MyBatis配置解析_ZenDei技術網路在線

核心配置文件 mybatis-config.xml 系統核心配置文件 MyBatis 的配置文件包含了會深深影響 MyBatis 行為的設置和屬性信息。能配置的內容如下： configuration（配置） properties（屬性） settings（設置） typeAliases（類型別名） ...

核心配置文件

mybatis-config.xml 系統核心配置文件
MyBatis 的配置文件包含了會深深影響 MyBatis 行為的設置和屬性信息。
能配置的內容如下：

configuration（配置）
    properties（屬性）
    settings（設置）
    typeAliases（類型別名）
    typeHandlers（類型處理器）
    objectFactory（對象工廠）
    plugins（插件）
    environments（環境配置）
        environment（環境變數）
            transactionManager（事務管理器）
            dataSource（數據源）
    databaseIdProvider（資料庫廠商標識）
    mappers（映射器）
    <!-- 註意元素節點的順序！順序不對會報錯 -->

environments元素

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC">
                <property name="..." value="..."/>
            </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>

配置MyBatis的多套運行環境，將SQL映射到多個不同的資料庫上，必須指定其中一個為預設運行環境（通過default指定）
子元素節點：environment
- 具體的一套環境，通過設置id進行區別，id保證唯一！
- 子元素節點：transactionManager - [ 事務管理器 ]

<!-- 語法 -->
<transactionManager type="[ JDBC | MANAGED ]"/>

- - 詳情：https://mybatis.org/mybatis-3/zh/configuration.html#environments
  - 這兩種事務管理器類型都不需要設置任何屬性。
- 子元素節點：數據源（dataSource）
  - dataSource 元素使用標準的 JDBC 數據源介面來配置 JDBC 連接對象的資源。
  - 數據源是必須配置的。
  - 有三種內建的數據源類型

type="[UNPOOLED|POOLED|JNDI]"）

- - unpooled：這個數據源的實現只是每次被請求時打開和關閉連接。
  - pooled：這種數據源的實現利用“池”的概念將 JDBC 連接對象組織起來 , 這是一種使得併發 Web 應用快速響應請求的流行處理方式。
  - jndi：這個數據源的實現是為了能在如 Spring 或應用伺服器這類容器中使用，容器可以集中或在外部配置數據源，然後放置一個 JNDI 上下文的引用。
  - 數據源也有很多第三方的實現，比如dbcp，c3p0，druid等等....

mappers元素

mappers

映射器 : 定義映射SQL語句文件
既然 MyBatis 的行為其他元素已經配置完了，我們現在就要定義 SQL 映射語句了。但是首先我們需要告訴 MyBatis 到哪裡去找到這些語句。 Java 在自動查找這方面沒有提供一個很好的方法，所以最佳的方式是告訴 MyBatis 到哪裡去找映射文件。你可以使用相對於類路徑的資源引用，或完全限定資源定位符（包括 file:/// 的 URL），或類名和包名等。映射器是MyBatis中最核心的組件之一，在MyBatis 3之前，只支持xml映射器，即：所有的SQL語句都必須在xml文件中配置。而從MyBatis 3開始，還支持介面映射器，這種映射器方式允許以Java代碼的方式註解定義SQL 語句，非常簡潔。

引入資源方式

<!-- 使用相對於類路徑的資源引用 -->
<mappers>
    <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

<!-- 使用完全限定資源定位符（URL） -->
<mappers>
    <mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

<!--
使用映射器介面實現類的完全限定類名
需要配置文件名稱和介面名稱一致，並且位於同一目錄下
-->
<mappers>
    <mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

<!--
將包內的映射器介面實現全部註冊為映射器
但是需要配置文件名稱和介面名稱一致，並且位於同一目錄下
-->
<mappers>
　　<package name="org.mybatis.builder"/>
</mappers>

Mapper文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.hang.dao.UserMapper">
    
</mapper>

namespace中文意思：命名空間，作用如下：

namespace和子元素的id聯合保證唯一 , 區別不同的mapper
綁定DAO介面
- namespace的命名必須跟某個介面同名
- 介面中的方法與映射文件中sql語句id應該一一對應
namespace命名規則 : 包名+類名

MyBatis 的真正強大在於它的映射語句，這是它的魔力所在。由於它的異常強大，映射器的 XML 文件就顯得相對簡單。如果拿它跟具有相同功能的 JDBC 代碼進行對比，你會立即發現省掉了將近 95% 的代碼。MyBatis 為聚焦於 SQL 而構建，以儘可能地為你減少麻煩。

Properties優化

資料庫這些屬性都是可外部配置且可動態替換的，既可以在典型的 Java 屬性文件中配置，亦可通過 properties 元素的子元素來傳遞。詳情：https://mybatis.org/mybatis-3/zh/configuration.html#properties

