使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(七)-- 结构化配置
2016-07-25 23:58
1136 查看
本篇将记录.Net Core里颇有特色的结构化配置的使用方法。
相比较之前通过Web.Config或者App.Config配置文件里使用xml节点定义配置内容的方式,.Net Core在配置系统上发生了很大的变化,具有了配置源多样化、更加轻量、扩展性更好的特点。
第一部分、基于键值对的配置
如果要使用结构化配置,需要先引用 "Microsoft.Extensions.Configuration": "1.0.0" nuget包。下面通过一个.Net Core控制台程序演示一、单层结构的配置
using Microsoft.Extensions.Configuration; using Microsoft.Extensions.Configuration.Memory; using System; using System.Collections.Generic; namespace DiApplicationTest { public class Program { public static void Main(string[] args) { IDictionary<string, string> source = new Dictionary<string, string>() { ["Ele1"] = "value1", ["Ele2"] = "value2" }; IConfiguration config = new ConfigurationBuilder().Add(new MemoryConfigurationSource() { InitialData = source }).Build(); Console.WriteLine($"Ele1: {config["Ele1"]}"); Console.WriteLine($"Ele2: {config["Ele2"]}"); Console.ReadLine(); } } }
启动调试,查看cmd窗口输出内容
上面的例子里,将一个字典作为配置源读入到config配置对象里,通过键可以读取到对应的值。
二、多层结构的配置
在大多数情况下,项目里的配置都是多层结构的,也可以称为是结构化的。在上面的例子的基础上稍加修改,实现结构化的配置读取。using Microsoft.Extensions.Configuration; using Microsoft.Extensions.Configuration.Memory; using System; using System.Collections.Generic; namespace DiApplicationTest { public class Program { public static void Main(string[] args) { IDictionary<string, string> source = new Dictionary<string, string>() { ["Ele1"] = "value1", ["Ele2:Sub1"] = "value2.1", ["Ele2:Sub2"] = "value2.2" }; IConfiguration config = new ConfigurationBuilder().Add(new MemoryConfigurationSource() { InitialData = source }).Build(); Console.WriteLine($"Ele1: {config["Ele1"]}"); Console.WriteLine($"Ele2.Sub1: {config.GetSection("Ele2")["Sub1"]}"); Console.WriteLine($"Ele2.Sub2: {config.GetSection("Ele2")["Sub2"]}"); Console.ReadLine(); } } }
启动调试,查看cmd窗口输出内容
在这个例子里,字典内容描述了一个具有两层结构的配置,第一层有Ele1和Ele2两个节点,分别对应一个字符内容和一个复合内容,第二层有Sub1和Sub2两个节点,同时挂在Ele2节点下,组成了一个复合结构。
注意看字典项里的Key,因为字典里的数据是扁平化的,为了能清晰描述节点之间的上下层关系,需要通过“:”符号来标识。
config对象通过GetSection方法来获取当前节点的某个下级节点内容。
第二部分、其他配置来源
除了上面例子里展示的配置源来自内存内容,也可以来自Xml文件、JSON文件或者数据库等。因为在.Net Core里使用JSON文件描述配置内容很常见,下面就展示如何读取JSON配置文件。先添加如下两个nuget包,支持从json文件读取内容
"Microsoft.Extensions.Configuration.FileExtensions": "1.0.0", "Microsoft.Extensions.Configuration.Json": "1.0.0",
添加 appsettings.json 文件
{ "Ele1": "value1", "Ele2": { "Sub1": "value2.1", "Sub2": "value2.2" } }
修改Main函数内容
using Microsoft.Extensions.Configuration; using System; using System.IO; namespace DiApplicationTest { public class Program { public static void Main(string[] args) { IConfigurationBuilder builder = new ConfigurationBuilder(); builder.SetBasePath(Directory.GetCurrentDirectory()); builder.AddJsonFile("appsettings.json"); IConfiguration config = builder.Build(); Console.WriteLine($"Ele1: {config["Ele1"]}"); Console.WriteLine($"Ele2.Sub1: {config.GetSection("Ele2")["Sub1"]}"); Console.WriteLine($"Ele2.Sub2: {config.GetSection("Ele2")["Sub2"]}"); Console.ReadLine(); } } }
启动调试,查看cmd窗口输入内容,与上面的例子内容一致。
这个例子将原来在字典里的内容转换成Json格式化的内容存储在持久化文件里。通过指定配置源,同样可以读取内容。
第三部分、Options对象映射
当配置文件内容较多时,通过config的Key获取对应的配置项的值变得比较繁琐。.Net Core的配置系统采用了一种叫“Options Pattern”的模式使配置内容与有着对应结构的对象进行映射,这种对象就叫做Options对象。下面将简单演示一下这种映射方式。
首先添加如下nuget包引用,使用此模式的相关接口和类都在这个包里。同时还需要引入DI容器。
"Microsoft.Extensions.DependencyInjection": "1.0.0", "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0",
添加两个具有层级结构的Options类
public class ConfigOptions { public string Ele1 { get; set; } public SubConfigOptions Ele2 { get; set; } } public class SubConfigOptions { public string Sub1 { get; set; } public string Sub2 { get; set; } }
修改Main函数内容
public static void Main(string[] args) { // 创建DI容器,注册Options Pattern服务 IServiceCollection services = new ServiceCollection(); services.AddOptions(); // 读取配置文件 IConfigurationBuilder builder = new ConfigurationBuilder(); builder.SetBasePath(Directory.GetCurrentDirectory()); builder.AddJsonFile("appsettings.json"); IConfiguration config = builder.Build(); // 通过注册的服务获取最终映射的配置对象 IServiceProvider serviceProvider = services.Configure<ConfigOptions>(config).BuildServiceProvider(); ConfigOptions options = serviceProvider.GetService<IOptions<ConfigOptions>>().Value; Console.WriteLine($"Ele1: {options.Ele1}"); Console.WriteLine($"Ele2.Sub1: {options.Ele2.Sub1}"); Console.WriteLine($"Ele2.Sub2: {options.Ele2.Sub2}"); Console.ReadLine(); }
启动调试,查看cmd窗口输入内容,与上面的例子内容一致。
在定义Options对象结构时,对象内的属性名称要与对应层级的配置Key的值保持一致,层级关系也要与配置内容的层级结构保持一致。
通过调用 services.AddOptions() 方法注册Options Pattern服务。将配置内容注册到容器里,来获取对应的服务Provider对象。通过调用GetService方法获得对应的真实服务对象,即带有事先定义的Options类型的泛型接口IOptions,接口的Value值就是配置内容映射的Options对象。
第四部分、Asp.Net Core里的配置管理
在这个系列之前使用的例子里添加配置管理相关的功能,来修改初始化日志级别的代码,同时添加一些自定义配置。先添加配置相关的nuget包
"Microsoft.Extensions.Configuration": "1.0.0",
"Microsoft.Extensions.Configuration.FileExtensions": "1.0.0", "Microsoft.Extensions.Configuration.Json": "1.0.0",
"Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0"
添加appsettings.json文件
{
// 日志配置
"Logging": {
"LogLevel": {
"Microsoft": "Warning"
}
},
// 自定义配置
"CfgContent":{ "Ele1": "value1", "Ele2": { "Sub1": "value2.1", "Sub2": "value2.2" } }
}
添加上个例子里的 ConfigOptions.cs、SubConfigOptions.cs 类,修改 Startup.cs 的内容,添加配置相关代码
using System.IO; using Microsoft.AspNetCore.Builder; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Logging; namespace WebApiFrame { public class Startup { public IConfiguration Configuration { get; } public Startup() { var builder = new ConfigurationBuilder() .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("appsettings.json"); Configuration = builder.Build(); } public void ConfigureServices(IServiceCollection services) { services.AddOptions(); services.Configure<ConfigOptions>(Configuration.GetSection("CfgContent")); // 注入MVC框架 services.AddMvc(); } public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory) { // 添加日志支持 loggerFactory.AddConsole(Configuration.GetSection("Logging")); loggerFactory.AddDebug(); // 添加NLog日志支持 //loggerFactory.AddNLog(); // 添加MVC中间件 app.UseMvc(); } } }
修改 DemoController.cs 内容
using System.Threading.Tasks; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Options; namespace WebApiFrame { [Route("[controller]")] public class DemoController : Controller { private ConfigOptions _cfgContent { get; } public DemoController(IOptions<ConfigOptions> options) { _cfgContent = options.Value; } [HttpGet("index")] public async Task Index() { HttpContext.Response.ContentType = "text/html"; await HttpContext.Response.WriteAsync($"<span>Ele1: {_cfgContent.Ele1}</span><br />"); await HttpContext.Response.WriteAsync($"<span>Ele2.Sub1: {_cfgContent.Ele2.Sub1}</span><br />"); await HttpContext.Response.WriteAsync($"<span>Ele2.Sub2: {_cfgContent.Ele2.Sub2}</span><br />"); } } }
启动调试,访问地址 http://localhost:5000/demo/index ,页面显示配置内容
从这个例子里可以看到,读取 appsettings.json 配置文件内容并分成两部分,其中一部分配置Logging作为Logger的配置内容用于日志初始化,另外一部分CfgContent配置内容注册到DI容器,在控制器的构造函数里通过IOptions泛型类型的参数注入,这样控制器就可以读取配置文件的内容。
相关文章推荐
- ASP.NET MVC 教程汇总
- 关于spring.net的面向切面编程 (Aspect Oriented Programming with Spring.NET)-通知(Advice)API
- Custom WEB Service (ASP.NET)AAD验证登录
- ASP.NET输出JSON格式数据
- 利用casperjs和tor来隐藏自己的ip地址
- ASP.NET 时间方法大全
- aspect 分类及形容词的情感分类——An unsupervised aspect-sentiment model for online reviews
- hjr-ASP.NET:asp.net网站的结构
- 构建高性能ASP.NET应用的12点建议
- IIS6配置Asp.net MVC运行环境
- aspect-based情感分析的调研
- Asp.net Mvc 数据验证
- ASP.NET Core 1.0实现邮件发送功能
- asp.net MVC实现Fullcalendar增删改的功能遇到的问题(包括datetimepicker冲突)
- ASP.NET MVC 长连接(服务器推)完整实现
- aspcms留言增加防刷新验证,单一ip留言条数限制,防止恶意刷新及恶意提交。
- ASPX页面添加验证码
- ASP.NET插件uploadify批量上传文件完整使用教程
- Raspberry Pi的GStreamer配置
- ASP.NET访问Access的连接字符串配置