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
1、 Log4j.rootCategory=[ level | null ],appenderName,appenderName, ….
level:是日記記錄的優先級,優先級由高到低分爲 OFF ,FATAL ,ERROR ,WARN ,INFO ,DEBUG ,ALL。Log4j建議只使用FATAL ,ERROR ,WARN ,INFO ,DEBUG這四個級別。主意看到了null 了吧,所以在這裏可以爲空。
appenderName:指定日誌信息輸出到哪個地方,可以同時指定多個輸出目的地。
2、Appender的語法爲:
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 (將日誌信息以流格式發送到任意指定的地方)
3、Layout的語法爲:
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 (包含日誌產生的時間、線程、類別等信息)
4、輸出
都以%開始後面不同的參數代表不同的格式化信息(參數按字母表順序列出):
%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 輸出產生該日誌事件的線程名
由上可大致瞭解log4j.properties 文件了吧(通過以上幾步已經是個配置文件了)。不過還有一些也應該瞭解:
5、Threshold的語法
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級別的信息,將被過濾。
6、level of a logger
與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