从零开始进行ABP项目开发(十)——总结

好了,我们从一个简单的控制台程序出发,从零开始创建了ABP项目的各个部分,创建了可以对提供服务的服务层和对外的Web Api,基于服务层和Web Api分别创建了简单的多页面应用和单页面应用。下面,把我们在学习过程中的知识点做一个总结。

ABP模块(Module)与模块的初始化

ABP以模块的方式组织应用,每一个模块都继承自AbpModule,模块定义时,可以显示地定义模块之间的依赖关系,这样,在初始化模块时,所依赖的模块也会被初始化。
一个模块典型的定义如下:

using Abp.Modules;
using System.Reflection;

namespace ZL.Poem.Core
{
    public class PoemCoreModule : AbpModule
    {
        public override void Initialize()
        {
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
        }
    }
}

可以使用AbpBootstrapper加载并运行模块:

using (var bootstrapper = AbpBootstrapper.Create<PoemConsoleClientModule>())
    {
        //初始化模块
        bootstrapper.Initialize();

    }

领域层的定义

领域对象季承自Entity,比如:

using Abp.Domain.Entities;

namespace ZL.Poem.Core.Poems
{
    /// <summary>
    /// 诗人,从ABP Entity派生
    /// </summary>
    public class Poet : Entity
    {
        /// <summary>
        /// 姓名
        /// </summary>
        public virtual string Name { get; set; }

        /// <summary>
        /// 介绍
        /// </summary>
        public virtual string Description { get; set; }

    }
}

领域对象的Id字段是固定的,缺省为整型,也可以定义为其它类型。当我们采用EF等框架构建持久化层时,可以通过定义映射领域层与数据库之间的关系。比如:

protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);

            //映射Poet到数据库表
            modelBuilder.Entity<Poet>().ToTable("Poet");

            //映射实体与数据库中的字段,将Id映射到数据库表的PoetID字段
            modelBuilder.Entity<Poet>()
                    .Property(p => p.Id)
                    .HasColumnName("PoetID");
        }

应用层的构建

应用层的服务实现 IApplicationService 接口。通常我们需要定义继承这个接口的服务接口,然后再实现这些自己的服务接口。比如:

using Abp.Application.Services;
using Abp.Application.Services.Dto;

namespace ZL.Poem.Application.Poems
{
    public interface IPoemAppService : IApplicationService
    {
        /// <summary>
        /// 获取诗人分页
        /// </summary>
        /// <param name="dto"></param>
        /// <returns></returns>
        PagedResultDto<PoetDto> GetPagedPoets(PagedResultRequestDto dto);

    }
}

应用层通过DTO与领域层打交道,我们不能对外暴露领域对象。Dto继承自EntityDto,可以使用AutoMap与领域层映射,比如:

using Abp.Application.Services.Dto;
using Abp.AutoMapper;
using ZL.Poem.Core.Poems;

namespace ZL.Poem.Application.Poems
{
    [AutoMapFrom(typeof(Poet))]
    public class PoetDto : EntityDto
    {
        public string Name { get; set; }

        public string Description { get; set; }
    }
}

动态Web Api

ABP可以为服务层动态生成Web Api,在一个Web Api项目中,可以增加一个ABP的模块,动态创建Web Api,比如:

using Abp.Modules;
using System.Reflection;
using ZL.Poem.Application;
using ZL.Poem.EF;

namespace ZL.Poem.WebApi
{
    [DependsOn(typeof(PoemDataModule),
       typeof(PoemApplicationModule),
        typeof(AbpAspNetCoreModule))]
   
    public class PoemWebApiModule : AbpModule
    {
        public override void Initialize()
        {
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());

            //创建动态Web Api
            Configuration.Modules.AbpAspNetCore().CreateControllersForAppServices(typeof(PoemApplicationModule).Assembly, moduleName: "app", useConventionalHttpVerbs: false); 

        }
    }
}

Web Api的接口约定的命名规则是I+服务名称+AppService,比如,IPoemAppService的服务名称为Poem,映射的地址为:

api/services/[moduleName]/[服务名称]/[方法名称]

基于RazorPage的多页面应用

创建基于RazorPage的多页面应用时,可以直接使用服务层,RazorPage的编程模型更为简单,代码结构上有点类似于WebForm:每个页面有一个后台代码文件,但本质上完全不同,后台代码定义了视图模型,与视图之间是松耦合的,也不负责管理页面的状态(WebForm中有ViewState,负责管理回传过程中的页面状态)。

基于Vue.js的单页面应用

可以使用Vistual Studio 创建基于Vue.js的单页面应用。这时,前端的单页面应用和后端的Web Api处于不同的域,会有跨域访问(CORS)的问题,需要启动跨域访问。需要在Startup的ConfigureServices方法中注册cors策略:

services.AddCors(option => option.AddPolicy("cors", policy => policy.AllowAnyHeader().AllowAnyMethod().AllowCredentials().AllowAnyOrigin()));

然后在Configure中使用这个策略

 public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.UseCors("cors");

下一步的工作

在这个系列里,还有一些没有涉及的内容,需要将来进行补充。

  • 权限:权限是应用系统的重要组成部分,同时也是比较复杂的部分,管理权限、认证、授权等等。
  • 集成测试:这个系列里讨论了单元测试,没有涉及集成测试。
  • ABP模块与现有系统的集成:如何将ABP模块与现有的非ABP系统集成。

以上内容,需要单独的专题进行讨论。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,270评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,489评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,630评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,906评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,928评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,718评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,442评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,345评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,802评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,984评论 3 337
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,117评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,810评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,462评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,011评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,139评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,377评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,060评论 2 355

推荐阅读更多精彩内容