4.5 ABP应用层 - 功能管理

4.5.1 简介

大多数的SaaS(多租户) 应用拥有多个版本并且这些版本的功能各不相同。因此,他们能为客户提供不同的价格和功能选项。

我们可以很容易的用ABP来实现这个功能管理系统。我们能定义一些功能,检查功能是否为租户开启。这个就像ABP的设计思想(例如权限和菜单设计)。

关于 IFeatureValueStore

我们可以利用 IFeatureValueStore获取功能值。在module-zero项目里面已有了全部实现,当然你也能用自己的方式来扩展它们。如果没有实现该接口,NullFeatureValueStore (默认实现)会被使用,它会为所有功能值返回null(默认值将会被用在这个案例中)。

4.5.2 功能类型

系统已有两个基本的功能类型。

1. Boolean 功能

可以是true或者false。利用这个类型我们可以为租户启用(enable)或者禁用(disable)某些功能。

2. Value 功能

可以为任意值。我们可以用它来存储并者取得一个字符串,我们也可以很容易的用数字作为字符串来存储。

例如,我们有一个任务管理系统,可以限制一个月内的任务创建数量的需求。那么我们可以根据需求创建两个版本系统;一个是每个月允许创建1000个任务,而另外一个是每个月允许创建5000个任务。所以,这个功能应该用Value类型来存储,而不是用简单的Boolean类型(true或者false)。

3. 定义功能

功能应该在检查之前被定义。模块可以定义它自己的功能,通过从FeatureProvider 派生。下面代码为我们展示了一个非常简单的具有3个功能的功能提供器。

  1. public class AppFeatureProvider : FeatureProvider
  2. {
  3. public override void SetFeatures(IFeatureDefinitionContext context)
  4. {
  5. var sampleBooleanFeature = context.Create("SampleBooleanFeature", defaultValue: "false");
  6. sampleBooleanFeature.CreateChildFeature("SampleNumericFeature", defaultValue: "10");
  7. context.Create("SampleSelectionFeature", defaultValue: "B");
  8. }
  9. }

在创建了功能提供器后,我们应该在我们的模块方法 PreInitialize中注册它。如下所示:

  1. Configuration.Features.Providers.Add<AppFeatureProvider>();

4. 基本功能属性

定义功能至少需要两个属性:

  • Name:用来区分功能的唯一标识符(string类型);

  • Default value:默认值。当我们需要这个功能值的时候我们就会用到它,并且该值对当前租户是不可用的。

在这里,我们定义了一个叫做SampleBooleanFeature的boolean类型的功能,默认值是false(禁用)。
我们还定义了两个value类型的功能(SampleNumericFeature 是SampleBooleanFeature的子功能)。

建议:
创建字符串常量的功能名称并且我们可以在任何地方使用它,还可以有效避免功能名称输入错误(记忆力有时候不行咯)。

5. 其它功能属性

唯一标识(name)和默认值属性已经足够满足需求了,但这里还有一些其它的属性来满足更细粒化的控制需求。

  • Scope:枚举类型FeatureScopes的某个值 ,可以是Edition (如果该功能只对Edition 等级的用户开放),Tenant(如果该功能仅对Tenant等级的用户开放)或者All(All等级可以拥有Edition和Tenant等级的所有功能,但是租户的设置会覆盖版本的设置);默认设置是All级别。

  • DisplayName:本地化字符串,向用户展示功能名称。

  • Description:本地化字符串,向用户的详细描述该功能。

  • InputType:UI层的输入类型(控件类型:Checkbox, Combobox等)。

  • Attributes:与功能相关的自定义任意类型的数据字典。

