Package io.netty.channel
Class AbstractChannel.AbstractUnsafe
- java.lang.Object
-
- io.netty.channel.AbstractChannel.AbstractUnsafe
-
- All Implemented Interfaces:
Channel.Unsafe
- Direct Known Subclasses:
AbstractNioChannel.AbstractNioUnsafe
- Enclosing class:
- AbstractChannel
protected abstract class AbstractChannel.AbstractUnsafe extends java.lang.Object implements Channel.Unsafe
Channel.Unsafeimplementation which sub-classes must extend and use.
-
-
Constructor Summary
Constructors Modifier Constructor Description protectedAbstractUnsafe()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected java.lang.ThrowableannotateConnectException(java.lang.Throwable cause, java.net.SocketAddress remoteAddress)Appends the remote address to the message of the exceptions caused by connection attempt failure.voidbeginRead()Schedules a read operation that fills the inbound buffer of the firstChannelInboundHandlerin theChannelPipeline.voidbind(java.net.SocketAddress localAddress, ChannelPromise promise)voidclose(ChannelPromise promise)Close theChannelof theChannelPromiseand notify theChannelPromiseonce the operation was complete.protected voidclose(ChannelPromise promise, java.lang.Throwable cause, java.nio.channels.ClosedChannelException closeCause)voidcloseForcibly()Closes theChannelimmediately without firing any events.protected voidcloseIfClosed()voidderegister(ChannelPromise promise)Deregister theChannelof theChannelPromisefromEventLoopand notify theChannelPromiseonce the operation was complete.voiddisconnect(ChannelPromise promise)Disconnect theChannelof theChannelFutureand notify theChannelPromiseonce the operation was complete.protected booleanensureOpen(ChannelPromise promise)voidflush()Flush out all write operations scheduled viaChannel.Unsafe.write(Object, ChannelPromise).protected voidflush0()protected voidhandleWriteError(java.lang.Throwable t)java.net.SocketAddresslocalAddress()Return theSocketAddressto which is bound local ornullif none.ChannelOutboundBufferoutboundBuffer()Returns theChannelOutboundBufferof theChannelwhere the pending write requests are stored.protected java.util.concurrent.ExecutorprepareToClose()Prepares to close theChannel.RecvByteBufAllocator.HandlerecvBufAllocHandle()Return the assignedRecvByteBufAllocator.Handlewhich will be used to allocateByteBuf's when receiving data.voidregister(EventLoop eventLoop, ChannelPromise promise)Register theChannelof theChannelPromiseand notify theChannelFutureonce the registration was complete.java.net.SocketAddressremoteAddress()Return theSocketAddressto which is bound remote ornullif none is bound yet.protected voidsafeSetFailure(ChannelPromise promise, java.lang.Throwable cause)Marks the specifiedpromiseas failure.protected voidsafeSetSuccess(ChannelPromise promise)Marks the specifiedpromiseas success.voidshutdownOutput(ChannelPromise promise)Shutdown the output portion of the correspondingChannel.ChannelPromisevoidPromise()Return a special ChannelPromise which can be reused and passed to the operations inChannel.Unsafe.voidwrite(java.lang.Object msg, ChannelPromise promise)Schedules a write operation.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface io.netty.channel.Channel.Unsafe
connect
-
-
-
-
Method Detail
-
recvBufAllocHandle
public RecvByteBufAllocator.Handle recvBufAllocHandle()
Description copied from interface:Channel.UnsafeReturn the assignedRecvByteBufAllocator.Handlewhich will be used to allocateByteBuf's when receiving data.- Specified by:
recvBufAllocHandlein interfaceChannel.Unsafe
-
outboundBuffer
public final ChannelOutboundBuffer outboundBuffer()
Description copied from interface:Channel.UnsafeReturns theChannelOutboundBufferof theChannelwhere the pending write requests are stored.- Specified by:
outboundBufferin interfaceChannel.Unsafe
-
localAddress
public final java.net.SocketAddress localAddress()
Description copied from interface:Channel.UnsafeReturn theSocketAddressto which is bound local ornullif none.- Specified by:
localAddressin interfaceChannel.Unsafe
-
remoteAddress
public final java.net.SocketAddress remoteAddress()
Description copied from interface:Channel.UnsafeReturn theSocketAddressto which is bound remote ornullif none is bound yet.- Specified by:
remoteAddressin interfaceChannel.Unsafe
-
register
public final void register(EventLoop eventLoop, ChannelPromise promise)
Description copied from interface:Channel.UnsafeRegister theChannelof theChannelPromiseand notify theChannelFutureonce the registration was complete.- Specified by:
registerin interfaceChannel.Unsafe
-
bind
public final void bind(java.net.SocketAddress localAddress, ChannelPromise promise)Description copied from interface:Channel.Unsafe- Specified by:
bindin interfaceChannel.Unsafe
-
disconnect
public final void disconnect(ChannelPromise promise)
Description copied from interface:Channel.UnsafeDisconnect theChannelof theChannelFutureand notify theChannelPromiseonce the operation was complete.- Specified by:
disconnectin interfaceChannel.Unsafe
-
close
public void close(ChannelPromise promise)
Description copied from interface:Channel.UnsafeClose theChannelof theChannelPromiseand notify theChannelPromiseonce the operation was complete.- Specified by:
closein interfaceChannel.Unsafe
-
shutdownOutput
public final void shutdownOutput(ChannelPromise promise)
Shutdown the output portion of the correspondingChannel. For example this will clean up theChannelOutboundBufferand not allow any more writes.
-
close
protected void close(ChannelPromise promise, java.lang.Throwable cause, java.nio.channels.ClosedChannelException closeCause)
-
closeForcibly
public final void closeForcibly()
Description copied from interface:Channel.UnsafeCloses theChannelimmediately without firing any events. Probably only useful when registration attempt failed.- Specified by:
closeForciblyin interfaceChannel.Unsafe
-
deregister
public final void deregister(ChannelPromise promise)
Description copied from interface:Channel.UnsafeDeregister theChannelof theChannelPromisefromEventLoopand notify theChannelPromiseonce the operation was complete.- Specified by:
deregisterin interfaceChannel.Unsafe
-
beginRead
public final void beginRead()
Description copied from interface:Channel.UnsafeSchedules a read operation that fills the inbound buffer of the firstChannelInboundHandlerin theChannelPipeline. If there's already a pending read operation, this method does nothing.- Specified by:
beginReadin interfaceChannel.Unsafe
-
write
public final void write(java.lang.Object msg, ChannelPromise promise)Description copied from interface:Channel.UnsafeSchedules a write operation.- Specified by:
writein interfaceChannel.Unsafe
-
flush
public final void flush()
Description copied from interface:Channel.UnsafeFlush out all write operations scheduled viaChannel.Unsafe.write(Object, ChannelPromise).- Specified by:
flushin interfaceChannel.Unsafe
-
flush0
protected void flush0()
-
handleWriteError
protected final void handleWriteError(java.lang.Throwable t)
-
voidPromise
public final ChannelPromise voidPromise()
Description copied from interface:Channel.UnsafeReturn a special ChannelPromise which can be reused and passed to the operations inChannel.Unsafe. It will never be notified of a success or error and so is only a placeholder for operations that take aChannelPromiseas argument but for which you not want to get notified.- Specified by:
voidPromisein interfaceChannel.Unsafe
-
ensureOpen
protected final boolean ensureOpen(ChannelPromise promise)
-
safeSetSuccess
protected final void safeSetSuccess(ChannelPromise promise)
Marks the specifiedpromiseas success. If thepromiseis done already, log a message.
-
safeSetFailure
protected final void safeSetFailure(ChannelPromise promise, java.lang.Throwable cause)
Marks the specifiedpromiseas failure. If thepromiseis done already, log a message.
-
closeIfClosed
protected final void closeIfClosed()
-
annotateConnectException
protected final java.lang.Throwable annotateConnectException(java.lang.Throwable cause, java.net.SocketAddress remoteAddress)Appends the remote address to the message of the exceptions caused by connection attempt failure.
-
prepareToClose
protected java.util.concurrent.Executor prepareToClose()
Prepares to close theChannel. If this method returns anExecutor, the caller must call theExecutor.execute(Runnable)method with a task that callsAbstractChannel.doClose()on the returnedExecutor. If this method returnsnull,AbstractChannel.doClose()must be called from the caller thread. (i.e.EventLoop)
-
-