Log4j配置文件配置总结

Log4j支持两种配置文件格式，一种是XML格式的文件，另一种是Properties键值属性文件。
这边主要介绍Properties格式的文件配置

Log4J配置文件的基本格式如下：
#配置根Logger
log4j.rootLogger = [level], appenderName1, appenderName2,  …

#配置日志信息输出目的地Appender
log4j.appender.appenderName  =  fully.qualified.name.of.appender.class
　　log4j.appender.appenderName.option1  =  value1
　　…
　　log4j.appender.appenderName.optionN  =  valueN

#配置日志信息的格式（布局）
log4j.appender.appenderName.layout  =  fully.qualified.name.of.layout.class
　　log4j.appender.appenderName.layout.option1  =  value1
　　…
　　log4j.appender.appenderName.layout.optionN  =  valueN 
其中 [level] 是日志输出级别，共有5级：
FATAL      0 
ERROR      3 
WARN       4 
INFO       6 
DEBUG      7

Appender：为日志输出目的地，Log4j提供的appender有以下几种：
org.apache.log4j.ConsoleAppender（控制台），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

Layout：日志输出格式，Log4j提供的layout有以下几种：
org.apache.log4j.HTMLLayout（以HTML表格形式布局），
org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

打印参数: Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，如下:

%c       输出所属的类目，通常就是所在类的全名
%c      a.b.c
%c{2} b.c
%20c （若名字空间长度小于20，则左边用空格填充）
%-20c （若名字空间长度小于20，则右边用空格填充）
%.30c （若名字空间长度超过30，截去多余字符）
%20.30c （若名字空间长度小于20，则左边用空格填充；若名字空间长度超过30，截去多余字符）
%-20.30c（若名字空间长度小于20，则右边用空格填充；若名字空间长度超过30，截去多余字符）

%C  列出调用logger的类的全名（包含包路径） 假设当前类是"org.apache.xyz.SomeClass"
%C org.apache.xyz.SomeClass
%C{1} SomeClass

%d  显示日志记录时间，{<日期格式>}使用ISO8601定义的日期格式
%d{yyyy/MM/dd HH:mm:ss,SSS} 2005/10/12 22:23:30,117
%d{ABSOLUTE} 22:23:30,117
%d{DATE} 12 Oct 2005 22:23:30,117
%d{ISO8601} 2005-10-12 22:23:30,117

%F  显示调用logger的源文件名
%F  MyClass.java

%l  输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数
%l MyClass.main(MyClass.java:129)
%L  显示调用logger的代码行
%L 129

%m  显示输出消息
%m This is a message for debug.
%M  显示调用logger的方法名
%M main

%n  当前平台下的换行符
%n Windows平台下表示rn,UNIX平台下表示n

%p  显示该条日志的优先级即DEBUG，INFO，WARN，ERROR，FATAL
%p INFO

%r  显示从程序启动时到记录该条日志时已经经过的毫秒数
%r 1215

%t  输出产生该日志事件的线程名
%t MyClass

%x     按NDC（Nested Diagnostic Context，线程堆栈）顺序输出日志
       假设某程序调用顺序是MyApp调用com.foo.Bar
       %c %x - %m%n MyApp - Call com.foo.Bar.
       com.foo.Bar - Log in Bar
       MyApp - Return to MyApp.
%X     按MDC（Mapped Diagnostic Context，线程映射表）输出日志。通常用于多个客户端连接同一台服务器，方便服务器区分是那个客户端访问留下来的日志。
%X{5} （记录代号为5的客户端的日志）

%%  显示一个百分号
%% %

log4j.propertie 示例文件：
log4j.rootLogger = INFO,stdout,filelog
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.nowarnconsole.Threshold=DEBUG
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d %t %p %c{1} %L %m%n

log4j.appender.filelog=org.apache.log4j.RollingFileAppender
log4j.appender.filelog.File=file.log
log4j.appender.filelog.MaxFileSize=20480KB
log4j.appender.filelog.MaxBackupIndex=5
log4j.appender.filelog.layout=org.apache.log4j.PatternLayout
log4j.appender.filelog.layout.ConversionPattern=%d %t %p [%c{4}] %m%n

代码中使用
public class TestLog4j {
     public static void main(String[] args) {
        //BasicConfigurator.configure()  自动快速地使用缺省 Log4j 环境。
        //若将 log4j.properties 放在工程根目录下也可不写此句，程序会自动找到配置文件。
        PropertyConfigurator.configure("D:/log4j.properties");
       //DOMConfigurator.configure ("D:/log4j.xml") ：读取 XML 形式的配置文件。
        Logger logger = Logger.getLogger(TestLog4j. class );
        logger.debug( "debug message ..." );
        logger.error( "error message ..." );
    }
}