mybatis屬性詳解

前言

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í)體 

  1. 通過(guò)JDBC查詢得到ResultSet對(duì)象

  2. 遍歷ResultSet對(duì)象并將每行數(shù)據(jù)暫存到HashMap實(shí)例中,以結(jié)果集的字段名或字段別名為鍵,以字段值為值

  3. 根據(jù)ResultMap標(biāo)簽的type屬性通過(guò)反射實(shí)例化領(lǐng)域模型

  4. 根據(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 studentList;

使用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元素的共同屬性

? 版權(quán)聲明
THE END
喜歡就支持一下吧
點(diǎn)贊5 分享