Micronautプロジェクトを複数モジュール化する方法！Gradleの構成を解説
生徒
「先生、Micronautのプロジェクトを複数のモジュールに分けて管理したいんですが、どうすればいいですか？」
先生
「MicronautではGradleを使ってプロジェクトをマルチモジュール化できます。複数のモジュールに分けることで、依存関係の管理やビルド効率を改善できます。」
生徒
「具体的にはどのような構成になるんですか？」
先生
「親プロジェクト（ルート）を作成し、その下にアプリケーションモジュールやライブラリモジュールを作成します。Gradleの設定ファイルでモジュール間の依存関係を指定するのが基本です。」
生徒
「設定例を見せてもらえますか？」
先生
「もちろんです。では具体的にGradleの構成を解説しましょう。」
1. マルチモジュールプロジェクトの基本構成
Micronautで複数モジュール化する場合、ルートプロジェクトを作成し、その配下にアプリケーションモジュールや共通ライブラリモジュールを配置します。例えば、以下のようなディレクトリ構成が考えられます。
micronaut-multi-module/
├── build.gradle
├── settings.gradle
├── app/
│ └── build.gradle
├── common/
│ └── build.gradle
└── service/
└── build.gradle
この構成では、appがメインアプリケーション、commonが共通ライブラリ、serviceがビジネスロジック用モジュールとなります。
2. settings.gradleでモジュールを登録
Gradleではルートプロジェクトのsettings.gradleにサブプロジェクトを登録します。これにより、サブモジュールを一括でビルドできるようになります。
rootProject.name = 'micronaut-multi-module'
include 'app'
include 'common'
include 'service'
この設定により、Gradleはapp、common、serviceモジュールを認識し、依存関係の解決やビルドが可能になります。
3. サブモジュール間の依存関係設定
サブモジュール間の依存関係は、各モジュールのbuild.gradleに記述します。例えば、appモジュールがcommonを利用する場合は以下のように設定します。
dependencies {
implementation project(':common')
implementation("io.micronaut:micronaut-runtime")
}
同様に、serviceモジュールもcommonを依存関係に加えることで、共通のユーティリティやモデルクラスを再利用できます。
4. Gradleビルドの活用ポイント
マルチモジュール構成では、Gradleのビルドキャッシュや並列ビルドを活用すると効率が向上します。特にMicronautはAOTコンパイルやDIコード生成が含まれるため、サブモジュールごとに並列でビルドすると時間を短縮できます。
# gradle.properties
org.gradle.parallel=true
org.gradle.build-cache=true
org.gradle.daemon=true
これにより、モジュール間の再ビルドが最小限になり、開発効率が大幅に向上します。
5. サンプルプロジェクトのアプリケーションモジュール
簡単なサンプルとして、appモジュールでMicronautアプリケーションを起動する例を示します。
import io.micronaut.runtime.Micronaut;
public class Application {
public static void main(String[] args) {
Micronaut.run(Application.class, args);
System.out.println("Micronautマルチモジュールアプリケーションが起動しました。");
}
}
Micronautマルチモジュールアプリケーションが起動しました。
この構成で./gradlew buildを実行すると、すべてのモジュールがビルドされ、依存関係も正しく解決されます。
6. モジュール化によるメリットと注意点
Micronautプロジェクトをモジュール化することで、以下のメリットがあります。
- 共通ライブラリをサブモジュールとして分離でき、コードの再利用性が向上
- ビルド対象を限定できるため、開発中のビルド時間を短縮可能
- CI/CDで部分的なテストやデプロイが可能になる
注意点としては、モジュール間の依存関係が複雑になると管理が難しくなるため、依存関係を整理しながら設計することが重要です。また、GradleのバージョンやMicronautのバージョンにより設定方法が微妙に異なることがあるので、公式ドキュメントも参考にすると安心です。
