X-Admin&ABP框架开发-版本管理

Posted ckexp

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了X-Admin&ABP框架开发-版本管理相关的知识,希望对你有一定的参考价值。

  多租户系统中,针对于不同租户开放不同功能,或是按照不同功能进行收费管理,需要从宿主本身去管理租户的版本信息,如同酒店人员对不同房间收取不同费用,依据房间内部设施,房间大小等设置不同收费标准。Abp系统中默认是多租户的,并且在Zero模块中实现了版本管理功能。 

   演示地址:http://119.3.138.127/,更改Account/HostLogin进入宿主管理

 

一、设计前提

  基于Abp进行了相关限制,我将多租户变成了单租户,不允许添加新的租户,由于日常接触中,发现除了云平台这种SaaS需要多租户,对于企业客户来讲,自备物理服务器或自购云服务器是常有的事情,因此对于该部分客户而言,多租户也就没有太多意义,但是从软件公司本身考虑,一套软件能够销售多家客户,能够通过简单配置,开放关闭某些功能,以此来适应客户功能需求,是最佳选项了。因此对于这两种情况考虑后,对于本系统而言,采用的是单租户+宿主形式的,企业客户使用单租户,宿主形式留给软件公司方便配置单租户实际需要的功能。

  在Zero中,已经默认实现了版本管理,但是对于非收费版本的页面管理,应用服务等没有具体代码实现。

 

二、版本管理

1、应用层增加版本应用服务,对于版本需要进行的用户操作归纳为三个。

  • 可查看现有版本列表;
  • 可对现有版本信息及版本拥有的功能项进行编辑更改;
  • 可增加或是删除版本;
/// <summary>
/// 版本管理应用服务接口
/// </summary>
public interface IEditionAppService : IApplicationService
{
    /// <summary>
    /// 获取全部版本列表
    /// </summary>
    /// <returns></returns>
    Task<ListResultDto<EditionListDto>> GetEditionsList();

    /// <summary>
    /// 获取版本用于编辑
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task<GetEditionForEditOutput> GetEditionForEdit(NullableIdDto input);

    /// <summary>
    /// 创建或更新版本
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task CreateOrUpdateEdition(CreateOrUpdateEditionInput input);

    /// <summary>
    /// 删除版本
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task DeleteEdition(EntityDto input);

    /// <summary>
    /// 租户更换版本
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task MoveTenantsToAnotherEdition(MoveTenantsToAnotherEditionDto input);
}

2、实现应用服务

实现版本应用服务接口,以创建版本为例,顶部权限验证,增加版本信息,并且设置该版本所拥有的功能项,对于版本领域服务,Zero模块提供了完整实现AbpEditionManager,只需调用即可。

[AbpAuthorize(PermissionNames.Pages_Frame_Editions_Create)]
private async Task CreateEdition(CreateOrUpdateEditionInput input)
{
    var edition = ObjectMapper.Map<Edition>(input.Edition);

    await _editionManager.CreateAsync(edition);
    await CurrentUnitOfWork.SaveChangesAsync();

    await SetFeatureValues(edition, input.FeatureValues);
}

private Task SetFeatureValues(Edition edition, List<NameValueDto> featureValues)
{
    return _editionManager.SetFeatureValuesAsync(edition.Id, featureValues.Select(fv => new NameValue(fv.Name, fv.Value)).ToArray());
}

3、控制器中增加版本管理控制器并设计相应的方法(逐渐认识到,能够使用Dto的尽量使用Dto),控制器部分主要承担路由功能,将前端请求转发到应用服务、领域服务中。

技术图片

 4、页面层实现,列表展示+弹框添加/编辑,弹框内展示出功能项树结构,供版本配置需要的功能项。

技术图片

 5、页面功能展示,列表展示现有版本,因考虑到版本数量不会很多,无需分页也无需条件查询。该部分菜单仅对宿主提供

技术图片

 

三、版本功能管理

   对于功能项,ABP框架中采用声明式,现在领域层中声明具体的功能项,在代码中,依照当前租户是否存在声明的某个功能项去决定是否执行某个功能,

1、功能项声明,在Core层->Features文件夹中声明该系统拥有的功能,需要对租户进行控制划分的。如客户服务模块,对于小部分企业客户而言,可能不需要该模块,则可通过对客户服务模块进行功能控制,页面上,代码中该部分功能都会绕过去。

/// <summary>
/// 功能管理
/// </summary>
public static class AppFeatures
{
    public const string HostSettings = "App.HostSettings";

    public const string CustomerService = "App.CustomerService";
}

2、功能绑定到系统中,在Features文件夹中,AppFeatureProvider负责将声明的功能绑定到系统中,可以对功能项进行默认设置,如对于客户服务要默认为都具有,可以更改defaultValue设置为true,具体更丰富的设计查看Abp提供的重载方法。可对功能项进行树结构设计。

