MyBatis學習 之 2、SQL語句映射文件(1)resultMap

時間  2019-11-24
標籤 mybatis 學習 sql 語句 映射 文件 resultmap 欄目 MyBatis 简体版
原文   原文鏈接


目錄(?)[-]java

  1. 二SQL語句映射文件1resultMap
    1. resultMap
      1. idresult
      2. constructor
      3. association聯合
        1. 使用select實現聯合
        2. 使用resultMap實現聯合
      4. collection彙集
        1. 使用select實現彙集
        2. 使用resultMap實現彙集
      5. discriminator鑑別器
 

2、SQL語句映射文件(1)resultMap

 

 

MyBatis學習 之 1、MyBatis簡介與配置MyBatis+Spring+MySqlsql

MyBatis學習 之 2、SQL語句映射文件(1)resultMap數據庫

MyBatis學習 之 2、SQL語句映射文件(2)增刪改查、參數、緩存apache

MyBatis學習 之 3、動態SQL語句緩存

MyBatis學習 之 4、MyBatis配置文件app

 

 

 

SQL 映射XML 文件是全部sql語句放置的地方。須要定義一個workspace，通常定義爲對應的接口類的路徑。寫好SQL語句映射文件後，須要在MyBAtis配置文件mappers標籤中引用，例如：oop

 

[xml] view plaincopy
  1. <mappers>  
  2.     <mapper resource="com/liming/manager/data/mappers/UserMapper.xml" />  
  3.     <mapper resource="com/liming/manager/data/mappers/StudentMapper.xml" />  
  4.     <mapper resource="com/liming/manager/data/mappers/ClassMapper.xml" />  
  5.     <mapper resource="com/liming/manager/data/mappers/TeacherMapper.xml" />  
  6. </mappers>  

 

 

當Java接口與XML文件在一個相對路徑下時，能夠不在myBatis配置文件的mappers中聲明。學習

 

SQL 映射XML 文件一些初級的元素：測試

1. cache – 配置給定模式的緩存 2. cache-ref – 從別的模式中引用一個緩存 3. resultMap – 這是最複雜而卻強大的一個元素了，它描述如何從結果集中加載對象 4. sql – 一個能夠被其餘語句複用的SQL 塊 5. insert – 映射INSERT 語句 6. update – 映射UPDATE 語句 7. delete – 映射DELEETE 語句 8. select  -  映射SELECT語句this

 

2.1 resultMap

        resultMap 是MyBatis 中最重要最強大的元素了。你可讓你比使用JDBC 調用結果集省掉90%的代碼，也可讓你作許多JDBC 不支持的事。現實上，要寫一個等同相似於交互的映射這樣的複雜語句，可能要上千行的代碼。ResultMaps 的目的，就是這樣簡單的語句而不須要多餘的結果映射，更多複雜的語句，除了只要一些絕對必須的語句描述關係之外，不再須要其它的。

resultMap屬性：type爲java實體類；id爲此resultMap的標識。

 

 resultMap能夠設置的映射：

1. constructor – 用來將結果反射給一個實例化好的類的構造器

a) idArg – ID 參數；將結果集標記爲ID，以方便全局調用 b) arg –反射到構造器的一般結果

2. id – ID 結果，將結果集標記爲ID，以方便全局調用

3. result – 反射到JavaBean 屬性的普通結果

4. association – 複雜類型的結合；多個結果合成的類型

a) nested result mappings – 幾resultMap 自身嵌套關聯，也能夠引用到一個其它上

5. collection –複雜類型集合a collection of complex types

6. nested result mappings – resultMap 的集合，也能夠引用到一個其它上

7. discriminator – 使用一個結果值以決定使用哪一個resultMap

a) case – 基本一些值的結果映射的case 情形

i. nested result mappings –一個case 情形自己就是一個結果映射，所以也能夠包括一些相同的元素，也能夠引用一個外部resultMap。

 

 

2.1.1 id、result

id、result是最簡單的映射，id爲主鍵映射；result其餘基本數據庫表字段到實體類屬性的映射。   最簡單的例子：

 

