FSAC未来超级架构师

架构师总动员
实现架构转型,再无中年危机

说在前面

在40岁老架构师 尼恩的读者交流群(50+)中,最近有小伙伴拿到了一线互联网企业如阿里、滴滴、极兔、有赞、希音、百度、网易、美团的面试资格,遇到很多很重要的面试题:

谈谈你的DDD落地经验?

谈谈你对DDD的理解?

最近有小伙伴在字节,又遇到了相关的面试题。小伙伴懵了, 他从来没有用过DDD,面挂了。关于DDD,尼恩之前给大家梳理过一篇很全的文章:阿里一面:谈一下你对DDD的理解?2W字,帮你实现DDD自由

但是尼恩的文章, 太过理论化,不适合刚入门的人员。所以,尼恩也在不断的为大家找更好的学习资料。

前段时间,尼恩在阿里的技术公众号上看到了一篇文章《殷浩详解DDD:领域层设计规范》 作者是阿里 技术大佬殷浩,非常适合与初学者入门,同时也足够的有深度。

美中不足的是, 殷浩那篇文章的行文风格,对初学者不太友好, 尼恩刚开始看的时候,也比较晦涩。

于是,尼恩在读的过程中,把哪些晦涩的内容,给大家用尼恩的语言, 浅化了一下, 这样大家更容易懂。

本着技术学习、技术交流的目的,这里,把尼恩修改过的 《殷浩详解DDD:领域层设计规范》,通过尼恩的公众号《技术自由圈》发布出来。

特别声明,由于没有殷浩同学的联系方式,这里没有找殷浩的授权,

如果殷浩同学或者阿里技术公众号不同意我的修改,不同意我的发布, 我即刻从《技术自由圈》公众号扯下来。

另外, 文章也特别长, 我也特别准备了PDF版本。如果需要尼恩修改过的PDF版本,也可以通过《技术自由圈》公众号找到尼恩来获取。

本文目录

- 说在前面

- 《殷浩详解DDD:领域层设计规范》正文

  - 从技术视角出发, 探索如何降低软件复杂性

  - 从业务视角出发, 探索如何降低软件复杂性

  - 业务视角的设计方法论和技术视角设计方法论的冲突

  - DDD系列文章的内容

- 第一章 - Domain Primitive

  - DP的定义

  - 1. 电话对应区号的案例分析

    - 问题1 - 接口的清晰度

    - 问题2 - 数据验证和错误处理

    - 问题3 - 业务代码的清晰度

    - 问题4 - 可测试性

  - 2. 降低测试的成本的有效解决方案

    - 评估1 - 接口的清晰度

    - 评估2 - 数据验证和错误处理

    - 评估3 - 业务代码的清晰度

    - 评估4 - 可测试性

    - 评估总结

  - 3. DP进阶使用

    - 新的案例1 - 转账

    - 案例2 - 跨境转账

  - 4. 总结:Domain Primitive的定义和三原则

    - Domain Primitive的定义

    - 使用Domain Primitive的三原则

    - Domain Primitive和DDD里Value Object的区别

    - Domain Primitive和Data Transfer Object (DTO)的区别

    - 什么情况下应该用Domain Primitive

  - 5. 实战 - 老应用重构的流程

    - 第一步 - 创建Domain Primitive,收集所有DP行为

    - 第二步 - 替换数据校验和无状态逻辑

    - 第三步 - 创建新接口

    - 第四步 - 修改外部调用

- 第二章 - 使用DDD进行应用架构

  - 1. 案例分析

    - Transaction Script事务脚本开发模式三大问题

    - 问题1 - 可维护性差

    - 问题2 - 可扩展性差

    - 问题3 - 可测试性差

    - 分析

  - 2. 重构方案

    - 2.1 - 抽象数据存储层

      - 2.1.1 Repository和Entity

    - 2.2 - 抽象第三方服务

      - 2.2.1 防腐层(ACL)

    - 2.3 - 抽象中间件

    - 2.4 - 封装业务逻辑

      - 2.4.1 - 用Domain Primitive封装跟实体无关的无状态计算逻辑

      - 2.4.2 - 用Entity封装单对象的有状态的行为,包括业务校验

      - 2.4.3 - 用Domain Service封装多对象逻辑

    - 2.5 - 重构后结果分析

  - 3. DDD的六边形架构

    - 3.1 - 代码组织结构

      - 3.1.1 - Types模块

      - 3.1.2 - Domain模块

      - 3.1.3 - Application模块

      - 3.1.4 - Infrastructure模块

      - 3.1.5 - Web模块

      - 3.1.6 - Start模块

    - 3.2 - 测试

    - 3.3 - 代码的演进/变化速度

  - 总结

- 未完待续,尼恩说在最后

- 部分历史案例

《殷浩详解DDD:领域层设计规范》正文

DDD的宏观理念其实并不难懂,

如同REST一样,DDD也只是一个设计思想,缺少一套完整的规范,导致DDD新手落地困难。

对于软件开发领域的架构师而言,如何降低系统复杂度始终是一个艰巨的挑战。

从技术视角出发, 探索如何降低软件复杂性

太多太多的行业大佬,尝试从技术层面,尝试去降低系统复杂度

  • 1994 年的 GoF 设计模式

    这个四人团的作品,自不用多说。

  • 1999 年的 Martin Fowler 的代码重构

《重构:改善既有代码设计》是世界级的编程大师Martin Fowler的作品。Martin Fowler被誉为软件开发“教父”,ThoughtWorks公司的首席科学家,同时他也是敏捷开发的开拓者和创始人。Martin Fowler将自己的经历编写成了很多极好的书籍,除了《重构》之外还有《企业应用架构模式》、《领域特定语言》、《NoSQL精粹》、《分析模式:可重用对象模型》等。虽然《重构》的第一版中的代码是用Java语言书写的,其实无关编程语言,只要是程序员就能够从这本书中受益。

  • 2003 年的企业集成模式 EIP(Enterprise Integration Patterns)。

EIP(Enterprise Integration Patterns,企业集成模式)是集成领域的圣经,也是各种MOM消息中间件和ESB的理论基础。在MQ和ESB中常见的各种概念和术语,基本都是来自于EIP,比如消息代理、消息通道、消息端点、消息路由、消息转换、消息增强、信息分支、消息聚合、消息分解、消息重排等等,并在《企业集成模式:设计、构建及部署消息传递解决方案》一书中详细的描述了它们的内容与特点。

这些著作均通过一系列设计模式或范例来降低常见复杂度。

然而,然后, 上面的这些著作,主要从技术视角出发,去解决问题,而未能从业务角度根本解决业务问题。

世界的神奇, 就在于多样性。

从业务视角出发, 探索如何降低软件复杂性

出了从技术视角出发,还有很多大师,从业务视角出发,去探索降低软件复杂性的根本措施。

  • 2003 年 Eric Evans 的《领域驱动设计》

  • 以及后续 Vaughn Vernon 的《实现领域驱动设计》

  • Uncle Bob 的《清洁架构》等书籍

这些书籍,都是从业务角度出发,为全球范围内从事纯业务开发的开发者提供了一套完整的架构思路。

DDD的普及的困难。

DDD作为一种软件架构的方法论 ,从2003年就诞生了。但是,却一直到微服务盛行的20年后,才开始普及和火爆,为什么呢?

根本原因是:

  • 领域驱动设计(DDD)是一种架构思维、软件架构的方法论,而非具体开发框架、软件技术的基础设施。因此在代码层面缺乏足够约束,缺乏足够的、适用多业务场景的开发基础脚手架,使得 DDD 在实际应用中的上手门槛较高。

  • 甚至,从业务视角出发的 设计方法论, 和从技术视角出发的设计方法论,存在着很多的理论冲突。

业务视角的设计方法论和技术视角设计方法论的冲突

首先看第二点,从业务视角出发的 DDD 设计方法论, 和从技术视角出发的很多中间件的设计方法论,存在着很多的理论冲突。

