我们在《聊聊默认支持的各种配置源》和《深入了解三种针对文件(JSON、XML与INI)的配置源》对配置模型中默认提供的各种ConfigurationSource进行了深入详尽的介绍,如果它们依然不能满足项目中的配置需求,我们可以还可以通过自定义ConfigurationProvider来支持我们希望的配置来源。就配置数据的持久化方式来说,将培植存储在数据库中应该是一种非常常见的方式,接下来我们就是创建一个针对数据库的ConfigurationSource,它采用最新的Entity Framework Core来完成数据库的存取操作。篇幅所限,我们不可能对Entity Framework Core相关的编程作单独介绍,如果读者朋友们对此不太熟悉,可以查阅Entity Framework Core在线文档。 [ 本文已经同步到《ASP.NET Core框架揭秘》之中]

目录
一、在应用中使用自定义的DbConfigurationSource
二、ApplicationSetting & ApplicationSettingsContext
三、DbConfigurationSource
四、DbConfigurationProvider
五、扩展方法AddDatabase

一、在应用中使用自定义的DbConfigurationSource

我们将这个自定义ConfigurationSource命名为DbConfigurationSource。在正式对它的实现展开介绍之前,我们先来看看它在项目中的应用。我们创建一个控制台程序来演示对这个DbConfigurationSource应用。我们将配置保存在SQL Server数据库中的某个数据表中,并采用Entity Framework Core来读取配置,所以我们需要添加针对“ Microsoft.EntityFrameworkCore”和“Microsoft.EntityFrameworkCore.SqlServer”这两个NuGet包的依赖。除此之外,我们的实例程序会采用Options模式将读取的配置绑定为了一个Options对象,所以我们添加了针对NuGet包“Microsoft.Extensions.DependencyInjection”和“Microsoft.Extensions.Options.ConfigurationExtensions”的依赖。

   1: {
   2:   ...
   3:   "buildOptions": {
   4:     ...
   5:     "copyToOutput": "connectionString.json"
   6:   },
   7:  
   8:   "dependencies": {
   9:     ...
  10:     "Microsoft.Extensions.Options.ConfigurationExtensions"    : "1.0.0",
  11:     "Microsoft.Extensions.DependencyInjection"                : "1.0.0",
  12:     "Microsoft.Extensions.Configuration.Json"                 : "1.0.0",
  13:     "Microsoft.EntityFrameworkCore.SqlServer"                 : "1.0.0",
  14:     "Microsoft.EntityFrameworkCore"                           : "1.0.0"
  15:   } 
  16: }

我们将链接字符串作为配置定义在一个名为“connectionString.json”的JSON文件中,所以我们添加了针对NuGet包“Microsoft.Extensions.Configuration.Json”的依赖。链接字符串采用如下的形式定义在这个JSON文件中的定义,我们修改了“buildOptions/copyToOutput”配置项使这个文件可以在编译的时候可以自动拷贝到输出目录下。

   1: {
   2:   "connectionStrings": {
   3:     "defaultDb":  "Server = ... ; Database=...; Uid = ...; Pwd = ..."
   4:   }
   5: }

