Mybatis 入門實戰(1)--簡介

1、Mybatis 是什么

MyBatis 是一款優秀的持久層框架，它支持自定義 SQL、存盤程序以及高級映射，MyBatis 免除了幾乎所有的 JDBC 代碼以及設定引數和獲取結果集的作業，MyBatis 可以通過簡單的 XML 或注解來配置和映射原始型別、介面和 Java POJO（Plain Old Java Objects，普通老式 Java 物件）為資料庫中的記錄，

2、Mybatis 配置

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

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

2.1、屬性（properties）

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

<properties resource="org/mybatis/example/config.properties">
  <property name="username" value="root"/>
  <property name="password" value="123456"/>
</properties>

設定好的屬性可以在整個組態檔中用來替換需要動態配置的屬性值，

如果一個屬性在不只一個地方進行了配置，那么，MyBatis 將按照下面的順序來加載：

• 首先讀取在 properties 元素體內指定的屬性，
• 然后根據 properties 元素中的 resource 屬性讀取類路徑下屬性檔案，或根據 url 屬性指定的路徑讀取屬性檔案，并覆寫之前讀取過的同名屬性，
• 最后讀取作為方法引數傳遞的屬性，并覆寫之前讀取過的同名屬性，

2.2、設定（settings）

這是 MyBatis 中極為重要的調整設定，它們會改變 MyBatis 的運行時行為， 下表描述了設定中各項設定的含義、默認值等，

2.3、型別別名（typeAliases）

型別別名可為 Java 型別設定一個縮寫名字， 它僅用于 XML 配置，意在降低冗余的全限定類名書寫，例如：

<typeAliases>
  <typeAlias alias="Author" type="domain.blog.Author"/>
  <typeAlias alias="Blog" type="domain.blog.Blog"/>
</typeAliases>

2.4、型別處理器（typeHandlers）

MyBatis 在設定預處理陳述句（PreparedStatement）中的引數或從結果集中取出一個值時， 都會用型別處理器將獲取到的值以合適的方式轉換成 Java 型別，Mybatis 內置了默認的型別處理器，如果不滿足需求，還可以自定義型別處理器；具體做法為：實作 org.apache.ibatis.type.TypeHandler 介面， 或繼承一個很便利的類 org.apache.ibatis.type.BaseTypeHandler， 并且可以（可選地）將它映射到一個 JDBC 型別，

2.5、物件工廠（objectFactory）

每次 MyBatis 創建結果物件的新實體時，它都會使用一個物件工廠（ObjectFactory）實體來完成實體化作業， 默認的物件工廠需要做的僅僅是實體化目標類，要么通過默認無參構造方法，要么通過存在的引數映射來呼叫帶有引數的構造方法， 如果想覆寫物件工廠的默認行為，可以通過創建自己的物件工廠來實作；具體做法為：繼承 org.apache.ibatis.reflection.factory.DefaultObjectFactory 類并覆寫相應的方法，

2.6、插件（plugins）

MyBatis 允許你在映射陳述句執行程序中的某一點進行攔截呼叫，默認情況下，MyBatis 允許使用插件來攔截的方法呼叫包括：

• Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
• ParameterHandler (getParameterObject, setParameters)
• ResultSetHandler (handleResultSets, handleOutputParameters)
• StatementHandler (prepare, parameterize, batch, update, query)

通過 MyBatis 提供的強大機制，使用插件是非常簡單的，只需實作 Interceptor 介面，并指定想要攔截的方法簽名即可，

2.7、環境配置（environments）

MyBatis 可以配置成適應多種環境，這種機制有助于將 SQL 映射應用于多種資料庫之中， 現實情況下有多種理由需要這么做，例如，開發、測驗和生產環境需要有不同的配置；或者想在具有相同 Schema 的多個生產資料庫中使用相同的 SQL 映射，還有許多類似的使用場景，

不過要記住：盡管可以配置多個環境，但每個 SqlSessionFactory 實體只能選擇一種環境，

所以，如果你想連接兩個資料庫，就需要創建兩個 SqlSessionFactory 實體，每個資料庫對應一個，

2.7.1、事務管理器（transactionManager）

在 MyBatis 中有兩種型別的事務管理器（也就是 type="[JDBC|MANAGED]"）：

• JDBC – 這個配置直接使用了 JDBC 的提交和回滾功能，它依賴從資料源獲得的連接來管理事務作用域，
• MANAGED – 這個配置幾乎沒做什么，它從不提交或回滾一個連接，而是讓容器來管理事務的整個生命周期（比如 JEE 應用服務器的背景關系），

注：如果你正在使用 Spring + MyBatis，則沒有必要配置事務管理器，因為 Spring 模塊會使用自帶的管理器來覆寫前面的配置，

2.7.2、資料源（dataSource）

dataSource 元素使用標準的 JDBC 資料源介面來配置 JDBC 連接物件的資源，

有三種內建的資料源型別（也就是 type="[UNPOOLED|POOLED|JNDI]"）：

UNPOOLED– 這個資料源的實作會每次請求時打開和關閉連接，雖然有點慢，但對那些資料庫連接可用性要求不高的簡單應用程式來說，是一個很好的選擇， 性能表現則依賴于使用的資料庫，對某些資料庫來說，使用連接池并不重要，這個配置就很適合這種情形，

