Java 8+;Maven Javadoc插件:获取URL时出错
我试图生成Javadoc,它实际上链接到我的依赖项的Javadoc。我尝试了各种方法来生成Javadoc,它不会为依赖项中的类引用生成完全限定的类名。我想要用简化的类名链接到Java文档。然而,即使使用JavaAPI类名,我也没有链接,并且拥有完全限定的类名。我正在使用Java8。我有以下配置:Java 8+;Maven Javadoc插件:获取URL时出错,java,maven,java-8,javadoc,maven-javadoc-plugin,Java,Maven,Java 8,Javadoc,Maven Javadoc Plugin,我试图生成Javadoc,它实际上链接到我的依赖项的Javadoc。我尝试了各种方法来生成Javadoc,它不会为依赖项中的类引用生成完全限定的类名。我想要用简化的类名链接到Java文档。然而,即使使用JavaAPI类名,我也没有链接,并且拥有完全限定的类名。我正在使用Java8。我有以下配置: <plugin> <groupId>org.apache.maven.plugins</groupId>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.2</version>
<configuration>
<reportOutputDirectory>${project.basedir}/target</reportOutputDirectory>
<destDir>javadoc</destDir>
<windowtitle>Epiphany</windowtitle>
<doctitle>Epiphany</doctitle>
<show>private</show>
<detectLinks>false</detectLinks>
<detectOfflineLinks>true</detectOfflineLinks>
<linksource>true</linksource>
<detectJavaApiLink>false</detectJavaApiLink>
<additionalparam>-Xdoclint:none</additionalparam>
<links>
<link>http://docs.oracle.com/javase/8/docs/api</link>
</links>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
<goal>test-javadoc</goal>
</goals>
</execution>
</executions>
</plugin>
我曾尝试根据我声明的依赖项检测链接,并尝试将其设置为false,然后提供指向Javadoc的链接,但仍然没有得到任何链接,并且依赖项中的类的所有类名都是完全限定的。我到底做错了什么?包列表文件在指定的URL处可用,所以我不明白为什么Javadoc不能访问它们或位于那里的Javadoc
更新:
将maven javadoc插件的版本更改为2.10.3。现在,如果我将detectJavaApiLink
设置为true
并删除java8javadoc的链接,javadoc会正确地生成指向javaapi类的链接,并使用简化的名称
但是,我在第三方依赖关系和链接到他们的Javadoc方面仍然存在问题。如果我将detectLinks
设置为true
,则无法找到其中任何一个的javadoc。如果我将其设置为false
并手动配置位置,我仍然会收到一条错误消息,说明它无法获取URL:
[WARNING] javadoc: warning - Error fetching URL: https://selenium.googlecode.com/git/docs/api/java
我为maven javadoc插件更新的pom配置如下:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.3</version>
<configuration>
<reportOutputDirectory>${project.basedir}/target</reportOutputDirectory>
<destDir>javadoc</destDir>
<windowtitle>Epiphany</windowtitle>
<doctitle>Epiphany</doctitle>
<show>private</show>
<detectLinks>false</detectLinks>
<detectOfflineLinks>true</detectOfflineLinks>
<linksource>true</linksource>
<additionalparam>-Xdoclint:none</additionalparam>
<detectJavaApiLink>true</detectJavaApiLink>
<links>
<link>https://selenium.googlecode.com/git/docs/api/java</link>
</links>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
<goal>test-javadoc</goal>
</goals>
</execution>
</executions>
</plugin>
org.apache.maven.plugins
请检查maven javadoc插件版本2.10.3…我已更新到2.10.3,这解决了我在Java 8 API类中的问题。它现在将它们链接起来,并使用简化的名称。在我尝试过的任何场景下,我仍然无法获得我的第三方依赖项的链接和简化名称——自动检测链接或手动配置链接。您能否创建一个示例项目,该项目不起作用,可能正在创建jira问题,并将该示例附加到jira问题。可以。明天早上我必须做这个。我提交了缺陷报告。希望它很快得到解决。我有一个代码审查即将到来,我希望有一些漂亮的,易于阅读的完全链接javadoc。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.3</version>
<configuration>
<reportOutputDirectory>${project.basedir}/target</reportOutputDirectory>
<destDir>javadoc</destDir>
<windowtitle>Epiphany</windowtitle>
<doctitle>Epiphany</doctitle>
<show>private</show>
<detectLinks>false</detectLinks>
<detectOfflineLinks>true</detectOfflineLinks>
<linksource>true</linksource>
<additionalparam>-Xdoclint:none</additionalparam>
<detectJavaApiLink>true</detectJavaApiLink>
<links>
<link>https://selenium.googlecode.com/git/docs/api/java</link>
</links>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
<goal>test-javadoc</goal>
</goals>
</execution>
</executions>
</plugin>