Netty 4.0中的那些变化

缺乏、安全感 2021-12-20 16:57 367阅读 0赞

Netty 是最优秀的NET库，每个大版本的一些特性都会引入注目，本文带你了解重温Netty 4.0的值得注意的改变和新特性，帮助你将应用程序从老的Netty3迁移到最新的版本上。翻译自官方文档[New and noteworthy in 4.0][]。

**目录**

1. 项目结构的改变

2. 通用 API 的改变

3. Buffer API 的改变

3.1.ChannelBuffer → ByteBuf

3.2.ByteBuf 不是一个接口，而是一个抽象类class

3.3. 大部分的buffer变成了动态的，具有可配置的最大容量

3.4. 新的buffer类型: CompositeByteBuf

3.5. 可预知的NIO buffer转型

3.6. 对小端序(Little endian)支持的改变

3.7. 池化buffer Pooled buffers

3.7.1.ByteBuf 总是使用引用计数(reference counted)

3.7.2.自动 buffer泄漏检查

4.io.netty.util.concurrent

5. Channel API 的改变

5.1 改组 ChannelHandler 接口

5.1.1 Upstream → Inbound, Downstream → Outbound

5.1.2 新的 ChannelHandler 类型继承关系

5.1.3 ChannelHandler 不需要 event object

5.1.4 简化channel 状态模型

5.1.5 write() 不会自动 flush

5.2 可知的和不易出错的入站流量挂起(暂停读取)

5.3 半关闭的socket

5.4 灵活的I/O线程分配

5.5 能够从一个已存在的jdk套接字上创建一个Channel

5.6 取消注册和重新注册一个Channel从/到一个I/O线程

5.7 调度任意的任务到I/O线程里运行

5.8 简化shutdown

5.9 类型安全的ChannelOption

5.10 AttributeMap

5.11 新的 bootstrap API

5.12 ChannelFuture → ChannelFuture 和 ChannelPromise

6. 良好定义的线程模型

6.1 没有 ExecutionHandler 了 - 它被放入核心代码中

7. 编解码框架的改变

7.1 Codec embedder → EmbeddedChannel

7.2 HTTP codec

7.3 transport 实现的改变

8. 用例学习：迁移阶乘（Factorial）的例子

8.1 迁移服务端

8.2 迁移客户端

--------------------

# 1. 项目结构的改变 #

Netty的包名从 `org.jboss.netty` 改成 `io.netty`， 因为 [我们不再是JBoss.org的一份子了][JBoss.org]。二进制的 JAR 文件被分成多个模块， 这样用户可以从类路径中排除不需要的特性. 当前的结构如下:

<table> 
 <thead> 
  <tr> 
   <th>Artifact ID</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>netty-parent</code></td> 
   <td>Maven parent POM</td> 
  </tr> 
  <tr> 
   <td><code>netty-common</code></td> 
   <td>Utility classes and logging facade</td> 
  </tr> 
  <tr> 
   <td><code>netty-buffer</code></td> 
   <td><code>ByteBuf</code>&nbsp;API that replaces&nbsp;<code>java.nio.ByteBuffer</code></td> 
  </tr> 
  <tr> 
   <td><code>netty-transport</code></td> 
   <td>Channel API and core transports</td> 
  </tr> 
  <tr> 
   <td><code>netty-transport-rxtx</code></td> 
   <td><a href="http://goo.gl/vTFBv" rel="nofollow">Rxtx</a>&nbsp;transport</td> 
  </tr> 
  <tr> 
   <td><code>netty-transport-sctp</code></td> 
   <td><a href="http://goo.gl/oXxaU" rel="nofollow">SCTP</a>&nbsp;transport</td> 
  </tr> 
  <tr> 
   <td><code>netty-transport-udt</code></td> 
   <td><a href="http://udt.sourceforge.net/" rel="nofollow">UDT</a>&nbsp;transport</td> 
  </tr> 
  <tr> 
   <td><code>netty-handler</code></td> 
   <td>Useful&nbsp;<code>ChannelHandler</code>&nbsp;implementations</td> 
  </tr> 
  <tr> 
   <td><code>netty-codec</code></td> 
   <td>Codec framework that helps write an encoder and a decoder</td> 
  </tr> 
  <tr> 
   <td><code>netty-codec-http</code></td> 
   <td>Codecs related with HTTP, Web Sockets, SPDY, and RTSP</td> 
  </tr> 
  <tr> 
   <td><code>netty-codec-socks</code></td> 
   <td>Codecs related with SOCKS protocol</td> 
  </tr> 
  <tr> 
   <td><code>netty-all</code></td> 
   <td>All-in-one JAR that combines all artifacts above</td> 
  </tr> 
  <tr> 
   <td><code>netty-tarball</code></td> 
   <td>Tarball distribution</td> 
  </tr> 
  <tr> 
   <td><code>netty-example</code></td> 
   <td>Examples</td> 
  </tr> 
  <tr> 
   <td><code>netty-testsuite-*</code></td> 
   <td>A collection of integration tests</td> 
  </tr> 
  <tr> 
   <td><code>netty-microbench</code></td> 
   <td>Microbenchmarks</td> 
  </tr> 
 </tbody> 
