前言
MyBatis是基於“數據庫結構不可控”的思想建立的，也就是我們希望數據庫遵循第三范式或BCNF，但實際事與願違，那么結果集映射就是MyBatis為我們提供這種理想與現實間轉換的手段了，而resultMap就是結果集映射的配置標簽了。
在深入ResultMap標簽前，我們需要了解從SQL查詢結果集到JavaBean或POJO實體的過程。
從SQL查詢結果到領域模型實體
- 通過JDBC查詢得到ResultSet對象
- 遍歷ResultSet對象並將每行數據暫存到HashMap實例中，以結果集的字段名或字段別名為鍵，以字段值為值
- 根據ResultMap標簽的type屬性通過反射實例化領域模型
- 根據ResultMap標簽的type屬性和id、result等標簽信息將HashMap中的鍵值對，填充到領域模型實例中並返回
一、resultMap
1、屬性說明
- id屬性 ，resultMap標簽的標識。
- type屬性 ，返回值的全限定類名，或類型別名。
- autoMapping屬性 ，值范圍true（默認值）|false, 設置是否啟動自動映射功能，自動映射功能就是自動查找與字段名小寫同名的屬性名，並調用setter方法。而設置為false后，則需要在
resultMap內明確注明映射關系才會調用對應的setter方法。
2、基本作用：建立SQL查詢結果字段與實體屬性的映射關系
示例1：通過setter構造領域模型
public class EStudent{ private long id; private String name; private int age; // getter,setter方法 /** * 必須提供一個無參數的構造函數 */ public EStudent(){} }
<select id="getStudent" resultMap="getStudentRM"> SELECT ID, Name, Age FROM TStudent </select> <resultMap id="getStudentRM" type="EStudnet"> <id property="id" column="ID"/> <result property="studentName" column="Name"/> <result property="studentAge" column="Age"/> </resultMap>
子元素說明：
- id元素 ，用於設置主鍵字段與領域模型屬性的映射關系
- result元素 ，用於設置普通字段與領域模型屬性的映射關系
id、result語句屬性配置細節：
| 屬性 | 描述 |
|---|---|
| property | 需要映射到JavaBean 的屬性名稱。 |
| column | 數據表的列名或者標簽別名。 |
| javaType | 一個完整的類名，或者是一個類型別名。如果你匹配的是一個JavaBean，那MyBatis 通常會自行檢測到。然后，如果你是要映射到一個HashMap，那你需要指定javaType 要達到的目的。 |
| jdbcType | 數據表支持的類型列表。這個屬性只在insert,update 或delete 的時候針對允許空的列有用。JDBC 需要這項，但MyBatis 不需要。如果你是直接針對JDBC 編碼，且有允許空的列，而你要指定這項。 |
| typeHandler | 使用這個屬性可以覆寫類型處理器。這項值可以是一個完整的類名，也可以是一個類型別名。 |
示例2：通過構造函數構造領域模型
<select id="getStudent" resultMap="getStudentRM"> SELECT ID, Name, Age FROM TStudent </select> <resultMap id="getStudentRM" type="EStudnet"> <constructor> <idArg column="ID" javaType="_long"/> <arg column="Name" javaType="String"/> <arg column="Age" javaType="_int"/> </constructor> </resultMap>
子元素說明：
- constructor元素 ，指定使用指定參數列表的構造函數來實例化領域模型。注意：其子元素順序必須與參數列表順序對應
- idArg子元素 ，標記該入參為主鍵
- arg子元素 ，標記該入參為普通字段(主鍵使用該子元素設置也是可以的)
3、一對一關系、一對多關系查詢
注意：在采用嵌套結果的方式查詢一對一、一對多關系時，必須要通過resultMap下的id或result標簽來顯式設置屬性/字段映射關系，否則在查詢多條記錄時會僅僅返回最后一條記錄的情況。
association聯合
聯合元素用來處理“一對一”的關系。需要指定映射的Java實體類的屬性，屬性的javaType（通常MyBatis 自己會識別）。對應的數據庫表的列名稱。如果想覆寫的話返回結果的值，需要指定typeHandler。
不同情況需要告訴MyBatis 如何加載一個聯合。MyBatis 可以用兩種方式加載：
- select: 執行一個其它映射的SQL 語句返回一個Java實體類型。較靈活；
- resultsMap: 使用一個嵌套的結果映射來處理通過join查詢結果集，映射成Java實體類型。
例如，一個班級對應一個班主任。
首先定義好班級中的班主任 private TeacherEntity teacherEntity;
使用select實現聯合
例：班級實體類中有班主任的屬性，通過聯合在得到一個班級實體時，同時映射出班主任實體。
這樣可以直接復用在TeacherMapper.xml文件中定義好的查詢teacher根據其ID的select語句。而且不需要修改寫好的SQL語句，只需要直接修改resultMap即可。
ClassMapper.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文件部分內容：
<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>
使用resultMap實現聯合
與上面同樣的功能，查詢班級，同時查詢器班主任。需在association中添加resultMap（在teacher的xml文件中定義好的），新寫sql（查詢班級表left join教師表），不需要teacher的select。
修改ClassMapper.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請見上面TeacherMapper.xml文件部分內容中。
collection聚集
聚集元素用來處理“一對多”的關系。需要指定映射的Java實體類的屬性，屬性的javaType（一般為ArrayList）；列表中對象的類型ofType（Java實體類）；對應的數據庫表的列名稱；
不同情況需要告訴MyBatis 如何加載一個聚集。MyBatis 可以用兩種方式加載：
1. select: 執行一個其它映射的SQL 語句返回一個Java實體類型。較靈活；
2. resultsMap: 使用一個嵌套的結果映射來處理通過join查詢結果集，映射成Java實體類型。
例如，一個班級有多個學生。
首先定義班級中的學生列表屬性：private List<StudentEntity> studentList;
使用select實現聚集
用法和聯合很類似，區別在於，這是一對多，所以一般映射過來的都是列表。所以這里需要定義javaType為ArrayList，還需要定義列表中對象的類型ofType，以及必須設置的select的語句名稱（需要注意的是，這里的查詢student的select語句條件必須是外鍵classID）。
ClassMapper.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文件部分內容：
<!-- java屬性，數據庫表字段之間的映射定義 --> <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> <!-- 查詢學生list，根據班級id --> <select id="getStudentByClassID" parameterType="String" resultMap="studentResultMap"> <include refid="selectStudentAll" /> WHERE ST.CLASS_ID = #{classID} </select>
使用resultMap實現聚集
使用resultMap，就需要重寫一個sql，left join學生表。
<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請見上面TeacherMapper.xml文件部分內容中。studentResultMap請見上面StudentMapper.xml文件部分內容中。
4. 動態映射關系
通過 discriminator子元素 （鑒別器）可以實現動態映射關系信息的設置。具體示例如下：
public class EStudent{ private long id; private String name; private String juniorHighSchool; private String seniorHighSchool; private int during; // 在本校就讀時間 // getter,setter方法 /** * 必須提供一個無參數的構造函數 */ public EStudent(){} }情景：查詢學生信息的seniorHighSchool信息，若就讀時間during字段值為4、5、6時，則以juniorHighSchool字段作所為seniorHighSchool信息。
<select id="getStundent" resultMap="rm"> SELECT ID, Name, JuniorHighSchool, SeniorHighSchool, during FROM TStudent </select> <resultMap id="rm" type="EStudent"> // 若不加這句，則當將juniorHighSchool賦予給seniorHighSchool屬性時，juniorHighSchool屬性將為null <result column="juniorHighSchool" property="juniorHighSchool"/> <discriminator column="during" javaType="_int"> // 形式1：通過resultType設置動態映射信息 <case value="4" resultType="EStudent"> <result column="juniorHighSchool" property="seniorHighSchool"/> </case> // 形式2: 通過resultMap設置動態映射信息 <case value="5" resultMap="dynamicRM"/> <case value="6" resultMap="dynamicRM"/> </discriminator> </resultMap> <resultMap id="dynamicRM" type="EStudent"> <result column="juniorHighSchool" property="seniorHighSchool"/> </resultMap>注意：上面關於 discriminator子元素 的 case元素 的 resultType屬性 和 resultMap元素 的 type屬性 ，均不是直指返回的領域模型類型，而是指定根據判斷條件后得到映射關系，可通過 id子元素 和 result子元素 重寫映射關系。
5. id元素,result元素,idArg元素,arg元素,discriminator元素的共同屬性
- javaType屬性 ：Java類的全限定名，或別名
- jdbcType屬性 ：JDBC類型, JDBC類型為CUD操作時列可能為空時進行處理
- typeHandler屬性 ：指定類型處理器的全限定類名或類型別名
- column屬性 ：指定SQL查詢結果的字段名或字段別名。將用於JDBC的 resultSet.getString(columnName)