雖然以前一直在用log4j,但是對其配置不甚了了,突然間因為需解決某些問題,要理解log4j的配置,
然而用google搜了一下,卻發(fā)現(xiàn)網上沒有一個簡單直觀的說明,于是只好看log4j的官方介紹,終于
理解了log4j的配置用法,以下是我對log4j配置的一點認識,如有謬誤還請不吝賜教.
首先我們搞清楚log4j能干什么,簡單來說就是提供一個記錄不同級別信息內容的日志工具,
可以把不同級別,不同包路徑的信息,以指定格式輸出到多種設備(控制臺,文件等)
在程序中,可以以以下方式來使用
?? Log log = org.apache.commons.logging.LogFactory.LogFactory.getLog(yourClassName.class);
??log.debug("debug message -------------------");
??log.info("info message ******************");
??log.warn("warn message +++++++++++++++");
??log.error("error msg=================");
??
本文主要講的是如何配置log4j,先讓我們先看看一個典型的log4j配置:??
==========log4j.properties==================
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{MM-dd HH\:mm\:ss.SSS} %-5p [%F\:%L]%x %m%n
log4j.appender.fileout=org.apache.log4j.RollingFileAppender
log4j.appender.fileout.File=D:/workspace/log4jtest/log/application.log
log4j.appender.fileout.MaxFileSize=10000KB
log4j.appender.fileout.MaxBackupIndex=10
log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
log4j.appender.fileout.layout.ConversionPattern=%d{MM-dd HH:mm:ss.SSS}[%24F:%-3L:%-5p]%x %m%n
log4j.rootCategory=INFO, stdout, fileout
log4j.logger.com.wolfsquare.log2=DEBUG,stdout
===================================
這個文件可以劃為三小塊
===========第一塊定義了一個名為 stdout 的appender和layout (appender,layout的概念后面再解釋,目前先記著有這樣兩個名詞):
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
定義stdout的實際輸出實現(xiàn)類,從這個appender實現(xiàn)類名可以猜到,這個類是負責控制臺輸出的。
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
定義stdout的輸出裝飾器
log4j.appender.stdout.layout.ConversionPattern=%d{MM-dd HH\:mm\:ss.SSS} %-5p [%F\:%L]%x %m%n
裝飾器參數(shù)配置
============第二塊定義了一個名為 fileout 的appender和layout:
log4j.appender.fileout=org.apache.log4j.RollingFileAppender
同理可猜這個實現(xiàn)類是輸出到文件的
log4j.appender.fileout.File=D:/workspace/log4jtest/log/application.log
log4j.appender.fileout.MaxFileSize=10000KB
log4j.appender.fileout.MaxBackupIndex=10
log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
log4j.appender.fileout.layout.ConversionPattern=%d{MM-dd HH:mm:ss.SSS}[%24F:%-3L:%-5p]%x %m%n
============第三塊定義了名字分別為rootCategory,log4j.logger.com.wolfsquare.log2的兩個logger
log4j.rootCategory=INFO, stdout, fileout
log4j.logger.com.wolfsquare.log2=DEBUG,stdout
rootCategory logger是缺省的logger,記錄所有的包的信息輸出。
第二個logger是只輸出指定包com.wolfsquare.log2下的日志信息。
那么INFO,DEBUG又是什么意思呢,他們是信息的分級標識,通過繼承實現(xiàn)這個實現(xiàn)自定義級別的分級。
第三塊配置兩句的意思是這樣的:
rootCategory 把所有類的INFO級別以上的信息輸出到stdout和fileout兩個appender中,
logger.com.wolfsquare.log2,把com.wolfsquare.log2包中的所有類(包括子包)DEBUG級別(含)以上的信息輸出到stdout 中
一個logger可以輸出到很多個設備中(appender),如果需要增加輸出設備則用分號分隔開appender名稱即可。
輸出信息的分類級別是DEBUG > INFO > WARN > ERROR,信息細節(jié)由細到粗,指定輸出某一級別的信息時,
過細的信息輸出將會被忽略
如果一個配置中有多個logger,他們之間會有什么關系呢?答案是,在輸出上,他們沒有任何關系,都是獨立運作的,
不相關的,但是在配置上,父包的配置會傳給子包,如果子包沒有另外定義配置的話。
例如上面配置文件中的兩個logger:
log4j.logger.com.wolfsquare
log4j.logger.com.wolfsquare.log2
這里認為 log4j.logger.com.wolfsquare.log2 繼承自 log4j.logger.com.wolfsquare,他們的配置聲明如下:
log4j.rootCategory=INFO, stdout, fileout
log4j.logger.com.wolfsquare.log2=,stdout
注意第二句沒有指定輸出級別,那么根據(jù)配置繼承規(guī)則會繼承父logger的配置,在這里就是INFO。
同時需要強調的是,如果兩個logger有繼承關系,且輸出到同一個appender,根據(jù)輸出獨立原則,那么將會出現(xiàn)兩行一樣的信息,
例如上面的兩個logger定義會導致這樣的情況。
最后以一幅圖來概括:
