Netty中的Option和ChildOption参数解析

分手后的思念是犯贱 2022-09-05 12:57 173阅读 0赞

前言  
Netty中的Option和ChildOption的区别：

1.Netty中的option主要是设置的ServerChannel的一些选项，而childOption主要是设置的ServerChannel的子Channel的选项。

2.如果是在客户端，因为是Bootstrap，只会有option而没有childOption，所以设置的是客户端Channel的选项。

本文转载自：Netty：option和childOption参数设置说明

一.通用参数  
CONNECT\_TIMEOUT\_MILLIS  
Netty参数，连接超时毫秒数，默认值30000毫秒即30秒。

MAX\_MESSAGES\_PER\_READ  
Netty参数，一次Loop读取的最大消息数，对于ServerChannel或者NioByteChannel，默认值为16，其他Channel默认值为1。默认值这样设置，是因为：ServerChannel需要接受足够多的连接，保证大吞吐量，NioByteChannel可以减少不必要的系统调用select。

WRITE\_SPIN\_COUNT  
Netty参数，一个Loop写操作执行的最大次数，默认值为16。也就是说，对于大数据量的写操作至多进行16次，如果16次仍没有全部写完数据，此时会提交一个新的写任务给EventLoop，任务将在下次调度继续执行。这样，其他的写请求才能被响应不会因为单个大数据量写请求而耽误。

ALLOCATOR  
Netty参数，ByteBuf的分配器，默认值为ByteBufAllocator.DEFAULT，4.0版本为UnpooledByteBufAllocator，4.1版本为PooledByteBufAllocator。该值也可以使用系统参数io.netty.allocator.type配置，使用字符串值："unpooled"，"pooled"。

RCVBUF\_ALLOCATOR  
Netty参数，用于Channel分配接受Buffer的分配器，默认值为AdaptiveRecvByteBufAllocator.DEFAULT，是一个自适应的接受缓冲区分配器，能根据接受到的数据自动调节大小。可选值为FixedRecvByteBufAllocator，固定大小的接受缓冲区分配器。

AUTO\_READ  
Netty参数，自动读取，默认值为True。Netty只在必要的时候才设置关心相应的I/O事件。对于读操作，需要调用channel.read()设置关心的I/O事件为OP\_READ，这样若有数据到达才能读取以供用户处理。该值为True时，每次读操作完毕后会自动调用channel.read()，从而有数据到达便能读取；否则，需要用户手动调用channel.read()。需要注意的是：当调用config.setAutoRead(boolean)方法时，如果状态由false变为true，将会调用channel.read()方法读取数据；由true变为false，将调用config.autoReadCleared()方法终止数据读取。

WRITE\_BUFFER\_HIGH\_WATER\_MARK  
Netty参数，写高水位标记，默认值64KB。如果Netty的写缓冲区中的字节超过该值，Channel的isWritable()返回False。

WRITE\_BUFFER\_LOW\_WATER\_MARK  
Netty参数，写低水位标记，默认值32KB。当Netty的写缓冲区中的字节超过高水位之后若下降到低水位，则Channel的isWritable()返回True。写高低水位标记使用户可以控制写入数据速度，从而实现流量控制。推荐做法是：每次调用channl.write(msg)方法首先调用channel.isWritable()判断是否可写。

MESSAGE\_SIZE\_ESTIMATOR  
Netty参数，消息大小估算器，默认为DefaultMessageSizeEstimator.DEFAULT。估算ByteBuf、ByteBufHolder和FileRegion的大小，其中ByteBuf和ByteBufHolder为实际大小，FileRegion估算值为0。该值估算的字节数在计算水位时使用，FileRegion为0可知FileRegion不影响高低水位。

SINGLE\_EVENTEXECUTOR\_PER\_GROUP  
Netty参数，单线程执行ChannelPipeline中的事件，默认值为True。该值控制执行ChannelPipeline中执行ChannelHandler的线程。如果为Trye，整个pipeline由一个线程执行，这样不需要进行线程切换以及线程同步，是Netty4的推荐做法；如果为False，ChannelHandler中的处理过程会由Group中的不同线程执行。

