新的Javadoc标签@apiNote,@implSpec和@implNote

来源:互联网 发布:ubuntu输入法不对 编辑:程序博客网 时间:2024/06/06 23:50

JDK广泛使用新的标签。一些例子:

  • 并发地图

    • 几个@implSpec定义了默认实现的行为,例如 replaceAll。 

    • 有趣的@impl注意 getOrDefault和 forEach。 

    • 重复@impl注意在Map中默认实现的抽象方法,记录“本实施方案有意地重新提取Map中提供的不正确的默认值”,例如 替换。 

  • 对象使用@apiNote解释为什么看似无用的方法的isNull非空加。 

  • 抽象类Clock在其类注释中使用@implSpec@implNote来区分必须注意的实现以及现有方法的实现方式。