JDK 11+ 和 Javadoc

Question

Exit code: 1 - javadoc: error - The code being documented uses packages in the unnamed module, but the packages defined in https://docs.oracle.com/en/java/javase/11/docs/api/ are in named modules.

有没有人能够使 javadoc 工作而不必将源版本更改为 1.8（如其他论坛中所建议的那样）？我正在使用 JDK v11.0.5 并且问题仍然存在（JDK 12+ 也是如此）。

编辑：此错误源自 maven 并由 maven-javadoc-plugin 抛出。即使使用<source>8</source>配置，我也无法使其适用于 JDK 11+ 。

Answer 1

正如OpenJDK 问题跟踪器中所建议的，这可以通过在 Javadoc 插件上定义源来解决：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <source>8</source>
    </configuration>
</plugin>

Answer 2

添加<detectJavaApiLink>false</detectJavaApiLink>到Maven javadoc插件配置修复错误

Answer 3

我需要 Carlos Santos 的帮助才能使这真正奏效。包含他的答案的完整配置是：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <configuration>
    <source>8</source>
    <detectJavaApiLink>false</detectJavaApiLink>
  </configuration>
</plugin>

Answer 4

javadoc生成您使用的包的链接，例如.../javase/11/docs/api. 虽然您的注释位于未命名的模块中，但目标不是，并且 javadoc 无法将这两者结合起来。它会生成一个文件package-list或一个element-list文件，因此您不能将未命名的模块（包）与命名的模块混合在一起。

我没有找到一种方法来限制 javadoc 尝试生成的链接；所以你可能必须为你自己的项目使用模块。这对我来说似乎很荒谬，只是为了让 javadoc 高兴。我想这只是这么多人坚持使用 Java 8 的原因之一。