有没有办法在使用 maven-jlink-plugin 的同时添加 maven 依赖项？

Question

我正在使用这个 Github project 来了解 Java 9 中的新模块化功能。我想向项目添加依赖项并能够构建本机映像。但是，当我尝试向 pom.xml 添加新的依赖项并将 requires 语句添加到模块-info.java 时，我从 maven-jlink-plugin 中收到以下错误：

Error: module-info.class not found for joda.time module

我正在尝试将其用作我可以使用新链接阶段部署图像的概念证明，但自然我需要能够具有外部依赖性并且我需要使用 maven（工作约束）。

更改为 mod-jar/pom。xml

...
 <dependencies>
    <dependency>
      <groupId>joda-time</groupId>
      <artifactId>joda-time</artifactId>
      <version>2.9.9</version>
    </dependency>
  </dependencies>
...

mod-jar/module-info.java

module com.soebes.nine.jar {
  requires java.base;
  requires joda.time;
  exports com.soebes.example.nine.jar;
}

日志：

[INFO] --- maven-jlink-plugin:3.0.0-alpha-1:jlink (default-jlink) @ mod-jlink ---
[INFO] Toolchain in maven-jlink-plugin: jlink [ /Library/Java/JavaVirtualMachines/jdk-9.0.1.jdk/Contents/Home/bin/jlink ]
[INFO] The following dependencies will be linked into the runtime image:
[INFO]  -> module: com.soebes.nine.one ( /Users/sebastianrestrepo/Projects/jdk9-jlink-jmod-example/maven-example/mod-1/target/jmods/com.soebes.nine.one.jmod )
[INFO]  -> module: com.soebes.nine.two ( /Users/sebastianrestrepo/Projects/jdk9-jlink-jmod-example/maven-example/mod-2/target/jmods/com.soebes.nine.two.jmod )
[INFO]  -> module: com.soebes.nine.jar ( /Users/sebastianrestrepo/Projects/jdk9-jlink-jmod-example/maven-example/mod-jar/target/com.soebes.nine.jar-1.0-SNAPSHOT.jar )
[INFO]  -> module: joda.time ( /Users/sebastianrestrepo/.m2/repository/joda-time/joda-time/2.9.9/joda-time-2.9.9.jar )
[ERROR] 
Error: module-info.class not found for joda.time module
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] parent ............................................. SUCCESS [  1.460 s]
[INFO] com.soebes.nine.one ................................ SUCCESS [  2.022 s]
[INFO] com.soebes.nine.two ................................ SUCCESS [  1.392 s]
[INFO] com.soebes.nine.jar ................................ SUCCESS [  1.388 s]
[INFO] mod-jlink .......................................... FAILURE [  1.061 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7.911 s
[INFO] Finished at: 2017-11-03T15:27:35-04:00
[INFO] Final Memory: 26M/981M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-jlink-plugin:3.0.0-alpha-1:jlink (default-jlink) on project mod-jlink:

如果有任何帮助，我将不胜感激。谢谢。

Answer 1

这个有not much to do with the plugin I believe。在您的案例中，模块 joda.time 似乎是一个 自动模块 。

jlink tool does not support linking of automatic modules因为它们可以依赖class路径的任意内容，这违背了自包含Java运行时的想法。

所以可能有两种方法可以解决这个问题:-

（你不拥有 jar）暂时继续创建一个 module-info.java[你可以 use jdeps tool 并更新 jar[使用 jar 工具] 和 Java 下的项目中相应编译的 class 9.
（你拥有依赖）将jar永久迁移到Java 9本身，编译打包后由module-info.class自身组成。

Answer 2

您可以使用 ModiTect Maven plug-in 将模块描述符添加到 JAR 并使用该模块创建模块化运行时映像。

免责声明：我是 ModiTect 的作者。

Answer 3

让我试着解释一下这方面的技术背景：

问题中给出的版本 2.9.9 中的 joda-time 是一个非模块化 jar，它不包含模块-info.class 并且它没有通过使用Automatic-Module-Name：在其 META-INF/MANIFEST.MF

中真实模块中的

类无法在类路径上调用类因此您不能在该版本的模块信息中使用 "requires jode.time"。

自动模块可以在 ClassPath 上使用类。为了在真实模块中使用来自非模块化 jar 的类，您可以使用包装器，它本身就是一个自动模块。

现在已经有 joda-time 的 2.10.1 版本了，它是一个自动模块并声明了 "Automatic-Module-Name: org.joda.time" 因此你可以在你的真实模块中使用新版本的 "requires org.joda.time" .

现在新的 jlink 工具不能直接使用非模块化 jar 或自动 jar 运行，maven-jlink 插件目前基本上只是 jlink 工具的 maven 包装器，将其配置参数转换为 jlink 工具的参数。

为了创建自定义 Java 项目运行时使用混合 Maven 依赖与真实模块、自动模块和非模块化 jar，你必须知道你的真实模块的所有系统模块依赖，自动-模块和非模块化 jar，然后使用 --add-modules 参数与这些 jlink。

要收集系统模块依赖项，您可以使用带有 --print-module-deps 或 --list-deps 参数的新 jdeps 工具，具体取决于所使用的实际 JDK 版本。

如果您在项目中使用 Maven，您可以通过创建或使用 Maven 插件来自动执行该任务。

Answer 4

我在我的一个项目中遇到了类似的问题。首先，我尝试了 moditect-maven-plugin，效果很好！但是，使用此插件，您必须分别配置缺少模块描述符的每个依赖项。 如果您有很多依赖项缺少模块描述符，这会很麻烦。

因此，我决定开发一个新的maven插件，即jigsaw-maven-plugin（见https://github.com/ghackenberg/jigsaw-maven-plugin）。 该插件提供三个目标，用于修补所有未命名模块（参见步骤 3）以及链接和打包这些模块（参见步骤 4 和 5） .

在修补、链接和打包之前，您需要在其中构建项目 JAR（参见步骤 1）并将项目依赖项（参见步骤 2）复制到公共位置（例如 ${project.build.directory}/modules）。也许您可以使用以下构建插件配置开始（有关详细信息，请参阅 GitHub page）：

第 1 步：构建存档

<plugin>
  <artifactId>maven-jar-plugin</artifactId>
  <version>3.2.0</version>
  <configuration>
    <outputDirectory>${project.build.directory}/modules</outputDirectory>
  </configuration>
</plugin>

步骤 2：复制依赖关系

<plugin>
  <artifactId>maven-dependency-plugin</artifactId>
  <version>3.2.0</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>copy-dependencies</goal>
      </goals>
      <configuration>
        <outputDirectory>${project.build.directory}/modules</outputDirectory> 
      </configuration>
    </execution>
  </executions>
</plugin>

第 3 步：修补所有未命名模块

在 modulePath 中搜索缺少模块描述符的 JAR，使用 jdeps 和 javac 生成缺少的模块描述符，并使用 java.util.zip 将它们添加到相应的 JAR。

<plugin>
  <groupId>io.github.ghackenberg</groupId>
  <artifactId>jigsaw-maven-plugin</artifactId>
  <version>1.1.2</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>patch</goal>
      </goals>
      <configuration>
        <modulePath>${project.build.directory}/modules</modulePath>
      </configuration>
    </execution>
  </executions>
</plugin>

第 4 步：Link 模块

Link 个模块使用 jlink.

<plugin>
  <groupId>io.github.ghackenberg</groupId>
  <artifactId>jigsaw-maven-plugin</artifactId>
  <version>1.1.2</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>link</goal>
      </goals>
      <configuration>
        <modulePath>${project.build.directory}/modules</modulePath>
        <module>your.module.name</module>
        <output>${project.build.directory}/image</output>
      </configuration>
    </execution>
  </executions>
</plugin>

第 5 步：打包模块

使用jpackage.

打包模块

<plugin>
  <groupId>io.github.ghackenberg</groupId>
  <artifactId>jigsaw-maven-plugin</artifactId>
  <version>1.1.2</version>
  <executions>
    <execution>
      <phase>package</phase>
      <goals>
        <goal>package</goal>
      </goals>
      <configuration>
        <modulePath>${project.build.directory}/modules</modulePath>
        <runtimeImage>${project.build.directory}/image</runtimeImage>
        <mainClass>your.module.name/your.package.Main</mainClass>
      </configuration>
    </execution>
  </executions>
</plugin>

有没有办法在使用 maven-jlink-plugin 的同时添加 maven 依赖项？

Is there a way to add maven dependencies while using the maven-jlink-plugin?

java

maven

jodatime

java-9

jlink