java - jlink --module-path 是有序路径吗？

Question

我一直在尝试通过 Hello World 和 Hello JFX World 程序将我的程序迁移到 jlink。我遵循的示例似乎在运行程序时指定了--add-modules。我不明白为什么程序需要在运行时提供 jlink 时提供的信息。

我现在已经成功构建了一个简单的 jlink Hello World 程序，该程序无需在命令行上使用 --add-modules 即可运行。诀窍是更改 jlink 模块路径上指定的模块的顺序。我不知道为什么这有效。

JDK-9、JDK-10 或 JDK-11 文档中在哪里指定或描述了此 jlink 行为？应该如何构建模块路径？

旁白:这种有序链接在 30 年前很常见，当时我曾经在 DEC PDP-11 小型计算机上链接 Fortran IV 和 Macro-11 程序。当我准备放弃时，我想尝试摆弄 jlink 的顺序

模块信息.java:

module TestFXord {
    requires javafx.controls;
    exports testfxord to javafx.graphics;
}

TestFXord.java:

package testfxord;

import javafx.application.Application;
import javafx.event.ActionEvent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

public class TestFXord extends Application {

    @Override
    public void start(Stage primaryStage) {

        Button btn = new Button();
        btn.setText("Say 'Hello World'");
        btn.setOnAction((ActionEvent event) -> {
            System.out.println("Hello World!");
        });

        StackPane root = new StackPane();
        root.getChildren().add(btn);
        Scene scene = new Scene(root, 300, 250);

        primaryStage.setTitle("Hello World!");
        primaryStage.setScene(scene);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }

}

jlink 命令不生成可运行的图像

#! /bin/sh
<jdk-11-path>/bin/jlink --module-path <jdk-11-path>/jmods:<javafx-sdk-11-path>/lib/javafx.base.jar:<javafx-sdk-11-path>/lib/javafx.controls.jar:<javafx-sdk-11-path>/lib/javafx.graphics.jar:<javafx-jmods-11-path>:<path-to-projects>/TestFXord/dist/TestFXord.jar --add-modules TestFXord --strip-debug --launcher TestFXord=TestFXord/testfxord.TestFXord --output dist/jlink/TestFXord

jlink 命令确实构建了可运行的镜像。请注意，现在立即出现在它所依赖的之后。

#! /bin/sh
    <jdk-11-path>/bin/jlink --module-path <jdk-11-path>/jmods:<javafx-jmods-11-path>:<javafx-sdk-11-path>/lib/javafx.base.jar:<javafx-sdk-11-path>/lib/javafx.controls.jar:<javafx-sdk-11-path>/lib/javafx.graphics.jar:<path-to-projects>/TestFXord/dist/TestFXord.jar --add-modules TestFXord --strip-debug --launcher TestFXord=TestFXord/testfxord.TestFXord --output dist/jlink/TestFXord

我认为jlink逐步构建一个符号表，将符号映射到地址，沿着模块路径从左到右工作，并解析(查找其地址)它有地址的符号，并且添加它发现的可用于解析后续模块中的调用的新符号条目。如果模块路径的顺序正确，每个符号都将在此过程中得到解析。如果模块路径的顺序不正确，则会出现尚未解析的符号。当涉及到运行图像时，用户必须添加模块来解决剩余的符号。

换句话说，我认为 jlink 不会返回列表来解析它刚刚发现的早期模块中的符号。考虑一下，我怀疑这样做的原因是，每次添加新模块时返回搜索未解析的符号对于大型应用程序将需要更长的链接过程。听起来对吗？

Answer 1

作为@AlanBateman said in his comment :

The module path specified to --module-path is a path of directories or modules. So the order does matter if you specify multiple locations that have different versions of the same module.

在两个示例中，您都将 JavaFX JMOD 文件和 JavaFX JAR 文件包含在 --module-path 中。不同之处在于您添加它们的顺序。

• 工作示例:首先是 JMOD 文件。
  • jlink 将使用 JMOD 文件中包含的模块
• 非工作示例:JMOD 文件位于最后。
  • jlink 将使用 JAR 文件中包含的模块

JavaFX SDK 附带的 JAR 文件不包含任何必要的 native 代码。如果链接 JAR 文件，生成的镜像将无法执行。

但是，JMOD 文件确实包含必要的 native 代码。事实上，将 native 代码与 Java 代码捆绑在一起是实现 JMOD 格式的主要原因之一。来自 JEP 261 :

The new JMOD format goes beyond JAR files to include native code, configuration files, and other kinds of data that do not fit naturally, if at all, into JAR files. JMOD files are used to package the modules of the JDK itself; they can also be used by developers to package their own modules, if desired.

JMOD files can be used at compile time and link time, but not at run time. To support them at run time would require, in general, that we be prepared to extract and link native-code libraries on-the-fly. This is feasible on most platforms, though it can be very tricky, and we have not seen many use cases that require this capability, so for simplicity we have chosen to limit the utility of JMOD files in this release.

使用jlink时，您应该链接到可用的JMOD文件。如果库不提供 JMOD 文件，则链接到 JAR 文件。

综上所述，您应该从 --module-path 中完全删除 JavaFX JAR 文件——它们是不必要的并且会引起困惑。