【原】配置Log4j，使得MyBatis打印出SQL语句

官网日志：mybatis官网日志文档

日志格式请参考：Pattern Layout 下对应的:Patterns规则。

【配置步骤】

一、mybatis-config.xml

设置MyBatis的Setting（非必须，不同环境下，可能不需要该设置）。原因如下：

Mybatis通过日志工厂提供日志信息，Mybatis内置的日志模版是log4j,commons.log,jdk log也可以通过slf4j简单日志模版结合log4j使用日志信息输出．具体选择哪个日志实现由MyBatis的内置日志工厂确定。它会使用最先找到的（按上文列举的顺序查找）。 如果一个都未找到，日志功能就会被禁用。不少应用服务器的classpath中已经包含Commons Logging，如Tomcat和WebShpere， 所以MyBatis会把它作为具体的日志实现。记住这点非常重要。这意味着，在诸如 WebSphere的环境中——WebSphere提供了Commons Logging的私有实现，你的Log4J配置将被忽略。

不过，如果你的应用部署在一个包含Commons Logging的环境， 而你又想用其他的日志框架，你可以做如下配置．

1．　配置日志输出方式是log4j　

在“src/main/java/resources”目录下，创建mybatis-config.xml文件，并且输入下列内容。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
    PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
    "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <settings>
        <setting name="lazyLoadingEnabled" value="false" />
        <setting name="logImpl" value="LOG4J" />
    </settings>
</configuration>

2.    使用对应的方法来指定使用哪个日志实现框架

org.apache.ibatis.logging.LogFactory.useSlf4jLogging();

org.apache.ibatis.logging.LogFactory.useLog4JLogging();

org.apache.ibatis.logging.LogFactory.useLog4J2Logging();

org.apache.ibatis.logging.LogFactory.useJdkLogging();

org.apache.ibatis.logging.LogFactory.useCommonsLogging();

org.apache.ibatis.logging.LogFactory.useStdOutLogging();

 

二、配置log4j的配置文件。

不同的项目中，log4j的配置文件的格式可能不同，在一些项目中，log4j的配置文件是XML格式的，比如log4j.xml；在另一些项目中，log4j的配置文件是properties格式的，比如log4j.properties。

1、对于properties格式文件的配置。

###############Log4j 4 SQL Output start#################
##下面两个，选择一个就可以了
log4j.logger.com.xxx.mydao=DEBUG  //这个自己的包名。如果没有的话，可能不能打印出日志
log4j.logger.com.xxx.mydao=TRACE //这里就表示将对应的mapper结果记录
log4j.logger.com.xxx.mydao.selectBlog=TRACE/DEBUG //这个是指定到方法级别
log4j.logger.com.springframework=DEBUG
log4j.logger.com.ibatis=DEBUG  
log4j.logger.com.ibatis.common.jdbc.SimpleDataSource=DEBUG  
log4j.logger.com.ibatis.common.jdbc.ScriptRunner=DEBUG  
log4j.logger.com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate=DEBUG  
log4j.logger.java.sql.Connection=DEBUG  
log4j.logger.java.sql.Statement=DEBUG  
log4j.logger.java.sql.PreparedStatement=DEBUG  
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.org.apache.ibatis.logging.commons.JakartaCommonsLoggingImpl=DEBUG
log4j.logger.java.sql=DEBUG,CONSOLE 
###############Log4j 4 SQL Output end###################

　　某些查询可能会返回大量的数据，只想记录其执行的SQL语句该怎么办？为此，Mybatis中SQL语 句的日志级别被设为DEBUG（JDK Logging中为FINE），结果日志的级别为TRACE（JDK Logging中为FINER)。所以，只要将日志级别调整为DEBUG即可达到目的：

2、对于xml格式文件的配置。

