阿里巴巴開發手冊強制使用SLF4J作爲門面擔當的祕密,我搞清楚了

之前已經詳細、全面地介紹了 Log4j,相信小夥伴們已經完全掌握了。那我在讀嵩山版的阿里巴巴開發手冊(沒有的小夥伴,記着找我要)的時候,就發現了一條「強制」性質的日誌規約:

應用中不可以直接使用日誌系統(Log4j、Logback)中的 API,而應該使用日誌框架中的 API,比如說 SLF4J,使用門面模式的日誌框架,有利於維護和統一各個類的日誌處理方式。

(爲什麼我把這段文字手敲了下來呢,因爲我發現阿里巴巴開發手冊上的有語病,瞧下面紅色標出的部分)

(維護和統一,把統一放在最後面讀起來真的是彆扭,和的有點牽強,請問手冊的小編是數學老師教的語文吧?)

那看到這條強制性的規約,我就忍不住想要問:“爲什麼阿里巴巴開發手冊會強制使用 SLF4J 作爲 Log4J 的門面擔當呢?”究竟這背後藏了什麼“不可告人”的祕密?

(請小夥伴們自行配上 CCTV 12 臺的那種 BGM)

PS:順帶給小夥伴們普及一點小知識,阿里巴巴開發手冊上出現的 Jakarta 其實是 Apache 軟件基金會下的一個開源項目。其實 Commons 是以前隸屬於 Jakarta,現在是作爲 Apache 下的一個單獨項目,阿里巴巴開發手冊上的描述已經不太恰當了,換成是 Apache Commons Logging 會更合適一點。

(忍不住又給阿里巴巴開發手冊挑了一個毛病,請原諒我“一絲不苟”的做事態度)

01、SLF4J 是什麼

SLF4J 是 Simple Logging Facade for Java 的縮寫(for≈4),也就是簡易的日誌門面,以外觀模式(Facade pattern,一種設計模式,爲子系統中的一組接口提供一個統一的高層接口,使得子系統更容易使用)實現,支持 java.util.logging、Log4J 和 Logback。

SLF4J 的作者就是 Log4J 和 Logback 的作者,他的 GitHub 主頁長下面這樣:

一股秋風瑟瑟的清冷感撲面而來,有沒有?可能巨佬不屑於維護他的 GitHub 主頁吧?我的 GitHub 主頁夠悽慘了,沒想到巨佬比我還慘,終於可以吹牛逼地說,“我,沉默王二,GitHub 主頁比 SLF4J、Log4J 和 Logback 的作者 Ceki Gulcu 綠多了。。。。。。”

1996 年初,歐洲安全電子市場項目決定編寫自己的跟蹤 API,最後該 API 演變成了 Log4j,已經推出就備受寵愛。

2002 年 2 月,Sun 推出了自己的日誌包 java.util.logging(可稱 JUL),據說實現思想借鑑了 Log4j,畢竟此時的 Log4j 已經很成熟了。

2002 年 8 月,Apache 就推出了自己的日誌包,也就是阿里巴巴開發手冊上提到的 JCL(Jakarta Commons Logging)。JCL 的野心很大,它在 JUL 和 Log4j 的基礎上提供了一個抽象層的接口,方便使用者在 JUL 和 Log4j 之間切換。

但 JCL 好像並不怎麼招人喜歡,有人是這樣抱怨的:

Ceki Gulcu 也覺得 JCL 不好,要不然他也不會在 2005 年自己擼一個名叫 SLF4J 的新項目,對吧?但出來混總是要付出代價的,SLF4J 只有接口,沒有實現,總不能強逼着 Java 和 Apache 去實現 SLF4J 接口吧?這太難了,不現實。

但巨佬之所以稱之爲巨佬,是因爲他擁有超出普通人的驚人之處,他在 SLF4J 和 JUL、Log4j、JCL 之間搭了三座橋:

巨佬動手,豐衣足食,有沒有?狠起來連自己的 Log4j 都搭個橋。

面對巨佬的霸氣,我只想弱弱地說一句,“ SLF4J 這個門面擔當,你以爲好當的啊?”

02、SLF4J 解決了什麼痛點

