知识卡片
无状态处理器可共享
ChannelHandler 实例跨流水线复用须保证并发安全。无通道私有可变状态的处理器可标注 @ChannelHandler.Sharable;通道状态可放入关联属性。注解只声明可共享,不自动保证线程安全。未标注的 ChannelHandlerAdapter 通常不能重复加入流水线;isSharable() 可检查标注。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《Java高并发核心编程.卷1,NIO、Netty、Redis、ZooKeeper》第5章《Netty核心原理与基础实战》(源文件:_epub-src/OEBPS/Text/Section0005_0009.xhtml)
- 结论依据:原文说明未加 @Sharable 时共享处理器会抛异常,并建议无状态处理器设计成共享模式。
- 原始内容:所以,如果在Handler实例中没有与特定通道强相关的数据或者状态,建议设计成共享模式。……如果没有加@ChannelHandler.Sharable注解,试图将同一个Handler实例添加到多个ChannelPipeline时,Netty将会抛出异常。
- 机制核验:[Netty ChannelHandler API](https://netty.io/4.1/api/io/netty/channel/ChannelHandler.html)。