MyBatis动态SQL从入门到精通：7天成为团队技术骨干

第一章：MyBatis动态SQL核心概念解析

MyBatis 作为一款优秀的持久层框架，其强大之处不仅在于简化了 JDBC 操作，更体现在对动态 SQL 的灵活支持。动态 SQL 允许开发者根据不同的业务条件构建可变的 SQL 语句，从而避免在 Java 代码中拼接 SQL 字符串带来的安全与维护问题。

动态 SQL 的作用与优势

• 提升 SQL 可读性与可维护性
• 避免手动字符串拼接引发的 SQL 注入风险
• 支持条件判断、循环、选择等逻辑控制

常用动态 SQL 标签

MyBatis 提供了多个 XML 标签用于实现动态 SQL 构建，主要包括：

标签名称	用途说明
<if>	根据条件判断是否包含某段 SQL
<choose>, <when>, <otherwise>	多路分支选择，类似 Java 中的 switch-case
<where>	智能处理 WHERE 子句，自动去除多余 AND 或 OR
<set>	用于 UPDATE 语句中动态生成 SET 部分
<foreach>	遍历集合或数组，常用于 IN 查询

示例：使用 <if> 和 <where> 构建条件查询

<select id="findUsers" parameterType="map" resultType="User">
  SELECT id, name, email FROM users
  <where>
    <if test="name != null">
      AND name LIKE CONCAT('%', #{name}, '%') <!-- 模糊匹配用户名 -->
    </if>
    <if test="email != null">
      AND email = #{email} <!-- 精确匹配邮箱 -->
    </if>
  </where>
</select>

上述代码展示了如何根据传入参数动态添加查询条件。若参数 map 中包含 name，则添加 name 条件；若包含 email，则追加 email 条件。MyBatis 会自动处理 <where> 标签内的逻辑，确保语法正确。

graph TD A[开始] --> B{参数是否为空?} B -- 是 --> C[返回空结果] B -- 否 --> D[构建动态SQL] D --> E[执行数据库查询] E --> F[返回结果列表]

第二章：动态SQL基础语法与常用标签实战

2.1 if标签的条件判断与空值处理技巧

在模板引擎中，`if` 标签是控制逻辑流程的核心工具，常用于条件渲染和数据安全校验。合理使用可有效避免空值引发的运行时错误。

基础条件判断

if user.Name != "" {
    fmt.Println("用户名：", user.Name)
}

该代码判断用户名称是否非空，防止输出空字符串。`!= ""` 是常见非空检测方式，适用于字符串类型。

多条件与空值合并处理

• 使用 `nil` 判断结构体或指针是否为空
• 结合 `len()` 检查切片、map 是否为空集合
• 利用短路求值优化判断顺序：`if user != nil && user.Age > 18`

推荐的空值安全模式

数据类型	空值判断方式
string	value == ""
slice/map	value == nil 或 len(value) == 0
pointer	value == nil

2.2 choose、when、otherwise实现多路分支逻辑

在MyBatis中，``、`` 和 `` 元素用于构建多路条件判断，类似于Java中的 `switch-case` 语句，适用于复杂的动态SQL场景。

基本语法结构

<choose>
  <when test="status == 'ACTIVE'">
    AND status = 'ACTIVE'
  </when>
  <when test="status == 'INACTIVE'">
    AND status = 'INACTIVE'
  </when>
  <otherwise>
    AND status IS NULL
  </otherwise>
</choose>

上述代码中，`` 只会执行第一个满足条件的 `` 分支。若无任何条件匹配，则执行 `` 中的内容。这种结构避免了多个条件同时生效的问题，提升了SQL生成的精确性。

• test属性：每个<when>需包含表达式，结果为布尔值
• 排他性：一旦某个<when>匹配成功，其余分支将被忽略
• 默认处理：<otherwise>作为兜底选项，确保有备选逻辑

2.3 where与trim标签构建灵活查询条件

在 MyBatis 中，`` 与 `` 标签用于动态生成 SQL 查询条件，避免手动处理 `AND` 或 `OR` 的冗余问题。

where 标签的智能处理

`` 标签会自动判断是否添加 `WHERE` 关键字，并忽略开头的 `AND` 或 `OR`。

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

当参数中 `name` 和 `age` 均非空时，生成的 SQL 为： `SELECT * FROM user WHERE name = ? AND age = ?` 即使第一个条件前有 `AND`，`` 会自动去除。

trim 标签的自定义控制

`` 提供更灵活的控制，通过属性定制前缀、后缀及需去除的关键字。

属性	作用
prefix	添加前缀（如 WHERE）
suffix	添加后缀
prefixOverrides	去除开头指定内容（如 AND）

2.4 set标签在动态更新语句中的应用

动态字段更新机制

在MyBatis等持久层框架中，`set`标签用于构建动态的UPDATE语句，仅对传入参数中非空字段生成SQL片段，避免覆盖有效数据。

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

上述代码中，``会自动处理逗号分隔问题：只保留条件成立的字段，并剔除末尾多余逗号。例如当仅`username`和`email`有值时，生成的SQL为`SET username = ?, email = ?`。

执行流程解析

• 参数对象进入映射器方法
• MyBatis解析``内各``条件
• 拼接通过校验的字段赋值语句
• 自动清除结尾冗余逗号
• 组合成完整UPDATE语句执行

2.5 foreach标签遍历集合与批量操作实践

在MyBatis中，`foreach`标签常用于构建动态SQL语句，特别适用于`IN`查询或批量插入等场景。通过遍历传入的集合或数组，可高效生成参数列表。

基本语法结构

<foreach collection="list" item="item" open="(" separator="," close=")">
    #{item}
</foreach>

其中，`collection`指定传入的集合参数名，`item`为当前元素别名，`open`和`close`定义包裹符号，`separator`为分隔符。

批量插入应用示例

• 适用于批量新增用户场景
• 减少数据库交互次数，提升性能

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

该语句将`List`集合转化为多值插入语句，显著提高执行效率。

第三章：动态SQL高级特性深入剖析

3.1 bind标签创建局部变量优化SQL可读性

在MyBatis中，`` 标签允许开发者基于现有参数创建局部变量，从而提升动态SQL的可读性和维护性。通过将复杂表达式预先绑定为简洁的变量名，SQL语句结构更清晰。

基本语法与使用场景

<select id="selectByKeyword" parameterType="map">
  <bind name="pattern" value="'%' + keyword + '%'" />
  SELECT * FROM users 
  WHERE username LIKE #{pattern}
</select>

上述代码中，`` 将拼接后的模糊查询字符串赋值给 `pattern` 变量，避免在SQL主体中直接嵌入表达式逻辑。

优势分析

• 提升SQL可读性：将重复或复杂的表达式提取为局部变量
• 增强复用性：同一变量可在多个条件中引用
• 降低出错率：减少拼写错误和逻辑冗余

3.2 动态SQL中的OGNL表达式进阶用法

在MyBatis的动态SQL中，OGNL（Object-Graph Navigation Language）表达式不仅支持基本的条件判断，还能通过方法调用、集合操作和属性访问实现复杂逻辑控制。

集合遍历与条件组合

使用OGNL可在<foreach>中直接操作集合，结合<if>实现动态过滤：

<select id="selectUsers" parameterType="map">
  SELECT * FROM user
  <where>
    <foreach item="role" collection="roles" open="AND role IN (" close=")" separator=",">
      #{role}
    </foreach>
    <if test="minAge != null">
      AND age >= #{minAge}
    </if>
  </where>
</select>

上述代码中，collection="roles"利用OGNL访问传入参数的集合属性，test="minAge != null"则通过属性存在性判断动态拼接条件。

方法调用与表达式计算

OGNL支持在表达式中调用对象方法，例如：

• test="name != null and name.length() > 0"：调用字符串的length()方法
• test="ids != null and ids.size() > 0"：判断集合非空

这种能力使得动态SQL能基于业务逻辑进行更精细的控制。

3.3 使用script注解在接口中编写动态SQL

在MyBatis中，`