DDDSample: 现代领域驱动设计的货物跟踪系统

项目概述

DDDSample 是一个基于现代领域驱动设计（DDD）理念开发的货物跟踪系统，旨在展示如何运用 DDD 原则构建高效、可维护和可扩展的企业级应用。该系统采用了分层架构、事件驱动架构、CQRS 等设计模式，并集成了 Spring Boot、JPA、JMS 等技术，为开发高质量的软件系统提供了良好的范例。

技术栈

• Spring Boot 3：作为基础框架，利用其自动配置和依赖注入功能，简化项目开发和部署。
• JPA (Spring Data JPA)：用于数据库操作，提供简洁的方式访问和管理数据。
• JMS (Spring ActiveMQ)：实现消息队列，支持异步通信和事件驱动架构。

功能特性

策略设计模式

为处理报告提供了策略设计模式，支持线程池（ThreadPool）、消息队列（MessageQueue）和直接处理（Directly）三种方式。通过配置   CargoTrackerApplicationProperties  中的   HandlingReportProcessStrategy  可以灵活选择处理策略，提高了系统的灵活性和可配置性。

 

java          

 @Data @ConfigurationProperties(prefix = "cargotracker.application") public class CargoTrackerApplicationProperties {     private final HandlingReport handingReport = new HandlingReport();     public enum HandlingReportProcessStrategy {         MESSAGE,         THREAD,         DIRECT     }     @Data     public static class HandlingReport {         private HandlingReportProcessStrategy processStrategy = HandlingReportProcessStrategy.DIRECT;     } } 

BDD 测试

在应用层采用行为驱动开发（BDD）测试，提高了测试的可读性和可维护性。通过编写测试用例来验证系统的行为是否符合预期。

无删除设计

各层采用无删除设计，例如可以安全地删除接口层的文件夹，而不会影响系统的其他部分。

领域层分离

将领域层分离为单独的 JAR 文件，避免意外使用领域层外的类，保护领域模型的完整性。

CQRS 分离

利用命令查询职责分离（CQRS）模式，将写操作和读操作分离处理，提高系统的性能和可扩展性。

架构设计

分层架构与模块化

采用清晰的分层架构，将不同职责的代码分离，如领域层、应用层、接口层等。领域层专注于核心业务逻辑，应用层协调业务流程，接口层负责对外提供服务。这种分层设计使得代码结构清晰，易于维护和扩展。

事件驱动架构

使用事件来解耦不同模块之间的依赖，当货物状态发生变化时，发布相应的事件，如   CargoCreatedEvent、 CargoRoutedEvent  等。通过消息队列和事件监听器，实现了异步处理和系统的可扩展性。

领域建模

清晰的领域模型

定义了丰富的领域实体和值对象，如   Cargo、 Itinerary、 Leg、 Location  等，准确地反映了业务领域的概念和关系。

值对象和实体的区分

明确区分了值对象和实体，如   TrackingId  是值对象，用于唯一标识货物； Cargo  是实体，具有唯一标识和生命周期。