log4j2实战--将MyBatis执行SQL记录到文件，按天分存

需求：将Mybatis的执行SQL，按天存日志文件。项目使用的是log4j2。

原先项目，都是将所有日志通通打印到控制台。现在需要将系统接收用户请求后，Mybatis的执行SQL，按天存日志文件。

当时在想：
把Mybatis的SQL打印到控制台容易实现，
日志按Level级别 按天存文件也容易实现，
但如何单独把Mybatis的SQL，按天存日志文件呢？

于是找了MyBatis日志配置说明
http://www.mybatis.org/mybatis-3/zh/logging.html

Mybatis 的内置日志工厂提供日志功能，内置日志工厂将日志交给以下其中一种工具作代理：

• SLF4J
• Apache Commons Logging
• Log4j 2
• Log4j
• JDK logging

MyBatis 内置日志工厂基于运行时自省机制选择合适的日志工具。它会使用第一个查找得到的工具（按上文列举的顺序查找）。如果一个都未找到，日志功能就会被禁用。

可以在mybatis-config.xml 中，设定使用的日志组件。

<configuration>
  <settings>
    ...
    <setting name="logImpl" value="LOG4J2"/>
    ...
  </settings>
</configuration>

        

          
        
        
        

          

          AI 代码解读
        
      
      

logImpl 可选的值有：SLF4J、LOG4J、LOG4J2、JDK_LOGGING、COMMONS_LOGGING、STDOUT_LOGGING、NO_LOGGING，或者是实现了接口org.apache.ibatis.logging.Log 的，且构造方法是以字符串为参数的类的完全限定名。

通过学习发现：Mybatis 中 SQL 语句的日志级别被设为DEBUG（JDK 日志设为 FINE），SQL执行结果的日志级别为 TRACE（JDK 日志设为 FINER)。

所以，如果某些查询可能会返回庞大的结果集，此时只想记录其执行的 SQL 语句而不想记录结果该怎么办，只要将日志级别调整为 DEBUG 即可达到目的。

可见：无论使用哪个日志组件、无论打印什么内容，均是按日志级别进行输出的。所以在本需求中，Mybatis的SQL按debug级别输出到指定地方即可。

无论是Mybatis框架，还是Spring、Java Mail框架，如果想看到框架底层运行的日志信息，配置日志级别为debug即可。

再次说明下，Mybatis 内置日志工厂将日志交给其中一种日志工具作代理。具体怎么做，由使用的日志工具决定，因此本需求MyBatis执行SQL的文件保存，是取决于使用的log4j2日志组件实现。

下面就来看一下log4j2具体的配置。

在log4j2中， 共有8个输出级别，按照从低到高为：ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

log4j2 的配置文件支持 xml、json、jsn 三种格式，默认情况下由系统自动加载，其要在classpath 可加载到的目录下。

日志配置文件主要配置2大类
1、配置输出源<Appenders>：日志输出到哪里。如控制台、file等
2、具体的日志配置<Loggers>：配置name，启用哪个Appender，以及日志级别等。

下面给出本需求的简单配置实现：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="ERROR" monitorInterval="600">
    <!-- configure.status 为设置日志输出级别，级别如下：OFF 、FATAL 、ERROR、WARN、INFO、DEBUG、TRACE、ALL -->
    <!-- configure.monitorInterval 监控间隔 指log4j2每隔600秒（10分钟），自动监控该配置文件是否有变化，如果变化，则自动根据文件内容重新配置 -->

    <Properties>
        <property name="pattern">%d{yyyy/MM/dd HH:mm:ss.SSS} [%p] %t %c %m%n</property>
        <property name="basePath">/Users/lijianhua/Documents/my-log</property>
    </Properties>

    <!--配置appenders源：日志输出的地址-->
    <Appenders>

        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout pattern="${pattern}"/>
        </Console>

        <RollingRandomAccessFile name="fileLogger"
                                 fileName="${basePath}/mybatis-sql.log"
                                 filePattern="${basePath}/mybatis-sql-%d{yyyy-MM-dd}.log"
                                 append="true">
            <PatternLayout pattern="${pattern}"/>

            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                <SizeBasedTriggeringPolicy size="100MB"/>
            </Policies>
        </RollingRandomAccessFile>
    </Appenders>

    <!--配置logers：级别、使用的输出地-->
    <Loggers>
        <Logger name="com.ljheee.app.dao" level="debug" additivity="true">
            <appender-ref ref="fileLogger" level="debug"/>
        </Logger>

        <Root level="info" additivity="false">
            <appender-ref ref="console"/>
        </Root>
    </Loggers>
