Spring Modulith 1.1.3

Spring Modulith は、開発者が適切に構造化された Spring Boot アプリケーションを構築できるようにし、ドメインによって駆動されるアプリケーションモジュールを見つけて操作する際に開発者をガイドします。このようなモジュール配置の検証、個々のモジュールの統合テスト、モジュールレベルでのアプリケーションの動作の観察、および作成された配置に基づくドキュメントスニペットの作成をサポートします。

クイックスタート

1. https://start.spring.io で Spring Boot アプリケーションを作成する

2. ビジネスモジュールをアプリケーションのメインパッケージの直接のサブパッケージとして配置する Java パッケージ配置を作成します。

   □ Example
   └─ □ src/main/java
      ├─ □ example           <1>
      │  └─ Application.java
      ├─ □ example.inventory <2>
      │  └─ …
      └─ □ example.order     <2>
         └─ …
   

   1. アプリケーションのルートパッケージ

   2. アプリケーションモジュールパッケージ

3. ApplicationModules モデルを作成し、検証を実行し、ドキュメントスニペットを作成します。

   class ApplicationTests {
   
     @Test
     void writeDocumentationSnippets() {
   
       var modules = ApplicationModules.of(Application.class).verify(); (1)
   
       new Documenter(modules) (2)
         .writeModulesAsPlantUml()
         .writeIndividualModulesAsPlantUml();
     }
   }
   

   1. アプリケーションモジュールモデルを作成し、その構造を検証します。

   2. Asciidoctor スニペット (コンポーネント図、アプリケーションモジュールキャンバス) を target/modulith-docs にレンダリングします。

4. 個々のアプリケーションモジュールの統合テストを実行します。

   □ Example
   └─ □ src/test/java
      └─ □ example.order
         └─ OrderModuleIntegrationTests.java
   
   @ApplicationModuleTests
   class OrderModuleIntegrationTests {
   
     @Test
     void someTestMethod() { … }
   }