Log日誌（二）

1. slf4j log4j logback的關係

The Simple Logging Facade for Java 是什麼？

籠統的講就是slf4j是一系列的日誌接口，而log4j logback是具體實現了的日誌框架。接下來我們跟着官方文檔詳細的來看一下他們的關係。

The Simple Logging Facade for Java (SLF4J) serves as a simple facade or abstraction for various logging frameworks, such as java.util.logging, logbackand log4j. SLF4J allows the end-user to plug in the desired logging framework at deployment time. Note that SLF4J-enabling your library/application implies the addition of only a single mandatory dependency, namely slf4j-api-1.7.21.jar.

官方文檔的這一段話已經明確描述了三者的關係。slf4j譯爲簡單日誌門面，是日誌框架的抽象。而log4j和logback是衆多日誌框架中的幾種。

即，是jdbc和mysql驅動的關係。項目中使用slf4j的api操作日誌，底層的日誌實現由其他日誌框架完成。

項目中直接使用slf4j是一種解耦的設計。如果直接使用日誌框架也可以但更換日誌框架時會需要改代碼。

2. 測試

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
@Test
public void test2(){
    // 手動會的Logger對象
    Logger logger = LoggerFactory.getLogger(TestMybatis.class);
    // 輸出日誌信息
    logger.debug("ssss");
}

@Slf4j // lombok註解，自動爲class生成一個屬性：Logger log;
public class A{
    // 如下屬性會自動生成
    //private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(A.class);
    
    public void fn1(){
        // 直接使用log，輸出日誌信息
        log.info("xxxx");
    }
}

#如果只導入了slf4j 而沒有導入任何日誌框架，則會報出如下警告：
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

3. log4j和logback呢？

而log4j和logback就是兩個受歡迎的日誌框架。但兩者又有不同。

• log4j是apache實現的一個開源日誌組件。（Wrapped implementations）
• logback同樣是由log4j的作者設計完成的，擁有更好的特性，用來取代log4j的一個日誌框架。是slf4j的原生實現。（Native implementations）

上圖可以看到應用程序對日誌框架的調用關係。應用程序調用slf4j api，而日誌的輸出最終是由底層的日誌框架來實現的。這張圖也提現了log4j和logback的不同。

官方文檔對logback的描述

NATIVE IMPLEMENTATION There are also SLF4J bindings external to the SLF4J project, e.g. logback which implements SLF4J natively. Logback’s ch.qos.logback.classic.Logger class is a direct implementation of SLF4J’s org.slf4j.Logger interface. Thus, using SLF4J in conjunction with logback involves strictly zero memory and computational overhead.

可以看到logback是直接實現了slf4j的接口，是不消耗內存和計算開銷的。

而log4j不是對slf4j的原生實現，所以slf4j api在調用log4j時需要一個適配層。

所謂“直接實現”，“需要適配層”：

<!-- slf4j：項目中直接使用其中的api -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.12</version>
</dependency>
<!-- 適配層：使得slf4j可以調用log4j的實現 -->
<!-- 【ops:實際使用時，導入這個適配依賴即可傳遞導入其他兩個】 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.12</version>
</dependency>
<!-- 日誌框架：log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.16</version>
</dependency>

<!-- Logback依賴，還會傳遞 slf4j 和 logback-core -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.1.7</version>
</dependency>

4. 配置

一般情況下，開發階段使用debug，上線後使用Info

<?xml version="1.0"  encoding="UTF-8" ?>
<!--
<!DOCTYPE log4j:configuration PUBLIC "-//LOGGER"
        "http://logging.apache.org/log4j/1.2/org/apache/log4j/xml/log4j.dtd">

<log4j:configuration>
-->
<!DOCTYPE log4j:configuration PUBLIC "-//LOGGER"
        "http://org/apache/log4j/xml/log4j.dtd">
<log4j:configuration>
    <!--若干個appender的定義-->
    <!--org.apache.log4j.ConsoleAppender 輸出到控制檯-->
    <appender name="myConsole" class="org.apache.log4j.ConsoleAppender">
        <!--輸出格式-->
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n"/>
        </layout>
        <!--過濾器設置輸出的級別 all trace debug info warn error fatal off
            log.trace("haha");
            log.error("hehe");
            log.debug("gg");
        -->
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="levelMin" value="debug" />
            <param name="levelMax" value="warn" />
            <param name="AcceptOnMatch" value="true" />
        </filter>
    </appender>

    <!--org.apache.log4j.DailyRollingFileAppender 每天產生一個日誌文件
        output2.log=項目根目錄下的output2.log(web環境不適用)
        d:\output1000.log=對應的磁盤位置
        output1000.log.2019-10-31
        output1000.log
    -->
    <!--
    %p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL
     %r 輸出自應用啓動到輸出該log信息耗費的毫秒數
     %c 輸出所屬的類目，通常就是所在類的全名
     %t 輸出產生該日誌事件的線程名
     %n 輸出一個回車換行符，Windows平臺爲“/r/n”，Unix平臺爲“/n”
     %d 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也可以在其後指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
     %l 輸出日誌事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlo4.main(TestLog4.java:10)
    -->

    <appender name="myFile" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="File" value="D:/Java/ProjectJ/myLog/myLogDebug.log"/><!--文件位置-->
        <param name="Append" value="true"/><!--是否選擇追加-->
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern"
                   value="%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n"/>
        </layout>
    </appender>

    <!--org.apache.log4j.RollingFileAppender 滾動日誌文件輸出
        文件大小到達 （kb、mb） 一定尺寸時重新產生新的文件
        除日誌文件本身之外，最多額外產生兩個新文件，當達到2個後，
        如果日誌文件又達到1mb，則會在第一個新文件中覆蓋寫入。然後再需要就是第二個新文件中覆蓋寫入。
        所以此種需要顧及好大小和個數，否則會有日誌覆蓋。
    -->
    <appender name="myFile2" class="org.apache.log4j.RollingFileAppender">
        <param name="File" value="D:/Java/ProjectJ/myLog/myLogInfo.log" />
        <param name="Append" value="true" />
        <param name="MaxFileSize" value="1mb"/>
        <param name="MaxBackupIndex" value="2" />
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%p (%c:%L)- %m%n" />
        </layout>
    </appender>

    <!--將各個包日誌、類日誌 輸出到不同的日誌文件中
        這樣可以便於日誌的分類。
    -->
    <!-- org.springframework包下的日誌最低輸出優先級爲info，由myFile輸出 -->
    <category name="org.springframework">
        <!-- 當前包下的日誌不在父日誌中輸出，即不再在root中定義的各個appender中輸出 -->
        <param name="additivity" value="false"/>
        <priority value="info"/>
        <appender-ref ref="myFile2"/>
    </category>
    <category name="com.alibaba.druid.pool.DruidDataSource">
        <priority value="warn"/>
        <appender-ref ref="myConsole"/>
    </category>


    <!-- 根logger的設置-->
    <root>
        <!--優先級設置，假設設置爲“info”，則無法輸出debug級別的日誌-->
        <priority value="debug"/>
        <!--<priority value="info"/>-->
        <!--<priority value="warn"/>-->
        <!--<priority value="error"/>-->
        <!--<priority value="fatal"/>-->

        <!-- 添加剛纔設置的appender -->
        <!-- 所有沒有單獨設置的日誌位置會在如下注冊的appender中輸出 -->
        <appender-ref ref="myConsole"/>
        <appender-ref ref="myFile"/>
        <appender-ref ref="myFile2"/>
    </root>
</log4j:configuration>