InterestOps 和文件摘要的 org.jboss.netty.channel.Channel 部分的 javadoc 是否错误？

Question

在netty(http://www.Netty.io)框架中，org.jboss.netty.channel.Channel类路径有一些用于 InterestOps 的字段(OP_NONE、OP_READ、OP_READ_WRITE、OP_WRITE)
这些字段的详细信息在 javadoc
链接中:http://netty.io/3.9/api/org/jboss/netty/channel/Channel.html

OP_READ - 如果设置，远程节点发送的消息将被立即读取。如果未设置，则在再次设置 OP_READ 标志(即读取暂停)之前，不会读取来自远程对等方的消息。
OP_WRITE - 如果设置，写入请求将不会发送到远程对等点，直到 OP_WRITE 标志被清除并且写入请求将在队列中挂起。如果未设置，写入请求将尽快从队列中刷新。
OP_READ_WRITE - 这是 OP_READ 和 OP_WRITE 的组合，这意味着只有写请求被暂停。
OP_NONE - 这是 (NOT OP_READ) 和 (NOT OP_WRITE) 的组合，这意味着只暂停读取操作。

首先解释是好的和合乎逻辑的，但是这个字段在字段摘要部分再次解释:

OP_NONE interestOps 值，表示只暂停了读操作。
OP_READ interestOps 值，表明读操作和写操作都没有被挂起。
OP_READ_WRITE interestOps 值，表明只有写操作已被暂停。
OP_WRITE interestOps 值，表示读写操作均已暂停。

我认为所有第二个解释与所有第一个解释不匹配，这是类型错误还是合乎逻辑？

Answer 1

据我了解，这两个描述确实匹配并且是正确的。

主要有两个标志——读标志和写标志。从netty源的Channel接口(interface)可以看出读标志是interestOps值的第1个最低有效位，而写标志是interestOps值的第3个最低有效位。

如果设置了读取标志，则读取操作不会暂停。

如果设置了写入标志，则写入操作被暂停。

所描述的所有 interestOps 值都处理是否设置了 channel 的读或写标志，并且它们的名称反射(reflect)了标志状态，而不是操作暂停状态。

• OP_READ - 值名称表示只设置了读取标志(netty 源显示 OP_READ = 1)。由于设置了读取标志，因此不会暂停读取操作。由于未设置写标志，因此不会暂停写操作。 这是实际的读取标志掩码，这也是它在第一个 javaDoc 描述中将其视为实际标志的原因。

• OP_WRITE - 值名称表示仅设置了写入标志(netty 源显示 OP_READ = 4)。由于设置了写标志，写操作被暂停。由于未设置读取标志，因此暂停读取操作。 这是实际的写入标志掩码，这就是为什么它在第一个 javaDoc 描述中被视为实际标志的原因。

• OP_READ_WRITE - 值名称表示已设置读取和写入标志(netty 源显示 OP_READ_WRITE = OP_READ | OP_WRITE = 5)。由于设置了读取标志，因此不会暂停读取操作。由于设置了写入标志，写入操作被暂停。

• OP_NONE - 值名称表示未设置标志(netty 来源显示 OP_NONE = 0)。由于未设置读取标志，因此暂停读取操作。由于未设置写标志，因此不会暂停写操作。