1.支持日志框架

MyBatis支持使用多種日志框架來(lái)打印sql，包括：slf4j、commons-logging、log4j、log4j2、jdk logging、stdout、no logging等。因此在打印日志時(shí)，我們首要確定自己使用的日志框架是什么，然后進(jìn)行相應(yīng)的配置。

默認(rèn)情況下，mybatis按照如下方式檢測(cè)需要使用的日志框架實(shí)現(xiàn)：

slf4j-->commons-logging-->log4j2-->log4j-->jdk logging(jul)-->no logging

在3.5.5 mybatis的org.Apache.ibatis.logging.LogFactory類(lèi)的源碼中體現(xiàn)：

mybatis日志工廠

其中slf4j，commons-logging都是facade設(shè)計(jì)模式的實(shí)現(xiàn)，底層需要依賴(lài)具體的日志框架，如log4j、log4j2、logback等。并且還要引入相應(yīng)的橋接jar包依賴(lài)。

對(duì)于日志框架jar包依賴(lài)缺少或者沖突的情況，mybatis提供了一個(gè)終極解決方案，通過(guò)logImpl配置來(lái)強(qiáng)制指定使用哪個(gè)日志框架，使用方式如下所示：

<settings>
        <setting name="logImpl" value="LOG4J"/>
 </settings>

logImpl的取值范圍：SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING

其中，STDOUT_LOGGING表示打印日志到控制臺(tái)。NO_LOGGING表示不打印日志。

下面這張圖列表出了slf4j在和各種底層日志框架如何整合，以及相應(yīng)的需要引入的橋接jar包，詳見(jiàn)slf4j官網(wǎng)：http://www.slf4j.org/manual.html

slf4j日志框架整合

2.打印日志案例

本案例以log4jdbc + log4j來(lái)打印mybatis日志。

pom.xml引入以下依賴(lài)：

        <!--log4jdbc-->
        <dependency>
            <groupId>org.bgee.log4jdbc-log4j2</groupId>
            <artifactId>log4jdbc-log4j2-jdbc4.1</artifactId>
            <version>1.16</version>
        </dependency>
        <!--slf4j-->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.30</version>
        </dependency>
        <!--橋接,依賴(lài)log4j坐標(biāo)-->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.7.30</version>
        </dependency>

mybatis-config.xml添加日志配置：

  <settings>
    <setting name="logImpl" value="LOG4J"/>
  </settings>

jdbc.properties進(jìn)行數(shù)據(jù)庫(kù)連接配置：

jdbc.driver=net.sf.log4jdbc.sql.jdbcapi.DriverSpy
jdbc.url=jdbc:log4jdbc:MySQL://127.0.0.1:3306/cms?useUnicode=true&characterEncoding=utf8&useSSL=false
jdbc.username=root
jdbc.password=root

log4j.properties進(jìn)行日志配置：

log4j.rootLogger=INFO,Console
    
#Console    
log4j.Appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.console.Target=System.out
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
  
log4j.logger.org.apache=ERROR
log4j.logger.org.mybatis=ERROR
log4j.logger.mybatis=DEBUG
log4j.logger.log4jdbc.debug=ERROR
  
log4j.logger.jdbc.audit=ERROR
log4j.logger.jdbc.resultset=OFF
log4j.logger.jdbc.sqlonly=DEBUG
log4j.logger.jdbc.sqltiming=ERROR
log4j.logger.jdbc.connection=FATAL
log4j.logger.jdbc.resultsettable=INFO

log4jdbc.log4j2.properties進(jìn)行配置：

log4jdbc.spylogdelegator.name=net.sf.log4jdbc.log.slf4j.Slf4jSpyLogDelegator

junit測(cè)試代碼如下：

    @Test
    void getList() {
        User user = User.builder().id(1).build();
        List<User> userList = userDao.getList(user);
//        userList.forEach(x -> log.info("===>{}",x));
        assertNotNull(userList);
    }

控制臺(tái)打印效果如下：

控制臺(tái)SQL語(yǔ)句

3.日志最佳實(shí)踐

一般在生產(chǎn)環(huán)境中應(yīng)用系統(tǒng)，日志級(jí)別調(diào)整為INFO或者WARN以避免過(guò)多的輸出日志。但某些時(shí)候，需要跟蹤具體問(wèn)題，那么就得打開(kāi)DEBUG日志。但是如果設(shè)置root logger為DEBUG級(jí)別，則需要的信息就會(huì)淹沒(méi)在日志的海洋中。

此時(shí)，需要單獨(dú)指定某個(gè)或者某些logger(如mybatis打印sql的logger)的日志級(jí)別為DEBUG，而root logger保持INFO或WARN不變。