MyBatis 簡(jiǎn)介

MyBatis 本是apache的一個(gè)開(kāi)源項(xiàng)目iBatis, 2010年這個(gè)項(xiàng)目由apache software foundation 遷移到了google code水援，并且改名為MyBatis，是一個(gè)基于Java的持久層框架韵洋。

• 持久層： 可以將業(yè)務(wù)數(shù)據(jù)存儲(chǔ)到磁盤(pán)，具備長(zhǎng)期存儲(chǔ)能力善茎，只要磁盤(pán)不損壞缭召，在斷電或者其他情況下巍耗，重新開(kāi)啟系統(tǒng)仍然可以讀取到這些數(shù)據(jù)。
• 優(yōu)點(diǎn)： 可以使用巨大的磁盤(pán)空間存儲(chǔ)相當(dāng)量的數(shù)據(jù)嗜诀，并且很廉價(jià)
• 缺點(diǎn)：慢（相對(duì)于內(nèi)存而言）

為什么使用 MyBatis

在我們傳統(tǒng)的 JDBC 中猾警，我們除了需要自己提供 SQL 外，還必須操作 Connection隆敢、Statment发皿、ResultSet，不僅如此拂蝎，為了訪問(wèn)不同的表穴墅，不同字段的數(shù)據(jù)，我們需要些很多雷同模板化的代碼，閑的繁瑣又枯燥玄货。

而我們?cè)谑褂昧?MyBatis 之后皇钞，只需要提供 SQL 語(yǔ)句就好了，其余的諸如：建立連接松捉、操作 Statment夹界、ResultSet，處理 JDBC 相關(guān)異常等等都可以交給 MyBatis 去處理隘世，我們的關(guān)注點(diǎn)于是可以就此集中在 SQL 語(yǔ)句上可柿，關(guān)注在增刪改查這些操作層面上。

并且 MyBatis 支持使用簡(jiǎn)單的 XML 或注解來(lái)配置和映射原生信息丙者，將接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對(duì)象)映射成數(shù)據(jù)庫(kù)中的記錄复斥。

搭建 MyBatis 環(huán)境

首先，我們需要先下載和搭建 MyBatis 的開(kāi)發(fā)環(huán)境械媒。

下載 MyBatis 工程包

打開(kāi)鏈接 http://github.com/mybatis/mybatis-3/releases 下載 MyBatis 所需要的包和源碼目锭，當(dāng)前最新版本為 3.4.6，官方還提供了文檔： 戳這里纷捞，雖然感覺(jué)寫(xiě)得一般痢虹，但還是有一些參考價(jià)值...唉，別當(dāng)教程看兰绣，當(dāng)字典看世分！

下載好 MyBatis 的包解壓后编振，可以得到以下的文件目錄：

其中 mybatis-3.4.6.jar 包就是 MyBatis 的項(xiàng)目工程包缀辩，【lib】文件夾下就是 MyBatis 項(xiàng)目需要依賴的第三方包，pdf 文件是它英文版的說(shuō)明踪央，不要英文也可以戳上面的鏈接臀玄。

為 IDEA 配置 MyBatis 環(huán)境

IDEA 默認(rèn)是不支持 MyBatis 開(kāi)發(fā)的，需要自己下載第三方插件來(lái)支持畅蹂，可惜的是功能強(qiáng)大的【MyBatis Plugin】是收費(fèi)的健无，需要我們自己破解！

第一步：在 IDEA 中下載 MyBatis Plugin

在【File】菜單下找到【Settings】液斜，然后再【Plugins】下點(diǎn)擊【Browse repositories..】：

在搜索欄中輸入【MyBatis Plugin】累贤，然后點(diǎn)擊【Install】（我這里是安裝好了所以沒(méi)有這個(gè)按鈕）：

第二步：破解

有幸找到最新的破解方法，最新支持破解的版本號(hào)為：v3.58 crack少漆，下載鏈接：戳這里

把它下載到 【D:\Download\】目錄下臼膏，打開(kāi) idea.vmoptions （【Help】-> 【Eidt Custom VM Options...】）：
在下方插入 -javaagent:D:/Download/ideaagent-1.2.jar

重啟 IDEA，首次啟動(dòng)需要信任本地服務(wù)器 ssl 證書(shū)示损，點(diǎn)擊接受后如未激活渗磅，再次重啟即可：

至此，我們就為 IDEA 配置好了 MyBatis 的開(kāi)發(fā)環(huán)境，可以檢驗(yàn)一下是否安裝成功：

第一個(gè) MyBatis 程序

