解读ASP.NET 5 & MVC6系列（9）：日志框架

框架介绍

在以前的.NET中，微软尚未提供过像样的日志框架，目前能用的一些框架好比Log4Net、NLog、CommonLogging使用起来多多少少都有些费劲，和java的SLF4J根本没法相比。但在新版的ASP.NET5中，可谓是牛气冲天，微软提供的Microsoft.Framework.Logging框架集可谓就是.NET版的SLF4J，提供相应的接口，其它第三方组件能够根据接口实现本身的实现。

ILoggerFactory接口

ILoggerFactory接口是日志的入库点，在系统中经过依赖注入能够获取该接口的实例，并根据该示例建立日志记录器ILogger来记录日志，示例以下：

var factory = ServiceProvider.GetRequiredService<ILoggerFactory>();
 var logger1 = factory.CreateLogger(typeof(HomeController).FullName); //CreateLogger
 var logger2 = factory.CreateLogger<HomeController>();  //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; }

    //建立日志记录实例
    ILogger CreateLogger(string categoryName); //通常是根据功能模块或类名进行分类

    void AddProvider(ILoggerProvider provider);  // 添加日志记录provider（如第三方实现）
}

在该接口的实现中，咱们能够设置日志的最小记录基本，其类别以下：

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

也能够添加第三方实现的Provider，好比添加一个控制台版本的实现：

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

而后经过CreateLogger方法建立日志记录器实例，最后再记录日志。

ILoggerProvider和ILogger

全部的第三方实现都须要实现ILoggerProvider接口和ILogger接口，其中接口很简单，就是实现建立ILogger接口的方法便可，代码以下：

public interface ILoggerProvider
{
    ILogger CreateLogger(string name); //建立给定类别的ILgger实例
}

而ILogger的实现，也相对简单，除了实现通用的日志记录方法之外，还须要实现一个日志级别判断的方法以及一个做用域建立方法，接口定义以下：

public interface ILogger
{
    //支持大多很多天志记录的通用方法，其它访问经过扩展方法进行完善
    void Log(LogLevel logLevel, int eventId, object state, Exception exception, Func<object, Exception, string> formatter);

    //判断是否能够记录给定的日志级别
    bool IsEnabled(LogLevel logLevel);

    //开启一个逻辑操做做用域
    IDisposable BeginScopeImpl(object state);
}

实现了上述两个接口，便可经过factory的AddProvider方法，将该provider添加到实例中，达到记录日志的目的。ASP.NET 5中目前的默认实现了4中日志记录Provider，分别是：Console、NLog、Serilog、Trace，注册这些Provider的时候，都可以使用扩展方法，实例以下：

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个级别的日志记录均定义了6个以下形式的扩展方法，实例以下：

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()规则.

因此使用的时候，咱们可使用像LogDebug()、LogError()这样的方法来进行快速记录日志。另外，该类还为Warning、Error、Critical三个级别，又分别定义了2个扩展方法，示例以下：

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

有些这些扩展方法，使用起来估计打遍天下无敌手了。

总结

经过基于接口的编程机制和DI依赖注入机制，咱们能够很容易实现第三方日志provider的扩展，从而将日志记录到咱们想记录的任意地方，如MongoDB等NoSQL数据库。

同步与推荐

本文已同步至目录索引：解读ASP.NET 5 & MVC6系列