在netty的pipeline中包含两种类型的事件,分别为inbound和outbound,inbound为上行事件,outbound为下行事件。inbound事件为被动触发,在某些情况发生时自动触发;outbound为主动触发,在需要主动执行某些操作时触发。
inbound事件一般通过pipeline的fire**方法触发,包含如下:
1.fireChannelRegistered
channel注册事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelRegistered() {
AbstractChannelHandlerContext.invokeChannelRegistered(head);
return this;
}
2.fireChannelUnregistered
channel解除注册事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelUnregistered() {
AbstractChannelHandlerContext.invokeChannelUnregistered(head);
return this;
}
3.fireChannelActive
channel活跃事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelActive() {
AbstractChannelHandlerContext.invokeChannelActive(head);
return this;
}
4.fireChannelInactive
channel非活跃事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelInactive() {
AbstractChannelHandlerContext.invokeChannelInactive(head);
return this;
}
5.fireExceptionCaught
异常事件,这个事件会在所有handler里传播。
@Override
public final ChannelPipeline fireExceptionCaught(Throwable cause) {
AbstractChannelHandlerContext.invokeExceptionCaught(head, cause);
return this;
}
6.fireUserEventTriggered
用户事件,为inbound事件。
@Override
public final ChannelPipeline fireUserEventTriggered(Object event) {
AbstractChannelHandlerContext.invokeUserEventTriggered(head, event);
return this;
}
7.fireChannelRead
channel读事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelRead(Object msg) {
AbstractChannelHandlerContext.invokeChannelRead(head, msg);
return this;
}
8.fireChannelReadComplete
channel读完成事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelReadComplete() {
AbstractChannelHandlerContext.invokeChannelReadComplete(head);
return this;
}
9.fireChannelWritabilityChanged
channel写状态变化事件,为inbound事件。
@Override
public final ChannelPipeline fireChannelWritabilityChanged() {
AbstractChannelHandlerContext.invokeChannelWritabilityChanged(head);
return this;
}
在pipeline中通过fire触发的事件都会调用AbstractChannelHandlerContext对应的invoke方法,而且都会执行head的invoke方法,该方法会调用该context的handler的对应处理方法,然后调用该context的fire方法向后面的inbound context传播。
outbound事件包含如下:
1.bind
端口绑定事件。
@Override
public final ChannelFuture bind(SocketAddress localAddress) {
return tail.bind(localAddress);
}
2.connect
连接事件。
@Override
public final ChannelFuture connect(SocketAddress remoteAddress) {
return tail.connect(remoteAddress);
}
3.disconnect
断开连接事件。
@Override
public final ChannelFuture disconnect() {
return tail.disconnect();
}
4.close
关闭事件。
@Override
public final ChannelFuture close() {
return tail.close();
}
5.deregister
解除注册事件。
@Override
public final ChannelFuture deregister() {
return tail.deregister();
}
6.flush
刷新数据到网络事件。
@Override
public final ChannelPipeline flush() {
tail.flush();
return this;
}
7.read
读事件,在创建好NioSocketChannel后会触发该事件,用于注册该channel的OP_READ感兴趣事件到event loop的selector。
@Override
public final ChannelPipeline read() {
tail.read();
return this;
}
8.write
写事件。
@Override
public final ChannelFuture write(Object msg) {
return tail.write(msg);
}
9.writeAndFlush
写出数据事件。
@Override
public final ChannelFuture writeAndFlush(Object msg) {
return tail.writeAndFlush(msg);
}
outbound事件都会从pipeline的tail开始传播,从tail向head遍历寻找outbound类型的context,执行该context的handler的对应处理方法。
注意:HeadContext既是ChannelInboundHandler也是ChannelOutboundHandler,但HeadContext只是outbound类型context,不是inbound类型context,在触发inbound事件时,因为从HeadContext起先执行其handler(对于HeadContext和TailContext,其handler就是它们自身)的方法再传播,而其handler必须是ChannelInboundHandler类型,所以HeadContext的对应handler的方法也会执行,这也是HeadContext的handler必须既是ChannelInboundHandler也是ChannelOutboundHandler的原因。