.NET Core采用的全新配置系统[3]: “Options模式”下的配置是如
配置的原子结构就是单纯的键值对,并且键和值都是字符串,但是在真正的项目开发中我们一般不会单纯地以键值对的形式来使用配置。值得推荐的做法就是采用《.NET Core采用的全新配置系统[1]: 读取配置数据》最后演示的方式将相关的配置定义成一个Options类型,并采用与类型定义想匹配的结构来定义原始的配置,这样就能利用它们之间的映射关系将读取的配置数据绑定为Options对象,我们将这种编程模式称为“Options模式”。 [ 本文已经同步到《ASP.NET Core框架揭秘》之中]
一、配置绑定对于一个Options对象来说,如果我们将其数据成员(这里主要指属性成员)视为其子节点,那么一个Options对象同样具有树形层次化结构,这与通过Configuration对象表示的配置树在结构上并没有本质的区别。如果Options类型的数据成员定义与配置树结构具有匹配的结构,那么将后者绑定为一个对应类型的Options对象是一件很容易的事情,对于这种将一个Configuration对象绑定为对应Options对象的行为简称为“配置绑定”。 配置绑定让我们可以根据得到的Configuration对象生成相应的Options对象,相关的API定义在“Microsoft.Extensions.Configuration.Binder”这个NuGet包中,后者为IConfiguration接口定义了如下一个GetValue方法得到绑定生成的Options对象。在调用这个放过的时候,我们会创建一个空的Options对象并将其作为参数,该方法会将Configuration承载的配置数据绑定到Options对象上。 1: public static class ConfigurationBinder 2: {
3: void Bind(this IConfiguration configuration,object instance); 4: }
配置绑定的目标类型可以是一个简单的基元类型,也可以是一个自定义数据类型,还可以是一个数组、集合或者字典类型。上述的这个Bind方法在进行配置绑定的过程,针对不同的目标类型,它会采用不同的策略。至于该方法具体的实现原理,我们会在后续的部分予以单独介绍,而目前介绍的重点是Options模式采用的API在背后是如何调用这个方法得到所需的Options对象的。 我们在回顾一下《.NET Core采用的全新配置系统[1]: 读取配置数据》演示的采用Options模式读取配置的例子。Options模式是对依赖注入的应用,我们知道针对依赖注入的编程只涉及两个方面,即注册相应的服务到ServiceCollection对象上,在利用后者创建相应的ServiceProvider来提供我们所需的服务对象。如下面的代码片段所示,Options模式最终的目的是利用ServiceProvider得到一个类型为IOptions<TOptions>的服务对象,后者的Value通过配置绑定生成的Options对象。为了能够得到所需的服务对象,它借助两个扩展方法AddOptions和Configure<TOptions>注册了必要的服务。 2: FormatOptions options = new ServiceCollection()
4: .Configure<FormatOptions>(config.GetSection("Format"))
5: .BuildServiceProvider()
6: .GetService<IOptions<FormatOptions>>()
7: .Value;
二、扩展方法AddOptions依然Options对象最终是利用依赖注入的方式创建的一个类型为IOptions<TOptions>的服务对象得到的,我们就先来认识一下这个接口。这是一个泛型接口,泛型参数类型TOptions代码的正式Options对象对应的类型。IOptions<TOptions>接口的定义如下,它只有一个唯一的只读属性Value返回我们所需的Options对象。 3: TOptions Value { get; }
static IServiceCollection AddOptions(this IServiceCollection services)
4: return services;
class OptionsManager<TOptions> : IOptions<TOptions> public OptionsManager(IEnumerable<IConfigureOptions<TOptions>> setups);
5: } 7: interface IConfigureOptions<in TOptions> class 8: {
9: void Configure(TOptions options); 10: }
11:?
12: class ConfigureOptions<TOptions>: IConfigureOptions<TOptions> where TOptions : 13: { 14: public Action<TOptions> Action { get; private set; } 15: public ConfigureOptions(Action<TOptions> action) 16: {
17: this.Action = action; 18: }
19: void Configure(TOptions options) 20: {
21: this.Action(options); 22: }
23: }
Options对象的创建体现在 OptionsManager <TOptions>类型的Value属性上。该属性的实现非常简单,它先调用默认无参构造函数(Options类型必须具有一个默认无参构造函数)创建一个空的Options对象,在返回之前,它会将其递交给初始化时指定的ConfigureOptions<TOptions>对象进行逐个处理。毫无疑问,针对Bind方法的调用肯定是通过某个ConfigureOptions<TOptions>对象参与到整个流程之中的,具体的实现自然与另一个扩展方法Configure有关。 三、扩展方法ConfigureOptions模式仅仅涉及到针对ServiceCollection的两个扩展方法(AddOptions和Configure<TOptions>),前者将服务IOptions<TOptions>/ OptionsManager <TOptions>注册到ServiceCollection之上,后者又作了怎样的服务注册呢? 4: }
6: class ConfigureFromConfigurationOptions<TOptions> :ConfigureOptions<TOptions> 7: { 9:????? : base(options => config.Bind(options))
11: } 从上面的代码片段可以看出,当我们调用ServiceCollection的扩展方法Configure<TOptions>时,该方法会利用指定 的Configuration对象创建一个ConfigureFromConfigurationOptions对象,并以服务类型IConfigureOptions<TOptions>注册到ServiceCollection上,采用的生命周期模式为Singleton。至于类型ConfigureFromConfigurationOptions,它是上面介绍的ConfigureOptions<TOptions>类型的继承者,创建该对象指定的Action<TOptions>委托对象通过调用Configuration对象的扩展方法Bind最终实现了配置绑定。 四、Options对象的创建Options编程模式的背后以两个注册到ServiceCollection的服务为核心,这两个服务对应的服务接口分别是IOptions<TOptions>和IConfigureOptions<TOptions>,前者直接提供最终绑定了配置数据的Options对象,后者则在Options对象返回之前对它实施相应的初始化工作。这个两个服务分别通过扩展方法AddOptions和Configure方法注册到指定的ServiceCollection之中,服务的真实类型分别是OptionsManager<TOptions>和ConfigureFromConfigurationOptions<TOptions>,后者派生于ConfigureOptions<TOptions>。下图所示的UML体现了Options模型中涉及的这些接口/类型以及它们之间的关系。 (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |
- 在ASP.NET WebForms中使用jQuery调用’WebMethod’
- asp.net – VS2008中的许多ascx-to-one ascx.cs错误
- asp.net-mvc-3 – 无法加载文件或程序集’StructureMap,Ver
- asp.net-mvc – 第一次只触发了Ajax.ActionLink
- asp.net – 可以通过从web.config中删除条目来关闭所有的MV
- asp.net-mvc – 在实体框架代码中为同一表定义多个外键
- .NET Core技术研究-主机Host ASP.NET Core技术研
- asp.net-mvc – Cakephp在asp.net mvc中烘焙等效
- asp.net-mvc – 如何从视图页面向页眉添加其他内容?
- 如何将Ninject集成到ASP.NET Core 2.0 Web应用程序中?
- asp.net – IIS7中的SQL Server和Windows身份验证
- asp.net – 如何添加ROW_NUMBER到LINQ查询或实体
- asp.net – 正确设置需要粘性会话的负载均衡网络
- asp.net-mvc – 如何将HTML表单转换为C#以进行Pa
- asp.net-mvc-3 – 使用Ninject 2.2的MVC 3依赖注
- Asp.NET 生成静态页面并分页的代码
- asp.net – 我的应用程序让我重定向到Account /
- asp.net – Visual Studio 2017错误:无法启动程
- asp.net-web-api – ExtensionlessUrlHandler和“
- 锯齿状数组< - > ASP.NET中的多维数组转换