Package org.jboss.netty.channel
Class SimpleChannelUpstreamHandler
java.lang.Object
org.jboss.netty.channel.SimpleChannelUpstreamHandler
- All Implemented Interfaces:
ChannelHandler
,ChannelUpstreamHandler
- Direct Known Subclasses:
AutobahnServerHandler
,BlockingReadHandler
,DiscardClientHandler
,DiscardServerHandler
,EchoClientHandler
,EchoServerHandler
,FactorialClientHandler
,FactorialServerHandler
,FrameDecoder
,HexDumpProxyInboundHandler
,HexDumpProxyInboundHandler.OutboundHandler
,HttpChunkAggregator
,HttpContentDecoder
,HttpHelloWorldServerHandler
,HttpSnoopClientHandler
,HttpSnoopServerHandler
,HttpStaticFileServerHandler
,HttpTunnelingClientSocketChannel.ServletChannelHandler
,HttpTunnelingServlet.OutboundConnectionHandler
,HttpUploadClientHandler
,HttpUploadServerHandler
,IdleStateAwareChannelUpstreamHandler
,IdleStateHandler
,LocalTimeClientHandler
,LocalTimeServerHandler
,ObjectEchoClientHandler
,ObjectEchoServerHandler
,QuoteOfTheMomentClientHandler
,QuoteOfTheMomentServerHandler
,ReadTimeoutHandler
,SecureChatClientHandler
,SecureChatServerHandler
,ServerBootstrap.Binder
,SpdySessionHandler
,TelnetClientHandler
,TelnetServerHandler
,UptimeClientHandler
,WebSocketClientHandler
,WebSocketServerHandler
,WebSocketServerProtocolHandler
,WebSocketServerProtocolHandshakeHandler
A Overriding the
ChannelUpstreamHandler
which provides an individual handler method
for each event type. This handler down-casts the received upstream event
into more meaningful sub-type event and calls an appropriate handler method
with the down-cast event. The names of the methods are identical to the
upstream event names, as introduced in the ChannelEvent
documentation.
Please use SimpleChannelHandler
if you need to implement both
ChannelUpstreamHandler
and ChannelDownstreamHandler
.
Overriding the handleUpstream
method
You can override the handleUpstream
method just like overriding an ordinary Java method. Please make sure to
call super.handleUpstream()
so that other handler methods are invoked
properly:
public class MyChannelHandler extendsSimpleChannelUpstreamHandler
{@Override
public void handleUpstream(ChannelHandlerContext
ctx,ChannelEvent
e) throws Exception { // Log all channel state changes. if (e instanceofChannelStateEvent
) { logger.info("Channel state changed: " + e); } super.handleUpstream(ctx, e); } }
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.jboss.netty.channel.ChannelHandler
ChannelHandler.Sharable
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Invoked when aChannel
is open and bound to a local address, but not connected.void
Invoked when aChannel
was closed and all its related resources were released.void
Invoked when aChannel
is open, bound to a local address, and connected to a remote address.void
Invoked when aChannel
was disconnected from its remote peer.void
Invoked when aChannel
'sinterestOps
was changed.void
Invoked when aChannel
is open, but not bound nor connected.void
Invoked when aChannel
was unbound from the current local address.void
Invoked when a childChannel
was closed.void
Invoked when a childChannel
was open.void
Invoked when an exception was raised by an I/O thread or aChannelHandler
.void
Handles the specified upstream event.void
Invoked when a message object (e.g:ChannelBuffer
) was received from a remote peer.void
Invoked when something was written into aChannel
.
-
Field Details
-
logger
-
-
Constructor Details
-
SimpleChannelUpstreamHandler
public SimpleChannelUpstreamHandler()
-
-
Method Details
-
handleUpstream
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.- Specified by:
handleUpstream
in interfaceChannelUpstreamHandler
- Parameters:
ctx
- the context object for this handlere
- the upstream event to process or intercept- Throws:
Exception
-
messageReceived
Invoked when a message object (e.g:ChannelBuffer
) was received from a remote peer.- Throws:
Exception
-
exceptionCaught
Invoked when an exception was raised by an I/O thread or aChannelHandler
.- Throws:
Exception
-
channelOpen
Invoked when aChannel
is open, but not bound nor connected.
Be aware that this event is fired from within the I/O thread. You should never execute any heavy operation in there as it will block the dispatching to other workers!- Throws:
Exception
-
channelBound
Invoked when aChannel
is open and bound to a local address, but not connected.
Be aware that this event is fired from within the I/O thread. You should never execute any heavy operation in there as it will block the dispatching to other workers!- Throws:
Exception
-
channelConnected
Invoked when aChannel
is open, bound to a local address, and connected to a remote address.
Be aware that this event is fired from within the I/O thread. You should never execute any heavy operation in there as it will block the dispatching to other workers!- Throws:
Exception
-
channelInterestChanged
Invoked when aChannel
'sinterestOps
was changed.- Throws:
Exception
-
channelDisconnected
Invoked when aChannel
was disconnected from its remote peer.- Throws:
Exception
-
channelUnbound
Invoked when aChannel
was unbound from the current local address.- Throws:
Exception
-
channelClosed
Invoked when aChannel
was closed and all its related resources were released.- Throws:
Exception
-
writeComplete
Invoked when something was written into aChannel
.- Throws:
Exception
-
childChannelOpen
Invoked when a childChannel
was open. (e.g. a server channel accepted a connection)- Throws:
Exception
-
childChannelClosed
public void childChannelClosed(ChannelHandlerContext ctx, ChildChannelStateEvent e) throws Exception Invoked when a childChannel
was closed. (e.g. the accepted connection was closed)- Throws:
Exception
-