我們來(lái)實(shí)際開(kāi)發(fā)一個(gè) MyBatis 程序始鱼，感受一下仔掸。

第一步：準(zhǔn)備數(shù)據(jù)庫(kù)

首先我們創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)【mybatis】，編碼方式設(shè)置為 UTF-8医清，然后再創(chuàng)建一個(gè)名為【student】的表起暮，插入幾行數(shù)據(jù)：

DROP DATABASE IF EXISTS mybatis;
CREATE DATABASE mybatis DEFAULT CHARACTER SET utf8;

use mybatis;
CREATE TABLE student(
  id int(11) NOT NULL AUTO_INCREMENT,
  studentID int(11) NOT NULL UNIQUE,
  name varchar(255) NOT NULL,
  PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

INSERT INTO student VALUES(1,1,'我沒(méi)有三顆心臟');
INSERT INTO student VALUES(2,2,'我沒(méi)有三顆心臟');
INSERT INTO student VALUES(3,3,'我沒(méi)有三顆心臟');

第二步：創(chuàng)建工程

在 IDEA 中新建一個(gè) Java 工程，并命名為【HelloMybatis】会烙，然后導(dǎo)入必要的 jar 包：

• mybatis-3.4.6.jar
• mysql-connector-java-5.1.21-bin.jar

第三步：創(chuàng)建實(shí)體類

在 Package【pojo】下新建實(shí)體類【Student】鞋怀，用于映射表 student：

package pojo;

public class Student {

    int id;
    int studentID;
    String name;

    /* getter and setter */
}

第四步：配置文件 mybatis-config.xml

在【src】目錄下創(chuàng)建 MyBaits 的主配置文件 mybatis-config.xml ，其主要作用是提供連接數(shù)據(jù)庫(kù)用的驅(qū)動(dòng)持搜，數(shù)據(jù)名稱密似，編碼方式，賬號(hào)密碼等葫盼，我們?cè)诤竺嬲f(shuō)明：

<?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>
        <package name="pojo"/>
    </typeAliases>
    <!-- 數(shù)據(jù)庫(kù)環(huán)境 -->
    <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://localhost:3306/mybatis?characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 映射文件 -->
    <mappers>
        <mapper resource="pojo/Student.xml"/>
    </mappers>

</configuration>

第五步：配置文件 Student.xml

在 Package【pojo】下新建一個(gè)【Student.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="pojo">
    <select id="listStudent" resultType="Student">
        select * from  student
    </select>
</mapper>

• 由于上面配置了 <typeAliases> 別名残腌，所以在這里的 resultType 可以直接寫(xiě) Student，而不用寫(xiě)類的全限定名 pojo.Student
• namespace 屬性其實(shí)就是對(duì) SQL 進(jìn)行分類管理贫导，實(shí)現(xiàn)不同業(yè)務(wù)的 SQL 隔離
• SQL 語(yǔ)句的增刪改查對(duì)應(yīng)的標(biāo)簽有：

第六步：編寫(xiě)測(cè)試類

在 Package【test】小創(chuàng)建測(cè)試類【TestMyBatis】：

package 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 pojo.Student;

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

public class TestMyBatis {

    public static void main(String[] args) throws IOException {
        // 根據(jù) mybatis-config.xml 配置的信息得到 sqlSessionFactory
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        // 然后根據(jù) sqlSessionFactory 得到 session
        SqlSession session = sqlSessionFactory.openSession();
        // 最后通過(guò) session 的 selectList() 方法調(diào)用 sql 語(yǔ)句 listStudent
        List<Student> listStudent = session.selectList("listStudent");
        for (Student student : listStudent) {
            System.out.println("ID:" + student.getId() + ",NAME:" + student.getName());
        }

    }
}

運(yùn)行測(cè)試類：

基本原理

• 應(yīng)用程序找 MyBatis 要數(shù)據(jù)
• MyBatis 從數(shù)據(jù)庫(kù)中找來(lái)數(shù)據(jù)
  1.通過(guò) mybatis-config.xml 定位哪個(gè)數(shù)據(jù)庫(kù)
  2.通過(guò) Student.xml 執(zhí)行對(duì)應(yīng)的 sql 語(yǔ)句
  3.基于 Student.xml 把返回的數(shù)據(jù)庫(kù)封裝在 Student 對(duì)象中
  4.把多個(gè) Student 對(duì)象裝載一個(gè) Student 集合中
• 返回一個(gè) Student 集合

參考資料：How2j.cn-MyBatis 相關(guān)教程

