新的javadoc注解@apiNote

我在LongStream类文档中发现了一个新的未记录的javadoc标记。Javadoc标记@apiNote似乎用于详细说明方法，但没有关于该标记的文档或发行说明。

它的真正目的是什么？其文档在哪里？

在Reduce method documentation

中可以找到使用@apiNote编译的javadoc示例

---

解决方案

如果不是标准的，我会说他们现在是官方的。请参见JDK-8068562。正如Nicolai上面指出的，他的博客文章New Javadoc Tags @apiNote, @implSpec and @implNote给出了一个很好的概述。它们是supported by Netbeans、supported by IntelliJ和supported by Eclipse。它们在Efficient Java第三版中进行了讨论和推荐。它们在整个核心Java库源代码中使用。