Package io.netty.channel.epoll
Class AbstractEpollStreamChannel
- java.lang.Object
-
- io.netty.util.DefaultAttributeMap
-
- io.netty.channel.AbstractChannel
-
- io.netty.channel.epoll.AbstractEpollStreamChannel
-
- All Implemented Interfaces:
Channel,ChannelOutboundInvoker,DuplexChannel,UnixChannel,AttributeMap,java.lang.Comparable<Channel>
- Direct Known Subclasses:
EpollDomainSocketChannel,EpollSocketChannel
public abstract class AbstractEpollStreamChannel extends AbstractChannel implements DuplexChannel
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected classAbstractEpollStreamChannel.SpliceInTask-
Nested classes/interfaces inherited from class io.netty.channel.AbstractChannel
AbstractChannel.AbstractUnsafe
-
Nested classes/interfaces inherited from interface io.netty.channel.Channel
Channel.Unsafe
-
-
Field Summary
Fields Modifier and Type Field Description protected booleanactiveprotected LinuxSocketsocket
-
Constructor Summary
Constructors Modifier Constructor Description protectedAbstractEpollStreamChannel(int fd)protectedAbstractEpollStreamChannel(Channel parent, int fd)protectedAbstractEpollStreamChannel(Channel parent, LinuxSocket fd, java.net.SocketAddress remote)protectedAbstractEpollStreamChannel(LinuxSocket fd, boolean active)
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description protected static voidcheckResolvable(java.net.InetSocketAddress addr)abstract EpollChannelConfigconfig()Returns the configuration of this channel.protected voiddoBeginRead()Schedule a read operation.protected voiddoBind(java.net.SocketAddress local)Bind theChannelto theSocketAddressprotected voiddoClose()Close theChannelprotected booleandoConnect(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress)Connect to the remote peerprotected voiddoDeregister()protected voiddoDisconnect()Disconnect thisChannelfrom its remote peerprotected intdoReadBytes(ByteBuf byteBuf)Read bytes into the givenByteBufand return the amount.protected voiddoRegister(ChannelPromise promise)protected voiddoShutdownOutput()Called when conditions justify shutting down the output portion of the channel.protected voiddoWrite(ChannelOutboundBuffer in)Flush the content of the given buffer to the remote peer.protected intdoWriteBytes(ChannelOutboundBuffer in, ByteBuf buf)protected intdoWriteSingle(ChannelOutboundBuffer in)Attempt to write a single object.FileDescriptorfd()Returns theFileDescriptorthat is used by thisChannel.protected java.lang.ObjectfilterOutboundMessage(java.lang.Object msg)Invoked when a new message is added to aChannelOutboundBufferof thisAbstractChannel, so that theChannelimplementation converts the message to another.booleanisActive()Returntrueif theChannelis active and so connected.protected booleanisCompatible(EventLoop loop)Returntrueif the givenEventLoopis compatible with this instance.booleanisInputShutdown()Returnstrueif and only if the remote peer shut down its output so that no more data is received from this channel.booleanisOpen()Returnstrueif theChannelis open and may get active laterbooleanisOutputShutdown()booleanisShutdown()Determine if both the input and output of this channel have been shutdown.protected java.net.SocketAddresslocalAddress0()Returns theSocketAddresswhich is bound locally.ChannelMetadatametadata()protected ByteBufnewDirectBuffer(ByteBuf buf)Returns an off-heap copy of the specifiedByteBuf, and releases the original one.protected ByteBufnewDirectBuffer(java.lang.Object holder, ByteBuf buf)Returns an off-heap copy of the specifiedByteBuf, and releases the specified holder.protected io.netty.channel.epoll.AbstractEpollChannel.AbstractEpollUnsafenewUnsafe()Create a newAbstractChannel.AbstractUnsafeinstance which will be used for the life-time of theChannelprotected IoRegistrationregistration()protected java.net.SocketAddressremoteAddress0()Return theSocketAddresswhich theChannelis connected to.protected voidsetFlag(int flag)ChannelFutureshutdown()Will shutdown the input and output sides of this channel.ChannelFutureshutdown(ChannelPromise promise)Will shutdown the input and output sides of this channel.ChannelFutureshutdownInput()ChannelFutureshutdownInput(ChannelPromise promise)Will shutdown the input and notifyChannelPromise.ChannelFutureshutdownOutput()ChannelFutureshutdownOutput(ChannelPromise promise)Will shutdown the output and notifyChannelPromise.ChannelFuturespliceTo(AbstractEpollStreamChannel ch, int len)Splice from thisAbstractEpollStreamChannelto anotherAbstractEpollStreamChannel.ChannelFuturespliceTo(AbstractEpollStreamChannel ch, int len, ChannelPromise promise)Splice from thisAbstractEpollStreamChannelto anotherAbstractEpollStreamChannel.ChannelFuturespliceTo(FileDescriptor ch, int offset, int len)Splice from thisAbstractEpollStreamChannelto anotherFileDescriptor.ChannelFuturespliceTo(FileDescriptor ch, int offset, int len, ChannelPromise promise)Splice from thisAbstractEpollStreamChannelto anotherFileDescriptor.-
Methods inherited from class io.netty.channel.AbstractChannel
closeFuture, compareTo, doRegister, equals, eventLoop, hashCode, id, invalidateLocalAddress, invalidateRemoteAddress, isRegistered, localAddress, maxMessagesPerWrite, newChannelPipeline, newId, parent, pipeline, remoteAddress, toString, unsafe, validateFileRegion, voidPromise
-
Methods inherited from class io.netty.util.DefaultAttributeMap
attr, hasAttr
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface io.netty.util.AttributeMap
attr, hasAttr
-
Methods inherited from interface io.netty.channel.Channel
alloc, bind, bind, bytesBeforeUnwritable, bytesBeforeWritable, close, close, closeFuture, config, connect, connect, connect, connect, deregister, deregister, disconnect, disconnect, eventLoop, flush, getOption, id, isActive, isOpen, isRegistered, isWritable, localAddress, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, parent, pipeline, read, remoteAddress, setOption, unsafe, voidPromise, write, write, writeAndFlush, writeAndFlush
-
-
-
-
Field Detail
-
socket
protected final LinuxSocket socket
-
active
protected volatile boolean active
-
-
Constructor Detail
-
AbstractEpollStreamChannel
protected AbstractEpollStreamChannel(Channel parent, int fd)
-
AbstractEpollStreamChannel
protected AbstractEpollStreamChannel(int fd)
-
AbstractEpollStreamChannel
protected AbstractEpollStreamChannel(Channel parent, LinuxSocket fd, java.net.SocketAddress remote)
-
AbstractEpollStreamChannel
protected AbstractEpollStreamChannel(LinuxSocket fd, boolean active)
-
-
Method Detail
-
newUnsafe
protected io.netty.channel.epoll.AbstractEpollChannel.AbstractEpollUnsafe newUnsafe()
Description copied from class:AbstractChannelCreate a newAbstractChannel.AbstractUnsafeinstance which will be used for the life-time of theChannel
-
metadata
public ChannelMetadata metadata()
Description copied from interface:Channel
-
spliceTo
public final ChannelFuture spliceTo(AbstractEpollStreamChannel ch, int len)
Splice from thisAbstractEpollStreamChannelto anotherAbstractEpollStreamChannel. Thelenis the number of bytes to splice. If usingInteger.MAX_VALUEit will splice until theChannelFuturewas canceled or it was failed. Please note:- both channels need to be registered to the same
EventLoop, otherwise anIllegalArgumentExceptionis thrown. EpollChannelConfig.getEpollMode()must beEpollMode.LEVEL_TRIGGEREDfor this and the targetAbstractEpollStreamChannel
- both channels need to be registered to the same
-
spliceTo
public final ChannelFuture spliceTo(AbstractEpollStreamChannel ch, int len, ChannelPromise promise)
Splice from thisAbstractEpollStreamChannelto anotherAbstractEpollStreamChannel. Thelenis the number of bytes to splice. If usingInteger.MAX_VALUEit will splice until theChannelFuturewas canceled or it was failed. Please note:- both channels need to be registered to the same
EventLoop, otherwise anIllegalArgumentExceptionis thrown. EpollChannelConfig.getEpollMode()must beEpollMode.LEVEL_TRIGGEREDfor this and the targetAbstractEpollStreamChannel
- both channels need to be registered to the same
-
spliceTo
public final ChannelFuture spliceTo(FileDescriptor ch, int offset, int len)
Splice from thisAbstractEpollStreamChannelto anotherFileDescriptor. Theoffsetis the offset for theFileDescriptorandlenis the number of bytes to splice. If usingInteger.MAX_VALUEit will splice until theChannelFuturewas canceled or it was failed. Please note:EpollChannelConfig.getEpollMode()must beEpollMode.LEVEL_TRIGGEREDfor thisAbstractEpollStreamChannel- the
FileDescriptorwill not be closed after theChannelFutureis notified - this channel must be registered to an event loop or
IllegalStateExceptionwill be thrown.
-
spliceTo
public final ChannelFuture spliceTo(FileDescriptor ch, int offset, int len, ChannelPromise promise)
Splice from thisAbstractEpollStreamChannelto anotherFileDescriptor. Theoffsetis the offset for theFileDescriptorandlenis the number of bytes to splice. If usingInteger.MAX_VALUEit will splice until theChannelFuturewas canceled or it was failed. Please note:EpollChannelConfig.getEpollMode()must beEpollMode.LEVEL_TRIGGEREDfor thisAbstractEpollStreamChannel- the
FileDescriptorwill not be closed after theChannelPromiseis notified - this channel must be registered to an event loop or
IllegalStateExceptionwill be thrown.
-
doWrite
protected void doWrite(ChannelOutboundBuffer in) throws java.lang.Exception
Description copied from class:AbstractChannelFlush the content of the given buffer to the remote peer.- Specified by:
doWritein classAbstractChannel- Throws:
java.lang.Exception
-
doWriteSingle
protected int doWriteSingle(ChannelOutboundBuffer in) throws java.lang.Exception
Attempt to write a single object.- Parameters:
in- the collection which contains objects to write.- Returns:
- The value that should be decremented from the write quantum which starts at
ChannelConfig.getWriteSpinCount(). The typical use cases are as follows:- 0 - if no write was attempted. This is appropriate if an empty
ByteBuf(or other empty content) is encountered - 1 - if a single call to write data was made to the OS
ChannelUtils.WRITE_STATUS_SNDBUF_FULL- if an attempt to write data was made to the OS, but no data was accepted
- 0 - if no write was attempted. This is appropriate if an empty
- Throws:
java.lang.Exception- If an I/O error occurs.
-
filterOutboundMessage
protected java.lang.Object filterOutboundMessage(java.lang.Object msg)
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
-
doShutdownOutput
protected final void doShutdownOutput() throws java.lang.ExceptionDescription copied from class:AbstractChannelCalled when conditions justify shutting down the output portion of the channel. This may happen if a write operation throws an exception.- Overrides:
doShutdownOutputin classAbstractChannel- Throws:
java.lang.Exception
-
isOutputShutdown
public boolean isOutputShutdown()
- Specified by:
isOutputShutdownin interfaceDuplexChannel- See Also:
Socket.isOutputShutdown()
-
isInputShutdown
public boolean isInputShutdown()
Description copied from interface:DuplexChannelReturnstrueif and only if the remote peer shut down its output so that no more data is received from this channel. Note that the semantic of this method is different from that ofSocket.shutdownInput()andSocket.isInputShutdown().- Specified by:
isInputShutdownin interfaceDuplexChannel
-
isShutdown
public boolean isShutdown()
Description copied from interface:DuplexChannelDetermine if both the input and output of this channel have been shutdown.- Specified by:
isShutdownin interfaceDuplexChannel
-
shutdownOutput
public ChannelFuture shutdownOutput()
- Specified by:
shutdownOutputin interfaceDuplexChannel- See Also:
Socket.shutdownOutput()
-
shutdownOutput
public ChannelFuture shutdownOutput(ChannelPromise promise)
Description copied from interface:DuplexChannelWill shutdown the output and notifyChannelPromise.- Specified by:
shutdownOutputin interfaceDuplexChannel- See Also:
Socket.shutdownOutput()
-
shutdownInput
public ChannelFuture shutdownInput()
- Specified by:
shutdownInputin interfaceDuplexChannel- See Also:
Socket.shutdownInput()
-
shutdownInput
public ChannelFuture shutdownInput(ChannelPromise promise)
Description copied from interface:DuplexChannelWill shutdown the input and notifyChannelPromise.- Specified by:
shutdownInputin interfaceDuplexChannel- See Also:
Socket.shutdownInput()
-
shutdown
public ChannelFuture shutdown()
Description copied from interface:DuplexChannelWill shutdown the input and output sides of this channel.- Specified by:
shutdownin interfaceDuplexChannel- Returns:
- will be completed when both shutdown operations complete.
-
shutdown
public ChannelFuture shutdown(ChannelPromise promise)
Description copied from interface:DuplexChannelWill shutdown the input and output sides of this channel.- Specified by:
shutdownin interfaceDuplexChannel- Parameters:
promise- will be completed when both shutdown operations complete.- Returns:
- will be completed when both shutdown operations complete.
-
doClose
protected void doClose() throws java.lang.ExceptionDescription copied from class:AbstractChannelClose theChannel- Throws:
java.lang.Exception
-
setFlag
protected void setFlag(int flag) throws java.io.IOException- Throws:
java.io.IOException
-
registration
protected final IoRegistration registration()
-
fd
public final FileDescriptor fd()
Description copied from interface:UnixChannelReturns theFileDescriptorthat is used by thisChannel.- Specified by:
fdin interfaceUnixChannel
-
config
public abstract EpollChannelConfig config()
Description copied from interface:ChannelReturns the configuration of this channel.
-
isActive
public boolean isActive()
Description copied from interface:ChannelReturntrueif theChannelis active and so connected.
-
doDisconnect
protected void doDisconnect() throws java.lang.ExceptionDescription copied from class:AbstractChannelDisconnect thisChannelfrom its remote peer- Specified by:
doDisconnectin classAbstractChannel- Throws:
java.lang.Exception
-
isOpen
public boolean isOpen()
Description copied from interface:ChannelReturnstrueif theChannelis open and may get active later
-
doDeregister
protected void doDeregister() throws java.lang.ExceptionDescription copied from class:AbstractChannel- Overrides:
doDeregisterin classAbstractChannel- Throws:
java.lang.Exception
-
isCompatible
protected boolean isCompatible(EventLoop loop)
Description copied from class:AbstractChannelReturntrueif the givenEventLoopis compatible with this instance.- Specified by:
isCompatiblein classAbstractChannel
-
doBeginRead
protected void doBeginRead() throws java.lang.ExceptionDescription copied from class:AbstractChannelSchedule a read operation.- Specified by:
doBeginReadin classAbstractChannel- Throws:
java.lang.Exception
-
doRegister
protected void doRegister(ChannelPromise promise)
Description copied from class:AbstractChannelIs called after theChannelis registered with itsEventLoopas part of the register process. Subclasses may override this method- Overrides:
doRegisterin classAbstractChannel- Parameters:
promise-ChannelPromisethat must be notified once done to continue the registration.
-
newDirectBuffer
protected final ByteBuf newDirectBuffer(ByteBuf buf)
Returns an off-heap copy of the specifiedByteBuf, and releases the original one.
-
checkResolvable
protected static void checkResolvable(java.net.InetSocketAddress addr)
-
doReadBytes
protected final int doReadBytes(ByteBuf byteBuf) throws java.lang.Exception
Read bytes into the givenByteBufand return the amount.- Throws:
java.lang.Exception
-
doWriteBytes
protected final int doWriteBytes(ChannelOutboundBuffer in, ByteBuf buf) throws java.lang.Exception
- Throws:
java.lang.Exception
-
doBind
protected void doBind(java.net.SocketAddress local) throws java.lang.ExceptionDescription copied from class:AbstractChannelBind theChannelto theSocketAddress- Specified by:
doBindin classAbstractChannel- Throws:
java.lang.Exception
-
doConnect
protected boolean doConnect(java.net.SocketAddress remoteAddress, java.net.SocketAddress localAddress) throws java.lang.ExceptionConnect to the remote peer- Throws:
java.lang.Exception
-
localAddress0
protected java.net.SocketAddress localAddress0()
Description copied from class:AbstractChannelReturns theSocketAddresswhich is bound locally.- Specified by:
localAddress0in classAbstractChannel
-
remoteAddress0
protected java.net.SocketAddress remoteAddress0()
Description copied from class:AbstractChannelReturn theSocketAddresswhich theChannelis connected to.- Specified by:
remoteAddress0in classAbstractChannel
-
-