MyBatis環境組態及入門

Mybatis 開發環境搭建，選擇: MyEclipse8.5 版本，mysql 5.5, jdk 1.8, mybatis3.2.3.jar 包。這些軟體工具均可以到各自的官方網站上下載。

整個過程在概如下，

1. 在本教學中，建立 java 工程，但一般都是開發 web 專案，這個系列教學最後是 web，但這裡為了方便學習，本教學前面建立的都是 java 工程。
2. 將 mybatis-3.2.3.jar，mysql-connector-java-5.1.25-bin.jar 建立兩個使用者自定庫（User Libary）：mysql-connector 和 mybatis；
3. 建立 mysql 測試資料庫和使用者表, 注意，資料庫使用的是 utf-8 編碼。以解決不必要的中文亂碼問題。

一、建立 Java 工程

首先建立一個名字為 Helloword 的 java project。選擇 "File" -> "New" ->"Java Project"，如下圖所示：

這樣就建立了一個 Java 工程了，我們繼續下一步。接下來我們在 mybatis-start 專案中加入兩個所需的程式庫：mysql-connector 和 mybatis，右鍵點選 "mybatis-start" 專案，從彈出的選單中選擇： "Build Path" -> "Add Libaries..." ，如下圖所示：

從中選擇「User Library"，點選「Next>"，建立兩個類庫為：mysql-connector 和 mybatis，如下所示：

點選「User Libararies..."，繼續下一步，建立一個新的類庫，如下圖所示：

到此使用者的一個類庫建立完成，以相同的方式來建立另一個類庫：

二、建立資料庫和 User 表

建立所需的資料庫和表，要建立的資料庫是：yiibai，並在 yiibai 資料庫建立一個表：user，如下圖所示：

建立資料庫：yiibai，使用 utf-8 編碼。

接下我們建立一個表：user，並插入一條記錄資訊，其結構如下所示：

CREATE TABLE `user` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(64) NOT NULL DEFAULT '',
  `dept` varchar(254) NOT NULL DEFAULT '',
  `website` varchar(254) DEFAULT '',
  `phone` varchar(16) NOT NULL DEFAULT '',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=latin1;

-- ----------------------------
-- Records of user
-- ----------------------------
INSERT INTO `user` VALUES ('1', 'yiibai', 'Tech', 'https://www.tw511.com', '13800009988');

三、建立 Mybatis 組態檔案

到此為止，前期準備工作就完成了。下面開始真正組態 mybatis-start 專案。設定 mybatis 組態檔案: Configure.xml, 在 src/config 目錄下建立此檔案，內容如下:

<?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 alias="User" type="com.yiibai.mybatis.models.User" />
	</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://127.0.0.1:3306/yiibai" />
			    <property name="username" value="root" />
			    <property name="password" value="" />
                       </dataSource>
		</environment>
	</environments>

	<mappers>
	     <!-- // power by https://www.tw511.com -->
	     <mapper resource="com/yiibai/mybatis/models/User.xml" />
	</mappers>
</configuration>

四、建立實體類和對映檔案

首先建立一個包：com.yiibai.mybatis.models，並在下建立與資料庫表對應的 User.java 類及其對映檔案：User.xml，詳細如下圖所示：

package com.yiibai.mybatis.models;

public class User {
	private int id;
	private String name;
	private String dept;
	private String phone;
	private String website;
	
	public String getWebsite() {
		return website;
	}
	public void setWebsite(String website) {
		this.website = website;
	}
	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getDept() {
		return dept;
	}
	public void setDept(String dept) {
		this.dept = dept;
	}
	public String getPhone() {
		return phone;
	}
	public void setPhone(String phone) {
		this.phone = phone;
	}
	
}

同時建立這個 User 類對應的對映檔案 User.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="com.yiibai.mybatis.models.UserMapper">
	<select id="GetUserByID" parameterType="int" resultType="User">
		select * from `user` where id = #{id}
    </select>
</mapper>

下面是對這幾個組態檔案一點解釋說明：
1、組態檔案 Configure.xml 是 mybatis 用來建立 sessionFactory，裡面主要包含了資料庫連線相關內容，還有 java 類所對應的別名，比如：<typeAlias alias="User" type="com.yiibai.mybatis.models.User"/> 這個別名非常重要，在具體的類的對映中，比如：User.xml 中 resultType 就是對應這個。要保持一致，這裡的 resultType 還有另外單獨的定義方式，後面學習到我們再詳細介紹說明。
2、Configure.xml 裡面的<mapper resource="com/yiibai/mybatis/models/User.xml"/>是包含要對映的類的 xml 組態檔案。
3、在User.xml 檔案裡面主要是定義各種 SQL 語句，以及這些語句的引數，以及要返回的型別等等。

五、執行程式測試結果

在 src 原始碼目錄下建立一個類叫作：HelloWord, 來執行測試組態環境是否成功，具體程式碼如下示：

import java.io.Reader;

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 com.yiibai.mybatis.models.*;

/**
 * 
 * @author yiibai
 * @copyright https://www.tw511.com
 * @date 2015/09/22
 */
public class HelloWord {
	private static SqlSessionFactory sqlSessionFactory;
	private static Reader reader;

	static {
		try {
			reader = Resources.getResourceAsReader("config/Configure.xml");
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
	public static SqlSessionFactory getSession() {
		return sqlSessionFactory;
	}
	/**
	 * @param args
	 */
	public static void main(String[] args) {
		// TODO Auto-generated method stub
		SqlSession session = sqlSessionFactory.openSession();
		try {
			User user = (User) session.selectOne(
					"com.yiibai.mybatis.models.UserMapper.GetUserByID", 1);
			if(user!=null){
				String userInfo = "名字："+user.getName()+", 所屬部門："+user.getDept()+", 主頁："+user.getWebsite();
				System.out.println(userInfo);
			}
		} finally {
			session.close();
		}
	}

}

現在執行這個程式，不是得到查詢結果了？正確的輸出結果應該如下：

名字：yiibai, 所屬部門：Tech, 主頁：https://www.tw511.com

恭喜你，環境搭建組態成功，在接下來章節，我們將學習 Mybatis 的操作方式：增刪改查。

Jar 包下載：http://pan.baidu.com/s/1bnyRJ9H