jlink指南

2023/06/09

1. 概述

jlink是一种生成自定义Java运行时镜像的工具,该镜像仅包含给定应用程序所需的平台模块

这样的运行时镜像的行为与JRE完全相同,但仅包含我们选择的模块和它们运行所需的依赖项。模块化运行时镜像的概念是在JEP 220中引入的。

在本教程中,我们将学习如何使用jlink创建自定义JRE,我们还将在JRE中运行并测试我们的模块是否正常运行。

2. 需要创建自定义JRE

让我们通过一个示例来了解自定义运行时镜像背后的动机。

我们将创建一个简单的模块化应用程序。要了解有关创建模块化应用程序的更多信息,请参阅我们关于模块化的文章。

首先,让我们创建一个HelloWorld类和一个相应的模块:

public class HelloWorld {
    private static final Logger LOG = Logger.getLogger(HelloWorld.class.getName());

    public static void main(String[] args) {
        LOG.info("Hello World!");
    }
}
module jlinkModule {
    requires java.logging;
}

要运行这个程序,我们只需要HelloWorld、String、Logger和Object类。

即使这个程序只需要运行四个类,但JRE中的所有预定义类也会被执行,即使我们的程序不需要它们。

因此,要运行一个小程序,我们必须维护一个完整的JRE,这简直是在浪费内存。

因此,自定义的JRE是运行我们的示例的最佳选择。

使用jlink,我们可以创建自己的小型JRE,其中仅包含我们想要使用的相关类,而不会浪费内存,因此,我们将看到性能的提高

3. 构建自定义Java运行时镜像

我们将执行一系列简单的步骤来创建自定义JRE镜像。

3.1 编译模块

首先,让我们从命令行编译上面提到的程序:

javac -d out module-info.java
javac -d out --module-path out cn\tuyucheng\taketoday\jlink\HelloWorld.java

现在,让我们运行该程序:

java --module-path out --module jlinkModule/cn.tuyucheng.taketoday.jlink.HelloWorld

输出将是:

Mar 13, 2019 10:15:40 AM cn.tuyucheng.taketoday.jlink.HelloWorld main
INFO: Hello World!

3.2 使用jdeps列出依赖模块

为了使用jlink,我们需要知道应用程序使用的JDK模块列表,并且我们应该包含在我们的自定义JRE中。

让我们使用jdeps 命令来获取应用程序中使用的依赖模块:

jdeps --module-path out -s --module jlinkModule

输出将是:

jlinkModule -> java.base
jlinkModule -> java.logging

这是有道理的,因为java.base是Java代码库所需的最小模块,而java.logging由我们程序中的记录器使用。

3.3 使用jlink创建自定义JRE

要为基于模块的应用程序创建自定义JRE,我们可以使用jlink命令。这是它的基本语法:

jlink [options] –module-path modulepath
    –add-modules module [, module...]
    --output <target-directory>

现在,让我们使用Java 11为我们的程序创建一个自定义JRE

jlink --module-path "%JAVA_HOME%\jmods";out
    --add-modules jlinkModule
    --output customjre

在这里,–add-modules参数后面的值告诉jlink要包含在JRE中的模块。

最后,–output参数旁边的customjre定义了应该生成我们的自定义JRE的目标目录。

请注意,我们使用Windows shell来执行本教程中的所有命令。Linux和Mac用户可能需要稍微调整它们。

3.4 使用生成的镜像运行应用程序

现在,我们有了由jlink创建的自定义JRE。

为了测试我们的JRE,让我们尝试通过在customjre目录的bin文件夹中导航并运行以下命令来运行我们的模块:

java --module jlinkModule/cn.tuyucheng.taketoday.jlink.HelloWorld

同样,我们使用的Windows shell在进入PATH之前会在当前目录中查找任何可执行文件。当我们在Linux或Mac上时,我们需要特别注意实际运行我们的自定义JRE,而不是针对PATH解析的java。

4. 使用启动器脚本创建自定义JRE

或者,我们还可以使用可执行启动器脚本创建自定义JRE

为此,我们需要运行带有额外–launcher参数的jlink命令,以使用我们的模块和主类创建启动器

jlink --launcher customjrelauncher=jlinkModule/cn.tuyucheng.taketoday.jlink.HelloWorld
    --module-path "%JAVA_HOME%\jmods";out
    --add-modules jlinkModule
    --output customjre

这将在我们的customjre/bin目录中生成两个脚本:customjrelauncher.bat和customjrelauncher。

让我们运行脚本:

customjrelauncher.bat

输出将是:

Mar 18, 2019 12:34:21 AM cn.tuyucheng.taketoday.jlink.HelloWorld main
INFO: Hello World!

5. 总结

在本教程中,我们学习了如何使用jlink创建一个自定义的模块化JRE,该JRE只包含我们模块所需的最少文件。我们还研究了如何使用可以轻松执行和交付的启动器脚本创建自定义JRE。

自定义、模块化的Java运行时镜像非常强大。创建自定义JRE的目标很明确:它们可以节省内存、提高性能以及增强安全性和可维护性。轻量级自定义JRE还使我们能够为小型设备创建可扩展的应用程序。

与往常一样,本教程的完整源代码可在GitHub上获得。

Show Disqus Comments

Post Directory

扫码关注公众号:Taketoday
发送 290992
即可立即永久解锁本站全部文章