春秋戰國的時候,每個國家都有自己的貨幣,用別國的貨幣也不合適,對吧?那在發生貿易的時候就比較麻煩了,貨幣不統一,就沒法直接交易,因爲貨幣可能不等價。

那秦始皇統一六國後,就推出了新的貨幣政策,全國都用一種貨幣,那之前的問題就解決掉了。

你看,同樣的道理,日誌系統有 JUL、JCL,Ceki Gulcu 自己又寫了 2 種,Log4j 和 Logback,各有各的優缺點,再加上使用者千千萬,蘿蔔白菜各有所愛,這就導致不同的應用可能會用不同的日誌系統。

假設我們正在開發一套系統,打算用 SLF4J 作爲門面,Log4j 作爲日誌系統,我們在項目中使用了 A 框架,而 A 框架的門面是 JCL,日誌系統是 JUL,那就相等於要維護兩套日誌系統,對吧?

這就難受了!

Ceki Gulcu 想到了這個問題,並且幫我們解決了!來看 SLF4J 官網給出的解決方案。

  • 使用 jcl-over-slf4j.jar 替換 commons-logging.jar
  • 引入 jul-to-slf4j.jar

爲了模擬這個過程,我們來建一個使用 JCL 的項目。

第一步,在 pom.xml 文件中引入 commons-logging.jar:

<dependency>
    <groupId>commons-logging</groupId>
    <artifactId>commons-logging</artifactId>
    <version>1.2</version>
</dependency>

第二步,新建測試類:

package com.itwanger;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

/**
 * @author 微信搜「沉默王二」,回覆關鍵字 PDF
 */

public class Demo {
    private static Log logger = LogFactory.getLog(Demo.class);
    public static void main(String[] args) {
        logger.info("jcl");
    }
}

該類會通過 LogFactory 獲取一個 Log 對象,並且使用 info() 方法打印一行日誌。

調試這段代碼的過程中你會發現,Log 的實現有四種:

如果沒有綁定 Log4j 的話,就會默認選擇 Jdk14Logger——它返回的 Logger 對象,正是 java.util.logging.Logger,也就是 JUL。

因此,就可以在控制檯看到以下信息:

10月 21, 2020 3:13:30 下午 com.itwanger.Demo main
信息: jcl

怎麼把使用 JCL 的項目改造成使用 SLF4J 的呢?

第三步,使用 jcl-over-slf4j.jar 替換 commons-logging.jar,並加入 jul-to-slf4j.jar、slf4j-log4j12.jar(會自動引入 slf4j-api.jar 和 log4j.jar):

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
    <version>1.7.25</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jul-to-slf4j</artifactId>
    <version>1.7.29</version>
</dependency>

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.25</version>
</dependency>

第四步,在 resources 目錄下創建 log4j.properties 文件,內容如下所示:

### 設置###
log4j.rootLogger = debug,stdout,D

### 輸出信息到控制檯 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 輸出DEBUG 級別以上的日誌到=debug.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = debug.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

再次運行 Demo 類,你會發現 target 目錄下會生成一個名叫 debug.log 的文件,內容如下所示:

2020-10-21 15:32:06  [ main:0 ] - [ INFO ]  jcl

並且可以在控制檯看到以下信息:

[INFO ] 2020-10-21 15:32:06,192 method:com.itwanger.Demo.main(Demo.java:12)
jcl

仔細對比一下,你就會發現,這次輸出的格式和之前不一樣,這就是因爲 Log4j 和 JUL 的日誌格式不同導致的。

另外,你有沒有發現?我們並沒有改動測試類 Demo,它裏面使用的仍然是 JCL 獲取 Log 的方式:

private static Log logger = LogFactory.getLog(Demo.class);

但輸出的格式已經切換到 Log4j 了!

SLF4J 除了提供這種解決方案,綁定 Log4j 替換 JUL 和 JCL;還提供了綁定 Logback 替換 JUL、JCL、Log4j 的方案:

還有綁定 JUL 替換 JCL 和 Log4j 的方案:

太強了,有木有?有的話請在留言區敲出 666。

03、SLF4J 比 Log4J 強在哪

SLF4J 除了解決掉以上的痛點,幫助我們的應用程序獨立於任何特定的日誌系統,還有一個非常牛逼的功能,那就是 SLF4J 在打印日誌的時候使用了佔位符 {},它有點類似於 String 類的 format() 方法(使用 %s 等填充參數),但更加便捷,這在很大程度上提高了程序的性能。

