利息和文件摘要的org.jboss.netty.channel.Channel部分的javadoc是错误还是没有?

时间:2013-12-23 08:46:50

标签: java netty javadoc

在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值,表示读取和写入操作均已暂停。

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

1 个答案:

答案 0 :(得分:0)

根据我的理解,两种描述都匹配并且是正确的。

有两个主要标志 - 读标志和写标志。 从netty源的Channel接口可以看出,read标志是interestOps值的第1个最低有效位,write标志是interestOps值的第3个最低有效位。

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

如果设置了写入标志,则暂停写入操作

如果设置了通道的读取或写入标志并且它们的名称反映了标志状态,而不是操作暂停状态,则描述的所有interestOps值都会处理。

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

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

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

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