Log4j的配置文件

Log4j支持两种配置文件格式，一种是java属性文件（键—值），一种是xml格式文件。

这里仅介绍下java属性文件的配置方法。
先看看个配置文件：log4j.properties

log4j.rootCategory=debug,stdout,R

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) -%m%n

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%p %t %c -%m%n
#输出结果将写入 example.log
log4j.appender.R.File=example.log
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=1

[b]1、 Log4j.rootCategory=[ level | null ],appenderName,appenderName, ….[/b]

level:是日记记录的优先级，优先级由高到低分为 OFF ,FATAL ,ERROR ,WARN ,INFO ,DEBUG ,ALL。Log4j建议只使用FATAL ,ERROR ,WARN ,INFO ,DEBUG这四个级别。主意看到了null 了吧，所以在这里可以为空。

appenderName:指定日志信息输出到哪个地方，可以同时指定多个输出目的地。

[b]2、Appender的语法为：[/b]
log4j.appender.appenderName=full name of appender’s class
log4j.appender.appenderName.kind=kind1
…
log4j.appender.appenderName.kind=kindN

有5种appender,分别为
org.apache.log4j.ConsoleAppender (控制台)
org.apache.log4j.FileAppender (文件)
org.apache.log4j.DailyRollingFileAppender (每天产生一个日志文件)
org.apache.log4j.WriterAppender (将日志信息以流格式发送到任意指定的地方)


[b]3、Layout的语法为：[/b]
log4j.appender.appenderName.layout=full name of layout’s class
log4j.appender.appenderName.layout.kind=kind
…
log4j.appender.appenderName.layout.kind=kindN

有4种layout ,分别为
org.apache.log4j.HTMLLayout (以html格式表格形式布局)
org.apache.log4j.PatternLayout （自定义布局）
org.apache.log4j.SimpleLayout （包含日志信息的级别和信息字符串）
org.apache.log4j.TTCCLayout （包含日志产生的时间、线程、类别等信息）


[b]4、输出[/b]
都以%开始后面不同的参数代表不同的格式化信息（参数按字母表顺序列出）：
%c 输出所属类的全名，可在修改为 %d{Num} ,Num类名输出的范围 如："org.apache.xyz.SomeClass", %C{2}将输出xyz.SomeClass
%d 输出日志时间其格式为 %d{yyyy-MM-dd HH:mm:ss,SSS}，可指定格式 如 %d{HH:mm:ss}
%l 输出日志事件发生位置，包括类目名、发生线程，在代码中的行数
%n 换行符
%m 输出代码指定信息，如info(“message”),输出message
%p 输出优先级，即 FATAL ,ERROR 等
%r 输出从启动到显示该log信息所耗费的毫秒数
%t 输出产生该日志事件的线程名


[b]5、Threshold的语法[/b]

log4j.threshold=level

level就是前面所说的 OFF ,FATAL ,ERROR ,WARN ,INFO ,DEBUG ,ALL。Threshold是个全局的过滤器，它将把低于所设置的level的信息过滤不显示出来。
看一个例子：

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=[%t] %-5p %c - %m%n
#Only print log statement of level WARN or above regardless of the（只打印warn级别以上的信息）
#logger.
log4j.threshold=WARN

Threshold的用法很灵活，还可以在appender中增加threshold

log4j.rootLogger=DEBUG, C
log4j.appender.C=org.apache.log4j.ConsoleAppender
# Set the appender threshold to INFO
log4j.appender.C.Threshold=INFO
log4j.appender.C.layout=org.apache.log4j.PatternLayout
log4j.appender.C.layout.ConversionPattern=%-4r [%t] %-5p %c %x - %m%n

这里初始设置 level为DEBUG ，但log4j.appender.C.Threshold=INFO 设置为INFO。因为 INFO>DEBUG 所以如果含有DEBUG级别的信息，将被过滤。

[b]6、level of a logger[/b]
与threshold 相似，不过过滤得不是全部，而是将其所过滤的范围缩小到loggers所指级别内 。
同样看个例子（指定在chapter3包里面）

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=[%t] %-5p %c - %m%n
# Print only messages of priority WARN or above in package "chapter3".
log4j.logger.chapter3=WARN

下面是说明chapter3包里面各个level
Logger name Assigned level Effective level
Root DEBUG DEBUG
chapter3 WARN WARN
chapter3.MyApp2 null WARN
chapter3.Foo null WARN

接着把上面的例子改动一下：

log4j.rootLogger=DEBUG, CON
log4j.appender.CON=org.apache.log4j.ConsoleAppender
log4j.appender.CON.layout=org.apache.log4j.PatternLayout
log4j.appender.CON.layout.ConversionPattern=%d %-5p %c - %m%n
# Allow requests level WARN or above in "chapter3" package except in
# "chapter3.Foo" where DEBUG or above is allowed.
log4j.logger.chapter3=WARN
log4j.logger.chapter3.Foo=DEBUG

可以看到在最后一行增加了 log4j.logger.chapter3.Foo=DEBUG
可以通过运行程序来查看效果（这里将不详细介绍程序）
Chapter3.Foo的级别已上升为 DEBUG 了
Logger name Assigned level Effective level
Root DEBUG DEBUG
chapter3 WARN WARN
chapter3.MyApp2 null WARN
chapter3.Foo DEBUG DEBUG


写了这么多相信也累了吧，那就休息下吧，这么多的内容好好消化理解，以后继续学习 : ) ，了解这些基础的东西还不够，如果想更深入的理解 推荐 log4j The Complete Manual.pdf