CRUD 操作

我們來(lái)看看常規(guī)的一套增刪改查應(yīng)該怎么實(shí)現(xiàn)：

第一步：配置 Student.xml

首先抛猫，我們?cè)?SQL 映射文件中新增語(yǔ)句，用來(lái)支撐 CRUD 的系列操作

<?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="pojo">
    <select id="listStudent" resultType="Student">
        select * from  student
    </select>

    <insert id="addStudent" parameterType="Student">
        insert into student (id, studentID, name) values (#{id},#{studentID},#{name})
    </insert>

    <delete id="deleteStudent" parameterType="Student">
        delete from student where id = #{id}
    </delete>

    <select id="getStudent" parameterType="_int" resultType="Student">
        select * from student where id= #{id}
    </select>

    <update id="updateStudent" parameterType="Student">
        update student set name=#{name} where id=#{id}
    </update>
</mapper>

• parameterType：要求輸入?yún)?shù)的類型
• resultType：輸出的類型

第二步：實(shí)現(xiàn)增刪改查

package 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 pojo.Student;

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

public class TestMyBatis {

    public static void main(String[] args) throws IOException {
        // 根據(jù) mybatis-config.xml 配置的信息得到 sqlSessionFactory
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        // 然后根據(jù) sqlSessionFactory 得到 session
        SqlSession session = sqlSessionFactory.openSession();

        // 增加學(xué)生
        Student student1 = new Student();
        student1.setId(4);
        student1.setStudentID(4);
        student1.setName("新增加的學(xué)生");
        session.insert("addStudent", student1);

        // 刪除學(xué)生
        Student student2 = new Student();
        student2.setId(1);
        session.delete("deleteStudent", student2);

        // 獲取學(xué)生
        Student student3 = session.selectOne("getStudent", 2);

        // 修改學(xué)生
        student3.setName("修改的學(xué)生");
        session.update("updateStudent", student3);

        // 最后通過(guò) session 的 selectList() 方法調(diào)用 sql 語(yǔ)句 listStudent
        List<Student> listStudent = session.selectList("listStudent");
        for (Student student : listStudent) {
            System.out.println("ID:" + student.getId() + ",NAME:" + student.getName());
        }

        // 提交修改
        session.commit();
        // 關(guān)閉 session
        session.close();
    }
}

上述的程序中：

• 通過(guò) session.insert("addStudent", student1); 增加了一個(gè) ID 和 studentID 都為 4孩灯，名字為“新增加的學(xué)生” 的學(xué)生
• 通過(guò) session.delete("deleteStudent", student2); 刪除了 ID = 1 的學(xué)生
• 通過(guò) Student student3 = session.selectOne("getStudent", 2); 獲取了 ID = 2的學(xué)生
• 通過(guò) session.update("updateStudent", student3); 將 ID = 2 的學(xué)生的名字修改為 “修改的學(xué)生”
• 通過(guò) session.commit() 來(lái)提交事務(wù)闺金，也可以簡(jiǎn)單理解為更新到數(shù)據(jù)庫(kù)

運(yùn)行獲得正確結(jié)果：

模糊查詢

如果要對(duì)數(shù)據(jù)庫(kù)中的 student 表進(jìn)行模糊查詢，需要通過(guò)匹配名字中的某個(gè)字來(lái)查詢?cè)撚脩簟?/p>

我們首先在 Student.xml 配置文件中配置 SQL 映射：

<select id="findStudentByName" parameterMap="java.lang.String" resultType="Student">
    SELECT * FROM student WHERE name LIKE '%${value}%' 
</select>

• 注意： <select> 標(biāo)簽對(duì)中 SQL 語(yǔ)句的 “${}” 符號(hào)峰档，表示拼接 SQL 串败匹，將接受的參數(shù)內(nèi)容不加任何修飾地拼接在 SQL 中，在 “${}” 中只能使用 value 來(lái)代表其中的參數(shù)讥巡。

因?yàn)槭悄：樵兿颇叮缘玫降牟樵兘Y(jié)果可能不止一個(gè)，所以我們使用 SqlSession 的 selectList() 方法欢顷，寫(xiě)一個(gè)測(cè)試方法：

@Test
public void test() throws IOException {

    // 根據(jù) mybatis-config.xml 配置的信息得到 sqlSessionFactory
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    // 然后根據(jù) sqlSessionFactory 得到 session
    SqlSession session = sqlSessionFactory.openSession();

    // 模糊查詢
    List<Student> students = session.selectList("findStudentByName", "三顆心臟");
    for (Student student : students) {
        System.out.println("ID:" + student.getId() + ",NAME:" + student.getName());
    }
}

