手把手教你用Abp vnext构建API接口服务

ABP是一个开源应用程序框架,该项目是ASP.NET Boilerplate Web应用程序框架的下一代，专注于基于ASP.NET Core的Web应用程序开发,也支持开发控制台应用程序。

官方网站：https://abp.io/
官方文档：https://docs.abp.io/

一、使用ABP框架可以快速的搭建一个应用程序，仅需要几步即可完成： 1. 安装ABP CLI

ABP CLI是使用ABP框架启动新解决方案的最快方法。如果没有安装ABP CLI，使用命令行窗口安装ABP CLI：

dotnet tool install -g Volo.Abp.Cli 2. 在一个空文件夹中使用abp new命令创建您的项目： abp new Acme.BookStore

您可以使用不同级别的名称空间。例如BookStore，Acme.BookStore或Acme.Retail.BookStore。

这样，就已经完成了一个应用程序的搭建。

然后我们只需要修改一下其他的配置即可运行应用程序，开发人员在这个架构的基础上就可以愉快的撸代码了。

然而，ABP的学习才刚刚开始。ABP放弃了原有MVC的架构，使用了模块化架构，支持微服务，根据DDD模式和原则设计和开发，为应用程序提供分层模型。对于没有微服务开发经验的程序员来说，学习ABP难度比较大。下面我们开始从一个空的web解决方案，一步步搭建API接口服务。

二、用APB基础架构搭建一个用户中心API接口服务

开发环境：Mac Visual Studio Code
SDK：dotnet core 3.1

1. 首先我们创建一个文件夹Lemon.UserCenter，并在终端中打开该文件夹。

使用命令创建一个空的web方案：

dotnet new web -o Lemon.UserCenter.HttpApi.Hosting 2. 再使用命令创建其他类库方案： 创建api层 dotnet new classlib -o Lemon.UserCenter.HttpApi 创建应用层 dotnet new classlib -o Lemon.UserCenter.Application 创建领域层 dotnet new classlib -o Lemon.UserCenter.Domain 创建基于EntityFrameworkCore的数据层 dotnet new classlib -o Lemon.UserCenter.EntityFrameworkCore 3. 把所有类库加入解决方案，然后类库间互相引用： 创建解决方案 dotnet new sln 所有类库加入解决方案 dotnet sln Lemon.UserCenter.sln add Lemon.UserCenter.HttpApi.Hosting/Lemon.UserCenter.HttpApi.Hosting.csproj dotnet sln Lemon.UserCenter.sln add Lemon.UserCenter.HttpApi/Lemon.UserCenter.HttpApi.csproj dotnet sln Lemon.UserCenter.sln add Lemon.UserCenter.Application/Lemon.UserCenter.Application.csproj dotnet sln Lemon.UserCenter.sln add Lemon.UserCenter.Domain/Lemon.UserCenter.Domain.csproj dotnet sln Lemon.UserCenter.sln add Lemon.UserCenter.EntityFrameworkCore/Lemon.UserCenter.EntityFrameworkCore.csproj 添加项目引用 dotnet add Lemon.UserCenter.HttpApi.Hosting/Lemon.UserCenter.HttpApi.Hosting.csproj reference Lemon.UserCenter.HttpApi/Lemon.UserCenter.HttpApi.csproj dotnet add Lemon.UserCenter.HttpApi.Hosting/Lemon.UserCenter.HttpApi.Hosting.csproj reference Lemon.UserCenter.EntityFrameworkCore/Lemon.UserCenter.EntityFrameworkCore.csproj dotnet add Lemon.UserCenter.HttpApi/Lemon.UserCenter.HttpApi.csproj reference Lemon.UserCenter.Application/Lemon.UserCenter.Application.csproj dotnet add Lemon.UserCenter.Application/Lemon.UserCenter.Application.csproj reference Lemon.UserCenter.Domain/Lemon.UserCenter.Domain.csproj dotnet add Lemon.UserCenter.EntityFrameworkCore/Lemon.UserCenter.EntityFrameworkCore.csproj reference Lemon.UserCenter.Domain/Lemon.UserCenter.Domain.csproj 4. 在领域层新增实体。

领域层添加Volo.Abp.Identity.Domain包引用：

dotnet add Lemon.UserCenter.Domain/Lemon.UserCenter.Domain.csproj package Volo.Abp.Identity.Domain

创建领域层模块类：

using Volo.Abp.Identity; using Volo.Abp.Modularity; namespace Lemon.UserCenter.Domain { [DependsOn(typeof(AbpIdentityDomainModule))] public class UserCenterDomainModule : AbpModule { } }

创建实体类：

using System; using Volo.Abp.Domain.Entities; namespace Lemon.UserCenter.Domain { public class UserData : Entity<Guid> { /// <summary> /// 账号 /// </summary> /// <value>The account.</value> public string Account { get; set; } /// <summary> /// 昵称 /// </summary> /// <value>The name of the nike.</value> public string NickName { get; set; } = ""; /// <summary> /// 头像 /// </summary> /// <value>The head icon.</value> public string HeadIcon { get; set; } = ""; /// <summary> /// 手机号码 /// </summary> /// <value>The mobile.</value> public string Mobile { get; set; } = ""; /// <summary> /// 电子邮箱 /// </summary> /// <value>The email.</value> public string Email { get; set; } = ""; /// <summary> /// 删除注记 /// </summary> /// <value><c>true</c> if deleted; otherwise, <c>false</c>.</value> public bool Deleted { get; set; } } } 5. 创建数据层