</table>

现在所有的 artifacts (除了 `netty-all.jar`) 都实现了 OSGi bundle, 可以用在你的 OSGi 容器中.

# 2. 通用 API 的改变 #

*  Netty中大部分的操作都支持链式方法，简化了操作
 *  不能配置的getter 不再有`get-` 前缀. (例如 `Channel.getRemoteAddress()` → `Channel.remoteAddress()`)
 *  布尔属性仍然保留 `is-` 前缀， 避免造成迷惑 (例如 'empty' 既是形容词也是动词, 所以 `empty()` 有两个意思)
 *  4.0 CR4 和 4.0 CR5之间的 改变请参照 [Netty 4.0.0.CR5 released with new-new API][]

# 3. Buffer API 的改变 #

## `3.1.ChannelBuffer` → `ByteBuf` ##

由于上面提到的项目结构的改变, buffer API可以作为一个独立的包使用. 即使你对使用Netty作为网络应用框架不感兴趣，你也可以使用buffer API.  
因此, 类型名`ChannelBuffer` 不再合适了， 所以改名为 `ByteBuf`.

用来创建新buffer的工具类 `ChannelBuffers`被分成了两个工具类： `Unpooled` 和 `ByteBufUtil`. 从名字`Unpooled`上也能猜出, 4.0引入了池化的 `ByteBuf`， 可以通过 `ByteBufAllocator`的具体实现来分配(allocated).

## `3.2.ByteBuf` 不是一个接口，而是一个抽象类class ##

根据我们内部的性能测试，将`ByteBuf` 从接口改为抽象类可以给总吞吐量带来5%的提升.

## `3.`3. 大部分的buffer变成了动态的，具有可配置的最大容量 ##

在3.x, buffer可以是固定大小或者动态的，固定大小的buffer一旦创建容量就不能改变。 而动态buffer的容量在`write*(...)`方法需要更多空间时可以改变。  
自4.0开始， 所有的buffer都是动态的。 然而，它们要比以前的动态buffer更好。你可以更容易更安全地增加或者减少buffer的容量。因为提供了新的方法 `ByteBuf.capacity(int newCapacity)`所以  
改变容量更容易。之所以说它安全， 是因为你可以设置一个最大容量，这样buffer就不会不限制的增长.

// No more dynamicBuffer() - use buffer().
    ByteBuf buf = Unpooled.buffer();
    // Increase the capacity of the buffer.
    buf.capacity(1024);
    ...
    // Decrease the capacity of the buffer (the last 512 bytes are deleted.)
    buf.capacity(512);

## `3.`4. 新的buffer类型: `CompositeByteBuf` ##

一个名叫`CompositeByteBuf` 的buffer实现为composite buffer实现定义了多个高级操作。用户可以使用composite buffer节省大量的内存复制，只比随机访问buffer的代价大一点。  
为了创建一个新的composite buffer, 可以像以前一样使用`Unpooled.wrappedBuffer(...)` , 也可以使用`Unpooled.compositeBuffer(...)`, 或者 `ByteBufAllocator.compositeBuffer()`.

## `3.`5. 可预知的NIO buffer转型 ##

在3.x中， `ChannelBuffer.toByteBuffer()` 以及它的变体所提供的约定并不那么明确。用户无法确定这些方法会返回一个拥有共享数据的视图buffer还是一个拥有独立数据的通过复制得到的buffer(a view buffer with shared data or a copied buffer with separate data)。  
4.0 中使用 `ByteBuf.nioBufferCount()`, `nioBuffer()`, 和 `nioBuffers()`代替`toByteBuffer()`. 如果`nioBufferCount()`返回 `0`, 用户总是可以通过`copy().nioBuffer()`得到一个复制buffer.

## `3.`6. 对小端序(Little endian)支持的改变 ##

小端序(Little endian)的支持做了很大的改变。先前用户为了得到小端序buffer,可以通过 `LittleEndianHeapChannelBufferFactory` 或者按指定的字节序包装一个已有的buffer:  
4.0 中增加了一个新的方法: `ByteBuf.order(ByteOrder)`， 它返回当前buffer对象的一个具有指定字节序的视图：

