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子元素 ，標記該入參為普通欄位(主鍵使用該子元素設定也是可以的)

  3. 一對一關係、一對多關係查詢請參考《MyBatis魔法堂：即學即用篇》

     注意：在採用巢狀結果的方式查詢一對一、一對多關係時，必須要通過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)

文章轉自：

http://www.cnblogs.com/fsjohnhuang/p/4076592.html