解讀ASP.NET 5 MVC6系列教程

　　框架介紹

　　在之前的.NET中，微軟還沒(méi)有提供過(guò)像樣的日志框架，目前能用的一些框架比如Log4Net、NLog、CommonLogging使用起來(lái)多多少少都有些費勁，和java的SLF4J根本無(wú)法相比。但在新版的ASP.NET5中，可謂是牛氣沖天，微軟提供的Microsoft.Framework.Logging框架集可謂就是.NET版的SLF4J，提供相應的接口，其它第三方組件可以根據接口實(shí)現自己的實(shí)現。

　　ILoggerFactory接口

　　ILoggerFactory接口是日志的入庫點(diǎn)，在系統中通過(guò)依賴(lài)注入可以獲取該接口的實(shí)例，并根據該示例創(chuàng )建日志記錄器ILogger來(lái)記錄日志，示例如下：

　　var factory = ServiceProvider.GetRequiredService(); var logger1 = factory.CreateLogger(typeof(HomeController).FullName); //CreateLogger var logger2 = factory.CreateLogger(); //CreateLogger logger1.Log(LogLevel.Information, 1, null, null, null); // 日志記錄 logger1.LogInformation("123"); // 擴展方法 logger1.LogError("123"); // 擴展方法

　　或者，你也可以在Startup.cs的Configure方法中，從loggerfactory參數中獲取上述示例。

　　ILoggerFactory接口的定義如下：

　　public interface ILoggerFactory{ //日志最小記錄級別 LogLevel MinimumLevel { get; set; } //創(chuàng )建日志記錄實(shí)例 ILogger CreateLogger(string categoryName); //一般是根據功能模塊或類(lèi)名進(jìn)行分類(lèi) void AddProvider(ILoggerProvider provider); // 添加日志記錄provider（如第三方實(shí)現）}

　　在該接口的實(shí)現中，我們可以設置日志的最小記錄基本，其類(lèi)別如下：

　　public enum LogLevel{ Debug = 1, Verbose = 2, Information = 3, Warning = 4, Error = 5, Critical = 6,}

　　也可以添加第三方實(shí)現的Provider，比如添加一個(gè)控制臺版本的實(shí)現：

　　public static ILoggerFactory AddConsole(this ILoggerFactory factory){ factory.AddProvider(new ConsoleLoggerProvider((category, logLevel) => logLevel >= LogLevel.Information)); return factory;}

　　然后通過(guò)CreateLogger方法創(chuàng )建日志記錄器實(shí)例，最后再記錄日志。

　　ILoggerProvider和ILogger

　　所有的第三方實(shí)現都需要實(shí)現ILoggerProvider接口和ILogger接口，其中接口很簡(jiǎn)單，就是實(shí)現創(chuàng )建ILogger接口的方法即可，代碼如下：

　　public interface ILoggerProvider{ ILogger CreateLogger(string name); //創(chuàng )建給定類(lèi)別的ILgger實(shí)例}

　　而ILogger的實(shí)現，也相對簡(jiǎn)單，除了實(shí)現通用的日志記錄方法以外，還需要實(shí)現一個(gè)日志級別判斷的方法以及一個(gè)作用域創(chuàng )建方法，接口定義如下：

　　public interface ILogger{ //支持大多數日志記錄的通用方法，其它訪(fǎng)問(wèn)通過(guò)擴展方法進(jìn)行完善 void Log(LogLevel logLevel, int eventId, object state, Exception exception, Funcformatter); //判斷是否可以記錄給定的日志級別 bool IsEnabled(LogLevel logLevel); //開(kāi)啟一個(gè)邏輯操作作用域 IDisposable BeginScopeImpl(object state);}

　　實(shí)現了上述兩個(gè)接口，即可通過(guò)factory的AddProvider方法，將該provider添加到實(shí)例中，達到記錄日志的目的。ASP.NET 5中目前的默認實(shí)現了4中日志記錄Provider，分別是：Console、NLog、Serilog、Trace，注冊這些Provider的時(shí)候，均可以使用擴展方法，實(shí)例如下：

　　loggerfactory.AddConsole()loggerfactory.AddNLog(new NLog.LogFactory())loggerfactory.AddSerilog(new LoggerConfiguration())var testSwitch = new SourceSwitch("TestSwitch", "Level will be set to warning for this test");factory.AddTraceSource(testSwitch, new ConsoleTraceListener());

　　ILogger的擴展方法

　　為了方便記錄日志，微軟在Microsoft.Framework.Logging.LoggerExtensions上，針對6個(gè)級別的日志記錄均定義了6個(gè)如下形式的擴展方法，實(shí)例如下：

　　public static void LogInformation(this ILogger logger, string message)public static void LogInformation(this ILogger logger, int eventId, string message)public static void LogInformation(this ILogger logger, string format, params object[] args)public static void LogInformation(this ILogger logger, int eventId, string format, params object[] args)public static void LogInformation(this ILogger logger, ILogValues state, Exception error = null)public static void LogInformation(this ILogger logger, int eventId, ILogValues state, Exception error = null)// 其它Debug、Verbose、Warning、Error、Critical也都遵循LogXXXX()規則.

　　所以使用的時(shí)候，我們可以使用像LogDebug()、LogError()這樣的方法來(lái)進(jìn)行快速記錄日志。另外，該類(lèi)還為Warning、Error、Critical三個(gè)級別，又分別定義了2個(gè)擴展方法，示例如下：

　　public static void LogWarning(this ILogger logger, string message, Exception error)public static void LogWarning(this ILogger logger, int eventId, string message, Exception error)

　　有些這些擴展方法，使用起來(lái)估計打遍天下無(wú)敵手了。

　　總結：通過(guò)基于接口的編程機制和DI依賴(lài)注入機制，我們可以很容易實(shí)現第三方日志provider的擴展，從而將日志記錄到我們想記錄的任意地方，如MongoDB等NoSQL數據庫。

【解讀ASP.NET 5 MVC6系列教程】相關(guān)文章：

ASP.NET MVC異常處理模塊簡(jiǎn)單教程-ASP.NET教程實(shí)例推薦07-19

21世紀大學(xué)英語(yǔ)讀寫(xiě)基礎教程The Future課文解讀10-30

asp.net的學(xué)習過(guò)程講解07-11

ASP.NET Page函數調用解析10-01

調酒教程10-21

插花技巧教程07-14

cad成組教程05-20

梵語(yǔ)名詞教程10-14

php高級教程01-23

插花培訓教程01-04