Netty-ChannelHandler-ChannelPipeline

出站操作和数据将由ChannelOutboundHandler处理。它的方法将被Channel、ChannelPipeline以及ChannelHandlerContext调用。

ChannelOutboundHandler可以按需推迟操作或者事件。

| 类型 | 描述 |

| — | — |

| bind(ChannelHandlerContext, SockertAddress, ChannelPromise) | 当请求将Channel绑定到本地地址时被调用 |

| connect(ChannelHandlerContext, SocketAddress, SockertAddress, ChannelPromise) | 当请求将Channel连接到远程节点时被调用 |

| disconnect(ChannelHandlerContext, ChannelPromise) | 当请求将Channel从远程节点断开时被调用 |

| close(ChannelHandlerContext, ChannelPromise) | 当请求关闭Channel时被调用 |

| deregister(ChannelHandlerContext, ChannelPromise) | 当请求将Channel丛它的EventLoop注销时被调用 |

| read(ChannelHandlerContext) | 当请求从Channel读取更多的数据时被调用 |

| flush(ChannelHandlerContext) | 当请求通过Channel将入队数据冲刷到远程节点时被调用 |

| write(ChannelHandlerContext, Object, ChannelPromise) | 当请求通过Channel将数据写到远程节点时被调用 |

ChannelOutboundHandler中的大部分方法都需要一个ChannelPromise参数，方便在操作完成时获取通知。ChannelPromise时ChannelFuture的一个子类，定义了一些可写方法，如setSuccess()和setFailure()方法

ChannelHandler适配器

ChannelInboundHandlerAdapter和ChannelOutboundHandlerAdapter两个适配器分别提供了ChannelInboundHandler和ChannelOutboundHandler的基本实现。通过扩展抽象类ChannelHandlerAdapter，它们获得了它们共同的超接口ChannelHandler的方法。

ChannelHandlerAdapter提供了isSharable()，如果其对应的实现被注解标注为Sharable，这方法将返回true，表示它可以被添加到多个ChannelPipeline。

ChannelInboundHandlerAdapter和ChannelOutboundHandlerAdapter中的方法体调用了其相关联的ChannelHandlerContext上的等效方法，从而将事件转发到了ChannelPipeline中的下一个ChannelHandler中。

资源管理

Netty目前定义了4种泄露检测级别：

| 级别 | 描述 |

| — | — |

| DISABLED | 禁用泄漏检测。只有在详尽的测试之后才应设置为这值 |

| SIMPLE | 使用1%的默认采样率检测并报告任何发现的泄漏。这是默认级别，适合绝大部分情况 |

| ADVANCED | 使用默认的采样率，报告所发现的任何的泄漏以及对应的消息被访问的位置 |

| PARANOID | 类似于ADVANCED,但是其将会对每次(对消息的)访问都进行采样。会对性能有很大影响，只能在调试阶段使用 |

java -Dio.netty.leakDetectionLevel=ADVANCED

如果一个消息被消费或者丢弃了，并且没有传递给ChannelPipeline中的下一个ChannelOutboundHandler，那么用户就有责任调用ReferenceCountUtil.release()。如果消息到达了实际的传输层，那么当它被写入时或者Channel关闭时，都将被自动释放。

ChannelPipeline接口

---

每一个新创建的Channel都将会被分配一个新的ChannelPipeline。这项关联是永久性的；Channel既不能附加另外一个ChannelPipeline，也不能分离当前的。

根据事件的起源，事件将会被ChannelInboundHandler或者ChannelOutboundHandler处理。随后，会调用ChannelHandlerContext实现，它将被转发给同一超类型的下一个ChannelHandler。

ChannelHandlerContext使ChannelHandler能够和它的ChannelPipeline以及其他的ChannelHandler交互。ChannelHandler可以通知其所属的ChannelPipeline中的下一个ChannelHandler，甚至可以动态修改它所属的ChannelPipeline。

在ChannelPipeline传播事件时，它会测试ChannelPipeline中的下一个ChannelHandler的类型是否和事件的运动方向相匹配。如果不匹配，ChannelPipeline将跳过该ChannelHandler并前进到下一个，直到它找到和该事件所期望的方向相匹配的为止。（ChannelHandler可以同时实现ChannelInboundHandler和ChannelOutboundHandler接口）