二.SocketChannel参数  
SO\_RCVBUF  
Socket参数，TCP数据接收缓冲区大小。该缓冲区即TCP接收滑动窗口，linux操作系统可使用命令：cat /proc/sys/net/ipv4/tcp\_rmem查询其大小。一般情况下，该值可由用户在任意时刻设置，但当设置值超过64KB时，需要在连接到远端之前设置。

SO\_SNDBUF  
Socket参数，TCP数据发送缓冲区大小。该缓冲区即TCP发送滑动窗口，linux操作系统可使用命令：cat /proc/sys/net/ipv4/tcp\_smem查询其大小。

TCP\_NODELAY  
TCP参数，立即发送数据，默认值为Ture（Netty默认为True而操作系统默认为False）。该值设置Nagle算法的启用，改算法将小的碎片数据连接成更大的报文来最小化所发送的报文的数量，如果需要发送一些较小的报文，则需要禁用该算法。Netty默认禁用该算法，从而最小化报文传输延时。

SO\_KEEPALIVE  
Socket参数，连接保活，默认值为False。启用该功能时，TCP会主动探测空闲连接的有效性。可以将此功能视为TCP的心跳机制，需要注意的是：默认的心跳间隔是7200s即2小时。Netty默认关闭该功能。

SO\_REUSEADDR  
Socket参数，地址复用，默认值False。有四种情况可以使用：  
(1)当有一个有相同本地地址和端口的socket1处于TIME\_WAIT状态时，而你希望启动的程序的socket2要占用该地址和端口，比如重启服务且保持先前端口。  
(2)有多块网卡或用IP Alias技术的机器在同一端口启动多个进程，但每个进程绑定的本地IP地址不能相同。  
(3)单个进程绑定相同的端口到多个socket上，但每个socket绑定的ip地址不同。  
(4)完全相同的地址和端口的重复绑定。但这只用于UDP的多播，不用于TCP。

SO\_LINGER  
Socket参数，关闭Socket的延迟时间，默认值为-1，表示禁用该功能。-1表示socket.close()方法立即返回，但OS底层会将发送缓冲区全部发送到对端。0表示socket.close()方法立即返回，OS放弃发送缓冲区的数据直接向对端发送RST包，对端收到复位错误。非0整数值表示调用socket.close()方法的线程被阻塞直到延迟时间到或发送缓冲区中的数据发送完毕，若超时，则对端会收到复位错误。

IP\_TOS  
IP参数，设置IP头部的Type-of-Service字段，用于描述IP包的优先级和QoS选项。

ALLOW\_HALF\_CLOSURE  
Netty参数，一个连接的远端关闭时本地端是否关闭，默认值为False。值为False时，连接自动关闭；为True时，触发ChannelInboundHandler的userEventTriggered()方法，事件为ChannelInputShutdownEvent。

三.ServerSocketChannel参数  
SO\_RCVBUF  
已说明，需要注意的是：当设置值超过64KB时，需要在绑定到本地端口前设置。该值设置的是由ServerSocketChannel使用accept接受的SocketChannel的接收缓冲区。

SO\_BACKLOG  
Socket参数，服务端接受连接的队列长度，如果队列已满，客户端连接将被拒绝。默认值，Windows为200，其他为128。

四.DatagramChannel参数  
SO\_BROADCAST  
Socket参数，设置广播模式。

SO\_RCVBUF  
已说明

SO\_SNDBUF  
已说明

SO\_REUSEADDR  
已说明

IP\_MULTICAST\_LOOP\_DISABLED  
对应IP参数IP\_MULTICAST\_LOOP，设置本地回环接口的多播功能。由于IP\_MULTICAST\_LOOP返回True表示关闭，所以Netty加上后缀\_DISABLED防止歧义。

IP\_MULTICAST\_ADDR  
对应IP参数IP\_MULTICAST\_IF，设置对应地址的网卡为多播模式。

IP\_MULTICAST\_IF  
对应IP参数IP\_MULTICAST\_IF2，同上但支持IPV6。

IP\_MULTICAST\_TTL  
IP参数，多播数据报的time-to-live即存活跳数。

IP\_TOS  
已说明

DATAGRAM\_CHANNEL\_ACTIVE\_ON\_REGISTRATION  
Netty参数，DatagramChannel注册的EventLoop即表示已激活。