文檔頂層結構：

configuration 配置

properties 屬性

settings 設置

typeAliases 類型命名

typeHandlers 類型處理器

objectFactory 對象工廠

plugins 插件

environments 環境

environment 環境變量

transactionManager 事務管理器

dataSource 數據源

databaseIdProvider 數據庫廠商標識

transactionManager 事務管理器

mappers 映射器

註意：這些元素在mybatis的xml配置文件中，順序是不可以顛倒的，否則無法構建SqlSessionFactoryBuilder實例，

也就無法構建SqlSessionFactory工廠實例，更無法構建SqlSession操作數據庫命令SQL對象實例。

回顧一下mybatis的步驟：

1）核心配置文件配置

2）pojo模型創建

3）映射文件配置

4）獲取SqlSessionFactory

5）獲取SqlSession

6）CRUD操作

7）事務操作

8）關閉SqlSession

mybatis的基本操作在這裏：

mybatis初體驗（一）

這篇文章總結一下核心配置文件mybatis-config.xml的配置方法。

初體驗中的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>  
    <!-- 對事務的管理和連接池的配置 -->  
    <environments default="development">  
        <environment id="development">  
            <transactionManager type="JDBC" />  
            <dataSource type="POOLED">  
                <property name="driver" value="oracle.jdbc.driver.OracleDriver" />  
                <property name="url" value="jdbc:oracle:thin:@localhost:1521:orcl" />  
                <property name="username" value="ibatis" />  
                <property name="password" value="ibatis" />  
            </dataSource>  
        </environment>  
    </environments>  
      
    <!-- mapping 文件路徑配置 -->  
    <mappers>  
        <mapper resource="com/yu/res/UserMapper.xml" />  
    </mappers>  
</configuration>
 

Properties

由上面的配置可以看出，我們的數據庫信息是直接寫到了配置裏

而一般情況下，對於這種配置信息，一般我們都會把它放到properties資源文件中。

1.創建一個資源文件jdbc.properties：

jdbc.driverClassName=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@localhost:1521:orcl
jdbc.username=mybatis  
jdbc.password=mybatis

2.mybatis-config.xml中引入

<properties resource="jdbc.properties" />

當然也可以在<properties/>標簽中定義屬性：

<properties resource="jdbc.properties">
	<property name="jdbc.driverClassName" value="oracle.jdbc.driver.OracleDriver"/>
</properties>

3.使用properties文件裏的屬性

<dataSource type="POOLED">  
      <property name="driver" value="${jdbc.driverClassName}" />  
      <property name="url" value="${jdbc.url}" />  
      <property name="username" value="${jdbc.username}" />  
      <property name="password" value="${jdbc.password}" />   
</dataSource>

說下這些配置的加載順序：

.在 properties 元素體內指定的屬性首先被讀取。
.從類路徑下資源或 properties 元素的 url 屬性中加載的屬性第二被讀取,它會 覆蓋已經存在的完全一樣的屬性。
.作為方法參數傳遞的屬性最後被讀取, 它也會覆蓋任一已經存在的完全一樣的 屬性,這些屬性可能是從 properties 元素體內和資源/url 屬性中加載的。

引用自：http://mybatis.github.io/mybatis-3/zh/configuration.html

所以，屬性的優先級為：方法直接傳遞參數 > 通過resource、url引用的資源 > properties元素體內定義

Settings

setting設置，關系到mybatis的主要設置，關系到mybatis運行時的行為方式。

配置方式：

<settings>  
        <setting name="cacheEnabled" value="true" />  
        <setting name="lazyLoadingEnabled" value="true" />  
        <setting name="multipleResultSetsEnabled" value="true" />  
        <setting name="useColumnLabel" value="true" />  
        <setting name="useGeneratedKeys" value="false" />  
        <setting name="autoMappingBehavior" value="PARTIAL" />  
        <setting name="defaultExecutorType" value="SIMPLE" />  
        <setting name="defaultStatementTimeout" value="25" />  
        <setting name="safeRowBoundsEnabled" value="false" />  
        <setting name="mapUnderscoreToCamelCase" value="false" />  
        <setting name="localCacheScope" value="SESSION" />  
        <setting name="jdbcTypeForNull" value="OTHER" />  
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString" />  
    </settings>

配置項說明：（從 http://mybatis.github.io/mybatis-3/zh/configuration.html copy過來的 ）

typeAliases

類型別名。

給java類型取一個別名，方便在核心配置、映射配置中來使用這個java類型。

在 mybatis初體驗（一） 中的UserMapper.xml配置中，有這樣的配置信息：

<select id="findUserById" resultType="com.yu.model.User" parameterType="long">  
        select * from t_user where id = #{id}
</select>

可以看到resultType屬性的值為com.yu.model.User，表示這個查詢返回的類型為com.yu.model.User類型。

如果有很多種類型的話，每次都得把類型的全路徑寫上，感覺就很費事。

所以就可以用mybatis提供的typeAliases來進行別名配置。

在核心配置文件中加上配置：

<typeAliases>  
      <typeAlias type="com.yu.model.User" alias="User" />
      <typeAlias type="com.yu.model.Org" alias="Org"/>
</typeAliases>

然後修改UserMapper.xml的配置：

<select id="findUserById" resultType="User" parameterType="long">  
        select * from t_user where id = #{id}
</select>

這樣就簡便多了。

當然，這是對於我們自定義的類型，或者其他類型，用這種設置別名的方式。

其實mybatis給我們提供了很多內建的類型別名，使我們不用在typeAliases中指定，就可以直接使用，下面是mybatis中內建的別名：

typeHandlers

類型處理器。

用途：

1）獲取數據庫的值，以合適的方式轉變為對應的java類型

2）將java類型，以合適的方式轉化為數據庫的保存類型

mybatis中默認的類型處理器：

當然也可以自定義類型處理器，

比如有一個字段的值是一個逗號隔開的字符串，如果希望查詢結果映射到java類型時是一個數組，而保存到數據庫時又會是以逗號隔開的字符串。

這種情況需要自定義類型處理器來處理。

關於自定義類型處理器，會單獨做一個總結。

mappers

在 mybatis初體驗（一） 中的UserMapper.xml配置中，有這樣的配置信息：

 <!-- mapping 文件路徑配置 -->  
 <mappers>  
     <mapper resource="com/yu/res/UserMapper.xml" />  
 </mappers>

用於引用定義好的映射定義，告訴mybatis去哪裏找我們的sql定義配置。有以下幾種用法：

直接引用xml文件

<mappers>  
     <mapper resource="com/yu/res/UserMapper.xml" />  
</mappers>

通過絕對路徑引用，註意在絕對路徑前加上：“file:///”

<mappers>  
     <mapper url="file:///D:/workspace/mywork/MyBatis/src/com/yu/res/UserMapper.xml"/> 
</mappers>

引用mapper接口對象的方式：

<mappers>  
     <mapper resource="com.yu.mapper.UserMapper" />  
</mappers>

引用mapper接口包的方式：

<mappers>  
     <package name="com.yu.mapper"/>
</mappers>

這篇文章介紹了mybatis核心配置文件mybatis-config.xml的一些基本配置。

mybatis配置文件