架构与系统设计 / 系统课时

按业务模块分包怎么组织

按业务模块分包怎么组织

当 Spring Boot 项目同时包含订单、支付、库存等业务时,先按 controller/service/repository 横向分包,代码会随着规模增长被拆散到多个目录。本课采用“业务模块优先、模块内部再分层”的方式,让一次业务修改尽量收敛在同一个模块中。

学习目标

  • 能按业务模块建立第一层包结构,再在模块内部划分 application、domain、infrastructure
  • 能判断跨模块调用应经过公开入口,还是属于不应出现的直接依赖
  • 能为新的 Spring Boot 项目建立可继续演进的目录骨架

为什么业务模块应该放在第一层

假设系统已有 order、payment、inventory 三个模块。如果第一层按技术类型分成 controller、service、repository,那么一次“修改订单取消规则”的改动可能横跨多个顶层目录;反过来先按业务模块分包,订单相关代码会集中在 order 下,阅读和修改边界都更清楚。

这种组织方式强调的是业务内聚。顶层包先回答“这段代码属于哪个业务能力”,模块内部再回答“它属于应用编排、领域模型还是技术实现”。

业务模块优先的分包结构

模块内部怎样分层

一个常见的模块可以这样理解:application 放用例编排、事务边界和 DTO 转换;domain 放聚合、实体、值对象、领域服务、仓储接口和领域事件;infrastructure 放数据库、消息、缓存、第三方 SDK 等技术实现。若项目需要明确 Web 或消息入口,也可以增加 interfaces 或 adapter,存放 Controller、消费者和请求参数转换。

关键点不是包名必须完全一致,而是依赖方向要稳定:应用层调用领域模型,基础设施层实现领域层声明的端口;领域层本身不要反向依赖 Spring MVC、JPA Repository 实现或远程客户端。

建立一个最小目录骨架

下面的命令适合在 Bash 环境中快速创建两个业务模块,并检查目录是否按“模块优先”组织。

bash
mkdir -p src/main/java/com/example/order/{application,domain,infrastructure}
mkdir -p src/main/java/com/example/payment/{application,domain,infrastructure}
find src/main/java/com/example/order -type d | sort

预期输出:

text
src/main/java/com/example/order
src/main/java/com/example/order/application
src/main/java/com/example/order/domain
src/main/java/com/example/order/infrastructure

这里的目录只是骨架。真正开始写代码后,应继续让订单用例、订单聚合和订单持久化实现分别进入对应层,而不是为了“看起来分层”把同一个职责拆到多个包里。

控制模块之间的依赖

业务模块之间最容易出现的问题,是一个模块直接访问另一个模块的内部类。例如 payment 直接引用 order.infrastructure 下的 Mapper 或数据库实体,这会把两个模块绑在技术实现上。

更稳妥的做法是让跨模块协作经过明确的公开入口,例如应用服务、领域事件或稳定的查询接口。这样即使订单模块以后更换数据库实现,支付模块也不需要跟着修改。

什么时候适合这种组织方式

当系统已经有多个相对独立的业务能力,且团队经常围绕“订单”“支付”“库存”而不是“所有 Controller”“所有 Service”分工时,业务模块优先通常更容易维护。对于很小的 CRUD 项目,过早拆出大量层级反而会增加跳转成本;此时可以保留更扁平的模块结构,等领域规则和协作关系增长后再细分。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按业务模块分包怎么组织

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通