MyBatis 入門

MyBatis  簡單入門

---

先來總結一下JDBC的缺點，不能說缺點吧，說不足或者問題吧

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

---

所以就有了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對象並返回。

Mybatis架構

1. mybatis配置

SqlMapConfig.xml，此文件作爲mybatis的全局配置文件，配置了mybatis的運行環境等信息。

mapper.xml文件即sql映射文件，文件中配置了操作數據庫的sql語句。此文件需要在SqlMapConfig.xml中加載。

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

Mapped Statement對sql執行輸出結果進行定義，包括HashMap、基本類型、pojo，Executor通過Mapped Statement在執行sql後將輸出結果映射至java對象中，輸出結果映射過程相當於jdbc編程中對結果的解析處理過程。

---

瞭解了架構我們來創建一個簡單的Demo

1.實體類 User

package top.vkiss.mybaties.domain;
public class User {
	private Integer id;
	private String name;
	private String pwd;
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public String getPwd() {
		return pwd;
	}
	public void setPwd(String pwd) {
		this.pwd = pwd;
	}
	@Override
	public String toString() {
		return "User [id=" + id + ", name=" + name + ", pwd=" + pwd + "]";
	}

}

2. dao層接口（不寫實現類）

package top.vkiss.mybaties.dao;
import java.util.List;
import top.vkiss.mybaties.domain.User;
public interface UserDao {
	public void addUser (User user) throws Exception;
	public void updateUser (User user) throws Exception;
	public void delUser (Integer id) throws Exception;
	public List<User> queryUser () throws Exception;
}

    拋異常爲個人開發習慣，可不拋

UserDao.xml  ---dao層操縱數據庫配置文件   

