ABP -Vnext框架一步一步入门落地教程——使用ABP -Vnext创建一个WEBAPI接口（二）

开发主题：何谓开发应用服务端

在官方开发教程这一段的内容叫做开发应用服务端，作为现在前后端分离的开发模式来说，一个应用就分为前端页面框架和后端API，页面框架调用WEBAPI实现业务就完事了。所以咱们今天开发一个WEBAPI就叫做应用服务端。

在传统的三层框架美好的年代，一个应用就是数据层、业务逻辑层、前端UI层就打完收工了。但为了实现更高程度的可复用、可扩展、并且能够更大程度的遵循设计模式单一职责开闭原则和里氏替换三大根本原则，现在的软件工程在以前三层架构的模式上研究出了领域驱动模式，而以前追求的对象持久化，把应用程序中的对象和对象的状态存储到数据库当中也发展成为了ORM框架(Object-Relational Mapping，对象关系映射)，最终实现低代码甚至是无代码的目标。

回到今天的主题，那我们要开发一个应用的功能，就从数据层业务逻辑层UI层三层发展到了现在ABP这样的模式。

一、创建解决方案：

二、创建数据实体：

1. 创建实体
2. 把实体添加到DTO（数据上下文DbContext）以实现数据持久化
3. 将Book实体映射到数据库表
4. 执行一次数据迁移

三、创建应用程序：

1. 创建 BookDto实体类
2. CreateUpdateBookDto
3. IBookAppService
4. BookAppService
5. 自动生成API Controllers
6. Swagger UI

创建解决方案

在开始开发之前,请按照入门教程创建名为 Acme.BookStore 的新解决方案.也就是我们上一篇文章创建的源代码。

创建数据实体

第一步：创建实体

启动模板中的领域层分为两个项目:

创建Book实体

Acme.BookStore.Domain包含你的实体, 领域服务和其他核心域对象.

Acme.BookStore.Domain.Shared包含可与客户共享的常量,枚举或其他域相关对象.

在解决方案的领域层(Acme.BookStore.Domain项目)中定义你的实体.

该应用程序的主要实体是Book. 在Acme.BookStore.Domain项目中创建一个 Books 文件夹(命名空间),并在其中添加名为 Book 的类,如下所示:

using System;
using Volo.Abp.Domain.Entities.Auditing;

namespace Acme.BookStore.Books
{
    public class Book : AuditedAggregateRoot<Guid>
    {
        public string Name { get; set; }

        public BookType Type { get; set; }

        public DateTime PublishDate { get; set; }

        public float Price { get; set; }
    }
}

ABP为实体提供了两个基本的基类: AggregateRoot和Entity. Aggregate Root是领域驱动设计 概念之一. 可以视为直接查询和处理的根实体(请参阅实体文档).

Book实体继承了AuditedAggregateRoot,AuditedAggregateRoot类在AggregateRoot类的基础上添加了一些基础审计属性(例如CreationTime, CreatorId, LastModificationTime 等). ABP框架自动为你管理这些属性.

Guid是Book实体的主键类型.

为了保持简单,本教程将实体属性保留为 public get/set . 如果你想了解关于DDD最佳实践,请参阅实体文档.

BookType枚举

Book实体使用了BookType枚举. 在Acme.BookStore.Domain.Shared项目中创建Books文件夹(命名空间),并在其中添加BookType:

点击查看代码

namespace Acme.BookStore.Books
{
    public enum BookType
    {
        Undefined,
        Adventure,
        Biography,
        Dystopia,
        Fantastic,
        Horror,
        Science,
        ScienceFiction,
        Poetry
    }
}

最终的文件夹/文件结构应该如下所示:

第二步：把实体添加到DTO（数据上下文DbContext）

第三步：将Book实体映射到数据库表

第四步：执行一次数据迁移

创建应用程序

第一步：创建 BookDto实体类

第二步：CreateUpdateBookDto

第三步：IBookAppService

第四步：BookAppService

第五步：自动生成API Controllers

第六步：Swagger UI