官网日志: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配置