import io.netty.buffer.ByteBuf;
    import io.netty.buffer.Unpooled;
    import java.nio.ByteOrder;
     
    ByteBuf buf = Unpooled.buffer(4);
    buf.setInt(0, 1);
    // Prints '00000001'
    System.out.format("%08x%n", buf.getInt(0)); 
     
    ByteBuf leBuf = buf.order(ByteOrder.LITTLE_ENDIAN);
    // Prints '01000000'
    System.out.format("%08x%n", leBuf.getInt(0));
     
    assert buf != leBuf;
    assert buf == buf.order(ByteOrder.BIG_ENDIAN);

## `3.`7. 池化buffer Pooled buffers ##

Netty 4引入了一个高性能的buffer池， 它是 [jemalloc][] 的变种， 组合了 [buddy allocation][] 和 [slab allocation][]的功能. 有以下好处:  
\*减少了 GC 压力，因为使用unpooled buffer会带来频繁的内存分配和回收

*  减少了内存的带宽消耗(memory bandwidth consumption) 因为新的内存不可避免地要用zero填充(初始化)
 *  定时回收 direct buffers

为了使用这个特性， 除非用户非要得到unpooled buffer, 他应该通过 [`ByteBufAllocator`][ByteBufAllocator]分配buffer:

Channel channel = ...;
    ByteBufAllocator alloc = channel.alloc();
    ByteBuf buf = alloc.buffer(512);
    ....
    channel.write(buf);
     
    ChannelHandlerContext ctx = ...
    ByteBuf buf2 = ctx.alloc().buffer(512);
    ....
    channel.write(buf2)

一旦`ByteBuf` 被写入到远程端， 它立即自动地放回原来的buffer池中.

默认的 `ByteBufAllocator` 是 `PooledByteBufAllocator`. 如果你不想使用buffer池， 抑或你想使用自己的allocator, 使用 `Channel.config().setAllocator(...)` 设置可选的allocator， 比如 `UnpooledByteBufAllocator`.

注意: 当我们使用的默认allocator 是 `UnpooledByteBufAllocator`时， 一旦我们确保`PooledByteBufAllocator`没有内存泄漏的问题, 我们应该将默认的allocator换回`PooledByteBufAllocator`.

### **`3.7.1.ByteBuf` 总是使用引用计数(reference counted)** ###

为了精确的控制`ByteBuf`生命周期，Netty不再依赖垃圾回收器，而是使用一个显示的引用计数器. 基本规则如下:

*  当 buffer 首次分配时, 它的初始引用计数为 1.
 *  当buffer的引用计数降为0时，它被回收或者放回原始的buffer池中.
 *  下面的动作会触发`IllegalReferenceCountException`异常:
    
     *  访问引用计数为0的buffer,
     *  将引用计数降少为负数,
     *  或者将引用计数的值超过 `Integer.MAX_VALUE`.
 *  衍生的buffers (比如 slices 和 duplicates) 和 交换的buffers (比如 little endian buffers) 和原buffer共享同一个引用计数器. 注意，当一个衍生的buffer创建时它的引用计数器不会改变.

当 `ByteBuf` 在 `ChannelPipeline`中使用时,你需要注意一些额外的规则:

*  管道中的每个 inbound (a.k.a. upstream) handler 必须release接收到的消息. Netty不会自动release 它们.
    
     *  注意 codec 框架的确自动 release消息， 用户如果想传递一个as-is message给下一个handler, 就不得不增加引用计数器 .
 *  当outbound (a.k.a. downstream) message 到达了管道的开始位置时，Netty会在写完它后 release it.

### **`3.7.`2.自动 buffer泄漏检查** ###

尽管引用计数很强大，但却容易出错。为了帮助用户找到他们忘记release buffer的地方, 泄漏检查器会自动地将那些泄漏buffer分配时的堆栈信息输出到日志中.

因为泄漏检查器(leak detector)依靠`PhantomReference` 并且获取堆栈信息是一个花费很大的操作， 它只会采样大约1%的分配. 因此，最好运行应用程序相当长的时间来找到所有可能的泄漏是一个好主意.

只要所有的泄漏否被发现和修改， 你就可以将这个特性关闭， 通过`-Dio.netty.noResourceLeakDetection` JVM 参数. （译者: jinfo可以运行时修改jvm参数，但是不是所有的参数都能被它修改）

# `4.io.netty.util.concurrent` #

除了 buffer API, 4.0还提供了写异步应用程序的一些通用的类，它们被放入包 `io.netty.util.concurrent`. 一些类如:

*  `Future` 和 `Promise` - 类似`ChannelFuture`, 但是不依赖 `Channel`
 *  `EventExecutor` 和 `EventExecutorGroup` - 通用的 event loop API