我们编写了如下的程序来演示针对自定义ConfigurationSource(DbConfigurationSource)的应用。我们首先创建了一个ConfigurationBuilder对象,并注册了一个指向“connectionString.json”文件的JsonConfigurationSource。针对DbConfigurationSource的注册体现在扩展方法AddDatabase上,这个方法接收两个参数,它们分别代表链接字符串的名称和初始的配置数据。前者正式“connectionString.json”设置的连接字符串名称“defaultDb”,后者是一个字典对象,它提供的原始配置正好可以构成一个Profile对象。在利用ConfigurationBuilder创建出相应的Configuration对象之后,我们采用标准的Options编程模式读取配置将将其绑定为一个Profile对象。

   1: var initialSettings = new Dictionary<string, string>
   2: {
   3:     ["Gender"]             = "Male",
   4:     ["Age"]                 = "18",
   5:     ["ContactInfo:EmailAddress"]     = "foobar@outlook.com",
   6:     ["ContactInfo:PhoneNo"]         = "123456789"
   7: };
   8:  
   9: IConfiguration config = new ConfigurationBuilder()
  10:     .AddJsonFile("connectionString.json")
  11:     .AddDatabase("DefaultDb", initialSettings)
  12:     .Build();
  13:  
  14: Profile profile = new ServiceCollection()
  15:     .AddOptions()
  16:     .Configure<Profile>(config)
  17:     .BuildServiceProvider()
  18:     .GetService<IOptions<Profile>>()
  19:     .Value;
  20:  
  21: Debug.Assert(profile.Gender == Gender.Male);
  22: Debug.Assert(profile.Age == 18);
  23: Debug.Assert(profile.ContactInfo.EmailAddress == "foobar@outlook.com");
  24: Debug.Assert(profile.ContactInfo.PhoneNo == "123456789");
  25:  
  26:  
  27: public class Profile
  28: {
  29:     public Gender         Gender { get; set; }
  30:     public int            Age { get; set; }
  31:     public ContactInfo    ContactInfo { get; set; }
  32: }
  33:  
  34: public class ContactInfo
  35: {
  36:     public string EmailAddress { get; set; }
  37:     public string PhoneNo { get; set; }
  38: }
  39:  
  40: public enum Gender
  41: {
  42:     Male,
  43:     Female
  44: }
  45:  

二、ApplicationSetting & ApplicationSettingsContext

如上面的代码片断所示,针对DbConfigurationSource的应用仅仅体现在我们为ConfigurationBuilder定义的扩展方法AddDatabase上,所以使用起来是非常方便的,那么这个扩展方法背后有着怎样的逻辑实现呢?DbConfigurationSource采用Entity Framework Core以Code First的方式进行数据操作,如下所示的ApplicationSetting是表示基本配置项的POCO类型,我们将配置项的Key以小写的方式存储。另一个ApplicationSettingsContext是对应的DbContext类型。

   1: [Table("ApplicationSettings")]
   2: public class ApplicationSetting
   3: {
   4:     private string key;
   5:  
   6:     [Key]
   7:     public string Key
   8:     {
   9:         get { return key; }
  10:         set { key = value.ToLowerInvariant(); }
  11:     }
  12:  
  13:     [Required]
  14:     [MaxLength(512)]
  15:     public string Value { get; set; }
  16:  
  17:     public ApplicationSetting()
  18:     {}
  19:  
  20:     public ApplicationSetting(string key, string value)
  21:     {
  22:         this.Key     = key;
  23:         this.Value   = value;
  24:     }
  25: }
  26:  
  27: public class ApplicationSettingsContext : DbContext
  28: {
  29:     public ApplicationSettingsContext(DbContextOptions options) : base(options)
  30:     {}
  31:  
  32:     public DbSet<ApplicationSetting> Settings { get; set; }
  33: }

三、DbConfigurationSource

如下所示的是DbConfigurationSource的定义,它的构造函数接受两个参数,第一个参数类型为Action<DbContextOptionsBuilder>的委托对象,我们用它来对创建DbContext采用的DbContextOptions进行设置,另一个可选的参数用来指定一些需要自动初始化的配置项。DbConfigurationSource在重写的Build方法中利用这两个对象创建一个DbConfigurationProvider对象。

   1: public class DbConfigurationSource : IConfigurationSource
   2: {
   3:     private Action<DbContextOptionsBuilder> _setup;
   4:     private IDictionary<string, string> _initialSettings;
   5:  
   6:     public DbConfigurationSource(Action<DbContextOptionsBuilder> setup, IDictionary<string, string> initialSettings = null)
   7:     {
   8:         _setup               = setup;
   9:         _initialSettings     = initialSettings;
  10:     }
  11:     public IConfigurationProvider Build(IConfigurationBuilder builder)
  12:     {
  13:         return new DbConfigurationProvider(_setup, _initialSettings);
  14:     }
  15: }