修改ChannelPipeline

ChannelHandler可以通过添加、删除或者替换其他的ChannelHandler来实时地修改ChannelPipeline的布局。

| 名称 | 描述 |

| — | — |

| addFirst(),addBefore(),addAfter(),addLast() | 将一个ChannelHandler添加到ChannelPipeline |

| remove() | 将一个ChannelHandler从ChannelPipeline中移除 |

| replace() | 将ChannelPipeline中的一个ChannelHandler替换为另一个ChannelHandler |

| get() | 通过类型或者名称返回ChannelHandler |

| context() | 返回和ChannelHandler绑定的ChannelHandlerContext |

| names() | 返回ChannelPipeline中所有的ChannelHandle的名称 |

触发事件

ChannelPipeline的API公开了用于调用入站和出站操作的附加方法，用于通知ChannelInboundHandler在ChannelPipeline中所发生的事件。

| 名称 | 描述 |

| — | — |

| fireChannelRegistered | 调用ChannelPipeline中下一个ChannelInboundHandler的channelRegistered(ChannelHandlerContext)方法 |

| fireChannelUnregistered | 调用ChannelPipeline中下一个ChannelInboundHandler的channelUnregistered(ChannelHandlerContext)方法 |

| fireChannelActive | 调用ChannelPipeline中下一个ChannelInboundHandler的channelActive(ChannelHandlerContext) |

| fireChannelInActive | 调用ChannelPipeline中下一个ChannelInboundHandler的channelInactive(ChannelHandlerContext)方法 |

| fireExceptionCaught | 调用ChannelPipeline中下一个ChannelInboundHandler的exceptionCaught(ChannelHandlertext, Throwable)方法 |

| fireUserEventTriggerd | 调用ChannelPipeline中下一个ChannelInboundHandler的userEventTriggered(ChannelHandlertext, Object)方法 |

| fireChannelRead | 调用ChannelPipeline中下一个ChannelInboundHandler的channelRead(ChannelHandlertext, Object msg)方法 |

| fireChannelReadComplete | 调用ChannelPipeline中下一个ChannelInboundHandler的channelReadComplete(ChannelHandlertext)方法 |

| fireChannelWritabilityChanged | 调用ChannelPipeline中下一个ChannelInboundHandler的channelWritabilityChanged(ChannelHandlertext)方法 |

ChannelPipelin的出站操作

| 名称 | 描述 |

| — | — |

| bind | 将Channel绑定到一个本地地址，将调用ChannelPipeline中的下一个ChannelOutboundHandler的bind(ChannelHandlerContext,Socket,ChannelPromise)方法 |

| connect | 将Channel连接到一个远程地址，这将调用ChannelPipeline中的下一个ChannelOutboundHandler的connect(ChannelHandlerContext,Socket,ChannelPromise)方法 |

| disconnect | 将Channel断开连接。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的disconnect(ChannelHandlerContext,Socket,ChannelPromise)方法 |

| close | 将Channel关闭。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的close(ChannelHandlerContext,ChannelPromise)方法 |

| deregister | 将Channel从它先前分配的EventExecutor(即EventLoop)中注销，这将调用ChannelPipeline中的下一个ChannelOutboundHandler的deregister(ChannelHandlerContext,ChannelPromise)方法 |

| flush | 冲刷Channel所有挂起的写入。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的flush(ChannelHandlerContext)方法 |

| write | 将消息写入Channel。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的write(ChannelContext,Object msg,ChannelPromise)方法。这并不会将消息写入底层的Socket，而只会将它放入到队列中。要将它写入到Socket，需要调用flush或者writeAndFlush方法 |

| writeAndFlush | 先调用write再调用flush的便利方法 |

| read | 请求从Channel中读取更多的数据。这将调用ChannelPipeline中的下一个ChannelOutboundHandler的read(ChannelHandlerContext)方法 |

1. ChannelPipeline保存了与Channel相关联的ChannelHandler

2. ChannelPipeline可以根据需要，通过添加或者删除ChannelHandler来动态修改

3. ChannelPipeline有着丰富的API调用，以响应入站和出站事件

ChanneHandlerContext接口

======================

