领域驱动设计.NET实践

第1部分 创建领域模型 第1章 领域驱动设计的概念 2 1.1 软件的复杂性 2 1.2 领域驱动设计简介 3 1.2.1 限界上下文 3 1.2.2 战略设计 4 1.2.3 领域模型 5 1.2.4 通用语言 5 1.3 领域驱动设计使用中的难点 5 1.3.1 对软件复杂性理解的偏差 6 1.3.2 术语的理解 6 1.3.3 技术框架问题 7 1.3.4 英语障碍 8 1.4 学习和使用领域驱动设计的一些体会 9 1.4.1 理解领域驱动设计的精髓 9 1.4.2 使用“战略设计”规划项目 9 1.4.3 在开发过程中使用“战术设计” 10 1.4.4 在学习中尽量尝试各种技术，在实践中保持简洁 11 1.4.5 实事求是，避免将理论当作教条 11 1.5 本书概况 11 1.5.1 本书的目标和结构 11 1.5.2 为什么选择.Net 12 1.5.3 本书选择的示例 12 1.5.4 本书使用的开发环境 12 1.5.5 本书中的数据和代码 13 1.6 本章小结 13 第2章 从零开始构建诗词游戏 14 2.1 需求概述 14 2.2 领域、子域与限界上下文 15 2.3 限界上下文的初步确定 16 2.3.1 用户认证上下文 18 2.3.2 诗词游戏上下文 19 2.3.3 诗词服务上下文 19 2.3.4 游戏管理上下文 19 2.4 限界上下文映射 19 2.4.1 各行其道 20 2.4.2 已发布语言 20 2.4.3 开放主机服务 20 2.4.4 客户-供应商 21 2.4.5 跟随者 21 2.4.6 防腐层 21 2.4.7 合作方式 21 2.4.8 共享内核 22 2.5 诗词游戏上下文的通用语言 22 2.6 创建**个版本 23 2.7 本章小结 27 第3章 理解领域模型 28 3.1 领域模型概述 28 3.2 实体 28 3.2.1 实体的基本概念 29 3.2.2 从业务概念中发现实体 31 3.2.3 实体中数据的封装 33 3.2.4 实体中的方法 35 3.2.5 为什么要避免“贫血”模型 37 3.3 值对象 38 3.3.1 值对象的概念 38 3.3.2 值对象的实现 39 3.3.3 在模型中使用值对象的好处 41 3.4 聚合和聚合根 42 3.5 存储库 43 3.5.1 存储库的概念 43 3.5.2 存储库接口示例 44 3.5.3 是否可以使用EF Core等技术代替存储库 46 3.5.4 构建测试用的存储库实现 46 3.6 领域事件 48 3.6.1 为什么需要领域事件 48 3.6.2 领域事件的概念 49 3.6.3 在项目中增加领域事件 49 3.7 重构项目框架 57 3.8 完善诗词服务 58 3.9 本章小结 62 第4章 领域服务与应用服务 63 4.1 **个领域服务 63 4.2 对游戏进行优化 65 4.2.1 问题分析 65 4.2.2 设计模式的使用 66 4.2.3 解决方案 67 4.3 领域服务的引入 69 4.4 应用服务 72 4.4.1 创建游戏 73 4.4.2 游戏过程 77 4.5 领域服务与应用服务的区别 83 4.6 避免滥用领域服务 84 4.7 本章小结 84 第5章 领域模型的验证与演化 85 5.1 领域模型构建过程回顾 85 5.2 领域模型设计需要注意的几个问题 86 5.2.1 学习领域知识，充分沟通 86 5.2.2 分析模式与设计模式的使用 86 5.2.3 遵守软件设计的一般规律 86 5.2.4 避免过度抽象 87 5.3 使用测试框架创建验证领域模型的测试用例 87 5.3.1 创建测试项目 87 5.3.2 模拟对象的使用 91 5.3.3 对异常的测试 92 5.4 使用行为驱动设计工具SpecFlow验证领域模型 93 5.4.1 行为驱动设计与领域驱动设计 94 5.4.2 使用SpecFlow验证领域模型 94 5.5 创建控制台应用验证领域模型 98 5.6 领域模型发布 98 5.7 领域模型的演化与持续集成 102 5.8 本章小结 103 第6章 创建基于控制台的人机游戏 104 6.1 已完成工作回顾 104 6.2 人机游戏说明 105 6.3 系统结构 105 6.4 创建应用层 106 6.5 模拟机器人作答 110 6.6 编写客户端 114 6.7 需要解决的问题 118 6.7.1 对象创建方式过于复杂 118 6.7.2 简单工厂不能满足扩展需求 119 6.7.3 应用层没有隔离领域层 119 6.7.4 其他需要解决的问题 120 6.8 本章小结 121 第2部分 DDD .Net工具箱 第7章 DDD .Net相关技术概述 124 7.1 .Net简介 124 7.1.1 .Net的发展简史 124 7.1.2 .Net的版本 125 7.1.3 .Net的跨平台支持 125 7.2 .Net功能 125 7.2.1 异步编程模式 125 7.2.2 特性 126 7.2.3 反射 128 7.2.4 委托 129 7.2.5 事件 131 7.2.6 泛型 132 7.2.7 LINQ 133 7.3 与领域驱动设计实现相关的技术框架 134 7.3.1 依赖注入框架 134 7.3.2 ORM框架 134 7.3.3 对象映射框架 135 7.3.4 实时通信框架 135 7.3.5 进程内消息框架 135 7.4 本章小结 136 第8章 依赖倒置原则、控制反转与DDD架构 137 8.1 依赖倒置原则 137 8.1.1 概述 137 8.1.2 在设计中引入依赖倒置原则 138 8.1.3 设计期依赖与运行期依赖 140 8.1.4 依赖倒置实例 143 8.2 控制反转 144 8.2.1 问题的提出 144 8.2.2 理解控制反转 146 8.2.3 IoC容器 146 8.3 架构结构的转变 146 8.4 本章小结 148 第9章 工厂与依赖注入容器 149 9.1 工厂 149 9.1.1 工厂的概念 149 9.1.2 工厂设计模式 150 9.2 依赖注入容器 151 9.2.1 问题的提出 152 9.2.2 理解依赖注入 152 9.3 .Net内置的依赖注入容器 153 9.3.1 基本使用方法 153 9.3.2 服务对象的生命周期 153 9.3.3 服务的注册方法 154 9.3.4 多个构造函数的情况 156 9.4 依赖注入容器的使用 156 9.4.1 在控制台应用中使用依赖注入 156 9.4.2 改造简单工厂 157 9.4.3 可插拔组件架构实现 159 9.5 使用第三方DI容器满足高级需求 159 9.5.1 基本使用方法 160 9.5.2 属性注入 161 9.5.3 使用基于名称的注入改造工厂 161 9.5.4 程序集注册 163 9.6 本章小结 163 第10章 基于关系数据库的存储库实现 164 10.1 EF Core的基本功能 164 10.2 使用EF Core实现存储库 167 10.2.1 创建PlayerRepository 167 10.2.2 创建GameRepository 170 10.3 EF Core的深入应用 173 10.3.1 多数据库类型支持 173 10.3.2 生产环境的数据库部署 178 10.3.3 数据库生成标识 182 10.3.4 Data Annotations vs Flunt API 183 10.4 在控制台应用中使用新的存储库 184 10.5 使用其他数据库访问框架实现存储库 185 10.5.1 存储库的持久层框架需要满足的条件 185 10.5.2 Dapper 186 10.5.3 FreeSql 187 10.6 本章小结 187 第11章 存储库与NoSQL数据库 188 11.1 NoSQL数据库概述 188 11.1.1 键值对存储数据库 188 11.1.2 列存储数据库 188 11.1.3 文档型数据库 189 11.1.4 Graph数据库 189 11.1.5 实时数据库 189 11.2 文档数据库MongoDB概述 189 11.2.1 MongoDB介绍 189 11.2.2 MongoDB的安装 190 11.2.3 MongoDB的管理 190 11.2.4 MongoDB的基本概念 191 11.2.5 MongoDB的基本数据类型 191 11.3 创建面向MongoDB的存储库 192 11.3.1 使用MongoDB.Driver操作MongoDB 192 11.3.2 创建存储库 194 11.3.3 使用依赖注入传入MongoDB数据库访问对象 200 11.3.4 注意事项 201 11.4 聚合根在MongoDB中存储与在关系数据库中存储的比较 202 11.5 本章小结 202 第12章 认证 203 12.1 基本概念 203 12.2 Asp.Net Core Identity 204 12.2.1 简介 205 12.2.2 创建使用Identity的Web应用 205 12.2.3 集成Identity与诗词游戏 207 12.2.4 Identity的配置 210 12.2.5 个性化Identity页面 212 12.2.6 Identity的使用场景 214 12.3 基于OpenId Connect的认证服务 214 12.3.1 OAuth 2.0、OpenId和OpenId Connect介绍 214 12.3.2 使用Identity Server 4创建用户管理和认证功能 215 12.3.3 使用Identity Server 4保护Web 应用 217 12.3.4 集成Identity Server 4与诗词游戏 222 12.4 在实际项目中使用认证服务 222 12.4.1 单点登录 222 12.4.2 前后端分离的应用 223 12.4.3 分布式应用 224 12.5 本章小结 225 第13章 领域事件实现 226 13.1 领域事件的工作过程 226 13.2 观察者模式、中介者模式与订阅/发布模式 229 13.2.1 观察者模式 230 13.2.2 中介者模式 231 13.2.3 订阅/发布模式 232 13.3 使用MediatR实现领域事件发布 233 13.3.1 引入MediatR 233 13.3.2 将领域事件封装为MediatR消息 233 13.3.3 事件总线实现 234 13.3.4 事件的接收和处理实现 237 13.3.5 事件发布 239 13.4 外部事件发布与消息中间件 240 13.5 本章小结 246 第14章 应用层开发 247 14.1 应用层概述 247 14.1.1 应用服务 247 14.1.2 数据传输对象 247 14.1.3 工作单元 248 14.2 应用层创建示例 249 14.2.1 控制台应用与Web应用的不同 249 14.2.2 创建新的应用层接口 252 14.2.3 应用层实现 255 14.3 创建应用层的Web API 257 14.4 引入工作单元 263 14.4.1 工作单元的定义 263 14.4.2 工作单元的实现 263 14.4.3 工作单元的使用 272 14.5 本章小结 272 第15章 使用Web API和gRPC实现限界上下文集成 273 15.1 直接访问诗词服务数据库 273 15.2 使用Web API实现上下文集成 277 15.2.1 编写诗词服务的Web API 277 15.2.2 编写访问Web API的PoemService接口 280 15.2.3 测试Web API和客户端 281 15.2.4 是否使用RESTful形式的Web API 283 15.3 使用gRPC实现限界上下文集成 284 15.3.1 RPC与gRPC 284 15.3.2 gRPC对.Net的支持 284 15.3.3 编写gRPC PoemService服务 287 15.3.4 编写gRPC PoemService客户端 292 15.3.5 编写验证控制台程序 294 15.3.6 编写gRPC应用的其他注意事项 296 15.3.7 gRPC重试策略的配置 297 15.4 本章小结 298 第16章 使用消息实现限界上下文集成 299 16.1 限界上下文集成方案 299 16.1.1 消息中间件的使用 299 16.1.2 创建对外发布消息的接口 300 16.1.3 创建消息接收接口 302 16.1.4 消息接收程序 302 16.2 使用RabbitMQ实现限界上下文集成 304 16.2.1 编写消息接收端 304 16.2.2 消息发布 307 16.2.3 在控制台项目中使用配置文件 309 16.2.4 编写接收端插件 310 16.2.5 RabbitMQ消息类型简介 312 16.3 使用Kafka实现限界上下文集成 314 16.3.1 Kafka消息发送端的编写 314 16.3.2 Kafka消息接收端的编写 315 16.4 本章小结 318 第3部分 构建以领域模型为核心的应用 第17章 “战略设计”与架构选择 320 17.1 从业务出发规划项目架构 320 17.1.1 问题的提出 320 17.1.2 战略设计的作用 321 17.1.3 限界上下文之间的架构 322 17.2 示例项目的“战略设计” 323 17.2.1 限界上下文的划分 323 17.2.2 诗词游戏上下文 323 17.2.3 用户认证上下文 324 17.2.4 诗词服务上下文 324 17.2.5 游戏管理上下文 324 17.3 与DDD相关的架构类型 324 17.3.1 分层架构 324 17.3.2 六边形架构 324 17.3.3 洋葱圈架构 325 17.3.4 整洁架构 326 17.4 使用架构描述、设计应用系统 327 17.4.1 总体架构 327 17.4.2 存储库 330 17.4.3 领域服务的扩展 331 17.4.4 领域事件发布 332 17.4.5 与其他限界上下文的集成 333 17.4.6 使用消息实现与其他限界上下文的集成 335 17.5 架构模型的总结 336 17.6 本章小结 337 第18章 构建Web单体应用 338 18.1 单体应用概述 338 18.2 需求细化 338 18.3 系统架构 340 18.4 应用层 341 18.5 使用SignalR创建实时服务 344 18.5.1 SignalR介绍 344 18.5.2 创建SignalR服务端 345 18.5.3 创建SignalR的JavaScript客户端 347 18.5.4 创建Razor页面 350 18.6 装配依赖注入服务 353 18.7 运行效果和待解决的问题 354 18.8 本章小结 357 第19章 构建游戏服务 358 19.1 需求分析 358 19.2 项目搭建 360 19.3 编写服务层 360 19.4 SignalR Hub的实现 365 19.5 定时器的引入 371 19.6 安全认证 374 19.7 使用依赖注入服务进行装配 377 19.8 本章小结 378 第20章 单页面客户端 379 20.1 需求概述 379 20.2 技术方案 380 20.2.1 单页面客户端在架构中的位置 380 20.2.2 关键技术 381 20.3 前端项目构建 383 20.3.1 创建项目 383 20.3.2 使用oidc-client进行认证 386 20.3.3 访问游戏服务的SignalR Hub 388 20.3.4 编写客户端逻辑 392 20.4 交互设计 393 20.4.1 交互设计原则 393 20.4.2 诗词游戏的交互设计 394 20.4.3 运行效果 395 20.5 本章小结 398 第21章 使用.Net构建多种类型客户端 399 21.1 概述 399 21.2 认证 400 21.2.1 IdentityModel.OidcClient介绍 400 21.2.2 控制台应用的认证功能实现 401 21.2.3 WinForm应用认证功能实现 403 21.2.4 Android移动应用的认证功能实现 408 21.3 Web API的访问 412 21.3.1 使用HttpClient访问Web API 412 21.3.2 控制台应用的Web API访问 412 21.3.3 WinForm的Web API访问 413 21.3.4 Android应用的Web API访问 414 21.4 SignalR的访问 415 21.4.1 SignalR的C#客户端 415 21.4.2 控制台应用访问SignalR Hub 416 21.4.3 WinForm访问SignalR Hub 417 21.4.4 Android App访问SignalR 418 21.5 客户端交互模式与应用服务 420 21.6 本章小结 420 第22章 微服务 421 22.1 微服务简介 421 22.1.1 基本概念 421 22.1.2 微服务的优点 422 22.1.3 使用微服务的代价 422 22.1.4 一个没有很好设计的微服务示例 423 22.2 微服务相关的技术 423 22.2.1 容器 424 22.2.2 微服务编排 424 22.2.3 微服务相关的其他技术 424 22.3 使用微服务架构的诗词游戏 426 22.3.1 需求分析 426 22.3.2 后端实现 427 22.3.3 前端实现 431 22.3.4 使用Docker Compose创建容器 433 22.4 容器化部署 437 22.4.1 单页面前端的容器化部署 437 22.4.2 Asp.Net Core项目的容器化部署 437 22.4.3 基础设施的容器化部署 439 22.4.4 诗词游戏的容器化部署 440 22.4.5 使用反向代理服务器整合应用的各个部分 441 22.5 持续集成 443 22.5.1 持续集成简介 443 22.5.2 手工集成过程 443 22.5.3 使用Jenkins完成自动集成 445 22.6 本章小结 447 第23章 诗词服务数据维护——非DDD技术的限界上下文 448 23.1 数据驱动开发简介 448 23.2 诗词服务数据维护的开发 449 23.3 数据驱动开发与DDD的比较 453 23.4 本章小结 455 第24章 游戏管理上下文的实现与CQS模式 456 24.1 游戏管理部分的设计 456 24.2 游戏管理部分的领域模型 457 24.2.1 领域模型定义 457 24.2.2 存储库的实现 459 24.3 查询部分设计 462 24.3.1 查询接口 462 24.3.2 查询实现 468 24.4 游戏管理服务设计 469 24.5 游戏管理客户端设计 472 24.6 CQRS简介 473 24.7 本章小结 474 第25章 使用成熟的DDD技术框架 475 25.1 ABP和ABP vNext 475 25.1.1 ASP.NET Boilerplate（ABP） 475 25.1.2 ABP vNext 476 25.2 使用ABP vNext开发项目 476 25.3 使用辅助工具进行开发 478 25.4 使用技术框架开发的优势和代价 479 25.5 如何使用技术框架 480 25.6 本章小结 480 第26章 系统提升与持续改进 481 26.1 模型对需求变化的适应性 481 26.1.1 游戏类型的增加 481 26.1.2 增加不同数据源的游戏类型 483 26.1.3 限制数据范围 484 26.2 软件升级时模型的修改 484 26.2.1 挖掘现有模型的潜力 484 26.2.2 引入新的领域概念 486 26.3 使用语音输入对系统的影响 488 26.4 架构的持续改进 488 26.5 本章小结 491 后记 492 附录A 本书使用的开发工具、开发环境介绍 494 A.1 Docker 494 A.2 Git 494 A.3 NuGet 495 A.4 xUnit 495 A.5 SpecFlow 495 A.6 MongoDB 495 A.7 MS SQL Server 496 A.8 RabbitMQ 496 A.9 Kafka 497 A.10 Jenkins 500 A.11 Identity Server 4 admin 500 附录B 参考文献 509 附录C 本书代码说明 511