http://www.mamicode.com/info-detail-3047377.html
前言
这两天看了一下ABP,做个简单的学习记录。记录主要有以下内容:
- 从官网创建并下载项目(.net core 3.x + vue)
- 项目在本地成功运行
- 新增实体并映射到数据库
- 完成对新增实体的基本增删改查
ABP官网:https://aspnetboilerplate.com/
Github:https://github.com/aspnetboilerplate
创建项目
进入官网
Get started,选择前后端技术栈,我这里就选.net core 3.x和vue。
填写自己的项目名称,邮箱,然后点create my project就可以下载项目了。
解压文件
运行项目
后端项目
首先运行后端项目,打开/aspnet-core/MyProject.sln
改一下MyProject.Web.Host项目下appsettings.json的数据库连接字符串,如果本地安装了mssql,用windows身份认证,不改也行
数据库默认是使用mssql的,当然也可以改其他数据库。
将MyProject.Web.Host项目设置为启动项,打开程序包管理器控制台,默认项目选择DbContext所在的项目,也就是MyProject.EntityFrameworkCore。执行update-database
数据库已成功创建:
Ctrl+F5,不出意外,浏览器就会看到这个界面:
前端项目
后端项目成功运行了,下面运行一下前端项目,先要确保本机有nodejs环境并安装了vue cli,这个就不介绍了。
/vue目录下打开cmd执行:npm install
install完成后执行:npm run serve
打开浏览器访问http://localhost:8080/,不出意外的话,会看到这个界面:
使用默认用户 admin/123qwe 登录系统:
至此,前后端项目都已成功运行。
那么基于abp的二次开发该从何下手呢,最简单的,比如要增加一个数据表,并且完成最基本CRUD该怎么做?
新增实体
实体类需要放在MyProject.Core项目下,我新建一个MyTest文件夹,并新增一个Simple类,随意给2个属性。
我这里继承了abp的Entity类,Entity类有主键ID属性,这个泛型int是指主键的类型,不写默认就是int。abp还有一个比较复杂的FullAuditedEntity类型,继承FullAuditedEntity的话就有创建时间,修改时间,创建人,修改人,软删除等字段。这个看实际情况。
public class Simple : Entity<int>
{
public string Name { get; set; }
public string Details { get; set; }
}
修改MyProject.EntityFrameworkCore项目的/EntityFrameworkCore/MyProjectDbContext:
public class MyProjectDbContext : AbpZeroDbContext<Tenant, Role, User, MyProjectDbContext>
{
/* Define a DbSet for each entity of the application */
public DbSet<Simple> Simples { get; set; }
public MyProjectDbContext(DbContextOptions<MyProjectDbContext> options)
: base(options)
{
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
base.OnModelCreating(modelBuilder);
modelBuilder.Entity<Simple>(p =>
{
p.ToTable("Simples", "test");
p.Property(x => x.Name).IsRequired(true).HasMaxLength(20);
p.Property(x => x.Details).HasMaxLength(100);
});
}
}
然后就可以迁移数据库了,程序包管理器控制台执行:add-migration mytest1
,update-database
刷新数据库,Simples表已生成:
实体的增删改查
进入MyProject.Application项目,新建一个MyTest文件夹
Dto
CreateSimpleDto,新增Simple数据的传输对象,比如ID,创建时间,创建人等字段,就可以省略
public class CreateSimpleDto
{
public string Name { get; set; }
public string Details { get; set; }
}
PagedSimpleResultRequestDto,分页查询对象
public class PagedSimpleResultRequestDto : PagedResultRequestDto
{
/// <summary>
/// 查询关键字
/// </summary>
public string Keyword { get; set; }
}
SimpleDto,这里跟CreateSimpleDto的区别就是继承了EntityDto,多了个ID属性
public class SimpleDto : EntityDto<int>
{
public string Name { get; set; }
public string Details { get; set; }
}
SimpleProfile,用来定义AutoMapper的映射关系清单
public class SimpleProfile : Profile
{
public SimpleProfile()
{
CreateMap<Simple, SimpleDto>();
CreateMap<SimpleDto, Simple>();
CreateMap<CreateSimpleDto, Simple>();
}
}
Service
注意,类名参考abp的规范去命名。
ISimpleAppService,Simple服务接口。我这里继承IAsyncCrudAppService,这个接口中包含了增删改查的基本定义,非常方便。如果不需要的话,也可以继承IApplicationService自己定义
public interface ISimpleAppService : IAsyncCrudAppService<SimpleDto, int, PagedSimpleResultRequestDto, CreateSimpleDto, SimpleDto>
{
}
SimpleAppService,Simple服务,继承包含了增删改查的AsyncCrudAppService类,如果有需要的话可以override这些增删改查方法。也可以继承MyProjectAppServiceBase,自己定义。
public class SimpleAppService : AsyncCrudAppService<Simple, SimpleDto, int, PagedSimpleResultRequestDto, CreateSimpleDto, SimpleDto>, ISimpleAppService
{
public SimpleAppService(IRepository<Simple, int> repository) : base(repository)
{
}
/// <summary>
/// 条件过滤
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
protected override IQueryable<Simple> CreateFilteredQuery(PagedSimpleResultRequestDto input)
{
return Repository.GetAll()
.WhereIf(!input.Keyword.IsNullOrWhiteSpace(), a => a.Name.Contains(input.Keyword));
}
}
接口测试
重新运行项目,不出意外的话,Swagger中就会多出Simple相关的接口。
- Create
- Get
- GetAll
- Update
- Delete
总结
ABP是一个优秀的框架,基于ABP的二次开发肯定会非常高效,但前提是需要熟练掌握ABP,弄清楚他的设计理念以及他的一些实现原理。
以后有时间的话再深入学习一下。文中如果有不妥之处欢迎指正。