1. 導入：なぜAutomatic Moduleが必要なのか
Java 9で導入されたProject Jigsaw（Javaモジュールシステム：JPMS）は、アプリケーションの堅牢性と依存関係の明確化を実現しました。しかし、既存の膨大なJavaライブラリのすべてが`module-info.java`を備えているわけではありません。モジュール化されていない古いJAR（名前付きモジュールではないもの）を読み込む際、JPMSはそれらを「Automatic Module」として自動的に認識します。この仕組みを理解していないと、依存関係の解決やカプセル化の壁に突き当たり、アプリケーションが起動しないといった課題に直面します。今回はこの技術的難所を安全に乗り越える手法を解説します。
2. 基礎知識：モジュールシステムの基本用語
まず、JPMSの基本構造を整理します。
モジュール（module）: `module-info.java`によって定義される、コードとリソースの論理的な集合体です。
exports: モジュール内のパッケージを他のモジュールから利用可能にする設定です。
opens: リフレクションによるアクセスを許可する設定です。
Automatic Module: `module-info.java`を持たないJARファイルがモジュールパスに配置された際、システムが自動的に名前付きモジュールとして扱う仕組みです。この時、モジュール名はJARファイル名から自動生成されます（例：`commons-lang3-3.12.0.jar` -> `commons.lang3`）。
3. 実装と解決策：Automatic Moduleの活用手順
モジュール化されていないライブラリを扱うための手順は以下の通りです。
1. モジュールパスへの配置: `classpath`ではなく`module-path`にJARを配置します。
2. モジュール名の確定: JAR内に`META-INF/MANIFEST.MF`がある場合、`Automatic-Module-Name`属性が指定されていればその名前が優先されます。なければファイル名から推測されます。
3. module-infoでの要求: 自作の`module-info.java`内で、`requires`句を使ってそのライブラリ名を指定します。
4. サンプルプログラム：Automatic Moduleの利用例
以下は、モジュール化されていないライブラリを読み込む際の`module-info.java`と、安全にアクセスするためのコード例です。
// module-info.java
// 自動モジュールとして認識された ‘commons.lang3’ を利用する設定
module my.application {
// ライブラリ名を指定（ファイル名から推測される名前に注意）
requires commons.lang3;
exports com.example.service;
}
// Main.java
package com.example.service;
import org.apache.commons.lang3.StringUtils;
public class App {
public static void main(String[] args) {
// Automatic Module経由でライブラリの機能を使用
String input = ” Hello Java Module “;
String result = StringUtils.trim(input);
// 正常に実行されることを確認
System.out.println(“Result: [” + result + “]”);
}
}
5. 応用・注意点：現場で陥りやすいバグの回避策
現場で最も注意すべきは「モジュール名の揺らぎ」と「リフレクションへの対応」です。
モジュール名の安定化: 自動生成されるモジュール名は、将来的にJARのファイル名が変わると依存関係が崩壊します。可能な限り、`Automatic-Module-Name`をマニフェストに含めたライブラリを選択するか、自前でビルド時にマニフェストを修正することを推奨します。
リフレクションの問題: ライブラリが内部でリフレクションを使用している場合、`Automatic Module`はすべてのパッケージを`exports`しますが、`opens`はされません。もし実行時に`IllegalAccessException`が発生する場合は、起動オプションで以下のように明示的に許可を与える必要があります。
–add-opens <モジュール名>/<パッケージ名>=ALL-UNNAMED
このように、Automatic Moduleは移行期における強力な武器ですが、過信は禁物です。最終的には各ライブラリが正式なモジュールに対応するのを待つか、自らラッパーモジュールを作成する設計を検討しましょう。
コメント