.NET平台开源项目速览(20)Newlife.Core中简单灵活的配置文件

时间:2024-03-23 13:36:44

如果用知乎,可以关注专栏:.NET开源项目

记得5年前开始拼命翻读X组件的源码,特别是XCode,但对Newlife.Core 的东西了解很少,最多只是会用用,而且用到的只是九牛一毛。里面好用的东西太多了。

最近一年时间,零零散散又学了很多,也了解了很多,不会写那总要学会用吧,今天就给大家介绍里面非常好用的自定义配置文件用法。

X组件的介绍我就不多说了,看这里多年前系列文章:

说明:文章是多年前的,但这些年变动也很大,最好看看源码,基本用法都还差不多。

.NET开源文章目录:本博客.NET开源项目文章目录

本文原文地址:.NET平台开源项目速览(20)Newlife.Core中简单灵活的配置文件

1.关于配置文件

说道配置文件,大家觉得太平凡和普通了,有人说有App.Config本来就可以用,何必搞这么多灰机。

可是飞机类型也很多,有空何必不尝试一下这个型号的飞机。

实际上App.Config里面对自定义的配置不太适合,加一堆,多了看起来也难受。而且有时候不同外部组件可能也带配置文件,多了就分不清楚了。

还有很多系统的配置可能需要及时生效(在不需要重新启动的情况下),以及程序中使用的简单,灵活性,也是一个重点。。。

吹了这么多水,那来看点实际的,看看Newlife.Core里面的配置文件有啥新东东。

2.Newlife.Core的配置功能

我总结的这个配置文件最大的优点:

1.开发过程中建立一个配置文件非常方便。集成,加属性,加默认值,如果有其他逻辑,补充一下。

2.使用极其方便,通过XXX类名.Current.属性名 就可以直接对配置项进行读写。

3.修改及时生效,可以设置生效时间,这样很多情况下,程序不用重启配置就能及时生效。

4.程序启动如果发现没有该配置项目,会自动新建默认配置文件。与XCode的反向工程异曲同工。

5.支持列表,字典等复杂数据结构。

6.代码注释和XML文件的注释匹配。

下面看看使用Demo:

3.Newlife.Core的配置的玩法

3.1 新建配置文件类

来个案例:加上要给一个应用程序加一个增加一个自定义配置文件:

配置项有(纯属虚构,不要纠结):

Debug(是否调试模式)

BatchSize(每批次处理的数据记录数),

ServiceName(服务名称)

CacheTime(缓存清理时间)

UserList(要监控的用户列表)

KvDemo(键值对)

首先,新建一个配置类:AppSet,代码如下(一般就是复制一份):

    /// <summary>应用自定义配置</summary>
[Description("应用自定义配置")]
[XmlConfigFile("Config/AppSet.config", 3000)]
public class AppSet : XmlConfig
{
/// <summary>调试开关。默认false</summary>
[Description("调试开关。默认false")]
public Boolean Debug { get; set; } = false; /// <summary>每批次处理的数据记录数</summary>
[Description("每批次处理的数据记录数")]
public Int32 BatchSize { get; set; } = 20000; /// <summary>服务名称</summary>
[Description("服务名称")]
public String ServiceName { get; set; } = "AppServer"; /// <summary>缓存清理时间</summary>
[Description("服务数据处理的线程数,32")]
public DateTime CacheTime { get; set; } = DateTime.Now.AddHours(5); /// <summary>要监控的用户ID列表</summary>
[Description("要监控的用户ID列表")]
public List UserList { get; set; } = new List() { 123,23,98,38}; /// <summary>键值对</summary>
[Description("键值对")]
public Dictionary<Int32, string> KvDemo { get; set; } =
new Dictionary<int, string>(){ { 1,"aaa"},{2,"bbb"},{ 3,"ccc"} };
}

配置文件说明:

1.类的特性:Description是整个XML配置文件的注释,XmlConfigFile定义文件位置和名称,以及生效时间3000ms

2.属性中的Description特性也是对该属性的说明(都会写入配置文件),至于注释大家都知道,智能提示有用

3.对属性的赋值是配置的默认值,程序启动第一次使用该类,如果配置文件不存在,就会自动采用这里的值创建,否则以存在的文件值为准

4.程序中可以动态修改和保存配置。

3.2 配置文件使用

每个配置文件都有一个静态的Current属性,通过静态对象来对整个配置文件进行操作。例如

  var name = AppSet.Current.ServiceName ;//读取配置
AppSet.Current.ServiceName = "TestName";//设置配置
AppSet.Current.Save();//配置保存,有异步方法,程序中动态进行

.NET平台开源项目速览(20)Newlife.Core中简单灵活的配置文件

如果程序第一次使用该配置类,在bin目录的Config文件夹,就会生成一个名称为AppSet.config的配置文件。如下图:

.NET平台开源项目速览(20)Newlife.Core中简单灵活的配置文件

由于Newlife本身也有一些配置类,所以也会自动生成在该目录,习惯都放在一起,也可以通过类特性修改保存路径。打开AppSet.config,内容如下:

 <?xml version="1.0" encoding="utf-8"?>
<!--应用自定义配置-->
<AppSet>
<!--调试开关。默认false-->
<Debug>false</Debug>
<!--每批次处理的数据记录数-->
<BatchSize>20000</BatchSize>
<!--服务名称-->
<ServiceName>TestName</ServiceName>
<!--缓存清理时间-->
<CacheTime>2018-02-26 01:28:00</CacheTime>
<!--要监控的用户ID列表-->
<UserList>
<!--要监控的用户ID列表-->
<Int32>123</Int32>
<!--要监控的用户ID列表-->
<Int32>23</Int32>
<!--要监控的用户ID列表-->
<Int32>98</Int32>
<!--要监控的用户ID列表-->
<Int32>38</Int32>
</UserList>
<!--键值对-->
<KvDemo>
<Comparer />
<Count>3</Count>
<Keys>
<Count>3</Count>
</Keys>
<Values>
<Count>3</Count>
</Values>
</KvDemo>
</AppSet>

仔细对照上面类的设置,一目了然。所以做一个这样的配置分分钟的事情。这里字典也支持,其实还支持类对象,可以把所有属性都给配置进行。

就不一一演示了,下面我们看看配置如何动态生效。

3.3 配置动态生效

下面,我们来做一个小实验,程序启动后,间隔7s来读取一次配置文件(配置文件3000毫秒检测一次变化),然后手动到目录下去修改配置文件中的值,

代码如下:

XTrace.UseConsole();
while(true)
{
XTrace.WriteLine(AppSet.Current.ServiceName);
//休眠7000毫秒,重新获取
System.Threading.Thread.Sleep(7000);
}

结果如下:

.NET平台开源项目速览(20)Newlife.Core中简单灵活的配置文件

可以看到配置的服务名称修改后,日志打印出有更新,重新加载,并继续打印出修改后的值。

4.底层源码实现

配置文件泛型基类源代码位置在 NewLife.Core/Xml/XmlConfig.cs ,对泛型的使用很常见,但对泛型基类使用出神入化,我见到最多的就是在X组件里面。非常牛逼的一个东西,我只会其皮毛,作者@大石头才是码神。

由于该配置文件基于XML文件,所以有几个辅助类。核新的代码主要是加载,和保存等逻辑,和上面功能一直,如果想学习,建议代码down下来,调试一遍。

5.相关资源

Newlife组件地址:https://github.com/NewLifeX/X

本文演示代码地址:https://github.com/asxinyu/NewlifeDemo