java8中java.util.stream包的文档不完整
在源代码中,显然有一个java8中java.util.stream包的文档不完整,java,Java,在源代码中,显然有一个AbstractPipeline类,它实现了BaseStream接口,但没有记录: 另外,抽象类ReferencePipeline实现了流接口,这里没有提到: 此外,在包摘要中,根本没有提到这些抽象类: 鉴于抽象类及其与接口的关系在其他包(如java.util)中有明确的文档记录: 我们可以说这是java8流文档的一个bug吗?您提到的两个类都具有包级访问权限。这意味着它们不是公共类,实际上是一个实现细节,而不是公共API的一部分。即使您知道这些类,也不能(轻松地)
AbstractPipeline
类,它实现了BaseStream
接口,但没有记录:
另外,抽象类ReferencePipeline
实现了流
接口,这里没有提到:
此外,在包摘要中,根本没有提到这些抽象类:
鉴于抽象类及其与接口的关系在其他包(如java.util
)中有明确的文档记录:
我们可以说这是java8流文档的一个bug吗?您提到的两个类都具有包级访问权限。这意味着它们不是公共类,实际上是一个实现细节,而不是公共API的一部分。即使您知道这些类,也不能(轻松地)在代码中直接使用它们
这不是一个bug,而是一个深思熟虑的选择。有许多基类和接口具有包级访问权限,因为它们在整个包中使用(包括
java.util
)。除非您深入研究特定JRE实现的源代码,否则您不会了解它们。您所指的那些类是包私有的,而不是公共的
。