框架介绍
在之前的.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数据库。
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件! 如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。