Spring モジュリス

モジュール型アプリケーションの構造

Spring Moduliti アプリケーションは通常、次の要素で構成されます。

• アプリケーションの実行に使用されるクラスを含むメインパッケージ。 このクラスには @SpringBootApplication アノテーションが付与されており、通常は実行に使用される main(…) メソッドが含まれています。

• アプリケーションモジュール — 次のものを含むメインパッケージの直接のサブパッケージ。

  • 提供インターフェース ：他のモジュールに提供される API で、通常はモジュールが公開する Spring Bean とドメインイベントを使用して実装します。

  • 内部実装コンポーネント: モジュール内の内部使用を目的としており、外部からはアクセスできません。

  • 必須インターフェース: モジュールによる他のモジュールの機能の使用 (Spring Bean の呼び出し、イベントのリッスン、公開された構成プロパティの使用など)。

以下は、単純なアプリケーションの配置例です。

ここでの orders モジュールの OrderRestController.java は、 catalog モジュールの公開された ProductApi.java に依存しています。

IntelliJ IDEA では、 プロジェクト ツールウィンドウ Alt+1 を開くとすぐに、モジュールアプリケーションの構造を確認し、その部分間を移動できます。

下の図では、最上位モジュールが緑色のロックでマークされ、内部コンポーネントが赤色のロックでマークされたモジュラーアプリケーションが示されています。

また、フレームワークの観点からアプリケーションの 論理構造を確認できます。 @SpringBootApplication が付与されたメインのアプリケーションクラスを選択し、 Alt+7 を押します（またはメインメニューの 表示(V) | ツールウィンドウ(T) | 構造 に移動します）。

Modullith 固有の モジュール ノードには、アプリケーションのモジュール、その ID、許可された依存関係、名前付きインターフェースのリストが表示されます。

Spring モジュリスのガイドラインを適用する

IntelliJ IDEA は、 インスペクションと クイックフィックスのセットを提供することで、アプリケーションの構造を Modulith の Spring アーキテクチャ原則に沿って維持できます。 デフォルトでは、これらのインスペクションは重大度レベルがエラーですが、ハイライトされたコードはコンパイルエラーも実行時エラーも発生しません。 これらの問題は Modulith 固有のテストにのみ不合格となります。

Spring を使用してアプリケーションを実装する場合、開発者はさまざまな Spring Bean を他の Bean に挿入する必要がある場合があります。 IntelliJ IDEA は、 bean の自動補完機能を提供することでこの作業を支援します。

Spring Modulth では、この機能が調整されました。 インジェクションがアプリケーションのモジュール境界に違反した場合、補完ポップアップに警告アイコンが表示されます。

既存のコードの場合、IntelliJ IDEA は、Spring Modullith ルールに違反する bean の使用箇所をハイライトし、コードをモジュラー構造に合わせてリファクタリングするクイックフィックスを提案します ( をクリックするか、 Alt+Enter を押すと呼び出されます)。

アーキテクチャガイドに応じて、次のクイックフィックスから選択できます。

• コンポーネントを元のモジュールからベースパッケージに移動します。

  

• 挿入されたクラスに @NamedInterface のアノテーションを付けて、このクラスを他のモジュールで開きます。

  

• このクラスを含むモジュールを開きます。

  このクイックフィックスは、インポートしたいクラスを含むモジュールに対して、 @ApplicationModule アノテーション付きの package-info.java ファイルを作成します。 モジュールは 未解決 としてマークされます。

  

アプリケーションモジュールの依存関係を操作する

モジュール間の依存関係を指定すると、IntelliJ IDEA はモジュールの名前の補完と検証、およびモジュール間のナビゲーションを提供します。