/// <summary>
/// 功能设置提供器
/// </summary>
public class AppFeatureProvider : FeatureProvider
{
    public override void SetFeatures(IFeatureDefinitionContext context)
    {
        var hostSettings = context.Create(
            AppFeatures.HostSettings,
            defaultValue: "false",
            displayName: L("HostSettings"),
            inputType: new CheckboxInputType()
        );

        var customerService = context.Create(
            AppFeatures.CustomerService,
            defaultValue: "false",
            displayName: L("CustomerService"),
            inputType: new CheckboxInputType()
        );

        var customerServiceMaps = customerService.CreateChildFeature(
            AppFeatures.CustomerService_Maps,
            defaultValue: "false",
            displayName: L("CustomerServiceMaps"),
            inputType: new CheckboxInputType()
        );
    }

    private ILocalizableString L(string name)
    {
        return new LocalizableString(name, SurroundConsts.LocalizationSourceName);
    }
}

3、版本管理中关联功能项,在版本管理页面,编辑版本信息弹框内右侧tab页功能项树结构,可查看系统已有功能,并通过勾选形式确定该版本需要的功能。

技术图片

 

四、租户版本管理

  软件公司可以在发售给客户的软件中预先配置好几个版本,方便部署实施时,更改租户使用的版本即可完成功能划分。默认使用的是单个租户,因此,对于租户的增删操作直接pass掉了。对于Abp提供的多租户的管理部分代码进行相关更改,适应单租户的一些操作。

  • 可查看当前租户信息;
  • 可切换租户使用版本;

1、在已有租户应用服务中更改已有代码,取消原有继承的CRUD服务,实现获取租户列表,更改版本等几个操作。

/// <summary>
/// 租户应用服务
/// </summary>
public interface ITenantAppService : IApplicationService
{
    /// <summary>
    /// 获取单个租户
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task<TenantListDto> GetTenant(EntityDto<int> input);

    /// <summary>
    /// 获取全部租户列表
    /// </summary>
    /// <returns></returns>
    Task<ListResultDto<TenantListDto>> GetTenantsList();

    /// <summary>
    /// 移动当前租户版本到其它版本
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task MoveTenantToAnotherEdition(MoveTenantToAnotherEditionInput input);
}

2、实现替换的几个租户应用服务接口方法,此处仅展示切换租户版本。完成顶部权限验证,版本参数验证,租户版本修改。

[AbpAuthorize(PermissionNames.Pages_Frame_Tenants_MoveTenantToAnotherEdition)]
public async Task MoveTenantToAnotherEdition(MoveTenantToAnotherEditionInput input)
{
    if (input.SourceEditionId == input.TargetEditionId)
    {
        throw new UserFriendlyException("原版本与目标版本一致,无需切换");
    }

    var tenant = await _tenantManager.GetByIdAsync(input.TenantId);
    tenant.EditionId = input.TargetEditionId;
    await _tenantManager.UpdateAsync(tenant);
}

 3、租户控制器层面已经存在了相关代码,改造部分代码并完成页面实现,页面实现中主要是弹框内列举出当前系统已有的版本列表信息,方便切换版本。

技术图片

 4、页面效果实现,版本切换操作实现。

技术图片

 

五、菜单权限控制

  对于诸如版本管理、租户管理这部分菜单仅能够对宿主进行开放,因此在权限列表中对该部分权限进行控制,在导航菜单中会依据是否有权限进行过滤菜单。权限中使用命名参数multiTenancySides设置为仅宿主使用。

#region 版本管理
var editions = frame.CreateChildPermission(PermissionNames.Pages_Frame_Editions, L("Editions"), multiTenancySides: MultiTenancySides.Host);
editions.CreateChildPermission(PermissionNames.Pages_Frame_Editions_Create, L("CreateEdition"), multiTenancySides: MultiTenancySides.Host);
editions.CreateChildPermission(PermissionNames.Pages_Frame_Editions_Update, L("UpdateEdition"), multiTenancySides: MultiTenancySides.Host);
editions.CreateChildPermission(PermissionNames.Pages_Frame_Editions_Delete, L("DeleteEdition"), multiTenancySides: MultiTenancySides.Host);
editions.CreateChildPermission(PermissionNames.Pages_Frame_Editions_MoveTenantsToAnotherEdition, L("MoveTenantsToAnotherEdition"), multiTenancySides: MultiTenancySides.Host);
#endregion

#region 租户管理
var tenants = frame.CreateChildPermission(PermissionNames.Pages_Frame_Tenants, L("Tenants"), multiTenancySides: MultiTenancySides.Host);
tenants.CreateChildPermission(PermissionNames.Pages_Frame_Tenants_MoveTenantToAnotherEdition, L("MoveTenantsToAnotherEdition"), multiTenancySides: MultiTenancySides.Host);
#endregion

  对于宿主登录,在主页面设置了两个入口,如登录时使用Account/HostLogin则为宿主登录,否则为租户登录。

 

 仓库地址:https://gitee.com/530521314/Partner.Surround.git 

2020-04-12,望技术有成后能回来看见自己的脚步

以上是关于X-Admin&ABP框架开发-版本管理的主要内容,如果未能解决你的问题,请参考以下文章

X-Admin&ABP框架开发-RBAC

Module Zero模块 [X-Admin&ABP框架开发-RBAC]

X-Admin&ABP框架开发-代码生成器

前端后台管理模板(x-admin)和画图工具(图表展示)

ABP开发框架前后端开发系列---(11)菜单的动态管理

ABP开发框架前后端开发系列---ABP基础接口处理和省份城市行政区管理模块的开发