四、DbConfigurationProvider

DbConfigurationProvider派生于抽象类ConfigurationProvider。在重写的Load方法中,它会根据提供的Action<DbContextOptionsBuilder>创建ApplicationSettingsContext对象,并利用后者从数据库中读取配置数据并转换成字典对象并赋值给代表配置字典的Data属性。如果数据表中没有数据,该方法还会利用这个DbContext对象将提供的初始化配置添加到数据库中。

   1: public class DbConfigurationProvider: ConfigurationProvider
   2: {
   3:     private IDictionary<string, string>         _initialSettings;
   4:     private Action<DbContextOptionsBuilder>     _setup;
   5:  
   6:     public DbConfigurationProvider(Action<DbContextOptionsBuilder> setup, IDictionary<string, string> initialSettings)
   7:     {
   8:         _setup               = setup;
   9:         _initialSettings     = initialSettings?? new Dictionary<string, string>() ;
  10:     }
  11:  
  12:     public override void Load()
  13:     {
  14:         DbContextOptionsBuilder<ApplicationSettingsContext> builder = new DbContextOptionsBuilder<ApplicationSettingsContext>();
  15:         _setup(builder);
  16:         using (ApplicationSettingsContext dbContext = new ApplicationSettingsContext(builder.Options))
  17:         {
  18:             dbContext.Database.EnsureCreated();
  19:             this.Data = dbContext.Settings.Any()? dbContext.Settings.ToDictionary(it => it.Key, it => it.Value, StringComparer.OrdinalIgnoreCase): this.Initialize(dbContext);
  20:         }
  21:     }
  22:  
  23:     private IDictionary<string, string> Initialize(ApplicationSettingsContext dbContext)
  24:     {
  25:         foreach (var item in _initialSettings)
  26:         {
  27:             dbContext.Settings.Add(new ApplicationSetting(item.Key, item.Value));
  28:         }
  29:         return _initialSettings.ToDictionary(it => it.Key, it => it.Value, StringComparer.OrdinalIgnoreCase);
  30:     }
  31: }

五、扩展方法AddDatabase

实例演示中用来注册DbConfigurationSource的扩展方法AddDatabase具有如下的定义。该方法首先调用ConfigurationBuilder的Build方法创建出一个Configuration对象,并调用后者的扩展方法GetConnectionString根据指定的连接字符串名称得到完整的连接字符串。接下来我们调用构造函数创建一个DbConfigurationSource对象并注册到ConfigurationBuilder上。创建DbConfigurationSource对象指定的Action<DbContextOptionsBuilder>会完成针对连接字符串的设置。

   1: public static class DbConfigurationExtensions
   2: {
   3:     public static IConfigurationBuilder AddDatabase(this IConfigurationBuilder builder, string connectionStringName, IDictionary<string, string> initialSettings = null)
   4:     {
   5:         string connectionString = builder.Build().GetConnectionString(connectionStringName);
   6:         DbConfigurationSource source = new DbConfigurationSource(optionsBuilder => optionsBuilder.UseSqlServer(connectionString), initialSettings);
   7:         builder.Add(source);
   8:         return builder;
   9:     }
  10: }

作者:蒋金楠
微信公众账号:大内老A
微博:www.weibo.com/artech
如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注个人公众号(原来公众帐号蒋金楠的自媒体将会停用)。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
原文链接

