mybatis.configuration.log-impl详解

一、概述

mybatis.configuration.log-impl是MyBatis一种日志输出的实现方式，主要用于方便调试，排查问题。默认情况下，MyBatis没有开启日志记录，因此当需要排查问题时，往往需要手动开启日志记录，这时mybatis.configuration.log-impl就会派上用场。

二、使用方式

使用mybatis.configuration.log-impl，需要在mybatis-config.xml文件中进行配置。具体方式如下：

<configuration>
    <!-- 配置日志实现 -->
    <settings>
        <!-- 指定日志实现 --> 
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>
</configuration>

这个例子中，我们设置了logImpl的值为STDOUT_LOGGING，表示使用SLF4J记录日志。

三、STDOUT_LOGGING

STDOUT_LOGGING是MyBatis默认的日志输出方式，也是最简单的日志输出方式。 MyBatis会自动打印日志到控制台上，我们不需要任何配置就可以使用这种方式。不过需要注意的是，这种方式只能用来简单地检查查询语句等，对于一些复杂的问题，使用STDOUT_LOGGING的效果会不太理想。

四、LOG4J2

如果我们使用的是Log4j2作为日志框架，那么我们可以设置logImpl的值为LOG4J2，MyBatis就会使用Log4j2来记录日志。

<configuration>
    <!-- 配置日志实现 -->
    <settings>
        <!-- 指定日志实现 --> 
        <setting name="logImpl" value="LOG4J2"/>
    </settings>
</configuration>

五、LOG4J

如果我们使用的是Log4j1作为日志框架，那么我们可以设置logImpl的值为LOG4J，MyBatis就会使用Log4j1来记录日志。

<configuration>
    <!-- 配置日志实现 -->
    <settings>
        <!-- 指定日志实现 --> 
        <setting name="logImpl" value="LOG4J"/>
    </settings>
</configuration>

六、LOG4J2实现方式

在使用Log4j2作为日志框架时，MyBatis默认使用Log4j2Logger作为日志输出实现。为了确保MyBatis能够正常地使用Log4j2Logger进行日志输出，我们需要将Log4j2的配置文件log4j2.xml放到classpath下面。

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="ERROR">
    <Appenders>
        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n" />
        </Console>
        <File name="mybatis-log" fileName="logs/mybatis-log.log">
          <PatternLayout pattern="%d %p %c{1.} [%t] %m%n" />
        </File>
    </Appenders>
    <Loggers>
        <Logger name="org.apache.ibatis" level="debug" additivity="false">
            <AppenderRef ref="mybatis-log"/>
        </Logger>
        <Root level="error">
            <AppenderRef ref="console"/>
        </Root>
    </Loggers>
</Configuration>

七、LOG4J实现方式

在使用Log4j1作为日志框架时，MyBatis默认使用Log4jImpl作为日志输出实现。为了确保MyBatis能够正常地使用Log4jImpl进行日志输出，我们需要把Log4j的配置文件log4j.properties放在classpath下面。

log4j.rootLogger=INFO, ALL
log4j.appender.ALL=org.apache.log4j.ConsoleAppender
log4j.appender.ALL.Threshold=INFO
log4j.appender.ALL.layout=org.apache.log4j.PatternLayout
log4j.appender.ALL.layout.ConversionPattern=%d{ISO8601} [%t] %p %c - %m%n

八、总结

mybatis.configuration.log-impl提供了多种日志记录方式，不仅能够记录SQL语句，还能记录一些调试信息，帮助我们更好地理解MyBatis的工作方式，快速解决问题。