MyBatis官方中文文檔

該作品是PDF文件格式請下載 福昕PDF閱讀器

MyBatis 是支持普通 SQL 查詢，存儲過程和高級映射的優秀持久層框架。MyBatis 消除
了幾乎所有的 JDBC 代碼和參數的手工設置以及結果集的檢索。MyBatis 使用簡單的 XML
或注解用于配置和原始映射，將接口和 Java 的 POJOs（Plan Old Java Objects，普通的 Java
對象）映射成數據庫中的記錄。

入門

每一個 MyBatis 的應 用程序 都以一 個 SqlSessionFactory 對象的 實例為 核心。
SqlSessionFactory 對 象 的 實 例 可 以 通 過 SqlSessionFactoryBuilder
對 象 來 獲 得 。
SqlSessionFactoryBuilder 對象可以從 XML 配置文件，或從 Configuration 類的習慣準備的實
例中構建 SqlSessionFactory 對象。

從 XML 中構建 SqlSessionFactory

從 XML 文件中構建 SqlSessionFactory 的實例非常簡單。這里建議你使用類路徑下的資
源文件來配置，但是你可以使用任意的 Reader 實例，這個實例包括由文字形式的文件路徑
或 URL 形式的文件路徑 file://來創建。MyBatis 包含了一些工具類，稱作為資源，這些工具
類包含一些方法，這些方法使得從類路徑或其他位置加載資源文件更加簡單。
String resource = "org/mybatis/example/Configuration.xml";
Reader reader = Resources.getResourceAsReader(resource);
sqlMapper = new SqlSessionFactoryBuilder().build(reader);
XML 配置文件包含對 MyBatis 系統的核心設置，包含獲取數據庫連接實例的數據源和
決定事務范圍和控制的事務管理器。關于 XML 配置文件的詳細內容可以在文檔后面找到，
這里給出一個簡單的示例：
<?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>
<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="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
當然，在XML配置文件中還有很多可以配置的，上面的示例指出的則是最關鍵的部分。
要注意 XML 頭部的聲明，需要用來驗證 XML 文檔正確性。environment 元素體中包含對事
務管理和連接池的環境配置。mappers 元素是包含所有 mapper （映射器）的列表，這些 mapper
的 XML 文件包含 SQL 代碼和映射定義信息。