掌握MyBatis动态SQL：从标签到实战的全面解析

前言
在我们日常的软件开发中，很多时候都会涉及到与数据库的交互操作。在使用MyBatis框架进行数据库操作时，我们可以利用它提供的一系列XML标签来构建动态SQL语句，以满足不同的业务需求。
.
本文主要探讨了如何使用MyBatis的, , , , , , , 等标签来构建动态SQL语句。我们将通过一个妖怪信息查询和更新的实例来展示这些标签的具体用法和测试方法。
.
这个教程将指导你一步步实现各种基于条件的SQL查询和更新，每个部分都提供了具体的需求描述和相应的Java和XML代码实现。

个人主页：尘觉主页

个人简介：大家好，我是尘觉，希望我的文章可以帮助到大家，您的满意是我的动力

在csdn获奖荣誉: csdn城市之星2名
⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　Java全栈群星计划top前5
⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　 端午大礼包获得者
⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　阿里云专家博主
⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　⁣⁣⁣⁣　亚马逊DyamoDB结营

欢迎大家：这里是CSDN，我总结知识的地方，欢迎来到我的博客，感谢大家的观看
如果文章有什么需要改进的地方还请大佬不吝赐教 先在次感谢啦

掌握MyBatis动态SQL：从标签到实战的全面解析

动态SQL-官方文档

文档地址: https://mybatis.org/mybatis-3/zh/dynamic-sql.html

为什么需要动态SQL

1、动态 SQL 是 MyBatis 的强大特性之一

2、使用 JDBC 或其它类似的框架，根据不同条件拼接 SQL 语句非常麻烦，例如拼接时要确保不能忘记添加必要的空格，还要注意去掉列表最后一个列名的逗号等

3、 SQL 映射语句中的强大的动态 SQL 语言, 可以很好的解决这个问题.

动态SQL-基本介绍

1. 在一个实际的项目中，sql 语句往往是比较复杂的
2. 为了满足更加复杂的业务需求，MyBatis 的设计者，提供了动态生成SQL 的功能。

动态SQL 必要性

1. 比如我们查询Monster 时，如果程序员输入的age 不大于0, 我们的sql语句就不带age 。
2. 更新Monster 对象时，没有设置的新的属性值，就保持原来的值，设置了新的值，才更新.

解决方案分析

1. 从上面的需求我们可以看出，有时我们在生成 sql 语句时，在同一个方法中，还要根据不同的情况生成不同的sql 语句.

2. 解决方案: MyBatis 提供的动态SQL 机制.

动态SQL 常用标签

似我们Java 的控制语句：

1. if [判断]
2. where [拼接 where 子句]
3. choose/when/otherwise [类似java 的 switch 语句, 注意是单分支]
4. foreach [类似 in ]
5. trim [替换关键字/定制元素的功能]
6. set [在update 的 set 中，可以保证进入 set 标签的属性被修改，而没有进入set 的，保持原来的值]

动态SQL-案例演示

新建Module dynamic-sql

1、在原来的项目中，新建 dynamic-sql 项目演示动态SQL 的使用
链接
2、新建 Module 后，先创建需要的包，再将需要的文件/资源拷贝过来(这里我们拷贝Monster.java、resources/jdbc.properties 和 mybatis-config.xml)

3、创建 MonsterMapper.java MonsterMapper.xml 和 MonsterMapperTest.java , 做一个比
较干净的讲解环境,

if 标签应用实例

需求：请查询age 大于 10 的所有妖怪，如果程序员输入的age 不大于 0, 则输出所有的妖怪!

修改 MonsterMapper.java

/**
 * 1. 这是一个接口
 * 2. 该接口用于声明操作monster表的方法
 * 3. 这些方法可以通过注解或者xml文件来实现
 */
public interface MonsterMapper {
   
    //根据age查询结果
    public List<Monster> findMonsterByAge(@Param(value = "age") Integer age);
}

修改 MonsterMapper.xml

    
    
        SELECT * FROM `monster` WHERE 1 = 1
        
            AND age > #{age}
        
    

修改 MonsterMapperTest.java 并完成测试

public class MonsterMapperTest {

    //属性
    private SqlSession sqlSession;
    private MonsterMapper monsterMapper;

    //初始化
    @Before
    public void init() {

        sqlSession = MyBatisUtils.getSqlSession();
        monsterMapper = sqlSession.getMapper(MonsterMapper.class);
        System.out.println("monsterMapper=" + monsterMapper.getClass());
    }

    @Test
    public void findMonsterByAge() {
        List<Monster> monsters =
                monsterMapper.findMonsterByAge(-1);
        for (Monster monster : monsters) {
            System.out.println("monster--" + monster);
        }
        if (sqlSession != null) {
            sqlSession.close();
        }
        System.out.println("操作成功~");
    }
}

where 标签应用实例

需求：查询id 大于 20 的，并且名字是 “牛魔王” 的所有妖怪, 注意，如果名字为空，或者输入的 id 小于 0, 则不拼接 sql 语句(梳理：如果名字为空 , 就不带名字条件,如果输入的id 小于 0, 就不带id的条件)

修改MonsterMapper.java

    //根据id和名字来查询结果
    public List<Monster> findMonsterByIdAndName(Monster monster);

修改MonsterMapper.xml

    
        SELECT * FROM `monster`
        
            
                AND `id` > #{id}
            
            
                AND `name` = #{name}
            
        
    

修改MonsterMapperTest.java 并完成测试

@Test
    public void findMonsterByIdAndName() {
        Monster monster = new Monster();
        monster.setId(1);
        monster.setName("牛魔王-100");

        List<Monster> monsters = monsterMapper.findMonsterByIdAndName(monster);
        for (Monster m : monsters) {
            System.out.println("m--" + m);
        }

        if (sqlSession != null) {
            sqlSession.close();
        }
        System.out.println("操作成功~");
    }

