MyBatis 簡介 MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code,並且改名為MyBatis,是一個基於Java的持久層框架。 持久層: 可以將業務數據 存儲到磁碟,具備長期存儲 ...
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 集合
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 系列教程
- 全能的百度和萬能的大腦
歡迎轉載,轉載請註明出處!
@我沒有三顆心臟
CSDN博客:http://blog.csdn.net/qq939419061
簡書:http://www.jianshu.com/u/a40d61a49221