一、Mybatis介紹

MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation
遷移到了google code，並且改名爲MyBatis 。2013年11月遷移到Github。
MyBatis是一個優秀的持久層框架，它對jdbc的操作數據庫的過程進行封裝，使開發者只需要關注 SQL
本身，而不需要花費精力去處理例如註冊驅動、創建connection、創建statement、手動設置參數、結果集檢索等jdbc繁雜的過程代碼。
Mybatis通過xml或註解的方式將要執行的各種statement（statement、preparedStatemnt、CallableStatement）配置起來，並通過java對象和statement中的sql進行映射生成最終執行的sql語句，最後由mybatis框架執行sql並將結果映射成java對象並返回。

二、使用jdbc編程問題總結

2.1 jdbc操作數據庫

1、加載數據庫驅動
2、創建並獲取數據庫鏈接
3、創建jdbc statement對象
4、設置sql語句
5、設置sql語句中的參數(使用preparedStatement)
6、通過statement執行sql並獲取結果
7、對sql執行結果進行解析處理
8、釋放資源(resultSet、preparedstatement、connection)

public static void main(String[] args) {
	Connection connection = null;
	PreparedStatement preparedStatement = null;
	ResultSet resultSet = null;

	try {
		// 加載數據庫驅動
		Class.forName("com.mysql.jdbc.Driver");

		// 通過驅動管理類獲取數據庫鏈接
		connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "root");
		// 定義sql語句 ?表示佔位符
		String sql = "select * from user where username = ?";
		// 獲取預處理statement
		preparedStatement = connection.prepareStatement(sql);
		// 設置參數，第一個參數爲sql語句中參數的序號（從1開始），第二個參數爲設置的參數值
		preparedStatement.setString(1, "王五");
		// 向數據庫發出sql執行查詢，查詢出結果集
		resultSet = preparedStatement.executeQuery();
		// 遍歷查詢結果集
		while (resultSet.next()) {
			System.out.println(resultSet.getString("id") + "  " + resultSet.getString("username"));
		}
	} catch (Exception e) {
		e.printStackTrace();
	} finally {
		// 釋放資源
		if (resultSet != null) {
			try {
				resultSet.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
		if (preparedStatement != null) {
			try {
				preparedStatement.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
		if (connection != null) {
			try {
				connection.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
	}
}

2.2 jdbc問題總結

1、數據庫連接創建、釋放頻繁造成系統資源浪費，從而影響系統性能。如果使用數據庫連接池可解決此問題。
2、 Sql語句在代碼中硬編碼，造成代碼不易維護，實際應用中sql變化的可能較大，sql變動需要改變java代碼。
3、使用preparedStatement向佔有位符號傳參數存在硬編碼，因爲sql語句的where條件不一定，可能多也可能少，修改sql還要修改代碼，系統不易維護。
4、對結果集解析存在硬編碼（查詢列名），sql變化導致解析代碼變化，系統不易維護，如果能將數據庫記錄封裝成pojo對象解析比較方便

三、Mybatis架構

1、 mybatis配置
SqlMapConfig.xml，此文件作爲mybatis的全局配置文件，配置了mybatis的運行環境等信息。
mapper.xml文件即sql映射文件，文件中配置了操作數據庫的sql語句。此文件需要在SqlMapConfig.xml中加載。
2、通過mybatis環境等配置信息構造SqlSessionFactory即會話工廠
3、由會話工廠創建sqlSession即會話，操作數據庫需要通過sqlSession進行。
4、 mybatis底層自定義了Executor執行器接口操作數據庫，Executor接口有兩個實現，一個是基本執行器、一個是緩存執行器。
5、 Mapped Statement也是mybatis一個底層封裝對象，它包裝了mybatis配置信息及sql映射信息等。mapper.xml文件中一個sql對應一個Mapped Statement對象，sql的id即是Mapped statement的id。
6、 Mapped Statement對sql執行輸入參數進行定義，包括HashMap、基本類型、pojo，Executor通過Mapped Statement在執行sql前將輸入的java對象映射至sql中，輸入參數映射就是jdbc編程中對preparedStatement設置參數。
7、 Mapped Statement對sql執行輸出結果進行定義，包括HashMap、基本類型、pojo，Executor通過Mapped Statement在執行sql後將輸出結果映射至java對象中，輸出結果映射過程相當於jdbc編程中對結果的解析處理過程。

四、mybatis的使用

4.1 創建Java工程

4.2 導入mybatis相關的jar包

加入mybatis核心包、依賴包、數據驅動包

4.3 加入配置文件

4.3.1 日誌輸出文件

mybatis默認使用log4j作爲輸出日誌信息

4.3.2 mybatis配置文件

<?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>
	<!-- 和spring整合後 environments配置將廢除 -->
	<environments default="development">
		<environment id="development">
			<!-- 使用jdbc事務管理 -->
			<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="123" />
			</dataSource>
		</environment>
	</environments>
</configuration>

4.4 創建pojo

pojo類作爲mybatis進行sql映射使用，po類通常與數據庫表對應

public class User {
	private int id;
	private String username;// 用戶姓名
	private String sex;// 性別
	private Date birthday;// 生日
	private String address;// 地址
	
	get/set方法......
	
}

4.5 創建sql映射文件

4.6 加載映射文件

4.7 根據id查詢用戶

4.7.1 映射文件

在user.xml中添加select標籤，編寫sql

4.7.2 測試程序

測試程序步驟：

創建SqlSessionFactoryBuilder對象
加載SqlMapConfig.xml配置文件
創建SqlSessionFactory對象
創建SqlSession對象
執行SqlSession對象執行查詢，獲取結果User
打印結果
釋放資源

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 org.junit.Before;
import org.junit.Test;

public class MybatisTest {

	private SqlSessionFactory sqlSessionFactory = null;

	@Before
	public void init() throws Exception {
		// 1. 創建SqlSessionFactoryBuilder對象
		SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
		// 2. 加載SqlMapConfig.xml配置文件
		InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
		// 3. 創建SqlSessionFactory對象
		this.sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
	}

	@Test
	public void testQueryUserById() throws Exception {
		// 4. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 5. 執行SqlSession對象執行查詢，獲取結果User
		// 第一個參數是User.xml的statement的id，第二個參數是執行sql需要的參數；
		Object user = sqlSession.selectOne("queryUserById", 1);
		// 6. 打印結果
		System.out.println(user);
		// 7. 釋放資源
		sqlSession.close();
	}

}

4.7.3 執行結果

4.8 模糊查詢

4.8.1 採用佔位符

@Test
	public void testQueryUserByUsername1() throws Exception {
		// 4. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 5. 執行SqlSession對象執行查詢，獲取結果User
		// 查詢多條數據使用selectList方法
		List<Object> list = sqlSession.selectList("queryUserByUsername1", "%王%");
		// 6. 打印結果
		for (Object user : list) {
			System.out.println(user);
		}
		// 7. 釋放資源
		sqlSession.close();
	}

4.8.2 拼湊字符串

@Test
	public void testQueryUserByUsername2() throws Exception {
		// 4. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 5. 執行SqlSession對象執行查詢，獲取結果User
		// 查詢多條數據使用selectList方法
		List<Object> list = sqlSession.selectList("queryUserByUsername2", "王");
		// 6. 打印結果
		for (Object user : list) {
			System.out.println(user);
		}
		// 7. 釋放資源
		sqlSession.close();
	}

4.9 總結

4.9.1 #{}和${}

#{}表示一個佔位符號，通過#{}可以實現preparedStatement向佔位符中設置值，自動進行java類型和jdbc類型轉換。#{}可以有效防止sql注入。 #{}可以接收簡單類型值或pojo屬性值。如果parameterType傳輸單個簡單類型值，#{}括號中可以是value或其它名稱。
$ {}表示拼接sql串，通過$ {}可以將parameterType 傳入的內容拼接在sql中且不進行jdbc類型轉換， $ {}可以接收簡單類型值或pojo屬性值，如果parameterType傳輸單個簡單類型值，${}括號中只能是value。

4.9.2 parameterType和resultType

parameterType：指定輸入參數類型，mybatis通過ognl從輸入對象中獲取參數值拼接在sql中。
resultType：指定輸出結果類型，mybatis將sql查詢結果的一行記錄數據映射爲resultType指定類型的對象。如果有多條數據，則分別進行映射，並把對象放到容器List中

4.9.3 selectOne和selectList

selectOne查詢一條記錄，如果使用selectOne查詢多條記錄則拋出異常：
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 3
at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)
selectList可以查詢一條或多條記錄

4.10 實現添加功能

4.10.1 映射文件

4.10.2 測試

	@Test
	public void testSaveUser() {
		// 4. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 5. 執行SqlSession對象執行保存
		// 創建需要保存的User
		User user = new User();
		user.setUsername("馬弓手關羽請求出戰");
		user.setSex("1");
		user.setBirthday(new Date());
		user.setAddress("蜀國");
		sqlSession.insert("saveUser", user);
		System.out.println(user);
		// 需要進行事務提交
		sqlSession.commit();
		// 7. 釋放資源
		sqlSession.close();
	}

4.10.3 結果展示

4.10.4 mysql自增主鍵返回

LAST_INSERT_ID():是mysql的函數，返回auto_increment自增列新記錄id值

4.10.5 Mysql使用 uuid實現主鍵

4.11 修改操作

@Test
	public void testUpdateUserById() {
		// 4. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();

		// 5. 執行SqlSession對象執行更新
		// 創建需要更新的User
		User user = new User();
		user.setId(26);
		user.setUsername("關羽");
		user.setSex("1");
		user.setBirthday(new Date());
		user.setAddress("蜀國");
		sqlSession.update("updateUserById", user);
		// 需要進行事務提交
		sqlSession.commit();
		// 7. 釋放資源
		sqlSession.close();
	}

4.12 刪除操作

	@Test
	public void testDeleteUserById() {
		// 1. 創建SqlSession對象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 2. 執行SqlSession對象執行刪除
		sqlSession.delete("deleteUserById", 26);
		// 3. 需要進行事務提交
		sqlSession.commit();
		// 4. 釋放資源
		sqlSession.close();
	}

五、Mybatis解決jdbc編程的問題

1、數據庫連接創建、釋放頻繁造成系統資源浪費從而影響系統性能，如果使用數據庫連接池可解決此問題。
解決：在SqlMapConfig.xml中配置數據連接池，使用連接池管理數據庫鏈接。
2、 Sql語句寫在代碼中造成代碼不易維護，實際應用sql變化的可能較大，sql變動需要改變java代碼。
解決：將Sql語句配置在XXXXmapper.xml文件中與java代碼分離。
3、向sql語句傳參數麻煩，因爲sql語句的where條件不一定，可能多也可能少，佔位符需要和參數一一對應。
解決：Mybatis自動將java對象映射至sql語句，通過statement中的parameterType定義輸入參數的類型。
4、對結果集解析麻煩，sql變化導致解析代碼變化，且解析前需要遍歷，如果能將數據庫記錄封裝成pojo對象解析比較方便。
解決：Mybatis自動將sql執行結果映射至java對象，通過statement中的resultType定義輸出結果的類型。

六、mybatis與hibernate不同

Mybatis和hibernate不同，它不完全是一個ORM框架，因爲MyBatis需要程序員自己編寫Sql語句。mybatis可以通過XML或註解方式靈活配置要運行的sql語句，並將java對象和sql語句映射生成最終執行的sql，最後將sql執行的結果再映射生成java對象。
Mybatis學習門檻低，簡單易學，程序員直接編寫原生態sql，可嚴格控制sql執行性能，靈活度高，非常適合對關係數據模型要求不高的軟件開發，例如互聯網軟件、企業運營類軟件等，因爲這類軟件需求變化頻繁，一但需求變化要求成果輸出迅速。但是靈活的前提是mybatis無法做到數據庫無關性，如果需要實現支持多種數據庫的軟件則需要自定義多套sql映射文件，工作量大。
Hibernate對象/關係映射能力強，數據庫無關性好，對於關係模型要求高的軟件（例如需求固定的定製化軟件）如果用hibernate開發可以節省很多代碼，提高效率。但是Hibernate的學習門檻高，要精通門檻更高，而且怎麼設計O/R映射，在性能和對象模型之間如何權衡，以及怎樣用好Hibernate需要具有很強的經驗和能力纔行。
總之，按照用戶的需求在有限的資源環境下只要能做出維護性、擴展性良好的軟件架構都是好架構，所以框架只有適合纔是最好。

mybatis的基礎入門