ABP框架教程：使用ABP Suite开发图书管理系统(二)

本文链接：https://blog.youkuaiyun.com/gitblog_00918/article/details/148392244

ABP框架教程：使用ABP Suite开发图书管理系统(二) - 创建图书实体

abp Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation. 项目地址: https://gitcode.com/gh_mirrors/abp1/abp

前言

在上一部分教程中，我们完成了解决方案的创建。本部分将重点介绍如何使用ABP Suite工具快速创建图书(Book)实体，并自动生成完整的CRUD功能。通过本教程，您将了解到ABP框架强大的代码生成能力，以及如何高效地开发业务模块。

ABP Suite工具简介

ABP Suite是ABP框架提供的一款可视化代码生成工具，它能够：

根据定义的实体模型自动生成前后端代码
创建完整的应用服务层实现
生成单元测试和集成测试
自动处理数据库迁移
配置权限和导航菜单
生成完整的UI界面

准备工作

在开始之前，请确保：

已停止正在运行的应用程序，因为ABP Suite需要修改解决方案文件
已通过菜单命令打开ABP Suite界面

创建图书类型枚举

在定义图书实体前，我们首先需要创建一个图书类型枚举。这个枚举将定义图书的不同分类：

namespace Acme.BookStore.Books;

public enum BookType
{
    Undefined,          // 未定义
    Adventure,          // 冒险类
    Biography,          // 传记类
    Dystopia,           // 反乌托邦类
    Fantastic,          // 奇幻类
    Horror,             // 恐怖类
    Science,            // 科学类
    ScienceFiction,     // 科幻类
    Poetry              // 诗歌类
}

这个枚举将被用作图书实体的一个属性，ABP Suite能够识别并正确处理枚举类型的属性。

定义图书实体

在ABP Suite中创建图书实体时，我们需要配置以下关键信息：

基本设置：
- 实体名称：Book
- 实体类型：主实体(Master)
- 基类：FullAuditedAggregateRoot（包含完整审计跟踪）
- 主键类型：Guid
高级选项：
- 启用代码自定义功能
- 生成单元测试和集成测试
- 设置菜单项图标为"book"
实体属性：
- 名称(Name)：必填字符串，最大长度128
- 类型(Type)：BookType枚举
- 出版日期(PublishDate)：DateTime类型，必填
- 价格(Price)：float类型，必填

代码生成过程

点击"保存并生成"按钮后，ABP Suite将自动执行以下操作：

领域层：
- 创建Book实体类
- 生成BookBase基类（用于自定义）
- 创建领域服务BookManager
- 实现仓储接口EfCoreBookRepository
应用层：
- 生成IBookAppService接口
- 实现BookAppService应用服务
- 创建输入输出DTO
基础设施层：
- 添加数据库迁移
- 更新数据库架构
表现层：
- 生成CRUD页面
- 配置导航菜单
- 设置权限控制
测试层：
- 创建单元测试
- 生成集成测试