Netty 事件
在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的原因。
浙公网安备 33010602011771号