{"id":25738439,"url":"https://github.com/wumortal/dddsample","last_synced_at":"2025-05-08T04:24:50.111Z","repository":{"id":120948422,"uuid":"182107632","full_name":"WuMortal/DDDSample","owner":"WuMortal","description":"this is DDDSamp","archived":false,"fork":false,"pushed_at":"2020-01-05T09:56:34.000Z","size":68,"stargazers_count":13,"open_issues_count":4,"forks_count":8,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-31T17:07:47.178Z","etag":null,"topics":["csharp","ddd","dotnetcore"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WuMortal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-18T14:56:25.000Z","updated_at":"2023-03-27T07:30:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"cc41ec01-e422-49f5-a092-c4b2177fedf5","html_url":"https://github.com/WuMortal/DDDSample","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WuMortal%2FDDDSample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WuMortal%2FDDDSample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WuMortal%2FDDDSample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WuMortal%2FDDDSample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WuMortal","download_url":"https://codeload.github.com/WuMortal/DDDSample/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252998039,"owners_count":21837931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","ddd","dotnetcore"],"created_at":"2025-02-26T07:30:32.060Z","updated_at":"2025-05-08T04:24:50.089Z","avatar_url":"https://github.com/WuMortal.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DDD「领域驱动设计」分层架构\r\n\r\n基于 DDD 传统分层架构实现。\r\n\r\n博客：[https://wigor.club](https://wigor.club)\r\n\r\n## 前言\r\n\r\n这个分层架构是工作中项目正在使用的分层架构，使用了一段时间发现受益匪浅，所以整理好我对该分层架构的一些理解分享给大家，我对于该分层架构还处于学习阶段理解有误的地方请指出。本次会以一个案例来说明各个分层的作用以及他们之间的调用关系，还有本次的重点不在于`DDD`，因为这个我还未能完全理解，当然避免不了中间会涉及`DDD`的一些概念。\r\n\r\n## DDD 简单介绍\r\n\r\n`DDD` 什么？为什么使用 `DDD` ？\r\n\r\n相关文章：[架构为什么要以领域为核心](https://mp.weixin.qq.com/s?__biz=MzAwNTMxMzg1MA==\u0026mid=2654074749\u0026idx=1\u0026sn=ed26e35d0674ac821c999949f4fcf67c\u0026chksm=80dbd328b7ac5a3eb3aef40c1057b1339dd8918cd501a8fa982e83b9c8bd5ef148978eb82be8\u0026mpshare=1\u0026scene=1\u0026srcid=#rd)\r\n\r\n下面是我的一些看法：\r\n\r\n关于这个问题有兴趣的可以自行百度，我相信网络上已经有大量的文章来说明这几个问题。我目前的理解是“业务”，是为了应对现在复杂和多变的业务，是一种开发理念。\r\n\r\n这里我就以一个小故事描述吧，有一天你接到任务要实现一个修改用户的功能，非常简单。使用传统三层架构我们会怎么写？\r\n\r\n1. 先在 `DAL` 层添加 `UserDAL` 然后实现一个 `Update(UserEntity user)` 方法\r\n\r\n2. 接着在 `BLL` 中添加一个 `UserBLL` 在实现一个 `Update(string email,string pwd ...)` 方法。\r\n\r\n3. `UI` 层在调用，OK 完成任务下班回家。\r\n\r\n接着你接到一个新的需求就是：需要增加用户修改信息的记录。\r\n\r\n你立马在 `BLL`的 `Update` 的方法里增加的用户修改信息的操作记录，完成需求。\r\n\r\n过了一段时间又来了一个需求：用户改了信息需要通知到管理员，并且用户每天只能修改 3 次信息。\r\n\r\n好了之后又经历了几波需求，你的代码也在不断的增加和变化，有一天你接收新的项目或者离开了，那么接收你项目的人完全不清楚这里的业务情况。因为 `Update` 方法并没有直接的反应出里的业务情况，代码目的不明确。代码变得难以维护。\r\n\r\n那么在 `DDD` 里这些应该怎么做呢？\r\n\r\n1. 首先在方法的命名上做出更改既然业务是修改信息那么命名应该是 `Modify(string email,string pwd ...)`\r\n\r\n2. 将用户修改信息的记录代码放在 `DomainService`（领域服务） 中，当然这里的类、方法命名要直接的反应出业务情况，如：`RecordUserModifyDomainService`。\r\n\r\n3. 对应的通知管理员的代码也应该放入 `DomainService` 中，`DomainService` 应该尽量简单一般只做一件事情。\r\n\r\n## 分层架构图\r\n\r\n![DDD 流程图](https://raw.githubusercontent.com/WuMortal/DDDSamp/master/doc/images/DDD_1.png)\r\n\r\n下面是关于 DDD 分层的一些描述，摘抄至之前看过的一片文章。\r\n\u003e * Presentation 为表示层，负责向用户显示信息和解释用户命令。这里指的用户可以是另一个计算机系统，不一定是使用用户界面的人。\r\n\u003e\r\n\u003e * Application 为应用层，定义软件要完成的任务，并且指挥表达领域概念的对象来解决问题。这一层所负责的工作对业务来说意义重大，也是与其它系统的应用层进行交互的必要渠道。应用层要尽量简单，不包含业务规则或者知识，而只为下一层中的领域对象协调任务，分配工作，使它们互相协作。它没有反映业务情况的状态，但是却可以具有另外一种状态，为用户或程序显示某个任务的进度。\r\n\u003e\r\n\u003e * Domain 为领域层（或模型层），负责表达业务概念，业务状态信息以及业务规则。尽管保存业务状态的技术细节是由基础设施层实现的，但是反映业务情况的状态是由本层控制并且使用的。领域层是业务软件的核心，领域模型位于这一层。\r\n\u003e\r\n\u003e * Infrastructure 层为基础实施层，向其他层提供通用的技术能力：为应用层传递消息，为领域层提供持久化机制，为用户界面层绘制屏幕组件，等等。基础设施层还能够通过架构框架来支持四个层次间的交互模式。\r\n\r\n## 说明\r\n\r\n如上图每个层中其实对应着具体的项，下面将对每个项进行说明。\r\n\r\n1. `Domain` 层分为：`Domain` 、`DomainService` 和 `IDomainService`。\r\n * 首先 `Domain` 中包含有 `Entity` 和 `IRepository` ，`Entity` 是你的实体一般对于数据库表但是在某些情况下你也可以冗余一些字段。`IRepository` 仓储的方法的定义，该层不会有具体的实现。\r\n * `DomainService` 和 `IDomainService`，`IDomainService` 只是负责表达业务的概念，`DomainService` 里才是具体业务逻辑代码。在这一层的代码命名上需要注意，我们的命名一般要能直接描述出该代码业务的功能。这里可以参考 `DDD` 的几个概念：通用语言、领域。\r\n\r\n2. `Infrastructure` 层分为：`Repository` 和 `CrossCutting`：\r\n * `Repository` 里面就是 `Domain` 里 `IRepository` 的具体实现。项目中 RepositoryExtensions.cs 是一个扩展类，将所有的仓储注入容器中，方便我们在项目中使用 `DI`（依赖注入）。\r\n * `CrossCutting` 主要是提供一些各个层通用的东西，如一些枚举、扩展方法、工具类等等。\r\n\r\n3. `Application` 层分为：`Application` 和 `ApplicationContract`。\r\n * `ApplicationContract` 里主要包含 `DTO`、`ViewModel`、`IXXXService`。`DTO` 是数据传输对象，主要负责给展现层提供展示数据，`DTO` 里应该只有值类型存在，当然根据具体情况也可存在其他的 `DTO` 。`ViewModel` 用于展现层传入的模型，简单的说 `DTO` 输出，`ViewModel` 输入。`IXXXService` 就是应用层的方法定义。\r\n * `Application` 里面主要是用于 实现 `ApplicationContract` 里的 `IXXXService`，还有 `Entity` 和 `DTO` 的映射也属于该层的工作。ApplicationExtensions.cs 扩展方法是用于实现 `DI`。\r\n\r\n4. `Presentation` 层里目前只有一个 WebAPI。展现层的代码一般有：对传入模型的校验。\r\n\r\n## 案例\r\n\r\n本次以一个用户注册的流程为案例，来简单说明如何使用该分层架构进行项目开发。\r\n\r\n1. 首先在 `Domain` 中建一个 UserEntity，有 Id、Mobile、Name、Age、RegisterDateTime 属性。接着建立 IUserRepository，编写需要定义的方法，这里我定义了一个 GetByMobile(string mobile) 方法。\r\n\r\n``` cs\r\n[Table(Name = \"User\")]\r\npublic class UserEntity\r\n{\r\n    [Column(IsIdentity = true)]\r\n    public Guid Id { get; set; }\r\n\r\n    public string Mobile { get; set; }\r\n\r\n    public string Name { get; set; }\r\n\r\n    public int Age { get; set; }\r\n\r\n    public DateTime RegisterDateTime { get; set; } = DateTime.Now;\r\n}\r\n\r\npublic interface IUserRepository : IBasicRepository\u003cUserEntity, Guid\u003e\r\n{\r\n    Task\u003cUserEntity\u003e GetByMobileAsync(string mobile);\r\n}\r\n```\r\n\r\nIBasicRepository 是使用了 [FreeSql](https://github.com/2881099/FreeSql)，你们可以自己实现。\r\n\r\n2. 然后在 Repository 中建 UserRepository 类，该类继承 IUserRepository 并且实现该接口的所有方法。\r\n\r\n``` cs\r\npublic class UserRepository : GuidRepository\u003cUserEntity\u003e, IUserRepository\r\n{\r\n    public UserRepository(IFreeSql freeSql)\r\n        : base(freeSql)\r\n    {\r\n    }\r\n\r\n    #region Implementation of IUserRepository\r\n\r\n    public async Task\u003cUserEntity\u003e GetByMobileAsync(string mobile)\r\n    {\r\n        return await this.Where(u =\u003e u.Mobile == mobile).FirstAsync();\r\n    }\r\n\r\n    #endregion\r\n}\r\n```\r\n\r\n3. 仓储基本好了后就是 `Application` ，首先需要在 ApplicationContract 中建 UsesDTO，根据业务情况你也可以建 UserSimpleDTO 、UserDetailDTO。`DTO` 里包含你需要返回的数据，我这里有 Id、Name、Mobile、Age、ProfilePhotoSrc（头像地址根据 Id 拼接，这里我用 imgage/Id.png 的格式）。\r\n\r\n``` cs\r\npublic class UserDTO\r\n{\r\n    public Guid Id { get; set; }\r\n\r\n    public string Name { get; set; }\r\n\r\n    public string Mobile { get; set; }\r\n\r\n    public int Age { get; set; }\r\n\r\n    public string ProfilePhotoSrc { get; set; }\r\n}\r\n```\r\n\r\n4. 添加好 UserDTO 后，然后添加 IUserService.cs 接口，接着在 Application 的 Service 中添加对应的 UserService，并且 UserService 继承 IUserService。\r\n\r\n``` cs\r\npublic interface IUserService\r\n{\r\n    /// \u003csummary\u003e\r\n    /// 用户注册\r\n    /// \u003c/summary\u003e\r\n    /// \u003cparam name=\"userName\"\u003e用户名\u003c/param\u003e\r\n    /// \u003cparam name=\"mobile\"\u003e手机号\u003c/param\u003e\r\n    /// \u003cparam name=\"age\"\u003e年龄\u003c/param\u003e\r\n    /// \u003creturns\u003e\u003c/returns\u003e\r\n    Task\u003cbool\u003e Register(string userName, string mobile, int age);\r\n\r\n    List\u003cUserDTO\u003e GetList();\r\n}\r\n\r\n public class UserService : IUserService\r\n{\r\n    readonly IUserRepository _userRepository;\r\n\r\n    public UserService(IUserRepository userRepository)\r\n    {\r\n        _userRepository = userRepository;\r\n    }\r\n\r\n    #region Implementation of IUserService\r\n\r\n    /// \u003csummary\u003e\r\n    /// 用户注册\r\n    /// \u003c/summary\u003e\r\n    /// \u003cparam name=\"userName\"\u003e用户名\u003c/param\u003e\r\n    /// \u003cparam name=\"mobile\"\u003e手机\u003c/param\u003e\r\n    /// \u003cparam name=\"age\"\u003e年龄\u003c/param\u003e\r\n    /// \u003creturns\u003e\u003c/returns\u003e\r\n    public async Task\u003cbool\u003e Register(string userName, string mobile, int age)\r\n    {\r\n        var userEnity = await _userRepository.GetByMobileAsync(mobile);\r\n\r\n        if (userEnity != null)\r\n        {\r\n            return false;\r\n        }\r\n\r\n        var addUserEntity = new UserEntity\r\n        {\r\n            Id = Guid.NewGuid(),\r\n            Age = age,\r\n            Name = userName,\r\n            Mobile = mobile\r\n        };\r\n\r\n        return await _userRepository.InsertAsync(addUserEntity) != null;\r\n    }\r\n\r\n    public List\u003cUserDTO\u003e GetList()\r\n    {\r\n        return _userRepository.Select\r\n            .ToList().ToDTOList();\r\n    }\r\n\r\n    #endregion\r\n}\r\n```\r\n\r\n5. UserServcie 是对应展现层的控制器 UserController ---\u003e IUserService。\r\n\r\n6. 最后展现层的 WebAPI 只需要注入 IUserService，就可以开心的使用了。\r\n\r\n``` cs\r\n[HttpPost]\r\npublic async Task\u003cIActionResult\u003e Post()\r\n{\r\n    var second = DateTime.Now.Second.ToString(\"00\");\r\n    bool isSuccess = await _userService.Register(\"Wigor\", $\"188888888{second}\", 22);\r\n\r\n    return Ok(isSuccess);\r\n}\r\n```\r\n\r\n就这样这个简单的案例就完成了，你可以参考着上面 说明 对比着去看看，当然这里有一些东西并没有体现，如 DomainServie，如果按照 DDD 来说还有 值对象、聚合、通用语言……，对于「通用语言」的话其实上面的小故事就体现出了一点。\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwumortal%2Fdddsample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwumortal%2Fdddsample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwumortal%2Fdddsample/lists"}