系列文章已完成，目錄如下：

jdk-logging log4j logback日志系統(tǒng)實(shí)現(xiàn)機(jī)制原理介紹

commons-logging與jdk-logging、log4j1、log4j2、logback的集成原理

slf4j與jul、log4j1、log4j2、logback的集成原理

各種jar包總結(jié)

log4j1:

log4j：log4j1的全部?jī)?nèi)容

log4j2:

log4j-api:log4j2定義的API

log4j-core:log4j2上述API的實(shí)現(xiàn)

logback:

logback-core:logback的核心包

logback-classic：logback實(shí)現(xiàn)了slf4j的API

commons-logging:

commons-logging:commons-logging的原生全部?jī)?nèi)容

log4j-jcl:commons-logging到log4j2的橋梁

jcl-over-slf4j：commons-logging到slf4j的橋梁

slf4j轉(zhuǎn)向某個(gè)實(shí)際的日志框架:

場(chǎng)景介紹：如 使用slf4j的API進(jìn)行編程，底層想使用log4j1來(lái)進(jìn)行實(shí)際的日志輸出，這就是slf4j-log4j12干的事。

slf4j-jdk14：slf4j到j(luò)dk-logging的橋梁

slf4j-log4j12：slf4j到log4j1的橋梁

log4j-slf4j-impl：slf4j到log4j2的橋梁

logback-classic：slf4j到logback的橋梁

slf4j-jcl：slf4j到commons-logging的橋梁

某個(gè)實(shí)際的日志框架轉(zhuǎn)向slf4j：

場(chǎng)景介紹：如 使用log4j1的API進(jìn)行編程，但是想最終通過(guò)logback來(lái)進(jìn)行輸出，所以就需要先將log4j1的日志輸出轉(zhuǎn)交給slf4j來(lái)輸出，slf4j再交給logback來(lái)輸出。將log4j1的輸出轉(zhuǎn)給slf4j，這就是log4j-over-slf4j做的事

這一部分主要用來(lái)進(jìn)行實(shí)際的日志框架之間的切換（下文會(huì)詳細(xì)講解）

jul-to-slf4j：jdk-logging到slf4j的橋梁

log4j-over-slf4j：log4j1到slf4j的橋梁

jcl-over-slf4j：commons-logging到slf4j的橋梁

集成總結(jié)

commons-logging與其他日志框架集成

1 commons-logging與jdk-logging集成：

需要的jar包：

commons-logging

2 commons-logging與log4j1集成：

需要的jar包：

commons-logging

log4j

3 commons-logging與log4j2集成：

需要的jar包：

commons-logging

log4j-api

log4j-core

log4j-jcl(集成包)

4 commons-logging與logback集成：

需要的jar包：

logback-core

logback-classic

slf4j-api、jcl-over-slf4j(2個(gè)集成包,可以不再需要commons-logging)

5 commons-logging與slf4j集成：

需要的jar包：

jcl-over-slf4j(集成包，不再需要commons-logging)

slf4j-api

slf4j與其他日志框架集成

slf4j與jdk-logging集成：

需要的jar包：

slf4j-api

slf4j-jdk14(集成包)

slf4j與log4j1集成：

需要的jar包：

slf4j-api

log4j

slf4j-log4j12(集成包)

slf4j與log4j2集成：

需要的jar包：

slf4j-api

log4j-api

log4j-core

log4j-slf4j-impl(集成包)

slf4j與logback集成：

需要的jar包：

slf4j-api

logback-core

logback-classic(集成包)

slf4j與commons-logging集成：

需要的jar包：

slf4j-api

commons-logging

slf4j-jcl(集成包)

日志系統(tǒng)之間的切換

 log4j無(wú)縫切換到logback

1 案例

我們已經(jīng)在代碼中使用了log4j1的API來(lái)進(jìn)行日志的輸出，現(xiàn)在想不更改已有代碼的前提下，使之通過(guò)logback來(lái)進(jìn)行實(shí)際的日志輸出。

已使用的jar包：

log4j

使用案例：

private static final Logger logger=Logger.getLogger(Log4jTest.class);
public static void main(String[] args){
	if(logger.isInfoEnabled()){
		logger.info("log4j info message");
	}
}

上述的Logger是log4j1自己的org.apache.log4j.Logger，在上述代碼中，我們?cè)谑褂胠og4j1的API進(jìn)行編程

現(xiàn)在如何能讓上述的日志輸出通過(guò)logback來(lái)進(jìn)行輸出呢？

只需要更換一下jar包就可以：

第一步：去掉log4j jar包

第二步：加入以下jar包

log4j-over-slf4j（實(shí)現(xiàn)log4j1切換到slf4j）

slf4j-api

logback-core

logback-classic

第三步：在類(lèi)路徑下加入logback的配置文件