</Configuration>

        

          
        
        
        

          

          AI 代码解读
        
      
      

通常log4j 采用properties文件配置。log4j2 采用xml文件配置。

log4j2 的xml文件配置，根节点是<Configuration>，它有2个可选属性：

• status 为设置日志输出级别，级别如下：OFF 、FATAL 、ERROR、WARN、INFO、DEBUG、TRACE 、ALL
• monitorInterval 监控间隔 指log4j2每隔600秒（10分钟），自动监控该配置文件是否有变化，如果变化，则自动根据文件内容重新配置。

1、配置输出源<Appenders>：

配置日志输出到哪里。如控制台、file等。

<Appenders>下通常有一个<Console> 表示日志都输出到控制台，方便开发期间进行查看。

另一个是<RollingRandomAccessFile>，按时间和文件大小滚动(rollover)的RollingRandomAccessFile Appender，名字真是够长，但不光只是名字长，相比RollingFileAppender有很大的性能提升，官网宣称是20-200%。

rollover的意思是当满足一定条件(如文件达到了指定的大小，达到了指定的时间)后，就重命名原日志文件进行归档，并生成新的日志文件用于log写入。如果还设置了一定时间内允许归档的日志文件的最大数量，将对过旧的日志文件进行删除操作。

这里说的“满足一定条件”，是需要触发的，需要配置基于时间的、或基于日志文件大小的触发策略，也就是如下配置：

            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                <SizeBasedTriggeringPolicy size="100MB"/>
            </Policies>

        

          
        
        
        

          

          AI 代码解读
        
      
      

关键点在于 filePattern后的日期格式，以及TimeBasedTriggeringPolicy的interval，日期格式精确到哪一位，interval也精确到哪一个单位。在本示例中，filePattern最小单位是天，interval=1也就是一天一个日志文件。

TimeBasedTriggeringPolicy基于时间的触发策略

2、具体的日志配置<Loggers>：

配置name，启用哪个Appender，以及日志级别等。

重点说明

<Logger name="com.ljheee.app.dao" level="debug" additivity="true">
            <appender-ref ref="fileLogger" level="debug"/>
</Logger>

        

          
        
        
        

          

          AI 代码解读
        
      
      

MyBatis支持多种粒度的日志记录：

1、可以记录某个映射器接口的日志
将name设为name="com.ljheee.app.dao.UserMapper"
就会记录 com.ljheee.app.dao.UserMapper 的详细执行操作，且仅记录应用中其它类的错误信息（若有）。

2、还可以将日志的记录方式从接口级别切换到语句级别，从而实现更细粒度的控制。如下配置只对 select 语句记录日志：
将name设为name="com.ljheee.app.dao.UserMapper.select"

3、当然也可以按实例配置到包级别，在DAO层，将包下所有MyBatis的mapper接口均使用日志记录。

小结：

log4j2 是Apache开发的一款log4j的升级产品，在某些特定的场景上面，甚至可以比之前的速度快上10倍。在保证log的组件更加快速的同时，同时所需的内存更加少。

上面在说RollingRandomAccessFile时，也说到性能很高，因为log4j2 内部使用了Disruptor高性能并发框架，输出日志采用异步输出，极高地提升了日志输出性能，因此也建议将后续的应用日志方式，切换到log4j2。

log4j2 配置示例https://howtodoinjava.com/log4j2/log4j-2-xml-configuration-example/
log4j2文档https://logging.apache.org/log4j/2.x/manual/appenders.html