.NET Core之 ABP从入门到精通

ABP是一套基于WEB的快速开发引用框架，和DDD领域驱动开发有很好的结合。
主要特性：模块化，多租户，认证授权，虚拟文件系统，主题系统，后台作业，事件总线，对象映射，依赖注入，数据过滤等。
接下来用代码的方式介绍ABP框架的使用。

一.VS创建一个ABP控制台程序打出Hello word!

1.首先引入框架包

Nuget中安装volo.abp.core
2.创建模块
所谓的ABP模块在代码中体现就是类，我们创建一个HelloABPModule的类，然后引入using Volo.Abp.Modularity;

using Volo.Abp.Modularity;namespace HelloABP
{public class HelloABPModule:AbpModule{}
}

这样就创建好了一个最简单的ABP模块。模块一般不写业务逻辑。

3.我们创建一个服务
创建一个HelloWorldService用于书写业务逻辑。

using Volo.Abp.DependencyInjection;namespace HelloABP
{public class HelloWorldService:ITransientDependency{public void Run() {Console.WriteLine("Hello world!");}}
}

ABP可以按照约定去实现自己的依赖注入，也可以通过接口的形式去实现注入。我们引入using Volo.Abp.DependencyInjection;然后继承ITransientDependency这样我们就用注入了周期为瞬时的HelloWorldService进入了我们IOC容器。

手动注入服务
上面是自动注入服务的方式，接着看下手动注入的方式，手动注入服务的方式和我们直接在Statup中注入是一样的。


using Volo.Abp.Modularity;
//添加注入服务
using Microsoft.Extensions.DependencyInjection;namespace HelloABP
{public class HelloABPModule:AbpModule{public override void ConfigureServices(ServiceConfigurationContext context){context.Services.AddTransient<HelloWorldService>();}}
}

我们在HelloABPModule启动模块类进行注入就行，注入方式和原生注入一样。

4.使用
在MAIN方法中创建启动模块。

