如何解决为什么Oracle JDK Javadoc不包含严格的浮点修饰符?
如果我在NetBeans Javadoc窗口中查看StrictMath.toradians()
,则前两行显示为
java.lang.StrictMath
public static strictfp double toradians(double angdeg)
这很有道理,因为我使用的JDK具有StrictMath.toradians()
修饰符定义的strictfp
。但是,如果我查看the StrictMath
Javadoc online,就不会提及strictfp
的任何内容。例如,toradians()
Javadoc的第一行读取为
public static double toradians(double angdeg)
我正在使用JDK 1.8.0_241,运行时稍微提前了一点。可以肯定的是Oracle JDK。据我所知,StrictMath
的JDK源代码中的Javadoc注释与上面链接的Oracle页面中发布的注释匹配。
是Javadoc工具忽略了strictfp
修饰符,还是Oracle故意从生成的StrictMath
Javadoc HTML页面中删除了它?
(我尝试为虚拟strictfp
函数生成Javadoc,但似乎在尝试执行的项目中出现了很多看似无关的Javadoc错误)。
解决方法
正如Java 8的javadoc
的{{3}}所说:
javadoc
命令可以包含修饰符public
,protected
,private
,abstract
,final
,static
,transient
和volatile
,但不是synchronized
或native
。synchronized
和native
修饰符被视为实现细节,而不是API规范的一部分。
它没有明确列出strictfp
,但是由于strictfp
是一个影响方法实现的功能,而不是方法的使用方式,因此被排除在外。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。