Mybatis入門（一）

一. 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編程步驟：

一、 加載數據庫驅動

二、 建立並獲取數據庫連接

三、 建立jdbc statement對象

四、 設置sql語句

五、 設置sql語句中的參數(使用preparedStatement)

六、 經過statement執行sql並獲取結果

七、 對sql執行結果進行解析處理

八、 釋放資源(resultSet、preparedstatement、connection)

 

2.1. jdbc問題總結

一、 數據庫連接建立、釋放頻繁形成系統資源浪費，從而影響系統性能。若是使用數據庫連接池可解決此問題。

二、 Sql語句在代碼中硬編碼，形成代碼不易維護，實際應用中sql變化的可能較大，sql變更須要改變java代碼。

三、 使用preparedStatement向佔有位符號傳參數存在硬編碼，由於sql語句的where條件不必定，可能多也可能少，修改sql還要修改代碼，系統不易維護。

四、 對結果集解析存在硬編碼（查詢列名），sql變化致使解析代碼變化，系統不易維護，若是能將數據庫記錄封裝成pojo對象解析比較方便。

 

三.Mybatis架構

一、 mybatis配置

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

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

二、 經過mybatis環境等配置信息構造SqlSessionFactory即會話工廠

三、 由會話工廠建立sqlSession即會話，操做數據庫須要經過sqlSession進行。

四、 mybatis底層自定義了Executor執行器接口操做數據庫，Executor接口有兩個實現，一個是基本執行器、一個是緩存執行器。

五、 Mapped Statement也是mybatis一個底層封裝對象，它包裝了mybatis配置信息及sql映射信息等。mapper.xml文件中一個sql對應一個Mapped Statement對象，sql的id便是Mapped statement的id。

六、 Mapped Statement對sql執行輸入參數進行定義，包括HashMap、基本類型、pojo，Executor經過Mapped Statement在執行sql前將輸入的java對象映射至sql中，輸入參數映射就是jdbc編程中對preparedStatement設置參數。

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

 

四. Mybatis入門程序

1.1 環境搭建

 mybatis核心包

mybatis依賴包

數據庫驅動包（已添加）

加入配置文件

log4j.properties

# Global logging configuration
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

 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配置將廢除 -->
	<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="root" />
			</dataSource>
		</environment>
	</environments>
</configuration>

1.2 建立entity

Public class User {
	private int id;
	private String username;// 用戶姓名
	private String sex;// 性別
	private Date birthday;// 生日
	private String address;// 地址


get/set……

1.3 SQL映射文件

<?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">
<!-- namespace：命名空間，用於隔離sql，還有一個很重要的做用，後面會講 -->
<mapper namespace="test">
</mapper>

1.4 加載映射文件

1.5 映射文件中編寫sql

<?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">
<!-- namespace：命名空間，用於隔離sql，還有一個很重要的做用，後面會講 -->
<mapper namespace="test">

    <!-- id:statement的id 或者叫作sql的id-->
    <!-- parameterType:聲明輸入參數的類型 -->
    <!-- resultType:聲明輸出結果的類型，應該填寫pojo的全路徑 -->
    <!-- #{}：輸入參數的佔位符，至關於jdbc的？ -->
    <select id="queryUserById" parameterType="int"
        resultType="cn.itcast.mybatis.pojo.User">
        SELECT * FROM `user` WHERE id  = #{id}
    </select>

</mapper>

1.6 測試程序

步驟:

1. 建立SqlSessionFactoryBuilder對象

2. 加載SqlMapConfig.xml配置文件

3. 建立SqlSessionFactory對象

4. 建立SqlSession對象 

5. 執行SqlSession對象執行查詢，獲取結果User

6. 打印結果

7. 釋放資源

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();
    }
}

 

#{}和${}

#{}表示一個佔位符號，經過#{}能夠實現preparedStatement向佔位符中設置值，自動進行java類型和jdbc類型轉換。#{}能夠有效防止sql注入。 #{}能夠接收簡單類型值或pojo屬性值。 若是parameterType傳輸單個簡單類型值，#{}括號中能夠是value或其它名稱。

${}表示拼接sql串，經過${}能夠將parameterType 傳入的內容拼接在sql中且不進行jdbc類型轉換， ${}能夠接收簡單類型值或pojo屬性值，若是parameterType傳輸單個簡單類型值，${}括號中只能是value。

parameterType和resultType

parameterType：指定輸入參數類型，mybatis經過ognl從輸入對象中獲取參數值拼接在sql中。

resultType：指定輸出結果類型，mybatis將sql查詢結果的一行記錄數據映射爲resultType指定類型的對象。若是有多條數據，則分別進行映射，並把對象放到容器List中

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能夠查詢一條或多條記錄。

 

五.Mybatis解決jdbc編程的問題

一、 數據庫鏈接建立、釋放頻繁形成系統資源浪費從而影響系統性能，若是使用數據庫鏈接池可解決此問題。

解決：在SqlMapConfig.xml中配置數據連接池，使用鏈接池管理數據庫連接。

二、 Sql語句寫在代碼中形成代碼不易維護，實際應用sql變化的可能較大，sql變更須要改變java代碼。

解決：將Sql語句配置在XXXXmapper.xml文件中與java代碼分離。

三、 向sql語句傳參數麻煩，由於sql語句的where條件不必定，可能多也可能少，佔位符須要和參數一一對應。

解決：Mybatis自動將java對象映射至sql語句，經過statement中的parameterType定義輸入參數的類型。

四、 對結果集解析麻煩，sql變化致使解析代碼變化，且解析前須要遍歷，若是能將數據庫記錄封裝成pojo對象解析比較方便。

解決：Mybatis自動將sql執行結果映射至java對象，經過statement中的resultType定義輸出結果的類型。

 

六.Hibernate與Mybatis的區別

Mybatis和hibernate不一樣，它不徹底是一個ORM框架，由於MyBatis須要程序員本身編寫Sql語句。mybatis能夠經過XML或註解方式靈活配置要運行的sql語句，並將java對象和sql語句映射生成最終執行的sql，最後將sql執行的結果再映射生成java對象。

Mybatis學習門檻低，簡單易學，程序員直接編寫原生態sql，可嚴格控制sql執行性能，靈活度高，很是適合對關係數據模型要求不高的軟件開發，例如互聯網軟件、企業運營類軟件等，由於這類軟件需求變化頻繁，一但需求變化要求成果輸出迅速。可是靈活的前提是mybatis沒法作到數據庫無關性，若是須要實現支持多種數據庫的軟件則須要自定義多套sql映射文件，工做量大。

Hibernate對象/關係映射能力強，數據庫無關性好，對於關係模型要求高的軟件（例如需求固定的定製化軟件）若是用hibernate開發能夠節省不少代碼，提升效率。可是Hibernate的學習門檻高，要精通門檻更高，並且怎麼設計O/R映射，在性能和對象模型之間如何權衡，以及怎樣用好Hibernate須要具備很強的經驗和能力才行。

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