Java SE 9 多版本兼容 JAR 包示例

Posted on 2022-08-16 by WalkonNet

說明

Java 9 版本中增強瞭Jar 包多版本字節碼文件格式支持，也就是說在同一個 Jar 包中我們可以包含多個 Java 版本的 class 文件，這樣就能做到 Jar 包升級到新的 Java 版本時不用強迫使用方為瞭使用新 Jar 包而升級自己的業務模塊 Java 版本，也不用針對不同最低支持 Java 版本提供不同的 Jar，真正的做到瞭一個 Jar 包兼容所有的目的。

本文通過以下示例來說明多版本 Jar 包的使用。

環境準備

機器上應該有多個版本的 JDK 用於測試，並且至少有一個是 JDK 9 或者更高版本。

命令行編譯示例

註：本示例無需使用 IDE ，我們用最原始的方式創建一個多版本的 Jar 包。

新建一個文件夾，用項目名稱命名，並且在其中把 src 目錄，包名都建好，可以自定義，後續編譯命令自行調整即可。

src\main\java\git\snippet 目錄下存的是舊版本 JDK 編寫的代碼。在這個目錄下新建兩個類。

package git.snippet;

/**
 * Java SE 9 Multi-Release JAR Files示例
 *
 * @author <a href="mailto:[email protected]" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >Grey</a>
 * @date 2022/8/14
 * @since 9
 */
public class App {
    public static void main(String[] args) {
        Helper.hello(args[0]);
    }
}

package git.snippet;

/**
 * @author <a href="mailto:[email protected]" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >Grey</a>
 * @date 2022/8/14
 * @since 1.7
 */
public class Helper {
    public static void hello(String name) {
        // jdk 9+不能用_作為變量
        String _ = "hello";
        System.out.println(_ + ", " + name);
    }
}

src\main\java9\git\snippet 目錄下存的是新版本 JDK 編寫的代碼。我們需要把 Helper 類用新的 JDK 版本特性來實現。代碼如下

package git.snippet;

/**
 * @author <a href="mailto:[email protected]" rel="external nofollow"  rel="external nofollow"  rel="external nofollow" >Grey</a>
 * @date 2022/8/14
 * @since 9
 */
public class Helper {
    public static void hello(String name) {
        // 舊版本用_作為變量，jdk9不能用_作為變量
        String fixName = "hello";
        System.out.println(fixName + ", " + name + " from jdk9");
    }
}

創建好上述類以後，項目結構如下:

接下來是編譯，在項目目錄下，用 JDK 9+的 javac 執行如下兩個編譯命令

C:\jdk\jdk-11\bin\javac --release 7 -d classes src\main\java\git\snippet\*.java

提示信息如下（僅顯示瞭警告）

D:\git\hello-mrjar>C:\jdk\jdk-11\bin\javac --release 7 -d classes src\main\java\git\snippet\*.java
src\main\java\git\snippet\Helper.java:11: 警告: 從發行版 9 開始, '_' 為關鍵字, 不能用作標識符
        String _ = "hello";
               ^
src\main\java\git\snippet\Helper.java:12: 警告: 從發行版 9 開始, '_' 為關鍵字, 不能用作標識符
        System.out.println(_ + ", " + name);
                           ^
2 個警告

C:\jdk\jdk-11\bin\javac --release 9 -d classes-9 src\main\java9\git\snippet\*.java

無提示信息和報錯信息。

接下來是通過 JDK 9+ 的 jar 進行打包，打包的時候，運行如下打包命令

C:\jdk\jdk-11\bin\jar --create --file target/hello-mrjar.jar --main-class git.snippet.App -C classes . --release 9 -C classes-9 .

如果提示如下報錯信息:

java.nio.file.NoSuchFileException: C:\Users\zhuiz\AppData\Local\Temp\hello-mrjar.jar9462053262887373909.jar -> target\hello-mrjar.jar
at java.base/sun.nio.fs.WindowsException.translateToIOException(WindowsException.java:85)
at java.base/sun.nio.fs.WindowsException.rethrowAsIOException(WindowsException.java:103)
at java.base/sun.nio.fs.WindowsFileCopy.move(WindowsFileCopy.java:395)
at java.base/sun.nio.fs.WindowsFileSystemProvider.move(WindowsFileSystemProvider.java:292)
at java.base/java.nio.file.Files.move(Files.java:1422)
at jdk.jartool/sun.tools.jar.Main.validateAndClose(Main.java:466)
at jdk.jartool/sun.tools.jar.Main.run(Main.java:349)
at jdk.jartool/sun.tools.jar.Main.main(Main.java:1681)

則手動在項目目錄下建立一個target文件夾，再次執行打包命令，錯誤解決。

在 target 目錄下，包已經打好 hello-mrjar.jar 。

最後進行測試，用JDK 9之前的 java 來執行這個 jar 包。

C:\jdk\jdk1.8\bin\java -jar hello-mrjar.jar Grey

輸出如下

hello, Grey

用 JDK 9+ 的 java 來執行這個 jar 包。

