1 簡介

MyBatis 是支援普通 SQL 查詢，儲存過程和高階對映的優秀持久層框架，其幾乎消除了所有的 JDBC 程式碼和引數的手工設定以及結果集的檢索。MyBatis 使用簡單的 XML 或註解用於配置和原始對映，將介面和 Java 的 POJOs（Plain Old Java Objects，普通的 Java物件）對映成資料庫中的記錄。MyBatis 應用程式大都使用 SqlSessionFactory 例項，SqlSessionFactory 例項可以通過 SqlSessionFactoryBuilder 獲得，而　SqlSessionFactoryBuilder 則可以從一個 XML 配置檔案或者一個預定義的配置類的例項獲得。

2 構建步驟

想要熟練的使用 MyBatis 框架，就必須明確其構建步驟，在此，咱們給出構建 MyBatis 框架的詳細步驟，以供大家參考：

• 建立一個 Java Web 專案；
• 匯入 MyBatis 框架的 jar 包；
• 建立核心配置檔案 sqlMapConfig.xml ；
• 建立對映檔案 UersMapper.xml；
• 建立測試類。

其中，MyBatis 框架的 jar 包可以通過“MyBatis 之 各種依賴包 ”進行下載，而且裡面包含了大多數常用的配置檔案，值得大家get。此外，還有一點需要大家注意，那就是 MyBatis 框架用於操作資料，支援 SQL 語句，因此在體驗 MyBatis 框架的時候，需要使用資料庫配合進行測試。在本篇博文中，咱們在資料庫中建立了一個名為“person”的表，並通過 MyBatis 框架對其進行一系列常見的操作（增、刪、改、查等）。

3 體驗 MyBatis 框架

首先，給出專案結構圖：

第一步：建立 Java Web 專案，匯入 jar 包

mybatis-3.2.2.jar                       核心jar
mysql-connector-java-5.1.10-bin.jar     資料庫訪問
asm-3.3.1.jar                           增強類
cglib-2.2.2.jar                         動態代理
commons-logging-1.1.1.jar               通用日誌
javassist-3.17
 
.1-GA.jar                 java助手
log4j-1.2.17.jar                        日誌
slf4j-api-1.7.5.jar                     日誌
slf4j-log4j12-1.7.5.jar                 日誌

第二步：建立核心配置檔案 sqlMapConfig.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="test">
        <environment id="test">
            <transactionManager type="JDBC"></transactionManager>    <!-- 事務管理型別：JDBC、MANAGED -->
            <dataSource type="POOLED">    <!-- 資料來源型別：POOLED、UNPOOLED、JNDI -->
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
    </environments>

    <!-- 載入對映檔案 mapper -->
    <mappers>
        <!-- 路徑用 斜線（/） 分割，而不是用 點(.) -->
        <mapper resource="yeepay/payplus/mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

第三步：建立對映檔案 UersMapper.xml

<?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="yeepay.payplus/mapper.UserMapper">   <!-- 名稱空間，名字可以隨意起，只要不衝突即可 -->
    <!-- 物件對映，可以不寫 -->
    <!-- 查詢功能，resultType 設定返回值型別 -->
    <select id="findAll" resultType="yeepay.payplus.Person">  <!-- 書寫 SQL 語句 -->
        SELECT * FROM Person
    </select>
</mapper>

第四步：建立實體類（Person）

package yeepay.payplus;

/**
 * Created by 維C果糖 on 2017/2/1.
 */
public class Person {
    private Integer id;
    private String name;
    private Integer age;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "Person{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

第五步：建立測試類（CeshiMyBatis）

package yeepay.payplus.test;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;
import yeepay.payplus.Person;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

/**
 * Created by 維C果糖 on 2017/2/1.
 */
public class CeshiMyBatis {
    @Test
    public void ceshi() throws IOException {
        /**
         *  1、獲得 SqlSessionFactory
         *  2、獲得 SqlSession
         *  3、呼叫在 mapper 檔案中配置的 SQL 語句
         */
        String resource = "sqlMapConfig.xml";           // 定位核心配置檔案
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);    // 建立 SqlSessionFactory

        SqlSession sqlSession = sqlSessionFactory.openSession();    // 獲取到 SqlSession

        // 呼叫 mapper 中的方法：名稱空間 + id
        List<Person> personList = sqlSession.selectList("yeepay.payplus/mapper.UserMapper.findAll");

        for (Person p : personList){
            System.out.println(p);
        }
    }
}

在完成以上步驟後，咱們可以通過 JUnit 來測試框架是否搭建成功，具體使用 JUnit 進行測試的方法，可以通過閱讀“基於 JUnit 單元測試的原理及示例”來了解更為詳細的內容。