[xml]  view plain copy
  1. <resultMap type="liming.student.manager.data.model.StudentEntity" id="studentResultMap">  
  2.     <id  property="studentId"        column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/>  
  3.     <result property="studentName"       column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/>  
  4.     <result property="studentSex"        column="STUDENT_SEX"  javaType="int" jdbcType="INTEGER"/>  
  5.     <result property="studentBirthday"   column="STUDENT_BIRTHDAY"  javaType="Date" jdbcType="DATE"/>  
  6.     <result property="studentPhoto"  column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" />  
  7. </resultMap>  

 

 

 

id、result語句屬性配置細節：

 

屬性

描述

 

property

須要映射到JavaBean的屬性名稱。

 

column

數據表的列名或者標籤別名。

 

javaType

一個完整的類名，或者是一個類型別名。若是你匹配的是一個JavaBean，那MyBatis一般會自行檢測到。而後，若是你是要映射到一個HashMap，那你須要指定javaType要達到的目的。

 

jdbcType

數據表支持的類型列表。這個屬性只在insert,update或delete 的時候針對容許空的列有用。JDBC須要這項，但MyBatis 不須要。若是你是直接針對JDBC編碼，且有容許空的列，而你要指定這項。

 

typeHandler

使用這個屬性能夠覆寫類型處理器。這項值能夠是一個完整的類名，也能夠是一個類型別名。

 

 

 

支持的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時候，須要定義java實體類的屬性映射到數據庫表的字段上。這個時候是使用JavaBean實現的。固然咱們也可使用實體類的構造方法來實現值的映射，這個時候是經過構造方法參數的書寫的順序來進行賦值的。         使用construcotr功能有限（例如使用collection級聯查詢）。         上面使用id、result實現的功能就能夠改成：

[xml]  view plain copy
  1. <resultMap type="StudentEntity" id="studentResultMap" >  
  2.     <constructor>  
  3.         <idArg javaType="String" column="STUDENT_ID"/>  
  4.         <arg javaType="String" column="STUDENT_NAME"/>  
  5.         <arg javaType="String" column="STUDENT_SEX"/>  
  6.         <arg javaType="Date" column="STUDENT_BIRTHDAY"/>  
  7.     </constructor>  
  8. </resultMap>  

 

        固然，咱們須要定義StudentEntity實體類的構造方法：

[java]  view plain copy
  1. public StudentEntity(String studentID, String studentName, String studentSex, Date studentBirthday){  
  2.     this.studentID = studentID;  
  3.     this.studentName = studentName;  
  4.     this.studentSex = studentSex;  
  5.     this.studentBirthday = studentBirthday;  
  6. }  

 

 

 

 

2.1.3 association聯合

聯合元素用來處理「一對一」的關係。須要指定映射的Java實體類的屬性，屬性的javaType（一般MyBatis 本身會識別）。對應的數據庫表的列名稱。若是想覆寫的話返回結果的值，須要指定typeHandler。 不一樣狀況須要告訴MyBatis 如何加載一個聯合。MyBatis 能夠用兩種方式加載：

1. select: 執行一個其它映射的SQL 語句返回一個Java實體類型。較靈活； 2. resultsMap: 使用一個嵌套的結果映射來處理經過join查詢結果集，映射成Java實體類型。

 

例如，一個班級對應一個班主任。  首先定義好班級中的班主任屬性：

[java]  view plain copy
  1. private TeacherEntity teacherEntity;  

 

 

2.1.3.1使用select實現聯合

 例：班級實體類中有班主任的屬性，經過聯合在獲得一個班級實體時，同時映射出班主任實體。

 這樣能夠直接複用在TeacherMapper.xml文件中定義好的查詢teacher根據其ID的select語句。並且不須要修改寫好的SQL語句，只須要直接修改resultMap便可。

 ClassMapper.xml文件部份內容：

[xml]  view plain copy
  1. <resultMap type="ClassEntity" id="classResultMap">  
  2.     <id property="classID" column="CLASS_ID" />  
  3.     <result property="className" column="CLASS_NAME" />  
  4.     <result property="classYear" column="CLASS_YEAR" />  
  5.     <association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/>  
  6. </resultMap>  
  7.   
  8. <select id="getClassByID" parameterType="String" resultMap="classResultMap">  
  9.     SELECT * FROM CLASS_TBL CT  
  10.     WHERE CT.CLASS_ID = #{classID};  
  11. </select>  

 

 

 TeacherMapper.xml文件部份內容：

