From 820286683ccc12de7c6de87565c43f74b0157d79 Mon Sep 17 00:00:00 2001 From: itwanger Date: Mon, 20 Jun 2022 08:19:55 +0800 Subject: [PATCH] DDD --- docs/nice-article/weixin/ganlygyddddywdnzw.md | 707 ++++++++++++++++++ .../nice-article/weixin-ganlygyddddywdnzw.jpg | Bin 0 -> 67575 bytes 2 files changed, 707 insertions(+) create mode 100644 docs/nice-article/weixin/ganlygyddddywdnzw.md create mode 100644 images/nice-article/weixin-ganlygyddddywdnzw.jpg diff --git a/docs/nice-article/weixin/ganlygyddddywdnzw.md b/docs/nice-article/weixin/ganlygyddddywdnzw.md new file mode 100644 index 000000000..74f3c624b --- /dev/null +++ b/docs/nice-article/weixin/ganlygyddddywdnzw.md @@ -0,0 +1,707 @@ +--- +title: 新来个技术总监，把DDD落地的那叫一个优雅，佩服！ +shortTitle: DDD（领域驱动设计） +description: 去年倒腾了一个半月，写过一篇 DDD 的文章，当时没有推广，完全自嗨，为了不让这篇好文被埋没，现重新整理，突出重点，可读性更强！ +author: 楼仔 +category: + - 微信公众号 +head: + - - meta + - name: description + content: 去年倒腾了一个半月，写过一篇 DDD 的文章，当时没有推广，完全自嗨，为了不让这篇好文被埋没，现重新整理，突出重点，可读性更强！ +--- + +> [二哥编程知识星球](https://mp.weixin.qq.com/s/vZwDdRc21ot7SSjDo4CXJQ) （戳链接加入）正式上线了，来和 **270 多名** 小伙伴一起打怪升级吧！这是一个 Java 学习指南 + 编程实战的私密圈子，你可以向二哥提问、帮你制定学习计划、跟着二哥一起做实战项目，冲冲冲。

+> Java 程序员进阶之路网址：[https://tobebetterjavaer.com](https://tobebetterjavaer.com) + +不 BB，直接上思维导图！ + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gQysHznWicFBVfUNmFXeJB8sjYBRVuNjsN4qnicNQH1u2jZXVOaV5JFmw/640?wx_fmt=png) + +## 1\. 走进 DDD + +### 1.1 为什么要用 DDD ？ + +- 面向对象设计，数据行为绑定，告别贫血模型； +- 降低复杂度，分而治之； +- 优先考虑领域模型，而不是切割数据和行为； +- 准确传达业务规则，业务优先； +- 代码即设计； +- 它通过边界划分将复杂业务领域简单化，帮我们设计出清晰的领域和应用边界，可以很容易地实现业务和技术统一的架构演进； +- 领域知识共享，提升协助效率； +- 增加可维护性和可读性，延长软件生命周期； +- 中台化的基石。 + +![](https://mmbiz.qpic.cn/mmbiz_jpg/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gcibPaJcRMCM40R7SLW2cCxVs09pFQShIv8QkRkUXx28OWYRN3pF1icjg/640?wx_fmt=jpeg) + +### 1.2 DDD 作用 + +说到 DDD，绕不开 MVC，在 MVC 三层架构中，我们进行功能开发的之前，拿到需求，解读需求。往往最先做的一步就是先设计表结构，在逐层设计上层 dao，service，controller。对于产品或者用户的需求都做了一层自我理解的转化。 + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gxfcvFgsx9IKicEGmiaaBic8OVWSdAemib1EhdqvyvqK63Z5QMmVKz6C0aw/640?wx_fmt=png) + +用户需求在被提出之后经过这么多层的转化后，特别是研发需求在数据库结构这一层转化后，将业务以主观臆断行为进行了转化。一旦业务边界划分模糊，考虑不全，大量的逻辑补充堆积到了代码层实现，变得越来越难维护。 + +假如我们现在要做一个电商订单下单的需求，涉及到用户选定商品，下订单、支付订单、对用户下单时的订单发货： + +- **MVC 架构**：我们常见的做法是在分析好业务需求之后，就开始设计表结构了，订单表，支付表，商品表等等。然后编写业务逻辑。这是第一个版本的需求，功能迭代饿了，订单支付后我可以取消，下单的商品我们退换货，是不是又需要进行加表，紧跟着对于的实现逻辑也进行修改。功能不断迭代，代码就不断的层层往上叠。 +- **DDD 架构**：我们先进行划分业务边界。这里面核心是订单。那么订单就是这个业务领域里面的聚合逻辑体现。支付，商品信息，地址等等都是围绕着订单实体。订单本身的属性决定之后，类似于地址只是一个属性的体现。当你将订单的领域模型构建好之后，后续的逻辑边界与仓储设计也就随之而来了。 + +**DDD 整体作用总结如下：** + +- 消除信息不对称； +- 常规 MVC 三层架构中自底向上的设计方式做一个反转，以业务为主导，自顶向下的进行业务领域划分； +- 将大的业务需求进行拆分，分而治之。 + +## 2\. DDD 架构 + +### 2.1 DDD 分层架构 + +> 严格分层架构：某层只能与直接位于的下层发生耦合。 +> +> 松散分层架构：允许上层与任意下层发生耦合。 + +在领域驱动设计（DDD）中采用的是松散分层架构，层间关系不那么严格。每层都可能使用它下面所有层的服务，而不仅仅是下一层的服务。每层都可能是半透明的，这意味着有些服务只对上一层可见，而有些服务对上面的所有层都可见。 + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gH4zTYicZIwYwpa46cW4g4apHxCD9IehxDhc6V37kDSnsia8SQHKIhZ4Q/640?wx_fmt=png) + +分层的作用，从上往下： + +- **用户交互层**：web 请求，rpc 请求，mq 消息等外部输入均被视为外部输入的请求，可能修改到内部的业务数据。 +- **业务应用层**：与 MVC 中的 service 不同的不是，service 中存储着大量业务逻辑。但在应用服务的实现中，它负责编排、转发、校验等。 +- **领域层**：或称为模型层，系统的核心，负责表达业务概念，业务状态信息以及业务规则。即包含了该领域所有复杂的业务知识抽象和规则定义。该层主要精力要放在领域对象分析上，可以从实体，值对象，聚合（聚合根），领域服务，领域事件，仓储，工厂等方面入手。 +- **基础设施层**：主要有 2 方面内容，一是为领域模型提供持久化机制，当软件需要持久化能力时候才需要进行规划；一是对其他层提供通用的技术支持能力，如消息通信，通用工具，配置等的实现。 + +在设计和开发时，不要将本该放在领域层的业务逻辑放到应用层中实现，因为庞大的应用层会使领域模型失焦，时间一长你的服务就会演化为传统的三层架构，业务逻辑会变得混乱。 + +### 2.2 各层数据转换 + +每一层都有自己特定的数据，可以做如下区分： + +- **VO（View Object）**：视图对象，主要对应界面显示的数据对象。对于一个 WEB 页面，或者 SWT、SWING 的一个界面，用一个 VO 对象对应整个界面的值。 +- **DTO（Data Transfer Object）**：数据传输对象，主要用于远程调用等需要大量传输对象的地方。比如我们一张表有 100 个字段，那么对应的 PO 就有 100 个属性。但是我们界面上只要显示 10 个字段，客户端用 WEB service 来获取数据，没有必要把整个 PO 对象传递到客户端，这时我们就可以用只有这 10 个属性的 DTO 来传递结果到客户端，这样也不会暴露服务端表结构。到达客户端以后，如果用这个对象来对应界面显示，那此时它的身份就转为 VO。在这里，我泛指用于展示层与服务层之间的数据传输对象。 +- **DO（Domain Object）**：领域对象，就是从现实世界中抽象出来的有形或无形的业务实体。 +- **PO（Persistent Object）**：持久化对象，它跟持久层（通常是关系型数据库）的数据结构形成一一对应的映射关系，如果持久层是关系型数据库，那么，数据表中的每个字段（或若干个）就对应 PO 的一个（或若干个）属性。最形象的理解就是一个 PO 就是数据库中的一条记录，好处是可以把一条记录作为一个对象处理，可以方便的转为其它对象。 + +## 3\. DDD 基础 + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4g1H77UIiaarqZyRCdtyibq12D99axNhibaGtMlibiaAQFpmxbaZmHkh3zP4A/640?wx_fmt=png) + +学习 DDD 前，有很多基础概念需要掌握，这幅图总结的很全，他把 DDD 划分不同的层级： + +- 最里层是值、属性、唯一标识等，这个是最基本的数据单位，但不能直接使用。 +- 然后是实体，这个把基础的数据进行封装，可以直接使用，在代码中就是封装好的一个个实体对象。 +- 之后就是领域层，它按照业务划分为不同的领域，比如订单领域、商品领域、支付领域等。 +- 最后是应用服务，它对业务逻辑进行编排，也可以理解为业务层。 + +### 3.1 领域和子域 + +在研究和解决业务问题时，DDD 会按照一定的规则将业务领域进行细分，当领域细分到一定的程度后，DDD 会将问题范围限定在特定的边界内，在这个边界内建立领域模型，进而用代码实现该领域模型，解决相应的业务问题。简言之，DDD 的领域就是这个边界内要解决的业务问题域。 + +领域可以进一步划分为子领域。我们把划分出来的多个子领域称为子域，每个子域对应一个更小的问题域或更小的业务范围。 + +领域的核心思想就是将问题域逐级细分，来降低业务理解和系统实现的复杂度。通过领域细分，逐步缩小服务需要解决的问题域，构建合适的领域模型。 + +**举个简单的例子**，对于保险领域，我们可以把保险细分为承保、收付、再保以及理赔等子域，而承保子域还可以继续细分为投保、保全（寿险）、批改（财险）等子子域。 + +### 3.2 核心域、通用域和支撑域 + +子域可以根据重要程度和功能属性划分为如下： + +- **核心域**：决定产品和公司核心竞争力的子域，它是业务成功的主要因素和公司的核心竞争力。 +- **通用域**：没有太多个性化的诉求，同时被多个子域使用的通用功能的子域。 +- **支撑域**：但既不包含决定产品和公司核心竞争力的功能，也不包含通用功能的子域。 + +**核心域、支撑域和通用域的主要目标**：通过领域划分，区分不同子域在公司内的不同功能属性和重要性，从而公司可对不同子域采取不同的资源投入和建设策略，其关注度也会不一样。 + +很多公司的业务，表面看上去相似，但商业模式和战略方向是存在很大差异的，因此公司的关注点会不一样，在划分核心域、通用域和支撑域时，其结果也会出现非常大的差异。 + +比如同样都是电商平台的淘宝、天猫、京东和苏宁易购，他们的商业模式是不同的。淘宝是 C2C 网站，个人卖家对个人买家，而天猫、京东和苏宁易购则是 B2C 网站，是公司卖家对个人买家。即便是苏宁易购与京东都是 B2C 的模式，苏宁易购是典型的传统线下卖场转型成为电商，京东则是直营加部分平台模式。 + +因此，在公司建立领域模型时，我们就要结合公司战略重点和商业模式，重点关注核心域。 + +### 3.3 通用语言和限界上下文 + +- **通用语言**：就是能够简单、清晰、准确描述业务涵义和规则的语言。 +- **限界上下文**：用来封装通用语言和领域对象，提供上下文环境，保证在领域之内的一些术语、业务相关对象等（通用语言）有一个确切的含义，没有二义性。 + +##### 3.3.1 通用语言 + +通用语言是团队统一的语言，不管你在团队中承担什么角色，在同一个领域的软件生命周期里都使用统一的语言进行交流。那么，通用语言的价值也就很明了，它可以解决交流障碍这个问题，使领域专家和开发人员能够协同合作，从而确保业务需求的正确表达。 + +这个通用语言到场景落地，大家可能还很模糊，其实就是把领域对象、属性、代码模型对象等，通过代码和文字建立映射关系，可以通过 Excel 记录这个关系，这样研发可以通过代码知道这个含义，产品或者业务方可以通过文字知道这个含义，沟通起来就不会有歧义，说的简单一点，其实就是统一产品和研发的话术。 + +直接看下面这幅图（来源于极客时间欧创新的 DDD 实战课）： + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gfKFMUOOUT7n1venjo2biaNaVNA2oicgEiaWfoecD35LKGqX692EzhO6LQ/640?wx_fmt=png) + +##### 3.3.2 限界上下文 + +通用语言也有它的上下文环境，为了避免同样的概念或语义在不同的上下文环境中产生歧义，DDD 在战略设计上提出了“限界上下文”这个概念，用来确定语义所在的领域边界。 + +限界上下文是一个显式的语义和语境上的边界，领域模型便存在于边界之内。边界内，通用语言中的所有术语和词组都有特定的含义。把限界上下文拆解开看，限界就是领域的边界，而上下文则是语义环境。 + +通过领域的限界上下文，我们就可以在统一的领域边界内用统一的语言进行交流。 + +### 3.4 实体和值对象 + +##### 3.4.1 实体 + +**实体 = 唯一身份标识 + 可变性【状态 + 行为】** + +DDD 中要求实体是唯一的且可持续变化的。意思是说在实体的生命周期内，无论其如何变化，其仍旧是同一个实体。唯一性由唯一的身份标识来决定的。可变性也正反映了实体本身的状态和行为。 + +**实体以 DO（领域对象）的形式存在**，每个实体对象都有唯一的 ID。我们可以对一个实体对象进行多次修改，修改后的数据和原来的数据可能会大不相同。 + +但是，由于它们拥有相同的 ID，它们依然是同一个实体。比如商品是商品上下文的一个实体，通过唯一的商品 ID 来标识，不管这个商品的数据如何变化，商品的 ID 一直保持不变，它始终是同一个商品。 + +##### 3.4.2 值对象 + +**值对象 = 将一个值用对象的方式进行表述，来表达一个具体的固定不变的概念。** + +当你只关心某个对象的属性时，该对象便可作为一个值对象。 我们需要将值对象看成不变对象，不要给它任何身份标识，还应该尽量避免像实体对象一样的复杂性。 + +还是举个订单的例子，订单是一个实体，里面包含地址，这个地址可以只通过属性嵌入的方式形成的订单实体对象，也可以将地址通过 json 序列化一个 string 类型的数据，存到 DB 的一个字段中，那么这个 Json 串就是一个值对象，是不是很好理解？ + +下面给个简单的图（同样是源于极客时间欧创新的 DDD 实战课）： + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4giabLQgdFH95qmHjMToKfelbQCicTicdOBHh5m2dh8thvw1e1Rm8x6SwUw/640?wx_fmt=png) + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gJbnlkngwfbp2D2OxicF9DI4zVFdzzr3YFvpJajPXA5urCibVqsjCJ0Xg/640?wx_fmt=png) + +### 3.5 聚合和聚合根 + +##### 3.5.1 聚合 + +**聚合**：我们把一些关联性极强、生命周期一致的实体、值对象放到一个聚合里。聚合是领域对象的显式分组，旨在支持领域模型的行为和不变性，同时充当一致性和事务性边界。 + +聚合有一个聚合根和上下文边界，这个边界根据业务单一职责和高内聚原则，定义了聚合内部应该包含哪些实体和值对象，而聚合之间的边界是松耦合的。按照这种方式设计出来的服务很自然就是“高内聚、低耦合”的。 + +聚合在 DDD 分层架构里属于领域层，领域层包含了多个聚合，共同实现核心业务逻辑。跨多个实体的业务逻辑通过领域服务来实现，跨多个聚合的业务逻辑通过应用服务来实现。 + +比如有的业务场景需要同一个聚合的 A 和 B 两个实体来共同完成，我们就可以将这段业务逻辑用领域服务来实现；而有的业务逻辑需要聚合 C 和聚合 D 中的两个服务共同完成，这时你就可以用应用服务来组合这两个服务。 + +##### 3.5.2 聚合根 + +如果把聚合比作组织，那聚合根就是这个组织的负责人。**聚合根也称为根实体，它不仅是实体，还是聚合的管理者。** + +- 首先它作为实体本身，拥有实体的属性和业务行为，实现自身的业务逻辑。 +- 其次它作为聚合的管理者，在聚合内部负责协调实体和值对象按照固定的业务规则协同完成共同的业务逻辑。 +- 最后在聚合之间，它还是聚合对外的接口人，以聚合根 ID 关联的方式接受外部任务和请求，在上下文内实现聚合之间的业务协同。也就是说，聚合之间通过聚合根 ID 关联引用，如果需要访问其它聚合的实体，就要先访问聚合根，再导航到聚合内部实体，外部对象不能直接访问聚合内实体。 + +上面讲的还是有些抽象，下面看一个图就能很好理解（同样是源于极客时间欧创新的 DDD 实战课）： + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gUNqMr7v4mS1Ikv4m3UcmNUJMUgPFrP37pbw4mcuicUYRSbbOdM8Xabg/640?wx_fmt=png) + +简单概括一下： + +- 通过事件风暴（我理解就是头脑风暴，不过我们一般都是先通过个人理解，然后再和相关核心同学进行沟通），得到实体和值对象； +- 将这些实体和值对象聚合为“投保聚合”和“客户聚合”，其中“投保单”和“客户”是两者的聚合根； +- 找出与聚合根“投保单”和“客户”关联的所有紧密依赖的实体和值对象； +- 在聚合内根据聚合根、实体和值对象的依赖关系，画出对象的引用和依赖模型。 + +### 3.6 领域服务和应用服务 + +##### 3.6.1 领域服务 + +当一些逻辑不属于某个实体时，可以把这些逻辑单独拿出来放到领域服务中，理想的情况是没有领域服务，如果领域服务使用不恰当，慢慢又演化回了以前逻辑都在 service 层的局面。 + +可以使用领域服务的情况： + +- 执行一个显著的业务操作 +- 对领域对象进行转换 +- 以多个领域对象作为输入参数进行计算，结果产生一个值对象 + +##### 3.6.2 应用服务 + +应用层作为展现层与领域层的桥梁，是用来表达用例和用户故事的主要手段。 + +应用层通过应用服务接口来暴露系统的全部功能。在应用服务的实现中，它负责编排和转发，它将要实现的功能委托给一个或多个领域对象来实现，它本身只负责处理业务用例的执行顺序以及结果的拼装。通过这样一种方式，它隐藏了领域层的复杂性及其内部实现机制。 + +应用层相对来说是较“薄”的一层，除了定义应用服务之外，在该层我们可以进行安全认证，权限校验，持久化事务控制，或者向其他系统发生基于事件的消息通知，另外还可以用于创建邮件以发送给客户等。 + +### 3.7 领域事件 + +**领域事件 = 事件发布 + 事件存储 + 事件分发 + 事件处理。** + +领域事件是一个领域模型中极其重要的部分，用来表示领域中发生的事件。忽略不相关的领域活动，同时明确领域专家要跟踪或希望被通知的事情，或与其他模型对象中的状态更改相关联。 + +下面简单说明领域事件： + +- **事件发布**：构建一个事件，需要唯一标识，然后发布； +- **事件存储**：发布事件前需要存储，因为接收后的事建也会存储，可用于重试或对账等； +- **事件分发**：服务内直接发布给订阅者，服务外需要借助消息中间件，比如 Kafka，RabbitMQ 等； +- **事件处理**：先将事件存储，然后再处理。 + +比如下订单后，给用户增长积分与赠送优惠券的需求。如果使用瀑布流的方式写代码。一个个逻辑调用，那么不同用户，赠送的东西不同，逻辑就会变得又臭又长。 + +这里的比较好的方式是，用户下订单成功后，发布领域事件，积分聚合与优惠券聚合监听订单发布的领域事件进行处理。 + +### 3.8 资源库【仓储】 + +仓储介于领域模型和数据模型之间，主要用于聚合的持久化和检索。它隔离了领域模型和数据模型，以便我们关注于领域模型而不需要考虑如何进行持久化。 + +我们将暂时不使用的领域对象从内存中持久化存储到磁盘中。当日后需要再次使用这个领域对象时，根据 key 值到数据库查找到这条记录，然后将其恢复成领域对象，应用程序就可以继续使用它了，这就是领域对象持久化存储的设计思想。 + +是不是感觉这块内容比较抽象？直接对着 Demo 学习吧，很多东西你就会豁然开朗。 + +## 4\. DDD 实战 + +### 4.1 项目介绍 + +- 主要是围绕用户、角色和两者的关系，构建权限分配领域模型。 +- 采用 DDD 4 层架构，包括用户接口层、应用层、领域层和基础服务层。 +- 数据通过 VO、DTO、DO、PO 转换，进行分层隔离。 +- 采用 SpringBoot + MyBatis Plus 框架，存储用 MySQL。 + +### 4.2 工程目录 + +项目划分为用户接口层、应用层、领域层和基础服务层，每一层的代码结构都非常清晰，包括每一层 VO、DTO、DO、PO 的数据定义，对于每一层的公共代码，比如常量、接口等，都抽离到 ddd-common 中。 + +``` +./ddd-application  // 应用层 +├── pom.xml +└── src +    └── main +        └── java +            └── com +                └── ddd +                    └── applicaiton +                        ├── converter +                        │   └── UserApplicationConverter.java // 类型转换器 +                        └── impl +                            └── AuthrizeApplicationServiceImpl.java // 业务逻辑 +./ddd-common +├── ddd-common // 通用类库 +│   ├── pom.xml +│   └── src +│       └── main +│           └── java +│               └── com +│                   └── ddd +│                       └── common +│                           ├── exception // 异常 +│                           │   ├── ServiceException.java +│                           │   └── ValidationException.java +│                           ├── result // 返回结果集 +│                           │   ├── BaseResult.javar +│                           │   ├── Page.java +│                           │   ├── PageResult.java +│                           │   └── Result.java +│                           └── util // 通用工具 +│                               ├── GsonUtil.java +│                               └── ValidationUtil.java +├── ddd-common-application // 业务层通用模块 +│   ├── pom.xml +│   └── src +│       └── main +│           └── java +│               └── com +│                   └── ddd +│                       └── applicaiton +│                           ├── dto // DTO +│                           │   ├── RoleInfoDTO.java +│                           │   └── UserRoleDTO.java +│                           └── servic // 业务接口 +│                               └── AuthrizeApplicationService.java +├── ddd-common-domain +│   ├── pom.xml +│   └── src +│       └── main +│           └── java +│               └── com +│                   └── ddd +│                       └── domain +│                           ├── event // 领域事件 +│                           │   ├── BaseDomainEvent.java +│                           │   └── DomainEventPublisher.java +│                           └── service // 领域接口 +│                               └── AuthorizeDomainService.java +└── ddd-common-infra +    ├── pom.xml +    └── src +        └── main +            └── java +                └── com +                    └── ddd +                        └── infra +                            ├── domain // DO +                            │   └── AuthorizeDO.java +                            ├── dto  +                            │   ├── AddressDTO.java +                            │   ├── RoleDTO.java +                            │   ├── UnitDTO.java +                            │   └── UserRoleDTO.java +                            └── repository +                                ├── UserRepository.java // 领域仓库 +                                └── mybatis +                                    └── entity // PO +                                        ├── BaseUuidEntity.java +                                        ├── RolePO.java +                                        ├── UserPO.java +                                        └── UserRolePO.java +./ddd-domian  // 领域层 +├── pom.xml +└── src +    └── main +        └── java +            └── com +                └── ddd +                    └── domain +                        ├── event // 领域事件 +                        │   ├── DomainEventPublisherImpl.java +                        │   ├── UserCreateEvent.java +                        │   ├── UserDeleteEvent.java +                        │   └── UserUpdateEvent.java +                        └── impl // 领域逻辑 +                            └── AuthorizeDomainServiceImpl.java +./ddd-infra  // 基础服务层 +├── pom.xml +└── src +    └── main +        └── java +            └── com +                └── ddd +                    └── infra +                        ├── config +                        │   └── InfraCoreConfig.java  // 扫描Mapper文件 +                        └── repository +                            ├── converter +                            │   └── UserConverter.java // 类型转换器 +                            ├── impl +                            │   └── UserRepositoryImpl.java +                            └── mapper +                                ├── RoleMapper.java +                                ├── UserMapper.java +                                └── UserRoleMapper.java +./ddd-interface +├── ddd-api  // 用户接口层 +│   ├── pom.xml +│   └── src +│       └── main +│           ├── java +│           │   └── com +│           │       └── ddd +│           │           └── api +│           │               ├── DDDFrameworkApiApplication.java // 启动入口 +│           │               ├── converter +│           │               │   └── AuthorizeConverter.java // 类型转换器 +│           │               ├── model +│           │               │   ├── req // 入参 req +│           │               │   │   ├── AuthorizeCreateReq.java +│           │               │   │   └── AuthorizeUpdateReq.java +│           │               │   └── vo  // 输出 VO +│           │               │       └── UserAuthorizeVO.java +│           │               └── web     // API +│           │                   └── AuthorizeController.java +│           └── resources // 系统配置 +│               ├── application.yml +│           └── resources // Sql文件 +│               └── init.sql +└── ddd-task +    └── pom.xml +./pom.xml +``` + +### 4.3 数据库 + +包括 3 张表，分别为用户、角色和用户角色表，一个用户可以拥有多个角色，一个角色可以分配给多个用户。 + +``` +create table t_user +( +    id           bigint auto_increment comment '主键' primary key, +    user_name    varchar(64)                        null comment '用户名', +    password     varchar(255)                       null comment '密码', +    real_name    varchar(64)                        null comment '真实姓名', +    phone        bigint                             null comment '手机号', +    province     varchar(64)                        null comment '用户名', +    city         varchar(64)                        null comment '用户名', +    county       varchar(64)                        null comment '用户名', +    unit_id      bigint                             null comment '单位id', +    unit_name    varchar(64)                        null comment '单位名称', +    gmt_create   datetime default CURRENT_TIMESTAMP not null comment '创建时间', +    gmt_modified datetime default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '修改时间', +    deleted      bigint   default 0                 not null comment '是否删除，非0为已删除' +)comment '用户表' collate = utf8_bin; +create table t_role +( +    id           bigint auto_increment comment '主键' primary key, +    name         varchar(256)                       not null comment '名称', +    code         varchar(64)                        null comment '角色code', +    gmt_create   datetime default CURRENT_TIMESTAMP not null comment '创建时间', +    gmt_modified datetime default CURRENT_TIMESTAMP not null on update CURRENT_TIMESTAMP comment '修改时间', +    deleted      bigint   default 0                 not null comment '是否已删除' +)comment '角色表' charset = utf8; +create table t_user_role ( +    id           bigint auto_increment comment '主键id' primary key, +    user_id      bigint                             not null comment '用户id', +    role_id      bigint                             not null comment '角色id', +    gmt_create   datetime default CURRENT_TIMESTAMP not null comment '创建时间', +    gmt_modified datetime default CURRENT_TIMESTAMP not null comment '修改时间', +    deleted      bigint   default 0                 not null comment '是否已删除' +)comment '用户角色关联表' charset = utf8; +``` + +### 4.4 基础服务层 + +仓储（资源库）介于领域模型和数据模型之间，主要用于聚合的持久化和检索。它隔离了领域模型和数据模型，以便我们关注于领域模型而不需要考虑如何进行持久化。 + +比如保存用户，需要将用户和角色一起保存，也就是创建用户的同时，需要新建用户的角色权限，这个可以直接全部放到仓储中： + +``` +public AuthorizeDO save(AuthorizeDO user) { +    UserPO userPo = userConverter.toUserPo(user); +    if(Objects.isNull(user.getUserId())){ +        userMapper.insert(userPo); +        user.setUserId(userPo.getId()); +    } else { +        userMapper.updateById(userPo); +        userRoleMapper.delete(Wrappers.lambdaQuery() +                .eq(UserRolePO::getUserId, user.getUserId())); +    } +    List userRolePos = userConverter.toUserRolePo(user); +    userRolePos.forEach(userRoleMapper::insert); +    return this.query(user.getUserId()); +} +``` + +仓储对外暴露的接口如下： + +``` +// 用户领域仓储 +public interface UserRepository { +    // 删除 +    void delete(Long userId); +    // 查询 +    AuthorizeDO query(Long userId); +    // 保存 +    AuthorizeDO save(AuthorizeDO user); +} +``` + +基础服务层不仅仅包括资源库，与第三方的调用，都需要放到该层，Demo 中没有该示例，我们可以看一个小米内部具体的实际项目，他把第三方的调用放到了 remote 目录中： + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gPYETyldgWBibEwayiaHvUpqlrlrMYEx1AKp66NKGAwrA6PWKib1LgCic2w/640?wx_fmt=png) + +### 4.5 领域层 + +##### 4.5.1 聚合&聚合根 + +我们有用户和角色两个实体，可以将用户、角色和两者关系进行聚合，然后用户就是聚合根，聚合之后的属性，我们称之为“权限”。 + +对于地址 Address，目前是作为字段属性存储到 DB 中，如果对地址无需进行检索，可以把地址作为“值对象”进行存储，即把地址序列化为 Json 存，存储到 DB 的一个字段中。 + +``` +public class AuthorizeDO { +    // 用户ID +    private Long userId; +    // 用户名 +    private String userName; +    // 真实姓名 +    private String realName; +    // 手机号 +    private String phone; +    // 密码 +    private String password; +    // 用户单位 +    private UnitDTO unit; +    // 用户地址 +    private AddressDTO address; +    // 用户角色 +    private List roles; +} +``` + +##### 4.5.2 领域服务 + +Demo 中的领域服务比较薄，通过单位 ID 后去获取单位名称，构建单位信息： + +``` +@Service +public class AuthorizeDomainServiceImpl implements AuthorizeDomainService { +    @Override +    // 设置单位信息 +    public void associatedUnit(AuthorizeDO authorizeDO) { +        String unitName = "武汉小米";// TODO: 通过第三方获取 +        authorizeDO.getUnit().setUnitName(unitName); +    } +} +``` + +我们其实可以把领域服务再进一步抽象，可以抽象出领域能力，通过这些领域能力去构建应用层逻辑，比如账号相关的领域能力可以包括授权领域能力、身份认证领域能力等，这样每个领域能力相对独立，就不会全部揉到一个文件中，下面是实际项目的领域层截图： + +![](https://mmbiz.qpic.cn/mmbiz_png/sXFqMxQoVLESpJibWtYnlHsuuI2wOYE4gmkUttpBicdc9jg9iaKqYWqL1VQG4mJ8BFEgxZXpqCOaHyofUwqOpENibg/640?wx_fmt=png) + +##### 4.5.3 领域事件 + +领域事件 = 事件发布 + 事件存储 + 事件分发 + 事件处理。 + +这个 Demo 中，对领域事件的处理非常简单，还是一个应用内部的领域事件，就是每次执行一次具体的操作时，把行为记录下来。Demo 中没有记录事件的库表，事件的分发还是同步的方式，所以 Demo 中的领域事件还不完善，后面我会再继续完善 Demo 中的领域事件，通过 Java 消息机制实现解耦，甚至可以借助消息队列，实现异步。 + +``` +/** + * 领域事件基类 + * + * @author louzai + * @since 2021/11/22 + */ +@Getter +@Setter +@NoArgsConstructor +public abstract class BaseDomainEvent implements Serializable { +    private static final long serialVersionUID = 1465328245048581896L; +    /** +     * 发生时间 +     */ +    private LocalDateTime occurredOn; +    /** +     * 领域事件数据 +     */ +    private T data; +    public BaseDomainEvent(T data) { +        this.data = data; +        this.occurredOn = LocalDateTime.now(); +    } +} +/** + * 用户新增领域事件 + * + * @author louzai + * @since 2021/11/20 + */ +public class UserCreateEvent extends BaseDomainEvent { +    public UserCreateEvent(AuthorizeDO user) { +        super(user); +    } +} +``` + +``` +/** + * 领域事件发布实现类 + * + * @author louzai + * @since 2021/11/20 + */ +@Component +@Slf4j +public class DomainEventPublisherImpl implements DomainEventPublisher { +    @Autowired +    private ApplicationEventPublisher applicationEventPublisher; +    @Override +    public void publishEvent(BaseDomainEvent event) { +        log.debug("发布事件,event:{}", GsonUtil.gsonToString(event)); +        applicationEventPublisher.publishEvent(event); +    } +} +``` + +### 4.4 应用层 + +应用层就非常好理解了，只负责简单的逻辑编排，比如创建用户授权： + +``` +@Transactional(rollbackFor = Exception.class) +public void createUserAuthorize(UserRoleDTO userRoleDTO){ +    // DTO转为DO +    AuthorizeDO authorizeDO = userApplicationConverter.toAuthorizeDo(userRoleDTO); +    // 关联单位单位信息 +    authorizeDomainService.associatedUnit(authorizeDO); +    // 存储用户 +    AuthorizeDO saveAuthorizeDO = userRepository.save(authorizeDO); +    // 发布用户新建的领域事件 +    domainEventPublisher.publishEvent(new UserCreateEvent(saveAuthorizeDO)); +} +``` + +查询用户授权信息： + +``` +@Override +  public UserRoleDTO queryUserAuthorize(Long userId) { +      // 查询用户授权领域数据 +      AuthorizeDO authorizeDO = userRepository.query(userId); +      if (Objects.isNull(authorizeDO)) { +          throw ValidationException.of("UserId is not exist.", null); +      } +      // DO转DTO +      return userApplicationConverter.toAuthorizeDTO(authorizeDO); +  } +``` + +细心的同学可以发现，我们应用层和领域层，通过 DTO 和 DO 进行数据转换。 + +### 4.5 用户接口层 + +最后就是提供 API 接口： + +``` +@GetMapping("/query") +public Result query(@RequestParam("userId") Long userId){ +    UserRoleDTO userRoleDTO = authrizeApplicationService.queryUserAuthorize(userId); +    Result result = new Result<>(); +    result.setData(authorizeConverter.toVO(userRoleDTO)); +    result.setCode(BaseResult.CODE_SUCCESS); +    return result; +} +@PostMapping("/save") +public Result create(@RequestBody AuthorizeCreateReq authorizeCreateReq){ +    authrizeApplicationService.createUserAuthorize(authorizeConverter.toDTO(authorizeCreateReq)); +    return Result.ok(BaseResult.INSERT_SUCCESS); +} +``` + +数据的交互，包括入参、DTO 和 VO，都需要对数据进行转换。 + +### 4.6 项目运行 + +- 新建库表：通过文件 "ddd-interface/ddd-api/src/main/resources/init.sql" 新建库表。 +- 修改 SQL 配置：修改 "ddd-interface/ddd-api/src/main/resources/application.yml" 的数据库配置。 +- 启动服务：直接启动服务即可。 +- 测试用例： + +- 请求 URL：http://127.0.0.1:8087/api/user/save +- Post body：{"userName":"louzai","realName":"楼","phone":13123676844,"password":"\*\*\*","unitId":2,"province":"湖北省","city":"鄂州市","county":"葛店开发区","roles":\[{"roleId":2}\]} + +### 4.7 项目地址 + +DDD Demo 代码已经上传到 GitHub 中： + +``` +https://github.com/lml200701158/ddd-framework +``` + +或者通过下面命令直接获取： + +``` +git clone git@github.com:lml200701158/ddd-framework.git +``` + +## 5\. 结语 + +最后，谈谈二哥对 DDD 的理解，我觉得 DDD 不像一门技术，我理解的技术比如高并发、缓存、消息队列等，**DDD 更像是一项软技能，一种方法论，包含了很多设计理念。** + +大家不要认为，掌握了一些概念，以及 DDD 的基本思想，就掌握了 DDD，然后做项目时，照葫芦画瓢，这样你会死的很惨！ + +只掌握 DDD 表面的东西，其实是不够的，**我觉得 DDD 最复杂的地方，其实是在它的领域设计部分**，项目启动前，你一定要设计各个领域对象，以及它们直接的交互关系。 + +比如我们之前做过一个项目，因为这块没有做好，大家一边写代码，一边还在思考，这个领域对象该如何构造，严重影响开发效率，**最后又不得不回退到 MVC 的模式。** + +不要为了炫技，啥都要搞个 DDD，两者如何选择： + +- **MVC**：上来就可以开干，短平快，**前期用起来很香，整体开发效率也更高**，所以对于紧急，或者不那么重要的项目，我会直接用 MVC 怼，不好的地方就是，后面会越来越复杂，可能最后就是一坨屎山，**但是很多时候，比如老板进度催的紧，我哪想到那么多以后呢？** +- **DDD**：前期需要花大量时间设计好领域模型，**对于一些基础组件，或者一些核心服务，如果对象模型非常复杂，建议采用 DDD**，前期可能会稍微痛苦一些，但是后期维护起来会非常方便。 + +--- + +_没有什么使我停留——除了目的，纵然岸旁有玫瑰、有绿荫、有宁静的港湾，我是不系之舟_。 + +**推荐阅读**： + +- [我扔进垃圾桶的第一本 Java 书...](https://mp.weixin.qq.com/s/XWwqzrHAJ0vtY3lNilqVkg) +- [一键部署 Spring Boot 项目](https://mp.weixin.qq.com/s/gb48ZAqDCwXInUWM7q0EaQ) +- [离开北京？](https://mp.weixin.qq.com/s/-LNhq_OBHDBZzAEMurqBJw) +- [编程喵实战项目可以在本地跑起来辣！](https://mp.weixin.qq.com/s/PZcWj0NbWRGdS0I9ACMqbg) + +![](https://img-blog.csdnimg.cn/img_convert/29e81f023caee3bdfdb6698a3ad2178f.png) diff --git a/images/nice-article/weixin-ganlygyddddywdnzw.jpg b/images/nice-article/weixin-ganlygyddddywdnzw.jpg new file mode 100644 index 0000000000000000000000000000000000000000..e00661466b3518beec3e1189fbfebd59cf0d7f2a GIT binary patch literal 67575 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 literal 0 HcmV?d00001 -- GitLab