Mybatis 配置解析

核心配置檔案

mybatis-config.xml

MyBatis 的配置檔案包含了會深深影響 MyBatis 行為的設定和屬性資訊。 配置文件的頂層結構如下：

configuration（配置）

• properties（屬性）
• settings（設定）
• typeAliases（類型別名）
• typeHandlers（型別處理器）
• objectFactory（物件工廠）
• plugins（外掛）
• environments（環境配置）
  • environment（環境變數）
    • transactionManager（事務管理器）
    • dataSource（資料來源）
• databaseIdProvider（資料庫廠商標識）
• mappers（對映器）

properties（屬性）：

我們可以通過properties屬性來引用配置檔案

先寫一個配置檔案：
db.properties

url = jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&useSSL=false&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&autoReconnect=true&failOverReadOnly=false
name = root
password = 1234
 

在核心配置檔案中引用寫好的配置檔案 並使用裡面的元素：

    <!-- 引入一個外部配置檔案-->
    <properties resource="db.properties"/>

    <environments default="development">

        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED"> 
                <
 
property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="${url}"/>  <!-- 拿取外部配置檔案的url屬性-->
                <property name="username" value="${name}"/> <!-- 拿取外部配置檔案的name屬性-->
                <property name="password" value="${password}"/><!-- 拿取外部配置檔案的password屬性-->
            </dataSource>
        </environment>

    </environments>

這些屬性可以在外部進行配置，並可以進行動態替換。你既可以在典型的 Java 屬性檔案中配置這些屬性，也可以在 properties 元素的子元素中設定。例如：

<properties resource="db.properties">
  <property name="username" value="dev_user"/>
  <property name="password" value="F2Fa3!33TYyg"/>
</properties>

settings（設定）

這是 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="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（類型別名）

類型別名可為 Java 型別設定一個縮寫名字。 它僅用於 XML 配置，意在降低冗餘的全限定類名書寫

    <typeAliases>
        <!-- 我們給實體類取一個別名 User-->
        <typeAlias alias="User" type="com.xiaofu.pojo.User"/>
    </typeAliases>

這樣就可以在 mapper中直接用她了就不用在寫全部路徑了

也可以指定一個包名：

    <typeAliases>
        <!-- 給一個包取別名 下面的類將被我們掃描-->
        <package name="com.xiaofu.pojo"/>
    </typeAliases>

在沒有註解的情況下 預設 以首字母小寫的形式 起的別名

現在pojo下有一個User類

在實體類較少的時候可以使用第一種形式取別名 如果實體類別較多建立使用第二種。

區別：第一種可以自定義別名 第二種則不行

如果非要讓第二種自定義別名可以 在類上使用註解 如：

@Alias("author")
public class Author {
    ...
}

environments（環境配置）：

    <environments default="development"> <!--default預設選擇的資料庫環境 對應下面的id-->
        <environment id="development"> <!--id 區分環境的標識 -->
            <transactionManager type="JDBC"/><!--transactionManager type 事物管理器（有jdbc和managed） -->
            <dataSource type="POOLED"><!-- dataSource資料來源  type 選擇池子 （POOLED池子 UNPOOLED沒有池子 JNDI正常連線）-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>  <!--資料庫驅動配置-->
                <!--資料庫連線url配置 之前jdbc的& 符號這裡是不能直接使用的 需要 &amp; 進行轉義-->
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&amp;useSSL=false&amp;characterEncoding=utf-8&amp;serverTimezone=Asia/Shanghai&amp;autoReconnect=true&amp;failOverReadOnly=false"/>
                <property name="username" value="root"/>  <!--資料庫使用者名稱-->
                <property name="password" value="1234"/>  <!--資料庫密碼-->
            </dataSource>
        </environment>

        <environment id="test">
            <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>

對映器（mappers）：

註冊繫結我們的mapper.xml檔案

第一種：直接找mapper.xml檔案來註冊（推薦使用）

<!-- 每一個 mapper.xml 都需要在mybatis核心配置檔案中註冊   -->
    <mappers>
        <mapper resource="com/xiaofu/dao/UserMapper.xml"/>
    </mappers>

第二種：通過類註冊

<!-- 每一個 mapper.xml 都需要在mybatis核心配置檔案中註冊   -->
    <mappers>
        <mapper class="com.xiaofu.dao.UserMapper"/>
    </mappers>

通過類註冊需要注意兩個問題：

• 介面和他的Mapper配置檔案必須同名！
• 介面和他的Mapper配置檔案必須在同一個包下！

第三種：通過包註冊（包下的mapper都會被註冊）

    <mappers>
        <!--這個包下的mapper都會被註冊-->
        <package name="com.xiaofu.dao"/>
    </mappers>

通過包註冊需要注意兩個問題：

• 介面和他的Mapper配置檔案必須同名！
• 介面和他的Mapper配置檔案必須在同一個包下！