一、ABP各项目介绍
1、.Domain.Shared 项目
项目包含常量,枚举和其他对象,这些对象实际上是领域层的一部分,但是解决方案中所有的层/项目中都会使用到。
该项目不依赖解决方案中的其他项目. 其他项目直接或间接依赖该项目。
2、.Domain 项目
解决方案的领域层. 它主要包含 实体, 集合根, 领域服务, 值类型, 仓储接口 和解决方案的其他领域对象。
它依赖 .Domain.Shared 因为它可能会在应用接口和DTO中使用常量,枚举和其他的共享对象。
注:专门放实体类,集合跟,聚合根和仓储接口(此实体的构造函数,增删改查等方法)
3、.Application.Contracts 项目
项目主要包含 应用服务 interfaces 和应用层的 数据传输对象 (DTO).。它用于分离应用层的接口和实现。 这种方式可以将接口项目做为约定包共享给客户端。
它依赖 .Domain.Shared 因为它可能会在应用接口和DTO中使用常量,枚举和其他的共享对象。
注:对外可放置Dto和方法的接口IService
4、.Application 项目
项目包含 .Application.Contracts 项目的 应用服务 接口实现。
它依赖 .Application.Contracts 项目, 因为它需要实现接口与使用DTO;
它依赖 .Domain 项目,因为它需要使用领域对象(实体,仓储接口等)执行应用程序逻辑。
注:上一个项目中接口的实现,Service方法
5、.EntityFrameworkCore.DbMigrations 项目
包含解决方案的EF Core数据库迁移. 它有独立的 DbContext 来专门管理迁移。
ABP是一个模块化的框架,理想的设计是让每个模块都有自己的 DbContext 类. 这时用于迁移的 DbContext 就会发挥作用.。它将所有的 DbContext 配置统一到单个模型中以维护单个数据库的模式。 对于更高级的场景,可以程序可以拥有多个数据库(每个数据库有一个或多个模块表)和多个迁移DbContext(每个都维护不同的数据库模式)
6、.DbMigrator 项目
这是一个控制台应用程序,它简化了在开发和生产环境执行数据库迁移的操作。
必要时创建数据库(没有数据库时);
应用未迁移的数据库迁移;
初始化种子数据(当需要时)。
这个项目有自己的 appsettings.json 文件. 所以如果要更改数据库连接字符串,请记得也要更改此文件。
初始化种子数据很重要,ABP具有模块化的种子数据基础设施
它依赖 .EntityFrameworkCore.DbMigrations 项目 (针对EF Core),因为它需要访问迁移文件;
它依赖 .Application.Contracts 项目,因为它需要访问权限定义在初始化种子数据时为管理员用户赋予所有权限。
7、.HttpApi 项目
用于定义API控制器,大多数情况下,不需要手动定义API控制器,因为ABP的动态API功能会根据应用层自动创建API控制器。 但是,如果需要编写API控制器,那么它是最合适的地方。
它依赖 .Application.Contracts 项目,因为它需要注入应用服务接口
8、.HttpApi.Client 项目
定义C#客户端代理使用解决方案的HTTP API项目.。可以将上编辑共享给第三方客户端,使其轻松的在DotNet应用程序中使用你的HTTP API(其他类型的应用程序可以手动或使用其平台的工具来使用你的API)。ABP有动态 C# API 客户端功能,所以大多数情况下你不需要手动的创建C#客户端代理。
它依赖 .Application.Contracts 项目,因为它需要使用应用服务接口和DTO
9、.Web 项目
包含应用程序的用户界面(UI).如果使用ASP.NET Core MVC UI, 它包括Razor页面,javascript文件,样式文件,图片等;包含应用程序主要的 appsettings.json 配置文件,用于配置数据库连接字符串和应用程序的其他配置。
依赖 .HttpApi 项目,因为UI层需要使用解决方案的API和应用服务接口
10、.IdentityServer 项目
用于其他项目的身份验证服务器。Web项目使用OpenId Connect身份验证从IdentityServer获取当前用户的身份和访问令牌,然后使用访问令牌调用HTTP API服务器,HTTP API服务器使用bearer token从访问令牌获取声明授权当前用户。BP使用开源的IdentityServer4框架做应用程序间的身份验证。
它有自己的appsettings.json文件(数据库连接字符串等其他配置)
11、.HttpApi.Host 项目
该项目是一个承载解决方案API的应用程序. 它有自己的appsettings.json文件(数据库连接字符串等其他配置)。