当前位置: 首页 > news >正文

MyBatis 动态 SQL 使用详解

🌟 一、什么是动态 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="ANDOR "> … `
<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>
http://www.dtcms.com/a/121886.html

相关文章:

  • MCP 服务搭建与配置学习资源部分汇总
  • 【CSS 选择器组合规则详解】
  • 2025-04-09 吴恩达机器学习6——神经网络(1):介绍
  • Spring Boot 3.x 中 WebClient 全面详解及示例
  • 文件上传漏洞原理学习
  • Synexens上海矽印 SP10 基于 DTOF 技术的单点激光雷达
  • Cursor+Claude 项目开发(辅助编程)
  • 沟通渠道混乱,信息传递延迟怎么办?
  • Redis高可用
  • 树的直径 (dp或贪心)
  • 蓝桥杯--寻找整数
  • 【教程】xrdp修改远程桌面环境为xfce4
  • 《从底层逻辑剖析:分布式软总线与传统计算机硬件总线的深度对话》
  • Mockito如何对静态方法进行测试
  • 【Claude AI大语言模型连接Blender生成资产】Windows安装Blender MCP教程
  • FreeRTOS(中断时间片任务API)
  • 微信小程序开发常用组件及用法详解
  • 如何解决Chrome浏览器安装时提示“无法连接互联网”
  • Linux入门指南:从零开始探索开源世界
  • Mysql备忘记录
  • EasyExcel导入导出
  • 雷电防护检测工作流程及重要性
  • 【愚公系列】《高效使用DeepSeek》062-图书库存管理
  • 台式电脑插入耳机没有声音或麦克风不管用
  • Dify 生成提示词的 Prompt
  • git回滚指定版本并操作
  • Llama 4的争议
  • 【重装系统】大白菜自制U盘装机,备份C盘数据,解决电脑启动黑屏/蓝屏
  • 批量合并多张 jpg/png 图片为长图或者 PDF 文件,支持按文件夹合并图片
  • 面向大模型的开发框架LangChain