zoukankan      html  css  js  c++  java
  • ABP 快速开发框架(.net core vue )

    http://www.mamicode.com/info-detail-3047377.html

    前言

    这两天看了一下ABP,做个简单的学习记录。记录主要有以下内容:

    1. 从官网创建并下载项目(.net core 3.x + vue)
    2. 项目在本地成功运行
    3. 新增实体并映射到数据库
    4. 完成对新增实体的基本增删改查

    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 mytest1update-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,弄清楚他的设计理念以及他的一些实现原理。

    以后有时间的话再深入学习一下。文中如果有不妥之处欢迎指正。

  • 相关阅读:
    sql笔记
    虚函数和抽象类笔记
    构造函数和静态构造函数 笔记
    在与sql server 建立连接时出现与网络相关的或特定于实例的错误
    类型转换 笔记
    test
    document.body和document.documentElement比较
    sql2005 存储过程实现分页
    新闻发布用到的存储过程和触发器
    SQL数据查询实例1
  • 原文地址:https://www.cnblogs.com/ifreesoft/p/13595692.html
Copyright © 2011-2022 走看看