SQL 映射XML 文件是所有sql語句放置的地方。需要定義一個(gè)workspace,一般定義為對(duì)應(yīng)的接口類的路徑。寫好SQL語句映射文件后,需要在MyBAtis配置文件mappers標(biāo)簽中引用,例如:
?
Xml代碼 ?
<mappers>??????<mapper?resource="com/liming/manager/data/mappers/UserMapper.xml"?/>??????<mapper?resource="com/liming/manager/data/mappers/StudentMapper.xml"?/>??????<mapper?resource="com/liming/manager/data/mappers/ClassMapper.xml"?/>??????<mapper?resource="com/liming/manager/data/mappers/TeacherMapper.xml"?/>??</mappers>?? ?
?
當(dāng)Java接口與XML文件在一個(gè)相對(duì)路徑下時(shí),可以不在myBatis配置文件的mappers中聲明。
?
SQL 映射XML 文件一些初級(jí)的元素:
1.?cache – 配置給定模式的緩存
2.?cache-ref – 從別的模式中引用一個(gè)緩存
3.?resultMap – 這是最復(fù)雜而卻強(qiáng)大的一個(gè)元素了,它描述如何從結(jié)果集中加載對(duì)象
4.?sql – 一個(gè)可以被其他語句復(fù)用的SQL 塊
5.?insert – 映射INSERT 語句
6.?update – 映射UPDATE 語句
7.?delete – 映射DELEETE 語句
8.?select? -? 映射SELECT語句
?
2.1 resultMap
??????? resultMap 是MyBatis 中最重要最強(qiáng)大的元素了。你可以讓你比使用JDBC 調(diào)用結(jié)果集省掉90%的代碼,也可以讓你做許多JDBC 不支持的事。現(xiàn)實(shí)上,要寫一個(gè)等同類似于交互的映射這樣的復(fù)雜語句,可能要上千行的代碼。ResultMaps 的目的,就是這樣簡(jiǎn)單的語句而不需要多余的結(jié)果映射,更多復(fù)雜的語句,除了只要一些絕對(duì)必須的語句描述關(guān)系以外,再也不需要其它的。
resultMap屬性:type為java實(shí)體類;id為此resultMap的標(biāo)識(shí)。
?
?resultMap可以設(shè)置的映射:
1.?constructor – 用來將結(jié)果反射給一個(gè)實(shí)例化好的類的構(gòu)造器
a)?idArg – ID 參數(shù);將結(jié)果集標(biāo)記為ID,以方便全局調(diào)用
b)?arg –反射到構(gòu)造器的通常結(jié)果
2.?id – ID 結(jié)果,將結(jié)果集標(biāo)記為ID,以方便全局調(diào)用
3.?result – 反射到JavaBean 屬性的普通結(jié)果
4.?association – 復(fù)雜類型的結(jié)合;多個(gè)結(jié)果合成的類型
a)?nested result mappings – 幾resultMap 自身嵌套關(guān)聯(lián),也可以引用到一個(gè)其它上
5.?collection –復(fù)雜類型集合a collection of complex types
6.?nested result mappings – resultMap 的集合,也可以引用到一個(gè)其它上
7.?discriminator – 使用一個(gè)結(jié)果值以決定使用哪個(gè)resultMap
a)?case – 基本一些值的結(jié)果映射的case 情形
i.?nested result mappings –一個(gè)case 情形本身就是一個(gè)結(jié)果映射,因此也可以包括一些相同的元素,也可以引用一個(gè)外部resultMap。
?
?
2.1.1 id、result
id、result是最簡(jiǎn)單的映射,id為主鍵映射;result其他基本數(shù)據(jù)庫(kù)表字段到實(shí)體類屬性的映射。
??最簡(jiǎn)單的例子:
?
Xml代碼 ?
<resultMap?type="liming.student.manager.data.model.StudentEntity"?id="studentResultMap">??????<id??property="studentId"????????column="STUDENT_ID"?javaType="String"?jdbcType="VARCHAR"/>??????<result?property="studentName"???????column="STUDENT_NAME"?javaType="String"?jdbcType="VARCHAR"/>??????<result?property="studentSex"????????column="STUDENT_SEX"??javaType="int"?jdbcType="INTEGER"/>??????<result?property="studentBirthday"???column="STUDENT_BIRTHDAY"??javaType="Date"?jdbcType="DATE"/>??????<result?property="studentPhoto"??column="STUDENT_PHOTO"?javaType="byte[]"?jdbcType="BLOB"?typeHandler="org.apache.ibatis.type.BlobTypeHandler"?/>??</resultMap>?? ?
?
?
id、result語句屬性配置細(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è)類型別名。 | ? |
?
?
支持的JDBC類型
?????? 為了將來的引用,MyBatis 支持下列JDBC 類型,通過JdbcType 枚舉:
BIT,FLOAT,CHAR,TIMESTAMP,OTHER,UNDEFINED,TINYINT,REAL,VARCHAR,BINARY,BLOB,NVARCHAR,SMALLINT,DOUBLE,LONGVARCHAR,VARBINARY,CLOB,NCHAR,INTEGER,NUMERIC,DATE,LONGVARBINARY,BOOLEAN,NCLOB,BIGINT,DECIMAL,TIME,NULL,CURSOR
?
?
2.1.2 constructor
??????? 我們使用id、result時(shí)候,需要定義java實(shí)體類的屬性映射到數(shù)據(jù)庫(kù)表的字段上。這個(gè)時(shí)候是使用JavaBean實(shí)現(xiàn)的。當(dāng)然我們也可以使用實(shí)體類的構(gòu)造方法來實(shí)現(xiàn)值的映射,這個(gè)時(shí)候是通過構(gòu)造方法參數(shù)的書寫的順序來進(jìn)行賦值的。
??????? 使用construcotr功能有限(例如使用collection級(jí)聯(lián)查詢)。
??????? 上面使用id、result實(shí)現(xiàn)的功能就可以改為:
Xml代碼 ?
<resultMap?type="StudentEntity"?id="studentResultMap"?>??????<constructor>??????????<idArg?javaType="String"?column="STUDENT_ID"/>??????????<arg?javaType="String"?column="STUDENT_NAME"/>??????????<arg?javaType="String"?column="STUDENT_SEX"/>??????????<arg?javaType="Date"?column="STUDENT_BIRTHDAY"/>??????</constructor>??</resultMap>?? ?
??????? 當(dāng)然,我們需要定義StudentEntity實(shí)體類的構(gòu)造方法:
Java代碼 ?
public?StudentEntity(String?studentID,?String?studentName,?String?studentSex,?Date?studentBirthday){??????this.studentID?=?studentID;??????this.studentName?=?studentName;??????this.studentSex?=?studentSex;??????this.studentBirthday?=?studentBirthday;??}?? ?
?
?
?
2.1.3 association聯(lián)合
聯(lián)合元素用來處理“一對(duì)一”的關(guān)系。需要指定映射的Java實(shí)體類的屬性,屬性的javaType(通常MyBatis 自己會(huì)識(shí)別)。對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱。如果想覆寫的話返回結(jié)果的值,需要指定typeHandler。
不同情況需要告訴MyBatis 如何加載一個(gè)聯(lián)合。MyBatis 可以用兩種方式加載:
1.?select: 執(zhí)行一個(gè)其它映射的SQL 語句返回一個(gè)Java實(shí)體類型。較靈活;
2.?resultsMap: 使用一個(gè)嵌套的結(jié)果映射來處理通過join查詢結(jié)果集,映射成Java實(shí)體類型。
?
例如,一個(gè)班級(jí)對(duì)應(yīng)一個(gè)班主任。
?首先定義好班級(jí)中的班主任屬性:
Java代碼 ?
private?TeacherEntity?teacherEntity;?? ?
?
2.1.3.1使用select實(shí)現(xiàn)聯(lián)合
?例:班級(jí)實(shí)體類中有班主任的屬性,通過聯(lián)合在得到一個(gè)班級(jí)實(shí)體時(shí),同時(shí)映射出班主任實(shí)體。
?這樣可以直接復(fù)用在TeacherMapper.xml文件中定義好的查詢teacher根據(jù)其ID的select語句。而且不需要修改寫好的SQL語句,只需要直接修改resultMap即可。
?ClassMapper.xml文件部分內(nèi)容:
Xml代碼 ?
<resultMap?type="ClassEntity"?id="classResultMap">??????<id?property="classID"?column="CLASS_ID"?/>??????<result?property="className"?column="CLASS_NAME"?/>??????<result?property="classYear"?column="CLASS_YEAR"?/>??????<association?property="teacherEntity"?column="TEACHER_ID"?select="getTeacher"/>??</resultMap>????<select?id="getClassByID"?parameterType="String"?resultMap="classResultMap">??????SELECT?*?FROM?CLASS_TBL?CT??????WHERE?CT.CLASS_ID?=?#{classID};??</select>?? ?
?
?TeacherMapper.xml文件部分內(nèi)容:
Xml代碼 ?
<resultMap?type="TeacherEntity"?id="teacherResultMap">??????<id?property="teacherID"?column="TEACHER_ID"?/>??????<result?property="teacherName"?column="TEACHER_NAME"?/>??????<result?property="teacherSex"?column="TEACHER_SEX"?/>??????<result?property="teacherBirthday"?column="TEACHER_BIRTHDAY"/>??????<result?property="workDate"?column="WORK_DATE"/>??????<result?property="professional"?column="PROFESSIONAL"/>??</resultMap>????<select?id="getTeacher"?parameterType="String"??resultMap="teacherResultMap">??????SELECT?*????????FROM?TEACHER_TBL?TT???????WHERE?TT.TEACHER_ID?=?#{teacherID}??</select>?? ?
?
?
2.1.3.2使用resultMap實(shí)現(xiàn)聯(lián)合
?與上面同樣的功能,查詢班級(jí),同時(shí)查詢器班主任。需在association中添加resultMap(在teacher的xml文件中定義好的),新寫sql(查詢班級(jí)表left join教師表),不需要teacher的select。
?修改ClassMapper.xml文件部分內(nèi)容:
Xml代碼 ?
<resultMap?type="ClassEntity"?id="classResultMap">??????<id?property="classID"?column="CLASS_ID"?/>??????<result?property="className"?column="CLASS_NAME"?/>??????<result?property="classYear"?column="CLASS_YEAR"?/>??????<association?property="teacherEntity"?column="TEACHER_ID"??resultMap="teacherResultMap"/>??</resultMap>????<select?id="getClassAndTeacher"?parameterType="String"?resultMap="classResultMap">??????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)容中。
?
?
2.1.4 collection聚集
聚集元素用來處理“一對(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 語句返回一個(gè)Java實(shí)體類型。較靈活;
2.?resultsMap: 使用一個(gè)嵌套的結(jié)果映射來處理通過join查詢結(jié)果集,映射成Java實(shí)體類型。
?
例如,一個(gè)班級(jí)有多個(gè)學(xué)生。
首先定義班級(jí)中的學(xué)生列表屬性:
Java代碼 ?
private?List<StudentEntity>?studentList;?? ?
?
2.1.4.1使用select實(shí)現(xiàn)聚集
?用法和聯(lián)合很類似,區(qū)別在于,這是一對(duì)多,所以一般映射過來的都是列表。所以這里需要 定義javaType為ArrayList,還需要定義列表中對(duì)象的類型ofType,以及必須設(shè)置的select的語句名稱(需要注意的是,這里的查詢 student的select語句條件必須是外鍵classID)。
?
ClassMapper.xml文件部分內(nèi)容:
Xml代碼 ?
<resultMap?type="ClassEntity"?id="classResultMap">??????<id?property="classID"?column="CLASS_ID"?/>??????<result?property="className"?column="CLASS_NAME"?/>??????<result?property="classYear"?column="CLASS_YEAR"?/>??????<association?property="teacherEntity"?column="TEACHER_ID"??select="getTeacher"/>??????<collection?property="studentList"?column="CLASS_ID"?javaType="ArrayList"?ofType="StudentEntity"?select="getStudentByClassID"/>??</resultMap>????<select?id="getClassByID"?parameterType="String"?resultMap="classResultMap">??????SELECT?*?FROM?CLASS_TBL?CT??????WHERE?CT.CLASS_ID?=?#{classID};??</select>?? ?
?
?
StudentMapper.xml文件部分內(nèi)容:
Xml代碼 ?
<!--?java屬性,數(shù)據(jù)庫(kù)表字段之間的映射定義?-->??<resultMap?type="StudentEntity"?id="studentResultMap">??????<id?property="studentID"?column="STUDENT_ID"?/>??????<result?property="studentName"?column="STUDENT_NAME"?/>??????<result?property="studentSex"?column="STUDENT_SEX"?/>??????<result?property="studentBirthday"?column="STUDENT_BIRTHDAY"?/>??</resultMap>????<!--?查詢學(xué)生list,根據(jù)班級(jí)id?-->??<select?id="getStudentByClassID"?parameterType="String"?resultMap="studentResultMap">??????<include?refid="selectStudentAll"?/>??????WHERE?ST.CLASS_ID?=?#{classID}??</select>?? ?
?
?
2.1.4.2使用resultMap實(shí)現(xiàn)聚集
?使用resultMap,就需要重寫一個(gè)sql,left join學(xué)生表。
Xml代碼 ?
<resultMap?type="ClassEntity"?id="classResultMap">??????<id?property="classID"?column="CLASS_ID"?/>??????<result?property="className"?column="CLASS_NAME"?/>??????<result?property="classYear"?column="CLASS_YEAR"?/>??????<association?property="teacherEntity"?column="TEACHER_ID"??resultMap="teacherResultMap"/>??????<collection?property="studentList"?column="CLASS_ID"?javaType="ArrayList"?ofType="StudentEntity"?resultMap="studentResultMap"/>??</resultMap>????<select?id="getClassAndTeacherStudent"?parameterType="String"?resultMap="classResultMap">??????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)容中。
?
2.1.5discriminator鑒別器
?
有時(shí)一個(gè)單獨(dú)的數(shù)據(jù)庫(kù)查詢也許返回很多不同(但是希望有些關(guān)聯(lián))數(shù)據(jù)類型的結(jié)果集。鑒別器元素就是被設(shè)計(jì)來處理這個(gè)情況的,還有包括類的繼承層次結(jié)構(gòu)。鑒別器非常容易理解,因?yàn)樗谋憩F(xiàn)很像Java語言中的switch語句。
定義鑒別器指定了column和javaType屬性。列是MyBatis查找比較值的地方。JavaType是需要被用來保證等價(jià)測(cè)試的合適類型(盡管字符串在很多情形下都會(huì)有用)。
下面這個(gè)例子為,當(dāng)classId為20000001時(shí),才映射classId屬性。
?
?
?
Xml代碼 ?
<resultMap?type="liming.student.manager.data.model.StudentEntity"?id="resultMap_studentEntity_discriminator">??????<id??property="studentId"????????column="STUDENT_ID"?javaType="String"?jdbcType="VARCHAR"/>??????<result?property="studentName"???????column="STUDENT_NAME"?javaType="String"?jdbcType="VARCHAR"/>??????<result?property="studentSex"????????column="STUDENT_SEX"??javaType="int"?jdbcType="INTEGER"/>??????<result?property="studentBirthday"???column="STUDENT_BIRTHDAY"??javaType="Date"?jdbcType="DATE"/>??????<result?property="studentPhoto"??column="STUDENT_PHOTO"?javaType="byte[]"?jdbcType="BLOB"?typeHandler="org.apache.ibatis.type.BlobTypeHandler"?/>??????<result?property="placeId"???????????column="PLACE_ID"?javaType="String"?jdbcType="VARCHAR"/>??????<discriminator?column="CLASS_ID"?javaType="String"?jdbcType="VARCHAR">??????????<case?value="20000001"?resultType="liming.student.manager.data.model.StudentEntity"?>??????????????<result?property="classId"?column="CLASS_ID"?javaType="String"?jdbcType="VARCHAR"/>??????????</case>??????</discriminator>??</resultMap>?
轉(zhuǎn)載于:https://www.cnblogs.com/charlexu/archive/2013/03/15/2961118.html
總結(jié)
以上是生活随笔為你收集整理的MyBatis ResultMap(2)的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò),歡迎將生活随笔推薦給好友。