iBATIS SQL Maps 入門：輕量級 ORM 替代方案的優雅實踐

iBATIS SQL Maps 入門：輕量級 ORM 替代方案的優雅實踐

研究 JPetStore 專案時接觸 iBATIS，發現其「只需懂 JavaBean、XML、SQL」的極簡設計極具吸引力。本文提煉官網核心特性與最小化範例，展示如何用純 SQL 完成資料庫到物件的映射，告別繁瑣 JDBC 樣板代碼。

為什麼選 iBATIS SQL Maps？

官網列出的 10 大特性（倒序）：

1. 你已經懂 SQL，何必再學新東西？
2. 資料庫設計從不完美（無需改動即可映射）。
3. 物件模型從不完美（無需改動即可映射）。
4. 支援複雜物件映射（List、巢狀物件圖）。
5. 支援 JavaBean（get/set）、Map、Collection、基本型別包裝類。
6. 簡單 XML 映射文檔結構。
7. 本地與全域事務支援（JTA）。
8. 可配置快取（含依賴管理）。
9. 任何有 JDBC 驅動的資料庫皆可用（無需外掛）。

核心哲學：**SQL 是資產，映射是橋樑，物件是目標。**

最小化依賴

• ibatis-common.jar（公用工具）
• ibatis-sqlmap.jar（核心框架）

映射檔片段：Address.xml

<select id="getAddress" resultClass="examples.domain.Address" parameterClass="int">
  SELECT
    ADR_ID          AS id,
    ADR_DESCRIPTION AS description,
    ADR_STREET      AS street,
    ADR_CITY        AS city,
    ADR_PROVINCE    AS province,
    ADR_POSTAL_CODE AS postalCode
  FROM ADDRESS
  WHERE ADR_ID = #value#
</select>

關鍵點：#value# 為參數佔位符（對應 parameterClass="int"）；AS 別名自動對應 JavaBean 屬性。

Java 呼叫代碼

Integer pk = new Integer(5);
Address address = (Address) sqlMap.queryForObject("getAddress", pk);
// 完成！address 物件已填滿資料庫欄位值。

無需寫 Connection、PreparedStatement、ResultSet、手動映射欄位、關閉資源——全部由框架托管。

進階功能一覽

• 動態 SQL：<isEqual>、<isNotNull> 等標籤構建條件查詢。
• 結果映射：<resultMap> 處理複雜關聯（一對多、多對一、繼承）。
• 快取模型：LRU、FIFO、OSCACHE 等多種策略，支援依賴失效。
• 事務管理：程式化/宣告式（Spring 整合無縫）。
• 分頁查詢：queryForList(statement, param, skip, max)。

適用場景與選型建議

更多中文教程請見 iBATIS 官網。iBATIS 3.x 已更名為 MyBatis，新專案建議直接使用 MyBatis。