MyBatis(1)——快速入門

MyBatis 簡介

MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code，并且改名為MyBatis，是一個基于Java的持久層架構。

持久層：可以将業務資料存儲到磁盤，具備長期存儲能力，隻要磁盤不損壞，在斷電或者其他情況下，重新開啟系統仍然可以讀取到這些資料。
優點：可以使用巨大的磁盤空間存儲相當量的資料，并且很廉價
缺點：慢（相對于記憶體而言）

為什麼使用 MyBatis

在我們傳統的 JDBC 中，我們除了需要自己提供 SQL 外，還必須操作 Connection、Statment、ResultSet，不僅如此，為了通路不同的表，不同字段的資料，我們需要些很多雷同模闆化的代碼，閑的繁瑣又枯燥。

而我們在使用了 MyBatis 之後，隻需要提供 SQL 語句就好了，其餘的諸如：建立連接配接、操作 Statment、ResultSet，處理 JDBC 相關異常等等都可以交給 MyBatis 去處理，我們的關注點于是可以就此集中在 SQL 語句上，關注在增删改查這些操作層面上。

并且 MyBatis 支援使用簡單的 XML 或注解來配置和映射原生資訊，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成資料庫中的記錄。

搭建 MyBatis 環境

首先，我們需要先下載下傳和搭建 MyBatis 的開發環境。

下載下傳 MyBatis 工程包

打開連結 http://github.com/mybatis/mybatis-3/releases 下載下傳 MyBatis 所需要的包和源碼，目前最新版本為 3.4.6，官方還提供了文檔：戳這裡，雖然感覺寫得一般，但還是有一些參考價值...唉，别當教程看，當字典看！

下載下傳好 MyBatis 的包解壓後，可以得到以下的檔案目錄：

其中 mybatis-3.4.6.jar 包就是 MyBatis 的項目工程包，【lib】檔案夾下就是 MyBatis 項目需要依賴的第三方包，pdf 檔案是它英文版的說明，不要英文也可以戳上面的連結。

為 IDEA 配置 MyBatis 環境

IDEA 預設是不支援 MyBatis 開發的，需要自己下載下傳第三方插件來支援，可惜的是功能強大的【MyBatis Plugin】是收費的，需要我們自己破解！

第一步：在 IDEA 中下載下傳 MyBatis Plugin

在【File】菜單下找到【Settings】，然後再【Plugins】下點選【Browse repositories..】：

在搜尋欄中輸入【MyBatis Plugin】，然後點選【Install】（我這裡是安裝好了是以沒有這個按鈕）：

第二步：破解

有幸找到最新的破解方法，最新支援破解的版本号為：v3.58 crack，下載下傳連結：戳這裡

把它下載下傳到【D:\Download\】目錄下，打開 idea.vmoptions （【Help】

->

【Eidt Custom VM Options...】）：

在下方插入

-javaagent:D:/Download/ideaagent-1.2.jar

重新開機 IDEA，首次啟動需要信任本地伺服器 ssl 證書，點選接受後如未激活，再次重新開機即可：

至此，我們就為 IDEA 配置好了 MyBatis 的開發環境，可以檢驗一下是否安裝成功：

第一個 MyBatis 程式

我們來實際開發一個 MyBatis 程式，感受一下。

第一步：準備資料庫

首先我們建立一個資料庫【mybatis】，編碼方式設定為 UTF-8，然後再建立一個名為【student】的表，插入幾行資料：

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,'我沒有三顆心髒');
INSERT INTO student VALUES(2,2,'我沒有三顆心髒');
INSERT INTO student VALUES(3,3,'我沒有三顆心髒');

第二步：建立工程

在 IDEA 中建立一個 Java 工程，并命名為【HelloMybatis】，然後導入必要的 jar 包：

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

第三步：建立實體類

在 Package【pojo】下建立實體類【Student】，用于映射表 student：

package pojo;

public class Student {

	int id;
	int studentID;
	String name;

	/* getter and setter */
}

第四步：配置檔案 mybatis-config.xml