它们是channel API基础，文章后面会有解释. 例如, `ChannelFuture` 扩展 `io.netty.util.concurrent.Future` 而 `EventLoopGroup` 扩展 `EventExecutorGroup`.

![2019082322484265.png][]

# 5. Channel API 的改变 #

在4.0中, 很多 `io.netty.channel` 包下的类都经历了大的整理 所以简单的文本搜索-替换不会将老的Netty 3.x 应用轻松迁移到 4.0.

## 5.1 改组 ChannelHandler 接口 ##

### **5.1.1 Upstream → Inbound, Downstream → Outbound** ###

术语 'upstream' 和 'downstream' 对新人来讲很让人困惑。 4.0 使用 'inbound' 和 'outbound' .

### 5.1.2 新的 `ChannelHandler` 类型继承关系 ###

在3.x 中, `ChannelHandler` 只是一个 tag interface, 而 `ChannelUpstreamHandler`, `ChannelDownstreamHandler`, 和 `LifeCycleAwareChannelHandler` 定义了实际的 handler 方法.  
在Netty 4中, `ChannelHandler` 合并了 `LifeCycleAwareChannelHandler` 连同许多新方法， 它们对inbound 和 outbound handler 很有用:

public interface ChannelHandler {
        void handlerAdded(ChannelHandlerContext ctx) throws Exception;
        void handlerRemoved(ChannelHandlerContext ctx) throws Exception;
        void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception;
    }

![201908232300032.png][]

### 5.1.3 `ChannelHandler` 不需要 event object ###

在3.x中, 每个 I/O 操作都会创建安一个 `ChannelEvent` 对象. 对于每一次 read / write, 它都额外的创建一个新的 `ChannelBuffer`.  
它极大地简化了Netty的内部处理，因为它代理了JVM的资源管理和buffer池。然而，这经常也是Netty应用程序在高负载的情况下GC压力大的原因。

4.0完全移除了event object， 取而代之的是强类型的方法调用. 3.x 包含处理所有事件的handler method如 `handleUpstream()` 和 `handleDownstream()`, 但Netty 4.0中 每个 event 类型都有它自己的handler method:

// Before:
    void handleUpstream(ChannelHandlerContext ctx, ChannelEvent e);
    void handleDownstream(ChannelHandlerContext ctx, ChannelEvent e);
     
    // After:
    void channelRegistered(ChannelHandlerContext ctx);
    void channelUnregistered(ChannelHandlerContext ctx);
    void channelActive(ChannelHandlerContext ctx);
    void channelInactive(ChannelHandlerContext ctx);
    void channelRead(ChannelHandlerContext ctx, Object message);
     
    void bind(ChannelHandlerContext ctx, SocketAddress localAddress, ChannelPromise promise);
    void connect(
            ChannelHandlerContext ctx, SocketAddress remoteAddress,
            SocketAddress localAddress, ChannelPromise promise);
    void disconnect(ChannelHandlerContext ctx, ChannelPromise promise);
    void close(ChannelHandlerContext ctx, ChannelPromise promise);
    void deregister(ChannelHandlerContext ctx, ChannelPromise promise);
    void write(ChannelHandlerContext ctx, Object message, ChannelPromise promise);
    void flush(ChannelHandlerContext ctx);
    void read(ChannelHandlerContext ctx);

`ChannelHandlerContext` 也根据上面改变而改变了:

// Before:
    ctx.sendUpstream(evt);
     
    // After:
    ctx.fireChannelRead(receivedMessage);

所有这些改变意味着用户无法扩展一个不存在的 `ChannelEvent` 接口了. 然而用户怎么定义他自己的事件类型呢，比如 `IdleStateEvent`? 4.0的`ChannelInboundHandler` 有一个 `userEventTriggered()` handler method,可以用来处理这样的需求.

### 5.1.4 简化channel 状态模型 ###

在3.x中，当一个新的Channel被创建并连接成功，至少三个ChannelStateEvent会被触发：channelOpen、channelBound以及channelConnected.当一个Channel关闭时，也至少有三个事件会被触发：channelDisconnected、channelUnbound以及channelClosed.

![20190823230352818.png][]

但是，触发这么多事件的意义并不那么大。更有用的是当一个Channel进入可读或可写的状态时通知用户。

![20190823230432115.png][]

`channelOpen`, `channelBound`, 和 `channelConnected` 被合并到 `channelActive`. `channelDisconnected`, `channelUnbound`, 和 `channelClosed` 被合并到 `channelInactive`.同样 `Channel.isBound()` 和 `isConnected()` 也被合并为`isActive()`.