choose/when/otherwise 应用实例

需求：如果给的name 不为空，就按名字查询妖怪，如果指定的id>0，就按id 来查询妖怪， 要求使用 choose/when/otherwise 标签实现, 传入参数要求使用Map

修改MonsterMapper.java

    //测试choose标签的使用
    public List<Monster> findMonsterByIdOrName_choose(Map<String, Object> map);

修改MonsterMapper.xml

    
    
        SELECT * FROM `monster`
        
            
                WHERE `name` = #{name}
            
            
                WHERE `id` > #{id}
            
            
                WHERE `salary` > 100
            
        
    

修改MonsterMapperTest.java 并完成测试

    @Test
    public void findMonsterByIdOrName_choose() {

        Map<String, Object> map = new HashMap<>();
        //map.put("name", "牛魔王-100");
        map.put("id", -1);

        List<Monster> monsters = monsterMapper.findMonsterByIdOrName_choose(map);
        for (Monster monster : monsters) {
            System.out.println("monster--" + monster);
        }

        if (sqlSession != null) {
            sqlSession.close();
        }
        System.out.println("操作成功~");
    }

forEach 标签应用实例

需求：查询monster_id 为 20, 22, 34 的妖怪

修改MonsterMapper.java

    //测试foreach的标签使用
    public List<Monster> findMonsterById_forEach(Map<String, Object> map);

修改MonsterMapper.xml

    
        SELECT * FROM `monster`
        
        
            
                id IN
                
                    #{id}
                
            
        
    

修改MonsterMapperTest.java 并完成测试

 @Test
    public void findMonsterById_forEach() {

        Map<String, Object> map = new HashMap<>();
        map.put("ids", Arrays.asList(10, 12, 14));

        List<Monster> monsters =
                monsterMapper.findMonsterById_forEach(map);

        for (Monster monster : monsters) {
            System.out.println("monster--" + monster);
        }


        if (sqlSession != null) {
            sqlSession.close();
        }
        System.out.println("操作成功~");

    }

trim 标签应用实例【使用较少】

trim 可以替换一些关键字.要求：按名字查询妖怪，如果 sql 语句有 and | or 就替换成where

修改MonsterMapper.java

 //trim标签的使用
    public List<Monster> findMonsterByName_Trim(Map<String, Object> map);

修改MonsterMapper.xml

    
    
        SELECT * FROM `monster`

        
            
                AND `name` = #{name}
            
            
                AND `age` > #{age}
            
        
    

修改MonsterMapperTest.java 并完成测试

 @Test
    public void findMonsterByName_Trim() {
        Map<String, Object> map = new HashMap<>();
        map.put("name", "牛魔王-100");
        map.put("age", 10);

        List<Monster> monsters =
                monsterMapper.findMonsterByName_Trim(map);

        for (Monster monster : monsters) {
            System.out.println("monster--" + monster);
        }

        if (sqlSession != null) {
            sqlSession.close();
        }
        System.out.println("操作成功~");

    }

set 标签应用实例[重点]

需求: 请对指定id 的妖怪进行 修改，如果没有设置新的属性，则保持原来的值

修改MonsterMapper.java

    //测试Set标签
    public void updateMonster_set(Map<String, Object> map);

修改MonsterMapper.xml

   
    
        UPDATE `monster`
        
            
                `age` = #{age} ,
            
            
                `email` = #{email} ,
            
            
                `name` = #{name} ,
            
            
                `birthday` = #{birthday} ,
            
            
                `salary` = #{salary} ,
            
            
                `gender` = #{gender} ,
            
        
        WHERE id = #{id}
    

修改MonsterMapperTest.java 并完成测试

    @Test
    public void updateMonster_set() {
        Map<String, Object> map = new HashMap<>();
        map.put("id", 3);
        map.put("name", "牛魔王5-100");
        map.put("age", 76);
        map.put("email", "[email protected]");

        monsterMapper.updateMonster_set(map);

        //修改需要有commit
        if (sqlSession != null) {
            sqlSession.commit();
            sqlSession.close();
        }
        System.out.println("操作成功~");
    }

总结

通过本篇，我们详细探讨了MyBatis中多个XML标签在构建动态SQL语句时的应用，包括但不限于条件判断、选择语句、循环语句及字符串替换等。

通过本本篇的实践，我们不仅能够学会使用各种MyBatis标签来构建复杂的SQL语句，更能够理解如何通过这些标签来优化我们的SQL语句，避免SQL注入等安全问题，同时也能让代码更加简洁和高效。

同时如何根据不同的条件来拼接SQL语句，使其既可以满足复杂的查询需求，也可以保持代码的简洁和可维护性。同时，也演示了如何通过测试类来验证我们的SQL语句是否能够正确执行。

通过实际的代码实现和测试验证，就能够更好地理解MyBatis动态SQL的强大功能，为我们日常的开发工作提供了方便和帮助。希望通过本篇的学习，你可以更加熟练和自信地在你的MyBatis项目中使用这些XML标签来构建动态SQL语句。

热门专栏推荐
想学习vue的可以看看这个

java基础合集

数据库合集

redis合集

nginx合集

linux合集

手写机制

微服务组件

spring_尘觉

springMVC

mybits

等等等还有许多优秀的合集在主页等着大家的光顾感谢大家的支持

欢迎大家加入我的社区 尘觉社区

文章到这里就结束了，如果有什么疑问的地方请指出，诸佬们一起来评论区一起讨论
希望能和诸佬们一起努力，今后我们一起观看感谢您的阅读
如果帮助到您不妨3连支持一下，创造不易您们的支持是我的动力