《ASP.NET Core 高效能系列》關於.NET Core的配置資訊的若干事項
1.配置檔案的相關閒話
Core自身對於配置檔案不是必須品,但由上文分析可知ASP.NET Core預設採用appsettings.json作為配置檔案,關於配置資訊的優先等級
命令列>環境變數>自我訂製的配置(AddUserSecrets)>和當前環境相匹配的appsettings.json中的配置>大於appsettings.json中的配置
關於AddUserSecrets是什麼這裡簡單一言以蔽之:每個開發人員有自己特性的配置資料,這些配置資訊僅僅屬於個人,不能提交給團隊成員,
但是又不想不團隊共有的配置所影響. 剩下的自行去了解,關鍵是上面的優先順序
和當前環境相匹配的appsettings.json如appsettings.Development.json
2.日誌配置的問題
系統預設採用Microsoft.Extensions.Logging系列套餐作為預設的日誌元件,且採用配置檔案中的Logging節點作為日誌的預設配置引數依據。如下圖所示:
日誌的優先等級如下(從上到下依次遞增)
public enum LogLevel { // 含有最詳細的日誌資料,其中可能含有程式的一些敏感資料,該選項預設是被禁用的,且生產環境中絕對不要開啟 // (太多,太敏感),之所以預設禁用在於appsettings.json中最低級別是Information Trace = 0, //除錯用的一些資料 Debug = 1, // 用於跟蹤程式通常的流程資料,這些日誌是一些長期的資料。 Information = 2, // 需要引起重視的日誌資料,不會導致程式崩潰 Warning = 3, //發生了錯誤,但不會導致程式大範圍崩潰 Error = 4, // 嚴重且致命的錯誤 Critical = 5, // 不是用來記錄日誌的. 通常用於設定預設值 None = 6 }
3.配置檔案的讀取
1)ASP.NET Core的Host採用appsettings.json作為配置檔案,具體的值是多少受優先順序的影響(看第一段)
2)Startup類中Host自動通過構造注入的方式提供了Configuration的值,Configuration讀取方式介紹如下
ASP.NET Core中預設採用了Microsoft.Extensions.Configuration.Json作為配置解析器(publish一下就看到了裡面有它)
{ "Id": "123", "Logging": { "IncludeScopes": false, "LogLevel": { "Default": "Debug", "System": "Information", "Microsoft": "Information" } }, "UserList": [ { "Name": "Name1" }, { "Name": "Name2" }, { "Name": "Name3" } ] }
3.通過Key進行讀取
Configuration["Id"]; // 123 Configuration["Logging:IncludeScopes"]; // false Configuration["Logging:LogLevel:Default"]; // Debug Configuration["UserList:0:Name"]; // Name1
上面這些值都是string型別的,我們可以通過GetValue來獲取指定型別的值
如下
Configuration.GetValue<int>("Id"); // int型別的123 Configuration.GetValue<bool>("Logging:IncludeScopes"); // bool 型別 false Configuration.GetValue<string>("Logging:LogLevel:Default"); // string 型別 Debug Configuration.GetValue<string>("UserList:0:Name"); // string 型別 Name1
4.通過POCO(純C#物件)類來獲取配置資訊(這裡以Get方法為例)
public class Poco { public int Id { get; set; } public LoggingPoco Logging { get; set; } public List<User> UserList { get; set; } public class User { public string Name { get; set; } } } public class LoggingPoco { public bool IncludeScopes { get; set; } public LogLevelPoco LogLevel { get; set; } } public class LogLevelPoco { public string Default { get; set; } public string System { get; set; } public string Microsoft { get; set; } } var detailLogging = Configuration.GetSection("Logging").Get<LoggingPoco>();
獲取整個配置檔案的配置資訊
var allConfig = Configuration.Get<Poco>();
獲取指定節點下的配置內容
var logging = Configuration.GetSection("Logging").Get<LoggingPoco>();
說說優先順序最高的配置(命令列方式)
前文所述,命令列具有優先順序最高的配置權力,命令列傳入A的值的方式:
//core特有的傳入方式,沒有引號就會因空格截斷 dotnet app.dll /A="Value in CMD" //傳統的方式,沒有引號就會因空格截斷 dotnet app.dll --A "Value in CMD"
環境變數的傳值方式
環境變數的等級僅次於命令列,另外windows當前使用者的環境變數有限等級高於系統環境變數,windows環境變數可能重啟後才能生效;
主要的應用場景在於docker等
記憶體性配置方式
主要用於加密保護一些敏感配置數