Java 9のjarコマンドでマルチリリースJAR（MRJAR）を作成する方法

マルチリリースJAR（MRJAR）とは

Java 9では、マルチリリースJAR（Multi-Release JAR）形式という新しい機能が導入されました。これにより、1つのJARファイルの中に、実行環境のJavaバージョンに応じて使い分けられる複数バージョンのクラスやリソースを格納できるようになりました。たとえば、Java 8向けのコードはそのまま維持しつつ、Java 9以降で利用可能な最適化された実装を同じJARに同梱することができます。

この記事では、jarコマンドを使用して、Java 8とJava 9の両方でコンパイルされた同一クラスの2つのバージョンを含むマルチリリースJARを作成する手順を解説します。

MRJARを作成するコマンド

以下のように --create オプションと --release オプションを組み合わせて実行します。

C:\Users\User\tutorialspoint>jar --create --file MR.jar -C sampleproject-base demo --release 9 -C sampleproject-9 demo
Warning: entry META-INF/versions/9/demo/SampleClass.class contains a class that is identical to an entry already in the jar

ここで表示される警告メッセージは、META-INF/versions/9 配下に含まれたクラスが、すでにJAR内に存在するエントリと同一であることを知らせるものです。内容が完全に同じ場合でも、バージョンごとのエントリとして登録されるため動作上の問題はありませんが、意図せず重複していないか確認しておくと安心です。

--release 9 オプションの役割

「--release 9」オプションを指定すると、それ以降に記述した内容（この例では sampleproject-9 ディレクトリ内の demo パッケージ）が、MRJAR内のバージョン別エントリである root/META-INF/versions/9 の下に格納されるよう指示されます。

作成されるJARのディレクトリ構成

上記のコマンドを実行すると、MR.jarは次のような構造になります。

jar root
    - demo
        - SampleClass.class
    - META-INF
        - versions
            - 9
                - demo
                    - SampleClass.class

MRJARの動作のポイント

JARのルート直下にある SampleClass.class は従来通りのデフォルトバージョンであり、META-INF/versions/9 配下のクラスはJava 9以降のランタイムでのみ読み込まれます。古いJava 8環境では META-INF/versions ディレクトリが単に無視されるため、同じJARファイルを複数のJavaバージョンで安全に配布できるのが大きなメリットです。