Ссылка на javadoc.io с использованием опции Javadoc-link

Я пытаюсь подключиться к некоторым Javadocs, размещенным в javadoc.io (в частности, Javadocs PowerMock) с помощью . Я попытался добавить URL-адрес Javadocs PowerMock в my -link флаг, но не может заставить Javadoc распознать его. Я использую внешние ссылки на другие Javadocs просто отлично (например, Guava, Java SE 7) с Gradle в качестве моей системы сборки. Я пробовал следующие варианты:

-link http://static.javadoc.io/org.powermock/powermock-core/1.6.3/

^ я подтвердил, что есть в этом каталог

-link http://static.javadoc.io/org.powermock/powermock-core/

-link http://javadoc.io/doc/org.powermock/powermock-core/1.6.3/

-link http://javadoc.io/doc/org.powermock/powermock-core/

все это приводит к следующей ошибке (URL изменен соответственно):

javadoc: warning - Error fetching URL: http://static.javadoc.io/org.powermock/powermock-core/1.6.3/

у кого-нибудь есть советы о том, как сделать эту работу?

насколько я могу судить, это своего рода javadoc.io конкретная проблема, хотя, вероятно, проблема использования на моем конце - например, я в настоящее время использую -link http://junit.org/javadoc/latest/ без проблем, но -link http://static.javadoc.io/junit/junit/4.12/ не работает.

11
java javadoc

4 ответов

из командной строки, используйте аргумент типа -J-Dhttp.agent=javadoc.

в Maven используйте что-то вроде:

<additionalJOption>-J-Dhttp.agent=maven-javadoc-plugin-${pom‌​.name}</additionalJO‌​ption>

фон: как предлагает Данило Пьянини в еще один ответ проблемы

4

Я исследовал проблему, проблема здесь в том, что пользовательский агент должен быть установлен (пустая строка в порядке) для подключения к javadoc.io для успешного завершения.

Я работал над проблемой и писал плагин Gradle, который может помочь для тех, кто полагается на эту систему построить.

к сожалению, работа вокруг не может быть портирована на обычный javadoc -link командная вызова.

4

это странно: я мог видеть в браузере, например http://static.javadoc.io/org.pegdown/pegdown/1.6.0/package-list но когда я добавляю http://static.javadoc.io/org.pegdown/pegdown/1.6.0 как у javadoc по Он говорит:

ошибка получения URL:http://static.javadoc.io/org.pegdown/pegdown/1.6.0/package-list

я использую следующий обходной путь:

  1. С maven-dependency-plugin unapack javadoc желаемой зависимости.

  2. ссылка с .

    <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>2.8</version>
    <executions>
        <execution>
            <id>unpack-javadoc</id>
            <phase>package</phase>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>org.pegdown</groupId>
                        <artifactId>pegdown</artifactId>
                        <classifier>javadoc</classifier>
                        <version>${pegdownVersion}</version>
                        <overWrite>false</overWrite>
                        <outputDirectory>${project.build.directory}/pegdown-javadoc</outputDirectory>
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <links>
            <link>http://www.slf4j.org/apidocs/</link>
        </links>
        <offlineLinks>
            <offlineLink>
                <url>http://static.javadoc.io/org.pegdown/pegdown/${pegdownVersion}</url>
                <location>${project.build.directory}/pegdown-javadoc</location>
            </offlineLink>
        </offlineLinks>
    </configuration>
</plugin>
3

Я закончил тем, что просто использовал -linkoffline обойти эту проблему, которая, я полагаю, имеет хорошее свойство не нуждаться в подключении к интернету во время сборки, хотя, если у кого-то есть дальнейшие мысли о том, как сделать эту работу с -link Я весь внимание.

2