ChannelHandlerContext代表了ChannelHandler和ChannelPipeline之间的关联。每当有ChannelHandler添加到ChannelPipeline中时，都会创建ChannelHandlerContext。ChannelHandlerContext的主要功能是管理它所关联的ChannelHandler和在同一个ChannelPipeline中的其他ChannelHandler之间的交互。

ChannelHandlerContext有很多方法，其中一些方法也存在于Channel和ChannelPipeline本身上。如果调用Channel或者ChannelPipeline上的方法，它们将沿着整个ChannelPipeline进行传播，而调用ChannelHandlerContext上的相同方法，则从当前所关联的ChannelHandler开始，并且只会传播给位于该ChannelHandler的下一个能够处理该事件的ChannelHandler。

| 方法名称 | 描述 |

| — | — |

| alloc | 返回和这个实例相关的Channel所配置的ByteBufAllocator |

| bind | 绑定到给定的SocketAddress，并返回ChannelFuture |

| channel | 返回绑定到这个实例的Channel |

| close | 关闭Channel，并返回ChannelFuture |

| connect | 连接给定的SocketAddress，并返回ChannelFuture |

| deregister | 从之前分配的EventExecutor注销，并返回ChannelFuture |

| disconnect | 从远程节点断开，并返回ChannelFuture |

| executor | 返回调度事件的EventExecutor |

| fireChannelActive | 触发对下一个ChannelInboundHandler上的channelActive()方法的调用 |

| fireChannelInActive | 触发下一个ChannelInboundHandler上的channelInActive()方法 |

| fireChannelRead | 触发对下一个ChannelInboundHandler上的channelRead()方法 |

| fireChannelReadComplete | 触发对下一个ChannelInboundHandler上的channelReadComplete()方法的调用 |

| fireChannelRegistered | 触发对下一个ChanneInboundHandler上的fireChannelRegistered方法的调用 |

| fireChannelUnregistered | 触发对下一个ChannelInboundHandler上的fireChannelUnregistered方法的调用 |

| fireChannelWritabilityChanged | 触发对下一个ChannelInboundHandler上的fireChannelWritabilityChanged方法的调用 |

| fireExceptionCaught | 触发对下一个ChannelInboundHandler上的fireExceptionCaught方法的调用 |

| fireUserEventTriggered | 触发对下一个ChannelInboundHandler上的fireUserEventTriggered(Object evt)方法的调用 |

| handler | 返回绑定到这个实例的ChannelHandler |

| isRemoved | 如果从关联的ChannelHandler已经被从ChannelPipeline中移除则返回true |

| name | 返回这个实例的唯一名称 |

| pipeline | 返回这个实例相关联的ChannelPipeline |

| read | 将数据从Channel读取到第一个入站缓冲区；如果读取成功则触发一个channelRead事件，并（在最后一个消息被被读取完成后）通知ChannelInboundHandler的channelReadComplete(ChannelHandlerContext)方法 |

| write | 通过这个实例写入消息并经过ChannelPipeline |

| writeAndFlush | 通过这个实例写入并冲刷消息并经过ChannelPipeline |

1. ChannelHanlderContext和ChannelHandler之间的关联是永远不会改变的，所以缓存对它的引用是安全的

2. ChannelHandlerContext上的方法产生的事件流更短，应该利用这个特性尽可能的获得最大的性能

使用ChannelHandlerContext

让ChannePipeline从某个特定的点开始传播的原因：

1. 为了减少将事件传经对它不感兴趣的ChannelHandler所带来的开销

2. 为了减少将事件传经那些可能会对它感兴趣的ChannelHandler

要想调用从某个特定的ChannelHandler开始处理的过程，必须获取到在(ChannelPipeline)该ChannelHandler之前的hannelHandler所关联的ChannelHandlerContext。这个ChannelHandlerContext将调用和它所关联的ChannelHandler之后的ChannelHandler。

一个ChannelHandler可以从属于多个ChannelPipeline，所以它(同一个ChannelHandler)也可以绑定到多个ChannelHandlerContext实例。用于这种用法的ChannelHandler必须使用@Shareable注解标注；否则将它添加到多个ChannelPipeline时将会触发异常。显而易见，为了安全地被用于多个并发的Channel(即连接)，这样的ChannelHandler必须是线程安全的。

为何要共享一个ChannelHandler？

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
存中…(img-z0sDA3Wc-1715853600333)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！