需要注意的是，`channelRegistered` and `channelUnregistered` 这两个事件与`channelOpen` and `channelClosed`并不等价。它们是在支持`Channel`的动态注册、注销以及再注册时被引入的新的状态，就像下图所示：

![20190823230525540.png][]

### 5.1.5 `write()` 不会自动 flush ###

4.0 引入了新的操作 `flush()` 它可以显示地将`Channel`输出缓存输出. `write()`操作并不会自动 flush. 你可以把它想象成`java.io.BufferedOutputStream`, 除了 它工作于消息级这一点.  
由于这个改变, 你必须万分小心，写入数据后不要忘了调用 `ctx.flush()` . 当然你也可以使用一个更直接的方法 `writeAndFlush()`.

## 5.2 可知的和不易出错的入站流量挂起(暂停读取) ##

3.x有一个由`Channel.setReadable(boolean)`提供的不是很明显的入站流量挂起机制。它在ChannelHandler之间带来了复杂的交互操作，同时handler由于不正确实现很容易互相干扰。

4.0里，增加了一个新的名为`read()` 的outbound操作。如果你使用`Channel.config().setAutoRead(false)`来关闭默认的auto-read标志，Netty不会读入任何东西，直到你显式地调用read()操作.  
一旦你启动的`read()` 操作完成，同时channel再次停止读，一个名为`channelReadSuspended()`的inbound事件会被触发， 这样你就能够重新启动另一次的`read()` 操作。你同样也可以拦截`read()` 操作来执行更多高级的流量控制。

**暂停接受新的的连接**

Netty 3.0 中用户没有办法停止接受新的连接， 除非使用阻塞的I/O线程或者关闭server socket。4.0中 当auto-read没有设置时 `read()` 操作就像一个原始的channel.

## 5.3 半关闭的socket ##

CP和SCTP允许用户关闭一个socket的outbound流量而不用完全关闭它。这样的socket被称为"半关闭的socket",用户能够通过调用`SocketChannel.shutdownOutput()`方法来获取一个半关闭socket。如果一个远端关闭了outbound流量，`SocketChannel.read(..)`会返回-1，这看上去并没有和一个关闭了的连接有什么区别。

3.x没有 `shutdownOutput()` 操作。它总是在 `SocketChannel.read(..)` 返回-1的时候关闭连接。为了支持半关闭socket，4.0增加了`SocketChannel.shutdownOutput()` 方法，同时用户能设置`ALLOW_HALF_CLOSURE`的`ChannelOption` 来阻止Netty在`SocketChannel.read(..)` 返回-1的时候自动关闭连接.

## 5.4 灵活的I/O线程分配 ##

在3.x里，一个 `Channel` 是由ChannelFactory创建的，同时新建的 `Channel` 会自动注册到一个隐藏的I/O线程。4.0使用新的名为 `EventLoopGroup` 的接口来替换`ChannelFactory` ，`EventLoopGroup`包含一个或多个`EventLoop`。一个新的`Channel` 也不会自动注册到`EventLoopGroup`，但用户可以显式调用`EventLoopGroup.register()` 来注册。

由于这个改变（例如，分离了`ChannelFactory`和I/O线程），用户可以注册不同的 `Channel`实现到同一个`EventLoopGroup`，或者同一个 `Channel`实现到不同的`EventLoopGroup`。  
例如，你可以运行一个NIO server socket，NIO client socket，NIO UDP socket，以及虚拟机内的本地通道在同一个I/O线程里。在编写一个需要最小延迟的代理服务器时这确实很有用。

## 5.5 能够从一个已存在的jdk套接字上创建一个Channel ##

3.x没有方法从已存在的jdk套接字（如`java.nio.channels.SocketChannel`. ）创建一个新的channel。4.0可以。

## 5.6 取消注册和重新注册一个Channel从/到一个I/O线程 ##

3.x中一旦一个新的Channel被创建，它就完全绑定到一个单一的I/O线程上，直到它底层的socket关闭。在4.0中，用户能够从I/O线程里取消注册一个Channel来完全控制它底层jdk套接字。例如，你能够利用Netty提供的高层次非阻塞I/O的优势来解决复杂的协议，然后取消注册`Channel` 并且切换到阻塞模式来在可能的最大吞吐量下传输一个文件。当然，它能够再次注册已经取消了注册的`Channel` 。

