學習mybatis-3 step by step 篇四

日誌

Mybatis內置的日誌工廠提供日誌功能，具體的日誌實現有如下幾種工具：

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

具體選擇哪一個日誌實現工具由MyBatis的內置日誌工廠肯定。它會使用最早找到的（按上文列舉的順序查找）。 若是一個都未找到，日誌功能就會被禁用。

很多應用服務器的classpath中已經包含Commons Logging，如Tomcat和WebShpere， 因此MyBatis會把它做爲具體的日誌實現。記住這點很是重要。這將意味着，在諸如 WebSphere的環境中——WebSphere提供了Commons Logging的私有實現，你的Log4J配置將被忽略。 這種作法難免讓人悲催，MyBatis怎麼能忽略你的配置呢？事實上，因Commons Logging已經存 在了，按照優先級順序，Log4J天然就被忽略了！不過，若是你的應用部署在一個包含Commons Logging的環境， 而你又想用其餘的日誌框架，你能夠經過在MyBatis的配置文件mybatis-config.xml裏面添加一項setting（配置）來選擇一個不一樣的日誌實現。

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

一個Maven項目配置的例子：

步驟1： 添加 Log4J 的 jar 包

        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
            <optional>true</optional>
        </dependency>

步驟2：配置Log4J

建立一個名稱爲log4j.properties的文件， 文件的具體內容以下：

# Global logging configuration
log4j.rootLogger=INFO, stdout
# MyBatis logging configuration...
log4j.logger.com.xxxxxx.mapper=TRACE
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

 

添加以上配置後，Log4J就會把 com.xxxxxx.mapper的詳細執行日誌記錄下來，對於應用中的其它類則僅僅記錄INFO級別級以上信息。

也能夠將日誌從整個mapper接口級別調整到到語句級別，從而實現更細粒度的控制。以下配置只記錄 selectBlog 語句的日誌：

 

log4j.logger.org.mybatis.example.BlogMapper.selectBlog=TRACE

與此相對，能夠對一組mapper接口記錄日誌，只要對mapper接口所在的包開啓日誌功能便可：

 

log4j.logger.org.mybatis.example=TRACE

某些查詢可能會返回大量的數據，只想記錄其執行的SQL語句該怎麼辦？爲此，Mybatis中SQL語 句的日誌級別被設爲DEBUG（JDK Logging中爲FINE），結果日誌的級別爲TRACE（JDK Logging中爲FINER)。因此，只要將日誌級別調整爲DEBUG便可達到目的：

log4j.logger.org.mybatis.example=DEBUG

要記錄日誌的是相似下面的mapper文件而不是mapper接口又該怎麼呢？

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.mybatis.example.BlogMapper">
  <select id="selectBlog" resultType="Blog">
    select * from Blog where id = #{id}
  </select>
</mapper>

對這個文件記錄日誌，只要對命名空間增長日誌記錄功能便可：

log4j.logger.org.mybatis.example.BlogMapper=TRACE

進一步，要記錄具體語句的日誌能夠這樣作：

log4j.logger.org.mybatis.example.BlogMapper.selectBlog=TRACE