Как мне заставить javadoc ссылаться на Java API с помощью Ant-задачи?
Вопрос
Прямо сейчас моя муравьиная задача выглядит следующим образом.
<javadoc sourcepath="${source}" destdir="${doc}">
<link href="http://java.sun.com/j2se/1.5.0/docs/api/" />
</javadoc>
И я получаю это предупреждение:
javadoc: warning - Error fetching URL: http://java.sun.com/j2se/1.5.0/docs/api/package-list
Как мне заставить javadoc правильно ссылаться на API?Я нахожусь за прокси-сервером.
Решение
Вероятно, вам нужен системные свойства http.proxyHost и http.proxyPort набор.Например, ANT_OPTS="-Dhttp.proxyHost=proxy.y.com" ant doc
В качестве альтернативы, вы могли бы установить флаг "offline" и предоставить список пакетов, но это может быть проблемой для ядра Java.
Другие советы
Вы также можете передать аргументы внутри задачи ant
<arg value="-J-Dhttp.proxyHost=your.proxy.here"/>
<arg value="-J-Dhttp.proxyPort=##"/>
Если вы идете по маршруту автономной ссылки.Загрузите список пакетов, перейдя по URL-адресу Java API (http://java.sun.com/j2se/1.5.0/docs/api/package-list) и сохраняем его как текстовый файл, а затем используем эту муравьиную задачу.
<javadoc sourcepath="${source}" destdir="${doc}">
<link offline="true" href="http://java.sun.com/j2se/1.5.0/docs/api/" packagelistloc="path-containing-package-list"/>
</javadoc>
Вы также можете использовать "автономный" режим, который позволяет вам создавать (быстрее!) без доступа к Интернету.Пожалуйста, ознакомьтесь с этим ответом: https://stackoverflow.com/a/24089805/366749