java.nio.channels.FileChannel myFile = ...;
    java.nio.channels.SocketChannel mySocket = java.nio.channels.SocketChannel.open();
     
    // Perform some blocking operation here.
    ...
     
    // Netty takes over.
    SocketChannel ch = new NioSocketChannel(mySocket);
    EventLoopGroup group = ...;
    group.register(ch);
    ...
     
    // Deregister from Netty.
    ch.deregister().sync();
     
    // Perform some blocking operation here.
    mySocket.configureBlocking(true);
    myFile.transferFrom(mySocket, ...);
     
    // Register back again to another event loop group.
    EventLoopGroup anotherGroup = ...;
    anotherGroup.register(ch);

## 5.7 调度任意的任务到I/O线程里运行 ##

当一个`Channel`被注册到`EventLoopGroup`时，`Channel`实际上是注册到一个由`EventLoopGroup`管理 `EventLoop`中。`EventLoop`实现了 `java.util.concurrent.ScheduledExecutorService`接口。这意味着用户可以在一个用户channel归属的I/O线程里运行或调度一个任意的Runnable或Callable。使用良好设计的线程模型（稍后会介绍），编写一个线程安全的handler变得极其容易地。

public class MyHandler extends ChannelOutboundHandlerAdapter {
        ...
        public void write(ChannelHandlerContext ctx, Object msg, ChannelPromise p) {
            ...
            ctx.write(msg, p);
            
            // Schedule a write timeout.
            ctx.executor().schedule(new MyWriteTimeoutTask(p), 30, TimeUnit.SECONDS);
            ...
        }
    }
     
    public class Main {
        public static void main(String[] args) throws Exception {
            // Run an arbitrary task from an I/O thread.
            Channel ch = ...;
            ch.executor().execute(new Runnable() { ... });
        }
    }

## 5.8 简化shutdown ##

`releaseExternalResources()`不再使用。你可以通过调用`EventLoopGroup.shutdownGracefully()`关闭所有打开的channel同时使所有I/O线程停止.

## 5.9 类型安全的`ChannelOption` ##

有两种方法来配置Netty的`Channel`的socket参数。一种是明确地调用ChannelConfig的setter，例如`SocketChannelConfig.setTcpNoDelay(true)`.。这是最为类型安全的方法。另外一种是调用 `ChannelConfig.setOption()`方法。有时候你不得不在运行时的时候socket决定要配置什么选项，这个方法就特别适合这样的情况。然而，在3.x里它是容易出错的，因为一个用户必需用一个字符串/对象对来指定选项。如果用户调用了错误的选项名或者值，他或她将会遇到一个`ClassCastException` 异常或指定的选项甚至可能会默默地忽视了。

4.0引入了名为`ChannelOption`的新的类型，它提供了类型安全地访问socket选项。

ChannelConfig cfg = ...;
     
    // Before:
    cfg.setOption("tcpNoDelay", true);
    cfg.setOption("tcpNoDelay", 0);  // Runtime ClassCastException
    cfg.setOption("tcpNoDelays", true); // Typo in the option name - ignored silently
     
    // After:
    cfg.setOption(ChannelOption.TCP_NODELAY, true);
    cfg.setOption(ChannelOption.TCP_NODELAY, 0); // Compile error

## 5.10 AttributeMap ##

在处理用户指令里，你可以附加任意的对象到`Channel`和`ChannelHandlerContext`。一个名为`AttributeMap`的新接口被加入了，它被`Channel`和`ChannelHandlerContext`继承。相反，`ChannelLocal`和`Channel.attachment`被移除。这些属性会在他们关联的`Channel` 垃圾回收的同时回收。

public class MyHandler extends ChannelInboundHandlerAdapter {
     
        private static final AttributeKey<MyState> STATE =
                AttributeKey.valueOf("MyHandler.state");
     
        @Override
        public void channelRegistered(ChannelHandlerContext ctx) {
            ctx.attr(STATE).set(new MyState());
            ctx.fireChannelRegistered();
        }
     
        @Override
        public void channelRead(ChannelHandlerContext ctx, Object msg) {
            MyState state = ctx.attr(STATE).get();
        }
        ...
    }

## 5.11 新的 bootstrap API ##

bootstrap API已经被重写，尽管它的目的还是一样；它执行需要配置和运行服务器或客户端程序的典型步骤，通常能在样板代码里找到。新的bootstrap同样采取了流式接口(fluent interface)。

**`ChannelPipelineFactory` → `ChannelInitializer`**

就像你在在下面的例子注意到的一样，`ChannelPipelineFactory` 不再存在了。而是由 `ChannelInitializer`来替换，它给予了`Channel` 和 `ChannelPipeline` 配置的更多控制。

请注意，你不能自己创建一个新的`ChannelPipeline`。通过观察目前为止的用例报告，Netty团队得到一个结论，让用户去创建自己的管道实现或者是继承默认的实现是没有好处的。因此，`ChannelPipeline` 不再让用户创建。`ChannelPipeline` 由 `Channel`自动创建。

