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.             );
  12.         sampleBooleanFeature.CreateChildFeature(
  13.             AppFeatures.SampleNumericFeature,
  14.             defaultValue: "10",
  15.             displayName: L("Sample numeric feature"),
  16.             inputType: new SingleLineStringInputType(new NumericValueValidator(1, 1000000))
  17.             );
  19.         context.Create(
  20.             AppFeatures.SampleSelectionFeature,
  21.             defaultValue: "B",
  22.             displayName: L("Sample selection feature"),
  23.             inputType: new ComboboxInputType(
  24.                 new StaticLocalizableComboboxItemSource(
  25.                     new LocalizableComboboxItem("A", L("Selection A")),
  26.                     new LocalizableComboboxItem("B", L("Selection B")),
  27.                     new LocalizableComboboxItem("C", L("Selection C"))
  28.                     )
  29.                 )
  30.             );
  31.     }
  33.     private static ILocalizableString L(string name)
  34.     {
  35.         return new LocalizableString(name, AbpZeroTemplateConsts.LocalizationSourceName);
  36.     }
  37. }

注意：
这个输入类型的定义不是被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.     }
  8.     ...
  9. }

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。使用它你会很容易的拥有自己的版本系统，或者你可以自己完全的实现一个。