Ant/Maven：“javadoc：警告 - 获取 URL 时出错”

Question

我最近设置了我的构建服务器 (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 进行编译。

Answer 1

它工作正常，但为了清楚起见，您需要先从 Oracle 网站下载包列表文件，例如http://docs.oracle.com/javase/6/docs/api/package-list，然后将该文件保存到您指定的文件夹中。

Answer 2

<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/"
    packagelistLoc="javadoc/javase6/package-list" />

应该是：

<link offline="true" href="http://docs.oracle.com/javase/6/docs/api/"
    packagelistLoc="javadoc/javase6/" />

packagelistLoc 是包含package-list 文件的目录的路径。