ABP 基于DDD的.NET开发框架

ABP总体介绍

• ABP是ASP.NET Boilerplate Project，ASP.NET样板项目。
• ABP框架定位于快速开发
• ABP是一个用于最快实践和流行开发现代Web应用程序的新起点，旨在成为一个通用的Web应用程序框架和项目模板。
• ABP基于DDD的经典分层架构思想，实现了众多DDD的概念。

官方文档：https://aspnetboilerplate.com/Pages/Documents

什么是ABP呢？

服务端

• ASP.NET MVC和Web API
• 实现领域驱动设计DDD，包括实体、存储库、领域服务、应用程序服务、DTO、UnitOfWork...
• 实现分层架构：领域层、应用程序、表示层、基础结构层
• 提供基础设施，为大型项目开发可重用和可组合的模块，使其依赖注入（使用Castle Windsor作为DI容器）。
• 提供严格的模型和基类，轻松使用对象关系映射ORM（直接支持EF）。
• 支持并实现数据库迁移Migration
• 包括简单灵活的本地化系统，多语言。
• 包含服务端全局领域事件和EventBus
• 管理异常处理和验证
• 为应用程序服务创建动态WebApi层
• 提供基本和辅助类实现常见任务
• 使用约定优于配置的原则

客户端

• 提供项目模板为单页应用程序SPA和多页应用程序MPA，模板基于Bootstrap。
• 常用jQuery和AngularJS库
• 创建动态JS代理以轻松调用应用程序服务，使用动态WebAPI层。
• 包含独特的任务API

ABP功能特性

基础设施层

• 依赖注入DI
• Session管理
• 缓存机制
• 日志管理
• 键值管理
• 时间管理

领域层

• 实体
• 值对象
• 仓储
• 领域服务
• 规约管理
• 工作单元
• 领域事件
• 数据过滤

应用层（动态WebApi）

• 应用服务
• 数据传输对象DTO
• 验证数据传输对象
• 授权
• 功能管理
• 审计日志

展现层

• ASP.NET MVC
• 本地化
• 菜单导航
• 嵌入资源
• JS API
• CSRF/XSRF保护

WebApi

• WebApi控制器
• 动态WebAPI
• Odata集成
• SwaggerUI集成

ORM

• EntityFramework集成
• EntityFramework Core集成
• NHibernate集成

后台服务

• 后台作业
• Hangfire集成
• Quartz集成

实时服务

• 通知系统
• Signal集成

ModuleZero

ABP框架是可以独立服务于其他任何数据库的，并尽可能使用他们能够通用。因此，有也就没有实行有关存储数据的功能。如审计日志、Session管理、授权...

ModuleZero实现了ABP框架的所有基础概念，如租户管理（多租户）、角色管理、用户管理、Session、授权（权限）管理、设置管理、语言管理、审计日志等。

Microsoft ASP.NET Identifity框架

ASP基础框架组建功能

• 基础框架组件独立、通用，可用于多个不同项目，类似于daxnet的Apworks框架。
• 对项目实现模块化提供了支持，每个模块有独立的EF DbContext，可单独指定数据库。
• 对DDD的技术实现进行了封装，让项目以及其精简的代码，专注于业务领域。
• 多租户支持，每个租户的数据自动隔离，业务模块开发者无需手动操作TenantID。
• 集成ASP.NET Identifity，实现登录认证、功能权限授权或验证、角色和用户管理。
• 集成Log4Net实现日志记录
• 集成AutoMapper实现DTO类与实体类的双向自动转换
• 实现ApplicationService的方法自动建立相应的WebApi方法，AJAX可直接调用，无需写ApiController和Action。
• 调用ApplicationService的方法时，自动验证权限和参数有效性，使用相应的Attribute标注。
• 继承自FullAuditeEntity基类的领域实体，会自动实现软删除，在数据库用lsDelete字段进行标注。
• 实现一系列扩展方法简化编码

基于DDD的分层结构

• 领域驱动设计（Domain-driven Design）
• DDD是一种模型驱动的软件设计方式

基于DDD的分层结构

用户界面（展现层）

负责向用户展现信息以及解释用户命令

• 请求应用层以获取用户所需展现的数据
• 发送命令给应用层要求其执行某个命令

应用层

很薄的一层，定义软件要完成的所有任务。对外为展现层提供各种应用功能，包括查询或命令，对内调用领域层（领域对象或领域服务）各种业务逻辑，应用层不包含业务逻辑。

领域层

负责表达业务概念，业务状态信息以及业务规则，领域模型处于此层，是业务软件的核心。

基础设施层

基础设施层为其他层提供通用的技术能力，提供层间的通信，为领域层实现持久化机制。总之，基础设施层可以通过架构或框架来支持其他层的技术需求。

DDD ABP

ABP目录结构

ABP

• Core 领域层，存放业务实体和仓储接口。
• Application 应用服务层
• EntityFramework 基础设施层，存放实体映射文件和仓储实现类等。
• Web 展现层，使用ASP.NET MVC。
• WebApi 展现层，使用ASP.NET WebAPI。

image.png

数据库设置

<connectionStrings>
  <add name="Default" connectionString="Server=.; Database=MPA; User ID=sa; Password=sa" providerName="System.Data.SqlClient" />
</connectionStrings>

image.png image.png

未能加载文件或程序集“Castle.Core, Version=4.0.0.0, Culture=neutral, PublicKeyToken=407dd0808d44fbdc”或它的某一个依赖项。找到的程序集清单定义与程序集引用不匹配。 (异常来自 HRESULT:0x80131040)

image.png image.png

数据库中已存在名为 'AbpAuditLogs' 的对象
解决方案：注释201807270535111_Updated_ABP.cs内的相同表代码

PM> Update-Database
Specify the '-Verbose' flag to view the SQL statements being applied to the target database.
Applying explicit migrations: [201707261347311_Initial_Migration, 201710131316266_UpgradedTo_ABP_3.1, 201801311121458_Modified_Authorization_Entities, 201803261403237_Upgraded_To_Abp_v3_5, 201807270535111_Updated_ABP, 201807271154374_Upgraded_ABP_3.8.1].
Applying explicit migration: 201707261347311_Initial_Migration.
Applying explicit migration: 201710131316266_UpgradedTo_ABP_3.1.
Applying explicit migration: 201801311121458_Modified_Authorization_Entities.
Applying explicit migration: 201803261403237_Upgraded_To_Abp_v3_5.
Applying explicit migration: 201807270535111_Updated_ABP.
Applying explicit migration: 201807271154374_Upgraded_ABP_3.8.1.
Running Seed method.

登陆账户：admin
账户密码：123qwe

https://v.qq.com/x/page/m0391qcwhyv.html

ABP代码生成器

ABP Code Generator