微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Java 8 javadoc工具差异和gradle的bug:如何解决它?

我有一个非常奇怪的错误与gradle(1.11)和javadoc任务.我的build.gradle中有链接,例如:

javadoc.options.links("http://docs.oracle.com/javase/7/docs/api");

我现在使用Java 8(从Oracle下载的JDK),这是javadoc任务的输出

fge@alustriel:~/src/perso/largetext$java -version; ./gradlew clean javadoc
java version "1.8.0"
Java(TM) SE Runtime Environment (build 1.8.0-b132)
Java HotSpot(TM) 64-Bit Server VM (build 25.0-b70, mixed mode)
:clean
:compileJava
warning: [options] bootstrap class path not set in conjunction with -source 1.7
1 warning
:processResources
:classes
:javadoc
javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/7/docs/api
javadoc: warning - Error fetching URL: http://jsr-305.googlecode.com/svn/trunk/javadoc
javadoc: warning - Error fetching URL: http://docs.guava-libraries.googlecode.com/git-history/v16.0.1/javadoc
3 warnings

BUILD SUCCESSFUL

Total time: 7.726 secs

事实上,当我查看javadoc时,所有外部链接都不存在;但是,如果我使用Java 7运行:

fge@alustriel:~/src/perso/largetext$(export JAVA_HOME=/opt/sunjdk/1.7/current; export PATH=$JAVA_HOME/bin:$PATH; java -version; ./gradlew clean javadoc)
java version "1.7.0_51"
Java(TM) SE Runtime Environment (build 1.7.0_51-b13)
Java HotSpot(TM) 64-Bit Server VM (build 24.51-b03, mixed mode)
:clean
:compileJava
:processResources
:classes
:javadoc

BUILD SUCCESSFUL

Total time: 7.635 secs

一切正常.

现在,我也尝试并修改了javadoc链接

// Note the appended "/package-list"
javadoc.options.links("http://docs.oracle.com/javase/7/docs/api/package-list");

使用Java 8,然后它不会发出警告,它会生成链接……但是链接被破坏了!也就是说,例如,我得到:

http://docs.oracle.com/javase/7/docs/api/package-list/java/lang/NullPointerException.html?is-external=true

(注意package-list /)作为链接而不是:

http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true

Java 8中发生了哪些变化?有解决方法吗?

解决方法:

尝试使用http://docs.oracle.com/javase/7/docs/api/而不是http://docs.oracle.com/javase/7/docs/api.

显然需要尾随斜线.

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。

相关推荐