举例来说,Martin Fowler在他个人博客里描述的一个Anti-pattern 反模式  是 Anemic Domain Model (https://martinfowler.com/bliki/AnemicDomainModel.html) (贫血域模型), 但是,恰恰这种 Anti-pattern  反模式,却在实际应用中频繁出现

比如,基于数据库技术和 MVC 的四层应用架构(UI、业务、数据访问、数据库)在一定程度上与 DDD 的概念冲突,导致大部分人在业务分析的时候使用了 DDD 的建模,而在技术落地的时候,使用MVC框架进行落地。

另外,一些热门的 ORM 工具,如 Hibernate 和 Entity Framework,实际上助长了这种 MVC  的贫血模型的传播。

2012年,早期的应用架构仅限于单机加负载均衡,使用 MVC 提供 Rest 接口供外部调用,或者使用 SOAP 或 WebServices 进行 RPC 调用,但主要局限于对外部依赖的协议。

引起我关注的是一个名为防腐层(Anti-Corruption Layer)的概念,在解决外部依赖频繁变更的情况下,如何将核心业务逻辑与外部依赖隔离的机制。防腐层(Anti-Corruption Layer)的概念,在这里尤其适用。

到了 2014 年,面向服务的架构(SOA)开始流行,微服务概念逐渐兴起。

如何将单体应用合理拆分为多个微服务成为热门话题,而 DDD 中的限界上下文(Bounded Context)为微服务拆分提供了合理框架。

如今,在所有事物均可称为“服务”的时代(XAAS),DDD 的思想使我们能够冷静思考,哪些内容可服务化拆分,哪些逻辑需聚合,以降低维护成本,而非简单追求开发效率。

什么是DDD呢?

DDD首先从业务领域入手,划分 业务领域边界,采用事件风暴工作坊方法,分析并提取业务场景中的实体、值对象、聚合根、聚合、领域事件等领域对象,根据限界上下文边界构建领域模型,将领域模型作为微服务设计的输入,进而完成微服务洋细设计。  
  
用DDD方法设计出来的微服务,业务和应用边界非常清晰,符合“高内聚,低耦合”的设计原则,可以轻松适应业务模型变化和微服务架构演进。  
  
——《基于DDD和微服务的中台架构与实现》  

DDD系列文章的内容

因此,这篇 DDD 的文章,旨在总结前人经验,发扬光大 DDD 思想,

并通过一套我认为合理的代码结构、框架和约束,降低 DDD 实践门槛,提升代码质量、可测试性、安全性和健壮性。

未来会覆盖的内容包括:

  • 最佳架构实践:六边形应用架构 / Clean架构的核心思想和落地方案

  • 持续发现和交付:Event Storming > Context Map > Design Heuristics > Modelling

  • 降低架构腐败速度:通过Anti-Corruption Layer集成第三方库的模块化方案

  • 标准组件的规范和边界:Entity, Aggregate, Repository, Domain Service, Application Service, Event, DTO Assembler等

  • 基于Use Case重定义应用服务的边界

  • 基于DDD的微服务化改造及颗粒度控制

  • CQRS架构的改造和挑战

  • 基于事件驱动的架构的挑战

  • 等等

先给大家带来最基础,但极其有价值的Domain Primitive的概念。

第一章 - Domain Primitive

在全面了解DDD之前,首先给大家介绍一个最基础的概念: Domain Primitive(DP/原子领域)。

Domain Primitive的 概念和命名来自于Dan Bergh Johnsson & Daniel Deogun的书 Secure by Design,这本书的章节 https://livebook.manning.com/book/secure-by-design/chapter-5/1

在《代码大全》一书中有DP的类似概念:ADT (抽象数据类型 )是指一些数据以及对这些数据所进行的操作的集合

关于使用ADT (抽象数据类型 )的建议:

1.把常见的底层数据类型创建为ADT并且使用这些ADT,而不再使用底层数据类型

2.把像文件这样的常用对象当成ADT

3.简单的事物也可以当做ADT:这样可以提高代码的自我说明能力,让代码更容易修改。

4.不要让ADT依赖于其存储介质

ADT就是业务上的最小类型,而不是编程语言提供的基础类型

回到 Domain Primitive,首先来看Primitive (原子)的一词的  定义是:

不从任何其他事物发展而来

初级的形成或生长的早期阶段

就好像Integer、String是所有编程语言的Primitive一样,DP是 DDD的 原子类型、基础类型

在DDD里,DP可以说是一切模型、方法、架构的基础,就像Integer、String一样,DP在DDD里,又是无所不在的。

DP的定义

Domain Primitive (DP)是一个在特定领域里,拥有精准定义的、可自我验证的、拥有行为的 Value Object 。

  1. DP是一个传统意义上的Value Object,拥有Immutable的特性

  2. DP是一个完整的概念整体,拥有精准定义

  3. DP使用业务域中的原生语言

  4. DP可以是业务域的最小组成部分、也可以构建复杂组合

所以,第一讲会对DP做一个全面的介绍和分析,从案例入手,看看为什么DP是一个强大的概念。

1. 电话对应区号的案例分析

我们先看一个简单的例子,业务逻辑如下:

一个 新应用,要通过 地推业务员 做推广,

需要做一个用户注册系统,同时希望在用户注册后能够通过 用户电话的地域(区号)对匹配到  区域业务员,后面给对应的   区域业务 员发奖金。

一个简单的用户和用户注册的代码实现,  entity 实体如下

public class User {  
    Long userId;  
    String name;  
    String phone;  
    String address;  
    Long repId;  
}  

服务层代码如下

  
public class RegistrationServiceImpl implements RegistrationService {  
  
    private SalesRepRepository salesRepRepo;  
    private UserRepository userRepo;  
  
    public User register(String name, String phone, String address)   
      throws ValidationException {  
        // 校验逻辑  
        if (name == null || name.length() == 0) {  
            throw new ValidationException("name");  
        }  
        if (phone == null || !isValidPhoneNumber(phone)) {  
            throw new ValidationException("phone");  
        }  
        // 此处省略address的校验逻辑  
  
        // 取电话号里的区号,然后通过区号找到区域内的SalesRep  
        String areaCode = null;  
        String[] areas = new String[]{"0571", "021", "010"};  
        for (int i = 0; i < phone.length(); i++) {  
            String prefix = phone.substring(0, i);  
            if (Arrays.asList(areas).contains(prefix)) {  
                areaCode = prefix;  
                break;  
            }  
        }  
        SalesRep rep = salesRepRepo.findRep(areaCode);  
  
        // 最后创建用户,落盘,然后返回  
        User user = new User();  
        user.name = name;  
        user.phone = phone;  
        user.address = address;  
        if (rep != null) {  
            user.repId = rep.repId;  
        }  
  
        return userRepo.save(user);  
    }  
  
    private boolean isValidPhoneNumber(String phone) {  
        String pattern = "^0[1-9]{2,3}-?\\d{8}$";  
        return phone.matches(pattern);  
    }  
}  

日常绝大部分代码, 其实都跟这个是类似的,乍一看貌似没啥问题,

但我们再深入一步,从以下四个维度去分析一下:

  • 接口的清晰度(可阅读性)

  • 数据验证和错误处理

  • 业务逻辑代码的清晰度

  • 可测试性

问题1 - 接口的清晰度

在Java代码中,对于一个方法来说,所有的参数名在编译时丢失,留下的仅仅是一个参数类型的列表,

所以我们重新看一下以上的接口定义,其实在运行时仅仅是:

User register(String, String, String);  

所以,以下的代码是一段编译器完全不会报错的,很难通过看代码就能发现的bug:

service.register("殷浩", "浙江省杭州市余杭区文三西路969号", "0571-12345678");  

当然,在真实代码中运行时会报错,但这种bug是在运行时被发现的,而不是在编译时。

普通的Code Review也很难发现这种问题,很有可能是代码上线后才会被暴露出来。

这里的思考是,有没有办法在编码时,就避免这种可能会出现的问题?

换句话说,有没有办法让方法入参一目了然,避免入参错误导致的bug?

实际场景中,不得不在方法名上面加上ByXXX来区分,参考如下:

User findByName(String name);  
User findByPhone(String phone);  
User findByNameAndPhone(String name, String phone);  

在这个场景下,由于入参都是String类型,不得不在方法名上面加上ByXXX来区分,

而如果多个参数,比如findByNameAndPhone同样也会陷入前面的入参顺序错误的问题,而且和前面的入参不同,这里参数顺序如果输错了,方法不会报错只会返回null,而这种bug更加难被发现。

问题2 - 数据验证和错误处理

在前面这段数据校验代码:

if (phone == null || !isValidPhoneNumber(phone)) {  
    throw new ValidationException("phone");  
}  

在日常编码中经常会出现,一般来说这种代码需要出现在方法的最前端,确保能够fail-fast。

但是假设你有多个类似的接口和类似的入参,在每个方法里这段逻辑会被重复。

而更严重的是如果未来我们要拓展电话号去包含手机时,很可能需要加入以下代码:

if (phone == null || !isValidPhoneNumber(phone) || !isValidCellNumber(phone)) {  
    throw new ValidationException("phone");  
}  

如果你有很多个地方用到了phone这个入参,但是有个地方忘记修改了,会造成bug。

这是一个DRY原则被违背时经常会发生的问题。

DRY 原则(Don’t Repeat Yourself),中文直译为:不要重复自己。

DRY 原则 应用在编程中,可以理解为:不要写重复的代码。

如果有个新的需求,需要把入参错误的原因返回,那么,上面的这段代码就变得更加复杂:

if (phone == null) {  
    throw new ValidationException("phone不能为空");  
} else if (!isValidPhoneNumber(phone)) {  
    throw new ValidationException("phone格式错误");  
}  

可以想像得到,代码里充斥着大量的类似代码块时,维护成本要有多高。

最后,在这个业务方法里,会(隐性或显性的)抛ValidationException,所以需要外部调用方去try/catch,而业务逻辑异常和数据校验异常被混在了一起,是否是合理的?

在传统Java架构里有几个办法能够去解决一部分问题,常见的如BeanValidation注解或ValidationUtils类,比如:

// Use Bean Validation  
User registerWithBeanValidation(  
  @NotNull @NotBlank String name,  
  @NotNull @Pattern(regexp = "^0?[1-9]{2,3}-?\\d{8}$") String phone,  
  @NotNull String address  
);  
  
// Use ValidationUtils:  
public User registerWithUtils(String name, String phone, String address) {  
    ValidationUtils.validateName(name); // throws ValidationException  
    ValidationUtils.validatePhone(phone);  
    ValidationUtils.validateAddress(address);  
    ...  
}  

但这几个传统的方法同样有问题,

BeanValidation:

  • 通常只能解决简单的校验逻辑,复杂的校验逻辑一样要写代码实现定制校验器

  • 在添加了新校验逻辑时,同样会出现在某些地方忘记添加一个注解的情况,DRY原则还是会被违背

ValidationUtils类:

  • 当大量的校验逻辑集中在一个类里之后,违背了Single Responsibility单一性原则,导致代码混乱和不可维护

  • 业务异常和校验异常还是会混杂

所以,有没有一种方法,能够一劳永逸的解决所有校验的问题以及降低后续的维护成本和异常处理成本呢?

问题3 - 业务代码的清晰度

在这段代码里,根据电话号码,匹配区域业务员:

String areaCode = null;  
//区域编码,区号  
String[] areas = new String[]{"0571", "021", "010"};  
//假设是固定电话号码, 里边含有区号  
  
for (int i = 0; i < phone.length(); i++) {  
    //前缀  
    String prefix = phone.substring(0, i);  
    // 找到区号  
    if (Arrays.asList(areas).contains(prefix)) {  
        areaCode = prefix;  
        break;  
    }  
}  
  
//找到区域 业务员  
SalesRep rep = salesRepRepo.findRep(areaCode);  

这里出现了一段代码, 从电话号码查找区号,这种代码通常被称作“胶水代码”,其本质是由于外部依赖的服务的入参并不符合我们原始的入参导致的。

比如,如果SalesRepRepository包含一个findRepByPhone的方法,则上面大部分的“胶水代码”都不必要了。

所以,一个常见的办法是将这段代码抽离出来,变成独立的一个或多个方法:

private static String findAreaCode(String phone) {  
    for (int i = 0; i < phone.length(); i++) {  
        String prefix = phone.substring(0, i);  
        if (isAreaCode(prefix)) {  
            return prefix;  
        }  
    }  
    return null;  
}  
  
private static boolean isAreaCode(String prefix) {  
    String[] areas = new String[]{"0571", "021"};  
    return Arrays.asList(areas).contains(prefix);  
}  

然后原始代码变为:

String areaCode = findAreaCode(phone);  
SalesRep rep = salesRepRepo.findRep(areaCode);  

而为了复用以上的方法,可能会抽离出一个静态工具类PhoneUtils

但是这里要思考的是,静态工具类是否是最好的实现方式呢?

当你的项目里充斥着大量的静态工具类,业务代码散在多个文件当中时,你是否还能找到核心的业务逻辑呢?

问题4 - 可测试性

为了保证代码质量,每个方法里的每个入参的每个可能出现的条件都要有TC覆盖(假设我们先不去测试内部业务逻辑),所以在我们这个方法里需要以下的TC:

条件 入参 name phone address
入参为null
入参为空
入参不符合要求(可能多个)

假如一个方法有个参数,每个参数有个校验逻辑,至少要有 个TC 。

TC:Test Cases,测试用例,包含输入、期望输出等。

如果这时候在该方法中加入一个新的入参字段fax,即使faxphone的校验逻辑完全一致,为了保证TC覆盖率,也一样需要个新的TC。

而假设有个方法中都用到了phone这个字段,这个方法都需要对该字段进行测试,也就是说整体需要TC的数量:

P∗N∗M  

个测试用例才能完全覆盖所有数据验证的问题,在日常项目中,这个测试的成本非常之高,导致大量的代码没被覆盖到。

而没被测试覆盖到的代码才是最有可能出现问题的地方。

在这个情况下,降低测试成本 == 提升代码质量,如何能够降低测试的成本呢?

2. 降低测试的成本的有效解决方案

我们回头先重新看一下原始的use case,并且标注其中可能重要的概念,业务逻辑如下:

一个 新应用,要通过 地推业务员 做推广,

需要做一个用户注册系统,同时希望在用户注册后能够通过 用户电话的地域(区号)对匹配到  区域业务员,后面给对应的   区域业务 员发奖金。

在分析了use case后,发现其中地推业务员用户本身自带ID属性,属于Entity(实体),而注册系统属于Application Service(应用服务),这几个概念已经有存在。

但是发现电话号这个概念却完全被隐藏到了代码之中。

我们可以问一下自己,取电话号的区号的逻辑是否属于用户(用户的区号?)?是否属于注册服务(注册的区号?)?

如果都不是很贴切,那就说明这个逻辑应该属于一个独立的概念。

所以这里引入我们第一个原则:

Make Implicit Concepts Expecit  
  
将 隐性的概念 显性化  

在这里,我们可以看到,原来电话号仅仅是用户的一个参数,属于隐形概念,但实际上电话号的区号才是真正的业务逻辑,而我们需要将电话号的概念显性化,通过写一个Value Object:

public class PhoneNumber {  
    
    private final String number;  
    public String getNumber() {  
        return number;  
    }  
  
    public PhoneNumber(String number) {  
        if (number == null) {  
            throw new ValidationException("number不能为空");  
        } else if (isValid(number)) {  
            throw new ValidationException("number格式错误");  
        }  
        this.number = number;  
    }  
  
    public String getAreaCode() {  
        for (int i = 0; i < number.length(); i++) {  
            String prefix = number.substring(0, i);  
            if (isAreaCode(prefix)) {  
                return prefix;  
            }  
        }  
        return null;  
    }  
  
    private static boolean isAreaCode(String prefix) {  
        String[] areas = new String[]{"0571", "021", "010"};  
        return Arrays.asList(areas).contains(prefix);  
    }  
  
    public static boolean isValid(String number) {  
        String pattern = "^0?[1-9]{2,3}-?\\d{8}$";  
        return number.matches(pattern);  
    }  
  
}  

这里面有几个很重要的元素:

  1. 通过private final String number确保PhoneNumber是一个(Immutable)Value Object。

    一般来说VO都是Immutable的,这里只是重点强调一下

  2. 校验逻辑都放在了constructor里面,确保只要PhoneNumber类被创建出来后,一定是校验通过的。

  3. 之前的findAreaCode方法变成了PhoneNumber类里的getAreaCode,突出了areaCodePhoneNumber的一个计算属性。

这样做完之后,我们发现把PhoneNumber显性化之后,其实是生成了一个Type(数据类型)和一个Class(类):

  • Type指我们在今后的代码里可以通过PhoneNumber去显性的标识电话号这个概念

  • Class指我们可以把所有跟电话号相关的逻辑完整的收集到一个文件里

这两个概念加起来,构造成了本文标题的Domain Primitive(DP)。

我们看一下全面使用了DP之后效果:

public class User {  
    UserId userId;  
    Name name;  
    PhoneNumber phone;  
    Address address;  
    RepId repId;  
}  
  
public User register(  
  @NotNull Name name,   
  @NotNull PhoneNumber phone,   
  @NotNull Address address  
) {  
    // 找到区域内的SalesRep  
    SalesRep rep = salesRepRepo.findRep(phone.getAreaCode());  
  
    // 最后创建用户,落盘,然后返回,这部分代码实际上也能用Builder解决  
    User user = new User();  
    user.name = name;  
    user.phone = phone;  
    user.address = address;  
    if (rep != null) {  
        user.repId = rep.repId;  
    }  
  
    return userRepo.saveUser(user);  
}  

我们可以看到在使用了DP之后,所有的数据验证逻辑和非业务流程的逻辑都消失了,剩下都是核心业务逻辑,可以一目了然。

我们重新用上面的四个维度评估一下:

评估1 - 接口的清晰度

重构后的方法签名变成了很清晰的:

public User register(Name, PhoneNumber, Address)  

而之前容易出现的bug,如果按照现在的写法

service.register(new Name("殷浩"), new Address("浙江省杭州市余杭区文三西路969号"), new PhoneNumber("0571-12345678"));  

在编译时就会报错,从而很容易的被及时发现

同样的,查询方法可以充分的使用method overloading:

User find(Name name);  
User find(PhoneNumber phone);  
User find(Name name, PhoneNumber phone);  

让接口API变得很干净,易拓展。

评估2 - 数据验证和错误处理

public User register(  
  @NotNull Name name,   
  @NotNull PhoneNumber phone,   
  @NotNull Address address  
) // no throws  

如前文代码展示的,重构后的方法里,完全没有了任何数据验证的逻辑,也不会抛ValidationException

原因是因为DP的特性,只要是能够带到入参里的一定是正确的或null(Bean Validation或lombok的注解能解决null的问题)。所以我们把数据验证的工作量前置到了调用方,而调用方本来就是应该提供合法数据的,所以更加合适。

再展开来看,使用DP的另一个好处就是代码遵循了DRY原则和单一性原则,如果未来需要修改PhoneNumber的校验逻辑,只需要在一个文件里修改即可,所有使用到了PhoneNumber的地方都会生效。

评估3 - 业务代码的清晰度

SalesRep rep = salesRepRepo.findRep(phone.getAreaCode());  
User user = xxx;  
return userRepo.save(user);  

除了在业务方法里不需要校验数据之外,原来的一段胶水代码被改为了PhoneNumber类的一个计算属性getAreaCode,让代码清晰度大大提升。

而且胶水代码通常都不可复用,但是使用了DP后,变成了可复用、可测试的代码。我们能看到,在刨除了数据验证代码、胶水代码之后,剩下的都是核心业务逻辑。(Entity相关的重构在后面文章会谈到,这次先忽略)

评估4 - 可测试性

条件 入参 PhoneNumber phone fax
入参为null
入参为空
入参不符合要求(可能多个)

当我们将PhoneNumber抽取出来之后,在来看测试的TC:

  • 首先PhoneNumber本身还是需要个测试用例,但是由于我们只需要测试单一对象,每个用例的代码量会大大降低,维护成本降低。

  • 每个方法里的每个参数,现在只需要覆盖为null的情况就可以了,其他的case不可能发生(因为只要不是null就一定是合法的)

所以,单个方法的TC从原来的变成了今天的。同样的,多个方法的TC数量变成了

N+M+P  

这个数量一般来说要远低于原来的数量,让测试成本极大的降低。

评估总结

维度 传统代码 使用Domain Primitive
API接口清晰度 含混不清 接口清晰可读
数据校验、错误处理 校验逻辑分布多个地方,大量重复代码 校验逻辑内聚,在接口边界外完成
业务代码的清晰度 校验代码,胶水代码,业务逻辑混杂 无胶水代码,业务逻辑清晰可读
测试复杂度 N M P N + M + P
其他好处
将隐含的概念显性化 整体安全性大大提升 Immutability不可变 线程安全

3. DP进阶使用

在上文我介绍了DP的第一个原则:将隐性的概念显性化。

在这里我将用一个 新的案例,介绍DP的另外两个原则:

  • Make Implicit Context Expecit  将 隐性的 上下文 显性化

  • Encapsulate Multi-Object Behavior  封装 多对象 行为

总结起来的 DP三原则是:

  • 将隐性的概念显性化。

  • 将 隐性的 上下文 显性化

  • 封装 多对象 行为

新的案例1 - 转账

假设现在要实现一个功能,让A用户可以支付x元给用户B,可能的实现如下:

public void pay(BigDecimal money, Long recipientId) {  
    BankService.transfer(money, "CNY", recipientId);  
}  

如果这个是境内转账,并且境内的货币永远不变,该方法貌似没啥问题,

但如果有一天货币变更了(比如欧元区曾经出现的问题),或者我们需要做跨境转账,该方法是明显的bug,因为money对应的货币不一定是CNY。

在这个case里,当我们说“支付x元”时,除了x本身的数字之外,实际上是有一个隐含的概念那就是货币“元”。

但是在原始的入参里,之所以只用了BigDecimal的原因是我们认为CNY货币是默认的,是一个隐含的条件,但是在我们写代码时,需要把所有隐性的条件显性化,而这些条件整体组成当前的上下文。

所以DP的第二个原则是:

Make Implicit Context Expecit  
  
将 隐性的 上下文 显性化  

所以当我们做这个支付功能时,实际上需要的一个入参是支付金额 + 支付货币。

我们可以把这两个概念组合成为一个独立的完整概念:Money

@Value  
public class Money {  
    private BigDecimal amount;  
    private Currency currency;  
    public Money(BigDecimal amount, Currency currency) {  
        this.amount = amount;  
        this.currency = currency;  
    }  
}  

而原有的代码则变为:

public void pay(Money money, Long recipientId) {  
    BankService.transfer(money, recipientId);  
}  

通过将默认货币这个隐性的上下文概念显性化,并且和金额合并为Money,我们可以避免很多当前看不出来,但未来可能会暴雷的bug。

案例2 - 跨境转账

前面的案例升级一下,假设用户可能要做跨境转账从CNY到USD,并且货币汇率随时在波动:

public void pay(Money money, Currency targetCurrency, Long recipientId) {  
    if (money.getCurrency().equals(targetCurrency)) {  
        BankService.transfer(money, recipientId);  
    } else {  
        BigDecimal rate = ExchangeService.getRate(money.getCurrency(), targetCurrency);  
        BigDecimal targetAmount = money.getAmount().multiply(new BigDecimal(rate));  
        Money targetMoney = new Money(targetAmount, targetCurrency);  
        BankService.transfer(targetMoney, recipientId);  
    }  
}  

在这个case里,由于targetCurrency不一定和moneyCurreny一致,需要调用一个服务去取汇率,然后做计算。最后用计算后的结果做转账。

这个case最大的问题在于,金额的计算被包含在了支付的服务中,涉及到的对象也有2个Currency,2个Money,1个BigDecimal,总共5个对象。

这种涉及到多个对象的业务逻辑,需要用DP包装掉,所以这里引出DP的第三个原则:

Encapsulate Multi-Object Behavior    
封装 多对象 行为  

在这个case 里,可以将转换汇率的功能,封装到一个叫做ExchangeRate的DP里:

@Value  
public class ExchangeRate {  
    private BigDecimal rate;  
    private Currency from;  
    private Currency to;  
  
    public ExchangeRate(BigDecimal rate, Currency from, Currency to) {  
        this.rate = rate;  
        this.from = from;  
        this.to = to;  
    }  
  
    public Money exchange(Money fromMoney) {  
        notNull(fromMoney);  
        isTrue(this.from.equals(fromMoney.getCurrency()));  
        BigDecimal targetAmount = fromMoney.getAmount().multiply(rate);  
        return new Money(targetAmount, to);  
    }  
}  

ExchangeRate汇率对象,通过封装金额计算逻辑以及各种校验逻辑,让原始代码变得极其简单:

public void pay(Money money, Currency targetCurrency, Long recipientId) {  
    ExchangeRate rate = ExchangeService.getRate(money.getCurrency(), targetCurrency);  
    Money targetMoney = rate.exchange(money);  
    BankService.transfer(targetMoney, recipientId);  
}  

4. 总结:Domain Primitive的定义和三原则

Domain Primitive的定义

让我们重新来定义一下Domain Primitive:Domain Primitive是一个在特定领域里,拥有精准定义的、可自我验证的、拥有行为的Value Object

  • DP是一个传统意义上的Value Object,拥有Immutable的特性

  • DP是一个完整的概念整体,拥有精准定义

  • DP使用业务域中的原生语言

  • DP可以是业务域的最小组成部分、也可以构建复杂组合

注:Domain Primitive的概念和命名来自于Dan Bergh Johnsson & Daniel Deogun的书 Secure by Design。

使用Domain Primitive的三原则

  • 让隐性的概念显性化

  • 让隐性的上下文显性化

  • 封装多对象行为

Domain Primitive和DDD里Value Object的区别

在DDD中,Value Object这个概念其实已经存在:

  • 在Evans的DDD蓝皮书中,Value Object更多的是一个非Entity的值对象

  • 在Vernon的IDDD红皮书中,作者更多的关注了Value Object的Immutability、Equals方法、Factory方法等

Domain Primitive是Value Object的进阶版,在原始VO的基础上要求每个DP拥有概念的整体,而不仅仅是值对象。

在VO的Immutable基础上增加了Validity和行为。当然同样的要求无副作用(side-effect free)。

Domain Primitive和Data Transfer Object (DTO)的区别

在日常开发中经常会碰到的另一个数据结构是DTO,比如方法的入参和出参。

DP和DTO的区别如下:

|

DTO DP
功能 数据传输 属于技术细节 代表业务域中的概念
数据的关联 只是一堆数据放在一起 不一定有关联度 数据之间的高相关性
行为 无行为 丰富的行为和业务逻辑

什么情况下应该用Domain Primitive

常见的DP的使用场景包括:

  • 有格式限制的String:比如NamePhoneNumberOrderNumberZipCodeAddress

  • 有限制的Integer:比如OrderId(>0),Percentage(0-100%),Quantity(>=0)等

  • 可枚举的int:比如Status(一般不用Enum因为反序列化问题)

  • DoubleBigDecimal:一般用到的DoubleBigDecimal都是有业务含义的,比如TemperatureMoneyAmountExchangeRateRating

  • 复杂的数据结构:比如Map>等,尽量能把Map的所有操作包装掉,仅暴露必要行为

5. 实战 - 老应用重构的流程

老应用,如何进行DP的升级呢?   可以遵循以下流程按部就班的升级。

在此用本文的  电话对应区号的案例  case 为例。

第一步 - 创建Domain Primitive,收集所有DP行为

在前文中,我们发现取电话号的区号这个是一个可以独立出来的、可以放入PhoneNumber这个Class的逻辑。

类似的,在真实的项目中,以前散落在各个服务或工具类里面的代码,可以都抽出来放在DP里,成为DP自己的行为或属性。

这里面的原则是:所有抽离出来的方法要做到无状态

比如原来是static的方法。如果原来的方法有状态变更,需要分离变与不变, 将改变状态的部分和不改状态的部分分离,然后将无状态的部分融入DP。

因为DP本身不能带状态,所以一切需要改变状态的代码都不属于DP的范畴。

(代码参考PhoneNumber的代码,这里不再重复)

第二步 - 替换数据校验和无状态逻辑

为了保障现有方法的兼容性,在第二步不会去修改接口的签名,

有效的办法是:通过代码替换原有的校验逻辑和根DP相关的业务逻辑。

比如:

public User register(String name, String phone, String address)  
        throws ValidationException {  
    if (name == null || name.length() == 0) {  
        throw new ValidationException("name");  
    }  
    if (phone == null || !isValidPhoneNumber(phone)) {  
        throw new ValidationException("phone");  
    }  
      
    String areaCode = null;  
    String[] areas = new String[]{"0571", "021", "010"};  
    for (int i = 0; i < phone.length(); i++) {  
        String prefix = phone.substring(0, i);  
        if (Arrays.asList(areas).contains(prefix)) {  
            areaCode = prefix;  
            break;  
        }  
    }  
    SalesRep rep = salesRepRepo.findRep(areaCode);  
    // 其他代码...  
}  

通过DP替换代码后:

public User register(String name, String phone, String address)  
        throws ValidationException {  
      
    Name _name = new Name(name);  
    PhoneNumber _phone = new PhoneNumber(phone);  
    Address _address = new Address(address);  
      
    SalesRep rep = salesRepRepo.findRep(_phone.getAreaCode());  
    // 其他代码...  
}  

通过new PhoneNumber(phone)这种代码,替代了原有的校验代码。

通过_phone.getAreaCode()替换了原有的无状态的业务逻辑。

第三步 - 创建新接口

创建新接口,将DP的代码提升到接口参数层:

public User register(Name name, PhoneNumber phone, Address address) {  
    SalesRep rep = salesRepRepo.findRep(phone.getAreaCode());  
}  

第四步 - 修改外部调用

外部调用方需要修改调用链路,比如:

service.register("殷浩", "0571-12345678", "浙江省杭州市余杭区文三西路969号");  

改为:

service.register(new Name("殷浩"), new PhoneNumber("0571-12345678"), new Address("浙江省杭州市余杭区文三西路969号"));  

通过以上4步,就能让你的代码变得更加简洁、优雅、健壮、安全。你还在等什么?今天就去尝试吧!

第二章 - 使用DDD进行应用架构

一个好的应用架构,应该需要实现以下几个目标:

  1. 独立于框架:架构不应该依赖某个外部的库或框架,不应该被框架的结构所束缚。

  2. 独立于UI:前台展示的样式可能会随时发生变化(今天可能是网页、明天可能变成console、后天是独立app),但是底层架构不应该随之而变化。

  3. 独立于底层数据源:无论今天你用MySQL、Oracle还是MongoDB、CouchDB,甚至使用文件系统,软件架构不应该因为不同的底层数据储存方式而产生巨大改变。

  4. 独立于外部依赖:无论外部依赖如何变更、升级,业务的核心逻辑不应该随之而大幅变化。

  5. 可测试:无论外部依赖了什么数据库、硬件、UI或者服务,业务的逻辑应该都能够快速被验证正确性。

这就好像是建筑中的楼宇:一个好的楼宇,无论内部承载了什么人、有什么样的活动、还是外部有什么风雨,一栋楼都应该屹立不倒,而且可以确保它不会倒。

但是今天我们在做业务研发时,更多的会去关注一些宏观的架构,比如SOA架构、微服务架构,而忽略了应用内部的架构设计,很容易导致代码逻辑混乱,很难维护,容易产生bug而且很难发现。

今天,我希望能够通过案例的分析和重构,来推演出一套高质量的DDD架构。

1. 案例分析

我们先看一个简单的案例需求如下:

用户可以通过银行网页转账给另一个账号,支持跨币种转账。

同时因为监管和对账需求,需要记录本次转账活动。

拿到这个需求之后,一个开发可能会经历一些技术选型,最终可能拆解需求如下:

  1. 从MySql数据库中找到转出和转入的账户,选择用MyBatis的mapper实现DAO

  2. 从Yahoo(或其他渠道)提供的汇率服务获取转账的汇率信息(底层是http开放接口)

  3. 计算需要转出的金额,确保账户有足够余额,并且没超出每日转账上限

  4. 实现转入和转出操作,扣除手续费,保存数据库

  5. 发送Kafka审计消息,以便审计和对账用

而一个简单的代码实现如下:

public class TransferController {  
    
    private TransferService transferService;  
    
    public Result<Boolean> transfer(String targetAccountNumber, BigDecimal amount, HttpSession session) {  
        Long userId = (Long) session.getAttribute("userId");  
        return transferService.transfer(userId, targetAccountNumber, amount, "CNY");  
    }  
}  
  
public class TransferServiceImpl implements TransferService {  
  
    private static final String TOPIC_AUDIT_LOG = "TOPIC_AUDIT_LOG";  
    private AccountMapper accountDAO;  
    private KafkaTemplate<String, String> kafkaTemplate;  
    private YahooForexService yahooForex;  
  
    @Override  
    public Result<Boolean> transfer(Long sourceUserId, String targetAccountNumber, BigDecimal targetAmount, String targetCurrency) {  
        // 1. 从数据库读取数据,忽略所有校验逻辑如账号是否存在等  
        AccountDO sourceAccountDO = accountDAO.selectByUserId(sourceUserId);  
        AccountDO targetAccountDO = accountDAO.selectByAccountNumber(targetAccountNumber);  
  
        // 2. 业务参数校验  
        if (!targetAccountDO.getCurrency().equals(targetCurrency)) {  
            throw new InvalidCurrencyException();  
        }  
  
        // 3. 获取外部数据,并且包含一定的业务逻辑  
        // exchange rate = 1 source currency = X target currency  
        BigDecimal exchangeRate = BigDecimal.ONE;  
        if (sourceAccountDO.getCurrency().equals(targetCurrency)) {  
            exchangeRate = yahooForex.getExchangeRate(sourceAccountDO.getCurrency(), targetCurrency);  
        }  
        BigDecimal sourceAmount = targetAmount.divide(exchangeRate, RoundingMode.DOWN);  
  
        // 4. 业务参数校验  
        if (sourceAccountDO.getAvailable().compareTo(sourceAmount) < 0) {  
            throw new InsufficientFundsException();  
        }  
  
        if (sourceAccountDO.getDailyLimit().compareTo(sourceAmount) < 0) {  
            throw new DailyLimitExceededException();  
        }  
  
        // 5. 计算新值,并且更新字段  
        BigDecimal newSource = sourceAccountDO.getAvailable().subtract(sourceAmount);  
        BigDecimal newTarget = targetAccountDO.getAvailable().add(targetAmount);  
        sourceAccountDO.setAvailable(newSource);  
        targetAccountDO.setAvailable(newTarget);  
  
        // 6. 更新到数据库  
        accountDAO.update(sourceAccountDO);  
        accountDAO.update(targetAccountDO);  
  
        // 7. 发送审计消息  
        String message = sourceUserId + "," + targetAccountNumber + "," + targetAmount + "," + targetCurrency;  
        kafkaTemplate.send(TOPIC_AUDIT_LOG, message);  
  
        return Result.success(true);  
    }  
}  

我们可以看到,一段业务代码里经常包含了参数校验、数据读取存储、业务计算、调用外部服务、发送消息等多种逻辑。

在这个案例里虽然是写在了同一个方法里,在真实代码中经常会被拆分成多个子方法,但实际效果是一样的,而在我们日常的工作中,绝大部分代码都或多或少的接近于此类结构。

在Martin Fowler的 P of EAA书中,这种很常见的代码样式被叫做Transaction Script(事务脚本)。就像咱们写 shell脚本、 sql脚本一样。

Transaction Script事务脚本开发模式三大问题

Transaction Script事务脚本开发模式,在功能上没有什么问题,

但是长久来看,他有以下三很大的问题:

一、可维护性能差

可维护性 = 当依赖变化时,有多少代码需要随之改变

二、可拓展性差

可扩展性 = 做新需求或改逻辑时,需要新增/修改多少代码

三、可测试性能差

可测试性 = 运行每个测试用例所花费的时间 * 每个需求所需要增加的测试用例数量

问题1 - 可维护性差

什么是 可维护性?可维护性 = 当依赖变化时,有多少代码需要随之改变。

一个应用最大的成本一般都不是来自于开发阶段,而是应用整个生命周期的总维护成本,所以代码的可维护性代表了最终成本。

参考以上的案例代码,事务脚本类的代码很难维护因为以下几点:

  • 数据结构的不稳定性:AccountDO类是一个纯数据结构,映射了数据库中的一个表。

    问题是:数据库的表结构和设计是应用的外部依赖,长远来看都有可能会改变,比如数据库要做Sharding,或者换一个表设计,或者改变字段名。

  • 依赖库的升级:AccountMapper依赖MyBatis的实现,如果MyBatis未来升级版本,可能会造成用法的不同(可以参考iBatis升级到基于注解的MyBatis的迁移成本)。同样的,如果未来换一个ORM体系,迁移成本也是巨大的。

  • 第三方服务依赖的不确定性

    第三方服务,比如Yahoo的汇率服务未来很有可能会有变化:轻则API签名变化,重则服务不可用需要寻找其他可替代的服务。

    在这些情况下改造和迁移成本都是巨大的。

    同时,外部依赖的兜底、限流、熔断等方案都需要随之改变。

  • 第三方服务API的接口变化

    YahooForexService.getExchangeRate返回的结果是小数点还是百分比?入参是(source, target)还是(target, source)?谁能保证未来接口不会改变?如果改变了,核心的金额计算逻辑必须跟着改,否则会造成资损。

  • 中间件更换

    今天我们用Kafka发消息,明天如果要上阿里云用RocketMQ该怎么办?后天如果消息的序列化方式从String改为Binary该怎么办?如果需要消息分片该怎么改?

我们发现案例里的代码对于任何外部依赖的改变都会有比较大的影响。

如果你的应用里有大量的此类代码,你每一天的时间基本上会被各种库升级、依赖服务升级、中间件升级、jar包冲突占满,最终这个应用变成了一个不敢升级、不敢部署、不敢写新功能、并且随时会爆发的炸弹,终有一天会给你带来惊喜。

问题2 - 可扩展性差

什么是可扩展性?可扩展性 = 做新需求或改逻辑时,需要新增/修改多少代码

事务脚本式代码的第二大缺陷是:虽然写单个场景的代码非常高效简单,但是当场景多起来时,其扩展性会变得越来越差。

如果今天需要增加一个跨行转账的能力,你会发现基本上需要重新开发,基本上没有任何的可复用性:

  • 数据来源被固定、数据格式不兼容

    原有的AccountDO是从本地获取的,而跨行转账的数据可能需要从一个第三方服务获取,而服务之间数据格式不太可能是兼容的,导致从数据校验、数据读写、到异常处理、金额计算等逻辑都要重写。

  • 业务逻辑无法复用

    数据格式不兼容的问题会导致核心业务逻辑无法复用。每个用例都是特殊逻辑的后果是最终会造成大量的if-else语句,而这种分支多的逻辑会让分析代码非常困难,容易错过边界情况,造成bug。

  • 逻辑和数据存储的相互依赖

    当业务逻辑增加变得越来越复杂时,新加入的逻辑很有可能需要对数据库schema或消息格式做变更。而变更了数据格式后会导致原有的其他逻辑需要一起跟着动。在最极端的场景下,一个新功能的增加会导致所有原有功能的重构,成本巨大。

在库表驱动开发、库表驱动架构的开发流程中,一般做第一个需求都非常的快,

但是由于代码复用性低,越做到后面,做第N个需求时需要的时间很有可能是呈指数级上升的,

绝大部分时间花费在老功能的重构和兼容上,最终你的创新速度会跌为0,促使老应用被推翻重构。

问题3 - 可测试性差

什么是可测试性?

可测试性 = 运行每个测试用例所花费的时间 * 每个需求所需要增加的测试用例数量

日常工作中,部分工具类、框架类和中间件类的代码有比较高的测试覆盖之外,在业务代码中,很难有比较好的测试覆盖,而绝大部分的业务代码上线前的测试属于人肉的“集成测试”。

低测试率导致我们对代码质量很难有把控,容易错过边界条件,异常case只有线上爆发了才被动发现。

而低测试覆盖率的主要原因是什么?  核心原因: 就是业务代码的可测试性比较差。

参考以上的一段代码,这种代码有极低的可测试性:

  • 设施搭建困难

    当代码中强依赖了数据库、第三方服务、中间件等外部依赖之后,想要完整跑通一个测试用例需要确保所有依赖都能跑起来,这个在项目早期是及其困难的。在项目后期也会由于各种系统的不稳定性而导致测试无法通过。

  • 运行耗时长

    大多数的外部依赖调用都是I/O密集型,如跨网络调用、磁盘调用等,而这种I/O调用在测试时需要耗时很久。另一个经常依赖的是笨重的框架如Spring,启动Spring容器通常需要很久。当一个测试用例需要花超过10秒钟才能跑通时,绝大部分开发都不会很频繁的测试。

  • 耦合度高

    假如一段脚本中有A、B、C三个子步骤,而每个步骤有N个可能的状态,当多个子步骤耦合度高时,为了完整覆盖所有用例,最多需要有N N N个测试用例。当耦合的子步骤越多时,需要的测试用例呈指数级增长。

在事务脚本模式下,当测试用例复杂度远大于真实代码复杂度,当运行测试用例的耗时超出人肉测试时,绝大部分人会选择不写完整的测试覆盖,而这种情况通常就是bug很难被早点发现的原因。

分析

我们重新来分析一下为什么以上的问题会出现?因为以上的代码违背了至少以下几个软件设计的原则:

  • 单一职责原则(Single Responsibility Principle):

    单一职责原则要求一个对象/类应该只有一个变更的原因。但是在这个案例里,代码可能会因为任意一个外部依赖或计算逻辑的改变而改变。

  • 依赖反转原则(Dependency Inversion Principle):

    依赖反转原则要求在代码中依赖抽象,而不是具体的实现。

    在这个案例里外部依赖都是具体的实现,比如YahooForexService虽然是一个接口类,但是它对应的是依赖了Yahoo提供的具体服务,所以也算是依赖了实现。

    同样的KafkaTemplate、MyBatis的DAO实现都属于具体实现。

  • 开放封闭原则(Open Closed Principle):开放封闭原则指开放扩展,但是封闭修改。

    在这个案例里的金额计算属于可能会被修改的代码,这个时候该逻辑应该需要被包装成为不可修改的计算类,新功能通过计算类的拓展实现。

我们需要对代码重构才能解决这些问题。

2. 重构方案

在重构之前,我们先画一张流程图,描述当前代码在做的每个步骤:

图片

这是一个传统的三层分层结构:UI层、业务层、和基础设施层。

上层对于下层有直接的依赖关系,导致耦合度过高。

在业务层中对于下层的基础设施有强依赖,耦合度高。

我们需要对这张图上的每个节点做抽象和整理,来降低对外部依赖的耦合度

2.1 - 抽象数据存储层

第一步常见的操作是将Data Access层做抽象,降低系统对数据库的直接依赖。

具体的方法如下:

  • 新建Account实体对象:

    一个实体(Entity)是拥有ID的域对象,除了拥有数据之外,同时拥有行为。

    Entity和数据库储存格式无关,在设计中要以该领域的通用严谨语言(Ubiquitous Language)为依据。

  • 新建对象储存接口类AccountRepository:

    Repository只负责Entity对象的存储和读取,而Repository的实现类完成数据库存储的细节。

    通过加入Repository接口,底层的数据库连接可以通过不同的实现类而替换。

具体的简单代码实现如下:

Account实体类:

@Data  
public class Account {  
    private AccountId id;  
    private AccountNumber accountNumber;  
    private UserId userId;  
    private Money available;  
    private Money dailyLimit;  
  
    public void withdraw(Money money) {  
        // 转出  
    }  
  
    public void deposit(Money money) {  
        // 转入  
    }  
}  

和AccountRepository及MyBatis实现类:

public interface AccountRepository {  
    Account find(AccountId id);  
    Account find(AccountNumber accountNumber);  
    Account find(UserId userId);  
    Account save(Account account);  
}  
  
public class AccountRepositoryImpl implements AccountRepository {  
  
    @Autowired  
    private AccountMapper accountDAO;  
  
    @Autowired  
    private AccountBuilder accountBuilder;  
  
    @Override  
    public Account find(AccountId id) {  
        AccountDO accountDO = accountDAO.selectById(id.getValue());  
        return accountBuilder.toAccount(accountDO);  
    }  
  
    @Override  
    public Account find(AccountNumber accountNumber) {  
        AccountDO accountDO = accountDAO.selectByAccountNumber(accountNumber.getValue());  
        return accountBuilder.toAccount(accountDO);  
    }  
  
    @Override  
    public Account find(UserId userId) {  
        AccountDO accountDO = accountDAO.selectByUserId(userId.getId());  
        return accountBuilder.toAccount(accountDO);  
    }  
  
    @Override  
    public Account save(Account account) {  
        AccountDO accountDO = accountBuilder.fromAccount(account);  
        if (accountDO.getId() == null) {  
            accountDAO.insert(accountDO);  
        } else {  
            accountDAO.update(accountDO);  
        }  
        return accountBuilder.toAccount(accountDO);  
    }  
}  

上面的代码中,出来了一个新的DO类,其职责是和 表一对一映射用的, 没有行为,只有属性/数据。

Account实体类和AccountDO数据类的对比如下:

  • Data Object数据类:AccountDO是单纯的和数据库表的映射关系,每个字段对应数据库表的一个column,这种对象叫Data Object。

    DO只有数据,没有行为。AccountDO的作用是对数据库做快速映射,避免直接在代码里写SQL。无论你用的是MyBatis还是Hibernate这种ORM,从数据库来的都应该先直接映射到DO上,但是代码里应该完全避免直接操作DO。

  • Entity实体类:Account是基于领域逻辑的实体类,它的字段和数据库储存不需要有必然的联系。

    Entity包含数据,同时也应该包含行为。

    在Account里,字段也不仅仅是String等基础类型,而应该尽可能用上一讲的Domain Primitive代替,可以避免大量的校验代码。

上面的代码中,出来了一个新的DAO类,其职责是和 底层的orm框架强关联,负责 DO模型的对象关系映射。

DAO和Repository类的对比如下:

  • DAO对应的是一个特定的数据库类型的操作,相当于SQL的封装。

    所有操作的对象都是DO类,所有接口都可以根据数据库实现的不同而改变。比如,insert 和 update 属于数据库专属的操作。

  • Repository对应的是Entity对象读取储存的抽象,在接口层面做统一,不关注底层实现。

    比如,通过 save 保存一个Entity对象,但至于具体是 insert 还是 update 并不关心。

    Repository的具体实现类通过调用DAO来实现各种操作,通过Builder/Factory对象实现AccountDO 到 Account之间的转化

2.1.1 Repository和Entity
  • 通过Account 这个Entity对象,解耦了业务代码和ORM映射/DB操作,避免了其他业务逻辑代码和数据库的直接耦合,避免了当数据库字段变化时,大量业务逻辑也跟着变的问题。

  • 通过Repository,改变业务代码的思维方式,让业务逻辑不再面向数据库编程,而是面向领域模型编程。

  • Account  Entity属于一个完整的内存中对象,可以比较容易的做完整的测试覆盖,包含其行为。

  • Repository作为一个接口类,可以比较容易的实现Mock或Stub,可以很容易测试。

  • AccountRepositoryImpl  实现类,由于其职责被单一出来,只需要关注Account到AccountDO的映射关系和Repository方法到DAO方法之间的映射关系,相对于来说更容易测试。

图片

2.2 - 抽象第三方服务

类似对于数据库的抽象,所有第三方服务也需要通过抽象解决第三方服务不可控,入参出参强耦合的问题。

在这个例子里我们抽象出ExchangeRateService的服务,和一个ExchangeRate的Domain Primitive类:

public interface ExchangeRateService {  
    ExchangeRate getExchangeRate(Currency source, Currency target);  
}  
  
public class ExchangeRateServiceImpl implements ExchangeRateService {  
  
    @Autowired  
    private YahooForexService yahooForexService;  
  
    @Override  
    public ExchangeRate getExchangeRate(Currency source, Currency target) {  
        if (source.equals(target)) {  
            return new ExchangeRate(BigDecimal.ONE, source, target);  
        }  
        BigDecimal forex = yahooForexService.getExchangeRate(source.getValue(), target.getValue());  
        return new ExchangeRate(forex, source, target);  
    }  
}  
2.2.1 防腐层(ACL)

这种常见的设计模式叫做Anti-Corruption Layer(防腐层或ACL)。

很多时候我们的系统会去依赖其他的系统,而被依赖的系统可能包含不合理的数据结构、API、协议或技术实现,如果对外部系统强依赖,会导致我们的系统被”腐蚀“。

这个时候,通过在系统间加入一个防腐层,能够有效的隔离外部依赖和内部逻辑,无论外部如何变更,内部代码可以尽可能的保持不变。

图片

ACL不仅仅只是多了一层调用,在实际开发中ACL能够提供更多强大的功能:

  • 适配器:很多时候外部依赖的数据、接口和协议并不符合内部规范,通过适配器模式,可以将数据转化逻辑封装到ACL内部,降低对业务代码的侵入。在这个案例里,我们通过封装了ExchangeRate和Currency对象,转化了对方的入参和出参,让入参出参更符合我们的标准。

  • 缓存:对于频繁调用且数据变更不频繁的外部依赖,通过在ACL里嵌入缓存逻辑,能够有效的降低对于外部依赖的请求压力。同时,很多时候缓存逻辑是写在业务代码里的,通过将缓存逻辑嵌入ACL,能够降低业务代码的复杂度。

  • 兜底:如果外部依赖的稳定性较差,一个能够有效提升我们系统稳定性的策略是通过ACL起到兜底的作用,比如当外部依赖出问题后,返回最近一次成功的缓存或业务兜底数据。这种兜底逻辑一般都比较复杂,如果散落在核心业务代码中会很难维护,通过集中在ACL中,更加容易被测试和修改。

  • 易于测试:类似于之前的Repository,ACL的接口类能够很容易的实现Mock或Stub,以便于单元测试。

  • 功能开关:有些时候我们希望能在某些场景下开放或关闭某个接口的功能,或者让某个接口返回一个特定的值,我们可以在ACL配置功能开关来实现,而不会对真实业务代码造成影响。同时,使用功能开关也能让我们容易的实现Monkey测试,而不需要真正物理性的关闭外部依赖。

图片

2.3 - 抽象中间件

类似于2.2的第三方服务的抽象,对各种中间件的抽象的目的是让业务代码不再依赖中间件的实现逻辑。

因为中间件通常需要有通用型,中间件的接口通常是String或Byte[] 类型的,导致序列化/反序列化逻辑通常和业务逻辑混杂在一起,造成胶水代码。

通过中间件的ACL抽象,减少重复胶水代码。

在这个案例里,我们通过封装一个抽象的AuditMessageProducer和AuditMessage DP对象,实现对底层kafka实现的隔离:

@Value  
@AllArgsConstructor  
public class AuditMessage {  
  
    private UserId userId;  
    private AccountNumber source;  
    private AccountNumber target;  
    private Money money;  
    private Date date;  
      
    public String serialize() {  
        return userId + "," + source + "," + target + "," + money + "," + date;     
    }  
      
    public static AuditMessage deserialize(String value) {  
        // todo  
        return null;  
    }  
}  
  
public interface AuditMessageProducer {  
    SendResult send(AuditMessage message);  
}  
  
public class AuditMessageProducerImpl implements AuditMessageProducer {  
  
    private static final String TOPIC_AUDIT_LOG = "TOPIC_AUDIT_LOG";  
  
    @Autowired  
    private KafkaTemplate<String, String> kafkaTemplate;  
  
    @Override  
    public SendResult send(AuditMessage message) {  
        String messageBody = message.serialize();  
        kafkaTemplate.send(TOPIC_AUDIT_LOG, messageBody);  
        return SendResult.success();  
    }  
}  

具体的分析和2.2类似,在此略过。

图片

2.4 - 封装业务逻辑

在这个案例里,有很多业务逻辑是跟外部依赖的代码混合的,包括金额计算、账户余额的校验、转账限制、金额增减等。这种逻辑混淆导致了核心计算逻辑无法被有效的测试和复用。

在这里,我们的解法是通过Entity、Domain Primitive和Domain Service封装所有的业务逻辑:

2.4.1 - 用Domain Primitive封装跟实体无关的无状态计算逻辑

在这个案例里使用ExchangeRate来封装汇率计算逻辑:

BigDecimal exchangeRate = BigDecimal.ONE;  
if (sourceAccountDO.getCurrency().equals(targetCurrency)) {  
    exchangeRate = yahooForex.getExchangeRate(sourceAccountDO.getCurrency(), targetCurrency);  
}  
BigDecimal sourceAmount = targetAmount.divide(exchangeRate, RoundingMode.DOWN);  

变为:

ExchangeRate exchangeRate = exchangeRateService.getExchangeRate(sourceAccount.getCurrency(), targetMoney.getCurrency());  
Money sourceMoney = exchangeRate.exchangeTo(targetMoney);  
2.4.2 - 用Entity封装单对象的有状态的行为,包括业务校验

用Account实体类封装所有Account的行为,包括业务校验如下:

@Data  
public class Account {  
  
    private AccountId id;  
    private AccountNumber accountNumber;  
    private UserId userId;  
    private Money available;  
    private Money dailyLimit;  
  
    public Currency getCurrency() {  
        return this.available.getCurrency();  
    }  
  
    // 转入  
    public void deposit(Money money) {  
        if (!this.getCurrency().equals(money.getCurrency())) {  
            throw new InvalidCurrencyException();  
        }  
        this.available = this.available.add(money);  
    }  
  
    // 转出  
    public void withdraw(Money money) {  
        if (this.available.compareTo(money) < 0) {  
            throw new InsufficientFundsException();  
        }  
        if (this.dailyLimit.compareTo(money) < 0) {  
            throw new DailyLimitExceededException();  
        }  
        this.available = this.available.subtract(money);  
    }  
}  

原有的业务代码则可以简化为:

sourceAccount.deposit(sourceMoney);  
targetAccount.withdraw(targetMoney);  
2.4.3 - 用Domain Service封装多对象逻辑

在这个案例里,我们发现这两个账号的转出和转入实际上是一体的,也就是说这种行为应该被封装到一个对象中去。特别是考虑到未来这个逻辑可能会产生变化:比如增加一个扣手续费的逻辑。

这个时候在原有的TransferService中做并不合适,在任何一个Entity或者Domain Primitive里也不合适,需要有一个新的类去包含跨域对象的行为。这种对象叫做Domain Service。我们创建一个AccountTransferService的类:

public interface AccountTransferService {  
    void transfer(Account sourceAccount, Account targetAccount, Money targetMoney, ExchangeRate exchangeRate);  
}  
  
public class AccountTransferServiceImpl implements AccountTransferService {  
    private ExchangeRateService exchangeRateService;  
  
    @Override  
    public void transfer(Account sourceAccount, Account targetAccount, Money targetMoney, ExchangeRate exchangeRate) {  
        Money sourceMoney = exchangeRate.exchangeTo(targetMoney);  
        sourceAccount.deposit(sourceMoney);  
        targetAccount.withdraw(targetMoney);  
    }  
}  

而原始代码则简化为一行:

accountTransferService.transfer(sourceAccount, targetAccount, targetMoney, exchangeRate);  

图片

2.5 - 重构后结果分析

这个案例重构后的代码如下:

public class TransferServiceImplNew implements TransferService {  
  
    private AccountRepository accountRepository;  
    private AuditMessageProducer auditMessageProducer;  
    private ExchangeRateService exchangeRateService;  
    private AccountTransferService accountTransferService;  
      
    @Override  
    public Result<Boolean> transfer(Long sourceUserId, String targetAccountNumber, BigDecimal targetAmount, String targetCurrency) {  
        // 参数校验  
        Money targetMoney = new Money(targetAmount, new Currency(targetCurrency));  
  
        // 读数据  
        Account sourceAccount = accountRepository.find(new UserId(sourceUserId));  
        Account targetAccount = accountRepository.find(new AccountNumber(targetAccountNumber));  
        ExchangeRate exchangeRate = exchangeRateService.getExchangeRate(sourceAccount.getCurrency(), targetMoney.getCurrency());  
          
        // 业务逻辑  
        accountTransferService.transfer(sourceAccount, targetAccount, targetMoney, exchangeRate);  
  
        // 保存数据  
        accountRepository.save(sourceAccount);  
        accountRepository.save(targetAccount);  
  
        // 发送审计消息  
        AuditMessage message = new AuditMessage(sourceAccount, targetAccount, targetMoney);  
        auditMessageProducer.send(message);  
  
        return Result.success(true);  
    }  
}  

可以看出来,经过重构后的代码有以下几个特征:

  • 业务逻辑清晰,数据存储和业务逻辑完全分隔。

  • Entity、Domain Primitive、Domain Service都是独立的对象,没有任何外部依赖,但是却包含了所有核心业务逻辑,可以单独完整测试。

  • 原有的TransferService不再包括任何计算逻辑,仅仅作为组件编排,所有逻辑均delegate到其他组件。这种仅包含Orchestration(编排)的服务叫做Application Service(应用服务)。

我们可以根据新的结构重新画一张图:

图片

然后通过重新编排后该图变为:

图片

我们可以发现,通过对外部依赖的抽象和内部逻辑的封装重构,应用整体的依赖关系变了:

  • 最底层不再是数据库,而是Entity、Domain Primitive和Domain Service。这些对象不依赖任何外部服务和框架,而是纯内存中的数据和操作。这些对象我们打包为Domain Layer(领域层)。领域层没有任何外部依赖关系。

  • 再其次的是负责组件编排的Application Service,但是这些服务仅仅依赖了一些抽象出来的ACL类和Repository类,而其具体实现类是通过依赖注入注进来的。Application Service、Repository、ACL等我们统称为Application Layer(应用层)。应用层 依赖 领域层,但不依赖具体实现。

  • 最后是ACL,Repository等的具体实现,这些实现通常依赖外部具体的技术实现和框架,所以统称为Infrastructure Layer(基础设施层)。Web框架里的对象如Controller之类的通常也属于基础设施层。

如果今天能够重新写这段代码,考虑到最终的依赖关系,我们可能先写Domain层的业务逻辑,然后再写Application层的组件编排,最后才写每个外部依赖的具体实现。

这种架构思路和代码组织结构就叫做Domain-Driven Design(领域驱动设计,或DDD)。

所以DDD不是一个特殊的架构设计,而是所有Transction Script代码经过合理重构后一定会抵达的终点。

3. DDD的六边形架构

在我们传统的代码里,我们一般都很注重每个外部依赖的实现细节和规范,但是今天,我们需要敢于抛弃掉原有的理念,重新审视代码结构。

在上面重构的代码里,如果抛弃掉所有Repository、ACL、Producer等的具体实现细节,我们会发现每一个对外部的抽象类,其实就是输入或输出,类似于计算机系统中的I/O节点。

这个观点在CQRS架构中也同样适用,将所有接口分为Command(输入)和Query(输出)两种。

除了Command(输入)和Query(输出) 两种 I/O之外其他的内部逻辑,就是应用业务的核心逻辑。

基于这个基础,Alistair Cockburn在2005年提出了Hexagonal Architecture(六边形架构),又被称之为Ports and Adapters(端口和适配器架构)。

图片

在这张Hex(  Hexagonal Architecture的缩写)六边形架构图中:

  • I/O的具体实现在模型的最外层

  • 每个I/O的适配器在灰色地带

  • 每个Hex的边是一个端口

  • Hex的中央是应用的核心领域模型

在Hex中,架构的组织关系,第一次变成了一个二维的内外关系,而不是传统一维的上下关系。

同时在Hex架构中我们第一次发现UI层、DB层、和各种中间件层实际上是没有本质上区别的,都只是数据的输入和输出,而不是在传统架构中的最上层和最下层。

除了2005年的Hex架构,2008年 Jeffery Palermo的Onion Architecture(洋葱架构)和2017年 Robert Martin的Clean Architecture(干净架构),都是极为类似的思想。

除了命名不一样、切入点不一样之外,其他的整体架构都是基于一个二维的内外关系。

这也说明了基于DDD的架构最终的形态都是类似的。

Herberto Graca有一个很全面的图包含了绝大部分现实中的端口类,值得借鉴。

图片

3.1 - 代码组织结构

为了有效的组织代码结构,避免下层代码依赖到上层实现的情况,在Java中我们可以通过POM Module和POM依赖来处理相互的关系。

通过Spring/SpringBoot的容器来解决运行时动态注入具体实现的依赖的问题。

一个简单的依赖关系图如下:

图片

图片

3.1.1 - Types模块

Types模块是保存可以对外暴露的Domain Primitives的地方。Domain Primitives因为是无状态的逻辑,可以对外暴露,所以经常被包含在对外的API接口中,需要单独成为模块。Types模块不依赖任何类库,纯POJO。

图片

3.1.2 - Domain模块

Domain模块是核心业务逻辑的集中地,包含有状态的Entity、领域服务Domain Service、以及各种外部依赖的接口类(如Repository、ACL、中间件等。Domain模块仅依赖Types模块,也是纯POJO。

图片

3.1.3 - Application模块

Application模块主要包含Application Service和一些相关的类。Application模块依赖Domain模块。还是不依赖任何框架,纯POJO。

图片

3.1.4 - Infrastructure模块

Infrastructure模块包含了Persistence、Messaging、External等模块。比如:Persistence模块包含数据库DAO的实现,包含Data Object、ORM Mapper、Entity到DO的转化类等。Persistence模块要依赖具体的ORM类库,比如MyBatis。如果需要用Spring-Mybatis提供的注解方案,则需要依赖Spring。

图片

3.1.5 - Web模块

Web模块包含Controller等相关代码。如果用SpringMVC则需要依赖Spring。

图片

3.1.6 - Start模块

Start模块是SpringBoot的启动类。

3.2 - 测试

  • Types,Domain模块都属于无外部依赖的纯POJO,基本上都可以100%的被单元测试覆盖。

  • Application模块的代码依赖外部抽象类,需要通过测试框架去Mock所有外部依赖,但仍然可以100%被单元测试。

  • Infrastructure的每个模块的代码相对独立,接口数量比较少,相对比较容易写单测。但是由于依赖了外部I/O,速度上不可能很快,但好在模块的变动不会很频繁,属于一劳永逸。

  • Web模块有两种测试方法:通过Spring的MockMVC测试,或者通过HttpClient调用接口测试。但是在测试时最好把Controller依赖的服务类都Mock掉。一般来说当你把Controller的逻辑都后置到Application Service中时,Controller的逻辑变得极为简单,很容易100%覆盖。

  • Start模块:通常应用的集成测试写在start里。当其他模块的单元测试都能100%覆盖后,集成测试用来验证整体链路的真实性。

【DDD的测试规范在后续文章中详解】

3.3 - 代码的演进/变化速度

在传统架构中,代码从上到下的变化速度基本上是一致的,改个需求需要从接口、到业务逻辑、到数据库全量变更,而第三方变更可能会导致整个代码的重写。但是在DDD中不同模块的代码的演进速度是不一样的:

  • Domain层属于核心业务逻辑,属于经常被修改的地方。比如:原来不需要扣手续费,现在需要了之类的。通过Entity能够解决基于单个对象的逻辑变更,通过Domain Service解决多个对象间的业务逻辑变更。

  • Application层属于Use Case(业务用例)。业务用例一般都是描述比较大方向的需求,接口相对稳定,特别是对外的接口一般不会频繁变更。添加业务用例可以通过新增Application Service或者新增接口实现功能的扩展。

  • Infrastructure层属于最低频变更的。一般这个层的模块只有在外部依赖变更了之后才会跟着升级,而外部依赖的变更频率一般远低于业务逻辑的变更频率。

所以在DDD架构中,能明显看出越外层的代码越稳定,越内层的代码演进越快,真正体现了领域“驱动”的核心思想。

总结

DDD不是一个什么特殊的架构,而是任何传统代码经过合理的重构之后最终一定会抵达的终点。DDD的架构能够有效的解决传统架构中的问题:

  • 高可维护性:当外部依赖变更时,内部代码只用变更跟外部对接的模块,其他业务逻辑不变。

  • 高可扩展性:做新功能时,绝大部分的代码都能复用,仅需要增加核心业务逻辑即可。

  • 高可测试性:每个拆分出来的模块都符合单一性原则,绝大部分不依赖框架,可以快速的单元测试,做到100%覆盖。

  • 代码结构清晰:通过POM module可以解决模块间的依赖关系, 所有外接模块都可以单独独立成Jar包被复用。当团队形成规范后,可以快速的定位到相关代码。

未完待续,尼恩说在最后

DDD 面试题,是非常常见的面试题。  DDD的学习材料, 汗牛塞屋,又缺乏经典。

《殷浩详解DDD:领域层设计规范》做到从0到1带大家精通DDD,非常难得。

这里,把尼恩修改过的 《殷浩详解DDD:领域层设计规范》,通过尼恩的公众号《技术自由圈》发布出来。

大家面试的时候, 可以参考以上的内容去组织答案,如果大家能做到对答如流,如数家珍,基本上 面试官会被你 震惊到、吸引到。

另外在面试之前,建议大家系统化的刷一波 5000页《尼恩Java面试宝典PDF》,并且在刷题过程中,如果有啥问题,大家可以来 找 40岁老架构师尼恩交流。

最终,让面试官爱到 “不能自已、口水直流”。offer, 也就来了。

部分历史案例