ABP vNext微服务架构详细教程——基础服务层

1

服务创建

713dbdfd23c3a5ef120db4ec0241c00f.png

在除身份管理相关服务以外的其他业务服务中,我们不需要包含用户角色权限管理功能模块,ABP vNext框架为我们提供了模块模式,其默认模板不包含身份管理相关模块,更适合用于搭建普通的业务微服务。

fa2015a87df233745b5059a36f54e5ce.gif

以产品管理服务为例,我们在解决方案目录中找到service目录,在其中创建productmanager目录,切换至该目录并启动cmd命令行。使用以下命令创建产品管理服务:

abp new Demo.ProductManager -t module --no-ui

56efa2b4ac4a432fc3680d037dda064a.png

其中

    -t module表示模块模式

    --no-ui表示不使用UI界面

a91d49c5e11681f8ea1819ad11adca00.gif

在ABP vNext框架Module模式下一直存在一个问题,创建时无法和Application一样使用-dbms参数设置数据库类型,而是使用默认的SQL Server数据库类型,这里我们的项目采用MySQL数据库,需要手动修改为MySQL,具体方法见下一章节。

f24af5a1e81b09264d2dbfa0a8a942d8.gif

因为我们身份认证服务采用统一的服务,所以我们在生成的模板中找到host目录下的ProductManager.IdentityServer项目文件夹并删除,数据库我们不使用MongoDB,所以可以将src目录下的ProductManager.MongoDB项目文件夹和test目录下的ProductManager.MongoDB.Tests项目文件夹删除。之后我们可以删除该项目根目录下database文件夹和除Demo.ProductManager.sln、common.props以外的所有文件,如果不需要对该项目进行单元测试,也可删除test文件夹。

1888979095115820a6fb9e7d6145e07b.gif

清理后,跳转到总解决方案所在目录,使用解决方案构建工具将产品管理服务所有项目添加到总解决方案,添加后效果如下:

2

切换为Mysql数据库

75a9446e7f194a69bde9a70d7fa468ca.gif

将Module模式项目从SQL Server数据库更改为MySQL数据库步骤如下:

1. 找到ProductManager.HttpApi.Host项目移除其Nuget引用中的Volo.Abp.EntityFrameworkCore.SqlServer,然后添加Nuget引用Volo.Abp.EntityFrameworkCore.MySQL,注意版本号和主项目ABP框架版本一致。

2. 找到ProductManager.HttpApi.Host项目中的模块类ProductManagerHttpApiHostModule,将其特性DependsOn特性中引用的 typeof(AbpEntityFrameworkCoreSqlServerModule) 更改为 typeof(AbpEntityFrameworkCoreMySQLModule) 并将其命名空间引用 using Volo.Abp.EntityFrameworkCore.SqlServer; 改为 using Volo.Abp.EntityFrameworkCore.MySQL; 。将ConfigureServices方法的

Configure(options => { options.UseSqlServer(); }); 改为 Configure(options => { options.UseMySQL(); });

3. 找到ProductManager.HttpApi.Host项目中的ProductManagerHttpApiHostMigrationsDbContextFactory类,将其方法CreateDbContext中的 var builder = new DbContextOptionsBuilder() .UseSqlServer(configuration.GetConnectionString("ProductManager")); 改为以下代码(注意我的MySQL版本为5.7,具体版本号请依据个人情况修改):

var builder = new DbContextOptionsBuilder()
  .UseMySql(configuration.GetConnectionString("ProductManager"),ServerVersion.Parse("5.7.28-mysql"));

4. 修改Demo.ProductManager.HttpApi.Host项目的appsettings.json配置文件,和Application模式不同,我们会发现Module模式下ABP vNext框架提供的项目模板ConnectionStrings项会包含Default和ProductManager两个配置项。其中Default为ABP框架基础配置信息的数据库,身份管理服务已包含其所需的所有数据,所以我们将Default配置为和身份管理中心相同的数据库链接。ProductManger也就是和当前项目相同的数据库配置项,所指向的数据库为对当前模块领域实体持久化的数据库,需要在当前项目中配置和创建。

