MyBatis作為一個輕量的SQL映射框架修档,確實很簡單,但是知識點挺多祝钢,實際使用中還是會有時想不起來某個標簽該怎么寫比规,所以整理了這篇文章,以備查詢拦英。由于MyBatis如此簡單蜒什,使得這一篇文章基本把實際使用中常碰到的事情都涵蓋了,包括:
- MyBatis中的一些概念
- MyBatis包含的內(nèi)容
- SQL映射
- 動態(tài)SQL
一疤估、 MyBatis中的一些概念
1. MyBatis
是個什么東西
在使用MyBatis的項目里灾常,日志中往往會出現(xiàn)很多拼接SQL語句的log,這其實說明了MyBatis底層還是使用JDBC來實現(xiàn)的铃拇。在JDBC的基礎上钞瀑,為了性能考慮,所有的語句都是基于SqlSession
慷荔。顧名思義雕什,維護這個類的實例其實就是維護了一個對于某個數(shù)據(jù)庫的連接的會話,在這個會話里可以有緩存啊什么之類的显晶。
2. mapper
接口是怎么映射成SQL語句的
目前多數(shù)開發(fā)者還是會使用XML來進行MyBatis的配置贷岸,包括MyBatis的核心配置和SQL映射配置。其實和注解一樣磷雇,XML本身只不過是一個元數(shù)據(jù)的載體偿警,最終起作用的還是MyBatis的核心類。其中有這樣幾個比較重要的:
-
SqlSessionFactoryBuilder
倦春,用來創(chuàng)建SqlSessionFactory
的實例户敬,之后就沒有用了落剪,其生命周期只是在初始化的時候有作用睁本。 -
SqlSessionFactory
,MyBatis最基礎的類忠怖,用來創(chuàng)建會話(即SqlSession
的實例)呢堰,其生命周期與整個系統(tǒng)的生命周期相同,在系統(tǒng)運行的任何時候都可以使用它查詢到當前數(shù)據(jù)庫的配置信息等凡泣。 -
SqlSession
枉疼,真正的和數(shù)據(jù)庫之間的會話皮假,線程不安全,所以其生命周期和使用它的線程相同骂维。 - 各種
Mapper
惹资,承載了實際的業(yè)務邏輯,其生命周期比較短航闺,由SqlSession
創(chuàng)建褪测。
3. Spring環(huán)境中MyBatis的初始化過程
實際情況中MyBatis往往是在Spring的環(huán)境中使用的,MyBatis本身并不依賴Spring潦刃,但是使用Spring可以極大的提高開發(fā)效率侮措,由于Spring進行了控制反轉(zhuǎn),所以其中MyBatis的初始化過程和正常過程稍稍有些不同:
- Spring發(fā)現(xiàn)需要創(chuàng)建
SqlSessionFactory
實例乖杠,會在classpath下找到MyBatis的核心配置文件分扎,使用它來初始化一個SqlSessionFactory
實例。當然胧洒,這一步完全可以使用代碼來完成畏吓,或者使用注解,就更加清晰明了卫漫。 - 往往mapper類也會作為bean注入到代碼中去的庵佣,那么Spring會使用上一步中的
SqlSessionFactory
實例來創(chuàng)建SqlSession
的實例。 - 然后再使用
SqlSession
嘗試創(chuàng)建各個mapper對象汛兜。 - 于此同時巴粪,MyBatis會掃描classpath下的mapper映射XML文件(此路徑可以自定義),對于每一個mapper接口粥谬,它的「類全名」會作為命名空間肛根,來和映射文件中的mapper標簽進行匹配。
- 對于每一個映射文件中的一個執(zhí)行語句標簽(如select漏策、delete)派哲,MyBatis會把他們映射到
SqlSession
的方法上,創(chuàng)建mapper接口的一個實現(xiàn)類掺喻。 - 如果mapper接口和其映射文件一一匹配芭届,則bean創(chuàng)建成功。
二感耙、MyBatis包含的內(nèi)容
MyBatis本身就是一個簡單的ORM框架褂乍,提供了SQL語句到方法、關系型數(shù)據(jù)表到對象的映射即硼。實際使用中與開發(fā)者相關的有兩個東西:
- MyBatis核心配置
緩存逃片、數(shù)據(jù)源、日志等關系到MyBatis其本身行為的一些配置只酥。 - mapper接口的映射
針對于具體業(yè)務邏輯的SQL映射褥实。
三呀狼、SQL映射
MyBatis也可以使用注解來實現(xiàn)映射,對于簡單的語句损离,使用注解可能會更加清晰簡單哥艇,但是其真正強大的地方還是XML。
1. select
屬性 | 描述 |
---|---|
id | 此命名空間內(nèi)的標識符 |
parameterType | 參數(shù)的類的全名或者alias僻澎,可選她奥。默認為空。 |
parameterMap | Deprecated |
resultType | 返回結(jié)果的類型全名或alias怎棱,如果結(jié)果是集合哩俭,此類型表示的是集合的成員類型。 |
resultMap | 使用指定的resultMap來映射結(jié)果集拳恋。resultMap 和 resultType只能二選一凡资。 |
flushCache | 如果為true,每次調(diào)用谬运,一級緩存和二級緩存都會回寫隙赁。select語句中默認為false。 |
useCache | 如果為true梆暖,結(jié)果將在二級緩存中緩存伞访。select語句中默認為true |
timeout | 設置超時,若超時則拋出異常轰驳。 |
fetchSize | 嘗試在獲取數(shù)據(jù)時分批獲取厚掷。 |
statementType | STATEMENT,PREPARED或者CALLABLE. 分別對應JDBC中的Statement级解,PreparedStatement和CallableStatement respectively冒黑。默認PREPARED. |
resultSetType | FORWARD_ONLY,SCROLL_SENSITIVE或者SCROLL_INSENSITIVE勤哗。默認為空抡爹。 |
databaseId | 使用特定的databaseIdProvider |
resultOrdered | 嵌套查詢時使用。 |
resultSets | 多返回集合時使用芒划。 |
2. 修改語句(insert冬竟,update,DELETE)
這3種語句的屬性基本和上邊select的一樣民逼,INSERT和UPDATE的語句有幾個特殊的屬性如下:
屬性 | 描述 |
---|---|
useGeneratedKeys | 將使用JDBC的getGeneratedKeys方法來獲取主鍵的值泵殴。默認為false。 |
keyProperty | 主鍵缴挖。MyBatis會將生成的主鍵賦給這個列袋狞。聯(lián)合主鍵使用逗號隔開。 |
keyColumn | 特定數(shù)據(jù)庫需要使用映屋。 |
3. SQl語句段(sql標簽)
<sql>標簽可以定義一段sql語句段苟鸯,可以在其他語句中引入使用。sql標簽可以包含參數(shù)棚点。示例如下:
<sql id="userColumns">${alias}.id,${alias}.username,${alias}.password </sql>
<select id="selectUsers" resultType="map">
select
<include refid="userColumns"><property name="alias" value="t1"/></include>,
<include refid="userColumns"><property name="alias" value="t2"/></include>
from some_table t1
cross join some_table t2
</select>
參數(shù)(property)也可以在refid或者include進來的sql中使用早处。示例如下:
<sql id="sometable">
${prefix}Table
</sql>
<sql id="someinclude">
from
<include refid="${include_target}"/>
</sql>
<select id="select" resultType="map">
select
field1, field2, field3
<include refid="someinclude">
<property name="prefix" value="Some"/>
<property name="include_target" value="sometable"/>
</include>
</select>
4. #{}
和${}
的區(qū)別
#{}
在底層實現(xiàn)上使用?
做占位符來生成PreparedStatement,然后將參數(shù)傳入瘫析,大多數(shù)情況都應使用這個砌梆,它更快、更安全贬循。${}
將傳入的數(shù)據(jù)直接顯示生成在sql中咸包。如:order by ${user_id},如果傳入的值是111,那么解析成sql時的值為order by 111, 如果傳入的值是id杖虾,則解析成的sql為order by id.
5. 類型別名
什么地方都少不了這種小技巧烂瘫,可以讓你少打很多字。
<typeAlias type="com.someapp.model.User" alias="User"/>
6. ResultMap
官方文檔上說這個特性是整個MyBatis中最強大的特性(沒有之一)奇适。其實它做的就是映射結(jié)果集坟比。
MyBatis底層使用JDBC,所以查詢出來的結(jié)果是ResultSet嚷往,如果resultType是一個對象葛账,MyBatis底層就會創(chuàng)建一個resultMap,并根據(jù)字段名一一對應上這個對象皮仁。如果你有一個查詢籍琳,它的結(jié)果集非常復雜,可以使用resultMap來做映射贷祈。
cache和cach-ref
使用cache標簽在映射文件內(nèi)(某命名空間內(nèi))實現(xiàn)二級緩存巩割,其所有屬性都有缺省值,所以單單一個標簽就可以生效付燥。cach-ref可以在兩個映射文件之間共享緩存
<cache
eviction="LRU"http://緩存移除策略
flushInterval="60000"http://默認不設置宣谈,不定時刷新
size="1024"
readOnly="false"/>
四、動態(tài)SQL
1. if
條件判斷键科,參數(shù)為test
2. choose (嵌套when闻丑,otherwise)
多選一,參數(shù)為test
3. trim (where勋颖,set)
- trim標簽可以定制其他標簽嗦嗡,并且去頭去尾;
- where標簽會自動生成where語句饭玲,并且可以去除頭部的and或者or侥祭;
- set標簽可以自動生成set語句,并且可以去除尾部的逗號。
4. foreach
循環(huán)集合輸出矮冬,可以循環(huán)數(shù)組谈宛,Iterable對象,或者Map胎署,如果是Map吆录,則index會是key。
<foreach item="item" index="index" collection="list"
open="(" separator="," close=")">
#{item}
</foreach>
5. bind
聲明一個使用OGNL表達式生成的變量琼牧,在sql語句中使用恢筝。