首页 > 代码库 > Catel帮助手册-Catel.Core(6):日志管理

Catel帮助手册-Catel.Core(6):日志管理

1,简介

     从2.2版本开始,Catel使用了一个自定义的日志系统,这种方式,针对log4net的引用可以被移除,做这个修改主要是为了不强迫用户使用log4net,同时,log4net看起来很长时间不更新了,其他的日志系统如NLog看起来在增长,新的日志系统将允许许多基础的日志,这样,日志将将非常简单,并且如果他需要,真正的日志将被用户执行。

1.1 Log和ILog

     所有的日志将通过ILog接口。这个接口被自动的注册到Catel中的所有对象上作为Log字段,ILog接口仅仅有一个实现,每个对象能够调用Log自动的方法来记录任何信息。

     在Catel中,仅仅有一个类继承与ILog接口,那就是Log类,这个类确保了日志消息能够正确的格式化,并且在消息写入日志的时候会触发LogMessage事件。

    Cate内部创建了一个独立的Log类型,这样,开发者能够在许多日志中筛选它自己感兴趣的日志。

1.2 LogManager

 

  LogManager是一个管理类,它将为类型创建新的日志,但是也跟踪所有的日志和日志监听,为了返回一个指定类的日志,可以使用如下代码。

 

private static readonly ILog Log = LogManager.GetCurrentClassLogger();

 

1.3 用代码记录日志

使用代码记录日志,ILog接口实现一些基础的方法来记录信息和一些额外数据选项,有一些扩展方法可以记录异常,字符串格式,等等,下面是记录履历的例子:

Log.Warning("Customer ‘{0}‘ does not exist", customerId);

或者,如果异常有效,也能写入到日志中。

Log.Error(ex, "Failed to delete file ‘{0}‘", fileName);

 

1.4 记录到output窗口或者console中

默认情况下,Catel并不增加任何监听,然后,它包含一个立即可用的实现将日志写入到output窗口或者console中,这个就是DebugLogListener,为了注册这个监听,可以使用如下代码。

#if DEBUGLogManager.AddDebugListener();#endif

在Catel3.8之前,使用的是LogManager.RegisterDebugListener()

 

1.5 重写全局的标记级别

从3.8开始可以针对所有的监听重写全区日志标记,如果要这样做,在LogManager上设置一直的值,例如,在所有的监听上强制显示调试履历,使用如下代码:

LogManager.IsDebugEnabled = true;

要重写设置override,设置值为空:

LogManager.IsDebugEnabled = null;

2,自定义监听

每一个监听都可以自定义来返回监听者感兴趣的日志,这样,监听者如果不感兴趣,可以不返回事件,例如,仅仅返回错误,创建一个新的监听如下:

var listener = new MyLogListener(); listener.IsDebugEnabled = false;listener.IsInfoEnabled = false;listener.IsWarningEnabled = false;listener.IsErrorEnabled = true;

默认情况下,所有的日志都会被监听。

3,批量日志监听

批量日志监听是继承IBatchLogListener接口的类(大部分可能继承与BatchLogListenerBase),这个接口增加了一个Flushmethod方法,允许监听者被清理掉,进一步的是日志监听写了一个较慢的监听存储。这个将不会访问每一个源头,而只是批量处理。

3.1 Flushing所有的监听者

       当使用批量日志监听者时,当应用程序异常或者是退出时清理所有监听者时很重要的,这是因为有些重要的日志没有持久化到文件中的会丢失掉。

  要flushing所有的监听者需要使用如下代码

LogManager.FlushAll();

3.2 实现一个自定义的IBatchLogListener

当实现一个通用的批量日志监听者,常用的方式是继承BatchLogListenerBase类,这个有如下优点:

1,BatchLogListenerBase是线程安全的

2,BatchLogListenerBase每5秒钟会自动的flushes监听者。

你只需要实现WriteLog方法来决定持久化存储的入口,下面是例子:

public class FileLogListener : BatchLogListenerBase{    private readonly string _filePath;    private readonly int _maxSizeInKiloBytes;    public FileLogListener(string filePath, int maxSizeInKiloBytes)    {        Argument.IsNotNullOrWhitespace(() => filePath);        _filePath = filePath;        _maxSizeInKiloBytes = maxSizeInKiloBytes;    }    protected override void WriteBatch(System.Collections.Generic.List<LogBatchEntry> batchEntries)    {        try        {            var fileInfo = new FileInfo(_filePath);            if (fileInfo.Exists && (fileInfo.Length / 1024 >= _maxSizeInKiloBytes))            {                CreateCopyOfCurrentLogFile(_filePath);            }            using (var fileStream = new FileStream(_filePath, FileMode.Append, FileAccess.Write, FileShare.Read))            {                using (var writer = new StreamWriter(fileStream))                {                    foreach (var batchEntry in batchEntries)                    {                        var message = FormatLogEvent(batchEntry.Log, batchEntry.Message, batchEntry.LogEvent, batchEntry.ExtraData);                        writer.WriteLine(message);                    }                }            }        }        catch (Exception)        {            // Swallow        }    }    private void CreateCopyOfCurrentLogFile(string filePath)    {        for (int i = 1; i < 999; i++)        {            var possibleFilePath = string.Format("{0}.{1:000}", filePath, i);            if (!File.Exists(possibleFilePath))            {                File.Move(filePath, possibleFilePath);            }        }    }}

5,集成第三方日志功能