測(cè)試結(jié)果：

總結(jié)一下

• 關(guān)于 parameterType： 就是用來(lái)在 SQL 映射文件中指定輸入?yún)?shù)類型的槽棍，可以指定為基本數(shù)據(jù)類型（如 int、float 等）抬驴、包裝數(shù)據(jù)類型（如 String炼七、Interger 等）以及用戶自己編寫(xiě)的 JavaBean 封裝類
• 關(guān)于 resultType： 在加載 SQL 配置，并綁定指定輸入?yún)?shù)和運(yùn)行 SQL 之后布持，會(huì)得到數(shù)據(jù)庫(kù)返回的響應(yīng)結(jié)果豌拙，此時(shí)使用 resultType 就是用來(lái)指定數(shù)據(jù)庫(kù)返回的信息對(duì)應(yīng)的 Java 的數(shù)據(jù)類型。
• 關(guān)于 “#{}” ： 在傳統(tǒng)的 JDBC 的編程中鳖链，占位符用 “?” 來(lái)表示姆蘸，然后再加載 SQL 之前按照 “?” 的位置設(shè)置參數(shù)墩莫。而 “#{}” 在 MyBatis 中也代表一種占位符，該符號(hào)接受輸入?yún)?shù)逞敷，在大括號(hào)中編寫(xiě)參數(shù)名稱來(lái)接受對(duì)應(yīng)參數(shù)狂秦。當(dāng) “#{}” 接受簡(jiǎn)單類型時(shí)可以用 value 或者其他任意名稱來(lái)獲取。
• 關(guān)于 “${}” ： 在 SQL 配置中推捐，有時(shí)候需要拼接 SQL 語(yǔ)句（例如模糊查詢時(shí)）裂问，用 “#{}” 是無(wú)法達(dá)到目的的。在 MyBatis 中牛柒，“${}” 代表一個(gè) “拼接符號(hào)” 堪簿，可以在原有 SQL 語(yǔ)句上拼接新的符合 SQL 語(yǔ)法的語(yǔ)句。使用 “${}” 拼接符號(hào)拼接 SQL 皮壁，會(huì)引起 SQL 注入椭更，所以一般不建議使用 “${}”。
• MyBatis 使用場(chǎng)景： 通過(guò)上面的入門程序蛾魄，不難看出在進(jìn)行 MyBatis 開(kāi)發(fā)時(shí)虑瀑，我們的大部分精力都放在了 SQL 映射文件上。 MyBatis 的特點(diǎn)就是以 SQL 語(yǔ)句為核心的不完全的 ORM（關(guān)系型映射）框架滴须。與 Hibernate 相比舌狗，Hibernate 的學(xué)習(xí)成本比較高，而 SQL 語(yǔ)句并不需要開(kāi)發(fā)人員完成扔水，只需要調(diào)用相關(guān) API 即可痛侍。這對(duì)于開(kāi)發(fā)效率是一個(gè)優(yōu)勢(shì)，但是缺點(diǎn)是沒(méi)辦法對(duì) SQL 語(yǔ)句進(jìn)行優(yōu)化和修改魔市。而 MyBatis 雖然需要開(kāi)發(fā)人員自己配置 SQL 語(yǔ)句主届，MyBatis 來(lái)實(shí)現(xiàn)映射關(guān)系，但是這樣的項(xiàng)目可以適應(yīng)經(jīng)常變化的項(xiàng)目需求嘹狞。所以使用 MyBatis 的場(chǎng)景是：對(duì) SQL 優(yōu)化要求比較高岂膳，或是項(xiàng)目需求或業(yè)務(wù)經(jīng)常變動(dòng)誓竿。

參考資料：

• 《Java EE 互聯(lián)網(wǎng)輕量級(jí)框架整合開(kāi)發(fā)》
• 《Spring MVC + MyBatis開(kāi)發(fā)從入門到項(xiàng)目實(shí)戰(zhàn)》
• How2j-MyBatis 系列教程
• 全能的百度和萬(wàn)能的大腦

歡迎轉(zhuǎn)載磅网，轉(zhuǎn)載請(qǐng)注明出處！
簡(jiǎn)書(shū)ID：@我沒(méi)有三顆心臟
github：wmyskxz
歡迎關(guān)注公眾微信號(hào)：wmyskxz_javaweb
分享自己的Java Web學(xué)習(xí)之路以及各種Java學(xué)習(xí)資料