public static void main(String[] args) throws Exception {
        // Configure the server.
        EventLoopGroup bossGroup = new NioEventLoopGroup();
        EventLoopGroup workerGroup = new NioEventLoopGroup();
        try {
            ServerBootstrap b = new ServerBootstrap();
            b.group(bossGroup, workerGroup)
             .channel(NioServerSocketChannel.class)
             .option(ChannelOption.SO_BACKLOG, 100)
             .localAddress(8080)
             .childOption(ChannelOption.TCP_NODELAY, true)
             .childHandler(new ChannelInitializer<SocketChannel>() {
                 @Override
                 public void initChannel(SocketChannel ch) throws Exception {
                     ch.pipeline().addLast(handler1, handler2, ...);
                 }
             });
     
            // Start the server.
            ChannelFuture f = b.bind().sync();
     
            // Wait until the server socket is closed.
            f.channel().closeFuture().sync();
        } finally {
            // Shut down all event loops to terminate all threads.
            bossGroup.shutdownGracefully();
            workerGroup.shutdownGracefully();
            
            // Wait until all threads are terminated.
            bossGroup.terminationFuture().sync();
            workerGroup.terminationFuture().sync();
        }
    }

## 5.12 `ChannelFuture` → `ChannelFuture` 和 `ChannelPromise` ##

`ChannelFuture`已经被拆分为`ChannelFuture`和`ChannelPromise`。这不仅仅是让异步操作里的生产者和消费者间的约定更明显，同样也是得在使用从链中(如filtering)返回的`ChannelFuture`更加安全，因为`ChannelFuture`的状态是不能改变的。

由于这个改变，一些方法现在都采用`ChannelPromise` 而不是`ChannelFuture` 来改变它的状态。

# 6. 良好定义的线程模型 #

3.x中没有很好定义线程模型， 尽管3.5尝试修改它的不一致性。  
4.0定义了一个严格的线程模型，可以帮助用户编写ChannelHandler， 而用户不必太担心线程安全.

*  Netty 绝不会并发地调用 `ChannelHandler`'的方法, 除非 `ChannelHandler` 被标记为 `@Sharable`. 这与handler方法的类型无关 - inbound, outbound, life cycle event handler method.
    
     *  用户不必同步inbound or outbound event handler方法.
     *  4.0 不允许增加 `ChannelHandler` 多次， 除非它被标记为 `@Sharable`.
 *  Netty 调用的`ChannelHandler`之间总是遵循 [happens-before][] .
    
     *  用户不必定义`volatile`字段来保存 handler 的状态.
 *  用户往`ChannelPipeline`中增加handler时可以指定 `EventExecutor`.
    
     *  如果指定了一个`EventExecutor`, `ChannelHandler`的handler方法总是被这个指定的 `EventExecutor`执行.
     *  如果没有指定, handler 方法总是被它的`Channel`注册的 `EventLoop` 执行.
 *  指派给handler或者channle的`EventExecutor` 和 `EventLoop` 总是单线程的.
    
     *  handler 方法总是被同一个线程调用.
     *  如果使用多线程的`EventExecutor` 或 `EventLoop`, 首先会选择其中一个线程， 然后一直使用这个线程，直到取消注册（deregistration）.
     *  如果在同意管道pipeline中的两个handler 被指派给不同的 `EventExecutor`, 它们可以被并发地调用. 如果它们访问共享数据， 用户必须小心线程安全 .
 *  增加到`ChannelFuture` 的`ChannelFutureListeners` 总是此`Channel`相关的`EventLoop` 执行.

## 6.1 没有 `ExecutionHandler` 了 - 它被放入核心代码中 ##

在你往`ChannelPipeline`增加`ChannelHandler` 时你可以指定一个`EventExecutor`, 这样管道总是使用这个`EventExecutor`来调用这个新增加的 `ChannelHandler`的handler方法.

Channel ch = ...;
    ChannelPipeline p = ch.pipeline();
    EventExecutor e1 = new DefaultEventExecutor(16);
    EventExecutor e2 = new DefaultEventExecutor(8);
     
    p.addLast(new MyProtocolCodec());
    p.addLast(e1, new MyDatabaseAccessingHandler());
    p.addLast(e2, new MyHardDiskAccessingHandler());

# 7. 编解码框架的改变 #

编码解码器框架里有实质性的内部改变, 因为4.0需要一个handler来创建和管理它的buffer（看这篇文章的 Per-handler buffer章节）然而，从用户角度来看这些变化并不大。

