Package io.netty.channel.uring
Class IoUringSocketChannel
- java.lang.Object
-
- io.netty.util.DefaultAttributeMap
-
- io.netty.channel.AbstractChannel
-
- io.netty.channel.uring.IoUringSocketChannel
-
- All Implemented Interfaces:
Channel
,ChannelOutboundInvoker
,DuplexChannel
,SocketChannel
,UnixChannel
,AttributeMap
,java.lang.Comparable<Channel>
public final class IoUringSocketChannel extends AbstractChannel implements SocketChannel
-
-
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 boolean
active
-
Constructor Summary
Constructors Constructor Description IoUringSocketChannel()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
cancelOutstandingReads(IoRegistration registration, int numOutstandingReads)
Cancel all outstanding readsprotected void
cancelOutstandingWrites(IoRegistration registration, int numOutstandingWrites)
Cancel all outstanding writesprotected static void
checkResolvable(java.net.InetSocketAddress addr)
SocketChannelConfig
config()
Returns the configuration of this channel.protected void
doBeginRead()
Schedule a read operation.protected void
doBind(java.net.SocketAddress local)
Bind theChannel
to theSocketAddress
protected void
doClose()
Close theChannel
protected void
doDeregister()
protected void
doDisconnect()
Disconnect thisChannel
from its remote peerprotected void
doRegister(ChannelPromise promise)
protected void
doShutdownOutput()
Called when conditions justify shutting down the output portion of the channel.protected void
doWrite(ChannelOutboundBuffer in)
Flush the content of the given buffer to the remote peer.FileDescriptor
fd()
Returns theFileDescriptor
that is used by thisChannel
.protected java.lang.Object
filterOutboundMessage(java.lang.Object msg)
Invoked when a new message is added to aChannelOutboundBuffer
of thisAbstractChannel
, so that theChannel
implementation converts the message to another.boolean
isActive()
Returntrue
if theChannel
is active and so connected.protected boolean
isCompatible(EventLoop loop)
Returntrue
if the givenEventLoop
is compatible with this instance.boolean
isInputShutdown()
Returnstrue
if and only if the remote peer shut down its output so that no more data is received from this channel.boolean
isOpen()
Returnstrue
if theChannel
is open and may get active laterboolean
isOutputShutdown()
boolean
isShutdown()
Determine if both the input and output of this channel have been shutdown.java.net.InetSocketAddress
localAddress()
Returns the local address where this channel is bound to.protected java.net.SocketAddress
localAddress0()
Returns theSocketAddress
which is bound locally.ChannelMetadata
metadata()
protected ByteBuf
newDirectBuffer(ByteBuf buf)
protected ByteBuf
newDirectBuffer(java.lang.Object holder, ByteBuf buf)
protected io.netty.channel.uring.AbstractIoUringChannel.AbstractUringUnsafe
newUnsafe()
Create a newAbstractChannel.AbstractUnsafe
instance which will be used for the life-time of theChannel
protected short
nextOpsId()
Returns the next id that should be used when submittingIoUringIoOps
.ServerSocketChannel
parent()
Returns the parent of this channel.protected IoRegistration
registration()
java.net.InetSocketAddress
remoteAddress()
Returns the remote address where this channel is connected to.protected java.net.SocketAddress
remoteAddress0()
Return theSocketAddress
which theChannel
is connected to.protected void
scheduleWriteIfNeeded(ChannelOutboundBuffer in, boolean submitAndRunNow)
ChannelFuture
shutdown()
Will shutdown the input and output sides of this channel.ChannelFuture
shutdown(ChannelPromise promise)
Will shutdown the input and output sides of this channel.ChannelFuture
shutdownInput()
ChannelFuture
shutdownInput(ChannelPromise promise)
Will shutdown the input and notifyChannelPromise
.ChannelFuture
shutdownOutput()
ChannelFuture
shutdownOutput(ChannelPromise promise)
Will shutdown the output and notifyChannelPromise
.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.protected void
submitAndRunNow()
-
Methods inherited from class io.netty.channel.AbstractChannel
closeFuture, compareTo, doRegister, equals, eventLoop, hashCode, id, invalidateLocalAddress, invalidateRemoteAddress, isRegistered, maxMessagesPerWrite, newChannelPipeline, newId, 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, 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
-
-
-
-
Method Detail
-
parent
public ServerSocketChannel parent()
Description copied from interface:Channel
Returns the parent of this channel.- Specified by:
parent
in interfaceChannel
- Specified by:
parent
in interfaceSocketChannel
- Overrides:
parent
in classAbstractChannel
- Returns:
- the parent channel.
null
if this channel does not have a parent channel.
-
config
public SocketChannelConfig config()
Description copied from interface:Channel
Returns the configuration of this channel.- Specified by:
config
in interfaceChannel
- Specified by:
config
in interfaceSocketChannel
-
remoteAddress
public java.net.InetSocketAddress remoteAddress()
Description copied from interface:Channel
Returns the remote address where this channel is connected to. The returnedSocketAddress
is supposed to be down-cast into more concrete type such asInetSocketAddress
to retrieve the detailed information.- Specified by:
remoteAddress
in interfaceChannel
- Specified by:
remoteAddress
in interfaceSocketChannel
- Overrides:
remoteAddress
in classAbstractChannel
- Returns:
- the remote address of this channel.
null
if 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
.
-
localAddress
public java.net.InetSocketAddress localAddress()
Description copied from interface:Channel
Returns the local address where this channel is bound to. The returnedSocketAddress
is supposed to be down-cast into more concrete type such asInetSocketAddress
to retrieve the detailed information.- Specified by:
localAddress
in interfaceChannel
- Specified by:
localAddress
in interfaceSocketChannel
- Overrides:
localAddress
in classAbstractChannel
- Returns:
- the local address of this channel.
null
if this channel is not bound.
-
metadata
public ChannelMetadata metadata()
Description copied from interface:Channel
-
newUnsafe
protected final io.netty.channel.uring.AbstractIoUringChannel.AbstractUringUnsafe newUnsafe()
Description copied from class:AbstractChannel
Create a newAbstractChannel.AbstractUnsafe
instance which will be used for the life-time of theChannel
- Specified by:
newUnsafe
in classAbstractChannel
-
shutdown
public final ChannelFuture shutdown()
Description copied from interface:DuplexChannel
Will shutdown the input and output sides of this channel.- Specified by:
shutdown
in interfaceDuplexChannel
- Returns:
- will be completed when both shutdown operations complete.
-
shutdown
public final ChannelFuture shutdown(ChannelPromise promise)
Description copied from interface:DuplexChannel
Will shutdown the input and output sides of this channel.- Specified by:
shutdown
in 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.Exception
Description copied from class:AbstractChannel
Called when conditions justify shutting down the output portion of the channel. This may happen if a write operation throws an exception.- Overrides:
doShutdownOutput
in classAbstractChannel
- Throws:
java.lang.Exception
-
isOutputShutdown
public final boolean isOutputShutdown()
- Specified by:
isOutputShutdown
in interfaceDuplexChannel
- See Also:
Socket.isOutputShutdown()
-
isInputShutdown
public final boolean isInputShutdown()
Description copied from interface:DuplexChannel
Returnstrue
if 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:
isInputShutdown
in interfaceDuplexChannel
-
isShutdown
public final boolean isShutdown()
Description copied from interface:DuplexChannel
Determine if both the input and output of this channel have been shutdown.- Specified by:
isShutdown
in interfaceDuplexChannel
-
shutdownOutput
public final ChannelFuture shutdownOutput()
- Specified by:
shutdownOutput
in interfaceDuplexChannel
- See Also:
Socket.shutdownOutput()
-
shutdownOutput
public final ChannelFuture shutdownOutput(ChannelPromise promise)
Description copied from interface:DuplexChannel
Will shutdown the output and notifyChannelPromise
.- Specified by:
shutdownOutput
in interfaceDuplexChannel
- See Also:
Socket.shutdownOutput()
-
shutdownInput
public final ChannelFuture shutdownInput()
- Specified by:
shutdownInput
in interfaceDuplexChannel
- See Also:
Socket.shutdownInput()
-
shutdownInput
public final ChannelFuture shutdownInput(ChannelPromise promise)
Description copied from interface:DuplexChannel
Will shutdown the input and notifyChannelPromise
.- Specified by:
shutdownInput
in interfaceDuplexChannel
- See Also:
Socket.shutdownInput()
-
doRegister
protected final void doRegister(ChannelPromise promise)
Description copied from class:AbstractChannel
Is called after theChannel
is registered with itsEventLoop
as part of the register process. Subclasses may override this method- Parameters:
promise
-ChannelPromise
that must be notified once done to continue the registration.
-
filterOutboundMessage
protected java.lang.Object filterOutboundMessage(java.lang.Object msg)
Description copied from class:AbstractChannel
Invoked when a new message is added to aChannelOutboundBuffer
of thisAbstractChannel
, so that theChannel
implementation converts the message to another. (e.g. heap buffer -> direct buffer)
-
cancelOutstandingReads
protected final void cancelOutstandingReads(IoRegistration registration, int numOutstandingReads)
Cancel all outstanding reads- Parameters:
registration
- theIoRegistration
.numOutstandingReads
- the number of outstanding reads, or-1
if 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:
true
if empty.
-
submitAndRunNow
protected void submitAndRunNow()
-
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:Channel
Returnstrue
if theChannel
is open and may get active later
-
isActive
public boolean isActive()
Description copied from interface:Channel
Returntrue
if theChannel
is active and so connected.
-
fd
public final FileDescriptor fd()
Description copied from interface:UnixChannel
Returns theFileDescriptor
that is used by thisChannel
.- Specified by:
fd
in interfaceUnixChannel
-
isCompatible
protected boolean isCompatible(EventLoop loop)
Description copied from class:AbstractChannel
Returntrue
if the givenEventLoop
is compatible with this instance.- Specified by:
isCompatible
in classAbstractChannel
-
doDisconnect
protected void doDisconnect() throws java.lang.Exception
Description copied from class:AbstractChannel
Disconnect thisChannel
from its remote peer- Specified by:
doDisconnect
in classAbstractChannel
- Throws:
java.lang.Exception
-
doClose
protected void doClose() throws java.lang.Exception
Description copied from class:AbstractChannel
Close theChannel
- Specified by:
doClose
in classAbstractChannel
- Throws:
java.lang.Exception
-
doBeginRead
protected final void doBeginRead()
Description copied from class:AbstractChannel
Schedule a read operation.- Specified by:
doBeginRead
in classAbstractChannel
-
doWrite
protected void doWrite(ChannelOutboundBuffer in)
Description copied from class:AbstractChannel
Flush the content of the given buffer to the remote peer.- Specified by:
doWrite
in classAbstractChannel
-
scheduleWriteIfNeeded
protected void scheduleWriteIfNeeded(ChannelOutboundBuffer in, boolean submitAndRunNow)
-
registration
protected final IoRegistration registration()
-
doDeregister
protected final void doDeregister()
Description copied from class:AbstractChannel
- Overrides:
doDeregister
in classAbstractChannel
-
doBind
protected void doBind(java.net.SocketAddress local) throws java.lang.Exception
Description copied from class:AbstractChannel
Bind theChannel
to theSocketAddress
- Specified by:
doBind
in 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:AbstractChannel
Returns theSocketAddress
which is bound locally.- Specified by:
localAddress0
in classAbstractChannel
-
remoteAddress0
protected final java.net.SocketAddress remoteAddress0()
Description copied from class:AbstractChannel
Return theSocketAddress
which theChannel
is connected to.- Specified by:
remoteAddress0
in classAbstractChannel
-
-