解读ASP.NET5&MVC6系列(9):日志框架

 框架介绍

在扶余等地区,都构建了全面的区域性战略布局,加强发展的系统性、市场前瞻性、产品创新能力,以专注、极致的服务理念,为客户提供网站制作、网站设计 网站设计制作定制设计,公司网站建设,企业网站建设,成都品牌网站建设,全网整合营销推广,成都外贸网站建设公司,扶余网站建设费用合理。

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

ILoggerFactory接口

ILoggerFactory接口是日志的入库点,在系统中通过依赖注入可以获取该接口的实例,并根据该示例创建日志记录器ILogger来记录日志,示例如下:

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接口的定义如下:

 
 
  1. public interface ILoggerFactory 
  2.     //日志最小记录级别 
  3.     LogLevel MinimumLevel { get; set; } 
  4.  
  5.     //创建日志记录实例 
  6.     ILogger CreateLogger(string categoryName); //一般是根据功能模块或类名进行分类 
  7.  
  8.     void AddProvider(ILoggerProvider provider);  // 添加日志记录provider(如第三方实现) 
  9. }

在该接口的实现中,我们可以设置日志的最小记录基本,其类别如下

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

也可以添加第三方实现的Provider,比如添加一个控制台版本的实现:

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

然后通过CreateLogger方法创建日志记录器实例,***再记录日志。

ILoggerProvider和ILogger

所有的第三方实现都需要实现ILoggerProvider接口和ILogger接口,其中接口很简单,就是实现创建ILogger接口的方法即可,代码如下:

 
 
  1. public interface ILoggerProvider 
  2.     ILogger CreateLogger(string name); //创建给定类别的ILgger实例 
  3. }

而ILogger的实现,也相对简单,除了实现通用的日志记录方法以外,还需要实现一个日志级别判断的方法以及一个作用域创建方法,接口定义如下:

 
 
  1. public interface ILogger 
  2.     //支持大多数日志记录的通用方法,其它访问通过扩展方法进行完善 
  3.     void Log(LogLevel logLevel, int eventId, object state, Exception exception, Func 

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

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

ILogger的扩展方法

为了方便记录日志,微软在Microsoft.Framework.Logging.LoggerExtensions上,针对6个级别的日志记录均定义了6个如下形式的扩展方法,实例如下:

 
 
  1. public static void LogInformation(this ILogger logger, string message) 
  2. public static void LogInformation(this ILogger logger, int eventId, string message) 
  3. public static void LogInformation(this ILogger logger, string format, params object[] args) 
  4. public static void LogInformation(this ILogger logger, int eventId, string format, params object[] args) 
  5. public static void LogInformation(this ILogger logger, ILogValues state, Exception error = null) 
  6. public static void LogInformation(this ILogger logger, int eventId, ILogValues state, Exception error = null) 
  7.  
  8. // 其它Debug、Verbose、Warning、Error、Critical也都遵循LogXXXX()规则.

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

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

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

总结

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

分享名称:解读ASP.NET5&MVC6系列(9):日志框架
文章来源:http://www.gawzjz.com/qtweb2/news9/4909.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联