我們來優化我們的配置文件

第一步 ; 在資源目錄下新建一個db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode=true&characterEncoding=utf8&useSSL=false
username=root
password=123456

第二步 : 將文件導入properties 配置文件

<configuration>
    <!--導入properties文件-->
    <properties resource="db.properties"/>
    <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>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

typeAliases優化

類型別名是為 Java 類型設置一個短的名字。它只和 XML 配置有關，存在的意義僅在於用來減少類完全限定名的冗餘。

<!--配置別名,註意順序-->
<typeAliases>
    <typeAlias type="com.hang.pojo.User" alias="User"/>
</typeAliases>

當這樣配置時， User 可以用在任何使用 com.hang.pojo.User 的地方。

也可以指定一個包名，MyBatis 會在包名下麵搜索需要的 Java Bean，比如:

<typeAliases>
    <package name="com.hang.pojo"/>
</typeAliases>

每一個在包 com.hang.pojo 中的 Java Bean，在沒有註解的情況下，會使用 Bean 的首字母小寫的非限定類名來作為它的別名。

若有註解，則別名為其註解值。見下麵的例子：

@Alias("user")
public class User {
    ...
}

其他配置瀏覽

1、設置

設置（settings）相關 => 查看幫助文檔：https://mybatis.org/mybatis-3/zh/configuration.html#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>

2、類型處理器

官方文檔：https://mybatis.org/mybatis-3/zh/configuration.html#typeHandlers

無論是 MyBatis 在預處理語句（PreparedStatement）中設置一個參數時，還是從結果集中取出一個值時，都會用類型處理器將獲取的值以合適的方式轉換成 Java 類型。
你可以重寫類型處理器或創建你自己的類型處理器來處理不支持的或非標準的類型。【瞭解即可】

.3、對象工廠

官方文檔：https://mybatis.org/mybatis-3/zh/configuration.html#objectFactory

MyBatis 每次創建結果對象的新實例時，它都會使用一個對象工廠（ObjectFactory）實例來完成。
預設的對象工廠需要做的僅僅是實例化目標類，要麼通過預設構造方法，要麼在參數映射存在的時候通過有參構造方法來實例化。
如果想覆蓋對象工廠的預設行為，則可以通過創建自己的對象工廠來實現。【瞭解即可】

生命周期和作用域

作用域（Scope）和生命周期

理解我們目前已經討論過的不同作用域和生命周期類是至關重要的，因為錯誤的使用會導致非常嚴重的併發問題。

我們可以先畫一個流程圖，分析一下Mybatis的執行過程！

作用域理解

SqlSessionFactoryBuilder 的作用在於創建 SqlSessionFactory，創建成功後， SqlSessionFactoryBuilder 就失去了作用，所以它只能存在於創建 SqlSessionFactory 的方法中，而不要讓其長期存在。因此 SqlSessionFactoryBuilder 實例的最佳作用域是方法作用域（也就是局部方法變數）。
SqlSessionFactory 可以被認為是一個資料庫連接池，它的作用是創建 SqlSession 介面對象。因為 MyBatis 的本質就是 Java 對資料庫的操作，所以 SqlSessionFactory 的生命周期存在於整個 MyBatis 的應用之中，所以一旦創建了 SqlSessionFactory，就要長期保存它，直至不再使用 MyBatis 應用，所以可以認為 SqlSessionFactory 的生命周期就等同於 MyBatis 的應用周期。
由於 SqlSessionFactory 是一個對資料庫的連接池，所以它占據著資料庫的連接資源。如果創建多個 SqlSessionFactory，那麼就存在多個資料庫連接池，這樣不利於對資料庫資源的控制，也會導致資料庫連接資源被消耗光，出現系統宕機等情況，所以儘量避免發生這樣的情況。
因此在一般的應用中我們往往希望 SqlSessionFactory 作為一個單例，讓它在應用中被共用。所以說 SqlSessionFactory 的最佳作用域是應用作用域。
如果說 SqlSessionFactory 相當於資料庫連接池，那麼 SqlSession 就相當於一個資料庫連接（Connection 對象），你可以在一個事務裡面執行多條 SQL，然後通過它的 commit、rollback 等方法，提交或者回滾事務。所以它應該存活在一個業務請求中，處理完整個請求後，應該關閉這條連接，讓它歸還給 SqlSessionFactory，否則資料庫資源就很快被耗費精光，系統就會癱瘓，所以用 try...catch...finally... 語句來保證其正確關閉。
所以 SqlSession 的最佳的作用域是請求或方法作用域。

本文來自博客園，作者：腹白，轉載請註明原文鏈接：https://www.cnblogs.com/wyh518/