一、問題概述
如題所說,后端應用(非spring boot項目)通常用到了很多jar包,比如spring系列、mybatis、hibernate、各類連接數據庫的客戶端的jar包。可能這個jar包用的是logback、那個用的是log4j、那個又是log4j2,
這時候,怎么才能保證各jar包的日志都能輸出,且能以統一的格式輸出呢?
為什么要強調非spring boot項目,可參考第四節。
二、幾種日志框架的簡單介紹
來源:https://juejin.im/post/5a7c5d575188254e76179c0f
Java中的日志框架分如下幾種:
1.Log4j
Apache Log4j是一個基於Java的日志記錄工具。它是由Ceki Gülcü首創的,現在則是Apache軟件基金會的一個項目。
2.Log4j 2
Apache Log4j 2是apache開發的一款Log4j的升級產品。
3.Commons Logging
Apache基金會所屬的項目,是一套Java日志接口,之前叫Jakarta Commons Logging,后更名為Commons Logging。
4.Slf4j
Slf4j
類似於Commons Logging,是一套簡易Java日志門面,本身並無日志的實現。(Simple Logging Facade for Java,縮寫Slf4j)。
5.Logback
一套日志組件的實現(slf4j陣營)。
6.Jul
(Java Util Logging)
自Java1.4以來的官方日志實現。
上面這幾個框架,又分為了兩類:一類是接口,包括了slf4j、commons logging;剩下的幾個是具體實現,包括了jul、logback、log4j、log4j2。
現在,講究針對接口編程,而不是針對具體實現,方便移植。而現在最通用的就是slf4j。就我待過的幾家公司來說,全都都用的是slf4j作為日志門面,具體的實現一般直接采用默認的logback。
下面就具體講講,怎么將其他框架五花八門的日志一統為slf4j。
三、統一的思路
我們先分析下。
假設有個jar采用了JUL,即java自帶的日志系統。我們要怎么才能將其適配到slf4j去呢?
在JUL的logger的方法被調用時,因為Logger所在的包位於java.util,默認就被加載了,不太方便以假亂真。
想要覆蓋其實現,我能想到的是,通過aop切面,直接將參數傳給slf4j的api,不調用原來的日志實現。
再來,假設有個jar采用了log4j,即寫日志用的是org.apache.log4j.Logger,該類是來源於log4j的相關jar包,那么,
我可以排除掉log4j相關的jar包,代碼里報錯了,對吧?那我再建一個相同package名、相同類名的class。在這個假的
class里,我去調用slf4j的api。
那么,這些功能需要我自己去寫嗎?不需要!slf4j已經給我們提供了從各類日志框架九九歸一到slf4j的轉換包。
源日志框架 | 目標日志框架 | 所需轉換用jar包 | maven(這里缺了version字段,請參考下一節) | 備注 |
jul | slf4j | jul-to-slf4j |
<dependency> |
需要排除掉原有依賴。 |
Commons Logging | slf4j | jcl-over-slf4j |
<dependency> |
需要排除掉原有依賴。 |
log4j | slf4j | log4j-over-slf4j |
<dependency> |
需要排除掉原有依賴。 |
log4j2 | slf4j | log4j-to-slf4j |
<dependency> |
需要排除掉原有依賴。 注意這里使用的為 log4j-to-slf4j |
這里給一張slf4j官方手冊里的,也是漏了log4j2的。
四、如何選擇以上轉換jar包的版本
在spring boot中,其實根本不需要以上的麻煩工作,只需要引用以下組件:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
<version>1.5.9.RELEASE</version>
</dependency>
我們看看這個組件里,包含了什么:

可以看到,log4j、jul、jcl(即commons-logging)的轉換包都有了。
那么,在非spring boot項目中,我們只要去mvnrepository.com查詢:spring-boot-starter-logging.
然后,選擇對應的版本,就可以在下圖看到該組件依賴的包:

怎么樣,應該是個比較簡單的辦法吧?
五、未完成的統一之路
這一篇里面,我們還只講了如何將各日志框架統一到slf4j來。
但是slf4j只是個門面,具體的實現呢(比如log4j等)又被我們排除掉了。
那么slf4j沒有實現,也是不能完成輸出日志的任務的。
所以我們還需要一個實現。這份留到下篇仔細講。
六、github代碼(已實現上述的統一問題,默認實現采用了logback)
代碼路徑:
https://github.com/cctvckl/logtest
這里演示下效果:
下面是統一后的:
其中jul為什么日志未統一,等有時間了我再看看。這兩天時間有點緊,要開發需求。。。