io.netty.channel.embedded

Class EmbeddedChannel

java.lang.Object

io.netty.util.DefaultAttributeMap

io.netty.channel.AbstractChannel

io.netty.channel.embedded.EmbeddedChannel

All Implemented Interfaces:

Channel, io.netty.util.AttributeMap, Comparable<Channel>

public class EmbeddedChannel
extends AbstractChannel

Base class for Channel implementations that are used in an embedded fashion.

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

Constructor Summary

Constructors

Constructor and Description
EmbeddedChannel(ChannelHandler... handlers) Create a new instance

Method Summary

Methods

Modifier and Type	Method and Description
void	checkException() Check if there was any Throwable received and if so rethrow it.
ChannelConfig	config() Returns the configuration of this channel.
protected void	doBeginRead() Schedule a read operation.
protected void	doBind(SocketAddress localAddress) Bind the Channel to the SocketAddress
protected void	doClose() Close the Channel
protected Runnable	doDeregister() Deregister the Channel from its EventLoop.
protected void	doDisconnect() Disconnect this Channel from its remote peer
protected Runnable	doRegister() Is called after the Channel is registered with its EventLoop as part of the register process.
protected int	doWrite(MessageList<Object> msgs, int index) Flush the content of the given ByteBuf to the remote peer.
protected void	ensureOpen()
boolean	finish() Mark this Channel as finished.
boolean	isActive() Return true if the Channel is active and so connected.
protected boolean	isCompatible(EventLoop loop) Return true if the given EventLoop is compatible with this instance.
protected boolean	isFlushPending() Return true if a flush to the Channel is currently pending.
boolean	isOpen() Returns true if the Channel is open an may get active later
Queue<Object>	lastInboundBuffer() Returns the buffer which holds all the Objects that were received by this Channel.
Queue<Object>	lastOutboundBuffer() Returns the buffer which holds all the Objects that were written by this Channel.
protected SocketAddress	localAddress0() Returns the SocketAddress which is bound locally.
ChannelMetadata	metadata() Return the ChannelMetadata of the Channel which describe the nature of the Channel.
protected AbstractChannel.AbstractUnsafe	newUnsafe() Create a new AbstractChannel.AbstractUnsafe instance which will be used for the life-time of the Channel
Object	readInbound() Return received data from this Channel
Object	readOutbound() Read data froum the outbound.
protected SocketAddress	remoteAddress0() Return the SocketAddress which the Channel is connected to.
void	runPendingTasks() Run all tasks that are pending in the EventLoop for this Channel
boolean	writeInbound(Object... msgs) Write messages to the inbound of this Channel.
boolean	writeOutbound(Object... msgs) Write messages to the outbound of this Channel.

Methods inherited from class io.netty.channel.AbstractChannel

alloc, bind, bind, calculateMessageSize, checkEOF, close, close, closeFuture, compareTo, connect, connect, connect, connect, deregister, deregister, disconnect, disconnect, doPreClose, equals, eventLoop, hashCode, id, invalidateLocalAddress, invalidateRemoteAddress, isRegistered, isWritable, localAddress, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, parent, pipeline, read, remoteAddress, toString, unsafe, voidPromise, write, write, write, write

Methods inherited from class io.netty.util.DefaultAttributeMap

attr

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.netty.util.AttributeMap

attr

Constructor Detail

EmbeddedChannel

public EmbeddedChannel(ChannelHandler... handlers)

Create a new instance

Parameters:

handlers - the @link ChannelHandler}s which will be add in the ChannelPipeline

Method Detail

metadata

public ChannelMetadata metadata()

Description copied from interface: Channel

Return the ChannelMetadata of the Channel which describe the nature of the Channel.

config

public ChannelConfig config()

Description copied from interface: Channel

Returns the configuration of this channel.

isOpen

public boolean isOpen()

Description copied from interface: Channel

Returns true if the Channel is open an may get active later

isActive

public boolean isActive()

Description copied from interface: Channel

Return true if the Channel is active and so connected.

lastInboundBuffer

public Queue<Object> lastInboundBuffer()