5. 进入Demo.ProductManager.HttpApi.Host项目所在目录,执行数据迁移命令 dotnet-ef database update ,执行成功后查看数据库,发现已创建模块数据库,且仅包含__EFMigrationsHistory表,则数据库链接成功。

3

初始化运行

1671e6ce65ded084dd6b37254bb0ad77.gif

在Demo.ProductManager.Application、Demo.ProductManager.Application.Contracts、Demo.ProductManager.HttpApi三个项目中分别找到Samples文件夹并删除,这是ABP vNext提供的样例API,没有实际用途。

87bcef0e50f032f8c12192b34ec91dfd.gif

设置端口号为5010并允许IP地址访问,方式为在Demo.ProductManager.HttpApi.Host项目配置文件appsettings.json中添加配置项: "urls": "http://*:5010" 

647b122b97d0ad11f4ca1790d325044e.gif

上一章节我们已经配置了数据库链接字符串,我们继续编辑Demo.ProductManager.HttpApi.Host项目配置文件appsettings.json,设置Redis链接字符串。

8560792cfe5500e96c029325346ecb69.gif

启动Demo.ProductManager.HttpApi.Host项目并访问http://localhost:5010/swagger/index.html,可以正常显示Swagger页面,即启动成功。

4

产品管理API

01

领域层

f1ce05f9acbdc7c9e0d713151b18ac8c.gif

在Demo.ProductManager.Domain项目中添加Products文件夹(产品领域)并创建Product类(产品聚合根)代码如下:

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


namespace Demo.ProductManager.Products;


/// 
/// 产品
/// 
public class Product : AggregateRoot
{
    /// 
    /// 名称
    /// 
    public string Name { get; set; }


    /// 
    /// 价格
    /// 
    public float Price { get; set; }
}

02

数据库创建

3f48a0682b0bd47cc1f63bb7e1b9785d.gif

在Demo.ProductManager.EntityFrameworkCore项目中找到IProductManagerDbContext接口和ProductManagerDbContext类,分别添加 DbSet Products { get; set; } 和 public DbSet Products { get; set; } 属性并添加相应引用。

8638c96284f5f51186f0b5787b3bf688.gif

在Demo.ProductManager.EntityFrameworkCore项目中找到ProductManagerDbContextModelCreatingExtensions类中的ConfigureProductManager方法内添加以下内容:

builder.Entity(b =>
{
  b.ToTable(ProductManagerDbProperties.DbTablePrefix
   + "Products", ProductManagerDbProperties.DbSchema);
  b.ConfigureByConvention();
});

这里使用实体类默认设置,如果需要进行自定义修改,可自行编辑实体配置。

1e104b7f02dcd43a15f90ca71fb243ec.gif

在Demo.ProductManager.HttpApi.Host项目所在目录中执行创建数据迁移语句:

dotnet-ef migrations Add BuildProduct

创建成功后执行数据迁移:

dotnet-ef database update

000a0b982fcf9a530a29ea60689c67cf.gif

执行成功后,我们可以在ProductManager模块数据库中看到已新增数据库表Product,此表中除主键ID和我们自己定义的两个字段以外,如果Product继承自AggregateRoot,则会包含ExtraProperties和ConcurrencyStamp两个字段,分别为扩展属性和并发戳。若继承自Entity则默认不会包含这两个字段。

03

应用层

为方便演示,本实例采用CrudAppService,对Product提供增删改查接口,具体实现方式如下:

173687abcb5cf8fc53f9f7f0a8134da9.gif

在Demo.ProductManager.Application.Contracts项目中创建Products文件夹并在其中创建Dto文件夹。在Dto文件夹中存放产品管理的数据传输对象,这里增删改查接口统一使用ProductDto,代码如下:

using System;
using Volo.Abp.Application.Dtos;
using Volo.Abp.Domain.Entities;


namespace Demo.ProductManager.Products.Dto;


/// 
/// 产品DTO
/// 
public class ProductDto : EntityDto, IHasConcurrencyStamp
{
    /// 
    /// 名称
    /// 
    public string Name { get; set; }


    /// 
    /// 价格
    /// 
    public float Price { get; set; }
    /// 
    /// 并发戳
    /// 
    public string ConcurrencyStamp { get; set; }
}

