架构与系统设计 / 系统课时
用防腐层隔离旧模型
用防腐层隔离旧模型
遗留系统里的字段、术语和接口往往与新领域模型不一致。防腐层的任务不是简单转发请求,而是在边界处完成协议适配和语义翻译,让新模型只表达自己的业务语言,并把旧系统变化限制在一个可控区域内。
学习目标
- 识别防腐层应承担的协议适配与语义转换职责
- 把遗留 DTO、状态码和字段含义转换为新领域模型
- 判断新系统是否仍存在绕过防腐层的模型污染
防腐层隔离的是语义污染
如果遗留系统用 level=3 表示金牌客户、金额使用分为单位、客户编号叫 cust_no,直接把这些结构暴露给新服务,新领域代码很快就会出现 getLevel() == 3、金额除以 100 等遗留规则。即使服务已经拆开,模型实际上仍被旧系统控制。
防腐层(Anti-Corruption Layer,ACL)位于新旧模型之间。它接收遗留协议和数据结构,先解释旧语义,再创建新领域能够直接使用的对象。新领域不需要知道 level=3、balance_cent 或遗留接口路径的存在。

把转换集中在系统边界
一个实用的防腐层通常拆成三类职责:客户端处理旧协议和调用细节,适配器整理传输结构,转换器负责真正的业务语义映射。核心原则是遗留类型只能出现在边界代码里,不能沿调用链继续渗透到应用服务和领域对象。
下面的 Java 17 示例把遗留客户记录转换为新的领域对象。旧系统使用数字等级和分单位余额,新模型改用明确的客户等级与 BigDecimal 金额。
import java.math.BigDecimal;
enum CustomerTier { STANDARD, SILVER, GOLD }
record LegacyCustomer(String custNo, int level, long balanceCent) {}
record Customer(String id, CustomerTier tier, BigDecimal credit) {}
final class LegacyCustomerTranslator {
Customer translate(LegacyCustomer legacy) {
// 数字状态码只允许在防腐层内出现,领域模型只认识明确枚举。
CustomerTier tier = switch (legacy.level()) {
case 1 -> CustomerTier.STANDARD;
case 2 -> CustomerTier.SILVER;
case 3 -> CustomerTier.GOLD;
default -> throw new IllegalArgumentException(
"Unsupported legacy level: " + legacy.level());
};
// 同时完成单位转换,避免 balanceCent 泄漏到领域代码。
BigDecimal credit = BigDecimal.valueOf(legacy.balanceCent(), 2);
return new Customer(legacy.custNo(), tier, credit);
}
}
public class Main {
public static void main(String[] args) {
LegacyCustomer legacy = new LegacyCustomer("C-1001", 3, 8850);
Customer customer = new LegacyCustomerTranslator().translate(legacy);
System.out.printf("%s %s %.2f%n",
customer.id(), customer.tier(), customer.credit());
}
}预期输出
C-1001 GOLD 88.50这里转换的不只是字段名。level=3 被解释成领域概念 GOLD,8850 被解释成金额 88.50。如果以后遗留系统把等级编码改成字符串,只需要调整防腐层,新领域对象和业务规则不应跟着变化。
明确处理不可映射的旧语义
最危险的做法是遇到陌生旧值时静默使用默认值。例如把未知 level 一律映射成 STANDARD,程序虽然继续运行,却可能在授信、定价或权限判断中制造错误结果。无法可靠翻译时,应明确拒绝、记录并进入人工或补偿流程。
对于新模型根本不存在的旧概念,也不要为了“字段齐全”强行复制。先判断它是否参与新上下文的业务决策;不参与就舍弃,需要保留审计信息时则放入专门的集成或审计结构,而不是污染领域实体。
检查边界是否真正生效
完成防腐层后,可以从依赖方向检查效果。领域对象和应用服务中不应导入遗留 DTO;旧状态码、旧字段名和传输单位只应出现在防腐层;所有对旧系统的访问也应通过统一入口,而不是某个业务模块为了方便再次直接调用遗留接口。
如果遗留接口字段变化时只修改防腐层,新领域仍能使用自己的术语表达规则,那么隔离已经产生价值。反过来,只要新代码仍在判断旧状态码或保存旧 DTO,服务虽然物理上拆开了,领域边界仍没有真正建立。