[xml]  view plain copy
  1. <resultMap type="TeacherEntity" id="teacherResultMap">  
  2.     <id property="teacherID" column="TEACHER_ID" />  
  3.     <result property="teacherName" column="TEACHER_NAME" />  
  4.     <result property="teacherSex" column="TEACHER_SEX" />  
  5.     <result property="teacherBirthday" column="TEACHER_BIRTHDAY"/>  
  6.     <result property="workDate" column="WORK_DATE"/>  
  7.     <result property="professional" column="PROFESSIONAL"/>  
  8. </resultMap>  
  9.   
  10. <select id="getTeacher" parameterType="String"  resultMap="teacherResultMap">  
  11.     SELECT *  
  12.       FROM TEACHER_TBL TT  
  13.      WHERE TT.TEACHER_ID = #{teacherID}  
  14. </select>  

 

 

 

2.1.3.2使用resultMap實現聯合

 與上面一樣的功能，查詢班級，同時查詢器班主任。需在association中添加resultMap（在teacher的xml文件中定義好的），新寫sql（查詢班級表left join教師表），不須要teacher的select。

 修改ClassMapper.xml文件部份內容：

[xml]  view plain copy
  1. <resultMap type="ClassEntity" id="classResultMap">  
  2.     <id property="classID" column="CLASS_ID" />  
  3.     <result property="className" column="CLASS_NAME" />  
  4.     <result property="classYear" column="CLASS_YEAR" />  
  5.     <association property="teacherEntity" column="TEACHER_ID"  resultMap="teacherResultMap"/>  
  6. </resultMap>  
  7.   
  8. <select id="getClassAndTeacher" parameterType="String" resultMap="classResultMap">  
  9.     SELECT *  
  10.       FROM CLASS_TBL CT LEFT JOIN TEACHER_TBL TT ON CT.TEACHER_ID = TT.TEACHER_ID  
  11.      WHERE CT.CLASS_ID = #{classID};  
  12. </select>  

 
其中的teacherResultMap請見上面TeacherMapper.xml文件部份內容中。

 

 

2.1.4 collection彙集

彙集元素用來處理「一對多」的關係。須要指定映射的Java實體類的屬性，屬性的javaType（通常爲ArrayList）；列表中對象的類型ofType（Java實體類）；對應的數據庫表的列名稱； 不一樣狀況須要告訴MyBatis 如何加載一個彙集。MyBatis 能夠用兩種方式加載：

1. select: 執行一個其它映射的SQL 語句返回一個Java實體類型。較靈活； 2. resultsMap: 使用一個嵌套的結果映射來處理經過join查詢結果集，映射成Java實體類型。

 

例如，一個班級有多個學生。 首先定義班級中的學生列表屬性：

[java]  view plain copy
  1. private List<StudentEntity> studentList;  

 

 

2.1.4.1使用select實現彙集

 用法和聯合很相似，區別在於，這是一對多，因此通常映射過來的都是列表。因此這裏須要定義javaType爲ArrayList，還須要定義列表中對象的類型ofType，以及必須設置的select的語句名稱（須要注意的是，這裏的查詢student的select語句條件必須是外鍵classID）。

 

ClassMapper.xml文件部份內容：

[xml]  view plain copy
  1. <resultMap type="ClassEntity" id="classResultMap">  
  2.     <id property="classID" column="CLASS_ID" />  
  3.     <result property="className" column="CLASS_NAME" />  
  4.     <result property="classYear" column="CLASS_YEAR" />  
  5.     <association property="teacherEntity" column="TEACHER_ID"  select="getTeacher"/>  
  6.     <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" select="getStudentByClassID"/>  
  7. </resultMap>  
  8.   
  9. <select id="getClassByID" parameterType="String" resultMap="classResultMap">  
  10.     SELECT * FROM CLASS_TBL CT  
  11.     WHERE CT.CLASS_ID = #{classID};  
  12. </select>  

 

 

 

StudentMapper.xml文件部份內容：

