一、MyBatis 配置檔案的結構如下。

<?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><!-- 配置 -->
<properties /><!-- 屬性 -->
<settings /><!-- 設定 -->
<typeAliases /><!-- 型別命名 -->
<typeHandlers /><!-- 型別處理器 -->
<objectFactory /><!-- 物件工廠 -->
<plugins /><!-- 外掛 -->
<environments><!-- 配置環境 -->
<environment><!-- 環境變數 -->
<transactionManager /><!-- 事務管理器 -->
<dataSource /><!-- 資料來源 -->
</environment>
</environments>
<databaseIdProvider /><!-- 資料庫廠商標識 -->
<mappers /><!-- 對映器 -->
</configuration>
 

mybatis-config.xml 檔案中的元素節點是有一定順序的，節點位置必須按以上位置排序，否則會編譯錯誤。

下面介紹 XML 配置檔案中的重要元素（標籤）。

configuration 元素是整個 XML 配置檔案的根節點，其角色就相當於是 MyBatis 的總管，MyBatis 所有的配置資訊都會存放在它裡面。

二、properties標籤

properties 標籤可以通過 resource 屬性指定外部 properties 檔案（database.properties），也可以通過 properties 子元素配置。

2.1 指定檔案

使用 properties 指定外部檔案，程式碼如下。

• <properties resource="mybatisDemo/resources/database.properties"/>

database.properties 用於描述資料庫連線的相關配置，例如資料庫驅動、連線資料庫的 url、資料庫使用者名稱、資料庫密碼等。

2.2 properties子元素配置

通過 properties 子元素 property 配置 username 和 password 變數，然後在 environments 節點中引用這些變數，程式碼如下。

• <properties>
• <property name="username"
  value="root"/>
• <property name="password" value="root"/>
• </properties>

在environments 節點中引用 username 和 password 變數。

• <environments default="development">
• <environment id="development">
• <transactionManager type="JDBC"/>
• <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>

也可以不使用 properties 標籤，直接將屬性值寫在 value 中。

三、settings標籤

settings 標籤用於配置 MyBatis 的執行時行為，它能深刻的影響 MyBatis 的底層執行，一般不需要大量配置，大部分情況下使用其預設值即可。

settings 的配置項很多，但是真正用到的不會太多，我們把常用的配置項研究清楚就可以了。settings 配置項說明如下表所示（表中紅色字型的配置項為常用配置項）。

下面給出一個全量的配置樣例，如下所示。

<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="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="defaultFetchSize" value="100"/>
<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>

四、typeAliases標籤

為了不在任何地方都指定類的全限定名，我們可以使用typeAliases 標籤定義一個別名。

例如，在 net.bianchengbang.po 包中有一個 Student 類，則該類的全限定名稱為 net.bianchengbang.po.Student。使用typeAliases 標籤定義別名，這樣就不用每次都書寫類的全限定名稱了，程式碼如下。

• <typeAliases>
• <typeAlias alias = "Student" type = "net.bianchengbang.po.Student"/>
• </typeAliases>

如果需要對同一個包下的多個類定義別名，則可以定義為：

• <typeAliases>
• <package name="net.biancheng.po"/>
• </typeAliases>

這樣 MyBatis 將掃描 net.biancheng.po 包裡面的類，將其第一個字母變為小寫作為其別名，例如 Student 別名為 student，User 別名為 user。

五、typeHandlers標籤

typeHandlers 主要將獲取的值合理地轉化為 Java 型別。在 typeHandler 中，分為 jdbcType 和 javaType，其中 jdbcType 用於定義資料庫型別，而 javaType 用於定義 Java 型別，typeHandler 的作用就是承擔 jdbcType 和 javaType 之間的相互轉換。

MyBatis 支援自定義處理型別，在自定義處理型別時，需要實現 org.apache.ibatis.type.TypeHandler 介面或繼承 org.apache.ibatis.type.BaseTypeHandle 類。詳細可參考官網：http://www.mybatis.org/mybatis-3/zh/configuration.html#typeHandlers

六、environments標籤

在 environments 標籤中，可以配置 MyBatis 的多套執行環境，將 SQL 對映到多個不同的資料庫上。

environment 是 environments 的子標籤，用來配置 MyBatis 的一套執行環境，需指定執行環境 ID、事務管理、資料來源配置等相關資訊。

我們可以通過配置多個 environment 標籤來連線多個數據庫，需要注意的是必須指定其中一個為預設執行環境（通過default指定）。

environment 標籤提供了兩個子標籤，即transactionManager 和 dataSource。

七、transactionManager標籤

MyBatis 支援兩個事務管理器，即 JDBC 和 MANAGED。

如果使用 JDBC 型別的事務管理器，則應用程式伺服器負責事務管理操作，例如提交、回滾等。如果使用 MANAGED 型別的事務管理器，則應用程式伺服器負責管理連線生命週期。

八、dataSource標籤

用於配置資料庫的連線屬性，例如要連線的資料庫的驅動程式名稱、URL、使用者名稱和密碼等。

dataSource 中的 type 屬性用於指定資料來源型別，有以下 3 種類型。

1）UNPOOLED

UNPOOLED 沒有資料庫連線池，效率低下。MyBatis 需要開啟和關閉每個資料庫操作的連線，它有點慢，通常應用於簡單的應用程式。

2）POOLED

對於 POOLED 資料來源型別，MyBatis 將維護一個數據庫連線池。並且對於每個資料庫的操作，MyBatis 都會使用連線池中的連線，並在操作完成後將它們返回到池中。減少了建立新連線所需的初始連線和身份驗證時間。

3）JNDI

對於 JNDI 的資料來源型別，MyBatis 將從 JNDI 資料來源中獲取連線。

dataSource 標籤示例程式碼如下：

<dataSource type="POOLED">
<!-- MySQL資料庫驅動 -->
<property name="driver" value="com.mysql.jdbc.Driver" />
<!-- 連線資料庫的URL -->
<property name="url"
value="jdbc:mysql://localhost:3306/test?characterEncoding=utf8" />
<property name="username" value="root" />
<property name="password" value="root" />
</dataSource>

九、mappers標籤

mappers 標籤用於指定 MyBatis SQL 對映檔案的路徑。

mapper 是 mappers 的子標籤，mapper 中的 resource 屬性用於指定 SQL 對映檔案的路徑（類資源路徑）

例如，SQL 對映檔案的名稱是 Student.xml，它位於名為 net.biancheng.mapper 的包中，那麼您可以這樣配置：

• <mappers>
• <mapper resource="net/biancheng/mapper/Student.xml"/>
• </mappers>