MyBatis 动态 SQL 完整笔记

MyBatis 动态 SQL 完整笔记

一、核心动态 SQL 标签与用法

1. 条件控制类标签

• <if>：基础条件判断
  示例：根据 name 和 age 动态筛选用户

  <if test="name != null and name != ''">
    AND user_name = #{name}
  </if>
  

• <choose>/<when>/<otherwise>：多条件分支
  示例：类似 Java 的 switch-case，优先匹配首个满足条件的 <when>

  <choose>
    <when test="type == 'admin'">AND role = 'admin'</when>
    <otherwise>AND role = 'guest'</otherwise>
  </choose>
  

2. 语法修正类标签

• <where>：自动处理 WHERE 关键字和首条条件前的 AND/OR

  <where>
    <if test="age != null">AND age = #{age}</if>
  </where>
  

• <trim>：更灵活的语法修正（替代 <where> 或 <set>）
  示例：自定义前缀/后缀及需删除的字符

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

• <set>：自动处理 UPDATE 语句的 SET 子句
  示例：动态更新字段并去除末尾逗号

  <set>
    <if test="name != null">name=#{name},</if>
    <if test="age != null">age=#{age}</if>
  </set>
  

3. 集合处理类标签

• <foreach>：遍历集合（批量操作/IN 查询）

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

• <bind>：预定义变量（优化模糊查询等场景）

  <bind name="namePattern" value="'%' + name + '%'"/>
  WHERE username LIKE #{namePattern}
  

二、性能优化与最佳实践

1. OGNL 表达式优化

• 避免复杂嵌套表达式，优先在 Java 层处理判断逻辑

  <if test="@com.utils.MyBatisUtils@isValid(name)">
  

2. 批量操作优化

• 使用 BATCH 模式执行 SqlSession，减少数据库连接开销
• 分批次处理超大数据集（如每 1000 条提交一次）

3. 缓存策略

• 二级缓存配置（Mapper 级别，跨会话共享）

  <mapper namespace="com.UserMapper">
    <cache eviction="LRU" flushInterval="60000"/>
  </mapper>
  

• 注意脏读问题：更新操作后手动清除缓存

  <update id="updateUser" flushCache="true">
  

三、高频场景实战示例

1. 动态排序与分页

<select id="selectUsers" resultMap="UserResultMap">
  SELECT * FROM users
  <where>
    <if test="orderBy != null">
      ORDER BY ${orderBy} <!-- 注意 SQL 注入风险 -->
    </if>
    <if test="offset >=0 and limit >0">
      LIMIT #{offset}, #{limit}
    </if>
  </where>
</select>

2. 多字段模糊查询

<bind name="searchKey" value="'%' + key + '%'"/>
<where>
  (title LIKE #{searchKey} OR content LIKE #{searchKey})
</where>

3. 批量插入优化

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

四、安全与规范

1. 防 SQL 注入

• 禁止直接拼接 ${} 参数（除非绝对可信）
• 使用 #{} 预编译参数化查询

2. 参数校验

• 集合判空：<if test="list != null and !list.isEmpty()">
• 字符串处理：<if test="name != null and name.trim() != ''">

3. 类型安全

• 显式声明 jdbcType（避免 NULL 类型推断错误）

  #{age,jdbcType=INTEGER}
  

五、高级特性

1. 注解动态 SQL

@SelectProvider(type = UserSqlBuilder.class, method = "buildQuery")
List<User> findUsers(UserQuery query);

2. 动态表名映射

<select id="selectByTable" resultType="map">
  SELECT * FROM ${tableName}
</select>

最佳实践总结

1. 优先使用 <where>/<set> 替代手动处理 SQL 语法
2. 复杂条件判断应前移至 Java 代码处理
3. 批量操作需配合数据库连接池优化
4. 高频读场景启用二级缓存，但注意数据一致性
5. 使用 <bind> 统一处理格式转换（如日期/模糊查询）