Java9系列第三篇-同一個Jar支持多JDK版本運行

2020 年 10 月 16 日
筆記

我計劃在後續的一段時間內，寫一系列關於java 9的文章，雖然java 9 不像Java 8或者Java 11那樣的核心java版本，但是還是有很多的特性值得關注。期待您能關注我，我將把java 9 寫成一系列的文章，大概十篇左右。

本文內容：在Java 9增強了JAR多版本位元組碼文件格式的支持，同一個Jar包可以包含多個Java版本的class文件。使用這個功能，我們可以將應用程序/庫升級到新的Java版本，而不必強迫用戶升級到相同的Java版本。

一、基本使用方法

多版本的位元組碼發行jar包，需要在其MANIFEST.MF中做以下的聲明：

Multi-Release: true

在jar包的META-INF/versions文件目錄裏面可以包含多個版本的class文件，編譯結果目錄結構如下：

jar root
  - A.class
  - B.class
  - META-INF
     - versions
        - 9
           - A.class

假設上文中的根目錄是使用java 8 或之前版本編譯的位元組碼文件A.calss。META-INF/versions/9/ 是使用java 9 編寫的java代碼的編譯結果A.class。

如果jar包是在JDK 8的運行時環境下運行，將使用根目錄下面的class文件進行程序運行。
如果jar包是在JDK 9的運行時環境下運行，將使用META-INF/versions/9/ 下面的class文件進行程序運行。

假設未來這個項目升級JDK 10，決定在A.java中使用Java 10的一些新特性，可以單獨針對A.class進行語法升級，並將編譯結果a.class放置在META-INF/versions/10/ 下面

jar root
  - A.class
  - B.class
  - META-INF
     - versions
        - 9
           - A.class
        - 10
           - A.class

現在，上面的jar包含了可以以三種Java版本運行的位元組碼文件，A.class兼容JDK 8、9、10。

二、真實的例子

java 8代碼

下面的類文件代碼我們讓它運行在Java 8的環境下

package com.example;

public class IOUtil {
  public static String convertToString(InputStream inputStream) throws IOException {
      System.out.println("IOUtil 使用java 8 版本");
      Scanner scanner = new Scanner(inputStream, "UTF-8");
      String str = scanner.useDelimiter("\\A").next();
      scanner.close();
      return str;
  }
}

增加一個Main.java的應用程序入口文件，調用IOUtil.convertToString方法將InputStream轉換成String。

package com.example;

public class Main {
  public static void main(String[] args) throws IOException {
          InputStream inputStream = new ByteArrayInputStream("測試字符串".getBytes());
          String result = IOUtil.convertToString(inputStream);
          System.out.println(result);
      }
}

Java 9代碼

在Java 9 發佈之後，我們決定使用Java 9 的新的語法重寫IOUtil.convertToString方法。

package com.example;

public class IOUtil {
  public static String convertToString(InputStream inputStream) throws IOException {
      System.out.println("IOUtil 使用java 9 版本");
      try (inputStream) {  //Java9版本的增強try-with-resources
          String str = new String(inputStream.readAllBytes());
          return str;
      }
  }
}

如上的代碼所示，我們使用了Java 9的兩個新特性帶有inputStream引用的try-with-resource塊和新的InputStream.readAllBytes()方法。

編譯

將Java8 、Java9的IOUtil.java代碼分別在JDK8、JDK9的版本下分別編譯成class位元組碼文件，並將class文件按照如下的目錄結構打成保存，並打jar包。（先按java8版本打成jar包，然後修改MANIFEST.MF文件，添加java 9位元組碼class文件即可）

D:\multi-release-jar-example\my-lib-jar>tree /A /F
+---com
|   \---example
|           IOUtil.class
|           Main.class
|           
\---META-INF
    |   MANIFEST.MF
    |   
    \---versions
        \---9
            \---com
                \---example
                        IOUtil.class

運行 Main class

在JDK 9的環境下運行這個jar包

D:\multi-release-jar-example>java -cp my-lib.jar com.example.Main
IOUtil 使用java 9 版本
測試字符串

在JDK 8的環境下運行這個jar包

D:\multi-release-jar-example>C:\jdk1.8.0_151\bin\java -cp my-lib.jar com.example.Main
IOUtil 使用java 8 版本
測試字符串

歡迎關注我的博客，裏面有很多精品合集

本文轉載註明出處（必須帶連接，不能只轉文字）：字母哥博客。

覺得對您有幫助的話，幫我點贊、分享！您的支持是我不竭的創作動力！ 。另外，筆者最近一段時間輸出了如下的精品內容，期待您的關注。