mybatis屬性詳解

375

前言

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
數(shù)據(jù)庫(kù)
# 構(gòu)造函數(shù)
喜歡就支持一下吧
點(diǎn)贊5 分享