Package io.netty.channel.uring
Class IoUringDomainSocketChannel
- java.lang.Object
-
- io.netty.util.DefaultAttributeMap
-
- io.netty.channel.AbstractChannel
-
- io.netty.channel.uring.IoUringDomainSocketChannel
-
- All Implemented Interfaces:
Channel,ChannelOutboundInvoker,DuplexChannel,DomainSocketChannel,UnixChannel,AttributeMap,java.lang.Comparable<Channel>
public final class IoUringDomainSocketChannel extends AbstractChannel implements DomainSocketChannel
DomainSocketChannelimplementation that uses linux io_uring
-
-
Nested Class Summary
-
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 booleanactive
-
Constructor Summary
Constructors Constructor Description IoUringDomainSocketChannel()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected booleanallowMultiShotPollIn()protected voidcancelOutstandingReads(IoRegistration registration, int numOutstandingReads)Cancel all outstanding readsprotected voidcancelOutstandingWrites(IoRegistration registration, int numOutstandingWrites)Cancel all outstanding writesprotected static voidcheckResolvable(java.net.InetSocketAddress addr)DomainSocketChannelConfigconfig()Returns the configuration of this channel.protected voiddoBeginRead()Schedule a read operation.protected voiddoBind(java.net.SocketAddress local)Bind theChannelto theSocketAddressprotected voiddoClose()Close theChannelprotected voiddoDeregister()protected voiddoDisconnect()Disconnect thisChannelfrom its remote peerprotected 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.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.DomainSocketAddresslocalAddress()Returns the local address where this channel is bound to.protected java.net.SocketAddresslocalAddress0()Returns theSocketAddresswhich is bound locally.ChannelMetadatametadata()protected ByteBufnewDirectBuffer(ByteBuf buf)protected ByteBufnewDirectBuffer(java.lang.Object holder, ByteBuf buf)protected io.netty.channel.uring.AbstractIoUringChannel.AbstractUringUnsafenewUnsafe()Create a newAbstractChannel.AbstractUnsafeinstance which will be used for the life-time of theChannelprotected shortnextOpsId()Returns the next id that should be used when submittingIoUringIoOps.PeerCredentialspeerCredentials()Returns the unix credentials (uid, gid, pid) of the peer SO_PEERCREDprotected IoRegistrationregistration()DomainSocketAddressremoteAddress()Returns the remote address where this channel is connected to.protected java.net.SocketAddressremoteAddress0()Return theSocketAddresswhich theChannelis connected to.protected voidscheduleWriteIfNeeded(ChannelOutboundBuffer in, boolean submitAndRunNow)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.protected booleansocketIsEmpty(int flags)Return if the socket is guaranteed to be empty when the submitted io was executed and the completion event be created.protected voidsubmitAndRunNow()-
Methods inherited from class io.netty.channel.AbstractChannel
closeFuture, compareTo, doRegister, equals, eventLoop, hashCode, id, invalidateLocalAddress, invalidateRemoteAddress, isRegistered, maxMessagesPerWrite, newChannelPipeline, newId, parent, pipeline, 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, connect, connect, connect, connect, deregister, deregister, disconnect, disconnect, eventLoop, flush, getOption, id, isActive, isOpen, isRegistered, isWritable, metadata, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, parent, pipeline, read, setOption, unsafe, voidPromise, write, write, writeAndFlush, writeAndFlush
-
Methods inherited from interface io.netty.channel.socket.DuplexChannel
isInputShutdown, isOutputShutdown, isShutdown, shutdown, shutdown, shutdownInput, shutdownInput, shutdownOutput, shutdownOutput
-
Methods inherited from interface io.netty.channel.unix.UnixChannel
fd
-
-
-
-
Method Detail
-
config
public DomainSocketChannelConfig config()
Description copied from interface:ChannelReturns the configuration of this channel.- Specified by:
configin interfaceChannel- Specified by:
configin interfaceDomainSocketChannel
-
localAddress
public DomainSocketAddress localAddress()
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 interfaceDomainSocketChannel- Overrides:
localAddressin classAbstractChannel- Returns:
- the local address of this channel.
nullif this channel is not bound.
-
remoteAddress
public DomainSocketAddress remoteAddress()
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 interfaceDomainSocketChannel- 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.
-
peerCredentials
public PeerCredentials peerCredentials() throws java.io.IOException
Returns the unix credentials (uid, gid, pid) of the peer SO_PEERCRED- Throws:
java.io.IOException
-
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)
-
newUnsafe
protected io.netty.channel.uring.AbstractIoUringChannel.AbstractUringUnsafe newUnsafe()
Description copied from class:AbstractChannelCreate a newAbstractChannel.AbstractUnsafeinstance which will be used for the life-time of theChannel
-
allowMultiShotPollIn
protected boolean allowMultiShotPollIn()
-
metadata
public ChannelMetadata metadata()
Description copied from interface:Channel
-
shutdown
public final 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 final 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.
-
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 final boolean isOutputShutdown()
- Specified by:
isOutputShutdownin interfaceDuplexChannel- See Also:
Socket.isOutputShutdown()
-
isInputShutdown
public final 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 final 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 final ChannelFuture shutdownOutput()
- Specified by:
shutdownOutputin interfaceDuplexChannel- See Also:
Socket.shutdownOutput()
-
shutdownOutput
public final ChannelFuture shutdownOutput(ChannelPromise promise)
Description copied from interface:DuplexChannelWill shutdown the output and notifyChannelPromise.- Specified by:
shutdownOutputin interfaceDuplexChannel- See Also:
Socket.shutdownOutput()
-
shutdownInput
public final ChannelFuture shutdownInput()
- Specified by:
shutdownInputin interfaceDuplexChannel- See Also:
Socket.shutdownInput()
-
shutdownInput
public final ChannelFuture shutdownInput(ChannelPromise promise)
Description copied from interface:DuplexChannelWill shutdown the input and notifyChannelPromise.- Specified by:
shutdownInputin interfaceDuplexChannel- See Also:
Socket.shutdownInput()
-
doRegister
protected final 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- Parameters:
promise-ChannelPromisethat must be notified once done to continue the registration.
-
cancelOutstandingReads
protected final void cancelOutstandingReads(IoRegistration registration, int numOutstandingReads)
Cancel all outstanding reads- Parameters:
registration- theIoRegistration.numOutstandingReads- the number of outstanding reads, or-1if multi-shot was used.
-
cancelOutstandingWrites
protected final void cancelOutstandingWrites(IoRegistration registration, int numOutstandingWrites)
Cancel all outstanding writes- Parameters:
registration- theIoRegistration.numOutstandingWrites- the number of outstanding writes.
-
socketIsEmpty
protected boolean socketIsEmpty(int flags)
Return if the socket is guaranteed to be empty when the submitted io was executed and the completion event be created.- Parameters:
flags- the flags that were part of the completion- Returns:
trueif empty.
-
nextOpsId
protected final short nextOpsId()
Returns the next id that should be used when submittingIoUringIoOps.- Returns:
- opsId
-
isOpen
public final boolean isOpen()
Description copied from interface:ChannelReturnstrueif theChannelis open and may get active later
-
isActive
public boolean isActive()
Description copied from interface:ChannelReturntrueif theChannelis active and so connected.
-
fd
public final FileDescriptor fd()
Description copied from interface:UnixChannelReturns theFileDescriptorthat is used by thisChannel.- Specified by:
fdin interfaceUnixChannel
-
isCompatible
protected boolean isCompatible(EventLoop loop)
Description copied from class:AbstractChannelReturntrueif the givenEventLoopis compatible with this instance.- Specified by:
isCompatiblein classAbstractChannel
-
doDisconnect
protected void doDisconnect() throws java.lang.ExceptionDescription copied from class:AbstractChannelDisconnect thisChannelfrom its remote peer- Specified by:
doDisconnectin classAbstractChannel- Throws:
java.lang.Exception
-
doClose
protected void doClose() throws java.lang.ExceptionDescription copied from class:AbstractChannelClose theChannel- Specified by:
doClosein classAbstractChannel- Throws:
java.lang.Exception
-
doBeginRead
protected final void doBeginRead()
Description copied from class:AbstractChannelSchedule a read operation.- Specified by:
doBeginReadin classAbstractChannel
-
doWrite
protected void doWrite(ChannelOutboundBuffer in)
Description copied from class:AbstractChannelFlush the content of the given buffer to the remote peer.- Specified by:
doWritein classAbstractChannel
-
scheduleWriteIfNeeded
protected void scheduleWriteIfNeeded(ChannelOutboundBuffer in, boolean submitAndRunNow)
-
submitAndRunNow
protected void submitAndRunNow()
-
registration
protected final IoRegistration registration()
-
doDeregister
protected final void doDeregister()
Description copied from class:AbstractChannel- Overrides:
doDeregisterin classAbstractChannel
-
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
-
checkResolvable
protected static void checkResolvable(java.net.InetSocketAddress addr)
-
localAddress0
protected final java.net.SocketAddress localAddress0()
Description copied from class:AbstractChannelReturns theSocketAddresswhich is bound locally.- Specified by:
localAddress0in classAbstractChannel
-
remoteAddress0
protected final java.net.SocketAddress remoteAddress0()
Description copied from class:AbstractChannelReturn theSocketAddresswhich theChannelis connected to.- Specified by:
remoteAddress0in classAbstractChannel
-
-