初识ABP vNext(10):ABP设置管理

  • A+
所属分类:.NET技术
摘要

Tips:本篇已加入系列文章阅读目录,可点击查看更多相关文章。目录前言开始定义设置使用设置最后

Tips:本篇已加入系列文章阅读目录,可点击查看更多相关文章。

前言

上一篇介绍了ABP模块化开发的基本步骤,完成了一个简单的文件上传功能。通常的模块都有一些自己的配置信息,比如上篇讲到的FileOptions类,其中配置了文件的上传目录,允许的文件大小和允许的文件类型。配置信息可以通过Configuration(配置)和Options(选项)来完成,ABP还提供了另一种更灵活的方式: Settings(设置),本篇就来介绍一下ABP的设置管理。

开始

回顾一下上篇的FileOptions

初识ABP vNext(10):ABP设置管理

首先定义了一个FileOptions类,其中包含了几个配置,然后在需要的地方中注入IOptions<FileOptions>就可以使用这些信息了。

当然,模块启动时可以做一些配置修改,比如:

初识ABP vNext(10):ABP设置管理

无论是配置文件还是这种代码形式的配置,都是程序层面的修改;有些配置不太适合这样做,比如这里的AllowedMaxFileSizeAllowedUploadFormats,它们应该在应用界面上,可以让管理员自行修改。下面就来改造一下程序。

定义设置

使用设置之前需要先定义它,不同的模块可以拥有不同的设置。

modulesfile-managementsrcXhznl.FileManagement.DomainSettingsFileManagementSettingDefinitionProvider.cs:

public class FileManagementSettingDefinitionProvider : SettingDefinitionProvider {     public override void Define(ISettingDefinitionContext context)     {         /* Define module settings here.          * Use names from FileManagementSettings class.          */          context.Add(new SettingDefinition(             FileManagementSettings.AllowedMaxFileSize,             "1024",             L("DisplayName:FileManagement.AllowedMaxFileSize"),             L("Description:FileManagement.AllowedMaxFileSize")             )                 .WithProperty("Group1", "File")                 .WithProperty("Group2", "Upload")                 .WithProperty("Type", "number"),              new SettingDefinition(                 FileManagementSettings.AllowedUploadFormats,                 ".jpg,.jpeg,.png,.gif,.txt",                 L("DisplayName:FileManagement.AllowedUploadFormats"),                 L("Description:FileManagement.AllowedUploadFormats")             )                 .WithProperty("Group1", "File")                 .WithProperty("Group2", "Upload")                 .WithProperty("Type", "text")             );     }      private static LocalizableString L(string name)     {         return LocalizableString.Create<FileManagementResource>(name);     } } 

以上代码定了了2个配置:AllowedMaxFileSizeAllowedUploadFormats,设置了它们的默认值、名称和详细说明。因为本项目使用了EasyAbp的SettingUi模块,所以会有一些Group1Group2之类的字段,具体介绍可以参考Abp.SettingUi

使用设置

想读取设置信息,只需注入ISettingProvider即可。因为父类ApplicationService中已经注入,所以这里直接使用SettingProvider就好。获取到配置,然后就可以做一些逻辑处理,比如判断上传文件的大小和格式是否合法:

public class FileAppService : FileManagementAppService, IFileAppService {     ......      [Authorize]     public virtual async Task<string> CreateAsync(FileUploadInputDto input)     {         var allowedMaxFileSize = await SettingProvider.GetAsync<int>(FileManagementSettings.AllowedMaxFileSize);//kb         var allowedUploadFormats = (await SettingProvider.GetOrNullAsync(FileManagementSettings.AllowedUploadFormats))             ?.Split(",", StringSplitOptions.RemoveEmptyEntries);          if (input.Bytes.Length > allowedMaxFileSize * 1024)         {             throw new UserFriendlyException(L["FileManagement.ExceedsTheMaximumSize", allowedMaxFileSize]);         }          if (allowedUploadFormats == null || !allowedUploadFormats.Contains(Path.GetExtension(input.Name)))         {             throw new UserFriendlyException(L["FileManagement.NotValidFormat"]);         }          ......     } } 

前端设置界面:

初识ABP vNext(10):ABP设置管理

下面可以随便修改下设置,进行测试:

初识ABP vNext(10):ABP设置管理

最后

本篇内容较少,希望对你有帮助。代码已上传至 https://github.com/xiajingren/HelloAbp ,欢迎star。