SqlMapConfig.xml全局配置文件解析（mybatis）

原文  http://www.cnblogs.com/selene/p/4607004.html

一：SqlMapConfig.xml配置文件的內容和配置順序如下

1. properties(屬性)
2. settings(全局配置參數)
3. typeAiases(類型別名)
4. typeHandlers(類型處理器)
5. objectFactory(對象工廠)
6. plugins(插件)
7. environments(環境集合屬性對象)mappers(映射器)
   1. environment(環境子屬性對象)
   2. transactionManager(事物管理)
   3. datesource(數據源
8. mappers(映射器)

二：properties屬性

作用：將數據連接單獨配置在db.properties中，只需要在SqlMapConfig.xml中載入db.properties的屬性值，在SqlMapConfig.xml中就不需要對資料庫連接參數進行硬編碼。資料庫連接參數只配置在db.properties中，方便對參數進行統一管理，其它xml可以引用該db.properties。

db.properties的內容：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

在SqlMapConfig.xml中載入db.properties

 <!-- 載入資料庫文件db.properties -->
<properties resource="db.properties">
	<!-- properties中還可以配置一些屬性名和屬性值,此處的優先載入 -->
	<!-- <property name="driver" value=""/> -->
</properties>
<!-- 和spring整合後 environments配置將廢除-->
<environments default="development">
	<environment id="development">
	<!-- 使用jdbc事務管理,事務控制由mybatis管理-->
		<transactionManager type="JDBC" />
	<!-- 資料庫連接池,由mybatis管理-->
		<dataSource type="POOLED">
			<property name="driver" value="${jdbc.driver}" />
			<property name="url" value="${jdbc.url}" />
			<property name="username" value="${jdbc.username}" />
			<property name="password" value="${jdbc.password}" />
		</dataSource>
	</environment>
</environments>

properties特性：

註意：

• 在properties元素體內定義的屬性優先讀取。
• 然後讀取properties元素中resource或url載入的屬性，它會覆蓋已讀取的同名屬性。
• 最後讀取parameterType傳遞的屬性，它會覆蓋已讀取的同名屬性

建議：

不要在properties元素體內添加任何屬性值，只將屬性值定義在properties文件中。

在properties文件中定義屬性名要有一定的特殊性，如xxxx.xxxx(jdbc.driver)

三:settings全局參數配置

mybatis框架運行時可以調整一些運行參數。比如，開啟二級緩存，開啟延遲載入等等。全局參數會影響mybatis的運行行為。

mybatis-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="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>

四:typeAiases(別名)--重點掌握

在 mapper.xml 中，定義很多的 statement ， statement 需要 parameterType 指定輸入參數的類型、需要 resultType 指定輸出結果的映射類型。

如果在指定類型時輸入類型全路徑，不方便進行開發，可以針對 parameterType 或 resultType指定的類型定義一些別名，在 mapper.xml 中通過別名定義，方便開發。

4.1.mybatis預設支持的別名

4.2.自定義別名

4.2.1:單個別名定義(在SqlMapConfig.xml)

<!-- 別名定義：針對單個別名定義 type:類型的路徑; alias:別名 -->
    <typeAliases><typeAlias type="com.mybatis.entity.User" alias="user"/></typeAliases>

UserMapper.xml引用別名:

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

4.2.2:批量定義別名(常用)

<!-- 批量別名的定義:
        package:指定包名，mybatis會自動掃描包中的pojo類，自動定義別名，別名就是類名(首字母大寫或小寫都可以)
 -->
     <typeAliases>
         <package name="com.mybatis.entity"/>
         <package name="其它包"/>
    </typeAliases>

五：typeHandlers(類型處理器)

mybatis 中通過 typeHandlers 完成 jdbc 類型和 java 類型的轉換。

通常情況下， mybatis 提供的類型處理器滿足日常需要，不需要自定義 .

mybatis 支持類型處理器：

六：mappers(映射配置)

6.1:通過resource載入單個映射文件

<!-- 載入映射文件 -->
    <mappers>
    <!--通過resource方法一次載入一個映射文件  -->
        <mapper resource="sqlmap/User.xml"/>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>

6.2:通過mapper介面載入單個映射文件

<!-- 通過mapper介面載入單個映射配置文件
            遵循一定的規範：需要將mapper介面類名和mapper.xml映射文件名稱保持一致，且在一個目錄中；
            上邊規範的前提是：使用的是mapper代理方法;
      -->
         <mapper class="com.mybatis.mapper.UserMapper"/>

按照上邊的規範，將 mapper.java 和 mapper.xml 放在一個目錄 ，且同名。

6.3:批量載入mapper(推薦使用)

<!-- 批量載入映射配置文件,mybatis自動掃描包下麵的mapper介面進行載入
        遵循一定的規範：需要將mapper介面類名和mapper.xml映射文件名稱保持一致，且在一個目錄中；
            上邊規範的前提是：使用的是mapper代理方法;
      -->
    <package name="com.mybatis.mapper"/>