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


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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章