io.netty.channel

类 ChannelInitializer<C extends Channel>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.channel.ChannelInitializer<C>

类型参数:

C - A sub-type of Channel

所有已实现的接口:

ChannelHandler, ChannelInboundHandler

直接已知子类:

AutobahnServerInitializer, FactorialClientInitializer, FactorialServerInitializer, HexDumpProxyInitializer, Http2ClientFrameInitializer, Http2ClientInitializer, Http2ServerInitializer, Http2ServerInitializer, Http2ServerInitializer, Http2ServerInitializer, Http2StaticFileServerInitializer, HttpCorsServerInitializer, HttpHelloWorldServerInitializer, HttpNativeServerInitializer, HttpSnoopClientInitializer, HttpSnoopServerInitializer, HttpStaticFileServerInitializer, HttpUploadClientInitializer, HttpUploadServerInitializer, SecureChatClientInitializer, SecureChatServerInitializer, SocksServerInitializer, SpdyClientInitializer, SpdyServerInitializer, StompWebSocketChatServerInitializer, TelnetClientInitializer, TelnetServerInitializer, WebSocketServerInitializer, WebSocketServerInitializer, WorldClockClientInitializer, WorldClockServerInitializer

@ChannelHandler.Sharable
public abstract class ChannelInitializer<C extends Channel>
extends ChannelInboundHandlerAdapter

A special ChannelInboundHandler which offers an easy way to initialize a Channel once it was registered to its EventLoop. Implementations are most often used in the context of AbstractBootstrap.handler(ChannelHandler) , AbstractBootstrap.handler(ChannelHandler) and ServerBootstrap.childHandler(ChannelHandler) to setup the ChannelPipeline of a Channel.

 public class MyChannelInitializer extends ChannelInitializer {
     public void initChannel(Channel channel) {
         channel.pipeline().addLast("myHandler", new MyHandler());
     }
 }

 ServerBootstrap bootstrap = ...;
 ...
 bootstrap.childHandler(new MyChannelInitializer());
 ...
 

Be aware that this class is marked as ChannelHandler.Sharable and so the implementation must be safe to be re-used.

嵌套类概要

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

ChannelHandler.Sharable

构造器概要

构造器

构造器和说明
ChannelInitializer()

方法概要

限定符和类型	方法和说明
void	channelRegistered(ChannelHandlerContext ctx) Calls ChannelHandlerContext.fireChannelRegistered() to forward to the next ChannelInboundHandler in the ChannelPipeline.
void	exceptionCaught(ChannelHandlerContext ctx, java.lang.Throwable cause) Handle the Throwable by logging and closing the Channel.
void	handlerAdded(ChannelHandlerContext ctx) Do nothing by default, sub-classes may override this method.
void	handlerRemoved(ChannelHandlerContext ctx) Do nothing by default, sub-classes may override this method.
protected abstract void	initChannel(C ch) This method will be called once the Channel was registered.

从类继承的方法 io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelInactive, channelRead, channelReadComplete, channelUnregistered, channelWritabilityChanged, userEventTriggered

从类继承的方法 io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, isSharable

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

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

构造器详细资料

ChannelInitializer

public ChannelInitializer()

方法详细资料

initChannel

protected abstract void initChannel(C ch)
                             throws java.lang.Exception

This method will be called once the Channel was registered. After the method returns this instance will be removed from the ChannelPipeline of the Channel.

参数:

ch - the Channel which was registered.

抛出:

java.lang.Exception - is thrown if an error occurs. In that case it will be handled by exceptionCaught(ChannelHandlerContext, Throwable) which will by default close the Channel.

channelRegistered

public final void channelRegistered(ChannelHandlerContext ctx)
                             throws java.lang.Exception

从类复制的说明: ChannelInboundHandlerAdapter

Calls ChannelHandlerContext.fireChannelRegistered() to forward to the next ChannelInboundHandler in the ChannelPipeline. Sub-classes may override this method to change behavior.

指定者:

channelRegistered 在接口中 ChannelInboundHandler

覆盖:

channelRegistered 在类中 ChannelInboundHandlerAdapter

抛出:

java.lang.Exception

exceptionCaught

public void exceptionCaught(ChannelHandlerContext ctx,
                            java.lang.Throwable cause)
                     throws java.lang.Exception

Handle the Throwable by logging and closing the Channel. Sub-classes may override this.

指定者:

exceptionCaught 在接口中 ChannelHandler

指定者:

exceptionCaught 在接口中 ChannelInboundHandler

覆盖:

exceptionCaught 在类中 ChannelInboundHandlerAdapter

抛出:

java.lang.Exception

handlerAdded

public void handlerAdded(ChannelHandlerContext ctx)
                  throws java.lang.Exception

Do nothing by default, sub-classes may override this method. If override this method ensure you call super!

指定者:

handlerAdded 在接口中 ChannelHandler

覆盖:

handlerAdded 在类中 ChannelHandlerAdapter

抛出:

java.lang.Exception

handlerRemoved

public void handlerRemoved(ChannelHandlerContext ctx)
                    throws java.lang.Exception

从类复制的说明: ChannelHandlerAdapter

Do nothing by default, sub-classes may override this method.

指定者:

handlerRemoved 在接口中 ChannelHandler

覆盖:

handlerRemoved 在类中 ChannelHandlerAdapter

抛出:

java.lang.Exception