[转]log4net使用(WinForm/WebFrom)

原来的一篇文章,今天用 WLW 转到页面上,原文章以及附件下载地址:http://zhq.ahau.edu.cn/blog/article.asp?id=366


--------------------------------------------------------------------------------

log4net为Apache 的一个子项目,其为Java版的.Net实现,具体介绍可以参看其官方网站,另外其下载地址和详细开发文档也可以找到.

Log4net官方网站http://logging.apache.org/log4net

WinForm和WebForm中的使用方式有点雷同,基本为(1.)配置config,(2.)初始化日志系统,(3.)类文件内记录日志.

Config 文件内的配置方法可以为以下:

<configuration>
<!--日志配置部分-->
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net"/>
</configSections>
<!--站点日志配置部分-->
<log4net>
<root>
<priority value="ALL"/>
<appender-ref ref="RollingFileAppender"/>
</root>
<appender name="TraceAppender" type="log4net.Appender.TraceAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"/>
</layout>
</appender>
<appender name="ConsoleAppender" type="log4net.Appender.ConsoleAppender">
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"/>
</layout>
</appender>
<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
<file value="log\\log.txt"/>
<appendToFile value="true"/>
<maxSizeRollBackups value="10"/>
<maximumFileSize value="2000KB"/>
<rollingStyle value="Size"/>
<staticLogFileName value="true"/>
<lockingModel type="log4net.Appender.FileAppender+MinimalLock"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"/>
</layout>
</appender>
</log4net>
</configuration> 

以上配置信息提供了RollingFile方式的日志记录方式,并保存在log.txt文件内,当日志文件超过2000k时就会自动更名,并建立新的log.txt文件,配置文件的具体使用说明可以参看log4net的开发文档.

Log4net的基本使用方式可以参看其开发文档.这里提供一个cnblogs.com的某牛人写的一个日志操作类(AppLog.cs),这样就可以很方便使用log4net日志系统了,但缺点也就出现了(具体的缺点就是在WinForm程序内无法捕捉到追加日志的具体位置了).下面为AppLog.cs文件具体代码:

    /**//// <summary>
/// 日志处理
/// </summary>
public class AppLog
{
/**//// <summary>
/// 静态类
/// </summary>
private AppLog(){}
private const string LOG_REPOSITORY = "Default"; // this should likely be set in the web config.
private static ILog m_log;
/**//// <summary>
/// 初始化日志系统
/// 在系统运行开始初始化
/// Global.asax Application_Start内
/// </summary>
public static void Init()
{
log4net.Config.XmlConfigurator.Configure();
}
/**//// <summary>
/// 写入日志
/// </summary>
/// <param name="message">日志信息</param>
/// <param name="messageType">日志类型</param>
public static void Write(string message, LogMessageType messageType)
{
DoLog(message, messageType, null, Type.GetType("System.Object"));
}
/**//// <summary>
/// 写入日志
/// </summary>
/// <param name="message">日志信息</param>
/// <param name="messageType">日志类型</param>
/// <param name="type"></param>
public static void Write(string message, LogMessageType messageType, Type type)
{
DoLog(message, messageType, null, type);
}
/**//// <summary>
/// 写入日志
/// </summary>
/// <param name="message">日志信息</param>
/// <param name="messageType">日志类型</param>
/// <param name="ex">异常</param>
public static void Write(string message, LogMessageType messageType, Exception ex)
{
DoLog(message, messageType, ex, Type.GetType("System.Object"));
}
/**//// <summary>
/// 写入日志
/// </summary>
/// <param name="message">日志信息</param>
/// <param name="messageType">日志类型</param>
/// <param name="ex">异常</param>
/// <param name="type"></param>
public static void Write(string message, LogMessageType messageType, Exception ex,
Type type)
{
DoLog(message, messageType, ex, type);
}
/**//// <summary>
/// 断言
/// </summary>
/// <param name="condition">条件</param>
/// <param name="message">日志信息</param>
public static void Assert(bool condition, string message)
{
Assert(condition, message, Type.GetType("System.Object"));
}
/**//// <summary>
/// 断言
/// </summary>
/// <param name="condition">条件</param>
/// <param name="message">日志信息</param>
/// <param name="type">日志类型</param>
public static void Assert(bool condition, string message, Type type)
{
if (condition == false)
Write(message, LogMessageType.Info);
}
/**//// <summary>
/// 保存日志
/// </summary>
/// <param name="message">日志信息</param>
/// <param name="messageType">日志类型</param>
/// <param name="ex">异常</param>
/// <param name="type">日志类型</param>
private static void DoLog(string message, LogMessageType messageType, Exception ex,
Type type)
{
m_log = LogManager.GetLogger(type);
switch (messageType)
{
case LogMessageType.Debug:
AppLog.m_log.Debug(message, ex);
break;
case LogMessageType.Info:
AppLog.m_log.Info(message, ex);
break;
case LogMessageType.Warn:
AppLog.m_log.Warn(message, ex);
break;
case LogMessageType.Error:
AppLog.m_log.Error(message, ex);
break;
case LogMessageType.Fatal:
AppLog.m_log.Fatal(message, ex);
break;
}
}
/**//// <summary>
/// 日志类型
/// </summary>
public enum LogMessageType
{
/**//// <summary>
/// 调试
/// </summary>
Debug,
/**//// <summary>
/// 信息
/// </summary>
Info,
/**//// <summary>
/// 警告
/// </summary>
Warn,
/**//// <summary>
/// 错误
/// </summary>
Error,
/**//// <summary>
/// 致命错误
/// </summary>
Fatal
}
}此类中提供日志的几种类型的一个枚举LogMessageType,将log4net中的几种日志记录方式进行了类型化抽象.记录日志时可以调用Write()方法写入日志. Write()有几个重载方法,可以实现不同的记录日志方式.例如:异常日志处理方式:

Utility.AppLog.Write("Exception:", Utility.AppLog.LogMessageType.Error, ex);一般的信息类型的日志处理

Utility.AppLog.Write("写入日志测试", Utility.AppLog.LogMessageType.Info);WinForm中使用时在Main()方法内初始化log4net日志系统.

//初始化日志使用封装类

Utility.AppLog.Init();

WebForm中使用时除config文件配置log4net相关设置部分,还需要在全局文件中(Global.asax)初始化相关日志处理类:

    void Application_Start(object sender, EventArgs e)
{
// 在应用程序启动时运行的代码
//初始化日志使用封装类
TestLog4net.Utility.AppLog.Init();
TestLog4net.Utility.AppLog.Write("Web站点运行", TestLog4net.Utility.AppLog.LogMessageType.Info);
}
void Application_End(object sender, EventArgs e)
{
//  在应用程序关闭时运行的代码
TestLog4net.Utility.AppLog.Write("Web站点关闭", TestLog4net.Utility.AppLog.LogMessageType.Info);
} 

为了捕捉Web站点的异常还需要在全局文件Application_Error中捕捉异常,并写入日志:

    void Application_Error(object sender, EventArgs e)
{
// 在出现未处理的错误时运行的代码
Exception ex = Server.GetLastError();
if (ex != null)
{
//写入错误日志
TestLog4net.Utility.AppLog.Write("[Exception]:", TestLog4net.Utility.AppLog.LogMessageType.Error, ex);
throw ex;
}
}大概就记这么多东西,详细的使用代码可以在演示代码文件(TestLog4net)内找到.

演示代码内除了使用封装好的日志操作类记录日志外,还有使用log4net开发文档内所介绍的日志记录方式来记录日志.

演示代码项目具体目录如下:



TestLog4net.WebProject 为web使用测试项目,使用时可能要重新加载一下路径.

TestLog4net.Utility 为log4net的使用封装类AppLog.cs类.

TestLog4net.WinForm 为WinForm使用测试项目.