using System;
using Volo.Abp;
using Microsoft.Extensions.DependencyInjection;
namespace HelloABP
{class Program{static void Main(string[] args){//创建启动模块，一般一个项目只有一个启动模块，var application = AbpApplicationFactory.Create<HelloABPModule>();//初始化application.Initialize();//调用服务var service = application.ServiceProvider.GetService<HelloWorldService>();service.Run();}}
}

这样一个最简单的ABP应用就跑起来了。

二.创建一个ASP.Net Core应用。

1.安装依赖包

abp.aspnetcore.mvc该包已经包含了第一部分的基础包，如果做WEB开发，安装这一个包就够了。

![在这里插入图片描述](https://img-blog.csdnimg.cn/97546ce9f411454187db272c9e204f8a.jpeg
2.创建应用启动模块
配置启动中间件管道，因为用了ABP进行项目启动，就不需要再用Statup类进行中间件配置了。
我们创建一个ABP模块类APPModule代码如下：

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Hosting;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Volo.Abp;
using Volo.Abp.AspNetCore.Mvc;
using Volo.Abp.Modularity;namespace WebApplication1
{//DependsOn注解可以定义在类和方法上，意思是我这个组件要依赖于另一个组件，也就是说被依赖的组件会比该组件先注册到IOC容器中。[DependsOn(typeof(AbpAspNetCoreMvcModule))]public class APPModule:AbpModule{public override void OnApplicationInitialization(ApplicationInitializationContext context){// 直接从根容器获取     //等同于Statup类Configure方法中的参数一var app = context.GetApplicationBuilder();//等同于Statup类Configure方法中的参数二var env = context.GetEnvironment();if (env.IsDevelopment()){app.UseDeveloperExceptionPage();}else{app.UseExceptionHandler("/Error");app.UseHsts();}app.UseHttpsRedirection();app.UseStaticFiles();app.UseRouting();app.UseAuthorization();app.UseEndpoints(endpoints =>{endpoints.MapRazorPages();});}}
}

上面大部分代码都是Statup类中配置中间件的代码，我们把Statup中Configure方法中的中间件全部写到了ABP启动模块中，原来的Configure只需要写启动模块的初始化代码就行了。

3.注入ABP启动模块和初始化
打开Statup类，代码如下:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.HttpsPolicy;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;namespace WebApplication1
{public class Startup{public Startup(IConfiguration configuration){Configuration = configuration;}public IConfiguration Configuration { get; }// This method gets called by the runtime. Use this method to add services to the container.public void ConfigureServices(IServiceCollection services){services.AddRazorPages();//注入ABP模块services.AddApplication<APPModule>();}// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.public void Configure(IApplicationBuilder app, IWebHostEnvironment env){//初始化模块app.InitializeApplication();}}
}

这2句注释的代码，和标题一中的控制台程序Mian方法的代码是一个意思，先注入服务，再初始化。这样我们就配置好了web应用的APB配置。接下来的业务操作，和控制台都是一样的了。

4.在ABP中使用控制器
创建一个控制器，代码如下：

using Microsoft.AspNetCore.Mvc;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Volo.Abp.AspNetCore.Mvc;namespace WebApplication1.Controllers
{//需要继承ABP的控制器public class HellloController:AbpController{public IActionResult Index() {return Content("Hello world");}}
}

并且需要把APPModule终结点的配置换成默认的，代码如下：

            //app.UseEndpoints(endpoints =>//{//    endpoints.MapRazorPages();//});//配置为默认app.UseConfiguredEndpoints();

这样我们就可以用ABP访问控制器了。

三.模块的生命周期。

ABP模块生命周期就三步：配置，初始化，销毁。
配置分为配置前，和配置后。
我们点进去AbpModule可以看到Pre和Post这类方法，只要带Pre的就是操作之前的，Post为该方法操作之后的。
服务配置前

  public virtual void PreConfigureServices(ServiceConfigurationContext context);

配置之后

  public virtual void PostConfigureServices(ServiceConfigurationContext context);

初始化

 public virtual void OnApplicationInitialization(ApplicationInitializationContext context);

程序结束做的事情

 public virtual void OnApplicationShutdown(ApplicationShutdownContext context);

上面都是虚方法，自己有需要的业务可以重写。

四.ABP模块中的预配置选项。

预配置作用，就是在你做配置之前使用的。
首先创建一个MyModulePreOptions类，

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;namespace HelloABP
{public class MyModulePreOptions{public bool IsEnable { get; set; }public string Name { get; set; }}
}

然后我们在ABP模块中进行选项预配置，直接上代码

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Volo.Abp.Modularity;
//添加注入服务
using Microsoft.Extensions.DependencyInjection;namespace HelloABP
{public class HelloABPModule:AbpModule{public override void PreConfigureServices(ServiceConfigurationContext context){PreConfigure<MyModulePreOptions>(options=>options.IsEnable=true);}public override void ConfigureServices(ServiceConfigurationContext context){//获取预配置后的信息var preOptions = context.Services.ExecutePreConfiguredActions<MyModulePreOptions>();if (preOptions.IsEnable) {Configure<MyModulePreOptions>(options =>options.Name="Hello Abp");}// context.Services.AddTransient<HelloWorldService>();}}
}

接着调用一下。

using Microsoft.Extensions.Options;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Volo.Abp.DependencyInjection;namespace HelloABP
{public class HelloWorldService:ITransientDependency{private readonly IOptions<MyModulePreOptions> _options;public HelloWorldService(IOptions<MyModulePreOptions> options){_options = options;}public void Run() {Console.WriteLine(_options.Value.Name??"选项未配置");}}
}

结果：

我们可以在预配置环节，对你需要配置的类进行属性初始化，然后我们在启动配置那块，调用你预配置好的类，然后做一些业务处理。