解读解读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的实现,也相对简单,除了实现通用的日志记录方法以外,还需要实现一个日志级别判断的方法以及一个作用域创
评论0
最新资源