ABP框架实战：构建图书管理系统服务端（Part 1）

方苹奕

于 2025-06-03 09:02:51 发布

阅读量316

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00647/article/details/148392233

ABP框架实战：构建图书管理系统服务端（Part 1）

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框架构建一个图书管理系统的服务端部分。作为系列教程的第一部分，我们将从项目创建开始，逐步完成实体定义、数据库配置、应用服务开发等核心内容。

一、项目初始化

在开始开发前，我们需要创建一个名为Acme.BookStore的解决方案。ABP框架提供了多种项目模板，可以根据需求选择不同的UI和数据库选项。

客户端包安装

ABP CLI在创建应用时会自动运行abp install-libs命令来安装所需的NPM包。但在某些情况下可能需要手动执行此命令：

abp install-libs

建议安装Yarn v1.22+（非v2版本）以避免潜在的包不一致问题。

二、领域层设计

图书实体定义

在领域层（Acme.BookStore.Domain项目）中，我们首先定义核心实体Book：

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; }
}

关键点说明：

继承自AuditedAggregateRoot，自动包含审计字段
使用Guid作为主键类型
实体属性使用public get/set简化示例

图书类型枚举

在共享领域层定义BookType枚举：

public enum BookType
{
    Undefined,
    Adventure,
    Biography,
    //...其他类型
}

三、数据库集成

Entity Framework Core配置

对于使用EF Core的项目：

在DbContext中添加DbSet属性
在OnModelCreating中配置实体映射：

builder.Entity<Book>(b =>
{
    b.ToTable(BookStoreConsts.DbTablePrefix + "Books",
        BookStoreConsts.DbSchema);
    b.ConfigureByConvention();
    b.Property(x => x.Name).IsRequired().HasMaxLength(128);
});

创建并应用数据库迁移：

dotnet ef migrations add Created_Book_Entity

数据种子

实现IDataSeedContributor接口来初始化示例数据：

public async Task SeedAsync(DataSeedContext context)
{
    if (await _bookRepository.GetCountAsync() <= 0)
    {
        await _bookRepository.InsertAsync(
            new Book { Name = "1984", Type = BookType.Dystopia, ... });
        //...
    }
}

运行DbMigrator应用程序来更新数据库并填充种子数据。

四、应用服务开发

DTO定义

BookDto用于向客户端传输数据：

public class BookDto : AuditedEntityDto<Guid>
{
    public string Name { get; set; }
    //...其他属性
}

CreateUpdateBookDto用于创建/更新操作，包含数据验证：

public class CreateUpdateBookDto
{
    [Required]
    [StringLength(128)]
    public string Name { get; set; } = string.Empty;
    //...其他属性及验证
}

对象映射配置

在AutoMapper配置文件中定义映射关系：

CreateMap<Book, BookDto>();
CreateMap<CreateUpdateBookDto, Book>();

应用服务接口与实现

定义IBookAppService接口：

public interface IBookAppService : 
    ICrudAppService<BookDto, Guid, PagedAndSortedResultRequestDto, CreateUpdateBookDto>
{
}

实现BookAppService：

public class BookAppService : 
    CrudAppService<Book, BookDto, Guid, PagedAndSortedResultRequestDto, CreateUpdateBookDto>,
    IBookAppService
{
    public BookAppService(IRepository<Book, Guid> repository)
        : base(repository) { }
}