Spring Modulith2.0.0

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