Mybatis中resultMap的Colum和property怎么用

# Mybatis中resultMap的Colum和property怎么用

## 一、resultMap基礎概念

### 1.1 什么是resultMap
resultMap是MyBatis框架中用于映射數據庫查詢結果到Java對象的核心配置元素。它解決了數據庫字段名與Java對象屬性名不一致時的映射問題，是MyBatis實現ORM（對象關系映射）的關鍵組件。

### 1.2 resultMap與resultType的區別
- **resultType**：直接指定返回類型，要求數據庫列名與Java屬性名完全一致（或開啟自動駝峰轉換）
- **resultMap**：通過顯式配置建立列與屬性的映射關系，支持復雜映射場景

```xml
<!-- resultType示例 -->
<select id="selectUser" resultType="com.example.User">
  SELECT id, user_name, age FROM user
</select>

<!-- resultMap示例 -->
<resultMap id="userResultMap" type="com.example.User">
  <!-- 映射配置 -->
</resultMap>

二、column與property屬性詳解

2.1 column屬性

• 含義：數據庫查詢結果中的列名（或別名）
• 特點：
  • 大小寫敏感（取決于數據庫）
  • 支持SQL AS關鍵字定義的別名
  • 可以是復雜查詢中的表達式結果

2.2 property屬性

• 含義：Java對象中的屬性名
• 特點：
  • 必須與Java Bean屬性名嚴格一致
  • 支持嵌套屬性（如”address.city”）
  • 支持集合類型映射

2.3 基本映射示例

<resultMap id="basicMap" type="User">
  <id property="id" column="user_id"/>
  <result property="username" column="user_name"/>
  <result property="age" column="user_age"/>
</resultMap>

三、不同場景下的使用方式

3.1 簡單字段映射

當數據庫字段與Java屬性命名風格不同時：

<resultMap id="userMap" type="User">
  <!-- 主鍵字段 -->
  <id property="id" column="user_id"/>
  
  <!-- 普通字段 -->
  <result property="userName" column="user_name"/>
  <result property="createdAt" column="create_time"/>
</resultMap>

3.2 一對一關聯映射

處理對象間的1:1關系：

<resultMap id="orderWithUserMap" type="Order">
  <id property="id" column="order_id"/>
  
  <!-- 關聯用戶對象 -->
  <association property="user" javaType="User">
    <id property="id" column="user_id"/>
    <result property="username" column="user_name"/>
  </association>
</resultMap>

3.3 一對多/多對多映射

處理集合類型屬性：

<resultMap id="userWithOrdersMap" type="User">
  <id property="id" column="id"/>
  
  <!-- 訂單集合 -->
  <collection property="orders" ofType="Order">
    <id property="id" column="order_id"/>
    <result property="amount" column="order_amount"/>
  </collection>
</resultMap>

四、高級映射技巧

4.1 自動映射與手動映射結合

<!-- 開啟autoMapping后，未明確配置的字段會自動映射 -->
<resultMap id="autoMap" type="User" autoMapping="true">
  <!-- 只手動映射命名不一致的字段 -->
  <result property="email" column="user_email"/>
</resultMap>

4.2 繼承映射配置

復用已定義的resultMap：

<resultMap id="baseUserMap" type="User">
  <id property="id" column="id"/>
  <result property="name" column="name"/>
</resultMap>

<resultMap id="extendedUserMap" extends="baseUserMap">
  <result property="email" column="email"/>
</resultMap>

4.3 嵌套查詢映射

通過select實現延遲加載：

<resultMap id="orderWithUserMap" type="Order">
  <association property="user" column="user_id" 
               select="selectUserById"/>
</resultMap>

<select id="selectUserById" resultType="User">
  SELECT * FROM user WHERE id = #{id}
</select>

五、常見問題與解決方案

5.1 映射失敗的常見原因

1. 大小寫問題：數據庫列名與配置不一致
2. 屬性拼寫錯誤：Java屬性名拼寫錯誤
3. 類型不匹配：數據庫類型與Java類型無法自動轉換
4. 缺少setter方法：Java Bean缺少對應屬性的setter

5.2 最佳實踐建議

1. 統一命名規范：建議數據庫使用下劃線，Java使用駝峰
2. 顯式配置主鍵：總是明確配置元素
3. 復雜映射分步處理：先建立基礎映射，再處理關聯關系
4. 使用自動映射：結合autoMapping減少配置量

六、實際應用示例

6.1 電商系統用戶訂單映射

<resultMap id="userOrderDetailMap" type="User">
  <id property="userId" column="u_id"/>
  <result property="userName" column="u_name"/>
  
  <collection property="orders" ofType="Order">
    <id property="orderId" column="o_id"/>
    <result property="orderAmount" column="o_amount"/>
    
    <collection property="items" ofType="OrderItem">
      <result property="productName" column="oi_product"/>
      <result property="quantity" column="oi_quantity"/>
    </collection>
  </collection>
</resultMap>

6.2 動態列名處理

當列名需要動態確定時：

<resultMap id="dynamicColumnMap" type="User">
  <id property="id" column="id"/>
  <result property="name" column="${dynamicColumn}"/>
</resultMap>

七、總結

resultMap的column和property屬性是MyBatis實現靈活映射的基礎： - column始終代表數據庫側的列名 - property始終代表Java對象的屬性名 - 合理使用可以處理各種復雜的映射場景 - 結合自動映射和繼承機制能顯著減少配置工作量

掌握resultMap的配置技巧，能夠有效解決實際開發中90%以上的ORM映射問題，是MyBatis高效使用的關鍵技能。

提示：在實際開發中，建議結合MyBatis的日志功能（開啟debug級別）來調試映射問題，可以清晰看到屬性賦值的過程和結果。 “`

這篇文章共計約2200字，全面介紹了MyBatis中resultMap的column和property屬性的使用方法，包含基礎概念、詳細配置示例、高級技巧和實際問題解決方案，采用Markdown格式編寫，層次清晰，適合作為技術文檔參考。