原理是什么呢？

2 切換原理

看下log4j-over-slf4j就一目了然了：

我們可以看到，這里面其實(shí)是簡(jiǎn)化更改版的log4j。去掉log4j1的原生jar包，換成該簡(jiǎn)化更改版的jar包（可以實(shí)現(xiàn)無(wú)縫遷移）。

但是簡(jiǎn)化更改版中的Logger和原生版中的實(shí)現(xiàn)就不同了，簡(jiǎn)化版中的Logger實(shí)現(xiàn)如下（繼承了Category）：

public class Category {
    private String name;
    protected org.slf4j.Logger slf4jLogger;
    private org.slf4j.spi.LocationAwareLogger locationAwareLogger;
    Category(String name) {
        this.name = name;
        slf4jLogger = LoggerFactory.getLogger(name);
        if (slf4jLogger instanceof LocationAwareLogger) {
            locationAwareLogger = (LocationAwareLogger) slf4jLogger;
        }
    }
}

從上面可以看到簡(jiǎn)化版中的Logger內(nèi)部是使用slf4j的API來(lái)生成的，所以我們使用的簡(jiǎn)化版的Logger會(huì)委托給slf4j來(lái)進(jìn)行輸出，由于當(dāng)前類(lèi)路徑下有l(wèi)ogback-classic，所以slf4j會(huì)選擇logback進(jìn)行輸出。從而實(shí)現(xiàn)了log4j到logback的日志切換。

下面的內(nèi)容就只講解日志系統(tǒng)到slf4j的切換，不再講解slf4j選擇何種日志來(lái)輸出

jdk-logging無(wú)縫切換到logback

1 案例

private static final Logger logger=Logger.getLogger(JulSlf4jLog4jTest.class.getName());
public static void main(String[] args){
	logger.log(Level.INFO,"jul info a msg");
	logger.log(Level.WARNING,"jul waring a msg");
}

可以看到上述是使用jdk-logging自帶的API來(lái)進(jìn)行編程的，現(xiàn)在我們想這些日志交給logback來(lái)輸出

解決辦法如下：

第一步：加入以下jar包：

jul-to-slf4j （實(shí)現(xiàn)jdk-logging切換到slf4j）

slf4j-api

logback-core

logback-classic

第二步：在類(lèi)路徑下加入logback的配置文件

第三步：在代碼中加入如下代碼：

static{
	SLF4JBridgeHandler.install();
}

切換原理

先來(lái)看下jul-to-slf4j jar包中的內(nèi)容：

我們看到只有一個(gè)類(lèi)：SLF4JBridgeHandler

它繼承了jdk-logging中定義的java.util.logging.Handler，Handler是jdk-logging處理日志過(guò)程中的一個(gè)處理器（具體我也沒(méi)仔細(xì)研究過(guò)），在使用之前，必須要提前注冊(cè)這個(gè)處理器，即上述的SLF4JBridgeHandler.install()操作，install后我們就可以通過(guò)這個(gè)handler實(shí)現(xiàn)日志的切換工作，如下：

protected Logger getSLF4JLogger(LogRecord record) {
    String name = record.getLoggerName();
    if (name == null) {
        name = UNKNOWN_LOGGER_NAME;
    }
    return LoggerFactory.getLogger(name);
}

在處理日志的過(guò)程中，使用了slf4j的原生方式LoggerFactory來(lái)獲取一個(gè)slf4j定義的Logger來(lái)進(jìn)行日志的輸出

而slf4j則又會(huì)選擇logback來(lái)進(jìn)行實(shí)際的日志輸出

commons-logging切換到logback

使用案例

使用的jar包

commons-logging

案例如下：

private static Log logger=LogFactory.getLog(JulJclTest.class);
public static void main(String[] args){
	if(logger.isTraceEnabled()){
		logger.trace("commons-logging-jcl trace message");
	}
}	

可以看到我們使用commons-logging的API來(lái)進(jìn)行日志的編程操作，現(xiàn)在想切換成logback來(lái)進(jìn)行日志的輸出（這其實(shí)就是commons-logging與logback的集成）

解決辦法如下：

第一步：去掉commons-logging jar包（其實(shí)去不去都無(wú)所謂）

第二步：加入以下jar包：

jcl-over-slf4j（實(shí)現(xiàn)commons-logging切換到slf4j）

slf4j-api

logback-core

logback-classic

第三步：在類(lèi)路徑下加入logback的配置文件

切換原理

這個(gè)原理之前都已經(jīng)說(shuō)過(guò)了，可以看下commons-logging與logback的集成

就是commons-logging通過(guò)jcl-over-slf4j 來(lái)選擇slf4j作為底層的日志輸出對(duì)象，而slf4j又選擇logback來(lái)作為底層的日志輸出對(duì)象。