下面代码详细展示了如何使用上面所描述的属性

  1. public class AppFeatureProvider : FeatureProvider
  2. {
  3. public override void SetFeatures(IFeatureDefinitionContext context)
  4. {
  5. var sampleBooleanFeature = context.Create(
  6. AppFeatures.SampleBooleanFeature,
  7. defaultValue: "false",
  8. displayName: L("Sample boolean feature"),
  9. inputType: new CheckboxInputType()
  10. );
  11. sampleBooleanFeature.CreateChildFeature(
  12. AppFeatures.SampleNumericFeature,
  13. defaultValue: "10",
  14. displayName: L("Sample numeric feature"),
  15. inputType: new SingleLineStringInputType(new NumericValueValidator(1, 1000000))
  16. );
  17. context.Create(
  18. AppFeatures.SampleSelectionFeature,
  19. defaultValue: "B",
  20. displayName: L("Sample selection feature"),
  21. inputType: new ComboboxInputType(
  22. new StaticLocalizableComboboxItemSource(
  23. new LocalizableComboboxItem("A", L("Selection A")),
  24. new LocalizableComboboxItem("B", L("Selection B")),
  25. new LocalizableComboboxItem("C", L("Selection C"))
  26. )
  27. )
  28. );
  29. }
  30. private static ILocalizableString L(string name)
  31. {
  32. return new LocalizableString(name, AbpZeroTemplateConsts.LocalizationSourceName);
  33. }
  34. }

注意:
这个输入类型的定义不是被ABP使用,ABP提供这些选项让我们能够更便捷的来创建我们所需要的功能。

4.5.3 功能层次

正如上面示例所展示的,功能可以有子功能。父功能通常被定义为boolean类型的功能,如果父功能被启用,那么子功能将会是可用的。ABP不会强制这样使用,但是建议你这样使用。

4.5.4 功能检测

在系统中我们定义这些功能,是用来检测这些功能是否应该对每个用户(租户)启用(允许)或者禁用(阻止)。我们可以用不同的方法来检测它们。

2. 使用RequiresFeature特性

我们可以在类或者方法上面用RequiresFeature特性,如下所示:

  1. [RequiresFeature("ExportToExcel")]
  2. public async Task<FileDto> GetReportToExcel(...)
  3. {
  4. ...
  5. }

如果ExportToExcel功能为当前租户(从IAbpsession获取当前租户)启用,那么这个方法会被执行;如果没有被启用,那么将会自动的抛出一个AbpAuthorizationException 异常。

当然RequiresFeature特性应该使用的是boolean类型功能 ,否则你会得到一个异常。

  • 不能用在一个私有方法上

  • 不能用在一个静态方法上

  • 不能用在一个非注入类的方法上(我们必须使用Dependency Injection).

还有:

  • 可以用在任何public方法上,如果这个方法是通过扩展接口来实现的(就像Application Services扩展指定接口一样)

  • 方法应该是virtual方法,如果被直接从类引用中调用(就像 ASP.NET MVC 或者 Web API Controllers)。

  • 方法应该是virtual方法,如果它是一个protected.

3. 使用IFeatureChecker

我们可以注入和使用IFeatureChecker接口来手动的检测功能(它是被自动注入,并对Application Services,MVC和Web API Controllers 直接可用)。

4. IsEnabled

可以简单的检测,如果给出的功能是启用或者禁用。如下所示:

  1. public async Task<FileDto> GetReportToExcel(...)
  2. {
  3. if (await FeatureChecker.IsEnabledAsync("ExportToExcel"))
  4. {
  5. throw new AbpAuthorizationException("You don't have this feature: ExportToExcel");
  6. }
  7. ...
  8. }

IsEnabledAsync 还有其他的方法也有同步版本。

当然,IsEnabled方法应该使用booean类型功能。否则,你会得到一个异常。

正如示例所示,如果你只是想检测功能并且抛出异常,你只需要使用CheckEnabled方法。

5. GetValue

获取当前功能的值并且转换为所需类型,如下所示:

  1. var createdTaskCountInThisMonth = GetCreatedTaskCountInThisMonth();
  2. if (createdTaskCountInThisMonth >= FeatureChecker.GetValue("MaxTaskCreationLimitPerMonth").To<int>())
  3. {
  4. throw new AbpAuthorizationException("You exceed task creation limit for this month, sorry :(");
  5. }

6. 客户端

在客户端,我们能使用abp.features命名空间去取得当前功能的值。

isEnabled

  1. var isEnabled = abp.features.isEnabled('SampleBooleanFeature');

getValue

  1. var value = abp.features.getValue('SampleNumericFeature');

4.5.5 功能管理

如果你需要定义一些功能,你可以注入和使用IFeatureManager。

4.5.6 版本须知

ABP没有建立版本系统,因为这样一个系统需要数据库支持(存储版本,版本功能,租客版映射等等)。因此,版本系统被实现在module zero。使用它你会很容易的拥有自己的版本系统,或者你可以自己完全的实现一个。