这里因为我们使用聚合根,修改数据时需要提供并发戳ConcurrencyStamp,但EntityDto中并未提供该字段,所以需继承IHasConcurrencyStamp接口。

213d71f05a0fbee58e19622f79ab2f09.gif

在Demo.ProductManager.Application.Contracts项目Products文件夹下添加产品管理应用服务接口IProductAppService如下:

using System;
using Demo.ProductManager.Products.Dto;
using Volo.Abp.Application.Services;


namespace Demo.ProductManager.Products;


/// 
/// 产品管理应用服务接口
/// 
public interface IProductAppService : ICrudAppService
{


}

58dc6b36fae0eeced609fbc0ee7eb9dc.gif

在Demo.ProductManager.Application项目中添加Products文件夹,添加应用服务类ProductAppService如下:

using System;
using Demo.ProductManager.Products.Dto;
using Volo.Abp.Application.Services;
using Volo.Abp.Domain.Repositories;


namespace Demo.ProductManager.Products;


/// 
/// 产品管理应用服务
/// 
public class ProductAppService:CrudAppService,IProductAppService
{
    public ProductAppService(IRepository repository) : base(repository)
    {
        
    }
}

9d5f751484ef7860c24384783987e673.gif

为方便多个领域下AutoMapper映射关系的管理,我在每个领域单独创建一个静态类,以扩展方法的方式编写当前领域的对象映射关系。例如在当前Products领域中,在Demo.ProductManager.Application项目中Products文件夹下添加静态类ProductAutoMapperProfile如下:

using Demo.ProductManager.Products.Dto;


namespace Demo.ProductManager.Products;


public static class ProductAutoMapperProfile
{
    public static void CreatProductMapper(this ProductManagerApplicationAutoMapperProfile profile)
    {
        profile.CreateMap();
        profile.CreateMap();
    }
}

之后,就可以在ProductManagerApplicationAutoMapperProfile类的ProductManagerApplicationAutoMapperProfile方法中增加以下代码:

this.CreatProductMapper();

bc1736034a4eb25cfb806d8012891021.gif

通常情况,DTO和实体的字段并非完全一一对应,我们需要再映射过程中忽略映射关系的校验,具体方法为将ProductManagerApplicationModule类中ConfigureServices方法下  Configure(options => { options.AddMaps(validate: true); }); 这一句validate参数值改为false

04

其他处理

05af90f0ce3f9bf1443b8d313afdb928.gif

ABP vNext框架Module模式模板默认未开启动态WebAPI,需要我们手动启用动态WebAPI,具体方式为在Demo.ProductManager.HttpApi.Host项目的ProductManagerHttpApiHostModule类ConfigureServices方法中添加以下代码:

Configure(options =>{   options     .ConventionalControllers     .Create(typeof(ProductManagerApplicationModule).Assembly); });

5d6ccd812583e434738ae7a96e077077.gif

通常情况,我们使用的仓储为ABP vNext框架提供的默认仓储实现,我们需要一次性添加所有默认仓储,具体方法为在Demo.ProductManager.EntityFrameworkCore项目中ProductManagerEntityFrameworkCoreModule类的ConfigureServices方法中,找到 context.Services.AddAbpDbContext(…… ,在其中添加options.AddDefaultRepositories();修改为:

context.Services.AddAbpDbContext(options =>{    /* Add custom repositories here. Example:     * options.AddRepository();    */    options.AddDefaultRepositories(); });

f0f709359d01d0c5bb34ad818ecf4e7c.png

完成以上修改后,运行Demo.ProductManager.HttpApi.Host项目并打开http://localhost:5010/swagger/index.html,可显示Swagger页面并包含,Product相关增删改查接口,可通过Swagger页面完成测试。

371bf6eb5a376496211037456e8f23e8.png

end

b8475dcb95a06323ef4a3cec6df5b505.png

ABP vNext微服务架构详细教程——基础服务层_第1张图片

f23a6edbbb5d11bb4f7d8df08fed920d.png

更多精彩

关注我获得

c659f24332281c143b3b5818362949f3.png

你可能感兴趣的:(数据库,java,mysql,linux,大数据)