*  核心编解码类移入到 `io.netty.handler.codec` 包下.
 *  `FrameDecoder` 被重新命名为 `ByteToMessageDecoder`.
 *  `OneToOneEncoder` 和 `OneToOneDecoder` 被`MessageToMessageEncoder` 和 `MessageToMessageDecoder` 取代.
 *  `decode()`, `decodeLast()`, `encode()` 的方法签名有些许改变以便支持泛型， 也移除了一些冗余的参数.

## 7.1 Codec embedder → `EmbeddedChannel` ##

Codec embedder 被 `io.netty.channel.embedded.EmbeddedChannel` 取代， 允许用户对任何包含编码解码器的管道进行测试.

## 7.2 HTTP codec ##

HTTP 解码器现在对每个HTTP消息中总是生成多个消息对象：

> 1        \* HttpRequest / HttpResponse
> 
> 0 - n   \* HttpContent
> 
> 1        \* LastHttpContent

如果想了解更多的细节, 请参考最新的 `HttpSnoopServer` 例子. 如果你不想为每个HTTP消息生成多个消息, 你可以将一个 `HttpObjectAggregator` 加入到管道中. `HttpObjectAggregator` 总是将多个消息转换成一个单一的`FullHttpRequest` 或者 `FullHttpResponse`.

## 7.3 transport 实现的改变 ##

新加了下面的 transports ：

*  OIO SCTP transport
 *  UDT transport

# 8. 用例学习：迁移阶乘（Factorial）的例子 #

## 8.1 迁移服务端 ##

1.  使用新的bootstrap API重写 `FactorialServer.run()` 方法.
    
    1.  不再使用 `ChannelFactory` . 初始化一个 `NioEventLoopGroup` (一个用来接受连接，其它的用来处理接受后的连接.
2.  重命名 `FactorialServerPipelineFactory` 为 `FactorialServerInitializer`.
    
    1.  让它扩展 `ChannelInitializer<Channel>`.
    2.  不创建一个 `ChannelPipeline`, 而是通过 `Channel.pipeline()`得到它.
3.  让 `FactorialServerHandler` 扩展 `ChannelInboundHandlerAdapter`.
    
    1.  用`channelInactive()`替换 `channelDisconnected()` .
    2.  不再使用handleUpstream().
    3.  将 `messageReceived()` 命名为 `channelRead()`， 并相应的调整方法签名.
    4.  用 `ctx.writeAndFlush()`替换 `ctx.write()` .
4.  让 `BigIntegerDecoder` 扩展 `ByteToMessageDecoder<BigInteger>`.
5.  让 `NumberEncoder` 扩展 `MessageToByteEncoder<Number>`.
    
    1.  `encode()` 不再返回一个buffer. 由`ByteToMessageDecoder`负责将编码的数据填入到buffer中.

## 8.2 迁移客户端 ##

大部分和移植服务端差不多，但在编写一个潜在的大数据流时要注意。

1.  使用新的 bootstrap API 重写 `FactorialClient.run()` 方法.
2.  将 `FactorialClientPipelineFactory` 重命名为 `FactorialClientInitializer`.
3.  让 `FactorialClientHandler` 扩展 `ChannelInboundHandlerAdapter`

为何写这篇呢，其实研究源码的同学很多没有啥反向，其实这篇Netty4的关键特性就是我们研究的方向，每个你关注的细节都值得我们去深入研究及借鉴。![100046155][]

[New and noteworthy in 4.0]: http://netty.io/wiki/new-and-noteworthy-in-4.0.html
[JBoss.org]: http://netty.io/news/2011/11/04/new-web-site.html
[Netty 4.0.0.CR5 released with new-new API]: http://netty.io/news/2013/06/18/4-0-0-CR5.html
[jemalloc]: http://www.canonware.com/jemalloc/
[buddy allocation]: http://en.wikipedia.org/wiki/Buddy_memory_allocation
[slab allocation]: http://en.wikipedia.org/wiki/Slab_allocation
[ByteBufAllocator]: http://netty.io/4.0/api/index.html?io/netty/buffer/AbstractByteBufAllocator.html
[2019082322484265.png]: /images/20211220/778ba97d2d0c409ea53788d2a6bb38a1.png
[201908232300032.png]: /images/20211220/fd8620c4a0974b1aa514ef47532daf73.png
[20190823230352818.png]: /images/20211220/75f3b7f9a0094b9e8ff709bf0e8d229f.png
[20190823230432115.png]: /images/20211220/ab149a126c374a66be28ab7d7b5b99bc.png
[20190823230525540.png]: /images/20211220/e62767d8a1bf4cfda9d7d4a6101e8108.png
[happens-before]: http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/package-summary.html#MemoryVisibility
[100046155]: /images/20211220/d9c4124e9ed3447ca4fe874e4fa46736.png