Mybatis常用动态 SQL 相关标签

1. `<if>`

用于条件判断，当满足条件时执行对应的 SQL 片段。

示例:

<select id="findUser" resultType="User">SELECT * FROM usersWHERE 1=1<if test="name != null and name != ''">AND name = #{name}</if><if test="age != null and age != ''">AND age = #{age}</if>
</select>

上述示例中，如果name不为null，并且不为空时，则拼接条件name进行查询。即if条件判断为true时，才进行name拼接查询

2. `<where>`

自动处理 WHERE 子句中的逻辑，避免手动拼接 AND 或 OR 导致的 SQL 错误。

如果 <where> 内部没有任何内容，则不会生成 WHERE。
自动移除第一个条件前多余的 AND 或 OR。

示例：

<select id="findUser" resultType="User">SELECT * FROM users<where><if test="name != null and name != ''">AND name = #{name}</if><if test="age != null and age != ''">AND age = #{age}</if></where>
</select>

3. `<set>`

用于更新操作时动态生成 SET 子句，自动处理逗号分隔符。

如果 <set> 内部没有任何内容，则不会生成 SET。
自动移除最后一个逗号。

示例：

<update id="updateUser">UPDATE users<set><if test="name != null and name != ''">AND name = #{name}</if><if test="age != null and age != ''">AND age = #{age}</if></set>WHERE id = #{id}
</update>

4. `<choose>、<when>、<otherwise>`

类似于 Java 中的 switch 或 if-else 语句，用于多条件分支判断。

示例：

<select id="findUser" resultType="User">SELECT * FROM users<where><choose><when test="name != null and name != ''">name = #{name}</when><when test="email != null and email != ''">email = #{email}</when><otherwise>age > 0</otherwise></choose></where>
</select>

上述示例中：

如果name不为空，则根据name查询

如果name不为空且email不为空，则根据email查询

如果name和email都为空，则查询age大于0的

5. `<trim>`

用于自定义动态 SQL 的前缀和后缀，可以灵活控制生成的 SQL。

prefix：在SQL前添加内容。
suffix：在生成 SQL语句后添加内容。
prefixOverrides：移除指定的前缀（如多余的 AND 或 OR）。
suffixOverrides：移除指定的后缀。

示例：

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

6. `<foreach>`

用于遍历集合，常用于 IN 查询或批量插入。

collection：指定要遍历的集合名称。
item：集合中的每个元素的别名。
open：遍历开始的字符。
close：遍历结束的字符。
separator：集合项之间的分隔符。

示例：

<select id="findUsersByIds" resultType="User">SELECT * FROM usersWHERE id IN<foreach collection="ids" item="id" open="(" separator="," close=")">#{id}</foreach>
</select>

批量插入示例：

<insert id="batchInsert">INSERT INTO users (name, age)VALUES<foreach collection="list" item="user" separator=",">(#{user.name}, #{user.age})</foreach>
</insert>

7. `<bind>`

用于在 SQL 中创建变量，通常结合其他标签使用，比如正则表达式匹配。

示例：

<select id="findUserByLike" resultType="User"><bind name="pattern" value="'%' + _parameter + '%'" />SELECT * FROM usersWHERE name LIKE #{pattern}
</select>

8. `<sql>` 和 `<include>`

用于定义可重用的 SQL 片段。

<sql>：定义 SQL 片段。
<include>：引用已定义的 SQL 片段。

示例：

<sql id="userColumns">id, name, age, email
</sql><select id="findUser" resultType="User">SELECT <include refid="userColumns" /> FROM usersWHERE id = #{id}
</select>

总结

标签	功能描述
`<if>`	条件判断
`<where>`	自动生成 `WHERE` 子句
`<set>`	自动生成 `SET` 子句
`<choose>`	多条件分支判断
`<trim>`	自定义前缀和后缀
`<foreach>`	遍历集合，适用于 `IN` 查询或批量操作
`<bind>`	创建变量
`<sql>`	定义可重用的 SQL 片段
`<include>`	引用已定义的 SQL 片段