簡(jiǎn)介
MyBatis的前身叫iBatis略就,本是apache的一個(gè)開(kāi)源項(xiàng)目, 2010年這個(gè)項(xiàng)目由apache software foundation 遷移到了google code,并且改名為MyBatis誊薄。MyBatis是支持普通SQL查詢羡滑,存儲(chǔ)過(guò)程和高級(jí)映射的優(yōu)秀持久層框架弹澎。MyBatis消除了幾乎所有的JDBC代碼和參數(shù)的手工設(shè)置以及結(jié)果集的檢索绞铃。MyBatis使用簡(jiǎn)單的XML或注解用于配置和原始映射,將接口和Java的POJOs(Plan Old Java Objects囱嫩,普通的Java對(duì)象)映射成數(shù)據(jù)庫(kù)中的記錄恃疯。
Mybatis的功能架構(gòu)分為三層(圖片借用了百度百科):
1)API接口層:提供給外部使用的接口API,開(kāi)發(fā)人員通過(guò)這些本地API來(lái)操縱數(shù)據(jù)庫(kù)墨闲。接口層一接收到調(diào)用請(qǐng)求就會(huì)調(diào)用數(shù)據(jù)處理層來(lái)完成具體的數(shù)據(jù)處理今妄。
2)數(shù)據(jù)處理層:負(fù)責(zé)具體的SQL查找、SQL解析鸳碧、SQL執(zhí)行和執(zhí)行結(jié)果映射處理等盾鳞。它主要的目的是根據(jù)調(diào)用的請(qǐng)求完成一次數(shù)據(jù)庫(kù)操作。
3)基礎(chǔ)支撐層:負(fù)責(zé)最基礎(chǔ)的功能支撐瞻离,包括連接管理腾仅、事務(wù)管理、配置加載和緩存處理琐脏,這些都是共用的東西攒砖,將他們抽取出來(lái)作為最基礎(chǔ)的組件。為上層的數(shù)據(jù)處理層提供最基礎(chǔ)的支撐日裙。
快速入門(mén)
Mybatis的整體流程圖
SqlSessionFactoryBuilder
每一個(gè)MyBatis的應(yīng)用程序的入口是SqlSessionFactoryBuilder,它的作用是通過(guò)XML配置文件創(chuàng)建Configuration對(duì)象(當(dāng)然也可以在程序中自行創(chuàng)建)惰蜜,然后通過(guò)build方法創(chuàng)建SqlSessionFactory對(duì)象昂拂。沒(méi)有必要每次訪問(wèn)Mybatis就創(chuàng)建一次SqlSessionFactoryBuilder,通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了抛猖。示例程序如下:
private static SqlSessionFactoryBuilder sqlSessionFactoryBuilder;
private static SqlSessionFactory sqlSessionFactory;
private static void init() throws IOException {
String resource = "mybatis-config.xml";
Reader reader = Resources.getResourceAsReader(resource);
sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
sqlSessionFactory = sqlSessionFactoryBuilder.build(reader);
}
SqlSessionFactory
SqlSessionFactory對(duì)象由SqlSessionFactoryBuilder創(chuàng)建格侯。它的主要功能是創(chuàng)建SqlSession對(duì)象,和SqlSessionFactoryBuilder對(duì)象一樣财著,沒(méi)有必要每次訪問(wèn)Mybatis就創(chuàng)建一次SqlSessionFactory联四,通常的做法是創(chuàng)建一個(gè)全局的對(duì)象就可以了。SqlSessionFactory對(duì)象一個(gè)必要的屬性是Configuration對(duì)象,它是保存Mybatis全局配置的一個(gè)配置對(duì)象撑教,通常由SqlSessionFactoryBuilder從XML配置文件創(chuàng)建朝墩。這里給出一個(gè)簡(jiǎn)單的示例:
<?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="org.iMybatis.abc.dao.UserDao" alias="UserDao" />
<typeAlias type="org.iMybatis.abc.dto.UserDto" alias="UserDto" />
</typeAliases>
<!-- 配置環(huán)境變量 -->
<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/iMybatis?characterEncoding=GBK" />
<property name="username" value="iMybatis" />
<property name="password" value="iMybatis" />
</dataSource>
</environment>
</environments>
<!-- 配置mappers -->
<mappers>
<mapper resource="org/iMybatis/abc/dao/UserDao.xml" />
</mappers>
</configuration>
要注意XML頭部的聲明,需要用來(lái)驗(yàn)證XML文檔正確性伟姐。typeAliases 元素是包含所有typeAlias(別名)的列表收苏,別名用來(lái)替換完整類名亿卤,這樣在需要完整類名的地方就可以用別名來(lái)代替。environment元素體中包含對(duì)事務(wù)管理和連接池的環(huán)境配置鹿霸。mappers元素是包含所有mapper(映射器)的列表排吴,這些mapper的XML文件包含SQL代碼和映射定義信息。當(dāng)然懦鼠,在XML配置文件中還有很多可以配置的钻哩,上面的示例指出的則是最關(guān)鍵的部分,其他配置請(qǐng)參考Mybatis的官方文檔肛冶。
SqlSession
SqlSession對(duì)象的主要功能是完成一次數(shù)據(jù)庫(kù)的訪問(wèn)和結(jié)果的映射憋槐,它類似于數(shù)據(jù)庫(kù)的session概念,由于不是線程安全的淑趾,所以SqlSession對(duì)象的作用域需限制方法內(nèi)阳仔。SqlSession的默認(rèn)實(shí)現(xiàn)類是DefaultSqlSession,它有兩個(gè)必須配置的屬性:Configuration和Executor扣泊。Configuration前文已經(jīng)描述這里不再多說(shuō)近范。SqlSession對(duì)數(shù)據(jù)庫(kù)的操作都是通過(guò)Executor來(lái)完成的,Executor的具體功能在下一小節(jié)在描述延蟹。
到目前為止评矩,我們看到的都是mybatis的流程,我們的應(yīng)用程序在什么地方插入到這個(gè)流程中并獲得我們想要的結(jié)果呢阱飘?就是SqlSession這里斥杜。SqlSession有一個(gè)重要的方法getMapper,顧名思義沥匈,這個(gè)方式是用來(lái)獲取Mapper對(duì)象的蔗喂。什么是Mapper對(duì)象?根據(jù)Mybatis的官方手冊(cè)高帖,應(yīng)用程序除了要初始并啟動(dòng)Mybatis之外缰儿,還需要定義一些接口,接口里定義訪問(wèn)數(shù)據(jù)庫(kù)的方法散址,存放接口的包路徑下需要放置同名的XML配置文件乖阵。SqlSession的getMapper方法是聯(lián)系應(yīng)用程序和Mybatis紐帶,應(yīng)用程序訪問(wèn)getMapper時(shí)预麸,Mybatis會(huì)根據(jù)傳入的接口類型和對(duì)應(yīng)的XML配置文件生成一個(gè)代理對(duì)象瞪浸,這個(gè)代理對(duì)象就叫Mapper對(duì)象。應(yīng)用程序獲得Mapper對(duì)象后吏祸,就應(yīng)該通過(guò)這個(gè)Mapper對(duì)象來(lái)訪問(wèn)Mybatis的SqlSession對(duì)象对蒲,這樣就達(dá)到里插入到Mybatis流程的目的。示例代碼如下:
SqlSession session= sqlSessionFactory.openSession();
UserDao userDao = session.getMapper(UserDao.class);
UserDto user = new UserDto();
user.setUsername("iMybatis");
List<UserDto> users = userDao.queryUsers(user);
對(duì)應(yīng)的接口:
public interface UserDao {
public List<UserDto> queryUsers(UserDto user) throws Exception;
}
對(duì)應(yīng)的配置文件:
<?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="org.iMybatis.abc.dao.UserDao">
<select id="queryUsers" parameterType="UserDto" resultType="UserDto"
useCache="false">
<![CDATA[
select * from t_user t where t.username = #{username}
]]>
</select>
</mapper>
Executor
Executor對(duì)象在創(chuàng)建Configuration對(duì)象的時(shí)候創(chuàng)建,并且緩存在Configuration對(duì)象里齐蔽。Executor對(duì)象的主要功能是調(diào)用StatementHandler訪問(wèn)數(shù)據(jù)庫(kù)两疚,并將查詢結(jié)果存入緩存中(如果配置了緩存的話)。
StatementHandler
StatementHandler是真正訪問(wèn)數(shù)據(jù)庫(kù)的地方含滴,并調(diào)用ResultSetHandler處理查詢結(jié)果诱渤。
ResultSetHandler
處理查詢結(jié)果。