Interface ConnectionAdapter
- All Known Subinterfaces:
- ConnectionFacade
- All Known Implementing Classes:
- ConnectionAdapterImpl
public interface ConnectionAdapter
Manages a switch connection.
- Author:
- mirehak, michal.polkorab
- 
Nested Class SummaryNested ClassesModifier and TypeInterfaceDescriptionstatic interfacestatic interface
- 
Method SummaryModifier and TypeMethodDescription@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<BarrierOutput>>barrier(BarrierInput input) InvokebarrierRPC.voidThrows exception if any of required listeners is missing.Disconnect corresponding switch.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<EchoOutput>>InvokeechoRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<EchoReplyOutput>>echoReply(EchoReplyInput input) Invokeecho-replyRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<ExperimenterOutput>>experimenter(ExperimenterInput input) InvokeexperimenterRPC.voidNotify listener about connection ready-to-use event.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<FlowModOutput>>flowMod(FlowModInput input) Invokeflow-modRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetAsyncOutput>>getAsync(GetAsyncInput input) Invokeget-asyncRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetConfigOutput>>getConfig(GetConfigInput input) Invokeget-configRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetFeaturesOutput>>getFeatures(GetFeaturesInput input) Invokeget-featuresRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetQueueConfigOutput>>Invokeget-queue-configRPC.Returns the address of the connected switch.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GroupModOutput>>groupMod(GroupModInput input) Invokegroup-modRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<HelloOutput>>hello(HelloInput input) InvokehelloRPC.booleanisAlive()Determines if the connection to the switch is alive.booleanDetermines if the channel is configured to auto-read.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<MeterModOutput>>meterMod(MeterModInput input) Invokemeter-modRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<MultipartRequestOutput>>Invokemultipart-requestRPC.voidonSwitchCertificateIdentified(@Nullable List<X509Certificate> certificateChain) Notify listener about switch certificate information.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<PacketOutOutput>>packetOut(PacketOutInput input) Invokepacket-outRPC.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<PortModOutput>>portMod(PortModInput input) Invokeport-modRPC.<T extends OutboundQueueHandler>
 OutboundQueueHandlerRegistration<T>registerOutboundQueueHandler(T handler, int maxQueueDepth, long maxBarrierNanos) Registers a new bypass outbound queue.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<RoleRequestOutput>>roleRequest(RoleRequestInput input) Invokerole-requestRPC.voidsetAlienMessageListener(AlienMessageListener alienMessageListener) Set handler for alien messages received from device.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<SetAsyncOutput>>setAsync(SetAsyncInput input) Invokeset-asyncRPC.voidsetAutoRead(boolean autoRead) Sets option for automatic channel reading - if set to false, incoming messages won't be read.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<SetConfigOutput>>setConfig(SetConfigInput input) Invokeset-configRPC.voidsetConnectionReadyListener(ConnectionReadyListener connectionReadyListener) Set listener for connection became ready-to-use event.voidsetDatapathId(BigInteger datapathId) Set datapathId for the dpn.voidsetExecutorService(ExecutorService executorService) Sets executorService.voidsetMessageListener(ConnectionAdapter.MessageListener messageListener) Sets the protocol message listener.voidsetPacketInFiltering(boolean enabled) Set filtering of PacketIn messages.voidsetSystemListener(ConnectionAdapter.SystemListener systemListener) Sets the system message listener.@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<TableModOutput>>tableMod(TableModInput input) Invoketable-modRPC.
- 
Method Details- 
disconnectDisconnect corresponding switch.- Returns:
- future set to true, when disconnect completed
 
- 
isAliveboolean isAlive()Determines if the connection to the switch is alive.- Returns:
- true, if connection to switch is alive
 
- 
getRemoteAddressInetSocketAddress getRemoteAddress()Returns the address of the connected switch.- Returns:
- address of the remote end - address of a switch if connected
 
- 
setMessageListenerSets the protocol message listener.- Parameters:
- messageListener- here will be pushed all messages from switch
 
- 
setSystemListenerSets the system message listener.- Parameters:
- systemListener- here will be pushed all system messages from library
 
- 
setAlienMessageListenerSet handler for alien messages received from device.- Parameters:
- alienMessageListener- here will be pushed all alien messages from switch
 
- 
checkListenersvoid checkListeners()Throws exception if any of required listeners is missing.
- 
fireConnectionReadyNotificationvoid fireConnectionReadyNotification()Notify listener about connection ready-to-use event.
- 
onSwitchCertificateIdentifiedNotify listener about switch certificate information.- Parameters:
- certificateChain- X509 certificate chain presented by the switch
 
- 
setConnectionReadyListenerSet listener for connection became ready-to-use event.- Parameters:
- connectionReadyListener- listens to connection ready event
 
- 
setAutoReadvoid setAutoRead(boolean autoRead) Sets option for automatic channel reading - if set to false, incoming messages won't be read.- Parameters:
- autoRead- target value to be switched to
 
- 
isAutoReadboolean isAutoRead()Determines if the channel is configured to auto-read.- Returns:
- true, if channel is configured to auto-read
 