<loggers>
    <!-- name可以指定包名或具体的类；additivity如果指定true，则root logger也会生效，相同日志会输出两次;false，则只有当前日志文件输出 -->
    <!-- 借据插入接口日志 -->
    <logger level="info" name="insertCreditBill" additivity="false">
        <appender-ref ref="insertCreditBillLog" />
    </logger>                                
    
    <!-- 下面是打印通过log4j2打印出mybatis语句的配置-->
    <logger name="com.xxx.mydao">
        <level>DEBUG</level>
    </logger>
    <logger name="com.springframework">
        <level>DEBUG</level>
    </logger>                        
    <logger name="com.ibatis" additivity="true"> 
        <level>DEBUG</level> 
    </logger>
    <logger name="com.ibatis.common.jdbc.SimpleDataSource" additivity="true"> 
        <level>DEBUG</level> 
    </logger>        
    <logger name="com.ibatis.common.jdbc.ScriptRunner" additivity="true"> 
        <level>DEBUG</level>
    </logger>    
    <logger name="com.ibatis.sqlmap.engine.impl.SqlMapClientDelegate" additivity="true"> 
        <level>DEBUG</level>
    </logger>                             
    <logger name="Java.sql.Connection" additivity="true">  
        <level>DEBUG</level>
    </logger> 
    <logger name="java.sql.Statement" additivity="true"> 
        <level>DEBUG</level>
    </logger> 
    <logger name="java.sql.PreparedStatement" additivity="true"> 
        <level>DEBUG</level>
    </logger> 
    <logger name="java.sql.ResultSet" additivity="true"> 
        <level>DEBUG</level>
    </logger>     
    <logger name="org.apache.ibatis.logging.commons.JakartaCommonsLoggingImpl" additivity="true"> 
        <level>DEBUG</level>
    </logger>                     
    
    <!-- root logger，任何其它的logger最终都相当于继承自 root logger -->
    <root level="INFO">
        <appenderRef ref="Console" />
        <appenderRef ref="FileLog"></appenderRef>
    </root>
</loggers>

说明：

上述配置中，“com.xxx.mydao”为自己项目中MyBatis的所有的mapper和xml文件所在的包名字。

至此，log4j的打印SQL语句的配置完成。

3、XML格式配置的精简版本

<loggers>                            
    <!-- 下面是打印通过log4j2打印出mybatis语句的配置-->
    <logger name="com.xxx.mydao">
        <level>DEBUG</level>
    </logger>
    
    <!-- root logger，任何其它的logger最终都相当于继承自 root logger -->
    <root level="INFO">
        <appenderRef ref="Console" />
        <appenderRef ref="FileLog"></appenderRef>
    </root>
</loggers>

说明：
　　在开发中，需要配置让哪个包下的程序打印出SQL，则仅仅只用配置那一个包名就成。

　　上述配置中，“com.xxx.mydao”为自己项目中MyBatis的mapper和xml文件所在的包名字，因此，精简版中，仅仅配置了这个包的内容

【拓展】

“细粒度”控制：Log4j打印出MyBatis中仅仅单个Mapper的配置。

<!-- 下面是通过配置log4j2，仅仅打印出单个mapper的SQL语句的配置-->
<logger name="com.**.dao.UserMapper">
    <level>DEBUG</level>
</logger>

三、POM.XML文件配置

<dependency>
	<groupId>log4j</groupId>
	<artifactId>log4j</artifactId>
	<version>1.2.17</version>
</dependency>
<dependency>
	<groupId>org.slf4j</groupId>
	<artifactId>slf4j-log4j12</artifactId>
	<version>1.7.21</version>
</dependency>
<dependency>
	<groupId>org.slf4j</groupId>
	<artifactId>slf4j-api</artifactId>
	<version>1.7.21</version>
</dependency>

1、单独开放第三个无法打印sql语句
2、第一种和第三种无法打印sql语句
3、其他情况都可以打印出sql语句
4、最后得出的结论可能是版本冲突的问题

总而言之  
  1、没有slf4j，只要log4j即可  
  2、有slf4j，则必须要有slf4j-log4j12，其他的可有可无  

 

 mybatis和其他架构包混用，

最头痛的就是这种，试了很多种办法，最后才校验出一种合适的办法。就是一定要用log4j.xml配置

 

来源：oschina

链接：https://my.oschina.net/u/3565362/blog/1606512