Как заставить 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? Я за прокси.


javadoc ant
person Rob Spieldenner    schedule 09.09.2008    source источник

Ответы (3)


arrow_upward
6
arrow_downward

Возможно, вам понадобятся системные свойства http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html установить. Например, ANT_OPTS="-Dhttp.proxyHost=proxy.y.com" ant doc

В качестве альтернативы вы можете установить флаг «офлайн» и предоставить список пакетов, но это может быть проблемой для ядра Java.

person erickson    schedule 09.09.2008

arrow_upward
12
arrow_downward

Вы также можете передать аргументы внутри задачи ant

<arg value="-J-Dhttp.proxyHost=your.proxy.here"/>
<arg value="-J-Dhttp.proxyPort=##"/>

Если вы идете по маршруту офлайн-ссылки. Загрузите список пакетов, перейдя по URL-адресу API Java (http://java.sun.com/j2se/1.5.0/docs/api/package-list) и сохранить его в виде текстового файла, а затем использовать эту задачу Ant.

<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>
person Rob Spieldenner    schedule 10.09.2008
comment
Обратите внимание, что path-containing-package-list выше означает путь к каталогу, содержащему файл с именем package-list. Это не путь к самому файлу package-list. - person ddekany; 10.10.2014

arrow_upward
0
arrow_downward

Вы также можете использовать «автономный» режим, который позволяет вам строить (быстрее!) без доступа к Интернету. См. этот ответ: https://stackoverflow.com/a/24089805/366749

person Patrice M.    schedule 03.12.2014