深入淺出Mybatis之快速入門！

簡介

MyBatis的前身叫iBatis，本是apache的一個開源項目, 2010年這個項目由apache software foundation 遷移到了google code，並且改名爲MyBatis。MyBatis是支持普通SQL查詢，存儲過程和高級映射的優秀持久層框架。MyBatis消除了幾乎所有的JDBC代碼和參數的手工設置以及結果集的檢索。MyBatis使用簡單的XML或註解用於配置和原始映射，將接口和Java的POJOs（Plan Old Java Objects，普通的Java對象）映射成數據庫中的記錄。

Mybatis的功能架構分爲三層（圖片借用了百度百科）：

1)       API接口層：提供給外部使用的接口API，開發人員通過這些本地API來操縱數據庫。接口層一接收到調用請求就會調用數據處理層來完成具體的數據處理。

2)       數據處理層：負責具體的SQL查找、SQL解析、SQL執行和執行結果映射處理等。它主要的目的是根據調用的請求完成一次數據庫操作。

3)      基礎支撐層：負責最基礎的功能支撐，包括連接管理、事務管理、配置加載和緩存處理，這些都是共用的東西，將他們抽取出來作爲最基礎的組件。爲上層的數據處理層提供最基礎的支撐。

 

 

快速入門

Mybatis的整體流程圖

 

SqlSessionFactoryBuilder

每一個MyBatis的應用程序的入口是SqlSessionFactoryBuilder，它的作用是通過XML配置文件創建Configuration對象（當然也可以在程序中自行創建），然後通過build方法創建SqlSessionFactory對象。沒有必要每次訪問Mybatis就創建一次SqlSessionFactoryBuilder，通常的做法是創建一個全局的對象就可以了。示例程序如下：

[java] view plain copy

private static SqlSessionFactoryBuilder sqlSessionFactoryBuilder;
private static SqlSessionFactory sqlSessionFactory;
private static void init() throws IOException {
    String resource = "mybatis-config.xml";
    Reader reader = Resources.getResourceAsReader(resource);
    sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
    sqlSessionFactory = sqlSessionFactoryBuilder.build(reader);
}

 

SqlSessionFactory

SqlSessionFactory對象由SqlSessionFactoryBuilder創建。它的主要功能是創建SqlSession對象，和SqlSessionFactoryBuilder對象一樣，沒有必要每次訪問Mybatis就創建一次SqlSessionFactory，通常的做法是創建一個全局的對象就可以了。SqlSessionFactory對象一個必要的屬性是Configuration對象,它是保存Mybatis全局配置的一個配置對象，通常由SqlSessionFactoryBuilder從XML配置文件創建。這裏給出一個簡單的示例：

[html] view plain copy

<?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>
    <!-- 配置別名 -->
    <typeAliases>
        <typeAlias type="org.iMybatis.abc.dao.UserDao" alias="UserDao" />
        <typeAlias type="org.iMybatis.abc.dto.UserDto" alias="UserDto" />
    </typeAliases>

    <!-- 配置環境變量 -->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/iMybatis?characterEncoding=GBK" />
                <property name="username" value="iMybatis" />
                <property name="password" value="iMybatis" />
            </dataSource>
        </environment>
    </environments>

    <!-- 配置mappers -->
    <mappers>
        <mapper resource="org/iMybatis/abc/dao/UserDao.xml" />
    </mappers>

</configuration>

要注意XML頭部的聲明，需要用來驗證XML文檔正確性。typeAliases 元素是包含所有typeAlias（別名）的列表，別名用來替換完整類名，這樣在需要完整類名的地方就可以用別名來代替。environment元素體中包含對事務管理和連接池的環境配置。mappers元素是包含所有mapper（映射器）的列表，這些mapper的XML文件包含SQL代碼和映射定義信息。當然，在XML配置文件中還有很多可以配置的，上面的示例指出的則是最關鍵的部分，其他配置請參考Mybatis的官方文檔。

 

SqlSession

SqlSession對象的主要功能是完成一次數據庫的訪問和結果的映射，它類似於數據庫的session概念，由於不是線程安全的，所以SqlSession對象的作用域需限制方法內。SqlSession的默認實現類是DefaultSqlSession，它有兩個必須配置的屬性：Configuration和Executor。Configuration前文已經描述這裏不再多說。SqlSession對數據庫的操作都是通過Executor來完成的，Executor的具體功能在下一小節在描述。

到目前爲止，我們看到的都是mybatis的流程，我們的應用程序在什麼地方插入到這個流程中並獲得我們想要的結果呢？就是SqlSession這裏。SqlSession有一個重要的方法getMapper，顧名思義，這個方式是用來獲取Mapper對象的。什麼是Mapper對象？根據Mybatis的官方手冊，應用程序除了要初始並啓動Mybatis之外，還需要定義一些接口，接口裏定義訪問數據庫的方法，存放接口的包路徑下需要放置同名的XML配置文件。SqlSession的getMapper方法是聯繫應用程序和Mybatis紐帶，應用程序訪問getMapper時，Mybatis會根據傳入的接口類型和對應的XML配置文件生成一個代理對象，這個代理對象就叫Mapper對象。應用程序獲得Mapper對象後，就應該通過這個Mapper對象來訪問Mybatis的SqlSession對象，這樣就達到裏插入到Mybatis流程的目的。示例代碼如下：

[java] view plain copy

SqlSession session= sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
UserDto user = new UserDto();
user.setUsername("iMybatis");
List<UserDto> users = userDao.queryUsers(user);

對應的接口：

[java] view plain copy

public interface UserDao {
    public List<UserDto> queryUsers(UserDto user) throws Exception;
}

對應的配置文件：

[html] view plain copy

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.iMybatis.abc.dao.UserDao">
    <select id="queryUsers" parameterType="UserDto" resultType="UserDto"
        useCache="false">
        <![CDATA[
        select * from t_user t where t.username = #{username}
        ]]>
    </select>
</mapper>

Executor

Executor對象在創建Configuration對象的時候創建，並且緩存在Configuration對象裏。Executor對象的主要功能是調用StatementHandler訪問數據庫，並將查詢結果存入緩存中（如果配置了緩存的話）。

 

StatementHandler

StatementHandler是真正訪問數據庫的地方，並調用ResultSetHandler處理查詢結果。

ResultSetHandler

處理查詢結果

源碼來源：×××/technology