🌟 一、什么是動態 SQL？

動態 SQL 是指根據傳入參數，動態拼接生成 SQL 語句，不需要寫多個 SQL 方法。MyBatis 提供了 <if>、<choose>、<foreach>、<where> 等標簽來實現這類操作

---

? 二、動態 SQL 的優點

優點	說明
?? 靈活	同一個 SQL 根據不同參數拼接不同條件（if / where），非常適合查詢頁面
?? 減少代碼重復	比如模糊搜索功能，不再需要寫多個 SQL 接口方法
?? 可讀性強（配合 XML）	結構清晰，尤其用 <where> / <set> / <foreach>
?? SQL 控制權在開發者手中	和 Hibernate/JPA 相比，MyBatis 更易于優化復雜 SQL
?? 易于維護多條件組合查詢	如管理后臺的搜索表單、動態篩選等功能

---

? 三、動態 SQL 的缺點

缺點	說明
? 編寫略繁瑣	XML 寫法需要嵌套多個標簽，容易出錯，特別是嵌套復雜條件時
? 可讀性下降（過度嵌套）	動態 SQL 太復雜時，XML 顯得臃腫不易讀
? 不利于 IDE 自動提示	邏輯寫在 XML 中，IDE 很難做類型檢查和智能提示
? SQL 拼接錯誤不易發現	某些條件組合可能拼錯 SQL，運行期才報錯
? 與注解風格沖突	注解方式不支持復雜的動態 SQL，只能用 XML 實現動態拼接

---

🛠? 四、動態 SQL 適用場景

? 最適合的場景：

場景	舉例
🔍 條件查詢頁面	多條件組合搜索，如：用戶列表查詢、訂單篩選、日志檢索
📋 后臺管理系統	如 admin 頁面支持 name、status、時間區間等動態條件
📊 報表查詢系統	查詢維度、范圍、排序條件全是動態的
🧩 批量操作	如 IN 查詢、批量更新、刪除（用 <foreach>）
📌 多字段更新	UPDATE 語句中字段非空才更新（用 <set> 標簽）

---

? 不推薦使用的場景：

場景	原因
常規增刪改查	邏輯簡單，不需要動態拼接
SQL 條件固定	寫死 SQL 語句更清晰、維護方便
條件復雜但變化不大	建議寫多個 SQL 方法，避免 XML 太臃腫

---

🔍 五、小結一張表

點評維度	動態 SQL 表現
靈活性	????? 超高
編寫復雜度	???? 中等偏高
可維護性	??? 中等
性能控制	????? 好
推薦場景	多條件查詢、批量操作

---

? 示例對比

? 使用動態 SQL：

<select id="searchUser" resultType="User">SELECT * FROM user<where><if test="name != null"> AND name LIKE CONCAT('%', #{name}, '%')</if><if test="age != null"> AND age = #{age}</if></where>
</select>

? 不使用動態 SQL（需要寫多個方法）：

<select id="findByName" ...>SELECT * FROM user WHERE name = #{name}</select>
<select id="findByAge" ...>SELECT * FROM user WHERE age = #{age}</select>
<select id="findByNameAndAge" ...>SELECT * FROM user WHERE name = #{name} AND age = #{age}</select>

---

🧩 MyBatis 動態 SQL 標簽速查表

標簽	作用	示例	注意事項
<if>	條件判斷	<if test="name != null">AND name = #{name}</if>	test 支持 OGNL 表達式，如 != null && name != ''
<choose> <when> <otherwise>	分支選擇（類似 switch-case）	見下方示例	只能命中一個 <when>，類似 if…else
<trim>	自定義前綴、后綴、去掉多余的分隔符	`<trim prefix=“WHERE” prefixOverrides="AND	OR "> … `
<where>	自動加 WHERE 并去掉首個 AND/OR	<where><if test="...">AND ...</if></where>	自動處理空條件時避免語法錯誤
<set>	自動加 SET 并去掉多余逗號（用于 UPDATE）	<set><if test="...">name=#{name},</if></set>	適用于動態更新字段
<foreach>	遍歷集合，構造 IN 語句、批量插入等	見下方示例	支持 list、array、Map，常用于 IN (...)
<bind>	創建一個變量，可用于字符串拼接等	<bind name="pattern" value="'%' + name + '%'" />	常配合模糊查詢使用

---

📚 示例合集

1?? <if> 使用示例

<select id="selectUser" resultType="User">SELECT * FROM user<where><if test="name != null and name != ''">AND name LIKE CONCAT('%', #{name}, '%')</if><if test="age != null">AND age = #{age}</if></where>
</select>

---

2?? <choose> / <when> / <otherwise> 示例

<select id="selectUser" resultType="User">SELECT * FROM user<where><choose><when test="name != null">AND name = #{name}</when><when test="age != null">AND age = #{age}</when><otherwise>AND status = 'active'</otherwise></choose></where>
</select>

---

3?? <trim> 示例（手動 WHERE 拼接）

<select id="selectUser" resultType="User">SELECT * FROM user<trim prefix="WHERE" prefixOverrides="AND |OR "><if test="name != null">AND name = #{name}</if><if test="age != null">AND age = #{age}</if></trim>
</select>

---

4?? <set> 示例（動態更新）

<update id="updateUser">UPDATE user<set><if test="name != null">name = #{name},</if><if test="age != null">age = #{age},</if></set>WHERE id = #{id}
</update>

---

5?? <foreach> 示例（IN 查詢）

<select id="selectByIds" resultType="User">SELECT * FROM user WHERE id IN<foreach collection="idList" item="id" open="(" separator="," close=")">#{id}</foreach>
</select>

語法片段	含義
id="selectByIds"	這是 Mapper 接口中方法對應的 SQL ID
resultType="User"	查詢結果會映射成 User 類
collection="idList"	傳入的是一個集合參數名，比如一個 List<Integer> 類型的參數
item="id"	遍歷集合中的每個元素，當前元素命名為 id
open="("	拼接 SQL 時，開頭加一個左括號 (
separator=","	每個參數之間用逗號隔開
close=")"	最后一個參數后加上右括號 )
#{id}	當前遍歷元素的值，作為 SQL 參數傳入（防 SQL 注入）

6?? <bind> 示例（模糊搜索）

<select id="searchByName" resultType="User"><bind name="pattern" value="'%' + name + '%'" />SELECT * FROM user WHERE name LIKE #{pattern}
</select>

部分	解釋
<select id="searchByName">	定義一個 SQL 查詢方法，ID 是 searchByName
resultType="User"	查詢結果會封裝成 User 對象
<bind name="pattern" value="'%' + name + '%'"/>	MyBatis 提供的 <bind> 標簽： 動態創建一個變量 pattern，它的值是 '%xxx%' 這樣的字符串，供后面 SQL 使用
value="'%' + name + '%'"	拼接模糊匹配字符串（注意這里的 '%' 是字符串，需要加單引號）
#{pattern}	MyBatis 會將 pattern 的值安全地替換進 SQL，防止 SQL 注入

---

📌 小技巧總結

目標	建議用法
多條件查詢	<where> 或 <trim> 配合 <if>
動態更新字段	<set> 配合 <if>
IN 查詢	<foreach>
模糊搜索	<bind>
模擬 if…else	<choose>