聊一聊ABP vNext的模块化系统

  • 官网

    https://abp.io/

  • 开源

    https://github.com/abpframework/abp 

  • EasyAbp

    https://easyabp.io/

  • Abp 模块

    https://abp.io/packages

模块化系统

ABP vNext 的世界观

在 Abp vNext 框架里面,模块系统是整个框架的基石,了解了模块系统以后,对于剩下的设计就很好理解了。

模块系统是就像上图乐高玩具一样,一块一块零散积木堆积起一个精彩的世界。每种积木的形状各不相同,功能各不相同,积木与积木直接互相依赖,互相支撑。

模块分两种类型. 它们没有任何结构上的差异,只是按照功能和目地分类:

  • 框架模块:这些是框架的核心模块,像缓存、邮件、主题、安全性、序列化、验证、Ef Core集成、MongoDB集成...等等。它们没有应用程序/业务功能,但通过提供通用基础架构,集成和抽象会使你的日常开发更加容易。

  • 应用程序模块:这些模块是实现特定的应用程序/业务功能,像 博客、文档管理、身份管理、租户管理... 等等。它是通常有自己的实体,服务,API和UI组件。

怎么使用模块?

Abp vNext 框架中这些模块怎么像积木一样互相拼装呢?

模块之间的拼装只有三步:

  • 第一步:建立模块直接的依赖关系,可以通过 DependsOnAttribute 特性来确定依赖关系。

  • 第二步:先配置模块,实现为模块填充数据和功能设置。

  • 第三步:使用模块提供的功能(接口)。通过功能接口来实现模块拼装。

public class Startup
{
      public void ConfigureServices(IServiceCollection services)
      {
          services.AddApplication<AppModule>(); //配置启动的 Abp模块
      }
      public void Configure(IApplicationBuilder app)
      {
          app.InitializeApplication(); //初始化 Abp模块
      }
  }

怎么自定义模块?

Abp vNext 规定每个模块都应该定义一个模块类并且继承 AbpModule 抽象类。

  • 通过 DependsOnAttribute 特性来关联需要使用的模块。

  • 通过重写 OnApplicationInitialization方法来初始化模块。也可以配置 AspNetCore 处理管道。

  • 通过重写 ConfigureServices 方法来配置模块。

[DependsOn(typeof(ModuleThree.ModuleThreeModule))]
[DependsOn(typeof(ModuleOne.ModuleOneModule))]
[DependsOn(typeof(AbpAspNetCoreMvcModule))]
public class AppModule : AbpModule
{


    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        // 配置依赖注入
    }


    public override void 
OnApplicationInitialization(ApplicationInitializationContext context)
    {
        var app = context.GetApplicationBuilder();
        var env = context.GetEnvironment();
        app.UseStaticFiles();
        app.UseRouting();
        app.UseConfiguredEndpoints();
    }
}

AbpModule 深度剖析

ABP 系统在启动的时候才会通过反射扫描所有模块,每个模块可以通过 DependsOnAttribute 特性来确定依赖关系,使用拓扑排序算法,来根据依赖性确定模块的加载顺序。(从最深层的模块依次加载,直到启动所有模块)。

AbpModule 的提供一些方法来管理模块的生命周期。

  • ConfigureServices:是将你的服务添加到依赖注入系统并配置其他模块的主要方法。

  • OnApplicationInitialization:初始化配置的所有模块的所有服务。

  • OnApplicationShutdown:如果要在应用程序关闭时执行。

  • ... 还有其他方法用的不多,下面流程图会有简单说明。

下面这个流程图简单阐述 AbpModule 提供的方法之间的执行顺序。

AbpModule 类源代码:

https://github.com/abpframework/abp/blob/dev/framework/src/Volo.Abp.Core/Volo/Abp/Modularity/AbpModule.cs

举一个定时发邮件例子来说明这三个方法用处。

  • 自定义了一个定时发邮件模块 SendMailModule 模块并且继承 AbpModule 。

  • 在 ConfigureServices 方法中配置定时发送的时间和发送邮箱的地址,邮件模块信息等。

  • 配置好模块之后,在 OnApplicationInitialization方法中启动定时器,进行定时发送邮件。

  • 当系统停止后需要提醒运维人员,在 OnApplicationShutdown 方法中发送一封邮件给运维人员。

ABP 模块化依赖价值流程

下面日志阐述AbpModule 提供的方法在有模块依赖的情况下之间的执行顺序。

上图的执行顺序的演示代码:

AbpModuleDemo.7z

总结

Abp vNext 是一个模块化设计,提供了高扩展性、高可用性、高效率开发框架。要实现高效率前提还需要熟练了解使用 Abp 中的所有模块功能。通过模块设计也可以很快定制一下功能以及更好的单元测试。

Abp vNext 模块设计是直接采用 Asp.NetCore 的原有功能,扩展了 Startup.ConfigureServices 和 Startup.Configure 方法,把方便我们在开发模块的时候直接使用 IServiceCollection 和 IApplicationBuilder

模块设计原则

  • 单一原则。每个模块只有一个功能,有着清晰的边界,实现高度解耦和高度可复用性。

  • DDD领域设计。通过领域设计思想确定模块的领域边界,避免模块化过于细化导致增加复杂程度。

模块使用常见问题

  • 模块化过于细化,很容易陷入模块的迷宫中。导致学习成本暴增。

  • 模块功能文档不清晰,使用起来问题频出。

  • 模块之间的过于依赖,对模块设计和功能不了解时,很难定位问题。

引用

  • Abp vNext 源码分析

    https://www.cnblogs.com/myzony/p/10722506.html

  • 官方文档

    https://docs.abp.io/zh-Hans/abp/latest/Module-Development-Basics

转载是一种动力 分享是一种美德

作者:阿凌

【版权声明】作品来自于长沙.NET技术社区成员【阿凌】,有兴趣了解长沙.NET技术社区详情,请关注公众号【DotNET技术圈】,作品版权归作者和博客园共有,作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

QQ群:

编程交流群<85318032> 

产品交流群<897857351>

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章