Class OioSctpChannel
java.lang.Object
io.netty.util.DefaultAttributeMap
io.netty.channel.AbstractChannel
io.netty.channel.oio.AbstractOioChannel
io.netty.channel.oio.AbstractOioMessageChannel
io.netty.channel.sctp.oio.OioSctpChannel
- All Implemented Interfaces:
Channel, ChannelOutboundInvoker, SctpChannel, AttributeMap, Comparable<Channel>
Deprecated.
SctpChannel implementation which use blocking mode and allows to read / write
SctpMessages to the underlying SctpChannel.
Be aware that not all operations systems support SCTP. Please refer to the documentation of your operation system,
to understand what you need to do to use it. Also this feature is only supported on Java 7+.-
Nested Class Summary
Nested classes/interfaces inherited from class AbstractChannel
AbstractChannel.AbstractUnsafeModifier and TypeClassDescriptionprotected classChannel.Unsafeimplementation which sub-classes must extend and use.Nested classes/interfaces inherited from interface Channel
Channel.UnsafeModifier and TypeInterfaceDescriptionstatic interfaceUnsafe operations that should never be called from user-code. -
Field Summary
Fields inherited from class AbstractOioChannel
SO_TIMEOUT -
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.Create a new instance with an newSctpChannel.OioSctpChannel(com.sun.nio.sctp.SctpChannel ch) Deprecated.Create a new instance from the givenSctpChannel.OioSctpChannel(Channel parent, com.sun.nio.sctp.SctpChannel ch) Deprecated.Create a new instance from the givenSctpChannel. -
Method Summary
Modifier and TypeMethodDescriptionDeprecated.Return all local addresses of the SCTP channel.Deprecated.Return all remote addresses of the SCTP server channel.com.sun.nio.sctp.AssociationDeprecated.Returns the underlying SCTP association.bindAddress(InetAddress localAddress) Deprecated.Bind a address to the already bound channel to enable multi-homing.bindAddress(InetAddress localAddress, ChannelPromise promise) Deprecated.Bind a address to the already bound channel to enable multi-homing.config()Deprecated.Returns the configuration of this channel.protected voiddoBind(SocketAddress localAddress) Deprecated.Bind theChannelto theSocketAddressprotected voiddoClose()Deprecated.Close theChannelprotected voiddoConnect(SocketAddress remoteAddress, SocketAddress localAddress) Deprecated.Connect to the remote peer using the given localAddress if one is specified ornullotherwise.protected voidDeprecated.Disconnect thisChannelfrom its remote peerprotected intdoReadMessages(List<Object> msgs) Deprecated.Read messages into the given array and return the amount which was read.protected voidDeprecated.Flush the content of the given buffer to the remote peer.protected ObjectDeprecated.Invoked when a new message is added to aChannelOutboundBufferof thisAbstractChannel, so that theChannelimplementation converts the message to another.booleanisActive()Deprecated.Returntrueif theChannelis active and so connected.booleanisOpen()Deprecated.Returnstrueif theChannelis open and may get active laterDeprecated.Returns the local address where this channel is bound to.protected SocketAddressDeprecated.Returns theSocketAddresswhich is bound locally.metadata()Deprecated.parent()Deprecated.Returns the parent of this channel.Deprecated.Returns the remote address where this channel is connected to.protected SocketAddressDeprecated.Return theSocketAddresswhich theChannelis connected to.unbindAddress(InetAddress localAddress) Deprecated.Unbind the address from channel's multi-homing address list.unbindAddress(InetAddress localAddress, ChannelPromise promise) Deprecated.Unbind the address from channel's multi-homing address list.Methods inherited from class AbstractOioMessageChannel
doReadMethods inherited from class AbstractOioChannel
clearReadPending, doBeginRead, isCompatible, isReadPending, newUnsafe, setReadPendingModifier and TypeMethodDescriptionprotected final voidDeprecated.Set read pending tofalse.protected voidDeprecated.Schedule a read operation.protected booleanisCompatible(EventLoop loop) Deprecated.Returntrueif the givenEventLoopis compatible with this instance.protected booleanDeprecated.No longer supported.protected AbstractChannel.AbstractUnsafeDeprecated.Create a newAbstractChannel.AbstractUnsafeinstance which will be used for the life-time of theChannelprotected voidsetReadPending(boolean readPending) Deprecated.UseAbstractOioChannel.clearReadPending()if appropriate instead.Methods inherited from class AbstractChannel
alloc, bind, bind, bytesBeforeUnwritable, bytesBeforeWritable, close, close, closeFuture, compareTo, connect, connect, connect, connect, deregister, deregister, disconnect, disconnect, doDeregister, doRegister, doShutdownOutput, equals, eventLoop, flush, hashCode, id, invalidateLocalAddress, invalidateRemoteAddress, isRegistered, isWritable, maxMessagesPerWrite, newChannelPipeline, newFailedFuture, newId, newProgressivePromise, newPromise, newSucceededFuture, pipeline, read, toString, unsafe, validateFileRegion, voidPromise, write, write, writeAndFlush, writeAndFlushModifier and TypeMethodDescriptionalloc()Return the assignedByteBufAllocatorwhich will be used to allocateByteBufs.bind(SocketAddress localAddress) Request to bind to the givenSocketAddressand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.bind(SocketAddress localAddress, ChannelPromise promise) Request to bind to the givenSocketAddressand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.longGet how many bytes can be written untilChannel.isWritable()returnsfalse.longGet how many bytes must be drained from underlying buffers untilChannel.isWritable()returnstrue.close()Request to close theChanneland notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.close(ChannelPromise promise) Request to close theChanneland notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.Returns theChannelFuturewhich will be notified when this channel is closed.final intconnect(SocketAddress remoteAddress) Request to connect to the givenSocketAddressand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.connect(SocketAddress remoteAddress, ChannelPromise promise) Request to connect to the givenSocketAddressand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.connect(SocketAddress remoteAddress, SocketAddress localAddress) Request to connect to the givenSocketAddresswhile bind to the localAddress and notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.connect(SocketAddress remoteAddress, SocketAddress localAddress, ChannelPromise promise) Request to connect to the givenSocketAddresswhile bind to the localAddress and notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.Request to deregister from the previous assignedEventExecutorand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.deregister(ChannelPromise promise) Request to deregister from the previous assignedEventExecutorand notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.Request to disconnect from the remote peer and notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.disconnect(ChannelPromise promise) Request to disconnect from the remote peer and notify theChannelFutureonce the operation completes, either because the operation was successful or because of an error.protected voidprotected voidprotected voidCalled when conditions justify shutting down the output portion of the channel.final booleanReturnstrueif and only if the specified object is identical with this channel (i.e:this == o).flush()Request to flush all pending messages via this ChannelOutboundInvoker.final inthashCode()Returns the ID of this channel.final ChannelIdid()Returns the globally unique identifier of thisChannel.protected voidDeprecated.no use-case for this.protected voidDeprecated.no use-case for this.booleanbooleanReturnstrueif and only if the I/O thread will perform the requested write operation immediately.protected final intprotected DefaultChannelPipelineReturns a newDefaultChannelPipelineinstance.newFailedFuture(Throwable cause) Create a newChannelFuturewhich is marked as failed already.protected ChannelIdnewId()Returns a newDefaultChannelIdinstance.Return an newChannelProgressivePromiseReturn a newChannelPromise.Create a newChannelFuturewhich is marked as succeeded already.pipeline()Return the assignedChannelPipeline.read()Request to Read data from theChannelinto the first inbound buffer, triggers anChannelInboundHandler.channelRead(ChannelHandlerContext, Object)event if data was read, and triggers achannelReadCompleteevent so the handler can decide to continue reading.toString()Returns theStringrepresentation of this channel.unsafe()Returns an internal-use-only object that provides unsafe operations.protected voidvalidateFileRegion(DefaultFileRegion region, long position) final ChannelPromiseReturn a special ChannelPromise which can be reused for different operations.Request to write a message via thisChannelHandlerContextthrough theChannelPipeline.write(Object msg, ChannelPromise promise) Request to write a message via thisChannelHandlerContextthrough theChannelPipeline.writeAndFlush(Object msg) Shortcut for callChannelOutboundInvoker.write(Object)andChannelOutboundInvoker.flush().writeAndFlush(Object msg, ChannelPromise promise) Shortcut for callChannelOutboundInvoker.write(Object, ChannelPromise)andChannelOutboundInvoker.flush().Methods inherited from class DefaultAttributeMap
attr, hasAttrModifier and TypeMethodDescription<T> Attribute<T> attr(AttributeKey<T> key) Get theAttributefor the givenAttributeKey.<T> booleanhasAttr(AttributeKey<T> key)
-
Constructor Details
-
OioSctpChannel
public OioSctpChannel()Deprecated.Create a new instance with an newSctpChannel. -
OioSctpChannel
public OioSctpChannel(com.sun.nio.sctp.SctpChannel ch) Deprecated.Create a new instance from the givenSctpChannel.- Parameters:
ch- theSctpChannelwhich is used by this instance
-
OioSctpChannel
Deprecated.Create a new instance from the givenSctpChannel.- Parameters:
parent- the parentChannelwhich was used to create this instance. This can be null if the invalid input: '{@link /*missing*/}' has no parent as it was created by your self.ch- theSctpChannelwhich is used by this instance
-
-
Method Details
-
localAddress
Deprecated.Description copied from interface:ChannelReturns the local address where this channel is bound to. The returnedSocketAddressis supposed to be down-cast into more concrete type such asInetSocketAddressto retrieve the detailed information.- Specified by:
localAddressin interfaceChannel- Specified by:
localAddressin interfaceSctpChannel- Overrides:
localAddressin classAbstractChannel- Returns:
- the local address of this channel.
nullif this channel is not bound.
-
remoteAddress
Deprecated.Description copied from interface:ChannelReturns the remote address where this channel is connected to. The returnedSocketAddressis supposed to be down-cast into more concrete type such asInetSocketAddressto retrieve the detailed information.- Specified by:
remoteAddressin interfaceChannel- Specified by:
remoteAddressin interfaceSctpChannel- Overrides:
remoteAddressin classAbstractChannel- Returns:
- the remote address of this channel.
nullif this channel is not connected. If this channel is not connected but it can receive messages from arbitrary remote addresses (e.g.DatagramChannel, useDefaultAddressedEnvelope.recipient()to determine the origination of the received message as this method will returnnull.
-
parent
Deprecated.Description copied from interface:ChannelReturns the parent of this channel.- Specified by:
parentin interfaceChannel- Specified by:
parentin interfaceSctpChannel- Overrides:
parentin classAbstractChannel- Returns:
- the parent channel.
nullif this channel does not have a parent channel.
-
metadata
Deprecated.Description copied from interface:Channel -
config
Deprecated.Description copied from interface:ChannelReturns the configuration of this channel.- Specified by:
configin interfaceChannel- Specified by:
configin interfaceSctpChannel
-
isOpen
-
doReadMessages
Deprecated.Description copied from class:AbstractOioMessageChannelRead messages into the given array and return the amount which was read.- Specified by:
doReadMessagesin classAbstractOioMessageChannel- Throws:
Exception
-
doWrite
Deprecated.Description copied from class:AbstractChannelFlush the content of the given buffer to the remote peer.- Specified by:
doWritein classAbstractChannel- Throws:
Exception
-
filterOutboundMessage
Deprecated.Description copied from class:AbstractChannelInvoked when a new message is added to aChannelOutboundBufferof thisAbstractChannel, so that theChannelimplementation converts the message to another. (e.g. heap buffer -> direct buffer)- Overrides:
filterOutboundMessagein classAbstractChannel- Throws:
Exception
-
association
public com.sun.nio.sctp.Association association()Deprecated.Description copied from interface:SctpChannelReturns the underlying SCTP association.- Specified by:
associationin interfaceSctpChannel
-
isActive
-
localAddress0
Deprecated.Description copied from class:AbstractChannelReturns theSocketAddresswhich is bound locally.- Specified by:
localAddress0in classAbstractChannel
-
allLocalAddresses
Deprecated.Description copied from interface:SctpChannelReturn all local addresses of the SCTP channel. Please note that, it will return more than one address if this channel is using multi-homing- Specified by:
allLocalAddressesin interfaceSctpChannel
-
remoteAddress0
Deprecated.Description copied from class:AbstractChannelReturn theSocketAddresswhich theChannelis connected to.- Specified by:
remoteAddress0in classAbstractChannel
-
allRemoteAddresses
Deprecated.Description copied from interface:SctpChannelReturn all remote addresses of the SCTP server channel. Please note that, it will return more than one address if the remote is using multi-homing.- Specified by:
allRemoteAddressesin interfaceSctpChannel
-
doBind
Deprecated.Description copied from class:AbstractChannelBind theChannelto theSocketAddress- Specified by:
doBindin classAbstractChannel- Throws:
Exception
-
doConnect
Deprecated.Description copied from class:AbstractOioChannelConnect to the remote peer using the given localAddress if one is specified ornullotherwise.- Specified by:
doConnectin classAbstractOioChannel- Throws:
Exception
-
doDisconnect
Deprecated.Description copied from class:AbstractChannelDisconnect thisChannelfrom its remote peer- Specified by:
doDisconnectin classAbstractChannel- Throws:
Exception
-
doClose
Deprecated.Description copied from class:AbstractChannelClose theChannel- Specified by:
doClosein classAbstractChannel- Throws:
Exception
-
bindAddress
Deprecated.Description copied from interface:SctpChannelBind a address to the already bound channel to enable multi-homing. The Channel bust be bound and yet to be connected.- Specified by:
bindAddressin interfaceSctpChannel
-
bindAddress
Deprecated.Description copied from interface:SctpChannelBind a address to the already bound channel to enable multi-homing. The Channel bust be bound and yet to be connected. Will notify the givenChannelPromiseand return aChannelFuture- Specified by:
bindAddressin interfaceSctpChannel
-
unbindAddress
Deprecated.Description copied from interface:SctpChannelUnbind the address from channel's multi-homing address list. The address should be added already in multi-homing address list.- Specified by:
unbindAddressin interfaceSctpChannel
-
unbindAddress
Deprecated.Description copied from interface:SctpChannelUnbind the address from channel's multi-homing address list. The address should be added already in multi-homing address list. Will notify the givenChannelPromiseand return aChannelFuture- Specified by:
unbindAddressin interfaceSctpChannel
-
NioSctpChannel.