Returns the buffer which holds all the Objects that were received by this Channel.

lastOutboundBuffer

public Queue<Object> lastOutboundBuffer()

Returns the buffer which holds all the Objects that were written by this Channel.

readInbound

public Object readInbound()

Return received data from this Channel

readOutbound

public Object readOutbound()

Read data froum the outbound. This may return null if nothing is readable.

writeInbound

public boolean writeInbound(Object... msgs)

Write messages to the inbound of this Channel.

Parameters:

msgs - the messages to be written

Returns:

true if the write operation did add something to the the inbound buffer

writeOutbound

public boolean writeOutbound(Object... msgs)

Write messages to the outbound of this Channel.

Parameters:

msgs - the messages to be written

Returns:

bufferReadable returns true if the write operation did add something to the the outbound buffer

finish

public boolean finish()

Mark this Channel as finished. Any futher try to write data to it will fail.

Returns:

bufferReadable returns true if any of the used buffers has something left to read

runPendingTasks

public void runPendingTasks()

Run all tasks that are pending in the EventLoop for this Channel

checkException

public void checkException()

Check if there was any Throwable received and if so rethrow it.

ensureOpen

protected final void ensureOpen()

isCompatible

protected boolean isCompatible(EventLoop loop)

Description copied from class: AbstractChannel

Return true if the given EventLoop is compatible with this instance.

Specified by:

isCompatible in class AbstractChannel

localAddress0

protected SocketAddress localAddress0()

Description copied from class: AbstractChannel

Returns the SocketAddress which is bound locally.

Specified by:

localAddress0 in class AbstractChannel

remoteAddress0

protected SocketAddress remoteAddress0()

Description copied from class: AbstractChannel

Return the SocketAddress which the Channel is connected to.

Specified by:

remoteAddress0 in class AbstractChannel

doRegister

protected Runnable doRegister()
                       throws Exception

Description copied from class: AbstractChannel

Is called after the Channel is registered with its EventLoop as part of the register process. You can return a Runnable which will be run as post-task of the registration process. Sub-classes may override this method as it will just return null

Overrides:

doRegister in class AbstractChannel

Throws:

Exception

doBind

protected void doBind(SocketAddress localAddress)
               throws Exception

Description copied from class: AbstractChannel

Bind the Channel to the SocketAddress

Specified by:

doBind in class AbstractChannel

Throws:

Exception

doDisconnect

protected void doDisconnect()
                     throws Exception

Description copied from class: AbstractChannel

Disconnect this Channel from its remote peer

Specified by:

doDisconnect in class AbstractChannel

Throws:

Exception

doClose

protected void doClose()
                throws Exception

Description copied from class: AbstractChannel

Close the Channel

Specified by:

doClose in class AbstractChannel

Throws:

Exception

doDeregister

protected Runnable doDeregister()
                         throws Exception

Description copied from class: AbstractChannel

Deregister the Channel from its EventLoop. You can return a Runnable which will be run as post-task of the registration process. Sub-classes may override this method

Overrides:

doDeregister in class AbstractChannel

Throws:

Exception

doBeginRead

protected void doBeginRead()
                    throws Exception

Description copied from class: AbstractChannel

Schedule a read operation.

Specified by:

doBeginRead in class AbstractChannel

Throws:

Exception

newUnsafe

protected AbstractChannel.AbstractUnsafe newUnsafe()

Description copied from class: AbstractChannel

Create a new AbstractChannel.AbstractUnsafe instance which will be used for the life-time of the Channel

Specified by:

newUnsafe in class AbstractChannel

isFlushPending

protected boolean isFlushPending()

Description copied from class: AbstractChannel

Return true if a flush to the Channel is currently pending.

Specified by:

isFlushPending in class AbstractChannel

doWrite

protected int doWrite(MessageList<Object> msgs,
          int index)
               throws Exception

Description copied from class: AbstractChannel

Flush the content of the given ByteBuf to the remote peer. Sub-classes may override this as this implementation will just thrown an UnsupportedOperationException

Specified by:

doWrite in class AbstractChannel

Returns:

the number of written messages

Throws:

Exception