常用的日志場(chǎng)景切換解釋

上面把日志的切換原理說(shuō)清楚了，下面就針對(duì)具體的例子來(lái)進(jìn)行應(yīng)用

先來(lái)看下slf4j官方的一張圖：

下面分別詳細(xì)說(shuō)明這三個(gè)案例

1 左上圖

現(xiàn)狀：

目前的應(yīng)用程序中已經(jīng)使用了如下混雜方式的API來(lái)進(jìn)行日志的編程：

現(xiàn)在想統(tǒng)一將日志的輸出交給logback

commons-logging

log4j1

jdk-logging

解決辦法：

加入以下jar包：

第一步：將上述日志系統(tǒng)全部無(wú)縫先切換到slf4j

• 去掉commons-logging（其實(shí)去不去都可以），使用jcl-over-slf4j將commons-logging的底層日志輸出切換到slf4j
• 去掉log4j1(必須去掉),使用log4j-over-slf4j,將log4j1的日志輸出切換到slf4j
• 使用jul-to-slf4j，將jul的日志輸出切換到slf4j

第二步：使slf4j選擇logback來(lái)作為底層日志輸出

slf4j-api

logback-core

logback-classic

下面的2張圖和上面就很類(lèi)似

2 右上圖

現(xiàn)狀：

目前的應(yīng)用程序中已經(jīng)使用了如下混雜方式的API來(lái)進(jìn)行日志的編程：

現(xiàn)在想統(tǒng)一將日志的輸出交給log4j1

commons-logging

jdk-logging

解決辦法：

加入以下jar包：

第一步：將上述日志系統(tǒng)全部無(wú)縫先切換到slf4j

• 去掉commons-logging（其實(shí)去不去都可以），使用jcl-over-slf4j將commons-logging的底層日志輸出切換到slf4j
• 使用jul-to-slf4j，將jul的日志輸出切換到slf4j

第二步：使slf4j選擇log4j1來(lái)作為底層日志輸出

加入以下jar包：

slf4j-api

log4j

slf4j-log4j12(集成包)

3 左下圖

現(xiàn)狀：

目前的應(yīng)用程序中已經(jīng)使用了如下混雜方式的API來(lái)進(jìn)行日志的編程：

現(xiàn)在想統(tǒng)一將日志的輸出交給jdk-logging

commons-logging

log4j

解決辦法：

第一步：將上述日志系統(tǒng)全部無(wú)縫先切換到slf4j

• 去掉commons-logging（其實(shí)去不去都可以），使用jcl-over-slf4j將commons-logging的底層日志輸出切換到slf4j
• 去掉log4j1(必須去掉),使用log4j-over-slf4j,將log4j1的日志輸出切換到slf4j

第二步：使slf4j選擇jdk-logging來(lái)作為底層日志輸出

加入以下jar包：

slf4j-api

slf4j-jdk14(集成包)

沖突說(shuō)明

仍然是這里的內(nèi)容slf4j官網(wǎng)的沖突說(shuō)明

其實(shí)明白上面介紹的各jar包的作用，就很容易理解

jcl-over-slf4j 與 slf4j-jcl 沖突

jcl-over-slf4j： commons-logging切換到slf4j

slf4j-jcl : slf4j切換到commons-logging

如果這兩者共存的話(huà)，必然造成相互委托，造成內(nèi)存溢出

log4j-over-slf4j 與 slf4j-log4j12 沖突

log4j-over-slf4j ： log4j1切換到slf4j

slf4j-log4j12 : slf4j切換到log4j1

如果這兩者共存的話(huà)，必然造成相互委托，造成內(nèi)存溢出。但是log4j-over-slf4內(nèi)部做了一個(gè)判斷，可以防止造成內(nèi)存溢出：

即判斷slf4j-log4j12 jar包中的org.slf4j.impl.Log4jLoggerFactory是否存在，如果存在則表示沖突了，拋出異常提示用戶(hù)要去掉對(duì)應(yīng)的jar包，代碼如下，在slf4j-log4j12 jar包的org.apache.log4j.Log4jLoggerFactory中：

jul-to-slf4j 與 slf4j-jdk14 沖突

jul-to-slf4j ： jdk-logging切換到slf4j

slf4j-jdk14 : slf4j切換到j(luò)dk-logging

如果這兩者共存的話(huà)，必然造成相互委托，造成內(nèi)存溢出

 結(jié)束語(yǔ)

至此，這個(gè)日志系列就算終于完成了。它注重于日志系統(tǒng)之間的交互與集成，所以想深入研究單個(gè)日志系統(tǒng)的架構(gòu)的話(huà)，就需要各位自行去深入研究了,希望大家以后多多支持腳本之家！

最新評(píng)論