VeryCodes.Log让日志记录和读取变的更简单

在.NET程序开发领域，log4net和nlog是两个十分优秀的日志组件，并且被广泛使用。当然还有一些系统独立开发使用读写文本文件（或其它存储格式）的方式处理日志。所以.net的日志处理方式大体可以分为：log4net、nlog和系统自定义日志处理三种方式。VeryCodes.Log并没有提供新的日志处理方式，这个类库提供了对以上三种方式的集成，达到使日志处理更简单，更统一的目的。

一、程序结构

VeryCodes.Log定义了两个接口ILogWriter和ILogReader。ILogWriter用于记录日志；ILogReader用于读取日志。

图1：ILogWriter

如图1中所示，所有日志记录类都实现了ILogWriter，目前提供了NLogWriter、Log4netWriter和SimpleLogWriter三个日志记录类。

默认的情况下（没有提供相应组件的配置文件）日志都将被记录到文本文件。

图2：ILOgReader

本程序只实现了一个日志读取类，该类只可以读取记录到文本文件的日志。

二、日志记录

1、Log4net

使用log4net组件记录日志，首先定义自己的日志记录类，可以定义多个类，这里定义一个类MyLog。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.IO;
using VeryCodes.Log;

/// <summary>
///MyLog 的摘要说明
/// </summary>
public class MyLog : Log4netWriter
{
    /// <summary>
    /// 调用静态方法或属性时创建实例
    /// </summary>
    static MyLog()
    {
        string path = AppDomain.CurrentDomain.SetupInformation.ApplicationBase;
        Instance = new MyLog("MyLog", new FileInfo(path + @"\logs\MyLog.xml"), true);
    }

    /// <summary>
    /// 使用指定的配置文件创建日志类的一个实例
    /// </summary>
    private MyLog(string loggerName, FileInfo configFile, bool isWatch)
        : base(loggerName, configFile, isWatch)
    {
    }

    /// <summary>
    /// 获取日志类的实例
    /// </summary>
    public static MyLog Instance
    {
        get;
        set;
    }
}

这里使用了继承的方式，当然也可以初始化为一个静态实例。目前log4net必须提供自己的配置文件，今后可能实现零配置。
程序中记录日志：

MyLog.Instance.ToInfo("I am a infoer."); 

MyLog.Instance.ToError("I am an errorer!");

2、Nlog
使用Nlog组件记录日志，首先定义自己的日志记录类，可以定义多个类，这里定义一个类MyNLog。

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Web; 

using VeryCodes.Log; 

/// <summary> 

///MyNLog 的摘要说明 

/// </summary> 

public class MyNLog : 
NLogWriter 

{ 

    /// 
<summary> 

    /// 
调用静态方法或属性时创建实例 

    /// 
</summary> 

    static MyNLog() 

    { 

        Instance = new 
MyNLog("MyNLog"); 

    } 

    /// 
<summary> 

    /// 
使用指定的配置文件创建日志类的一个实例 

    /// 
</summary> 

    private MyNLog(string 
loggerName) 

        : 
base(loggerName) 

    { 

    } 

    /// 
<summary> 

    /// 
获取日志类的实例 

    /// 
</summary> 

    public static 
MyNLog Instance 

    { 

        get; 

        set; 

    } 

}

这里使用了继承的方式，当然也可以初始化为一个静态实例。可以看到nlog已经实现了零配置，当然也可以在初始化的时候指定配置文件。
程序中记录日志：

MyNLog.Instance.ToDebug("Hello NLog Debug!"); 

MyNLog.Instance.ToInfo("Hello NLog Info!");

3、简单日志记录类：SimpleLogWriter

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Web; 

using VeryCodes.Log; 

/// <summary> 

/// 使用SimpleFileLog的日志类 

/// </summary> 

public class MySimpleFileLog 

{ 

    /// 
<summary> 

    /// 
SimpleFileLog静态实例 

    /// 
</summary> 

    public static 
readonly SimpleLogWriter Instance; 

    /// 
<summary> 

    /// 
静态构造函数 

    /// 
</summary> 

    static MySimpleFileLog() 

    { 

        string filePath = 
HttpContext.Current.Server.MapPath("~/logs"); 

        string prefix = 
"MySFL"; 

        string fileExt = 
".log"; 

        string timeFormat = 
"yyyy_MM_dd_HH"; 

        LogLevel level = LogLevel.Debug; 

        Instance = new 
SimpleLogWriter(filePath, prefix, fileExt, 
timeFormat, level); 

    } 

    /// 
<summary> 

    /// 
记录Debug日志 

    /// 
</summary> 

    /// 
<param name="msg"></param> 

    public static 
void ToDebug(object 
msg) 

    { 

        Instance.ToDebug(msg); 

    } 

    /// 
<summary> 

    /// 
记录Info日志 

    /// 
</summary> 

    /// 
<param name="msg"></param> 

    public static 
void ToInfo(object 
msg) 

    { 

        Instance.ToInfo(msg); 

    } 

    /// 
<summary> 

    /// 
记录Error日志 

    /// 
</summary> 

    /// 
<param name="msg"></param> 

    public static 
void ToError(object 
msg) 

    { 

        Instance.ToError(msg); 

    } 

}

程序中记录日志：

MySimpleFileLog.ToDebug("I am a debuger!"); 

MySimpleFileLog.ToInfo("I am a infoer!"); 

MySimpleFileLog.ToError("I am a errorer!");

三、日志读取
CommonLogReader实现了读取文本日志的相关方法，支持按照日志级别和日志记录时间过滤日志数据。

string path = Server.MapPath("~/logs/MySFL_2011_07_22_09.log"); 

CommonLogReader reader = 
new CommonLogReader(); 

DateTime startTime = 
DateTime.Parse("2011-07-22 
09:47:00"); 

DateTime endTime = 
DateTime.Parse("2011-07-22 
09:47:59"); 

string result = reader.ReadFile(path, startTime, 
endTime);

日志中的记录需要以时间为开头，才能进行正确的解析。例如使用SimpleLogWriter记录的日志：

2011-07-20 16:21:09,911 [Debug] - 
日志启动... 

2011-07-20 16:21:09,929 [Debug] - I 
am a debuger! 

2011-07-20 16:21:09,929 [Info] - I 
am a infoer! 

2011-07-20 16:21:09,929 [Error] - I 
am a errorer! 

2011-07-20 16:21:09,960 [Error] - I 
am a errorer! [Exception]System.DivideByZeroException:尝试除以零。 

   在 
VeryCodes_Log_SimpleFileLog.Button1_Click(Object sender, EventArgs e) 位置 
e:\Demo\VeryCodes 
Framework\Demo\VeryCodes.Log.Demo\VeryCodes_Log\SimpleFileLog.aspx.cs:行号 23 

2011-07-20 16:21:09,429 [Info] - I 
am a infoer! 

   在 
VeryCodes_Log_SimpleFileLog.Button1_Click(Object sender, EventArgs e) 位置 
e:\Demo\VeryCodes 
Framework\Demo\VeryCodes.Log.Demo\VeryCodes_Log\SimpleFileLog.aspx.cs:行号 23 

2011-07-20 16:21:10,929 [Info] - I 
am a infoer! 

2011-07-20 16:21:39,929 [Info] - I 
am a infoer! 

   在 
VeryCodes_Log_SimpleFileLog.Button1_Click(Object sender, EventArgs e) 位置 
e:\Demo\VeryCodes 
Framework\Demo\VeryCodes.Log.Demo\VeryCodes_Log\SimpleFileLog.aspx.cs:行号 23 

2011-07-20 16:21:09,929 [Error] - I 
am a errorer! 

2011-07-20 16:21:19,929 [Info] - I 
am a infoer! 

2011-07-20 16:21:29,929 [Error] - I 
am a errorer!

这个日志读取程序使用正则表达式进行匹配，可以完整的读取发生异常时的堆栈信息。

如果你觉得还可以，赶紧来试用下吧。点击这里下载类库。

欢迎就使用过程中的问题与我讨论。

来源：http://blog.bossma.cn/csharp/verycodes_log_for_simple_log/