Log4J的三個組件:
Logger:日志記錄器铐拐,負(fù)責(zé)收集處理日志記錄(如何處理日志)
Appender:日志輸出目的地艳悔,負(fù)責(zé)日志的輸出(輸出到什么地方)
Layout:日志格式化任洞,負(fù)責(zé)對輸出的日志的格式化(以什么形式展現(xiàn))
一個logger可以對應(yīng)多個appender,一個appender只能對應(yīng)一個layout。
1、Logger:
logger可以有選擇的啟動和禁用日志的輸出搞动,我們經(jīng)常會在各種框架中看到如:
private static final Logger log=LoggerFactory.getLogger(xx.class);
講解:log就代表了一個Logger實例灰羽,他的name就是類“xx”的full quailied name(類的全限定名)驮履,這個log可以指定多個appender和layout。Logger的名字大小寫敏感谦趣,其命名有繼承機(jī)制:例如:name為org.apache.commons的logger會繼承name為org.apache的logger疲吸。
Log4J中有一個特殊的logger叫做“root”,他是所有l(wèi)ogger的根,也就意味著其他的logger都會直接或者間接地繼承自root前鹅。root logger可以用Logger.getRootLogger()方法獲取摘悴,但是不能通過Logger.getLogger("root")獲得。
java code:
Logger root = Logger.getRootLogger();
Logger log = Logger.getLogger("root");
System.out.println(log==root);//false 說明root無法通過name獲取
Logger log2 = Logger.getLogger("root");
System.out.println(log==log2);//true,說明一個name唯一對應(yīng)一個logger
2舰绘、Level:
level為logger服務(wù)蹂喻,用來定義日志的級別葱椭,他的值可以是:OFF(關(guān)閉)FATAL(致命的)ERROR(錯誤)WARN(警告)INFO(信息)DEBUG(調(diào)試)ALL(所有),輸出日志的策略由此Level決定口四,例如:如果logger的Level設(shè)置為INFO孵运,那么系統(tǒng)只輸出INFO以及以上(WARN、ERROR蔓彩、FATAL)信息治笨。如果當(dāng)前l(fā)ogger沒有設(shè)定Level,那么它在輸出日志時采用的策略是:它會使用它繼承的Logger的Level作為它自己的Level來處理。如果它的上級也沒有設(shè)置Level,那么就找上上級赤嚼,幾次類推旷赖,直到root為止,(root的Level是不能設(shè)為空的更卒,所以最終一定會找到一個Level)等孵。默認(rèn)root的Level是INFO,其他logger的Level默認(rèn)都是null,需要手動指定蹂空。
Level對應(yīng)的logger輸出級別對應(yīng)的方法有:
logger.debug(message);
logger.info(message);
logger.error(message);
logger.fatal(message);
3俯萌、Appender:
Appender可以控制日志的輸出的目的地,一個輸出源就叫一個Appender,appender的類別有:Console(控制臺)File(文件)JDBC上枕、JMS等等咐熙,logger可以通過方法logger.addAppender(appender)配置多個appender,對logger來說,每個有效的日志請求結(jié)果都將輸出到logger本身以及父logger的appender上辨萍。例如:
Logger com=Logger.getLogger("com");
Appender appender = new FileAppender(new SimpleLayout(),"hello.log");
com.addAppender(appender);
Logger iteye = Logger.getLogger("com.iteye");
iteye.addAppender(new ConsoleAppender(new SimpleLayout(),"System.out"));//target:sys.out(default)或sys.err
iteye.info("hello world");
上例中糖声,“iteye”是繼承"com"logger的,“com”定義的appender是FileAppender,而“iteye”定義的appender是ConsoleAppender,這里我并沒有設(shè)置他們的Level,那么自動使用root默認(rèn)的INFO作為日志的等級分瘦,因此此處iteye.info("hello world")會被輸出到指定的appender上蘸泻。但是最終日志信息會顯示在控制臺,而且也會輸出到文件hello.log中去嘲玫。不過這里可以通過設(shè)置logger“iteye”的additivity(附加標(biāo)記)設(shè)為false==>>iteye.setAdditivity(false);這樣日志信息”hello world“就不會寫入到hello.log中去了悦施。
常用的集中appender有:
org.apache.log4j.ConsoleAppender(控制臺)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天產(chǎn)生一個日志文件)
org.apache.log4j.RollingFileAppender((文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件))
org.apache.log4j.WriterAppender(將日志信息以流格式發(fā)送到任意指定的地方)
4、Layout:
使用指定的Layout來展示(格式化)日志去团,常見的Layout有:
org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(可以靈活地指定布局模式)
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串)
org.apache.log4j.TTCCLayout(包含日志產(chǎn)生的時間抡诞、線程值戳、類別等等信息)捌锭,等
5、配置:
配置了以上幾個組件后取视,我們就可以了解一下log4j的配置.properties了鬼雀。
Java code:
#配置根Logger
log4j.rootLogger = [level],appenderName1,appenderName2,...
#例子:
log4j.rootLogger =? DEBUG,stdout,file
java code:
#配置日志信息輸出目的地(Appender)
log4j.appender.appenderName =? fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1=value1
...
log4j.appender.appenderName.optionN=valueN
#例子
###輸出到控制臺###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout .Target = System.out #默認(rèn)就是System.out,另外一個值是System.error
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = %d{ABSOLUTE}? %5p %c{1}:%L - %m%n
###輸出到文件###
log4j.appender.file=org.apache.log4j.DailyRollingFileAppender
log4j.appender.file.File = logs/log.log
log4j.appender.file.Append?= true #默認(rèn)是true,系統(tǒng)啟動時追加至文件中顷窒,否則會覆蓋原有內(nèi)容
log4j.appender.file.Threshold = INFO ## 輸出IFNO級別以上的日志,這里的意思是rootLooger設(shè)置為DEBUG時,只輸出INFO以上(INFO鞋吉、WARN鸦做、ERROR、FATAL)的信息到文件中去谓着,而DEBUG信息就不會輸出 了
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] % m%n
java code
#配置日志信息的格式(Layout)
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
...
log4j.appender.appenderName.layout.optionN =? valueN
#例子
log4j.appender.file.layout =? org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} ?[%t:%r] - [%p] %m%n
ConversionPattern參數(shù)的格式含義
格式名 含義
%c??? 輸出日志信息所屬的類的全名
%d??? 輸出日志時間點(diǎn)的日期或時間泼诱,默認(rèn)格式為ISO8601,也可以在其后指定格式赊锚,比如:%d{yyy-MM-dd HH:mm:ss},輸出類似:2002-10-18 22:10:28
%f????? 輸出日志信息所屬的類的類名
%l??????輸出日志事件的發(fā)生位置治筒,即輸出日志信息的語句處于它所在的類的第幾行
%m??? 輸出代碼中指定的信息,如log(message)中的message
%n???? 輸出一個回車換行符舷蒲,Windows平臺為“rn”,Unix平臺為"n"
%p???? 輸出優(yōu)先級矢炼,即DEBUG,INFO,WARN,ERROR,FATAL。如果是調(diào)用debug()輸出的阿纤。則國DEBUG,依此類推
%r???? 輸出自應(yīng)用啟動到輸出該日志信息所耗費(fèi)的毫秒數(shù)
%t???? 輸出產(chǎn)生該日志事件的線程名
最后如果你看到此類錯誤應(yīng)該有不再感到疑惑了吧:
public static org.slf4j.Logger log = LoggerFactory.getLogger(Test.class);
?log.error("erro");
log4j:WARN No appenders could be found for logger (Test).
?log4j:WARN Please initialize the log4j system properly.