org.jboss.netty.channel

类 SimpleChannelHandler

java.lang.Object

org.jboss.netty.channel.SimpleChannelHandler

所有已实现的接口:

ChannelDownstreamHandler, ChannelHandler, ChannelUpstreamHandler

直接已知子类:

AbstractTrafficShapingHandler, BufferedWriteHandler, HttpContentEncoder, IdleStateAwareChannelHandler, SpdyHttpResponseStreamIdHandler

public class SimpleChannelHandler
extends java.lang.Object
implements ChannelUpstreamHandler, ChannelDownstreamHandler

A ChannelHandler which provides an individual handler method for each event type. This handler down-casts the received upstream or or downstream event into more meaningful sub-type event and calls an appropriate handler method with the down-cast event. For an upstream event, the names of the methods are identical to the upstream event names, as introduced in the ChannelEvent documentation. For a downstream event, the names of the methods starts with the name of the operation and ends with "Requested" (e.g. writeRequested.)

Please use SimpleChannelUpstreamHandler or SimpleChannelDownstreamHandler if you want to intercept only upstream or downstream events.

Overriding the handleUpstream and handleDownstream method

You can override the handleUpstream and handleDownstream method just like overriding an ordinary Java method. Please make sure to call super.handleUpstream() or super.handleDownstream() so that other handler methods are invoked properly:

public class MyChannelHandler extends SimpleChannelHandler {

     @Override
     public void handleUpstream(ChannelHandlerContext ctx, ChannelEvent e) throws Exception {

         // Log all channel state changes.
         if (e instanceof ChannelStateEvent) {
             logger.info("Channel state changed: " + e);
         }

         super.handleUpstream(ctx, e);
     }

     @Override
     public void handleDownstream(ChannelHandlerContext ctx, ChannelEvent e) throws Exception {

         // Log all channel state changes.
         if (e instanceof MessageEvent) {
             logger.info("Writing:: " + e);
         }

         super.handleDownstream(ctx, e);
     }
 }

嵌套类概要

从接口继承的嵌套类/接口 org.jboss.netty.channel.ChannelHandler

ChannelHandler.Sharable

构造器概要

构造器

构造器和说明
SimpleChannelHandler()

方法概要

方法

限定符和类型	方法和说明
void	bindRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.bind(SocketAddress) was called.
void	channelBound(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel is open and bound to a local address, but not connected.
void	channelClosed(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel was closed and all its related resources were released.
void	channelConnected(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel is open, bound to a local address, and connected to a remote address.
void	channelDisconnected(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel was disconnected from its remote peer.
void	channelInterestChanged(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel's interestOps was changed.
void	channelOpen(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel is open, but not bound nor connected.
void	channelUnbound(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when a Channel was unbound from the current local address.
void	childChannelClosed(ChannelHandlerContext ctx, ChildChannelStateEvent e) Invoked when a child Channel was closed.
void	childChannelOpen(ChannelHandlerContext ctx, ChildChannelStateEvent e) Invoked when a child Channel was open.
void	closeRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.close() was called.
void	connectRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.connect(SocketAddress) was called.
void	disconnectRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.disconnect() was called.
void	exceptionCaught(ChannelHandlerContext ctx, ExceptionEvent e) Invoked when an exception was raised by an I/O thread or a ChannelHandler.
void	handleDownstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified downstream event.
void	handleUpstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified upstream event.
void	messageReceived(ChannelHandlerContext ctx, MessageEvent e) Invoked when a message object (e.g: ChannelBuffer) was received from a remote peer.
void	setInterestOpsRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.setInterestOps(int) was called.
void	unbindRequested(ChannelHandlerContext ctx, ChannelStateEvent e) Invoked when Channel.unbind() was called.
void	writeComplete(ChannelHandlerContext ctx, WriteCompletionEvent e) Invoked when something was written into a Channel.
void	writeRequested(ChannelHandlerContext ctx, MessageEvent e) Invoked when Channel.write(Object) is called.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

SimpleChannelHandler

public SimpleChannelHandler()

方法详细资料

handleUpstream

public void handleUpstream(ChannelHandlerContext ctx,
                  ChannelEvent e)
                    throws java.lang.Exception

Handles the specified upstream event. Down-casts the received upstream event into more meaningful sub-type event and calls an appropriate handler method with the down-casted event.

指定者:

handleUpstream 在接口中 ChannelUpstreamHandler

参数:

ctx - the context object for this handler

e - the upstream event to process or intercept

抛出:

java.lang.Exception

messageReceived

public void messageReceived(ChannelHandlerContext ctx,
                   MessageEvent e)
                     throws java.lang.Exception

Invoked when a message object (e.g: ChannelBuffer) was received from a remote peer.

抛出:

java.lang.Exception

exceptionCaught

public void exceptionCaught(ChannelHandlerContext ctx,
                   ExceptionEvent e)
                     throws java.lang.Exception

Invoked when an exception was raised by an I/O thread or a ChannelHandler.

抛出:

java.lang.Exception

channelOpen

public void channelOpen(ChannelHandlerContext ctx,
               ChannelStateEvent e)
                 throws java.lang.Exception

Invoked when a Channel is open, but not bound nor connected.

抛出:

java.lang.Exception

channelBound

public void channelBound(ChannelHandlerContext ctx,
                ChannelStateEvent e)
                  throws java.lang.Exception

Invoked when a Channel is open and bound to a local address, but not connected.

抛出:

java.lang.Exception

channelConnected

public void channelConnected(ChannelHandlerContext ctx,
                    ChannelStateEvent e)
                      throws java.lang.Exception

Invoked when a Channel is open, bound to a local address, and connected to a remote address.

抛出:

java.lang.Exception

channelInterestChanged

public void channelInterestChanged(ChannelHandlerContext ctx,
                          ChannelStateEvent e)
                            throws java.lang.Exception

Invoked when a Channel's interestOps was changed.

抛出:

java.lang.Exception

channelDisconnected

public void channelDisconnected(ChannelHandlerContext ctx,
                       ChannelStateEvent e)
                         throws java.lang.Exception

Invoked when a Channel was disconnected from its remote peer.

抛出:

java.lang.Exception

channelUnbound

public void channelUnbound(ChannelHandlerContext ctx,
                  ChannelStateEvent e)
                    throws java.lang.Exception

Invoked when a Channel was unbound from the current local address.

抛出:

java.lang.Exception

channelClosed

public void channelClosed(ChannelHandlerContext ctx,
                 ChannelStateEvent e)
                   throws java.lang.Exception

Invoked when a Channel was closed and all its related resources were released.

抛出:

java.lang.Exception

writeComplete

public void writeComplete(ChannelHandlerContext ctx,
                 WriteCompletionEvent e)
                   throws java.lang.Exception

Invoked when something was written into a Channel.

抛出:

java.lang.Exception

childChannelOpen

public void childChannelOpen(ChannelHandlerContext ctx,
                    ChildChannelStateEvent e)
                      throws java.lang.Exception

Invoked when a child Channel was open. (e.g. a server channel accepted a connection)

抛出:

java.lang.Exception

childChannelClosed

public void childChannelClosed(ChannelHandlerContext ctx,
                      ChildChannelStateEvent e)
                        throws java.lang.Exception

Invoked when a child Channel was closed. (e.g. the accepted connection was closed)

抛出:

java.lang.Exception

handleDownstream

public void handleDownstream(ChannelHandlerContext ctx,
                    ChannelEvent e)
                      throws java.lang.Exception

Handles the specified downstream event. Down-casts the received downstream event into more meaningful sub-type event and calls an appropriate handler method with the down-casted event.

指定者:

handleDownstream 在接口中 ChannelDownstreamHandler

参数:

ctx - the context object for this handler

e - the downstream event to process or intercept

抛出:

java.lang.Exception

writeRequested

public void writeRequested(ChannelHandlerContext ctx,
                  MessageEvent e)
                    throws java.lang.Exception

Invoked when Channel.write(Object) is called.

抛出:

java.lang.Exception

bindRequested

public void bindRequested(ChannelHandlerContext ctx,
                 ChannelStateEvent e)
                   throws java.lang.Exception

Invoked when Channel.bind(SocketAddress) was called.

抛出:

java.lang.Exception

connectRequested

public void connectRequested(ChannelHandlerContext ctx,
                    ChannelStateEvent e)
                      throws java.lang.Exception

Invoked when Channel.connect(SocketAddress) was called.

抛出:

java.lang.Exception

setInterestOpsRequested

public void setInterestOpsRequested(ChannelHandlerContext ctx,
                           ChannelStateEvent e)
                             throws java.lang.Exception

Invoked when Channel.setInterestOps(int) was called.

抛出:

java.lang.Exception

disconnectRequested

public void disconnectRequested(ChannelHandlerContext ctx,
                       ChannelStateEvent e)
                         throws java.lang.Exception

Invoked when Channel.disconnect() was called.

抛出:

java.lang.Exception

unbindRequested

public void unbindRequested(ChannelHandlerContext ctx,
                   ChannelStateEvent e)
                     throws java.lang.Exception

Invoked when Channel.unbind() was called.

抛出:

java.lang.Exception

closeRequested

public void closeRequested(ChannelHandlerContext ctx,
                  ChannelStateEvent e)
                    throws java.lang.Exception

Invoked when Channel.close() was called.

抛出:

java.lang.Exception