Java 9のモジュールシステムにおけるモジュール記述子（module-info.java）の重要性とは？

モジュールとモジュール記述子の基本

モジュール（Module）とは、パッケージに整理されたクラス群と、プロパティファイルなどの静的リソースから構成されるコードの集合体です。モジュールは、自身を利用するために必要なあらゆる情報を外部環境へ提供します。

そしてモジュール記述子（Module Descriptor）こそが、Java 9で導入されたモジュールシステムの中核となる要素です。モジュール記述子とは、モジュールのディレクトリ階層のルートに配置される「module-info.java」というファイルに記述されたモジュール宣言をコンパイルしたものを指します。

モジュール宣言の例

モジュールは、以下のようなモジュール宣言によって自分自身を定義します。

module com.myproject.module1 {
    requires com.myproject.module2;
    exports com.myproject.project1;
    exports com.myproject.project2;
}

主要なモジュール記述子の一覧

module-info.java で使用できる主なディレクティブ（指示文）とその役割は以下の通りです。

1. module

• module モジュール名：指定した名前のモジュールを宣言します。モジュール定義の出発点となる必須の記述です。

2. requires（依存関係の宣言）

• requires モジュール名：自モジュールが指定したモジュールに依存していることを示します。これにより、対象モジュールがエクスポートしている公開型（public型）へアクセスできるようになります。
• requires transitive モジュール名：このモジュールに依存する他のモジュールも、自動的に指定モジュールへ依存することになります。依存関係の伝播を意図的に制御したい場合に使用します。

3. exports（公開範囲の制御）

• exports パッケージ名：このモジュールをrequireするすべてのモジュールに対して、指定パッケージ内の公開メンバーをエクスポートします。
• exports パッケージ名 to モジュール名：上記と同様ですが、公開メンバーを利用できるモジュールを限定（修飾付きエクスポート）できます。カプセル化をより厳密に行いたい場合に有効です。

4. uses / provides（サービスの利用と提供）

• uses クラス名：現在のモジュールを、指定したサービスのコンシューマー（利用者）として登録します。ServiceLoaderによるサービス検出の前提となります。
• provides クラス名 with 実装クラス名：実装クラスを、指定サービスの実装を提供するプロバイダーとして登録します。usesと組み合わせることで疎結合なプラグイン機構を実現できます。

5. opens（リフレクション許可）

• opens パッケージ名：他のモジュールがリフレクションを使って、指定パッケージ内の非公開（private）メンバーへアクセスできるようにします。JPAやJacksonなど、実行時リフレクションを利用するライブラリとの連携に必要です。
• opens パッケージ名 to モジュール名：上記と同様ですが、リフレクションによるアクセスを許可するモジュールを限定できます（修飾付きオープン）。

まとめ

モジュール記述子は、単なる設定ファイルではなく、モジュール間の依存関係・公開範囲・サービス連携・リフレクション許可といった「モジュールの境界」を明確に定義する重要な仕組みです。これにより、従来のクラスパスでは不可能だった堅牢なカプセル化と、信頼性の高いアプリケーション構成が実現されます。