16

我有一个具有以下结构的小项目:

pom.xml

src/main/java/
  module-info.java
  de.ps.pl.te/
    package-info.java
    TE.java

src/test/java/
   de.ps.pl.te.test/
     package-info.java
     TETests.java

同样在我的 maven pom 中,我定义了 javadoc 插件,如下所示:

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.1.0</version>
        <configuration>
          <show>protected</show>
          <failOnError>false</failOnError>
        </configuration>
      </plugin>

现在我在运行过程中得到了一些奇怪的输出

mvn clean install site

[信息] 生成“Javadoc”报告 --- maven-javadoc-plugin:3.1.0:aggregate-no-fork [错误] 获取链接时出错:D:\work\eclipse\java\FritzBox\phplib\target\javadoc-捆绑选项。忽略了它。

[...]

[INFO] 生成“测试 Javadoc”报告 --- maven-javadoc-plugin:3.1.0:test-aggregate-no-fork

[错误] 获取链接时出错:D:\work\eclipse\java\FritzBox\phplib\target\javadoc-bundle-options。忽略了它。

正在加载包 de.ps.pl.te.test 的源文件...

1 个错误

[错误] 创建 javadoc 报告时出错:

退出代码:2 - javadoc:错误 - 包 de.powerstat.phplib.templateengine.test 没有源文件

命令行是:[...]javadoc.exe @options @packages

请参阅“[...]”目录中生成的 Javadoc 文件。

org.apache.maven.reporting.MavenReportException:

退出代码:2 - javadoc:错误 - 包 de.ps.pl.te.test 没有源文件

命令行是:[...]javadoc.exe @options @packages

请参阅 '[...]\target\site\testapidocs' 目录中生成的 Javadoc 文件。

在 org.apache.maven.plugins.javadoc.AbstractJavadocMojo.executeJavadocCommandLine (AbstractJavadocMojo.java:5761)

在 org.apache.maven.plugins.javadoc.AbstractJavadocMojo.executeReport (AbstractJavadocMojo.java:2148)

在 org.apache.maven.plugins.javadoc.TestJavadocReport.executeReport (TestJavadocReport.java:162)

[...]

我研究了以下问题:

但我的问题似乎有所不同,并且基于 java 模块化。所以问题是如何修复它 - 或者更多的是制作错误报告?

编辑 1

现在我尝试使用 JDK 11.0.3 和 JDK 12.0.1 - 由于 oracle 证书和服务器问题,我无法下载 OpenJDK - 所以我无法测试 OpenJDK 13 早期访问。

有趣的是,使用版本 11/12 时错误消息略有不同。

对于 JDK 11,错误是:

退出代码:1 - Project\src\main\java\module-info.java:12:错误:找不到模块:org.apache.logging.log4j 需要 org.apache.logging.log4j;

对于 JDK 12,错误是:

退出代码:1 - 错误:找不到模块:de.powerstat.phplib.templateengine

消息的其余部分仍然相同。

我还发现了这里可能涉及的错误报告:

Javadoc 不支持多版本 jar 中的模块信息

我也尝试排除 module-info.java 没有成功:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <version>3.1.0</version>
  <configuration>
    <show>protected</show>
    <failOnError>false</failOnError>
    <sourceFileExcludes>
      <sourceFileExclude>**/module-info.java</sourceFileExclude>
    </sourceFileExcludes>
  </configuration>
</plugin>

编辑 2

在 target\site\apidocs 我可以找到以下(maven 生成?)文件:

  • 参数文件
  • javadoc.bat
  • 选项

参数文件:

'D:/TemplateEngine/src/main/java/de/ps/pl/te/package-info.java'
'D:/TemplateEngine/src/main/java/de/ps/pl/te/TemplateEngine.java'

javadoc.bat:

D:\Programme\Java\jdk-11.0.3\bin\javadoc.exe @options @argfile

包:

de.powerstat.phplib.templateengine
de.powerstat.phplib.templateengine

选项:

--module-path
'C:/.m2/repository/org/apache/logging/log4j/log4j-api/2.11.2/log4j-api-2.11.2.jar;C:/.m2/repository/org/apache/logging/log4j/log4j-core/2.11.2/log4j-core-2.11.2.jar'
-sourcepath
'D:/TemplateEngine/src/main/java'
-d
'D:/TemplateEngine/target/site/apidocs'
-linkoffline
'https://docs.oracle.com/en/java/javase/11/docs/api' 'D:/TemplateEngine/target/javadoc-bundle-options'
[Removed uninteresting parts like encoding, title etc.]

对于有人想亲自尝试的情况,我已经在GitHub 上提供了整个项目

编辑 3:

随着更新到 Java 11.0.10 或其他更新版本,上述一些问题已经消失。但仍然存在一个问题——我已将其报告为错误

4

2 回答 2

1

在测试时我看到了这个错误

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.7.1:site (default-site) on project templateengine: Execution default-site of goal org.apache.maven.plugins:maven-site-plugin:3.7.1:site failed: could not find reports directory [C:\tmp\TemplateEngine\target\pit-reports]
[ERROR]
[ERROR] Please copy and paste the information and the complete stacktrace below when reporting an issue
[ERROR] VM : OpenJDK 64-Bit Server VM
[ERROR] Vendor : Oracle Corporation
[ERROR] Version : 12.0.1+12
[ERROR] Uptime : 146619
[ERROR] Input ->
[ERROR]  1 : -Dclassworlds.conf=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1/bin/m2.conf
[ERROR]  2 : -Dmaven.home=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1
[ERROR]  3 : -Dlibrary.jansi.path=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1/lib/jansi-native
[ERROR]  4 : -Dmaven.multiModuleProjectDirectory=C:/tmp/TemplateEngine
[ERROR] BootClassPathSupported : false

刚刚创建了文件夹“mkdir ./target/pit-reports”,它就消失了。这正在产生问题

<show>private</show>

所以我们可以说你在 maven-javadoc-plugin 中发现了一个错误 :)

于 2019-06-30T10:39:05.240 回答
-1

我最近遇到了同样的错误。看起来是因为我的仓库中的 maven-shade-plugin 。我使用的是 1.6 的旧版本并将其升级到 3.2.4,这个错误就消失了。

于 2020-09-16T15:28:32.073 回答