.NET Core采用的全新配置系统[7]: 将配置保存在数据库中相关推荐

  1. .NET Core采用的全新配置系统[5]: 聊聊默认支持的各种配置源[内存变量,环境变量和命令行参数]...

    较之传统通过App.config和Web.config这两个XML文件承载的配置系统,.NET Core采用的这个全新的配置模型的最大一个优势就是针对多种不同配置源的支持.我们可以将内存变量.命令行参 ...

  2. php 后台配置系统,使用 laravel-admin 配置后台管理系统

    内容有点多,就不说别的了.. 需要一个简单的后台管理系统,对接数据库中的用户信息表,完成基本的增删改查操作. 最好支持权限管理:有便捷的接口可供调用(不需要深度定制):前端界面和交互美观简洁,足够&q ...

  3. Spark Core (TopN、mysql写入、读取文件通过RDD结合数据库中的表)练习3套

    pom.xml文件 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="h ...

  4. python名片系统代码练习并存储到数据库中

    我们首先要了解要干什么,咱要实现以下界面,进行增删改查,能够输入查询,并且将数据存储到数数据库中,和文件中. 主页面代码如下: #调用增删改查函数import 名片项目.dyhs as dy #调用存 ...

  5. 杨中科.NET5视频教程更新了:DI、配置系统、Logging、EF Core等

    我的.NET5视频教程又更新了一些内容了,包含依赖注入.配置系统.日志系统以及部分Entity Framework Core的内容.Entity Framework Core还没全讲完,会继续更新. ...

  6. 深入理解Magento – 第一章 – Magento强大的配置系统

    深入理解Magento 作者:Alan Storm 翻译:Hailong Zhang 第一章 – Magento强大的配置系统 Magento的配置系统就像是Magento的心脏,支撑着Magento ...

  7. Django基础--Django基本命令、路由配置系统(URLconf)、编写视图、Template、数据库与ORM...

    web框架 框架,即framework,特指为解决一个开放性问题而设计的具有一定约束性的支撑结构. 使用框架可以帮你快速开发特定的系统. 简单地说,就是你用别人搭建好的舞台来做表演. 尝试搭建一个简单 ...

  8. linux 5556端口,在Linux系统下通过配置iptables实现自动转发报文

    首先需要启动iptables,在终端窗口输入如下命令(以下指令都需要在root模式下执行): vim /etc/sysctl.conf 打开sysctl.conf文件,修改其中net.ipv4.ip_ ...

  9. RH413企业安全加固 第15章 配置系统审计

    第15章 配置系统审计 环境配置 1.RHEL6.4 SERVER 10.10.10.221 2.RHEL6.4 CLIENT 10.10.10.223 1.审计使用的服务 [root@teacher ...

最新文章

  1. 使用Flow检查React,Redux和React-Redux的全面指南
  2. 郭天祥:我的大学六年
  3. 必备面试题:系统CPU飙高和GC频繁,如何排查?
  4. 安装mysql 没有快捷_快速安装mysql
  5. js中使用shiro标签的一个小坑
  6. 设置环境变量的三种方法【转载】
  7. java 基本理论知识点
  8. 台式计算机最常用的IO总线,三总线结构的计算机总线系统由 (1) 组成。
  9. 【ESP32 Arduino平衡小车制作】(一)霍尔编码器解码
  10. CSS 3之设置图片边框
  11. 逆火软件测试工资,逆火刷机软件介绍和软件使用说明
  12. 工欲善其事,必先利其器 — “CSDN浏览器插件” 办公必备“神器” | 你值得拥有
  13. python plt pyplot matplotlib绘图时形状异常
  14. 【高德地图】iOS 开发汇总(一)
  15. 业务应用数据库压力过大解决方案
  16. 为什么有的人赚钱很简单,有的人却不行?
  17. Web API-添加Swagger,SQL Server,记录并导出到Excel
  18. 【作用域、自由变量】
  19. 创业期间,应该怎么样坚持下去?如何从容面对困难?
  20. 经历≠经验,码农如何工作10年依然是菜鸟?

热门文章

  1. Centos 6.4使用本地yum源
  2. 美工一流的个人网站源码系列(2),不漂亮你可以不下载!
  3. C#发现之旅第二讲 C#-XSLT开发
  4. DataTable方法 和 性能
  5. clientHeight,offsetHeight,scrollHeight迷一样的三个值
  6. Shell脚本基本命令3
  7. dede标签用法(来源网页)
  8. day36 python学习gevent io 多路复用 socketserver *****
  9. Java内部类引用外部类中的局部变量为何必须是final问题解析
  10. 预处理命令[#define]说明