前言
MyBatis是基于“數(shù)據(jù)庫(kù)結(jié)構(gòu)不可控”的思想建立的,也就是我們希望數(shù)據(jù)庫(kù)遵循第三范式或BCNF,但實(shí)際事與愿違,那么結(jié)果集映射就是MyBatis為我們提供這種理想與現(xiàn)實(shí)間轉(zhuǎn)換的手段了,而resultMap就是結(jié)果集映射的配置標(biāo)簽了。?
在深入ResultMap標(biāo)簽前,我們需要了解從SQL查詢結(jié)果集到JavaBean或POJO實(shí)體的過(guò)程。
從SQL查詢結(jié)果到領(lǐng)域模型實(shí)體
-
通過(guò)JDBC查詢得到ResultSet對(duì)象
-
遍歷ResultSet對(duì)象并將每行數(shù)據(jù)暫存到HashMap實(shí)例中,以結(jié)果集的字段名或字段別名為鍵,以字段值為值
-
根據(jù)ResultMap標(biāo)簽的type屬性通過(guò)反射實(shí)例化領(lǐng)域模型
-
根據(jù)ResultMap標(biāo)簽的type屬性和id、result等標(biāo)簽信息將HashMap中的鍵值對(duì),填充到領(lǐng)域模型實(shí)例中并返回
一、resultMap
1、屬性說(shuō)明
-
id屬性 ,resultMap標(biāo)簽的標(biāo)識(shí)。
-
type屬性 ,返回值的全限定類名,或類型別名。
-
autoMapping屬性 ,值范圍true(默認(rèn)值)|false, 設(shè)置是否啟動(dòng)自動(dòng)映射功能,自動(dòng)映射功能就是自動(dòng)查找與字段名小寫同名的屬性名,并調(diào)用setter方法。而設(shè)置為false后,則需要在resultMap內(nèi)明確注明映射關(guān)系才會(huì)調(diào)用對(duì)應(yīng)的setter方法。
2、基本作用:建立SQL查詢結(jié)果字段與實(shí)體屬性的映射關(guān)系?
示例1:通過(guò)setter構(gòu)造領(lǐng)域模型
public?class?EStudent{??private?long?id;??private?String?name;??private?int?age;??//?getter,setter方法??/** ???*?必須提供一個(gè)無(wú)參數(shù)的構(gòu)造函數(shù) ???*/??public?EStudent(){} }
<select> ??SELECT?ID,?Name,?Age ????FROM?TStudent </select><resultmap> ??<id></id> ??<result></result> ??<result></result></resultmap>
子元素說(shuō)明:
-
id元素 ,用于設(shè)置主鍵字段與領(lǐng)域模型屬性的映射關(guān)系
-
result元素 ,用于設(shè)置普通字段與領(lǐng)域模型屬性的映射關(guān)系
id、result語(yǔ)句屬性配置細(xì)節(jié):
屬性 | 描述 |
---|---|
property | 需要映射到JavaBean 的屬性名稱。 |
column | 數(shù)據(jù)表的列名或者標(biāo)簽別名。 |
javaType | 一個(gè)完整的類名,或者是一個(gè)類型別名。如果你匹配的是一個(gè)JavaBean,那MyBatis 通常會(huì)自行檢測(cè)到。然后,如果你是要映射到一個(gè)HashMap,那你需要指定javaType 要達(dá)到的目的。 |
jdbcType | 數(shù)據(jù)表支持的類型列表。這個(gè)屬性只在insert,update 或delete 的時(shí)候針對(duì)允許空的列有用。JDBC 需要這項(xiàng),但MyBatis 不需要。如果你是直接針對(duì)JDBC 編碼,且有允許空的列,而你要指定這項(xiàng)。 |
typeHandler | 使用這個(gè)屬性可以覆寫類型處理器。這項(xiàng)值可以是一個(gè)完整的類名,也可以是一個(gè)類型別名。 |
示例2:通過(guò)構(gòu)造函數(shù)構(gòu)造領(lǐng)域模型
<select> ??SELECT?ID,?Name,?Age ????FROM?TStudent</select><resultmap>??<constructor>????<idarg></idarg>????<arg></arg>????<arg></arg>??</constructor></resultmap>
子元素說(shuō)明:
-
constructor元素 ,指定使用指定參數(shù)列表的構(gòu)造函數(shù)來(lái)實(shí)例化領(lǐng)域模型。注意:其子元素順序必須與參數(shù)列表順序?qū)?yīng)
-
idArg子元素 ,標(biāo)記該入?yún)橹麈I
-
arg子元素 ,標(biāo)記該入?yún)槠胀ㄗ侄?主鍵使用該子元素設(shè)置也是可以的)
3、一對(duì)一關(guān)系、一對(duì)多關(guān)系查詢
?注意:在采用嵌套結(jié)果的方式查詢一對(duì)一、一對(duì)多關(guān)系時(shí),必須要通過(guò)resultMap下的id或result標(biāo)簽來(lái)顯式設(shè)置屬性/字段映射關(guān)系,否則在查詢多條記錄時(shí)會(huì)僅僅返回最后一條記錄的情況。
association聯(lián)合
聯(lián)合元素用來(lái)處理“一對(duì)一”的關(guān)系。需要指定映射的Java實(shí)體類的屬性,屬性的javaType(通常MyBatis 自己會(huì)識(shí)別)。對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱。如果想覆寫的話返回結(jié)果的值,需要指定typeHandler。?
不同情況需要告訴MyBatis 如何加載一個(gè)聯(lián)合。MyBatis 可以用兩種方式加載:
-
select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類型。較靈活;
-
resultsMap: 使用一個(gè)嵌套的結(jié)果映射來(lái)處理通過(guò)join查詢結(jié)果集,映射成Java實(shí)體類型。
例如,一個(gè)班級(jí)對(duì)應(yīng)一個(gè)班主任。?
首先定義好班級(jí)中的班主任?private TeacherEntity teacherEntity;
使用select實(shí)現(xiàn)聯(lián)合?
例:班級(jí)實(shí)體類中有班主任的屬性,通過(guò)聯(lián)合在得到一個(gè)班級(jí)實(shí)體時(shí),同時(shí)映射出班主任實(shí)體。?
這樣可以直接復(fù)用在TeacherMapper.xml文件中定義好的查詢teacher根據(jù)其ID的select語(yǔ)句。而且不需要修改寫好的SQL語(yǔ)句,只需要直接修改resultMap即可。
ClassMapper.xml文件部分內(nèi)容:
<resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<association></association>?? </resultmap>?? <select>?? ????SELECT?*?FROM?CLASS_TBL?CT?? ????WHERE?CT.CLASS_ID?=?#{classID};?? </select>
TeacherMapper.xml文件部分內(nèi)容:
<resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<result></result>?? ????<result></result>?? ????<result></result>?? </resultmap>?? <select>?? ????SELECT?*?? ??????FROM?TEACHER_TBL?TT?? ?????WHERE?TT.TEACHER_ID?=?#{teacherID}?? </select>
使用resultMap實(shí)現(xiàn)聯(lián)合?
與上面同樣的功能,查詢班級(jí),同時(shí)查詢器班主任。需在association中添加resultMap(在teacher的xml文件中定義好的),新寫sql(查詢班級(jí)表left join教師表),不需要teacher的select。
修改ClassMapper.xml文件部分內(nèi)容:
<resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<association></association>?? </resultmap>?? <select>?? ????SELECT?*?? ??????FROM?CLASS_TBL?CT?LEFT?JOIN?TEACHER_TBL?TT?ON?CT.TEACHER_ID?=?TT.TEACHER_ID?? ?????WHERE?CT.CLASS_ID?=?#{classID};?? </select>
其中的teacherResultMap請(qǐng)見上面TeacherMapper.xml文件部分內(nèi)容中。
collection聚集
聚集元素用來(lái)處理“一對(duì)多”的關(guān)系。需要指定映射的Java實(shí)體類的屬性,屬性的javaType(一般為ArrayList);列表中對(duì)象的類型ofType(Java實(shí)體類);對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱;?
不同情況需要告訴MyBatis 如何加載一個(gè)聚集。MyBatis 可以用兩種方式加載:?
1. select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類型。較靈活;?
2. resultsMap: 使用一個(gè)嵌套的結(jié)果映射來(lái)處理通過(guò)join查詢結(jié)果集,映射成Java實(shí)體類型。
例如,一個(gè)班級(jí)有多個(gè)學(xué)生。?
首先定義班級(jí)中的學(xué)生列表屬性:private List
使用select實(shí)現(xiàn)聚集?
用法和聯(lián)合很類似,區(qū)別在于,這是一對(duì)多,所以一般映射過(guò)來(lái)的都是列表。所以這里需要定義javaType為ArrayList,還需要定義列表中對(duì)象的類型ofType,以及必須設(shè)置的select的語(yǔ)句名稱(需要注意的是,這里的查詢student的select語(yǔ)句條件必須是外鍵classID)。
ClassMapper.xml文件部分內(nèi)容:
<resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<association></association>?? ????<collection></collection>?? </resultmap>?? <select>?? ????SELECT?*?FROM?CLASS_TBL?CT?? ????WHERE?CT.CLASS_ID?=?#{classID};?? </select>
StudentMapper.xml文件部分內(nèi)容:
<!-- java屬性,數(shù)據(jù)庫(kù)表字段之間的映射定義 -->?? <resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<result></result>?? </resultmap>?? <!-- 查詢學(xué)生list,根據(jù)班級(jí)id -->?? <select>?? ????<include></include>?? ????WHERE?ST.CLASS_ID?=?#{classID}?? </select>
使用resultMap實(shí)現(xiàn)聚集?
使用resultMap,就需要重寫一個(gè)sql,left join學(xué)生表。
<resultmap>?? ????<id></id>?? ????<result></result>?? ????<result></result>?? ????<association></association>?? ????<collection></collection>?? </resultmap>?? <select>?? ????SELECT?*?? ??????FROM?CLASS_TBL?CT?? ???????????LEFT?JOIN?STUDENT_TBL?ST?? ??????????????ON?CT.CLASS_ID?=?ST.CLASS_ID?? ???????????LEFT?JOIN?TEACHER_TBL?TT?? ??????????????ON?CT.TEACHER_ID?=?TT.TEACHER_ID?? ??????WHERE?CT.CLASS_ID?=?#{classID};?? </select>
其中的teacherResultMap請(qǐng)見上面TeacherMapper.xml文件部分內(nèi)容中。studentResultMap請(qǐng)見上面StudentMapper.xml文件部分內(nèi)容中。
4. 動(dòng)態(tài)映射關(guān)系?
通過(guò) discriminator子元素 (鑒別器)可以實(shí)現(xiàn)動(dòng)態(tài)映射關(guān)系信息的設(shè)置。具體示例如下:
public?class?EStudent{??private?long?id;??private?String?name;??private?String?juniorHighSchool;??private?String?seniorHighSchool;??private?int?during;?//?在本校就讀時(shí)間??//?getter,setter方法??/** ???*?必須提供一個(gè)無(wú)參數(shù)的構(gòu)造函數(shù) ???*/??public?EStudent(){} }
情景:查詢學(xué)生信息的seniorHighSchool信息,若就讀時(shí)間during字段值為4、5、6時(shí),則以juniorHighSchool字段作所為seniorHighSchool信息。
<select> ??SELECT?ID,?Name,?JuniorHighSchool,?SeniorHighSchool,?during ????FROM?TStudent</select><resultmap> ??//?若不加這句,則當(dāng)將juniorHighSchool賦予給seniorHighSchool屬性時(shí),juniorHighSchool屬性將為null??<result></result>??<discriminator> ????//?形式1:通過(guò)resultType設(shè)置動(dòng)態(tài)映射信息????<case>??????<result></result>????</case> ???//?形式2:?通過(guò)resultMap設(shè)置動(dòng)態(tài)映射信息???<case></case>???<case></case>??</discriminator></resultmap><resultmap>??<result></result></resultmap>
注意:上面關(guān)于 discriminator子元素 的 case元素 的 resultType屬性 和 resultMap元素 的 type屬性 ,均不是直指返回的領(lǐng)域模型類型,而是指定根據(jù)判斷條件后得到映射關(guān)系,可通過(guò) id子元素 和 result子元素 重寫映射關(guān)系。
5. id元素,result元素,idArg元素,arg元素,discriminator元素的共同屬性
-
javaType屬性 :Java類的全限定名,或別名
-
jdbcType屬性 :JDBC類型, JDBC類型為CUD操作時(shí)列可能為空時(shí)進(jìn)行處理
-
typeHandler屬性 :指定類型處理器的全限定類名或類型別名
-
column屬性 :指定SQL查詢結(jié)果的字段名或字段別名。將用于JDBC的 resultSet.getString(columnName)
-
本文講解了mybatis屬性詳解,更多相關(guān)內(nèi)容請(qǐng)關(guān)注php中文網(wǎng)。
-
相關(guān)推薦: