Log4net 使用文档(概念)

Wei.Lee — Tue, 28 Mar 2006 14:17:00 GMT

日志部分在程序中占了4%�Q�有利于帮助我们很快地得到我们需要的调试信息�Q�找到问题的�Ҏ��快解决问题�Q�从而降低我们的�l�护成本。这几天一直断断箋�l�地学习Log4net部分�Q�由于知道自己在一个比较长的时间必��d��使用.net的部分（HA Project and LIS Project�Q�，没办法，只有��着头皮死肯�Q�）�Q�不�q�也让我见识不少呢！log4net是appache开源的一个杰作，和log4J很相象，如同孪生的兄弟一��P��基本的概念原理都是一��L��Q�她主要应用�?net上的。下面是我一些收集的资料�Q�同时也是我在开发过�E�中的一些经验�ȝ��。稍后也会把一些实际项目的�l�验记录下来�Q�和使用Log4J的相兛_��宏V�?br />
Log4net 主要有四个组件。分别是Logger(记录�?/span>)�Q?/span>Repository(�?/span>)�Q?/span>Appender(附着�?/span>)�?/span>Layout(布局)�?/span>

Logger 定义与用途：

Logger 是应用程序需要交互的主要�l��g�Q�它用来产生日志消息。��生的日志消息�q�不直接昄��Q�还要预先经�q?/span> Layout 的格式化处理后才会输出�?/span>

Root 是一个默认的 Logger �Q�当一�?/span> root �?/span> Logger 内容配置一致的时候就会记录两条相同的记录�Q�当在配�|�文件中找不�?/span> logger 的名字时候，��׃��使用root的配�|��?/span>

Repository 定义与用途：

Repository 主要用于负责日志对象�l�织�l�构的维护。现�?已经使用LogManager�c�L��l�护日志对象�l�织�?/span>

Appender 定义及用途：

定义输出介质�Q�可以把多个 Aappender 附加��C��个日志对象中, 一�?/span>Appender对象�~�省地把所有的日志事�g传递到输出��中�Q�我们可以通过Aappender Filters来过滤剩下我们需要的部分。分别有�U�别�q��o�Q�定义��别区��_��Q�字�W�串�q��o�Q�可以定义多�?/span>filter。such as :LevelMatchFilter�?font face="Verdana">LevelRangeFilter�?/font>MDCFilter、NDCFilter�?StringMatchFilter.

Layout 定义与用�?/span>

Layout �l��g用于向用��h��C�最后经�q�格式化的输��Z��息。可以是�U�性的或一�?/span> XML 文�g�?/span> Layout �l��g和一�?/span> Appender �l��g一起工作。也��是说一�?/span> appender 对象只能对应一�?/span> layout 对象�?/span>

Log4net DEBUG 信息分��Q?/span>

一共有七��

�U�别
允许�Ҏ��

Boolean 属�?/span>

优先�U�别

OFF �Q�拒�l�所有的日志��h��Q?/span> FATAL ERROR

null void Fatal(...); void Error(...);

null bool IsFatalEnabled; bool IsErrorEnabled;

Highest second three

WARN INFO DEBUG

void Warn(...); void Info(...); void Debug(...);

bool IsWarnEnabled; bool IsInfoEnabled; bool IsDebugEnabled;

four five six

ALL �Q�允许所有的日志��h��Q?/span>

Null

Lowest

Log4net 配置方式�Q?/span>

1�Q?span style="FONT: 7pt 'Times New Roman'"> 在单独文仉��配置�Q�推荐）�Q�改变配�|�不需要重新编译代码，同时也可以在�E�序�q�行的过�E�中修改代码�?/span>

2�Q?span style="FONT: 7pt 'Times New Roman'"> 在程序代码中配置

兌��配置文�g�Q?/span>

log4net 框架使用 ~~log4net.Config.DOMConfiguratorAttribute~~ log4net.Config.XmlConfigurator 在程序集的��别上定义配置文�g。方法有多种的：
1 �Q�可以在��目�?/span> AssemblyInfo.cs 文�g里添加以下的语句

[assembly:log4net.Config.XmlConfigurator(ConfigFile="filename", ConfigFileExtension="ext",Watch=true/false)]

其中 configFile 讑֮�了配�|�文件的文�g名，路径�Q�扩展名

configFileExtension 讑֮�了被�~�译的文件��用扩展名字，默认�?/span> config

但是configFileExtension与configFile不能同时使用。在�q�里我们可以兌��我们手动配置的文�Ӟ��而不使用.net�l�我们的应用�E�序配置文�g�?br />eg�Q?br />[assembly:log4net.Config.DOMConfigurator(ConfigFile="/Projects/Regular/bin/config/App.log.conf.xml",Watch=true)]

2 �Q�可以不带参数应�?/span> DOMConfiguratio():

[assembly: log4net.Config.DOMConfigurator()]

3�Q?span style="FONT: 7pt 'Times New Roman'"> 也可以在�E�序代码中用 DOMConfigurator �c�L��开配置文�g。类的构造函数需要一�?/span> FileInfo 对象作参敎ͼ�以指��打开的配�|�文件名�?/span>

log4net.Config.DOMConfigurator.Configure(

new FileInfo("TestLogger.Exe.Config"));

创徏日志对象�Q?/span>

当日志对象没有在配置文�g中定义的话，��׃��使用 root 的祖父节炏V�?/span>

Log4net.ILog log = Log4net.LogManager.GetLogger("MyLogger");

输出日志信息�Q?/span>

可以使用输出日志的几�U�方式：fatal();error();warn();info();debug();

if (log.IsDebugEnabled) log.Debug("message");

DEBUG 输出格式的意义：

Eg �Q?/span>

value="%d [%t] %-5p %c [%x] - %m%n"

%m(message): 输出的日志消息，�?/span> ILog.Debug( �?/span> ) 输出的一条消�?/span>

%n(new line): 换行

%d(datetime): 输出当前语句�q�行的时�?/span>

%r(run time): 输出�E�序从运行到执行到当前语句时消耗的毫秒�?/span>

%t(thread id): 当前语句所在的�U�程 ID

%p(priority): 日志的当前优先��别，�?/span> DEBUG �?/span> INFO �?/span> WARN …等

%c(class): 当前日志对象的名�U�ͼ�例如�Q?/span>

模式字符串�ؓ�Q?/span> %-10c -%m%n

代码为：

ILog log=LogManager.GetLogger(“Exam.Log�?;

log.Debug(“Hello�?;

则输��Zؓ下面的�Ş式：

Exam.Log - Hello

%L �Q�输��句所在的行号。包括类目名、发生的�U�程�Q�以及在代码中的行数�?/span>

%F �Q�输��句所在的文�g�?/span>

%- 数字�Q�表�C��的最��长度，如果不够�Q�则用空格填�?/span>

例如�Q��{换模式�ؓ %r [%t]%-5p %c - %m%n �?/span> PatternLayout ��生成类��g��以下内容的输出：

176 [main] INFO org.foo.Bar - Located nearest gas station.
(未完待箋)

Wei.Lee 2006-03-28 22:17 发表评论

在线观看国产v片,欧美精品电影免费在线观看,热99在线视频

Log4net 使用文档(概念)