     Catel中的日志默认并不写任何输出,这个给了开发者自由,可以使用任何最终的日志机制来处理它。例如Catel可以很容易的使用log4net或者NLOG来集成,通常,下面步骤需要来执行去集成日志。

1,创建自己的或者使用LogListenerBase创建一个自定义的ILogListener

2, 使用LogManager.AddListener将其注册进去。

  1. 5.1 集成Log4net方法

下面的例子为Log4net提供了一个ILogListener,但是有些额外的Log库可以被使用。

5.1.1 创建Listener

通过继承LogListenerBase来创建一个新的类:

 

public class Log4netListener : LogListenerBase{    protected override void Debug(ILog log, string message, object extraData)    {        var finalLog = log4net.LogManager.GetLogger(log.TargetType);        finalLog.Debug(message);    }     protected override void Info(ILog log, string message, object extraData)    {        var finalLog = log4net.LogManager.GetLogger(log.TargetType);        finalLog.Info(message);    }     protected override void Warning(ILog log, string message, object extraData)    {        var finalLog = log4net.LogManager.GetLogger(log.TargetType);        finalLog.Warn(message);    }     protected override void Error(ILog log, string message, object extraData)    {        var finalLog = log4net.LogManager.GetLogger(log.TargetType);        finalLog.Error(message);    }}

 

5.1.2 注册一个监听

     最后同样重要的,去注册这个监听

LogManager.AddListener(new Log4netListener());

 

5.1.3 配置log4net

    注意,这仅仅是一个简单的配置,请查看log4net文档看所有的选项:

1,增加log4net的引用

2,增加[assembly: log4net.Config.XmlConfigurator(Watch = true)] 到AssemblyInfo.cs

3,在app.config中配置log4net的实际数据

 

 

5.2继承NLog方法

下面的例子为NLog提供了一个ILogListener,但是有些额外的Log库可以被使用。

5.2.1 创建Listener

通过继承LogListenerBase来创建一个新的类:

 

public class NLogListener : LogListenerBase{    protected override void Debug(ILog log, string message, object extraData)    {        var finalLog = NLog.LogManager.GetLogger(log.TargetType.ToString());        finalLog.Debug(message);    }     protected override void Info(ILog log, string message, object extraData)    {        var finalLog = NLog.LogManager.GetLogger(log.TargetType.ToString());        finalLog.Info(message);    }     protected override void Warning(ILog log, string message, object extraData)    {        var finalLog = NLog.LogManager.GetLogger(log.TargetType.ToString());        finalLog.Warn(message);    }     protected override void Error(ILog log, string message, object extraData)    {        var finalLog = NLog.LogManager.GetLogger(log.TargetType.ToString());        finalLog.Error(message);    }}

5.1.2 注册一个监听

     最后同样重要的,去注册这个监听

LogManager.AddListener(new NLogListener());

 

 

 

 

6,将日志写入到磁盘

Catel也支持非常轻量监听来允许其他的外部库,创建一个监听,先创建一个新的类来继承与ILogListener,下一步,将其注册到LogManager中。

ILogListener针对每个LogEvent有一个独立的方法,但是也有一个共享的方法来调用,例如,如果debug信息被写入日志中,Write和Debug方法都会在ILogListener上被调用。

注意:要看批量写入磁盘的例子,可以看前面的日志更新

注意:Catel已经包含了一个FileLogListener,不需要重写这个类,它作为一个例子是很容易理解的。

 

6.1创建一个监听

可以写一个新的类继承于LogListenerBase。

public class FileLogListener : LogListenerBase{    private readonly TextWriter _textWriter;     public FileLogListener(string fileName)    {        Argument.IsNotNullOrWhitespace("fileName", fileName);        FileName = fileName;         _textWriter = new StreamWriter(fileName, true);    }     public string FileName { get; private set; }     public override void Write(ILog log, string message, LogEvent logEvent)    {        _textWriter.WriteLine(message);    }}

 

6.2 注册监听

最后同样重要的注册这个监听

LogManager.AddListener(new FileLogListener("<log_file_path>"));

 

 

7,通过配置文件来创建监听

 

从3.8开始,可以通过配置文件初始化LogListener,下面是一个例子

 

 

<configSections>    <sectionGroup name="catel">        <section name="logging" type="Catel.Logging.LoggingConfigurationSection, Catel.Core" />    </sectionGroup></configSections> <catel>    <logging>        <listeners>            <listener type="Catel.Logging.FileLogListener" FilePath="CatelLogging.txt" IgnoreCatelLogging="true" IsDebugEnabled="false" IsInfoEnabled="true" IsWarningEnabled="true" IsErrorEnabled="true"/>        </listeners>    </logging></catel>

上面Logging节点,需要保护一个没有限制数量的监听,每个监听中至少要提供类型的命名空间

<listener type="Catel.Logging.FileLogListener" />

其他的属性是自定义的,者意味着可以自定义每个加入进来的监听,下面是注册FileLogListener的配置

<listener type="Catel.Logging.FileLogListener" FilePath="CatelLogging.txt" IgnoreCatelLogging="true"          IsDebugEnabled="false" IsInfoEnabled="true" IsWarningEnabled="true" IsErrorEnabled="true"/>

ILogListenr属性(IsDebugEnabled, IsInfoEnabled, IsWarningEnabled and IsErrorEnabled)是对所有的监听有效的,其他的选项依赖于具体的监听类,这样可以提高运行时的灵活性。

Catel帮助手册-Catel.Core(6):日志管理