[xml]  view plain copy
  1. <!-- java屬性，數據庫表字段之間的映射定義 -->  
  2. <resultMap type="StudentEntity" id="studentResultMap">  
  3.     <id property="studentID" column="STUDENT_ID" />  
  4.     <result property="studentName" column="STUDENT_NAME" />  
  5.     <result property="studentSex" column="STUDENT_SEX" />  
  6.     <result property="studentBirthday" column="STUDENT_BIRTHDAY" />  
  7. </resultMap>  
  8.   
  9. <!-- 查詢學生list，根據班級id -->  
  10. <select id="getStudentByClassID" parameterType="String" resultMap="studentResultMap">  
  11.     <include refid="selectStudentAll" />  
  12.     WHERE ST.CLASS_ID = #{classID}  
  13. </select>  

 

 

 

2.1.4.2使用resultMap實現彙集

 使用resultMap，就須要重寫一個sql，left join學生表。

[xml]  view plain copy
  1. <resultMap type="ClassEntity" id="classResultMap">  
  2.     <id property="classID" column="CLASS_ID" />  
  3.     <result property="className" column="CLASS_NAME" />  
  4.     <result property="classYear" column="CLASS_YEAR" />  
  5.     <association property="teacherEntity" column="TEACHER_ID"  resultMap="teacherResultMap"/>  
  6.     <collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" resultMap="studentResultMap"/>  
  7. </resultMap>  
  8.   
  9. <select id="getClassAndTeacherStudent" parameterType="String" resultMap="classResultMap">  
  10.     SELECT *  
  11.       FROM CLASS_TBL CT  
  12.            LEFT JOIN STUDENT_TBL ST  
  13.               ON CT.CLASS_ID = ST.CLASS_ID  
  14.            LEFT JOIN TEACHER_TBL TT  
  15.               ON CT.TEACHER_ID = TT.TEACHER_ID  
  16.       WHERE CT.CLASS_ID = #{classID};  
  17. </select>  

  其中的teacherResultMap請見上面TeacherMapper.xml文件部份內容中。studentResultMap請見上面StudentMapper.xml文件部份內容中。

 

2.1.5discriminator鑑別器

 

有時一個單獨的數據庫查詢也許返回不少不一樣（可是但願有些關聯）數據類型的結果集。鑑別器元素就是被設計來處理這個狀況的，還有包括類的繼承層次結構。鑑別器很是容易理解，由於它的表現很像Java語言中的switch語句。

定義鑑別器指定了column和javaType屬性。列是MyBatis查找比較值的地方。JavaType是須要被用來保證等價測試的合適類型（儘管字符串在不少情形下都會有用）。

下面這個例子爲，當classId爲20000001時，才映射classId屬性。

 

 

 

[xml]  view plain copy
  1. <resultMap type="liming.student.manager.data.model.StudentEntity" id="resultMap_studentEntity_discriminator">  
  2.     <id  property="studentId"        column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/>  
  3.     <result property="studentName"       column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/>  
  4.     <result property="studentSex"        column="STUDENT_SEX"  javaType="int" jdbcType="INTEGER"/>  
  5.     <result property="studentBirthday"   column="STUDENT_BIRTHDAY"  javaType="Date" jdbcType="DATE"/>  
  6.     <result property="studentPhoto"  column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" />  
  7.     <result property="placeId"           column="PLACE_ID" javaType="String" jdbcType="VARCHAR"/>  
  8.     <discriminator column="CLASS_ID" javaType="String" jdbcType="VARCHAR">  
  9.         <case value="20000001" resultType="liming.student.manager.data.model.StudentEntity" >  
  10.             <result property="classId" column="CLASS_ID" javaType="String" jdbcType="VARCHAR"/>  
  11.         </case>  
  12.     </discriminator>  
  13. </resultMap>  
 

 

MyBatis學習 之 1、MyBatis簡介與配置MyBatis+Spring+MySql

MyBatis學習 之 2、SQL語句映射文件(1)resultMap

MyBatis學習 之 2、SQL語句映射文件(2)增刪改查、參數、緩存

MyBatis學習 之 3、動態SQL語句

MyBatis學習 之 4、MyBatis配置文件

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程