C:\jdk\jdk-11\bin\java -jar hello-mrjar.jar Grey

輸出如下：

hello, Grey from jdk9

這樣就實現瞭同一個 Jar 包中包含多個 Java 版本的 class 文件，用不同版本 JDK 執行的時候，運行不同版本的 class 文件。

也可以使用 Intellij IDEA 來創建多版本 Jar，這裡是參考文檔： Creating Multi-Release JAR Files in IntelliJ IDEA

Maven 項目配合多版本 Jar 示例

多數情況下，我們不會手動創建項目目錄並編譯，一般用 Maven 來管理項目。本示例演示如何在 Maven 下進行多版本 Jar 包的管理。

創建一個 Maven 項目，結構如下：

和上例類似， src\main\java9 文件夾中是對應的新版本 JDK 的代碼

src\main\java 文件夾中是對應的舊版本的 JDK 代碼。

代碼清單如下：

package git.snippet;
public class App {
    public static void main(String[] args) {
        System.out.println(String.format("Running on %s", new DefaultVersion().version()));
    }
}

舊版本代碼，放在 src\main\java 對應的包下。

package git.snippet;
public class DefaultVersion {
    public String version() {
        System.out.println("use jdk");
        return System.getProperty("java.version");
    }
}

新版本代碼，放在 src\main\java9 對應的包下。

package git.snippet;

public class DefaultVersion {

    public String version() {
        System.out.println("use jdk 9+");
        return Runtime.version().toString();
    }
}

pom.xml 文件配置，註意，相關的文件夾或者包有調整，需要做對應的調整。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>git.snippet</groupId>
    <artifactId>hello-mrjar-with-maven</artifactId>
    <version>1.0</version>

    <properties>
        <java.version>11</java.version>
        <maven.compiler.source>${java.version}</maven.compiler.source>
        <maven.compiler.target>${java.version}</maven.compiler.target>
        <maven-jar-plugin.version>3.2.0</maven-jar-plugin.version>
    </properties>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <executions>
                    <execution>
                        <id>compile-java-8</id>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                        <configuration>
                            <source>1.8</source>
                            <target>1.8</target>
                            <compileSourceRoots>
                            <!---舊版本代碼的位置-->
                                <compileSourceRoot>${project.basedir}/src/main/java</compileSourceRoot>
                            </compileSourceRoots>
                        </configuration>
                    </execution>
                    <execution>
                        <id>compile-java-9</id>
                        <phase>compile</phase>
                        <goals>
                            <goal>compile</goal>
                        </goals>
                        <configuration>
                            <release>9</release>
                            <compileSourceRoots>
                            <!---新版本代碼的位置-->
                                <compileSourceRoot>${project.basedir}/src/main/java9</compileSourceRoot>
                            </compileSourceRoots>
                            <outputDirectory>${project.build.outputDirectory}/META-INF/versions/9</outputDirectory>
                        </configuration>
                    </execution>
                    <execution>
                        <id>default-testCompile</id>
                        <phase>test-compile</phase>
                        <goals>
                            <goal>testCompile</goal>
                        </goals>
                        <configuration>
                            <skip>true</skip>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>${maven-jar-plugin.version}</version>
                <configuration>
                    <archive>
                        <manifestEntries>
                            <Multi-Release>true</Multi-Release>
                        </manifestEntries>
                        <manifest>
                        <!--設置主方法入口-->
                            <mainClass>git.snippet.App</mainClass>
                        </manifest>
                    </archive>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

然後用新版本的 JDK 進行打包，在項目目錄下執行：

mvn clean package -Dmaven.test.skip=true

提示：

[INFO] --- maven-jar-plugin:3.2.0:jar (default-jar) @ hello-mrjar-with-maven ---
[INFO] Building jar: D:\git\hello-mrjar-with-maven\target\hello-mrjar-with-maven-1.0.jar
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.447 s
[INFO] Finished at: 2022-08-15T11:29:48+08:00
[INFO] ------------------------------------------------------------------------

說明打包成功。然後進入 target 目錄，進行驗證

用舊版本的 Java 執行 Jar 包

C:\jdk\jdk1.8\bin\java -jar hello-mrjar-with-maven-1.0.jar
復制代碼

輸出：

use jdk
Running on 1.8.0_202

用新版本的 Java 執行 Jar 包

C:\jdk\jdk-11\bin\java -jar hello-mrjar-with-maven-1.0.jar

輸出：

use jdk 9+
Running on 11.0.15+8-LTS-149

到此這篇關於Java SE 9 多版本兼容 JAR 包示例的文章就介紹到這瞭,更多相關Java JAR 包內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

Java SE 9 多版本兼容 JAR 包示例

目錄

說明

環境準備

命令行編譯示例

Maven 項目配合多版本 Jar 示例

推薦閱讀：

發佈留言取消回覆

近期文章

目錄

說明

環境準備

命令行編譯示例

Maven 項目配合多版本 Jar 示例

推薦閱讀：

發佈留言 取消回覆

近期文章

標籤

發佈留言取消回覆