[C#] .Net Core 全局配置读取管理方法 ConfigurationManager

  最近在学习.Net Core的过程中,发现.Net Framework中常用的ConfigurationManager在Core中竟然被干掉了。

  也能理解。Core中使用的配置文件全是Json,不像Framework使用的XML,暂时不支持也是能理解的,但是毕竟全局配置文件这种东西还挺重要的,阅读了一些文章后目前有3个解决方案。

一、引入扩展System.Configuration.ConfigurationManager


  这个扩展库可以直接在Nuget中获取。

  使用方法和说明见 .NET Core 2.0迁移技巧之web.config配置文件

  读取的文件类型和方法都跟.Net Framework中一致,而且仅需引入包就可以,瞬间很兴奋有木有!

  但是!在使用过过程中发现这个扩展有问题。项目运行过程中需修改我的app.config文件,对我项目中输出的内容没有丝毫影响,Debug发现获取到的值的确没有变化。重启项目都没有用。只有把项目重新编译才好使。

  不知道是不是因为我的打开方式不对,但是最终放弃这个方法。

二、引入扩展Microsoft.Extensions.Options.ConfigurationExtensions

  这个扩展库也可以直接在Nuget中获取。

  使用方法和说明见 ASP.NET Core实现类库项目读取配置文件

  这个可以读取application.json中的配置参数,不再使用XML可以说很好的贴近Core的设计理念。

  可惜,这个也有点美中不足的地方。首先跟上面的那个一样,运行时修改json文件读取到的内容不会改变,但是至少重启项目可以修改,这个让我欣慰很多。另外就是,这个方法采用的是反序列化的原理,也就是必须有一个跟配置文件对应的实体类才可以,这个感觉比较鸡肋,放弃。

三、自定义扩展方法

  这个是我这次说的重点,要是前面两个方法能满足读者你的需求,那么就没有必要看下去。

  废话少说,先上代码:

  1  public class ConfigurationManager
  2     {
  3         /// <summary>
  4         /// 配置内容
  5         /// </summary>
  6         private static NameValueCollection _configurationCollection = new NameValueCollection();
  7 
  8         /// <summary>
  9         /// 配置监听响应链堆栈
 10         /// </summary>
 11         private static Stack<KeyValuePair<string, FileSystemWatcher>> FileListeners = new Stack<KeyValuePair<string, FileSystemWatcher>>();
 12 
 13         /// <summary>
 14         /// 默认路径
 15         /// </summary>
 16         private static string _defaultPath = Directory.GetCurrentDirectory() + "\\appsettings.json";
 17 
 18         /// <summary>
 19         /// 最终配置文件路径
 20         /// </summary>
 21         private static string _configPath = null;
 22 
 23         /// <summary>
 24         /// 配置节点关键字
 25         /// </summary>
 26         private static string _configSection = "AppSettings";
 27 
 28         /// <summary>
 29         /// 配置外连接的后缀
 30         /// </summary>
 31         private static string _configUrlPostfix = "Url";
 32 
 33         /// <summary>
 34         /// 最终修改时间戳
 35         /// </summary>
 36         private static long _timeStamp = 0L;
 37 
 38         /// <summary>
 39         /// 配置外链关键词,例如:AppSettings.Url
 40         /// </summary>
 41         private static string _configUrlSection { get { return _configSection + "." + _configUrlPostfix; } }
 42 
 43 
 44         static ConfigurationManager()
 45         {
 46             ConfigFinder(_defaultPath);
 47         }
 48 
 49         /// <summary>
 50         /// 确定配置文件路径
 51         /// </summary>
 52         private static void ConfigFinder(string Path)
 53         {
 54             _configPath = Path;
 55             JObject config_json = new JObject();
 56             while (config_json != null)
 57             {
 58                 config_json = null;
 59                 FileInfo config_info = new FileInfo(_configPath);
 60                 if (!config_info.Exists) break;
 61 
 62                 FileListeners.Push(CreateListener(config_info));
 63                 config_json = LoadJsonFile(_configPath);
 64                 if (config_json[_configUrlSection] != null)
 65                     _configPath = config_json[_configUrlSection].ToString();
 66                 else break;
 67             }
 68 
 69             if (config_json == null || config_json[_configSection] == null) return;
 70 
 71             LoadConfiguration();
 72         }
 73 
 74         /// <summary>
 75         /// 读取配置文件内容
 76         /// </summary>
 77         private static void LoadConfiguration()
 78         {
 79             FileInfo config = new FileInfo(_configPath);
 80             var configColltion = new NameValueCollection();
 81             JObject config_object = LoadJsonFile(_configPath);
 82             if (config_object == null || !(config_object is JObject)) return;
 83            
 84             if (config_object[_configSection]!=null)
 85             {
 86                 foreach (JProperty prop in config_object[_configSection])
 87                 {
 88                     configColltion[prop.Name] = prop.Value.ToString();
 89                 }
 90             }
 91             
 92             _configurationCollection = configColltion;
 93         }
 94 
 95         /// <summary>
 96         /// 解析Json文件
 97         /// </summary>
 98         /// <param name="FilePath">文件路径</param>
 99         /// <returns></returns>
100         private static JObject LoadJsonFile(string FilePath)
101         {
102             JObject config_object = null;
103             try
104             {
105                 StreamReader sr = new StreamReader(FilePath, Encoding.Default);
106                 config_object = JObject.Parse(sr.ReadToEnd());
107                 sr.Close();
108             }
109             catch { }
110             return config_object;
111         }
112 
113         /// <summary>
114         /// 添加监听树节点
115         /// </summary>
116         /// <param name="info"></param>
117         /// <returns></returns>
118         private static KeyValuePair<string, FileSystemWatcher> CreateListener(FileInfo info)
119         {
120 
121             FileSystemWatcher watcher = new FileSystemWatcher();
122             watcher.BeginInit();
123             watcher.Path = info.DirectoryName;
124             watcher.Filter = info.Name;
125             watcher.IncludeSubdirectories = false;
126             watcher.EnableRaisingEvents = true;
127             watcher.NotifyFilter = NotifyFilters.Attributes | NotifyFilters.CreationTime | NotifyFilters.DirectoryName | NotifyFilters.FileName | NotifyFilters.LastAccess | NotifyFilters.LastWrite | NotifyFilters.Size;
128             watcher.Changed += new FileSystemEventHandler(ConfigChangeListener);
129             watcher.EndInit();
130 
131             return new KeyValuePair<string, FileSystemWatcher>(info.FullName, watcher);
132           
133         }
134 
135         private static void ConfigChangeListener(object sender, FileSystemEventArgs e)
136         {
137             long time = TimeStamp();
138             lock (FileListeners)
139             {
140                 if (time > _timeStamp)
141                 {
142                     _timeStamp = time;
143                     if (e.FullPath != _configPath || e.FullPath == _defaultPath)
144                     {
145                         while (FileListeners.Count > 0)
146                         {
147                             var listener = FileListeners.Pop();
148                             listener.Value.Dispose();
149                             if (listener.Key == e.FullPath) break;
150                         }
151                         ConfigFinder(e.FullPath);
152                     }
153                     else
154                     {
155                         LoadConfiguration();
156                     }
157                 }
158             }
159         }
160 
161         private static long TimeStamp()
162         {
163             return (long)((DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds * 100);
164         }
165 
166         private static string c_configSection = null;
167         public static string ConfigSection
168         {
169             get { return _configSection; }
170             set { c_configSection = value; }
171         }
172 
173 
174         private static string c_configUrlPostfix = null;
175         public static string ConfigUrlPostfix
176         {
177             get { return _configUrlPostfix; }
178             set { c_configUrlPostfix = value; }
179         }
180 
181         private static string c_defaultPath = null;
182         public static string DefaultPath
183         {
184             get { return _defaultPath; }
185             set { c_defaultPath = value; }
186         }
187 
188         public static NameValueCollection AppSettings
189         {
190             get { return _configurationCollection; }
191         }
192 
193         /// <summary>
194         /// 手动刷新配置,修改配置后,请手动调用此方法,以便更新配置参数
195         /// </summary>
196         public static void RefreshConfiguration()
197         {
198             lock (FileListeners)
199             {
200                 //修改配置
201                 if (c_configSection != null) { _configSection = c_configSection; c_configSection = null; }
202                 if (c_configUrlPostfix != null) { _configUrlPostfix = c_configUrlPostfix; c_configUrlPostfix = null; }
203                 if (c_defaultPath != null) { _defaultPath = c_defaultPath; c_defaultPath = null; }
204                 //释放掉全部监听响应链
205                 while (FileListeners.Count > 0)
206                     FileListeners.Pop().Value.Dispose();
207                 ConfigFinder(_defaultPath);
208             }
209         }
210 
211     }

 

  最开始设计的是采用缓存,每次调用比对文件的修改时间,大小等特征,出现变化从新载入配置。后来发现图样图森破!

  C#提供了专门监听文件系统的方法。所以从新设计了监听响应链堆栈来实现。

  

  使用说明:

    1、配置节点:

      可以直接写在项目默认的配置文件appsettings.json中 格式如下

{
  "AppSettings": {
    "Title": "Test",
    "Version": "1.2.1",
    "AccessToken": "123456@abc.com"
  }
}
View Code

      保证配置节点AppSettings存在,剩下的就是以Key-Value的形式来写属性,就可以。

    2、外部配置文件

      像.Net Framework中一样,可以通过外部配置文件来实现。格式如下

1 {
2   "AppSettings.Url": "D:\\test\\app1.json"
3 }
View Code

      采用格式是“配置节点名.外链后缀”的形式。可以设计多级外部配置文件,只要发现有外部配置节点就会向下寻找,并监听链上的所有节点文件的变化。

      但是需要注意的是:一旦存在外部配置节点,此文件中的配置节点和参数将不再参与解析

    3、可配置初始化参数

      包括默认文件路径在内的多个参数均可以修改,详情见代码。

      修改后需要手动调用RefreshConfiguration方法,以使配置内容生效,有点像事务处理。建议在项目的Startup方法中修改配置方法。

    4、使用

      跟.Net Framework中一样,直接调用ConfigurationManager.Appsettings["Title"]就可以了。

 

以上代码功能完全原创,转载请著名出处。如果有任何问题和疑问欢迎提出,可以给我邮件或者直接留言。

posted @ 2017-09-13 16:48  写代码的相声演员  阅读(12814)  评论(16编辑  收藏  举报