深刻淺出MyBatis：MyBatis的全部配置

時間 2019-11-16

原文原文鏈接

上一篇介紹了JDBC的相關概念、MyBatis的特性與Hibernate的區別、MyBatis的基本組件與生命週期，基本可使用MyBatis了。php

文章索引：
java

這一篇詳細介紹MyBatis的配置，首先看下配置XML文件的層次結構，而後詳細介紹每一個配置項，說明每項的做用，值的取值與含義。mysql

下面列出MyBatis配置XML文件的層次結構，這些層次是不可以顛倒順序的。sql

<?xml version="1.0" encoding="UTF-8"?>  
<configuration>  
    <properties/>  
    <settings/>  
    <typeAliases/>  
    <typeHandles/>  
    <objectFactory/>  
    <plugins/>  
    <environments>  
        <environment>  
            <transanctionManager/> <!-- 配置事務管理器 -->  
            <dataSource/> <!-- 配置數據源 -->  
        </environment>  
    </environments>  
  
    <databaseIdProvider/> <!-- 數據庫廠商標識 -->  
    <mappers/> <!-- 映射器 -->  
</configuration>  
複製代碼

properties元素

將一些公用、常常變動的值單獨聲明，能在配置文件的上下文中使用它，MyBatis提供了3種配置方式：數據庫

property子元素
properties配置文件
程序參數傳遞

property子元素

<properties>
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mi-user"/>
        <property name="username" value="root"/>
        <property name="pwd" value="123456"/>
    </properties>
複製代碼

properties配置文件

建立一個配置文件 jdbc.propertiesapache

driver = com.mysql.jdbc.Driver
url = jdbc:mysql://localhost:3306/mi-user
username = root
password = 123456
複製代碼

設置properties配置文件緩存

<properties resource='jdbc.properties' />
複製代碼

程序參數傳遞

實際工做中，會遇到這種場景：系統由運維人員配置，生成數據庫的密碼對開發者是保密的，對用戶名和密碼進行了加密。能夠經過程序參數傳遞的方式，先解密，再設置property。bash

//讀入配置文件流
InputStream cfgStream = Resources.getResourceAsStream("mybatis-config.xml");
Reader cfgReader = new InputStreamReader(cfgStream);

//讀入屬性文件流
InputStream proStream = Resources.getResourceAsStream("jdbc.properties");
Reader proReader = new InputStreamReader(proStream);

Properties properties = new Properties();
properties.load(proReader);
//轉換爲明文
properties.setProperty("username",decode(properties.getProperty("username")));
properties.setProperty("pwd",decode(properties.getProperty("pwd")));

//建立sqlSessionFactory
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(cfgReader,properties);
複製代碼

若是3種配置同時出現，優先級爲第3種 > 第2種 > 第1種，推薦使用第2種，有特殊需求時使用第3種。微信

設置

設置會改變MyBatis運行時的行爲，設置項不少，只會介紹經常使用的配置，想了解所有配置能夠查看官方文檔。mybatis

cacheEnabled，全局地開啓或關閉配置文件中的全部映射器已經配置的任何緩存，默認爲true；
lazyLoadingEnabled，延遲加載的全局開關，當開啓時，全部關聯對象都會延遲加載，特定關聯關係中可經過設置fetchType屬性來覆蓋該項的開關狀態，默認爲false；
aggressiveLazyLoading，當開啓時，任何方法的調用都會加載該對象的全部屬性。不然，每一個屬性會按需加載，3.4.1版本以前默認爲true，3.4.1以後默認爲false；
autoMappingBehavior，指定MyBatis應如何自動映射列到字段或屬性，NONE 表示取消自動映射，PARTIAL 只會自動映射沒有定義嵌套結果集映射的結果集，FULL 會自動映射任意複雜的結果集，默認爲PARTIAL；
autoMappingUnknownColumnBehavior，指定發現自動映射目標未知列（或者未知屬性類型）的行爲，NONE: 不作任何反應，WARNING: 輸出提醒日誌，FAILING: 映射失敗，默認爲NONE；
defaultStatementTimeout，設置超時時間，它決定驅動等待數據庫響應的秒數；
mapUnderscoreToCamelCase，是否開啓自動駝峯命名規則（camel case）映射，即從經典數據庫列名 A_COLUMN 到經典 Java 屬性名 aColumn 的相似映射，默認爲false；
defaultEnumTypeHandler，指定 Enum 使用的默認 TypeHandler，默認爲org.apache.ibatis.type.EnumTypeHandler；
returnInstanceForEmptyRow，當返回行的全部列都是空時，MyBatis默認返回null。當開啓這個設置時，MyBatis會返回一個空實例，默認爲false；
localCacheScope，MyBatis 利用本地緩存機制（Local Cache）防止循環引用（circular references）和加速重複嵌套查詢。默認值爲 SESSION，這種狀況下會緩存一個會話中執行的全部查詢。若設置值爲 STATEMENT，本地會話僅用在語句執行上，對相同 SqlSession 的不一樣調用將不會共享數據，默認爲SESSION；
logImpl，指定日誌的具體實現，好比SLF4J|LOG4J|COMMONS_LOGGING等；

