java日誌框架log4j詳細配置及與slf4j聯合使用教程
注: 更讓你理解facade門面模式,更讓你理解jvm的run anyway
一、log4j基本用法
首先,配置log4j的jar,maven工程配置以下依賴,非maven工程從maven倉庫下載jar新增到“build path”
1 2 3 4 5 |
>
|
然後,在src/main/java目錄(包的根目錄即classpath)新建log4j.properties檔案
1 2 3 4 5 6 7 8 9 |
= INFO
|
最後,新建Main.java檔案
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
執行main方法,日誌資訊就出來了
1 |
|
二、log4j.properties路徑
log4j.properties要放在哪以及怎樣配置才能被解析呢?不同工程型別配置方式不同
1、普通java或spring工程
這是最常見的java工程型別,寫demo用的多,把log4j.properties放在src/main/java目錄(包的根目錄)就行了
2、spring mvc工程
web工程裡用spring mvc構建的比較多了,把log4j.properties放在src/main/resources的conf目錄(web工程配置檔案通常在resources或WEB-INF目錄),編輯web.xml,新增
1 2 3 4 5 6 7 |
|
3、普通web工程
沒有了spring提供的listener載入log4j.properties,我們要怎麼載入這個檔案呢?同樣,把log4j.properties放在src/main/resources的conf目錄,用servlet載入
1 2 3 4 5 6 7 8 9 10 11 12 |
|
編輯web.xml,新增
1 2 3 4 5 6 7 8 9 |
|
看著是不是和spring mvc的很像,甚至你也想到了,普通java工程沒有指定log4j.properties的路徑,那說明log4j的jar包一定有一個預設的路徑。另外,建議,log4j的配置放在第一個,因為後續載入其他元件就要開始使用日誌記錄了
現在,你可以在多種型別的java工程中打出日誌了,但都是控制檯的日誌,輸出內容也很有限,下面我們就來詳細介紹log4j.properties內容怎麼配置
三、log4j.properties內容
接下來介紹的內容看起來獨立,其實相互關聯,並且很有規律,我們要輸出日誌,首先得有日誌物件(logger),那這些日誌物件把日誌輸出到哪裡呢,控制檯還是檔案,這就要設定輸出位置(appender),輸出的格式與內容又是什麼樣的呢,這就要設定輸出樣式(layout),這些設定完,log4j的配置也就完了
在此之前,先介紹下log4j日誌等級的概念,日誌等級就是日誌的重要程度,log4j日誌分為7個等級:ALL、DEBUG、INFO、WARN、ERROR、FATAL、OFF,從左到右等級由低到高,分等級是為了設定日誌輸出的門檻,只有等級等於或高於這個門檻的日誌才有機會輸出
1、logger
日誌例項,就是程式碼裡實例化的Logger物件
1 2 |
|
這是全域性logger的配置,LEVEL用來設定日誌等級,appenderName定義日誌輸出器,示例中的“console”就是一個日誌輸出器
下面給出一個更清晰的例子,配置“com.demo.test”包下所有類中例項化的Logger物件
1 2 |
|
2、appender
日誌輸出器,指定logger的輸出位置
1 |
|
appender有5種選擇
1 2 3 4 5 |
|
每種appender都有若干配置項,下面逐一介紹
ConsoleAppender(常用)
1 2 3 |
|
FileAppender
1 2 3 4 |
|
DailyRollingFileAppender(常用)
1 2 3 4 5 6 7 8 9 10 11 12 |
|
RollingFileAppender
1 2 3 4 5 6 |
|
3、layout
指定logger輸出內容及格式
1 |
|
layout有4種選擇
1 2 3 4 |
|
layout也有配置項,下面具體介紹
HTMLLayout
1 2 |
|
PatternLayout(最常用的配置)
1 |
|
設定格式的引數說明如下
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
四、log4j完整配置示例
介紹完了log4j.properties內容,我們來配置一些常用的日誌輸出吧
1 2 |
|
控制檯console日誌輸出器
1 2 3 4 5 6 7 |
|
檔案logFile日誌輸出器
1 2 3 4 5 6 7 8 |
|
滾動檔案rollingFile日誌輸出器
1 2 3 4 5 6 7 8 9 10 |
|
定期滾動檔案dailyFile日誌輸出器
1 2 3 4 5 6 7 8 9 |
|
五、log4j區域性日誌配置
以上介紹的配置都是全域性的,整個工程的程式碼使用同一套配置,意味著所有的日誌都輸出在了相同的地方,你無法直接了當的去看資料庫訪問日誌、使用者登入日誌、操作日誌,它們都混在一起,因此,需要為包甚至是類配置單獨的日誌輸出,下面給出一個例子,為“com.demo.test”包指定日誌輸出器“test”,“com.demo.test”包下所有類的日誌都將輸出到/log/test.log檔案
1 2 3 4 5 |
|
也可以讓同一個類輸出不同的日誌,為達到這個目的,需要在這個類中例項化兩個logger
1 2 |
|
然後分別配置
1 2 3 4 5 6 7 8 9 10 11 12 |
|
六、slf4j與log4j聯合使用
slf4j是什麼?slf4j只是定義了一組日誌介面,但並未提供任何實現,既然這樣,為什麼要用slf4j呢?log4j不是已經滿足要求了嗎?
是的,log4j滿足了要求,但是,日誌框架並不只有log4j一個,你喜歡用log4j,有的人可能更喜歡logback,有的人甚至用jdk自帶的日誌框架,這種情況下,如果你要依賴別人的jar,整個系統就用了兩個日誌框架,如果你依賴10個jar,每個jar用的日誌框架都不同,豈不是一個工程用了10個日誌框架,那就亂了!
如果你的程式碼使用slf4j的介面,具體日誌實現框架你喜歡用log4j,其他人的程式碼也用slf4j的介面,具體實現未知,那你依賴其他人jar包時,整個工程就只會用到log4j日誌框架,這是一種典型的門面模式應用,與jvm思想相同,我們面向slf4j寫日誌程式碼,slf4j處理具體日誌實現框架之間的差異,正如我們面向jvm寫java程式碼,jvm處理作業系統之間的差異,結果就是,一處編寫,到處執行。況且,現在越來越多的開源工具都在用slf4j了
那麼,怎麼用slf4j呢?
首先,得弄到slf4j的jar包,maven依賴如下,log4j配置過程完全不變
1 2 3 4 5 |
|
然後,弄到slf4j與log4j的關聯jar包,通過這個東西,將對slf4j介面的呼叫轉換為對log4j的呼叫,不同的日誌實現框架,這個轉換工具不同
1 2 3 4 5 |
|
當然了,slf4j-log4j12這個包肯定依賴了slf4j和log4j,所以使用slf4j+log4j的組合只要配置上面這一個依賴就夠了
最後,程式碼裡宣告logger要改一下,原來使用log4j是這樣的
1 2 3 4 5 6 7 |
|
現在要改成這樣
1 2 3 4 5 6 7 8 |
|
依賴的Logger變了,而且,slf4j的api還能使用佔位符,很方便