模块化单体应用构建指南 - 使用Moduliths框架

模块化单体应用构建指南 - 使用Moduliths框架

【免费下载链接】moduliths Building modular, monolithic applications using Spring Boot 项目地址: https://gitcode.com/gh_mirrors/mo/moduliths

项目介绍

Moduliths是一个基于Spring Boot扩展的项目，其核心理念是借助ArchUnit实现对模块化单体（modulithic）Java应用程序开发的支持。此框架已停更并转移到Spring Modulith项目下。尽管如此，对于仍在使用的版本1.3分支，将继续提供与Spring Boot 2.7版本相匹配的bug修复支持。Moduliths旨在通过注解如@Modulith等工具，验证和确保应用遵循预定的模块化架构设计，强调在编译时或测试阶段就能验证架构约束，追求最小程度地侵入到技术选型中。

项目快速启动

要迅速开始一个使用Moduliths的项目，遵循以下步骤：

创建Spring Boot项目

首先，你可以通过Spring Initializer创建一个新的Spring Boot应用。

添加依赖

接下来，在你的项目中加入Moduliths的核心与测试库，确保你的pom.xml包含以下依赖（替换$[modulith version]为实际的版本号）：

<dependencies>
    <!-- 对于@Modulith注解 -->
    <dependency>
        <groupId>org.moduliths</groupId>
        <artifactId>moduliths-core</artifactId>
        <version>$[modulith version]</version>
    </dependency>
    <!-- 测试支持 -->
    <dependency>
        <groupId>org.moduliths</groupId>
        <artifactId>moduliths-test</artifactId>
        <version>$[modulith version]</version>
        <scope>test</scope>
    </dependency>
    
    <!-- 若使用快照版本 -->
    <repositories>
        <repository>
            <id>spring-snapshots</id>
            <url>https://repo.spring.io/libs-snapshot</url>
        </repository>
    </repositories>
</dependencies>

设定包结构与模块测试

确保你的包结构符合描述，并创建模块测试类。例如，对于名为moduleB的模块，可以这样配置测试类：

package com.acme.myapp.moduleB;

import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import org.moduliths.ModuleTest;

@RunWith(SpringRunner.class)
@ModuleTest
public class ModuleBTest {
    // 测试逻辑在此...
}

应用案例和最佳实践

在处理复杂的模块关系时，利用@ModuleTest进行模块测试允许精准控制测试环境，比如通过声明@MockBean来模拟依赖或通过设置BootstrapMode.DIRECT_DEPENDENCIES来限定测试范围仅包括直接依赖的模块。这有助于维持模块间的界限清晰，提升测试的针对性和效率。

示例场景

假设模块A依赖模块B，最佳实践包括明确声明这些依赖，并在测试模块A时考虑这些交互，要么通过模拟(@MockBean)外部依赖，要么设置正确的模块启动模式来自动管理依赖。

典型生态项目

虽然Moduliths项目本身作为一个核心组件存在，但它的理念与Spring生态系统紧密结合，特别是迁移到Spring Modulith之后，该框架成为了构建高度模块化Spring Boot应用的标准方法之一。开发者可以通过集成Spring Boot的众多特性，如自动配置、Spring Cloud服务等，进一步丰富他们的模块化单体应用。此外，考虑到模块化架构的推广，理解如何与Spring Cloud Config、Spring Cloud Gateway等其他Spring Cloud组件协同工作，也是构建现代分布式系统的一个重要方面。

请注意，虽然本教程基于停止维护的Moduliths项目，但它提供的概念和实践经验对于探索更现代的模块化应用开发仍然富有启发性和实用性。

【免费下载链接】moduliths Building modular, monolithic applications using Spring Boot 项目地址: https://gitcode.com/gh_mirrors/mo/moduliths