- 
registerOutboundQueueHandler@Beta <T extends OutboundQueueHandler> OutboundQueueHandlerRegistration<T> registerOutboundQueueHandler(T handler, int maxQueueDepth, long maxBarrierNanos) Registers a new bypass outbound queue.- Type Parameters:
- T- handler type
- Parameters:
- handler- queue handler
- maxQueueDepth- max amount of not confirmed messaged in queue (i.e. edge for barrier message)
- maxBarrierNanos- regular base for barrier message
- Returns:
- An OutboundQueueHandlerRegistration
 
- 
setPacketInFiltering@Beta void setPacketInFiltering(boolean enabled) Set filtering of PacketIn messages. By default these messages are not filtered.- Parameters:
- enabled- True if PacketIn messages should be filtered, false if they should be reported.
 
- 
setDatapathIdSet datapathId for the dpn.- Parameters:
- datapathId- of the dpn
 
- 
setExecutorServiceSets executorService.- Parameters:
- executorService- for all dpns
 
- 
barrier@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<BarrierOutput>> barrier(BarrierInput input) InvokebarrierRPC. See alsoBarrier.- Parameters:
- input- of- barrier
- Returns:
- output of barrier
 
- 
echo@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<EchoOutput>> echo(EchoInput input) InvokeechoRPC. See alsoEcho.- Parameters:
- input- of- echo
- Returns:
- output of echo
 
- 
echoReply@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<EchoReplyOutput>> echoReply(EchoReplyInput input) Invokeecho-replyRPC. See alsoEchoReply.- Parameters:
- input- of- echo-reply
- Returns:
- output of echo-reply
 
- 
experimenter@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<ExperimenterOutput>> experimenter(ExperimenterInput input) InvokeexperimenterRPC. See alsoExperimenter.- Parameters:
- input- of- experimenter
- Returns:
- output of experimenter
 
- 
flowMod@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<FlowModOutput>> flowMod(FlowModInput input) Invokeflow-modRPC. See alsoFlowMod.- Parameters:
- input- of- flow-mod
- Returns:
- output of flow-mod
 
- 
getAsync@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetAsyncOutput>> getAsync(GetAsyncInput input) Invokeget-asyncRPC. See alsoGetAsync.- Parameters:
- input- of- get-async
- Returns:
- output of get-async
 
- 
getConfig@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetConfigOutput>> getConfig(GetConfigInput input) Invokeget-configRPC. See alsoGetConfig.- Parameters:
- input- of- get-config
- Returns:
- output of get-config
 
- 
getFeatures@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetFeaturesOutput>> getFeatures(GetFeaturesInput input) Invokeget-featuresRPC. See alsoGetFeatures.- Parameters:
- input- of- get-features
- Returns:
- output of get-features
 
- 
getQueueConfig@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GetQueueConfigOutput>> getQueueConfig(GetQueueConfigInput input) Invokeget-queue-configRPC. See alsoGetQueueConfig.- Parameters:
- input- of- get-queue-config
- Returns:
- output of get-queue-config
 
- 
groupMod@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<GroupModOutput>> groupMod(GroupModInput input) Invokegroup-modRPC. See alsoGroupMod.- Parameters:
- input- of- group-mod
- Returns:
- output of group-mod
 
- 
hello@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<HelloOutput>> hello(HelloInput input) InvokehelloRPC. See alsoHello.- Parameters:
- input- of- hello
- Returns:
- output of hello
 
- 
meterMod@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<MeterModOutput>> meterMod(MeterModInput input) Invokemeter-modRPC. See alsoMeterMod.- Parameters:
- input- of- meter-mod
- Returns:
- output of meter-mod
 
- 
multipartRequest@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<MultipartRequestOutput>> multipartRequest(MultipartRequestInput input) Invokemultipart-requestRPC. See alsoMultipartRequest.- Parameters:
- input- of- multipart-request
- Returns:
- output of multipart-request
 
- 
packetOut@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<PacketOutOutput>> packetOut(PacketOutInput input) Invokepacket-outRPC. See alsoPacketOut.- Parameters:
- input- of- packet-out
- Returns:
- output of packet-out
 
- 
portMod@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<PortModOutput>> portMod(PortModInput input) Invokeport-modRPC. See alsoPortMod.- Parameters:
- input- of- port-mod
- Returns:
- output of port-mod
 
- 
roleRequest@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<RoleRequestOutput>> roleRequest(RoleRequestInput input) Invokerole-requestRPC. See alsoRoleRequest.- Parameters:
- input- of- role-request
- Returns:
- output of role-request
 
- 
setAsync@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<SetAsyncOutput>> setAsync(SetAsyncInput input) Invokeset-asyncRPC. See alsoSetAsync.- Parameters:
- input- of- set-async
- Returns:
- output of set-async
 
- 
setConfig@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<SetConfigOutput>> setConfig(SetConfigInput input) Invokeset-configRPC. See alsoSetConfig.- Parameters:
- input- of- set-config
- Returns:
- output of set-config
 
- 
tableMod@NonNull com.google.common.util.concurrent.ListenableFuture<org.opendaylight.yangtools.yang.common.RpcResult<TableModOutput>> tableMod(TableModInput input) Invoketable-modRPC. See alsoTableMod.- Parameters:
- input- of- table-mod
- Returns:
- output of table-mod
 
 
-