MyBatis 动态 SQL 优化：标签的实战与技巧

权^2025-03-24 8:56

目录

动态SQL详解

动态SQL是一种在运行时生成和执行SQL语句的技术，广泛应用于处理复杂查询条件和动态数据需求。以下是动态SQL的核心概念、常见用法及注意事项。

一、动态SQL的核心概念

1.1 什么是动态SQL？

动态SQL是一种灵活的SQL编写方式，允许开发者在程序运行时根据条件生成SQL语句，而不是在编译时固化。动态 SQL 是Mybatis的强大特性之一，能够完成不同条件下不同的 SQL拼接。

1.2 动态SQL的优点

  • 灵活性：根据不同条件生成不同的SQL语句。
  • 复用性：减少重复代码，提高代码维护性。
  • 性能：在某些场景下可以优化查询性能。

1.3 动态SQL的常见用途

  • 处理多条件查询。
  • 动态指定表名、字段或排序方式。
  • 处理批量操作。

二、动态SQL的常见用法（XML方式）

数据库数据信息

2.1 < if > 标签

主要用于在动态SQL中根据条件判断是否执行某个SQL片段。它可以根据传入的参数或条件动态地添加或移除SQL语句的一部分，从而实现灵活的查询需求。

UserInfoMapperXML.java 接口代码

java 复制代码 
 Integer insertUserBySQL(UserInfo userInfo);

UserInfoMapper.xml 文件

