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

请看下面的详细讲解。

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

在Java SE 9中引入了模块系统，这使得多版本兼容成为了一个挑战。在本篇攻略中，我们将探讨如何创建和使用Java SE 9多版本兼容的JAR包。

创建可兼容的JAR包

在Java SE 9中，为了使一个JAR包能够支持多个版本的Java运行时，我们需要在manifest文件中添加一个特殊的属性：Multi-Release。在这个属性中，我们可以设置在不同的Java运行时环境中所使用的不同版本的类文件。下面是一个示例：

Manifest-Version: 1.0
Implementation-Title: MyLibrary
Multi-Release: true

Name: MyLibrary/myLibraryClass.class
SHA-256-Digest: 0zcbuyttdiucxjrpzh1lnkox5wey4029
Multi-Release: false

Name: MyLibrary/myLibraryAdditionalClass.class
SHA-256-Digest: f1d90ihfnnwwe7jqsbyr1xsft1fy3438
Multi-Release: true
MyLibrary-Additional-Version: 9

Name: MyLibrary/myLibraryAdditionalClass.class
SHA-256-Digest: 8ckuhaj8p209c8q7o78y64g030ytlr50
Multi-Release: true
MyLibrary-Additional-Version: 10

在manifest文件中可以看到，除了常规的属性之外，还有两个Multi-Release属性，其中一个使用了false值，而另一个使用了true值。这是因为我们可以使用多个multi-release属性来表示不同版本的类文件所在的路径，这取决于我们正在使用的Java运行时版本。例如，在上述示例中，如果当前的Java运行时版本低于9，则只会使用myLibraryClass类文件。如果当前的Java运行时版本为9，则会优先使用myLibraryAdditionalClass_v9类文件，如果此文件不存在，Java运行时则会默认使用myLibraryAdditionalClass_v10类文件。

使用可兼容的JAR包

Java SE 9使用multi-release JAR文件具有向后兼容性。这意味着一个JAR包可以同时支持旧版本和新版本的Java虚拟机（JVM）。在使用时，我们只需要像常规JAR包一样，在classpath下添加multi-release JAR包，然后就可以在任何版本的Java运行时中使用它。

下面是一个例子，使用multi-release JAR包来演示实现JDK9+版本下输出 “Hello, Java 9+!”，使用低版本的Java将只输出“Hello, monde!"：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, " + greetJava9Plus());
    }
    private static String greetJava9Plus() {
        try {
            Class.forName("java.lang.Module");
            Module module = HelloWorld.class.getModule();
            return module.getDescriptor().exports().stream().anyMatch(e -> e.source().equals(""))
                    ? "Java 9+!"
                    : "monde!";
        }
        catch (ClassNotFoundException e) {
            return "monde!";
        }
    }
}

这个示例中，我们使用反射来检查当前运行时的版本号，然后动态地决定输出什么。

另外一个例子是，实现一个Java 9的模块myLib，使用反射的方式进行调用，使myLib能够兼容低版本的Java。示例代码如下：

src/myLib/MyLibClass.java:

package myLib;

public class MyLibClass {
    public static void sayHello() {
        System.out.println("Hello, my lib!");
    }
}

src/myLib/module-info.java:

module myLib { 
    exports myLib; 
}

src/legacy/MyLibConsumer.java:

package legacy;

import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

public class MyLibConsumer {
    public static void main(String[] args) {
        try {
            Class<?> c = Class.forName("myLib.MyLibClass");
            Method m = c.getMethod("sayHello");
            m.invoke(null);
        } catch (ClassNotFoundException | InvocationTargetException | IllegalAccessException | NoSuchMethodException e) {
            System.err.println("Error invoking the exported library method: " + e.getMessage());
        }
    }
}

在该示例中，我们创建了一个Java 9模块“myLib”，然后在旧版本的Java下进行反射调用。在这种情况下，我们只是在类路径下添加了myLib的JAR文件。

总结

通过上面两个示例，我们学习了如何创建和使用Java SE 9多版本兼容的JAR包。在使用过程中，我们应该根据需要进行适当的调整，以满足需要在不同版本的Java运行时环境中进行兼容的场景。