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