java 复制代码 
    <insert id="insertUserBySQL">
        insert into user_info (
        username,
        password,
        age,
        <if test="gender!=null">
            gender,
        </if>
        phone)
        values(
        #{username},
        #{password},
        #{age},
        <if test="gender!=null">
            #{gender},
        </if>
        #{phone})
    </insert>

测试类没有插入gender的情况：

java 复制代码 
    @Test
    void insertUserBySQL() {
        UserInfo userInfo=new UserInfo();
        userInfo.setUsername("qq");
        userInfo.setPassword("qq");
        userInfo.setAge(46);
        userInfo.setPhone("465131");
        userInfoMapperXML.insertUserBySQL(userInfo);
    }

运行结果：

可以看到把gender这个字段使用if标签之后，这个字段就被移除了。

2.2< trim>标签

trim标签在动态SQL中起到格式化SQL语句的作用，允许开发者在生成SQL时自动处理空格、换行符以及前缀后缀的添加。通过合理使用trim标签，可以简化动态SQL的开发，提高代码的可读性和维护性，同时确保生成的SQL语句高效且正确。

prefix ：表示整个语句块，以prefix的值作为前缀
suffix ：表示整个语句块，以suffix的值作为后缀
prefixOverrides ：表示整个语句块要去除掉的前缀
suffixOverrides：表示整个语句块要去除掉的后缀

为了更好的了解trim标签的作用，先来个错误的示范。

XML.java 文件

java 复制代码 
Integer insertUserBySQL1(UserInfo userInfo);

.xml文件

java 复制代码 
    <insert id="insertUserBySQL1">
        insert into user_info
        <trim prefix="(" suffix=")" >
    <if test="username!=null">
        username,
    </if>
            <if test="password!=null">
                password,
            </if>
            <if test="age!=null">
                age,
            </if>
            <if test="gender!=null">
                gender,
            </if>
            <if test="phone!=null">
                phone
            </if>
        </trim>
        values
        <trim suffix="(" prefix=")" >
            <if test="username!=null">
                #{username},
            </if>
            <if test="password!=null">
                #{password},
            </if>
            <if test="age!=null">
                #{age},
            </if>
            <if test="gender!=null">
                #{gender},
            </if>
            <if test="phone">
                #{phone}
            </if>
        </trim>
    </insert>

测试类

java 复制代码 
 @Test
    void insertUserBySQL1() {
        UserInfo userInfo=new UserInfo();
        userInfo.setUsername("zhangs");
        userInfo.setPassword("123461");
        userInfo.setPhone("7489");
        userInfoMapperXML.insertUserBySQL1(userInfo);

运行结果：

修改 .xml文件，通过trim标签给SQL语句添加或者去除前后缀。

再进行测试；

可以看到成功了。

2.3 <where>标签

标签用于在动态SQL中自动处理WHERE子句的生成，简化多条件查询的开发。它能自动处理逻辑连接词（如AND、OR）以及去除多余的关键字，使得代码更加简洁和高效。
XML.java文件代码：

java 复制代码 
List<UserInfo> selectByWhere();

.xml文件代码

java 复制代码 
  <select id="selectByWhere" resultType="com.sliqvers.model.UserInfo">
            select * from user_info
        <where>
            <if test="username!=null">
                and username=#{username}
            </if>
            <if test="password!=null">
                or password=#{password}
            </if>
        <if test="age!=null">
            and age=#{age}
        </if>
            <if test="phone!=null">
             or   phone=#{phone}
            </if>
        </where>
    </select>

测试类

java 复制代码 
  @Test
    void selectByWhere() {
        userInfoMapperXML.selectByWhere().stream().forEach(x-> System.out.println(x));
    }

生成的SQL：

当username和phonel都有值：
SELECT * FROM user_info WHERE username = ? AND phone =?;

当只有username有值：
SELECT * FROM user_info WHERE username =?;

当两者都为null：
SELECT * FROM user_info;

2.4<set>标签

标签在UPDATE语句中起到动态设置字段值的作用，自动处理SET关键字和逗号，避免空更新。通过合理使用<set>标签，可以简化代码，提高SQL执行效率，确保系统的安全性和稳定性。
XML.java文件

java 复制代码 
 Integer upadteUserSql(UserInfo userInfo);

.xml文件

java 复制代码 
    <update id="upadteUserSql">
        update user_info
        <set>
            <if test="password!=null">
                password = #{password} ,
            </if>
            <if test="username!=null">
                username = #{username},
            </if>
        </set>
        where id=#{id}
    </update>

测试类：

java 复制代码 
    @Test
    void upadteUserSql() {
        UserInfo userInfo=new UserInfo();
        userInfo.setUsername("Sliqvers");
        userInfo.setPassword("111111");
        userInfo.setId(1);
        userInfoMapperXML.upadteUserSql(userInfo);
    }

运行结果：

生成的SQL：

当username和password都有值：
UPDATE user_info SET username = ?, email = ? WHERE id = ?

当只有username有值：
UPDATE user_info SET username = ? WHERE id = ?

当只有password有值：
UPDATE users_info SET password = ? WHERE id = ?

当两者都为null：
UPDATE user_info WHERE id = ?

2.5 <foreach> 标签

<foreach>标签在动态SQL中起到遍历集合或数组的作用，生成IN子句、批量INSERT或UPDATE等操作。通过合理使用标签，可以简化批量操作的SQL拼接，提高开发效率和系统性能。同时，注意避免SQL注入和空集合处理等问题，可确保动态SQL的安全性和可靠性。

<foreach> 标签的属性

collection：必填，指定要遍历的集合名。

item：必填，指定遍历时的变量名。

open：可选，遍历开始时添加的字符串。

close：可选，遍历结束时添加的字符串。

separator：可选，遍历时的分隔符（默认","）。

index：可选，遍历时的索引变量。

select：可选，用于嵌套查询。
XML.java接口

java 复制代码 
  List<UserInfo> selectBySql(List<Integer> ids);

.xml文件

java 复制代码 
    <select id="selectBySql" resultType="com.sliqvers.model.UserInfo">
        select * from user_info where id in
        <foreach collection="ids" open="(" close=")" separator="," item="id">
            #{id}
        </foreach>
    </select>

测试类

java 复制代码 
    @Test
    void selectBySql() {
        List<Integer> ids=new ArrayList<>();
        ids.add(1);
        ids.add(2);
        ids.add(3);
        userInfoMapperXML.selectBySql(ids).stream().forEach(x-> System.out.println(x));
    }

运行结果：

生成的SQL：

ids = [1, 2, 3] 时：
SELECT * FROM user_info WHERE id IN (1, 2, 3)

2.6 <include>标签

在xml映射⽂件中配置的SQL，有时可能会存在很多重复的片段，此时就会存在很多冗余的代码,我们可以对重复的代码片段进行抽取，将其通过 <sql> 标签封装到⼀个SQL片段，然后再通过<include> 标签进行引用。
定义一个常用的WHERE条件

java 复制代码 
<sql id="allColumn">
 id, username, age, gender, phone, delete_flag, create_time, update_time
</sql>

通过 <include> 标签在原来抽取的地方进行引用。操作如下：

java 复制代码 
<select id="queryAllUser" resultMap="BaseMap">
 select
 <include refid="allColumn"></include>
 from user_info
</select>

三、动态SQL的注意事项

3.1 SQL注入问题(搞破坏)

  • 风险：直接拼接用户输入可能导致SQL注入。
  • 解决方案：使用参数化查询或ORM框架（如MyBatis）提供的安全功能。

3.2 performance

  • 执行计划缓存：动态SQL可能导致数据库无法有效利用执行计划缓存。
  • 优化建议：尽量减少动态SQL的使用场景，或者使用有限的条件组合。

3.3 动态SQL的可读性和维护性

  • 复杂性：动态SQL可能使代码更难阅读和维护。
  • 建议：合理分层代码，遵循编码规范。

四、总结

本文通过详细的示例和实际应用场景，介绍了如何有效利用这些标签来优化 MyBatis 配置，提升开发效率，确保 SQL 的高效执行和安全性。学习这些技巧，帮助开发者更高效地构建和维护数据库交互层。

相关推荐
喻师傅11 分钟前
横扫SQL面试——事件流处理（峰值统计）问题
大数据·sql·面试
Chandler2412 分钟前
Redis：List 类型 内部实现、编码、命令及应用场景
数据结构·数据库·redis·缓存·list
qq_3392822315 分钟前
优化 MariaDB 的恢复流程
数据库·mariadb
yuyuyuliang0036 分钟前
Qt SQL-2
数据库·sql·qt
软件工匠师2 小时前
MySQL 设置允许远程连接完整指南：安全与效率并重
数据库·mysql·安全
你好龙卷风！！！9 小时前
mac m4 Homebrew安装MySQL 8.0
数据库·mysql·macos
binnnngo9 小时前
Spring Boot集成阿里云OSS：对象存储实战指南
数据库·spring boot·阿里云
程序猿ZhangSir9 小时前
Redis 和 MySQL双写一致性的更新策略有哪些？常见面试题深度解答。
java·数据库·spring boot·redis·mysql·缓存·mybatis
StarRocks_labs10 小时前
【活动回顾】StarRocks Singapore Meetup #2 @Shopee
数据库·starrocks·数据分析·spark·olap·物化视图·apache druid
热门推荐
01DeepSeek各版本说明与优缺点分析02RAG 实践- Ollama+RagFlow 部署本地知识库03如何在WPS和Word/Excel中直接使用DeepSeek功能04FreeCAD傻瓜教程之创建参数化几何图形-螺旋体、平面、球体、椭球体、圆柱体、圆锥体、棱柱、椭圆05本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07SQL 集合运算08苍穹外卖面试总结09DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具10【汽车ECU电控数据管理篇】HEX文件格式解析篇章