ABP.VNext-模块

一、什么是ABP.Vnext？

ABP.Vnext是一个基于Asp.Net Core Web应用程序框架。主要目的是用来快速开发Web应用，
ABP.Vnext不仅提供完整Web应用程序开发模板,而且提供Web应用程序开发所需要的一些基础设施功能。

二、什么是Module?

当然每个人看问题的角度不一样,如何能让自己快速理解就先用什么方式吧，从万物皆对象的角度,也可以说万物皆模块,只是需要自己去平衡它的边界。

我自己认为模块就是对所有组件和业务模块的抽象,取的一个名字,例如在OA系统中可以按照业务划分考勤模块,请假模块,员工模块等,也可以按照自己理解的方式去拆分处模块,最终各个不同的模块拼凑在一起协作,形成一个完整的应用程序,方便维护和及快速开发。

三、在ABP中如何使用Module

环境vs2019和.NET5

1.控制台应用程序

1.创建一个控制台应用程序

2.然后Nuget安装Abp.Vnext

Nuget Volo.Abp.Core 

3.然后在控制台项目中创建模块来使用ABP,每一个自定义模块必须继承AbpModule

public class ConsoleModule : AbpModule {  public override void ConfigureServices(ServiceConfigurationContext context)  {      // 1、IOC注册自定义类      System.Console.WriteLine("加载AbpModuleModule模块");            //此处可以用于当前模块注册一些服务      //context.Services.AddSingleton<CustomService>();            //ConsoleHostedService主机服务，需要继承自IHostedService      context.Services.AddHostedService<ConsoleHostedService>();  } } 

4.修改Progarm启动类

 static void Main(string[] args)  {      CreateHostBuilder(args).RunConsoleAsync().Wait();  }    internal static IHostBuilder CreateHostBuilder(string[] args) =>      Host.CreateDefaultBuilder(args)          .ConfigureAppConfiguration()          .ConfigureServices((hostContext, services) =>          {              //应用程序装载自定义模块作为启动模块              services.AddApplication<ConsoleModule>();          }); 

2.Web应用程序

1.创建一个Web应用程序

2.然后Nuget安装Abp.Vnext

Nuget Volo.Abp.Core 

3.然后在WEB项目中创建一个WebModule模块来使用ABP,模块必须继承AbpModule

public class WebModule : AbpModule {      public override void ConfigureServices(ServiceConfigurationContext context){}     public override void OnApplicationInitialization(ApplicationInitializationContext context){} } 

4.在原有Startup类中修改代码

public class Startup {     public void ConfigureServices(IServiceCollection services)     {          //在服务中心注册WebModule为启动项          services.AddApplication<WebModule>();     }          public void Configure(IApplicationBuilder app, IWebHostEnvironment env)     {          //框架初始化应用程序          app.InitializeApplication();     } } 

5.将原有Web中Startup类中的注册服务和配置中间件的内容移到WebModule中

public class WebModule : AbpModule {     //注册服务     public override void ConfigureServices(ServiceConfigurationContext context)     {        context.Services.AddControllers();     }          //应用程序开始时注册中间件     public override void OnApplicationInitialization(ApplicationInitializationContext context)     {        var app = context.GetApplicationBuilder();        var env = context.GetEnvironment();         if (env.IsDevelopment())        {            app.UseDeveloperExceptionPage();        }        app.UseStaticFiles();        app.UseRouting();        app.UseConfiguredEndpoints();     } } 

四、模块依赖注册

1.自定义模块

除了项目启动模块的使用如控制台,web项目等，如果要自定义模块其实也和上述2种使用方式相同,并且更为简单，不需要其他的加载项配置,只需要引入Abp.Vnext继承自AbpModule即可。

创建一个自定义的公共模块

public class CommonModule : AbpModule {     //模块加载时配置一些操作或初始化服务     public override void ConfigureServices(ServiceConfigurationContext context)     {         System.Console.WriteLine("加载自定义CommonModule模块");     } } 

2.模块依赖

假设我在我的控制台项目想要依赖我的公共模块,我应该怎么做呢，传统没有使用ABP的做法是直接引入对应类就可以完成依赖并且使用,但是使用了ABP框架之后,需要在传统的做法上做一些事情，就是在模块类上加入 [DependsOn()]特性即可。

例如我的A模块需要依赖我的B模块

 [DependsOn(typeof(B))] public class A : AbpModule {     public override void ConfigureServices(ServiceConfigurationContext context)     {         System.Console.WriteLine("自定义A模块");     } }  public class B : AbpModule {     public override void ConfigureServices(ServiceConfigurationContext context)     {         System.Console.WriteLine("自定义B模块");     } } 

3.服务注册

首先我们要知道服务和模块是被包含的关系,“模块”包含“服务”

在使用了ABP框架后在模块中注册服务有3种方式

1.在模块类中的ConfigureServices方法中手动注册服务，但是如果服务增多，ConfigureServices方法中将会产生大量的注册代码，需要维护

public class CommonModule : AbpModule {      public override void ConfigureServices(ServiceConfigurationContext context)      {          context.Services.AddTransient<CommonService>();      } } 

2.继承自约束接口例如ITransientDependency,ISingletonDependency，接口约束

public class CommonService:ITransientDependency {     public void Common()     {         System.Console.WriteLine("CommonService 执行");     } } 

3.在需要被注册的服务商使用特性标记[Dependency(ServiceLifetime.Transient)]，推荐使用职责分明

//注册服务生命周期为瞬时 [Dependency(ServiceLifetime.Transient)] public class CommonService {     public void Common()     {         System.Console.WriteLine("CommonService 执行");     } } 

五、插件加载

有时候我们想实现某个标准功能的接口做一个插件模块,按需要手动配置到项目中,需要的时候就给他配置,不需要就去掉配置,而不是像模块依赖一样需要强引用,那这种做法就可以使用abp的插件加载机制

其实原理并不难,知道怎么用后，完全可以自己写一个,我们先给出在ABP中的实现步骤

1.使用vs创建插件项目Common.PlugIn模块

2.然后创建插件目录PlugIns

3.然后将Common.PlugIn.dll复制到PlugIns目录中

4.然后在Console项目中Program加载PlugIns

5.在web项目中就是在Startup注册服务中加入以下代码

services.AddApplication<ConsoleModule>(       options =>           {               options.PlugInSources.AddFolder(@"Plugin");           });        });