Spring Modulith 1.3.1

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() { … }
   }