我最近设置了我的构建服务器(Jenkins)来为Ant构建生成Javadocs文档。然而,无论我怎么做,我都不能让它包含外部库的链接。当我尝试使用在线链接时,Ant会返回:
[javadoc] javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/6/docs/api/package-list
当我使用离线链接并引用本地包列表时,它不会生成警告,但也不会生成链接。这对我尝试链接的每个库都适用,而不仅仅是Java SE。以下是在我的 build.xml 中用于链接的各自行:
<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/" packagelistLoc="javadoc/javase6/package-list" />
并且:
<link href="http://docs.oracle.com/javase/6/docs/api/" />
值得一提的是服务器的网络连接并没有特别不寻常的配置。经过一番研究,我发现当使用代理时会出现我收到的警告,但我找不到任何直接连接服务器的情况下出现该警告的案例。
另外,我想提一下,我已验证我的离线软件包列表位于正确的位置,并可以通过构建文件中的相对路径访问。
编辑#1:显然这也是Maven的一个问题,这表明Javadoc工具本身有问题。
编辑#2:值得一提的是,我正在使用JDK 1.6 update 45进行编译。