From 56da289bfd82c837fb993de4c8d8271600b6174f Mon Sep 17 00:00:00 2001
From: AmyliaY <471816751@qq.com>
Date: Sat, 15 Feb 2020 15:27:36 +0800
Subject: [PATCH] =?UTF-8?q?BIO=E7=BC=96=E7=A8=8B=EF=BC=8C=E4=BC=AA?=
=?UTF-8?q?=E5=BC=82=E6=AD=A5IO=E7=BC=96=E7=A8=8B=EF=BC=8CNIO=E7=BC=96?=
=?UTF-8?q?=E7=A8=8B=EF=BC=8CAIO=E7=BC=96=E7=A8=8B=EF=BC=8C=E5=8F=8A?=
=?UTF-8?q?=E5=85=B6=E5=AF=B9=E6=AF=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../四种IO编程及对比.md | 319 +++++++++++++++++-
images/Netty/BIO通信模型.png | Bin 0 -> 23816 bytes
images/Netty/Buffer组件类图.png | Bin 0 -> 7350 bytes
images/Netty/Channel组件类图.png | Bin 0 -> 28191 bytes
images/Netty/NIO客户端序列图.png | Bin 0 -> 75647 bytes
images/Netty/NIO服务端序列图.png | Bin 0 -> 56830 bytes
images/Netty/伪异步IO通信模型.png | Bin 0 -> 36221 bytes
...四种IO模型的功能特性对比图.png | Bin 0 -> 36946 bytes
8 files changed, 318 insertions(+), 1 deletion(-)
create mode 100644 images/Netty/BIO通信模型.png
create mode 100644 images/Netty/Buffer组件类图.png
create mode 100644 images/Netty/Channel组件类图.png
create mode 100644 images/Netty/NIO客户端序列图.png
create mode 100644 images/Netty/NIO服务端序列图.png
create mode 100644 images/Netty/伪异步IO通信模型.png
create mode 100644 images/Netty/四种IO模型的功能特性对比图.png
diff --git a/docs/Netty/IOTechnologyBase/四种IO编程及对比.md b/docs/Netty/IOTechnologyBase/四种IO编程及对比.md
index 96c22b4..552db53 100644
--- a/docs/Netty/IOTechnologyBase/四种IO编程及对比.md
+++ b/docs/Netty/IOTechnologyBase/四种IO编程及对比.md
@@ -1 +1,318 @@
-努力更新中...
\ No newline at end of file
+## 传统的BIO编程
+网络编程的基本模型是 Client/Server 模型，也就是两个进程之间进行相互通信，其中服务端提供位置信息(绑定的IP地址和监听端口)，客户端通过连接操作向服务端监听的地址发起连接请求，通过三次握手建立连接，如果连接建立成功，双方就可以通过网络套接字(Socket) 进行通信。
+
+在基于传统同步阻塞模型开发中，ServerSocket 负责绑定IP 地址，启动监听端口，Socket负责发起连接操作。连接成功之后，双方通过输入和输出流进行同步阻塞式通信。
+
+#### BIO通信模型
+通过下面的通信模型图可以发现，采用 BIO 通信模型的服务端，通常由一个独立的 Acceptor线程 负责监听客户端的连接，它接收到客户
+端连接请求之后为每个客户端创建一个新的线程进行链路处理，处理完成之后，通过输出流返回应答给客户端，线程销毁。这就是典型的 “一请求一应答” 通信模型。
+
+
+
+该模型最大的问题就是缺乏弹性伸缩能力，当客户端并发访问量增加后，服务端的线程个数和客户端并发访问数呈1: 1的正比关系，由于线程是 Java虚拟机 非常宝贵的系统资源，当线程数膨胀之后，系统的性能将急剧下降，随着并发访问量的继续增大，系统会发生线程堆栈溢出、创建新线程失败等问题，并最终导致进程宕机或者僵死，不能对外提供服务。
+
+在高性能服务器应用领域，往往需要面向成千上万个客户端的并发连接，这种模型显然无法满足高性能、高并发接入的场景。为了改进 一线程一连接 模型，后来又演进出了一种通过线程池或者消息队列实现1个或者多个线程处理N个客户端的模型，由于它的底层通信机制依然使用 同步阻塞IO，所以被称为 “伪异步”。
+
+## 伪异步IO编程
+为了解决 同步阻塞IO 面临的一个链路需要一个线程处理的问题，后来有人对它的线程模型进行了优化，后端通过一个线程池来处理多个客户端的请求接入，形成 客户端个数M：线程池最大线程数N 的比例关系，其中 M 可以远远大于 N。通过线程池可以灵活地调配线程资源，设置线程的最大值，防止由于海量并发接入导致线程耗尽。
+
+#### 伪异步IO模型图
+采用线程池和任务队列可以实现一种叫做 伪异步的IO通信框架，其模型图下。当有新的客户端接入时，将客户端的 Socket 封装成一个 Task对象 (该类实现了java.lang.Runnable接口)，投递到后端的线程池中进行处理，JDK 的线程池维护一个消息队列和 N 个活跃线程，对消息队列中的任务进行处理。由于线程池可以设置消息队列的大小和最大线程数，因此，它的资源占用是可控的，无论多少个客户端并发访问，都不会导致资源的耗尽和宕机。
+
+
+
+伪异步 IO通信框架 采用了线程池实现，因此避免了为每个请求都创建一个独立线程造成的线程资源耗尽问题。但是由于它底层的通信依然采用同步阻塞模型，因此无法从根本上解决问题。
+
+#### 伪异步IO编程弊端分析
+要对 伪异步IO编程 的弊端进行深入分析，首先我们看两个 Java同步IO 的 API说明，随后结合代码进行详细分析。
+```java
+public abstract class InputStream implements Closeable {
+
+ /**
+ * Reads the next byte of data from the input stream. The value byte is
+ * returned as an int in the range 0 to
+ * 255. If no byte is available because the end of the stream
+ * has been reached, the value -1 is returned. This method
+ * blocks until input data is available, the end of the stream is detected,
+ * or an exception is thrown.
+ *
+ * A subclass must provide an implementation of this method.
+ *
+ * @return the next byte of data, or -1 if the end of the
+ * stream is reached.
+ * @exception IOException if an I/O error occurs.
+ */
+ public abstract int read() throws IOException;
+}
+```
+注意其中的一句话 **“This method blocks until input data is available, the end of the stream is detected, or an exception is thrown”**，当对 Socket 的输入流进行读取操作的时候，它会一直阻塞下去，直到发生如下三种事件。
+
+- 有数据可读；
+- 可用数据已经读取完毕；
+- 发生空指针或者 IO异常。
+
+这意味着当对方发送请求或者应答消息比较缓慢，或者网络传输较慢时，读取输入流一方的通信线程将被长时间阻塞，如果对方要 60s 才能够将数据发送完成，读取一方的 IO线程 也将会被同步阻塞 60s，在此期间，其他接入消息只能在消息队列中排队。
+
+下面我们接着对输出流进行分析，还是看 JDK IO类库 输出流的 API文档，然后结合文档说明进行故障分析。
+```java
+public abstract class OutputStream implements Closeable, Flushable {
+
+ /**
+ * Writes an array of bytes. This method will block until the bytes are *actually written.
+ *
+ * @param b the data.
+ * @exception IOException if an I/O error occurs.
+ * @see java.io.OutputStream#write(byte[], int, int)
+ */
+ public void write(byte b[]) throws IOException {
+ write(b, 0, b.length);
+ }
+}
+```
+当调用 OutputStream 的 write()方法 写输出流的时候，它将会被阻塞，直到所有要发送的字节全部写入完毕，或者发生异常。学习过 TCP/IP 相关知识的人都知道，当消息的接收方处理缓慢的时候，将不能及时地从 TCP缓冲区 读取数据，这将会导致发送方的 TCP window size 不断减小，直到为 0，双方处于 Keep-Alive状态，消息发送方将不能再向 TCP缓冲区 写入消息，这时如果采用的是 同步阻塞IO，write操作 将会被无限期阻塞，直到 TCP window size 大于0 或者发生 IO异常。
+
+通过对输入和输出流的 API文档 进行分析，我们了解到读和写操作都是同步阻塞的，阻塞的时间取决于对方 IO线程 的处理速度和 网络IO 的传输速度。本质上来讲，我们无法保证生产环境的网络状况和对方的应用程序能足够快，如果我们的应用程序依赖对方的处理速度，它的可靠性就非常差。也许在实验室进行的性能测试结果令人满意，但是一旦上线运行，面对恶劣的网络环境和良莠不齐的第三方系统，问题就会如火山一样喷发。
+
+伪异步IO 实际上仅仅是对之前 IO线程模型 的一个简单优化，它无法从根本上解决 同步IO 导致的通信线程阻塞问题。下面我们就简单分析下通信对方返回应答时间过长会引起的级联故障。
+
+1. 服务端处理缓慢，返回应答消息耗费60s， 平时只需要10ms。
+2. 采用伪异步I/O的线程正在读取故障服务节点的响应，由于读取输入流是阻塞的，它将会被同步阻塞60s。
+3. 假如所有的可用线程都被故障服务器阻塞，那后续所有的1/O消息都将在队列中排队。
+4. 由于线程池采用阻塞队列实现，当队列积满之后，后续入队列的操作将被阻塞。
+5. 由于前端只有一个Accptor线程接收客户端接入，它被阻塞在线程池的同步阻塞队列之后，新的客户端请求消息将被拒绝，客户端会发生大量的连接超时。
+6. 由于几乎所有的连接都超时，调用者会认为系统已经崩溃，无法接收新的请求消息。
+
+## NIO编程
+与 Socket类 和 ServerSocket类 相对应，NIO 也提供了 SocketChannel 和 ServerSocketChannel 两种不同的套接字通道实现。这两种新增的通道都支持阻塞和非阻塞两种模式。阻塞模式使用非常简单，但是性能和可靠性都不好，非阻塞模式则正好相反。开发人员可以根据自
+己的需要来选择合适的模式。一般来说，低负载、低并发的应用程序可以选择 同步阻塞IO，以降低编程复杂度；对于高负载、高并发的网络应用，需要使用 NIO 的非阻塞模式进行开发。
+
+#### NIO类库简介
+NIO类库 是在 JDK 1.4 中引入的。NIO 弥补了原来 同步阻塞IO 的不足，它在 标准Java代码 中提供了高速的、面向块的IO。下面我们简单看一下 NIO类库 及其 相关概念。
+
+**1、缓冲区Buffer**
+Buffer对象 包含了一些要写入或者要读出的数据。在 NIO类库 中加入 Buffer对象，是其与 原IO类库 的一个重要区别。在面向流的 IO 中，可以将数据直接写入或者将数据直接读到 Stream对象 中。在NIO库中，所有数据都是用缓冲区处理的。在读取数据时，它是直接读到缓冲区中的；在写入数据时，写入到缓冲区中。任何时候访问 NIO 中的数据，都是通过缓冲区进行操作。
+
+缓冲区实质上是一个数组。通常它是一个字节数组（ByteBuffer），也可以使用其他种类的数组。但是一个缓冲区不仅仅是一个数组，缓冲区提供了对数据的结构化访问以及维护读写位置（limit）等信息。最常用的缓冲区是 ByteBuffer，一个 ByteBuffer 提供了一组功能用于操作 byte数组。除了 ByteBuffer，还有其他的一些缓冲区，事实上，每一种 Java基本类型（除了 boolean）都对应有一种与之对应的缓冲区，如：CharBuffer、IntBuffer、DoubleBuffer 等等。Buffer组件中主要类的类图如下所示。
+
+
+
+除了ByteBuffer，每一个 Buffer类 都有完全一样的操作，只是它们所处理的数据类型不一样。因为大多数 标准IO操作 都使用 ByteBuffer，所以它在具有一般缓冲区的操作之外还提供了一些特有的操作，以方便网络读写。
+
+**2、通道Channel**
+Channel 是一个通道，它就像自来水管一样，网络数据通过 Channel 读取和写入。通道与流的不同之处在于通道是双向的，可以用于读、写，或者二者同时进行；流是单向的，要么是 InputStream，要么是 OutputStream。因为 Channel 是全双工的，所以它可以比流更好地映射底层操作系统的 API。特别是在 UNIX网络编程模型 中，底层操作系统的通道都是全双工的，同时支持读写操作。Channel组件中 主要类的类图如下所示，从中我们可以看到最常用的 ServerSocketChannel 和 SocketChannel。
+
+
+
+**3、多路复用器Selector**
+多路复用器Selector 是 Java NIO编程 的基础，熟练地掌握 Selector 对于 NIO编程 至关重要。多路复用器提供选择已经就绪的任务的能力。简单来讲，Selector会不断地轮询 “注册在其上的Channel”，如果某个 Channel 上面发生读或者写事件，这个 Channel 就处于就绪状态，会被 Selector 轮询出来，然后通过 SelectionKey 可以获取 “就绪 Channel 的集合”，进行后续的 IO操作。
+
+一个 多路复用器Selector 可以同时轮询多个 Channel，由于 JDK 使用了 epoll() 代替传统的 select 的实现，所以它并没有最大连接句柄的限制。这也就意味着，只需要一个线程负责 Selector 的轮询，就可以接入成千上万的客户端。下面，我们通过 NIO编程的序列图 和 源码分析来熟悉相关的概念。
+
+#### NIO服务端序列图
+
+
+
+下面，我们看一下 NIO服务端 的主要创建过程。
+
+1、打开 ServerSocketChannel，用于监听客户端的连接，它是所有客户端连接的
+父管道，示例代码如下。
+```java
+ ServerSocketChannel acceptorSvr = ServerSocketChannel.open();
+```
+2、绑定监听端口，设置连接为非阻塞模式，示例代码如下。
+```java
+ acceptorSvr.socket().bind(new InetSocketAddress(InetAddress.getByName("IP"), port));
+ acceptorSvr.configureBlocking(false);
+```
+3、创建 Reactor线程，创建多路复用器并启动线程，示例代码如下。
+```java
+ Selector selector = Selector.open();
+ New Thread (new ReactorTask()).start();
+```
+4、将 ServerSocketChannel 注册到 Reactor线程 的 多路复用器Selector 上，监听 ACCEPT事件，示例代码如下。
+```java
+ SelectionKey key = acceptorSvr.register(selector, SelectionKey.OP_ ACCEPT, ioHandler);
+```
+5、多路复用器在线程 run()方法 的无限循环体内轮询 准备就绪的Key，示例代码如下。
+```java
+ int num = selector.select();
+ Set selectedKeys = selector.selectedKeys();
+ Iterator it = selectedKeys.iterator();
+ while (it.hasNext()) {
+ SelectionKey key = (SelectionKey) it.next();
+ // .... deal with IO event ...
+```
+6、多路复用器Selector 监听到有新的客户端接入，处理新的接入请求，完成 TCP三次握手，建立物理链路，示例代码如下。
+```java
+ SocketChannel channel = svrChannel.accept();
+```
+7、设置客户端链路为非阻塞模式，示例代码如下。
+```java
+ channel.configureBlocking(false);
+ channel.socket().setReuseAddress(true);
+ ......
+```
+8、将新接入的客户端连接注册到 Reactor线程 的多路复用器上，监听读操作，读取客户端发送的网络消息，示例代码如下。
+```java
+ SelectionKey key = socketChannel.register(selector, SelectionKey.OP_READ, ioHandler);
+```
+9、异步读取客户端请求消息到缓冲区，示例代码如下。
+```java
+ int readNumber = channel.read(receivedBuffer);
+```
+10、对 ByteBuffer 进行编解码，如果有半包消息指针 reset，继续读取后续的报文，将解码成功的消息封装成 Task，投递到业务线程池中,进行业务逻辑编排，示例代码如下。
+```java
+ List messageList = null;
+ while (byteBuffer.hasRemain()) {
+ byteBuffer.mark();
+ Object message = decode(byteBuffer) ;
+ if (message == null) {
+ byteBuffer.reset();
+ break;
+ }
+ messageList.add(message);
+ }
+ if (!byteBuffer.hasRemain()) {
+ byteBuffer.clear();
+ } else {
+ byteBuffer.compact();
+ }
+ if (messageList != null && !messageList.isEmpty()) {
+ for (Object message : messageList) {
+ handlerTask(message);
+ }
+ }
+```
+11、将 POJO对象 encode 成 ByteBuffer，调用 SocketChannel 的 异步write接口，将消息异步发送给客户端，示例代码如下。
+```java
+ socketChannel.write(byteBuffer);
+```
+注意：如果发送区 TCP缓冲区满，会导致写半包，此时，需要注册监听写操作位，循环写，直到整包消息写入 TCP缓冲区。对于 “半包问题” 此处暂不赘述，后续会单独写一篇详细分析 Netty 的处理策略。
+
+#### NIO 客户端序列图
+
+
+
+1、打开 SocketChannel，绑定客户端本地地址 (可选，默认系统会随机分配一个可用的本地地址)，示例代码如下。
+```java
+ SocketChannel clientChannel = SocketChannel.open();
+```
+2、设置 SocketChannel 为非阻塞模式，同时设置客户端连接的 TCP参数，示例代码如下。
+```java
+ clientChannel.configureBlocking(false);
+ socket.setReuseAddress(true);
+ socket.setReceiveBufferSize(BUFFER_SIZE);
+ socket.setSendBufferSize(BUFFER_SIZE);
+```
+3、异步连接服务端，示例代码如下。
+```java
+ boolean connected = clientChannel.connect( new InetSocketAddress("ip", port) );
+```
+4、判断是否连接成功，如果连接成功，则直接注册读状态位到多路复用器中，如果当前没有连接成功，则重连 (异步连接，返回false，说明客户端已经发送 syne包，服务端没有返回 ack包，物理链路还没有建立)，示例代码如下。
+```java
+ if (connected) {
+ clientChannel.register(selector, SelectionKey.OP_READ, ioHandler);
+ } else {
+ clientChannel.register(selector, SelectionKey.OP_CONNECT, ioHandler);
+ }
+```
+5、向 Reactor线程 的多路复用器注册 OP_CONNECT 状态位，监听服务端的 TCP ACK应答，示例代码如下。
+```java
+ clientChannel.register(selector, SelectionKey.OP_CONNECT, ioHandler);
+```
+6、创建 Reactor线程，创建多路复用器并启动线程，代码如下。
+```java
+ Selector selector = Selector.open();
+ New Thread( new ReactorTask() ).start();
+```
+7、多路复用器在线程 run()方法 的无限循环体内轮询 准备就绪的Key，代码如下。
+```java
+ int num = selector.select();
+ Set selectedKeys = selector.selectedKeys();
+ Iterator it = selectedKeys.iterator();
+ while (it.hasNext()) {
+ SelectionKey key = (SelectionKey) it.next();
+ // ... deal with IO event ...
+ }
+```
+8、接收 connect事件，并进行处理，示例代码如下。
+```java
+ if (key.isConnectable()) {
+ // handlerConnect();
+ }
+```
+9、判断连接结果，如果连接成功，注册读事件到多路复用器，示例代码如下。
+```java
+ if(channel.finishConnect()) {
+ registerRead();
+ }
+```
+10、注册读事件到多路复用器，示例代码如下。
+```java
+ clientChannel.register(selector, SelectionKey.OP_READ, ioHandler);
+```
+11、异步读客户端请求消息到缓冲区，示例代码如下。
+```java
+ int readNumber = channel.read(receivedBuffer);
+```
+12、对 ByteBuffer 进行编解码，如果有半包消息接收缓冲区 Reset，继续读取后续的报文，将解码成功的消息封装成 Task，投递到业务线程池中，进行业务逻辑编排。示例代码如下。
+```java
+ List messageList = null;
+ while (byteBuffer.hasRemain()) {
+ byteBuffer.mark();
+ object message = decode(byteBuffer);
+ if (message == nu11) {
+ byteBuffer.reset();
+ break;
+ }
+ messageList.add(message);
+ }
+ if (!byteBuffer.hasRemain()) {
+ byteBuffer.clear();
+ } else {
+ byteBuffer.compact();
+ }
+ if ( messageList != null && !messageList.isEmpty() )
+ for (Object message : messageList) {
+ handlerTask(message);
+ }
+ }
+```
+13、将 POJO对象 encode成 ByteBuffer，调用 SocketChannel 的 异步write接口，将消息异步发送给客户端。示例代码如下。
+```java
+ socketChannel.write(buffer);
+```
+
+## AIO编程
+NIO2.0 引入了新的异步通道的概念，并提供了异步文件通道和异步套接字通道的实现。异步通道提供以下两种方式获取获取操作结果。
+- 通过 java.util.concurrent.Future类 来表示异步操作的结果;
+- 在执行异步操作的时候传入一个 java.nio.channels.CompletionHandler接口 的实现类作为操作完成的回调。
+
+NIO2.0 的异步套接字通道是真正的 异步非阻塞IO，对应于 UNIX网络编程 中的 事件驱动IO (AIO)。它不需要通过多路复用器 (Selector) 对注册的通道进行轮询操作即可实现异步读写，从而简化了 NIO 的编程模型。
+
+由于在实际开发中使用较少，所以这里不对 AIO 进行详细分析。
+
+## 四种IO编程模型的对比
+对比之前，这里再澄清一下 “伪异步IO” 的概念。伪异步IO 的概念完全来源于实践，并没有官方说法。在 JDK NIO编程 没有流行之前，为了解决 Tomcat 通信线程同步IO 导致业务线程被挂住的问题，大家想到了一个办法，在通信线程和业务线程之间做个缓冲区，这个缓冲区用于隔离 IO线程 和业务线程间的直接访问，这样业务线程就不会被 IO线程 阻塞。而对于后端的业务侧来说，将消息或者 Task 放到线程池后就返回了，它不再直接访问 IO线程 或者进行 IO读写，这样也就不会被同步阻塞。
+
+
+
+## 选择 Netty 开发项目的理由
+从可维护性角度看，由于 NIO 采用了异步非阻塞编程模型，而且是一个 IO线程 处理多条链路，它的调试和跟踪非常麻烦，特别是生产环境中的问题，我们无法进行有效的调试和跟踪，往往只能靠一些日志来辅助分析，定位难度很大。
+#### 为什么不选择 Java原生NIO 进行开发
+1. NIO 的类库和 API 使用起来非常繁杂，需要熟练掌握 Selector、ServerSocketChannel、SocketChannel、ByteBuffer 等。
+2. 需要具备其他的额外技能做铺垫，例如，熟悉 Java多线程编程。这是因为 NIO编程 涉及到 Reactor模式，你必须对 多线程 和 网路编程 非常熟悉，才能编写出高质量的 NIO程序。
+3. 可靠性能力补齐，工作量和难度都非常大。例如客户端面临：断连重连、网络闪断、半包读写、失败缓存、网络拥塞和异常码流的处理，等问题。
+4. JDK NIO 的 BUG，例如臭名昭著的 epoll bug，它会导致 Selector空轮询，最终导致 CPU 100%。虽然官方声称修复了该问题，但是直到 JDK 1.7版本 该问题仍旧未得到彻底的解决。
+
+#### 为什么选择 Netty 进行开发
+Netty 是业界最流行的 NIO框架 之一，它的健壮性、功能、性能、可定制性和可扩展性在同类框架中都是首屈一指的，已经得到成百上千的商用项目验证，例如 Hadoop 的 RPC框架 Avro ，阿里的 RPC框架 Dubbo 就使用了 Netty 作为底层通信框架。通过对Netty的分析，我们将它的优点总结如下。
+- API使用简单，开发门槛低；
+- 功能强大，预置了多种编解码功能，支持多种主流协议；
+- 定制能力强，可以通过 ChannelHandler 对通信框架进行灵活地扩展；
+- 性能高，通过与其他业界主流的 NIO框架 对比，Netty 的综合性能最优；
+- 成熟、稳定，Netty 修复了已经发现的所有 JDK NIO BUG，业务开发人员不需要再为 NIO 的 BUG 而烦恼；
+- 社区活跃，版本迭代周期短，发现的 BUG 可以被及时修复，同时，更多的新功能会加入；
+- 经历了大规模的商业应用考验，质量得到验证。Netty 在互联网、大数据、网络游戏、企业应用、电信软件等众多行业已经得到了成功商用，证明它已经完全能够满足不同行业的商业应用了。
+
+正是因为这些优点，Netty 逐渐成为了 Java NIO编程 的首选框架。
\ No newline at end of file
diff --git a/images/Netty/BIO通信模型.png b/images/Netty/BIO通信模型.png
new file mode 100644
index 0000000000000000000000000000000000000000..6830bb239ce70498a76bfed45c751574933d2cdc
GIT binary patch
literal 23816
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ⅈ
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
literal 0
HcmV?d00001
diff --git a/images/Netty/Channel组件类图.png b/images/Netty/Channel组件类图.png
new file mode 100644
index 0000000000000000000000000000000000000000..12d0e6da46da60b08bbf5626835b02386fe3c0c6
GIT binary patch
literal 28191
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