在【src】目錄下建立 MyBaits 的主配置檔案

mybatis-config.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>

    <!-- 别名 -->
    <typeAliases>
        <package name="pojo"/>
    </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://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】下建立一個【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 可以直接寫 Student，而不用寫類的全限定名 pojo.Student
namespace 屬性其實就是對 SQL 進行分類管理，實作不同業務的 SQL 隔離
SQL 語句的增删改查對應的标簽有：

第六步：編寫測試類

在 Package【test】小建立測試類【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 {
		// 根據 mybatis-config.xml 配置的資訊得到 sqlSessionFactory
		String resource = "mybatis-config.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
		// 然後根據 sqlSessionFactory 得到 session
		SqlSession session = sqlSessionFactory.openSession();
		// 最後通過 session 的 selectList() 方法調用 sql 語句 listStudent
		List<Student> listStudent = session.selectList("listStudent");
		for (Student student : listStudent) {
			System.out.println("ID:" + student.getId() + ",NAME:" + student.getName());
		}

	}
}

運作測試類：

基本原理

應用程式找 MyBatis 要資料
MyBatis 從資料庫中找來資料

1.通過 mybatis-config.xml 定位哪個資料庫

2.通過 Student.xml 執行對應的 sql 語句

3.基于 Student.xml 把傳回的資料庫封裝在 Student 對象中

4.把多個 Student 對象裝載一個 Student 集合中
傳回一個 Student 集合

參考資料：How2j.cn-MyBatis 相關教程

CRUD 操作

我們來看看正常的一套增删改查應該怎麼實作：

第一步：配置 Student.xml

首先，我們在 SQL 映射檔案中新增語句，用來支撐 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：要求輸入參數的類型
resultType：輸出的類型

第二步：實作增删改查

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 {
		// 根據 mybatis-config.xml 配置的資訊得到 sqlSessionFactory
		String resource = "mybatis-config.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
		// 然後根據 sqlSessionFactory 得到 session
		SqlSession session = sqlSessionFactory.openSession();

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

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

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

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

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

		// 送出修改
		session.commit();
		// 關閉 session
		session.close();
	}
}

上述的程式中：

通過 session.insert("addStudent", student1); 增加了一個 ID 和 studentID 都為 4，名字為“新增加的學生” 的學生
session.delete("deleteStudent", student2); 删除了 ID = 1 的學生
Student student3 = session.selectOne("getStudent", 2); 擷取了 ID = 2的學生
session.update("updateStudent", student3); 将 ID = 2 的學生的名字修改為 “修改的學生”
session.commit() 來送出事務，也可以簡單了解為更新到資料庫

運作獲得正确結果：

模糊查詢

如果要對資料庫中的 student 表進行模糊查詢，需要通過比對名字中的某個字來查詢該使用者。

我們首先在 Student.xml 配置檔案中配置 SQL 映射：

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

注意： <select> 标簽對中 SQL 語句的 “${}” 符号，表示拼接 SQL 串，将接受的參數内容不加任何修飾地拼接在 SQL 中，在 “${}” 中隻能使用 value 來代表其中的參數。

因為是模糊查詢，是以得到的查詢結果可能不止一個，是以我們使用 SqlSession 的 selectList() 方法，寫一個測試方法：

@Test
public void test() throws IOException {

	// 根據 mybatis-config.xml 配置的資訊得到 sqlSessionFactory
	String resource = "mybatis-config.xml";
	InputStream inputStream = Resources.getResourceAsStream(resource);
	SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
	// 然後根據 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());
	}
}

測試結果：

總結一下

