MyBatis是一個Java持久化框架，它通過XML描述符或注解把對象與存儲過程或SQL語句關聯起來。
MyBatis是在Apache許可證 2.0下分發的自由軟件，是iBATIS 3.0的分支版本。其維護團隊也包含iBATIS的初創成員。
與其他的對象關系映射框架不同，MyBatis并沒有將Java對象與數據庫表關聯起來，而是將Java方法與SQL語句關聯。MyBatis允許用戶充分利用數據庫的各種功能，例如存儲過程、視圖、各種復雜的查詢以及某數據庫的專有特性。如果要對遺留數據庫、不規范的數據庫進行操作，或者要完全控制SQL的執行，MyBatis是一個不錯的選擇。
與JDBC相比，MyBatis簡化了相關代碼：SQL語句在一行代碼中就能執行。MyBatis提供了一個映射引擎，聲明式的把SQL語句執行結果與對象樹映射起來。通過使用一種內建的類XML表達式語言，或者使用Apache Velocity集成的插件，SQL語句可以被動態的生成。
MyBatis與Spring Framework和Google Guice集成，這使開發者免于依賴性問題。
MyBatis支持聲明式數據緩存（declarative data caching）。當一條SQL語句被標記為“可緩存”后，首次執行它時從數據庫獲取的所有數據會被存儲在一段高速緩存中，今后執行這條語句時就會從高速緩存中讀取結果，而不是再次命中數據庫。MyBatis提供了默認下基于Java HashMap的緩存實現，以及用于與OSCache、Ehcache、Hazelcast和Memcached連接的默認連接器。MyBatis還提供API供其他緩存實現使用?！?/p>
要點
這段時間學習下來，其實對Mybatis來說主要的過程無法是以下幾步
1. 從XML配置文件中獲取SessionFactory，然后由SessionFactory產生相應的Session。
2. 是用Session對象對業務數據完成相應的CRUD操作（增刪改查）和相應的事務控制。
3. 使用完畢后關閉相應的Session，以免過度占用資源
4. 使用配置相應的Mapper xml文件進行業務實體的JavaBean與數據庫表之間做相應的Map操作
戰前準備：
1. 開發環境Eclipse JavaEE IDE，JDK 1.6，數據庫mysql 5.5
2. 下載相應Jar包，以備后用
mybatis-3.2.3.zip 解壓后拿出 mybatis-3.2.3.jar，=> 下載地址： http://code.google.com/p/mybatis/ （Mybatis核心包）
mybatis-generator-core-1.3.1.jar => 下載地址： http://code.google.com/p/mybatis/wiki/Generator （Mybatis自動生成配置文件包）
mysql-connector-java-5.1.26-bin.jar => 下載地址：http://dev.mysql.com/downloads/connector/j/ （Mysql 的jdbc驅動包）
搭建步驟
接下來大家可以再Eclipse下面建一個名為MybatisDemo的Java Project項目，按照如下圖中所示新建相應的包結構和文件夾結構，其中config與mapper分別為文件夾，
包david.mybatis.demo與包david.mybatis.model下分別存放相應的demo運行程序與Javabean對象，lib文件夾下存放剛剛下載的那幾個第三方jar包。
建完下面的目錄，我們可以添加相應的Jar包，如下圖
完成后，執行下面SQL，建立DEMO所需的表結構，分別有3張表，Visitor（訪問者表），Website（網站表），Channel（頻道表）
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
|
/*創建Visitor*/CREATE TABLE Visitor( Id INT(11) NOT NULL AUTO_INCREMENT, Name VARCHAR(1000) NOT NULL, Email VARCHAR(1000) NOT NULL, Status INT NOT NULL DEFAULT 1, CreateTime DateTime, PRIMARY KEY(Id))/*創建網站表*/CREATE TABLE Website( Id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, Name VARCHAR(1000) NOT NULL, VisitorId INT REFERENCES Visitor(Id), Status INT NOT NULL DEFAULT 1, CreateTime DateTime)/*創建頻道表*/CREATE TABLE Channel( Id INT NOT NULL PRIMARY KEY AUTO_INCREMENT, Name VARCHAR(1000) NOT NULL, WebsiteId INT REFERENCES Website(Id), Status INT NOT NULL DEFAULT 1, CreateTime DateTime) |
所有這些都完成后，我們就要開始動手啦~
就像開頭說的，Mybatis的所有配置都源于一份XML配置文件，我們需要在config文件夾下，新建名為mybatis_demo_config.xml的配置文件，這一份東西就是我們后面所需要操作的核心之一。
在配置這個文件千萬要注意<configuration>節點內的元素都是有層級順序的要求的，不能夠隨意更換次序，否則在加載xml配置文件的時候會出現異常而導致后續操作不成功。
具體的節點說明大家可以查看http://mybatis.github.io/mybatis-3/zh/configuration.html#，這里只說比較常用的節點，typeAliases，environments，mappers。
1. typeAliases => 別名節點，可以通過設置這個節點的屬性，這樣配置文件中其他需要實體名字的地方都可以使用此別名而不是完全限定名
例如 <typeAlias type="david.mybatis.model.Visitor" alias="Visitor" />
2. environments => 環境節點，配置數據連接相關的信息
3. mappers => 配置SQL映射語句。
最簡單的配置如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
<?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="david.mybatis.model.Visitor" alias="Visitor" /> </typeAliases> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"></transactionManager> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <!-- ?useUnicode=true&characterEncoding=utf8為了支持中文插入 --> <property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis_db?useUnicode=true&characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="123456" /> </dataSource> </environment> </environments> <mappers> <mapper resource="mapper/VisitorMapper.xml" /> </mappers></configuration> |
在包david.mybatis.demo下面新建一個名為MyBatisUtils類，里面存放獲取SqlSession與關閉SqlSession的方法，提煉出來方便多次復用。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
package david.mybatis.demo;import java.io.InputStream;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 david.mybatis.model.CRUD_Enum;public class MybatisUtils { private static final String CONFIG_PATH = "config/mybatis_demo_config.xml"; /* * 獲取數據庫訪問鏈接 */ public static SqlSession getSqlSession() { SqlSession session = null; try { InputStream stream = Resources.getResourceAsStream(CONFIG_PATH); //可以根據配置的相應環境讀取相應的數據庫環境 // SqlSessionFactory factory = new SqlSessionFactoryBuilder().build( // stream, "development"); SqlSessionFactory factory = new SqlSessionFactoryBuilder() .build(stream); session = factory.openSession(); } catch (Exception e) { // TODO: handle exception e.printStackTrace(); } return session; } /* * 獲取數據庫訪問鏈接 */ public static void closeSession(SqlSession session) { session.close(); } /* * 返回操作記錄消息 */ public static void showMessages(CRUD_Enum type, int count) { switch (type) { case Add: System.out.println("添加了" + count + "條記錄。"); break; case Delete: System.out.println("刪除了" + count + "條記錄。"); break; case Update: System.out.println("更新了" + count + "條記錄。"); break; case Query: System.out.println("匹配了" + count + "條記錄。"); break; case List: System.out.println("共有" + count + "條記錄。"); break; default: break; } }} |
在包david.mybatis.model下面新建一個名為Visitor的類，用來作相應的OR Mapping。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
package david.mybatis.model;import java.text.SimpleDateFormat;import java.util.Date;public class Visitor { private int id; private String name; private String email; private int status; private Date createTime; public Visitor() { // TODO Auto-generated constructor stub createTime = new Date(); } public Visitor(String name, String email) { this.name = name; this.email = email; this.status = 1; this.createTime = new Date(); } public int getId() { return id; } public void setName(String name) { this.name = name; } public String getName() { return name; } public void setEmail(String email) { this.email = email; } public String getEmail() { return email; } public Date getCreateTime() { return createTime; } @Override public String toString() { // TODO Auto-generated method stub return String.format("{Id: %d, Name: %s, CreateTime: %s}", id, name, new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(createTime)); }} |
在包david.mybatis.demo下面新建一個VisitorMapper.xml，用來映射相應SQL語句。
這里要注意namespace=>david.mybatis.demo.IVisitorOperation一定要與對應這個包下面的實際文件名，IVisitorOperation否則無法成功加載相應的映射文件
|
1
2
3
4
5
6
|
<mapper namespace="david.mybatis.demo.IVisitorOperation"> <select id="basicQuery" parameterType="int" resultType="Visitor"> select * from visitor where id=#{id} and Status>0 order by Id </select></mapper> |
接下來運行下面的程序
|
1
2
3
4
5
6
7
8
9
10
|
public static void testBasicQuery(int id) { SqlSession session = MybatisUtils.getSqlSession(); try { Visitor visitor = (Visitor) session.selectOne("david.mybatis.demo.IVisitorOperation.basicQuery", id); MybatisUtils.closeSession(session); System.out.println(visitor); } catch (Exception e) { // TODO: handle exception } } |
一個最簡單的執行結果就出來啦
這算是Mybatis系列的HelloWord~
