DDD实战进阶第一波(十五)：开发通常业务的大健康行业直销系统（总结篇）

 

前面咱们花了14篇的文章来给你们介绍经典DDD的概念、架构和实践。这篇文章咱们来作一个完整的总结，另外生成一个Api接口文档。

一.DDD解决传统的开发的几大问题：

1. 没有描述需求的设计模型；而是直接经过数据库表的方式体现，也就是需求与设计是脱节的。
2. 编码的架构也没有与设计和需求对应起来。
3. 业务逻辑与技术混在一块儿；业务逻辑可能直接调用的数据访问，这样把业务逻辑与数据访问的技术混在一块儿。
4. 开发没有层次感和节奏感；系统没有一个统一的约束，开发人员没有一个统一的节奏，这主要体如今随意的编码。
5. Bug 定位困难：当系统出现业务异常行为时，没法快速准确的定位出现问题的位置，由于系统不一样开发人员的代码放置随意性。
6. 需求变动响应缓慢：在大型的系统或产品中，当须要增长功能或修改现有功能时，由于代码架构的随意性，可能会出现改了功能可能会影响到其余的功能，形成系统极不稳定。

解决软件设计与开发问题的套路就是领域驱动设计（简称 DDD）。DDD 这个套路可以灵活解决以上的问题，为咱们提供一个好的设计、架构以及高质量的代码。

 

二.DDD解决之道：

DDD 方法首先是须要将需求分析后，造成一个反应需求的领域模型。领域模型就是你们日常理解的类、类的属性、类之间的关系等。固然在 DDD 中，为了更好的将领域模型反应需求，对类、类的属性、类之间的关系等有一些模式的指导。好比类的属性多是通常属性，也多是值对象；好比有关系的类之间是不是表明一个总体概念、有相同生命周期、须要统一持久化等。因此咱们的领域模型除了可以跑通需求外，还要考虑聚合根、实体、值对象、聚合等概念的应用，这样领域模型的设计才能更好的反应需求，也可以更好的将设计对应成有约束力的代码。另外 DDD 也提供了大量模式，告诉咱们应该如何编写对应设计的代码，可以将咱们的代码真正映射到设计；如何进行业务逻辑与持久化机制的剥离；如何进行更好的架构设计等。

1.DDD能应对复杂性：系统复杂性主要体如今三个方面。一是技术维度，有业务代码的实现、有与数据库或其余持久化存储交互的实现、有消息队列的实现、有身份验证与受权的实现、有 WebAPI 暴露的实现等；二是业务维度，有太多的模块和功能须要去作；三是时间维度，须要快速的开发，快速的响应需求的变动，快速的修正 Bug。DDD应对复杂性主要经过三个方面：

• a. 技术维度：经过合理的架构分层，可以让每层关注本身的事情，好比领域层只关注业务逻辑的事情，仓储实现层只关注持久化数据与查询的事情，应用服务层只关注协调领域层与仓储实现层完成用例的事情，接口层只关注暴露给前端的事情。
• b. 业务维度：经过将大系统划分红多个界限上下文，可让不一样团队和不一样人只关注当前上下文的开发。在当前界限上下文中的领域层、仓储实现层、应用服务层、接口层都与其余界限上下文独立开来，这样能够专一开发，而且在修改代码与发布产品时，影响面较小。
• c. 时间维度：经过敏捷式迭代快速验证，快速修正。

2.高效掌握DDD： 

          a. 熟悉概念：充分熟悉前面文章介绍的界限上下文、实体、值对象、领域服务、聚合、聚合根、仓储、应用服务、接口等。

          b. 熟悉架构：充分熟悉前面文章介绍的经典DDD的架构。

          c. 实践：前面文章从产品、经销商、订单三个界限上下文分析了需求、创建了领域模型、经过经典DDD架构实现了代码，须要你在实际项目中灵活的运用。

 

三.接口文档的生成

当咱们已经作好了全部的接口后，须要生成WebApi在线的接口文档，便于前端人员进行查看与使用。.net core webapi中使用Swagger生成接口文档。

1.在WebApi项目中引入Nuget包：Swashbuckle.AspNetCore。

2.在WebApi项目属性的生成中，勾选“XML 文档文件”。此目的是能够包括WebApi中每一个接口的注释。

3.在WebApi Startup.cs文件的ConfigureServices方法中，添加以下的代码：

 //swagger接口文档的信息
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new Info
                {
                    Version = "v1",
                    Title = "产品界限上下文接口文档",
                    Description = "包括产品界限上下文全部接口的描述",
                    Contact =new Contact {Name="曹剑",Email="malaoko@hotmail.com"}
                });
                //使用Xml文档中接口的注释
                var basePath = ApplicationEnvironment.ApplicationBasePath;
                var xmlPath = Path.Combine(basePath, "Product.WebApi.xml");
                c.IncludeXmlComments(xmlPath);               
            });

4.在Configure方法中，添加以下的代码：

 //制定swagger接口文档的访问url路径信息
            app.UseSwagger();
            app.UseSwaggerUI(p =>
            {
                p.SwaggerEndpoint("/swagger/v1/swagger.json", "Product接口");
            });

5.修改Properties下的launchSettings.json文件中的两个launchUrl的值都改成swagger，这样在打开这个WebApi时，自动跳转到swagger帮助文件：

"profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "swagger",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "Product.WebApi": {
      "commandName": "Project",
      "launchBrowser": true,
      "launchUrl": "swagger",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "applicationUrl": "http://localhost:5000"
    }
  }

 6.访问时，最终的效果以下图：

7.在点击每一个接口时，能够看到详细的调用说明：

 

本系列的文章就到这里，这个系列的文章主要是讲解了经典DDD，关于CQRS DDD与微服务，能够继续关注咱们后续的系列文章，也能够加入QQ群或关注咱们的

微信公众号。在后续CQRS与微服务的内容中，咱们将实现以下的架构

微服务架构：

CQRS架构：

QQ讨论群：309287205 

DDD实战进阶视频请关注微信公众号：