一、安裝
使用MyBatis,首先需要下載其jar包姐扮,然后將jar包導(dǎo)入lib中即可拳缠,下載地址:github.com/mybatis/mybatis-3/releases
如果使用Maven來構(gòu)建項(xiàng)目抚芦,則需將下面的 dependency 代碼置于 pom.xml 文件中:
<dependency>
? ? ? ? <groupId>org.mybatis<groupId>
? ? ? <artifactId>mybatis</artifactId>
? ? ? ?<version>x.x.x</version>
</dependency>
二、XML 中構(gòu)建 SqlSessionFctory并獲取SqlSession
每個基于 MyBatis 的應(yīng)用都是以一個 SqlSessionFactory 的實(shí)例為中心的崩泡。SqlSessionFactory 的實(shí)例可以通過 SqlSessionFactoryBuilder 獲得禁荒。而 SqlSessionFactoryBuilder 則可以從 XML 配置文件或一個預(yù)先定制的 Configuration 的實(shí)例構(gòu)建出 SqlSessionFactory 的實(shí)例。
從 XML 文件中構(gòu)建 SqlSessionFactory 的實(shí)例非常簡單允华,建議使用類路徑下的資源文件進(jìn)行配置圈浇。但是也可以使用任意的輸入流(InputStream)實(shí)例,包括字符串形式的文件路徑或者 file:// 的 URL 形式的文件路徑來配置靴寂。MyBatis 包含一個名叫 Resources 的工具類磷蜀,它包含一些實(shí)用方法,可使從 classpath 或其他位置加載資源文件更加容易百炬。
例:
String resource="mybatis/example/mybatis-config.xml";
InputStream inputStream=Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
SqlSession session=sqlSessionFactory.openSession();
XML 配置文件(configuration XML)中包含了對 MyBatis 系統(tǒng)的核心設(shè)置褐隆,包含獲取數(shù)據(jù)庫連接實(shí)例的數(shù)據(jù)源(DataSource)和決定事務(wù)作用域和控制方式的事務(wù)管理器(TransactionManager)。XML 配置文件的詳細(xì)內(nèi)容后面再探討剖踊,這里先給出一個簡單的示例:
當(dāng)然庶弃,還有很多可以在XML 文件中進(jìn)行配置,上面的示例指出的則是最關(guān)鍵的部分德澈。要注意 XML 頭部的聲明歇攻,用來驗(yàn)證 XML 文檔正確性。environment 元素體中包含了事務(wù)管理和連接池的配置梆造。mappers 元素則是包含一組 mapper 映射器(這些 mapper 的 XML 文件包含了 SQL 代碼和映射定義信息)缴守。
三、獲取SqlSession寫映射SQL語句
(一)、SqlSession 完全包含了面向數(shù)據(jù)庫執(zhí)行 SQL 命令所需的所有方法屡穗。你可以通過 SqlSession 實(shí)例來直接執(zhí)行已映射的 SQL 語句贴捡,例:
SqlSession session=sqlSessionFactory.openSession();
session.selectOne("com.csl.dao.CslActiveMapper.getActive",rowNo);
(二)、XML映射文件CslActiveMapper.xml實(shí)例:
(三)村砂、將映射文件放到mybatis-config.xml下:
所有的寫SQL語句的xml映射文件都放在mybatis-config.xml文件的<mappers></mappers>下烂斋。至此這樣一個簡單的MyBatis框架就搭建起了
四、作用域(Scope)和生命周期
(一)础废、SqlSessionFactoryBuilder
這個類可以被實(shí)例化汛骂、使用和丟棄,一旦創(chuàng)建了 SqlSessionFactory色迂,就不再需要它了香缺。因此 SqlSessionFactoryBuilder 實(shí)例的最佳作用域是方法作用域(也就是局部方法變量)。你可以重用 SqlSessionFactoryBuilder 來創(chuàng)建多個 SqlSessionFactory 實(shí)例歇僧,但是最好還是不要讓其一直存在以保證所有的 XML 解析資源開放給更重要的事情。
(二)锋拖、SqlSessionFactory
SqlSessionFactory 一旦被創(chuàng)建就應(yīng)該在應(yīng)用的運(yùn)行期間一直存在诈悍,沒有任何理由對它進(jìn)行清除或重建。使用 SqlSessionFactory 的最佳實(shí)踐是在應(yīng)用運(yùn)行期間不要重復(fù)創(chuàng)建多次兽埃,多次重建 SqlSessionFactory 被視為一種代碼“壞味道(bad smell)”侥钳。因此 SqlSessionFactory 的最佳作用域是應(yīng)用作用域。有很多方法可以做到柄错,最簡單的就是使用單例模式或者靜態(tài)單例模式舷夺。
(三)、SqlSession
每個線程都應(yīng)該有它自己的 SqlSession 實(shí)例售貌。SqlSession 的實(shí)例不是線程安全的给猾,因此是不能被共享的,所以它的最佳的作用域是請求或方法作用域颂跨。絕對不能將 SqlSession 實(shí)例的引用放在一個類的靜態(tài)域敢伸,甚至一個類的實(shí)例變量也不行。也絕不能將 SqlSession 實(shí)例的引用放在任何類型的管理作用域中恒削,比如 Servlet 架構(gòu)中的 HttpSession池颈。如果你現(xiàn)在正在使用一種 Web 框架,要考慮 SqlSession 放在一個和 HTTP 請求對象相似的作用域中钓丰。換句話說躯砰,每次收到的 HTTP 請求,就可以打開一個 SqlSession携丁,返回一個響應(yīng)琢歇,就關(guān)閉它。這個關(guān)閉操作是很重要的,你應(yīng)該把這個關(guān)閉操作放到 finally 塊中以確保每次都能執(zhí)行關(guān)閉矿微。下面的示例就是一個確保 SqlSession 關(guān)閉的標(biāo)準(zhǔn)模式:
SqlSession session = sqlSessionFactory.openSession();
try{
}catch{
}finally{
session.close();
}
在你的所有的代碼中一致性地使用這種模式來保證所有數(shù)據(jù)庫資源都能被正確地關(guān)閉痕慢。