別名

在配置映射文件中，須要指定類的全限定名，爲了簡化，能夠聲明一個簡短的名稱去指代它，能夠在MyBatis上下文中使用。系統已經爲咱們定義了經常使用的類型，好比數值、字符串、日期、集合等。對於自定義的業務POJO，須要自定義別名。

<typeAliases>
     <typeAlias alias="role" type="com.learn.chapter2.po.Role"/>
</typeAliases>
複製代碼

也能夠經過註解方式進行，首先配置一個掃描的包，而後在類定義時添加註解@Alias("role")。

<typeAliases>
     <package name="com.learn.chapter2.po" />
</typeAliases>
複製代碼

@Alias("role")
public class Role{
}
複製代碼

類型處理器

MyBatis在預處理語句中設置一個參數時，或者從結果集中取出一個值時，都會用註冊了的typeHader進行處理。typeHander的做用就是將參數從javaType轉化爲jdbcType，或者從數據庫取出結果時把jdbcType轉化爲javaType。

系統內部已經定義了經常使用的類型處理器，有些狀況下，須要自定義。

MyBatis也提供了枚舉類型的類型處理器，有2個轉化枚舉類型的typeHandler，EnumTypeHandler和EnumOrdinalTypeHandler，其中EnumTypeHandler是使用枚舉字符串名稱做爲參數傳遞的，EnumOrdinalTypeHandler是使用整數下標做爲參數傳遞的。

但這2個枚舉類型應用不那麼普遍，更多的時候，須要自定義typeHandler進行處理。

自定義類型處理器，首先要定義類型處理類，實現TypeHandler泛型接口：

public class SexEnumTypeHandler implements TypeHandler<Sex> {

    @Override
    public void setParameter(PreparedStatement ps, int i, Sex sex, JdbcType jdbcType) throws SQLException {
        ps.setInt(i, sex.getId());
    }

    @Override
    public Sex getResult(ResultSet rs, String name) throws SQLException {
        return Sex.getSex(rs.getInt(name));
    }

    @Override
    public Sex getResult(ResultSet rs, int id) throws SQLException {
        return Sex.getSex(id);
    }

    @Override
    public Sex getResult(CallableStatement cs, int id) throws SQLException {
        return Sex.getSex(cs.getInt(id));
    }
}
複製代碼

而後註冊自定義的TypeHandler

<typeHandlers>
   <typeHandler handler="com.qqdong.study.SexEnumTypeHandler" javaType="sex"/>
</typeHandlers>
複製代碼

最後，在定義映射器時，指定typeHandler便可

<select id="getUser" parameterType="long" resultType="userMap">
</select>

<resultMap id="userMap" type="user">
    <result column="sex" property="sex" typeHandler="com.qqdong.study.SexEnumTypeHandler">
</resultMap>
複製代碼

ObjectFactory

當MyBatis在構建一個結果返回的時候，都會使用ObjectFactory去構建POJO，在MyBatis中能夠定製本身的對象工廠。通常不用配置，使用默認的DefaultObjectFactory便可。

插件plugin

插件比較複雜，後續單獨一篇文章介紹。

environments配置環境

配置環境能夠註冊多個數據源，每一個數據源包括基本配置和數據庫事務配置。

<environments default="development">
    <environment id="development">
    <!-- 採用jdbc事務管理 -->
        <transactionManager type="JDBC">
            <property name="autoCommit" value="false">
        </transactionManager>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
 </environments>
複製代碼