mybatis jdbc Type 與java Type對照表 以及ResultMap元素講解
一、前言
MyBatis是基於“資料庫結構不可控”的思想建立的,也就是我們希望資料庫遵循第三正規化或BCNF,但實際事與願違,那麼結果集對映就是MyBatis為我們提供這種理想與現實間轉換的手段了,而resultMap就是結果集對映的配置標籤了。
二、從SQL查詢結果到領域模型實體
在深入ResultMap標籤前,我們需要了解從SQL查詢結果集到JavaBean或POJO實體的過程。
1. 通過JDBC查詢得到ResultSet物件
2. 遍歷ResultSet物件並將每行資料暫存到HashMap例項中,以結果集的欄位名或欄位別名為鍵,以欄位值為值
3. 根據ResultMap標籤的type屬性通過反射例項化領域模型
4. 根據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元素 ,用於設定普通欄位與領域模型屬性的對映關係
示例2:通過建構函式構造領域模型
public class EStudent{ private long id; private String name; private int age; // getter方法 public EStudent(long id, String name, int age){ this.id = id; this.name = name; this.age = age; } }
<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子元素 ,標記該入參為普通欄位(主鍵使用該子元素設定也是可以的)
注意:在採用巢狀結果的方式查詢一對一、一對多關係時,必須要通過resultMap下的id或result標籤來顯式設定屬性/欄位對映關係,否則在查詢多條記錄時會僅僅返回最後一條記錄的情況。
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)