POOLED– 這種資料源的實作利用“池”的概念將 JDBC 連接物件組織起來，避免了創建新的連接實體時所必需的初始化和認證時間， 這種處理方式很流行，能使并發 Web 應用快速回應請求，

JNDI – 這個資料源實作是為了能在如 EJB 或應用服務器這類容器中使用，容器可以集中或在外部配置資料源，然后放置一個 JNDI 背景關系的資料源參考，

2.8、資料庫廠商標識（databaseIdProvider）

MyBatis 可以根據不同的資料庫廠商執行不同的陳述句，這種多廠商的支持是基于映射陳述句中的 databaseId 屬性， MyBatis 會加載帶有匹配當前資料庫 databaseId 屬性和所有不帶 databaseId 屬性的陳述句， 如果同時找到帶有 databaseId 和不帶 databaseId 的相同陳述句，則后者會被舍棄，databaseIdProvider 對應的 DB_VENDOR 實作會將 databaseId 設定為 DatabaseMetaData#getDatabaseProductName() 回傳的字串， 由于通常情況下這些字串都非常長，而且相同產品的不同版本會回傳不同的值，你可能想通過設定屬性別名來使其變短：

<databaseIdProvider type="DB_VENDOR">
  <property name="SQL Server" value="sqlserver"/>
  <property name="DB2" value="db2"/>
  <property name="Oracle" value="oracle" />
</databaseIdProvider>

2.9、映射器（mappers）

我們需要告訴 MyBatis 到哪里去找SQL 映射陳述句， 在自動查找資源方面，Java 并沒有提供一個很好的解決方案，所以最好的辦法是直接告訴 MyBatis 到哪里去找映射檔案， 你可以使用相對于類路徑的資源參考，或完全限定資源定位符（包括 file:/// 形式的 URL），或類名和包名等，例如：

<!-- 使用相對于類路徑的資源參考 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
</mappers>

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

<!-- 使用映射器介面實作類的完全限定類名 -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
</mappers>

<!-- 將包內的映射器介面全部注冊為映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

3、作用域（Scope）和生命周期

3.1、物件生命周期和依賴注入框架

依賴注入框架可以創建執行緒安全的、基于事務的 SqlSession 和映射器，并將它們直接注入到你的 bean 中，因此可以直接忽略它們的生命周期， 如果對如何通過依賴注入框架使用 MyBatis 感興趣，可以研究一下 MyBatis-Spring 或 MyBatis-Guice 兩個子專案，

3.2、SqlSessionFactoryBuilder

這個類可以被實體化、使用和丟棄，一旦創建了 SqlSessionFactory，就不再需要它了， 因此 SqlSessionFactoryBuilder 實體的最佳作用域是方法作用域（也就是區域方法變數）， 你可以重用 SqlSessionFactoryBuilder 來創建多個 SqlSessionFactory 實體，但最好還是不要一直保留著它，以保證所有的 XML 決議資源可以被釋放給更重要的事情，

3.2、SqlSessionFactory

SqlSessionFactory 一旦被創建就應該在應用的運行期間一直存在，沒有任何理由丟棄它或重新創建另一個實體， 使用 SqlSessionFactory 的最佳實踐是在應用運行期間不要重復創建多次，多次重建 SqlSessionFactory 被視為一種代碼“壞習慣”，因此 SqlSessionFactory 的最佳作用域是應用作用域， 有很多方法可以做到，最簡單的就是使用單例模式或者靜態單例模式，

3.3、SqlSession

每個執行緒都應該有它自己的 SqlSession 實體，SqlSession 的實體不是執行緒安全的，因此是不能被共享的，所以它的最佳的作用域是請求或方法作用域， 絕對不能將 SqlSession 實體的參考放在一個類的靜態域，甚至一個類的實體變數也不行， 也絕不能將 SqlSession 實體的參考放在任何型別的托管作用域中，比如 Servlet 框架中的 HttpSession， 如果你現在正在使用一種 Web 框架，考慮將 SqlSession 放在一個和 HTTP 請求相似的作用域中， 換句話說，每次收到 HTTP 請求，就可以打開一個 SqlSession，回傳一個回應后，就關閉它， 

3.4、映射器實體

映射器是一些系結映射陳述句的介面，映射器介面的實體是從 SqlSession 中獲得的，雖然從技術層面上來講，任何映射器實體的最大作用域與請求它們的 SqlSession 相同，但方法作用域才是映射器實體的最合適的作用域， 也就是說，映射器實體應該在呼叫它們的方法中被獲取，使用完畢之后即可丟棄， 映射器實體并不需要被顯式地關閉，盡管在整個請求作用域保留映射器實體不會有什么問題，但是你很快會發現，在這個作用域上管理太多像 SqlSession 的資源會讓你忙不過來， 因此，最好將映射器放在方法作用域內，

更多詳細說明請參考官網檔案：https://mybatis.org/mybatis-3/zh，

標籤：其他

上一篇：每日演算法題之撲克牌順子

下一篇：一個簡單的查詢學生資訊的介面測驗