關于 parameterType：就是用來在 SQL 映射檔案中指定輸入參數類型的，可以指定為基本資料類型（如 int、float 等）、包裝資料類型（如 String、Interger 等）以及使用者自己編寫的 JavaBean 封裝類
關于 resultType：在加載 SQL 配置，并綁定指定輸入參數和運作 SQL 之後，會得到資料庫傳回的響應結果，此時使用 resultType 就是用來指定資料庫傳回的資訊對應的 Java 的資料類型。
關于 “#{}” ：在傳統的 JDBC 的程式設計中，占位符用 “?” 來表示，然後再加載 SQL 之前按照 “?” 的位置設定參數。而 “#{}” 在 MyBatis 中也代表一種占位符，該符号接受輸入參數，在大括号中編寫參數名稱來接受對應參數。當 “#{}” 接受簡單類型時可以用 value 或者其他任意名稱來擷取。
關于 “${}” ：在 SQL 配置中，有時候需要拼接 SQL 語句（例如模糊查詢時），用 “#{}” 是無法達到目的的。在 MyBatis 中，“${}” 代表一個 “拼接符号” ，可以在原有 SQL 語句上拼接新的符合 SQL 文法的語句。使用 “${}” 拼接符号拼接 SQL ，會引起 SQL 注入，是以一般不建議使用 “${}”。
MyBatis 使用場景：通過上面的入門程式，不難看出在進行 MyBatis 開發時，我們的大部分精力都放在了 SQL 映射檔案上。 MyBatis 的特點就是以 SQL 語句為核心的不完全的 ORM（關系型映射）架構。與 Hibernate 相比，Hibernate 的學習成本比較高，而 SQL 語句并不需要開發人員完成，隻需要調用相關 API 即可。這對于開發效率是一個優勢，但是缺點是沒辦法對 SQL 語句進行優化和修改。而 MyBatis 雖然需要開發人員自己配置 SQL 語句，MyBatis 來實作映射關系，但是這樣的項目可以适應經常變化的項目需求。是以使用 MyBatis 的場景是：對 SQL 優化要求比較高，或是項目需求或業務經常變動。

參考資料：

《Java EE 網際網路輕量級架構整合開發》
《Spring MVC + MyBatis開發從入門到項目實戰》
How2j-MyBatis 系列教程
全能的百度和萬能的大腦

歡迎轉載，轉載請注明出處！

簡書ID：@我沒有三顆心髒

github：wmyskxz

歡迎關注公衆微信号：wmyskxz_javaweb

分享自己的Java Web學習之路以及各種Java學習資料

MyBatis(1)——快速入門

MyBatis 簡介

為什麼使用 MyBatis

搭建 MyBatis 環境

下載下傳 MyBatis 工程包

為 IDEA 配置 MyBatis 環境

第一步：在 IDEA 中下載下傳 MyBatis Plugin

第二步：破解

第一個 MyBatis 程式

第一步：準備資料庫

第二步：建立工程

第三步：建立實體類

第四步：配置檔案 mybatis-config.xml

第五步：配置檔案 Student.xml

第六步：編寫測試類

基本原理

CRUD 操作

第一步：配置 Student.xml

第二步：實作增删改查

模糊查詢

總結一下

參考資料：

繼續閱讀

SSM 整合 Spring+Spring MVC+MyBatisSSM 整合

MyEclipse安裝MyBatipse 從dao快速定位mapper的sql語句

Mybatis問答集

【附源碼】計算機畢業設計SSM網絡求職招聘系統

Mybatis源碼閱讀（一）：Mybatis初始化1.1 解析properties、settings前言入口引申結語

mybatis源碼解析（二）初始化SqlSessionFactory對象

Mybatis源碼閱讀（四）：核心接口4.2——Executor（上）

MyBatis源碼解析(一)——MyBatis初始化過程解MyBatis源碼解析(一)——MyBatis初始化過程解1. 準備工作2. MyBatis初始化過程

從你的WEB世界路過之--0.初識0) 前言1) WEB基本概念2) 響應資料3. 結語

Java 實作Gbase資料庫增删改查功能

mybatis——使用代理對象進行資料庫操作

mybatis中#{}和${}和差別，以及防止sql注入。

myeclipse 搭建mybatis架構時報錯（1）Communications link failure 通訊連結故障

MyBatis學習筆記Mybatis學習筆記（maven、Idea版）

用mybatis的generator插件在項目中自動生成dao及entity

從mybatis到mybatis plus(mp)