導入: モジュールシステムが解決する課題
Java 9から導入されたJavaプラットフォームモジュールシステム（JPMS）は、アプリケーションの堅牢性と保守性を飛躍的に高める仕組みです。従来のJavaでは、クラスパス上のすべてのクラスがパブリックであれば誰からでもアクセス可能という「カプセル化の欠如」が課題でした。module-info.javaを適切に記述することで、ライブラリの公開範囲を厳密に制御し、依存関係の明確化とランタイムの最適化が可能になります。
基礎知識: モジュールの基本概念
モジュールとは、関連するパッケージやリソースをひとまとめにした単位です。
module-info.javaは、プロジェクトのルートディレクトリに配置する設定ファイルで、そのモジュールが「何を公開し、何に依存しているか」を宣言します。
・exports: 指定したパッケージ内のpublicクラスを他モジュールへ公開します。
・requires: 依存するモジュールを指定します。
・opens: リフレクションによるアクセスを許可します（Spring FrameworkなどのDIコンテナで多用されます）。
実装/解決策: モジュール記述子の定義
モジュールを定義するには、ソースコードのルートに「module-info.java」を作成します。以下は、一般的なライブラリ構成を想定した実装例です。
サンプルプログラム: module-info.javaの構成例
以下は、サービスを提供しつつ、特定のパッケージのみを外部公開し、リフレクションを許可する設定例です。
// モジュール名の定義（慣習としてパッケージ名と合わせるのが一般的）
module com.example.service {
// 他のモジュールから利用可能なパッケージを指定（これがないと非公開扱い）
exports com.example.service.api;
// 必要なモジュール（java.sqlやサードパーティ製ライブラリなど）を宣言
requires java.sql;
requires lombok;
// リフレクション（DI等）を許可するパッケージを指定
// これにより、外部ライブラリがprivateなフィールドにアクセス可能になる
opens com.example.service.internal to spring.beans;
}
応用・注意点: 現場での運用における落とし穴
現場でモジュールシステムを導入する際、最も陥りやすいのが「リフレクションエラー」です。SpringやHibernateなどのフレームワークは、内部的にリフレクションを使用してクラスを操作します。
1. opensの活用: 外部フレームワークに依存するクラスがある場合、module-info.javaでopensを指定しないと「IllegalAccessException」が発生します。もしモジュール化の恩恵のみを受けたい場合は、無理にopensを記述せず、モジュール化せずに扱うことも検討してください。
2. 自動モジュール名: モジュール化されていない既存のJARファイルを依存関係に追加する場合、そのJARは「自動モジュール」として扱われます。その際、JARのファイル名がモジュール名として利用されるため、プロジェクトのビルドツール（Maven/Gradle）で明確に名前を定義しておくのが安全です。
3. 段階的な移行: 全てのライブラリを一気にモジュール化するのは困難です。まずは自作のコアライブラリからモジュール化を進め、徐々に範囲を広げるアプローチを推奨します。
モジュールシステムは学習コストこそ高いですが、大規模なエンタープライズ開発においては、意図しないクラスへの依存を防ぐ強力な武器となります。ぜひ、新規プロジェクトから導入を検討してみてください。
コメント