Ant / Maven：“javadoc：warning - 获取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

<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文件的目录的路径。

Answer 2

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