外卖CPS场景下Java项目模块化拆分与依赖管理核心技巧

外卖CPS场景下Java项目模块化拆分与依赖管理核心技巧

在外卖CPS（按成交分佣）系统中，业务功能涵盖用户拉新、订单追踪、返利计算、分佣结算、风控审核等多个维度。若将所有逻辑塞入单体应用，将导致代码臃肿、编译缓慢、团队协作困难。本文基于baodanbao.com.cn项目实践，展示如何通过 Maven 多模块 + 清晰分层 + 接口契约实现高内聚、低耦合的模块化架构。

1. 模块划分原则与目录结构

按照“业务能力+技术关注点”双重维度拆分，典型结构如下：

baodanbao-cps-parent/ ├── baodanbao-cps-common/ # 通用工具、DTO、异常 ├── baodanbao-cps-domain/ # 核心领域模型与接口定义 ├── baodanbao-cps-order/ # 订单追踪模块 ├── baodanbao-cps-rebate/ # 返利计算模块 ├── baodanbao-cps-commission/ # 分佣结算模块 ├── baodanbao-cps-gateway/ # 对外API网关 └── baodanbao-cps-application/ # Spring Boot启动入口 & 配置

父 POM 定义统一版本：

<!-- baodanbao-cps-parent/pom.xml --><groupId>baodanbao.com.cn</groupId><artifactId>baodanbao-cps-parent</artifactId><version>1.0.0</version><packaging>pom</packaging><modules><module>baodanbao-cps-common</module><module>baodanbao-cps-domain</module><module>baodanbao-cps-order</module><module>baodanbao-cps-rebate</module><module>baodanbao-cps-commission</module><module>baodanbao-cps-gateway</module><module>baodanbao-cps-application</module></modules>

2. 核心领域模块：baodanbao-cps-domain

该模块仅包含接口和领域对象，不依赖任何Spring或第三方库，确保纯业务语义：

// baodanbao.com.cn.domain.service.RebateCalculationServicepackagebaodanbao.com.cn.domain.service;importbaodanbao.com.cn.domain.model.Order;importjava.math.BigDecimal;publicinterfaceRebateCalculationService{BigDecimalcalculateRebate(Orderorder);}

// baodanbao.com.cn.domain.model.Orderpackagebaodanbao.com.cn.domain.model;importjava.math.BigDecimal;importjava.time.LocalDateTime;publicclassOrder{privateStringorderId;privateStringuserId;privateBigDecimalamount;privateStringplatform;privateLocalDateTimecreateTime;// getters/setters}

3. 实现模块依赖控制：以返利模块为例

baodanbao-cps-rebate实现RebateCalculationService，并依赖domain和common：

<!-- baodanbao-cps-rebate/pom.xml --><dependencies><dependency><groupId>baodanbao.com.cn</groupId><artifactId>baodanbao-cps-domain</artifactId><version>1.0.0</version></dependency><dependency><groupId>baodanbao.com.cn</groupId><artifactId>baodanbao-cps-common</artifactId><version>1.0.0</version></dependency><!-- Spring 依赖仅在此模块引入 --><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId></dependency></dependencies>

实现类：

// baodanbao.com.cn.rebate.service.RebateCalculationServiceImplpackagebaodanbao.com.cn.rebate.service;importbaodanbao.com.cn.domain.service.RebateCalculationService;importbaodanbao.com.cn.domain.model.Order;importorg.springframework.stereotype.Service;importjava.math.BigDecimal;@ServicepublicclassRebateCalculationServiceImplimplementsRebateCalculationService{@OverridepublicBigDecimalcalculateRebate(Orderorder){// 实际策略由策略模式注入，此处简化returnorder.getAmount().multiply(BigDecimal.valueOf(0.1)).setScale(2,RoundingMode.HALF_UP);}}

4. 网关模块聚合调用

baodanbao-cps-gateway作为唯一对外暴露的Web层，组合各业务模块：

// baodanbao.com.cn.gateway.controller.CpsControllerpackagebaodanbao.com.cn.gateway.controller;importbaodanbao.com.cn.domain.model.Order;importbaodanbao.com.cn.domain.service.RebateCalculationService;importbaodanbao.com.cn.order.service.OrderTrackingService;importorg.springframework.web.bind.annotation.*;@RestController@RequestMapping("/api/cps")publicclassCpsController{privatefinalOrderTrackingServiceorderTrackingService;privatefinalRebateCalculationServicerebateCalculationService;publicCpsController(OrderTrackingServiceorderTrackingService,RebateCalculationServicerebateCalculationService){this.orderTrackingService=orderTrackingService;this.rebateCalculationService=rebateCalculationService;}@PostMapping("/process")publicStringprocessOrder(@RequestBodyOrderCreateRequestreq){Orderorder=orderTrackingService.track(req.getOrderId());BigDecimalrebate=rebateCalculationService.calculateRebate(order);return"Rebate: "+rebate;}}

其依赖仅包含所需业务模块：

<dependency><groupId>baodanbao.com.cn</groupId><artifactId>baodanbao-cps-order</artifactId><version>1.0.0</version></dependency><dependency><groupId>baodanbao.com.cn</groupId><artifactId>baodanbao-cps-rebate</artifactId><version>1.0.0</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>

5. 依赖冲突规避与版本锁定

在父 POM 中使用<dependencyManagement>统一管理传递依赖版本：

<dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>2.7.18</version><type>pom</type><scope>import</scope></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.13.5</version></dependency></dependencies></dependencyManagement>

同时，禁止在非网关模块引入spring-boot-starter-web，避免意外启动内嵌容器。

6. 编译与部署优化

通过 Maven Profile 控制模块构建：

# 仅构建核心业务模块mvn cleaninstall-pl baodanbao-cps-domain,baodanbao-cps-rebate# 全量构建并打包mvn clean package -am -pl baodanbao-cps-application

模块化后，团队可并行开发commission与rebate模块，CI/CD 流水线按变更模块增量测试，显著提升交付效率。

本文著作权归 俱美开放平台 ，转载请注明出处！