衆所周知,字符串是不可變的,字符串拼接會創建很多不必要的字符串對象,極大的消耗了內存空間。但 Log4J 在打印帶參數的日誌時,只能使用字符串拼接的方式:

String name = "沉默王二";
int age = 18;
logger.debug(name + ",年紀:" + age + ",是個非常不要臉的程序員");

非常笨重,但加入了 SLF4J 後,這個問題迎刃而解。我們來看一下在 Log4j 項目中加入 SLF4J 的詳細的步驟。

第一步,把 log4j 的依賴替換爲 slf4j-log4j12(Maven 會自動引入 slf4j-api.jar 和 log4j.jar):

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.25</version>
</dependency>

第二步,在 resources 目錄下創建 log4j.properties 文件,內容和 Log4j 那一篇完全相同:

### 設置###
log4j.rootLogger = debug,stdout,D,E

### 輸出信息到控制檯 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 輸出DEBUG 級別以上的日誌到=debug.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = debug.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 輸出ERROR 級別以上的日誌到=error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =error.log 
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR 
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

第三步,新建測試類:

package com.itwanger;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * @author 微信搜「沉默王二」,回覆關鍵字 PDF
 */

public class Log4jSLF4JDemo {
    private static final Logger logger = LoggerFactory.getLogger(Log4jSLF4JDemo.class);

    public static void main(String[] args) {
        logger.debug("{},是個非常不要臉的程序員","沉默王二");
    }
}

看到了吧,使用佔位符要比“+”操作符方便的多。並且此時不再需要 isDebugEnabled() 先進行判斷,debug() 方法會在字符串拼接之前執行。

如果只是 Log4J 的話,會先進行字符串拼接,再執行 debug() 方法,來看示例代碼:

String name = "沉默王二";
int age = 18;
logger.debug(name + ",年紀:" + age + ",是個非常不要臉的程序員");

在調試這段代碼的時候,你會發現的,如下圖所示:

這也就意味着,如果日誌系統的級別不是 DEBUG,就會多執行了字符串拼接的操作,白白浪費了性能。

注意,阿里巴巴開發手冊上還有一條「強制」級別的規約:

這是因爲如果參數是基本數據類型的話,會先進行自動裝箱(Integer.valueOf())。測試代碼如下所示:

logger.debug("沉默王二,{}歲"18);

通過反編譯工具就可以看得到:

logger.debug("\u6C89\u9ED8\u738B\u4E8C\uFF0C{}\u5C81", Integer.valueOf(18));

如果參數需要調用其他方法的話,debug() 方法會隨後調用。

也就是說,如果不 isDebugEnabled() 的話,在不是 DEBUG 級別的情況下,會多執行自動裝箱和調用其他方法的操作——程序的性能就下降了!

測試類運行的結果和之前 Log4J 的一樣,小夥伴們可以點擊鏈接跳轉到 Log4j 那篇對比下。

04、總結

簡單總結一下這篇文章哈。

1)在使用日誌系統的時候,一定要使用 SLF4J 作爲門面擔當。

2)SLF4J 可以統一日誌系統,作爲上層的抽象接口,不需要關注底層的日誌實現,可以是 Log4j,也可以是 Logback,或者 JUL、JCL。

3)SLF4J 在打印日誌的時候可以使用佔位符,既提高了程序性能(臨時字符串少了,垃圾回收的工作量就小),又讓代碼變得美觀統一。

4)小夥伴們如果知道更多祕密的話,建議在留言區貼出來哦。

嗯哼,其實我已經寫完了整個日誌系統,包括 Log4j、 SLF4J、Logback、Log4j 它弟 Log4j 2,但我覺得分開來發的話,更利於 SEO(瞧我這爲了流量的心機,手動狗頭)。如果你確實需要看完整版的話,我也貼心地爲你準備了,點擊下面的鏈接就可以下載 PDF:

https://pan.baidu.com/s/1dPwsQhT5OMVapE7hGi7vww 提取碼:fxxy

碼字不易,日常求個贊吧,動一動金手指,bug 少一個(逃。

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