萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

MyBatis 動態 SQL 核心元素詳解與最佳實務

動態 SQL 核心元素

MyBatis 提供 6 大元素構建靈活 SQL:if、choose/when/otherwise、trim、where、set、foreach。底層採用 OGNL 表達式評估條件。

1. <if> 條件包含

若參數為 null,對應片段自動省略,避免手工拼接 SQL 的空格/逗號錯誤。

2. <choose> / <when> / <otherwise> 互斥分支

類似 Java switch-case,只進入第一個滿足條件的 when,全不滿足走 otherwise。

3. <where> 智能 WHERE 子句

  • 自動插入 WHERE 關鍵字。
  • 自動去除首個 AND/OR。
  • 所有條件皆不滿足時不輸出 WHERE,查全表。

4. <trim> 靈活前後綴處理

  • prefix:內容非空時前綴。
  • prefixOverrides:移除內容開頭的指定字串(支援正則管道分隔)。
  • suffix/suffixOverrides:尾部對應功能。

5. <set> 動態 UPDATE 集合


    UPDATE t_blog
    
         title = #{title}, 
         content = #{content}, 
         owner = #{owner} 
    
    WHERE id = #{id}
  • 自動輸出 SET。
  • 移除尾部逗號。
  • 注意:若所有 if 皆 false,SET 內容為空會報錯,需確保至少一欄更新。

6. <foreach> 集合迭代(IN 條件神器)

collection 參數綁定規則

傳入參數類型collection 值Mapper 簽名範例
單參數 ListlistList<Blog> selectByIds(List<Integer> ids);
單參數 ArrayarrayList<Blog> selectByIds(Integer[] ids);
多參數 / MapMap 的 Key 名稱List<Blog> selectByIds(@Param("ids") List<Integer> ids);

實戰最佳實務

  1. 優先用 <where>、<set>,減少手工維護關鍵字。
  2. 複雜邏輯拆分多個 Mapper 方法,避免單一 XML 過度膨脹。
  3. OGNL 表達式保持簡單,複雜判斷移至 Service 層預先計算布林標記傳入。
  4. foreach 大集合分批:Oracle IN 限制 1000 項,SQL Server 參數上限 2100,超過需分批或用臨時表/TVP。
  5. 啟用 SQL 日誌(Log4j/Slf4j 設定 DEBUG 級別),開發期驗證生成 SQL 正確性。
copyright © 萬盛學電腦網 all rights reserved