初識ABP vNext（8）：ABP特徵管理

xhznl發表於2020-09-04

特徵

Tips：本篇已加入系列文章閱讀目錄，可點選檢視更多相關文章。

前言

上一篇提到了ABP功能管理（特徵管理），它來自ABP的FeatureManagement模組，ABP官方文件貌似還沒有這個模組的相關說明，但是個人感覺這個模組非常實用，下面就簡單介紹一個特徵管理的基本應用。

開始

在租戶管理中，有一個“管理功能”按鈕，預設是沒有資料的，介面上也沒有地方維護。

特徵管理簡單來說就是在同一套系統中為不同的租戶提供一些差異化的功能。比如免費使用者，提供的是基礎功能，VIP使用者則會多一些高階功能。

定義特徵

在Application.Contracts專案中新增Features資料夾。

src\Xhznl.HelloAbp.Application.Contracts\Features\HelloAbpFeatures.cs：

public class HelloAbpFeatures
{
    public const string GroupName = "HelloAbp";

    public const string SocialLogins = GroupName + ".SocialLogins";
    public const string UserCount = GroupName + ".UserCount";
}

src\Xhznl.HelloAbp.Application.Contracts\Features\HelloAbpFeatureDefinitionProvider.cs：

public class HelloAbpFeatureDefinitionProvider : FeatureDefinitionProvider
{
    public override void Define(IFeatureDefinitionContext context)
    {
        var group = context.AddGroup(HelloAbpFeatures.GroupName);

        group.AddFeature(HelloAbpFeatures.SocialLogins, "true", L("Feature:SocialLogins")
            , valueType: new ToggleStringValueType());
        group.AddFeature(HelloAbpFeatures.UserCount, "10", L("Feature:UserCount")
            , valueType: new FreeTextStringValueType(new NumericValueValidator(1, 1000)));
    }

    private static LocalizableString L(string name)
    {
        return LocalizableString.Create<HelloAbpResource>(name);
    }
}

以上程式碼新增了2個特徵：SocialLogins，UserCount。

SocialLogins（社交登入），valueType為ToggleStringValueType，意味著它是個勾選框，預設值為"true"。

UserCount（使用者數量），valueType為FreeTextStringValueType，意味著它是個輸入框，預設值為"10"。

現在可以為不同租戶設定不同的特徵值。

應用特徵

特徵值定義好了，接下來就是如何應用了，首先看一下使用者數量如何控制。

使用者數量

目前使用者是通過/identity/users介面來新增的，那麼我們重寫這個介面對應的服務方法就好了。關於重寫服務可以參考：重寫服務

對應的ABP原始碼在：abp\modules\identity\src\Volo.Abp.Identity.Application\Volo\Abp\Identity\IdentityUserAppService.cs中。

在我們的Application專案中新增一個服務類繼承IdentityUserAppService，重寫CreateAsync方法，使用FeatureChecker獲取到特徵值，然後做個使用者數量校驗即可。

src\Xhznl.HelloAbp.Application\Identity\HelloIdentityUserAppService.cs：

[RemoteService(IsEnabled = false)]
[Dependency(ReplaceServices = true)]
[ExposeServices(typeof(IIdentityUserAppService), typeof(IdentityUserAppService))]
public class HelloIdentityUserAppService : IdentityUserAppService, IHelloIdentityUserAppService
{
    private readonly IStringLocalizer<HelloAbpResource> _localizer;

    public HelloIdentityUserAppService(IdentityUserManager userManager,
        IIdentityUserRepository userRepository,
        IIdentityRoleRepository roleRepository,
        IStringLocalizer<HelloAbpResource> localizer) : base(userManager, userRepository, roleRepository)
    {
        _localizer = localizer;
    }

    public override async Task<IdentityUserDto> CreateAsync(IdentityUserCreateDto input)
    {
        var userCount = (await FeatureChecker.GetOrNullAsync(HelloAbpFeatures.UserCount)).To<int>();
        var currentUserCount = await UserRepository.GetCountAsync();
        if (currentUserCount >= userCount)
        {
            throw new UserFriendlyException(_localizer["Feature:UserCount.Maximum", userCount]);
        }

        return await base.CreateAsync(input);
    }
}

下面可以將某租戶的使用者數量設定一下，測試是否有效果：