<?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="top.vkiss.mybaties.dao.UserDao">
	<!-- 添加 -->
	<insert id="addUser" parameterType="top.vkiss.mybaties.domain.User">
		<!-- 添加之後可以獲取到主鍵  MYSQL中order:AFTER  ORACLE中:BEFORE  必須有返回值 -->
		<selectKey keyProperty="id" order="AFTER" resultType="int">
			select LAST_INSERT_ID();
		</selectKey>
		insert into t_user (name,pwd) values(#{name},#{pwd})
	</insert>
	<!-- 刪除 -->
	<select id="delUser" parameterType="int">
    	delete from t_user where id=#{1}
	</select>
	<!-- 修改 -->
	<update id="updateUser" parameterType="top.vkiss.mybaties.domain.User">
		update t_user set name=#{name},pwd=#{pwd} where id=#{id}
	</update>
    <!-- 查詢所有 -->
    <select id="queryUser" resultType="top.vkiss.mybaties.domain.User">
		select id,name,pwd from t_user
    </select>
    <!-- 模糊查 -->
    <select id="getUserAllByLike" resultType="top.vkiss.mybaties.domain.User">
		select id,name,pwd from t_user where name like "%"#{value}"%"
            <!-- $符寫法：  LIKE '%${value}%' -->
    </select>
</mapper>

3. service 層 接口

package top.vkiss.mybaties.service;
import java.util.List;
import top.vkiss.mybaties.domain.User;
public interface UserService {
	public void addUser (User user) throws Exception;
	public void updateUser (User user) throws Exception;
	public void delUser (Integer id) throws Exception;
	public List<User> queryUser () throws Exception;
}

service 實現類

package top.vkiss.mybaties.service;
import java.util.List;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import top.vkiss.mybaties.dao.UserDao;
import top.vkiss.mybaties.domain.User;
import top.vkiss.mybaties.utils.MyBatiesUtils;
public class UserServiceImpl implements UserService {
	SqlSessionFactory sF = MyBatiesUtils.getFactory();
	SqlSession session;
	private UserDao ud;
	public UserDao getUd() {
		if (ud==null) {
			session = sF.openSession();	
			ud = session .getMapper(UserDao.class);
		}
		return ud;
	}
	public void setUd(UserDao ud) {
		this.ud = ud;
	}
	@Override
	public List<User> queryUser() throws Exception {
		// TODO Auto-generated method stub
		return getUd().queryUser();
	}
	@Override
	public void addUser(User user) throws Exception {
		// TODO Auto-generated method stub
		getUd().addUser(user);
		session.commit();
	}
	@Override
	public void updateUser(User user) throws Exception {
		// TODO Auto-generated method stub
		getUd().updateUser(user);
	}
	@Override
	public void delUser(Integer id) throws Exception {
		// TODO Auto-generated method stub
		getUd().delUser(id);
	}

}

4. Mybatis 自定義工具類，用於讀取配置文件，獲取 sqlSessionFactory，融合spring後可交給spring管理

package top.vkiss.mybaties.utils;
import java.io.IOException;
import java.io.InputStream;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MyBatiesUtils {
	private static SqlSessionFactory sqlSessionFactory;
	static{
    	InputStream is=null;
		try {
			is = Resources.getResourceAsStream("SqlMapConfig.xml");
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		sqlSessionFactory=new SqlSessionFactoryBuilder().build(is);
    }
	public static SqlSessionFactory getFactory(){
		return sqlSessionFactory;
	}
	
}

 5. log4j.properties  -配置文件，測試時用於查看日誌

# Global logging configuration
#\u5728\u5f00\u53d1\u73af\u5883\u4e0b\u65e5\u5fd7\u7ea7\u522b\u8981\u8bbe\u7f6e\u6210DEBUG\uff0c\u751f\u4ea7\u73af\u5883\u8bbe\u7f6e\u6210info\u6216error
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

log4j.rootLogger=DEBUG, stdout

DEBUDG值， 在項目上線時修改

6.SqlMapConfig.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>
	<!--   將來下面的配置交給spring接管 -->
	<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/springhibernate" />
				<property name="username" value="root" />
				<property name="password" value="root" />
			</dataSource>
		</environment>
	</environments>
	<!-- 加載映射文件 -->
	<mappers>
		<mapper resource="top/vkiss/mybaties/dao/UserDao.xml"/>
	</mappers>
</configuration>

7.省略 action 層 直接進行測試

package top.vkiss.mybaties.test;
import java.util.List;
import top.vkiss.mybaties.domain.User;
import top.vkiss.mybaties.service.UserService;
import top.vkiss.mybaties.service.UserServiceImpl;
public class TEST {
	public static void main(String[] args) throws Exception {
		UserService usc = new UserServiceImpl();
		User user = new User();
		user.setName("小周");
		user.setPwd("000");
		usc.addUser(user);
		List<User> list = usc.queryUser();
		System.out.println(list);
	}
}

打印結果

DEBUG [main] - Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - PooledDataSource forcefully closed/removed all connections.
DEBUG [main] - Opening JDBC Connection
DEBUG [main] - Created connection 1448061896.
DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@564fabc8]
DEBUG [main] - ==>  Preparing: insert into t_user (name,pwd) values(?,?) 
DEBUG [main] - ==> Parameters: 小周(String), 000(String)
DEBUG [main] - <==    Updates: 1
DEBUG [main] - ==>  Preparing: select LAST_INSERT_ID(); 
DEBUG [main] - ==> Parameters: 
DEBUG [main] - <==      Total: 1
DEBUG [main] - Committing JDBC Connection [com.mysql.jdbc.JDBC4Connection@564fabc8]
DEBUG [main] - ==>  Preparing: select id,name,pwd from t_user 
DEBUG [main] - ==> Parameters: 
DEBUG [main] - <==      Total: 19
[User [id=0, name=關勝, pwd=666], User [id=10, name=8888, pwd=88866], User [id=11, name=關勝, pwd=666], User [id=13, name=關勝, pwd=666], User [id=14, name=關勝, pwd=666], User [id=19, name=關羽, pwd=666], User [id=20, name=關勝, pwd=666], User [id=21, name=關勝, pwd=666], User [id=22, name=關勝, pwd=666], User [id=23, name=關勝, pwd=666], User [id=25, name=haha, pwd=heihei], User [id=26, name=你好, pwd=888], User [id=27, name=你好, pwd=888], User [id=28, name=你好, pwd=888], User [id=29, name=你好, pwd=888], User [id=31, name=小周, pwd=null], User [id=32, name=小周, pwd=000], User [id=33, name=小周, pwd=000], User [id=34, name=小周, pwd=000]]

注意:

版本問題

          jdk 1.8   

          mybatis 3.2.7

jar包

asm-3.3.1.jar
cglib-2.2.2.jar
commons-logging-1.1.1.jar
javassist-3.17.1-GA.jar
log4j-1.2.17.jar
log4j-api-2.0-rc1.jar
log4j-core-2.0-rc1.jar
mybatis-3.2.7.jar
mysql-connector-java-5.1.7-bin.jar
slf4j-api-1.7.5.jar
slf4j-log4j12-1.7.5.jar

---

---

---

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需要具有很強的經驗和能力才行。

總之，按照用戶的需求在有限的資源環境下只要能做出維護性、擴展性良好的軟件架構都是好架構，所以框架只有適合纔是最好。