java怎么用MyBatis实现动态SQL 学习MyBatis动态SQL语法与配置

MyBatis通过<if>、<where>、<set>、<foreach>和<choose>等标签实现动态SQL，支持条件查询、分支选择、集合遍历和字段更新，自动处理关键字与语法错误，避免SQL注入，提升开发效率。

MyBatis 的强大之处在于它支持动态 SQL，能够根据不同的条件拼接 SQL 语句，避免拼接字符串的麻烦和潜在的 SQL 注入风险。在实际开发中，查询条件往往是可变的，比如用户可能只填了部分搜索项，这时就需要动态地构建 WHERE 条件。

1. 使用 <where> 和 <if> 构建条件查询

最常见的动态 SQL 场景是带条件的 SELECT 查询。MyBatis 提供了 <if> 标签来判断某个参数是否有效，并结合 <where> 自动处理 AND 或 OR 的开头问题。

<select id="findUsers" parameterType="map" resultType="User">
  SELECT id, name, age, email FROM users
  <where>
    <if test="name != null and name != ''">
      AND name LIKE CONCAT('%', #{name}, '%')
    </if>
    <if test="age != null">
      AND age >= #{age}
    </if>
  </where>
</select>

说明：
- test 属性 中写的是 OGNL 表达式，用于判断参数是否满足条件。
- <where> 会自动去除第一个多余的 AND 或 OR，避免语法错误。

2. 使用 <choose>、<when>、<otherwise> 实现分支逻辑

类似于 Java 中的 switch-case，<choose> 可以实现多个互斥条件中的一个生效。

<select id="findUserByStrategy" parameterType="map" resultType="User">
  SELECT id, name, age FROM users
  <where>
    <choose>
      <when test="id != null">
        id = #{id}
      </when>
      <when test="name != null">
        name LIKE CONCAT('%', #{name}, '%')
      </when>
      <otherwise>
        age > 18
      </otherwise>
    </choose>
  </where>
</select>

这个例子中，只会使用 id、name 或默认条件之一，适合“优先级选择”类场景。

立即学习“Java免费学习笔记（深入）”；

3. 使用 <foreach> 处理集合遍历（如 IN 查询）

当需要对集合或数组进行遍历（比如 IN 查询），可以使用 <foreach> 标签。

<select id="findUsersByIds" parameterType="list" resultType="User">
  SELECT id, name, age FROM users
  WHERE id IN
  <foreach item="id" index="index" collection="list"
           open="(" separator="," close=")">
    #{id}
  </foreach>
</select>

说明：
- collection 指定传入的集合类型（List、Array 等）。
- item 是循环中每个元素的别名。
- open 和 close 定义包裹符号，separator 是分隔符。

4. 使用 <set> 动态更新字段

在 UPDATE 语句中，<set> 可以自动添加 SET 关键字并去除末尾多余的逗号。

Insou AI

Insou AI 是一款强大的人工智能助手，旨在帮助你轻松创建引人入胜的内容和令人印象深刻的演示。

下载

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

这样即使某些字段为空，也不会影响 SQL 的正确性。

5. 使用 <trim> 自定义前缀/后缀处理

<trim> 是更灵活的标签，可以替代 <where> 和 <set>。

例如，自定义 where 逻辑：

<trim prefix="WHERE" prefixOverrides="AND |OR ">
  <if test="name != null">AND name = #{name}</if>
  <if test="age != null">OR age = #{age}</if>
</trim>

prefix 表示添加前缀，prefixOverrides 表示去除开头的指定内容。

基本上就这些常用语法。掌握 if、where、set、foreach、choose 这几个标签，就能应对大多数动态 SQL 场景。关键是理解 test 判断条件的写法和参数传递方式（Map、对象、List 等）。配置上无需额外设置，只要 Mapper XML 正确引用即可。