MyBatis3用log4j在控制台输出SQL的方法示例

时间:2021-12-26 06:06:37

为什么要在控制台输出 SQL 呢?

当然是为了开发调试的时候方便了。

如果一个 数据库相关的操作出现了问题,我们可以根据输出的SQL语句快速排查问题。

输出的信息:

[org.mybatis.spring.SqlSessionUtils]-Creating a new SqlSession 
[org.mybatis.spring.SqlSessionUtils]-SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@33290f98] was not registered for synchronization because synchronization is not active 
[org.springframework.jdbc.datasource.DataSourceUtils]-Fetching JDBC Connection from DataSource 
[org.mybatis.spring.transaction.SpringManagedTransaction]-JDBC Connection [jdbc:mysql://rds.aliyuncs.com:3306/yyyy?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull, UserName=223323@222.222.xxx.xxx, MySQL Connector Java] will not be managed by Spring 
[Datenumber.pageSelect]-==>  Preparing: SELECT x.Id, DATE_FORMAT(x.`Date`, '%Y%m%d') `datestr`, x.befor_num, x.after_num, x.physician_id, y.department_id, y.clinic_id, y.true_name, y.avatar, y.title, y.telephone FROM datenumber x right join physician y on x.physician_id=y.id AND ( x.`Date` >= ? AND x.`Date` <= ? ) Where 1=1 AND y.clinic_id = ? ORDER BY x.Date ASC  
[Datenumber.pageSelect]-==> Parameters: 2017-3-28(String), 2017-4-4(String), 1(Long) 
[Datenumber.pageSelect]-<==      Total: 19 

输出的内容比较可怕,数据库连接字符,用户名密码都输出来了,一定要小心。

不过有一点不好的是SQL语句和参数是分开输出的,想复制到查询工具中调试的话还得自己填写参数,比较麻烦。

我的项目环境

Spring 4.0.2 + Spring MVC 4.0.2 + MyBatis 3.2.6

方法一:使用标准日志输出

此方法比较简单,只需要配置 MyBatis 的配置文件 Configuration 中有相关属性即可,不用再放一个 log4j.properties 文件。

?
1
2
3
4
5
6
7
8
<?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="logImpl" value="STDOUT_LOGGING"/>
  </settings>
</configuration>

关键语句:

?
1
<setting name="logImpl" value="STDOUT_LOGGING"/>

指定 MyBatis 应该使用哪个日志记录实现。如果此设置不存在,则会自动发现日志记录实现。

方法二:使用log4j日志输出

1、spring-mybatis.xml 文件不需要修改;

2、在mybatis.xml中,指定使用log4j为日志实现,这个我实际测试也不需要。

?
1
2
3
4
5
6
7
8
9
<?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="logImpl" value="LOG4J"/>
  </settings>
</configuration>
<!-- 实际测试这个文件有没有都可以 -->

这里的value值可以是SLF4J、Apache Commons Logging、Log4J2、Log4J、JDK logging(除Log4J2、Log4J外,其他未验证),并会按顺序查找

3、在web.xml中也需要配置

?
1
2
3
<listener>
   <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
 </listener>

或者用下面的(未测试)

?
1
2
3
<listener>
    <listener-class>org.apache.logging.log4j.web.Log4jServletContextListener</listener-class>
  </listener>

4、最后配置log4j.properties

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
### Log4j配置 ###
### 与Spring结合需要在web.xml中指定此文件位置,并添加监听器 ###
#定义log4j的输出级别和输出目的地(目的地可以自定义名称,和后面的对应)
#[ level ] , appenderName1 , appenderName2
log4j.rootLogger=DEBUG,console,file
 
#-----------------------------------#
#1 定义日志输出目的地为控制台
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
####可以灵活地指定日志输出格式,下面一行是指定具体的格式 ###
#%c: 输出日志信息所属的类目,通常就是所在类的全名
#%m: 输出代码中指定的消息,产生的日志具体信息 
#%n: 输出一个回车换行符,Windows平台为"/r/n",Unix平台为"/n"输出日志信息换行
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
 
#-----------------------------------#
#2 文件大小到达指定尺寸的时候产生一个新的文件 
log4j.appender.file = org.apache.log4j.RollingFileAppender
#日志文件输出目录
log4j.appender.file.File=log/tibet.log
#定义文件最大大小
log4j.appender.file.MaxFileSize=10mb
###输出日志信息###
#最低级别
log4j.appender.file.Threshold=ERROR
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
 
#-----------------------------------#
#3 druid
log4j.logger.druid.sql=INFO
log4j.logger.druid.sql.DataSource=info
log4j.logger.druid.sql.Connection=info
log4j.logger.druid.sql.Statement=info
log4j.logger.druid.sql.ResultSet=info
  
#4 mybatis 显示SQL语句部分
log4j.logger.org.mybatis=DEBUG
#log4j.logger.cn.tibet.cas.dao=DEBUG
#log4j.logger.org.mybatis.common.jdbc.SimpleDataSource=DEBUG
#log4j.logger.org.mybatis.common.jdbc.ScriptRunner=DEBUG
#log4j.logger.org.mybatis.sqlmap.engine.impl.SqlMapClientDelegate=DEBUG
#log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

两种方式比较

1、使用标准日志输出配置简单,使用log4j日志输出配置相对复杂;

2、log4j功能强大,控制粒度比较细;

当在配置文件中指定为“ STDOUT_LOGGING”时,实际使用的是哪一个日志实现?Apache Commons Logging 还是JDK logging ?

都不是,实际是 System.out.pringln.

2017-09-14更新

有小伙伴反馈按第二种方法配置后不输出SQL 语句,请注意 log4j.properties 文件中的:

?
1
log4j.appender.console.Threshold=DEBUG

是否与本例一致!

请注意细节,刚开始学习的朋友可以先完全使用本例提供的配置,得到正确的输出后再做个性定制。
另外,按照我上面的配置会输出大量 SQL 语句之外的信息,一位朋友尝试出只输出 SQL 语句、参数、结果的配置方法,

在此表示感谢并分享给大家:

MyBatis3用log4j在控制台输出SQL的方法示例

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://blog.csdn.net/testcs_dn/article/details/67640212