超全MyBatis动态SQL详解

最新推荐文章于 2024-06-02 12:47:20 发布
最新推荐文章于 2024-06-02 12:47:20 发布
阅读量240 收藏
点赞数
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/kuangjuelian229/article/details/89443266
版权

超全MyBatis动态SQL详解

MyBatis 令人喜欢的一大特性就是动态 SQL。在使用 JDBC 的过程中， 根据条件进行 SQL 的拼接是很麻烦且很容易出错的。MyBatis 动态 SQL 的出现， 解决了这个麻烦。

MyBatis通过 OGNL 来进行动态 SQL 的使用的。目前， 动态 SQL 支持以下几种标签：

1 数据准备
为了后面的演示， 创建了一个 Maven 项目 mybatis-dynamic, 创建了对应的数据库和表

DROP TABLE IF EXISTS student;

CREATE TABLE student (
student_id int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
name varchar(20) DEFAULT NULL COMMENT '姓名',
phone varchar(20) DEFAULT NULL COMMENT '电话',
email varchar(50) DEFAULT NULL COMMENT '邮箱',
sex tinyint(4) DEFAULT NULL COMMENT '性别',
locked tinyint(4) DEFAULT NULL COMMENT '状态(0:正常,1:锁定)',
gmt_created datetime DEFAULT CURRENT_TIMESTAMP COMMENT '存入数据库的时间',
gmt_modified datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改的时间',
delete int(11) DEFAULT NULL,
PRIMARY KEY (student_id)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='学生表';

对应的项目结构

2 if 标签
if 标签是我们最常使用的。在查询、删除、更新的时候很可能会使用到。必须结合 test 属性联合使用。

2.1 在 WHERE 条件中使用 if 标签
这是常见的一种现象， 我们在进行按条件查询的时候， 可能会有多种情况。

2.1.1 查询条件
根据输入的学生信息进行条件检索

当只输入用户名时， 使用用户名进行模糊检索；

当只输入性别时， 使用性别进行完全匹配

当用户名和性别都存在时， 用这两个条件进行查询匹配查询

2.1.2 动态 SQL
接口函数

/**
 * 根据输入的学生信息进行条件检索
 * 1. 当只输入用户名时， 使用用户名进行模糊检索；
 * 2. 当只输入邮箱时， 使用性别进行完全匹配
 * 3. 当用户名和性别都存在时， 用这两个条件进行查询匹配的用
 * @param student
 * @return
 */
    List<Student> selectByStudentSelective(Student student);

对应的动态 SQL


select

from student
where 1=1

and name like concat('%', #{name}, '%')


and sex=#{sex}

在此 SQL 语句中， where 1=1 是多条件拼接时的小技巧， 后面的条件查询就可以都用 and 了。

同时， 我们添加了 if 标签来处理动态 SQL

<if test="name != null and name !=''">
  and name like concat('%', #{name}, '%')
</if>
<if test="sex != null">
  and sex=#{sex}
</if>

此 if 标签的 test 属性值是一个符合 OGNL 的表达式， 表达式可以是 true 或 false。如果表达式返回的是数值， 则0为 false, 非 0 为 true;

2.1.3 测试
@Test
public void selectByStudent() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    Student search = new Student();
    search.setName("明");

    System.out.println("只有名字时的查询");
    List<Student> studentsByName = studentMapper.selectByStudentSelective(search);
    for (int i = 0; i < studentsByName.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsByName.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    search.setName(null);
    search.setSex((byte) 1);
    System.out.println("只有性别时的查询");
    List<Student> studentsBySex = studentMapper.selectByStudentSelective(search);
    for (int i = 0; i < studentsBySex.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsBySex.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    System.out.println("姓名和性别同时存在的查询");
    search.setName("明");
    List<Student> studentsByNameAndSex = studentMapper.selectByStudentSelective(search);
    for (int i = 0; i < studentsByNameAndSex.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsByNameAndSex.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    sqlSession.commit();
    sqlSession.close();
}

只有名字时的查询， 发送的语句和结果

查询的条件只发送了

where 1=1 and name like concat('%', ?, '%')

只有性别时的查询， 发送的语句和结果

查询的条件只发送了

where 1=1 and sex=?

姓名和性别同时存在的查询， 发送的语句和结果

查询条件

where 1=1 and name like concat('%', ?, '%') and sex=?

2.2 在 UPDATE 更新列中使用 if 标签
有时候我们不希望更新所有的字段， 只更新有变化的字段。

2.2.1 更新条件
只更新有变化的字段， 空值不更新。

2.2.1 动态 SQL
接口方法

/**
 * 更新非空属性
 */
int updateByPrimaryKeySelective(Student record);

对应的 SQL


update student


name = #{name,jdbcType=VARCHAR},


phone = #{phone,jdbcType=VARCHAR},


email = #{email,jdbcType=VARCHAR},


sex = #{sex,jdbcType=TINYINT},


locked = #{locked,jdbcType=TINYINT},


gmt_created = #{gmtCreated,jdbcType=TIMESTAMP},


gmt_modified = #{gmtModified,jdbcType=TIMESTAMP},


where student_id = #{studentId,jdbcType=INTEGER}

2.2.3 测试
@Test
public void updateByStudentSelective() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    Student student = new Student();
    student.setStudentId(1);
    student.setName("明明");
    student.setPhone("13838438888");
    System.out.println(studentMapper.updateByPrimaryKeySelective(student));

    sqlSession.commit();
    sqlSession.close();
}

结果如下

2.3 在 INSERT 动态插入中使用 if 标签
我们插入数据库中的一条记录， 不是每一个字段都有值的， 而是动态变化的。在这时候使用 if 标签， 可帮我们解决这个问题。

2.3.1 插入条件
只有非空属性才插入。

2.3.2 动态SQL
接口方法

/**
 * 非空字段才进行插入
 */
int insertSelective(Student record);

对应的SQL


insert into student


student_id,


name,


phone,


email,


sex,


locked,


gmt_created,


gmt_modified,




#{studentId,jdbcType=INTEGER},


#{name,jdbcType=VARCHAR},


#{phone,jdbcType=VARCHAR},


#{email,jdbcType=VARCHAR},


#{sex,jdbcType=TINYINT},


#{locked,jdbcType=TINYINT},


#{gmtCreated,jdbcType=TIMESTAMP},


#{gmtModified,jdbcType=TIMESTAMP},


这个 SQL 大家应该很熟悉， 毕竟是自动生成的。

2.3.3 测试
@Test
public void insertByStudentSelective() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    Student student = new Student();
    student.setName("小飞机");
    student.setPhone("13838438899");
    student.setEmail("xiaofeiji@qq.com");
    student.setLocked((byte) 0);

    System.out.println(studentMapper.insertSelective(student));

    sqlSession.commit();
    sqlSession.close();
}

对应的结果

SQL 中， 只有非空的字段才进行了插入。

3 choose 标签
choose when otherwise 标签可以帮我们实现 if else 的逻辑。一个 choose 标签至少有一个 when, 最多一个otherwise。

下面是一个查询的例子。

3.1 查询条件
假设 name 具有唯一性， 查询一个学生

当 studen_id 有值时， 使用 studen_id 进行查询；

当 studen_id 没有值时， 使用 name 进行查询；

否则返回空

3.2 动态SQL
接口方法

/**
 * - 当 studen_id 有值时， 使用 studen_id 进行查询；
 * - 当 studen_id 没有值时， 使用 name 进行查询；
 * - 否则返回空
 */
Student selectByIdOrName(Student record);

对应的SQL


select

from student
where 1=1


and student_id=#{studentId}


and name=#{name}


and 1=2


3.3 测试
@Test
public void selectByIdOrName() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    Student student = new Student();
    student.setName("小飞机");
    student.setStudentId(1);

    Student studentById = studentMapper.selectByIdOrName(student);
    System.out.println("有 ID 则根据 ID 获取");
    System.out.println(ToStringBuilder.reflectionToString(studentById, ToStringStyle.MULTI_LINE_STYLE));

    student.setStudentId(null);
    Student studentByName = studentMapper.selectByIdOrName(student);
    System.out.println("没有 ID 则根据 name 获取");
    System.out.println(ToStringBuilder.reflectionToString(studentByName, ToStringStyle.MULTI_LINE_STYLE));

    student.setName(null);
    Student studentNull = studentMapper.selectByIdOrName(student);
    System.out.println("没有 ID 和 name, 返回 null");
    Assert.assertNull(studentNull);

    sqlSession.commit();
    sqlSession.close();
}

有 ID 则根据 ID 获取， 结果

没有 ID 则根据 name 获取

没有 ID 和 name, 返回 null

4 trim(set、where)
这三个其实解决的是类似的问题。如我们在写前面的[在 WHERE 条件中使用 if 标签] SQL 的时候， where 1=1 这个条件我们是不希望存在的。

4.1 where
4.1.1 查询条件
根据输入的学生信息进行条件检索。

当只输入用户名时， 使用用户名进行模糊检索；

当只输入性别时， 使用性别进行完全匹配

当用户名和性别都存在时， 用这两个条件进行查询匹配查询

不使用 where 1=1。

4.1.2 动态 SQL
很显然， 我们要解决这几个问题

当条件都不满足时：此时 SQL 中应该要不能有 where ， 否则导致出错
当 if 有条件满足时：SQL 中需要有 where， 且第一个成立的 if 标签下的 and | or 等要去掉
这时候， 我们可以使用 where 标签。

接口方法

/**
 * 根据输入的学生信息进行条件检索
 * 1. 当只输入用户名时， 使用用户名进行模糊检索；
 * 2. 当只输入邮箱时， 使用性别进行完全匹配
 * 3. 当用户名和性别都存在时， 用这两个条件进行查询匹配的用
 */
List<Student> selectByStudentSelectiveWhereTag(Student student);

对应的 SQL


select

from student


and name like concat('%', #{name}, '%')


and sex=#{sex}


4.1.3 测试
@Test
public void selectByStudentWhereTag() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    Student search = new Student();
    search.setName("明");

    System.out.println("只有名字时的查询");
    List<Student> studentsByName = studentMapper.selectByStudentSelectiveWhereTag(search);
    for (int i = 0; i < studentsByName.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsByName.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    search.setSex((byte) 1);
    System.out.println("姓名和性别同时存在的查询");
    List<Student> studentsBySex = studentMapper.selectByStudentSelectiveWhereTag(search);
    for (int i = 0; i < studentsBySex.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsBySex.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    System.out.println("姓名和性别都不存在时查询");
    search.setName(null);
    search.setSex(null);
    List<Student> studentsByNameAndSex = studentMapper.selectByStudentSelectiveWhereTag(search);
    for (int i = 0; i < studentsByNameAndSex.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(studentsByNameAndSex.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    sqlSession.commit();
    sqlSession.close();
}

只有名字时的查询, 有 where

姓名和性别同时存在的查询， 有 where

姓名和性别都不存在时查询, 此时， where 不会再出现了。

4.2 set
set 标签也类似， 在 [2.2 在 UPDATE 更新列中使用 if 标签] 中， 如果我们的方法 updateByPrimaryKeySelective 没有使用

4.3 trim
set 和 where 其实都是 trim 标签的一种类型， 该两种功能都可以使用 trim 标签进行实现。

4.3.1 trim 来表示 where
如以上的 where 标签， 我们也可以写成


表示当 trim 中含有内容时， 添加 where， 且第一个为 and 或 or 时， 会将其去掉。而如果没有内容， 则不添加 where。

4.3.2 trim 来表示 set
相应的， set 标签可以如下表示


表示当 trim 中含有内容时， 添加 set， 且最后的内容为 , 时， 会将其去掉。而没有内容， 不添加 set

4.3.3 trim 的几个属性
prefix: 当 trim 元素包含有内容时， 增加 prefix 所指定的前缀

prefixOverrides: 当 trim 元素包含有内容时， 去除 prefixOverrides 指定的 前缀

suffix: 当 trim 元素包含有内容时， 增加 suffix 所指定的后缀

suffixOverrides：当 trim 元素包含有内容时， 去除 suffixOverrides 指定的后缀

5 foreach 标签
foreach 标签可以对数组， Map 或实现 Iterable 接口。

foreach 中有以下几个属性：

collection: 必填， 集合/数组/Map的名称.

item: 变量名。即从迭代的对象中取出的每一个值

index: 索引的属性名。当迭代的对象为 Map 时， 该值为 Map 中的 Key.

open: 循环开头的字符串

close: 循环结束的字符串

separator: 每次循环的分隔符

其他的比较好理解， collection 中的值应该怎么设定呢？

跟接口方法中的参数相关。

  1. 只有一个数组参数或集合参数
    默认情况：集合collection=list， 数组是collection=array

推荐：使用 @Param 来指定参数的名称， 如我们在参数前@Param("ids")， 则就填写 collection=ids

  1. 多参数
    多参数请使用 @Param 来指定， 否则SQL中会很不方便

  2. 参数是Map
    指定为 Map 中的对应的 Key 即可。其实上面的 @Param 最后也是转化为 Map 的。

  3. 参数是对象
    使用属性.属性即可。

5.1 在 where 中使用 foreach
在 where条件中使用， 如按id集合查询， 按id集合删除等。

5.1.1 查询条件
我们希望查询用户 id 集合中的所有用户信息。

5.1.2 动态 SQL
函数接口

/**
 * 获取 id 集合中的用户信息
 * @param ids
 * @return
 */
List<Student> selectByStudentIdList(List<Integer> ids);

对应 SQL


select

from student
where student_id in

#{id}

5.1.3 测试
@Test
public void selectByStudentIdList() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    List<Integer> ids = new LinkedList<>();
    ids.add(1);
    ids.add(3);

    List<Student> students = studentMapper.selectByStudentIdList(ids);
    for (int i = 0; i < students.size(); i++) {
        System.out.println(ToStringBuilder.reflectionToString(students.get(i), ToStringStyle.MULTI_LINE_STYLE));
    }

    sqlSession.commit();
    sqlSession.close();
}

结果

5.2 foreach 实现批量插入
可以通过foreach来实现批量插入。

5.2.1 动态SQL
接口方法

/**
 * 批量插入学生
 */
int insertList(List<Student> students);

对应的SQL


insert into student(name, phone, email, sex, locked)
values

(
#{student.name}, #{student.phone},#{student.email},
#{student.sex},#{student.locked}
)

5.2.2 测试
@Test
public void insertList() {
SqlSession sqlSession = null;
sqlSession = sqlSessionFactory.openSession();
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);

    List<Student> students = new LinkedList<>();
    Student stu1 = new Student();
    stu1.setName("批量01");
    stu1.setPhone("13888888881");
    stu1.setLocked((byte) 0);
    stu1.setEmail("13888888881@138.com");
    stu1.setSex((byte) 1);
    students.add(stu1);

    Student stu2 = new Student();
    stu2.setName("批量02");
    stu2.setPhone("13888888882");
    stu2.setLocked((byte) 0);
    stu2.setEmail("13888888882@138.com");
    stu2.setSex((byte) 0);
    students.add(stu2);

    System.out.println(studentMapper.insertList(students));
    sqlSession.commit();
    sqlSession.close();
}

结果

6 bind 标签
bind 标签是通过 OGNL 表达式去定义一个上下文的变量， 这样方便我们使用。

如在 selectByStudentSelective 方法中， 有如下


and name like concat('%', #{name}, '%')

在 MySQL 中， 该函数支持多参数， 但在 Oracle 中只支持两个参数。那么我们可以使用 bind 来让该 SQL 达到支持两个数据库的作用



and name like #{nameLike}

更改后的查询结果如下

7 代码
使用示例：

https://github.com/homejim/mybatis-examples

posted @ 2019-04-21 14:09 嗯哼~ 阅读( ...) 评论( ...) 编辑 收藏
wldan
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
MyBatis动态SQL
TY02072403的博客
03-05 391
官方文档 以下代码和笔记是关于mybatis动态SQL的一套，请移步观看 配置MyBatis的日志打印 在mybatis-config.xml文件中增加如下配置 <settings> <setting name="cacheEnabled" value="true" /> <setting name="useGeneratedKeys" value="true" /> <setting name="defaultExecutorType"
Mybatis动态sql
热门推荐
weixin_52394141的博客
07-18 1万+
Mybatis缓存以及实现动态sql
Mybatis--动态SQL
梦想也许遥不可及，但重要的是追梦的过程，用博客记录自己的成长，记录自己一步一步向上攀登的印记
04-06 5241
前言if标签if+wheretrim标签choose(when,otherwise)标签foreach标签sql片段 前言 mybatis的动态sql是一种根据特定的条件来进行动态拼接sql语句的字符串问题，动态 SQL 是 MyBatis 的强大特性之一。使用过 JDBC 或其它类似的框架，大家应该能理解根据不同条件拼接 SQL 语句有多痛苦，例如拼接时要确保不能忘记添加必要的空格，还要注意去掉列表最后一个列名的逗号。利用动态 SQL，可以彻底摆脱这种痛苦。 下面，我就以t_emp表来讲解 if标签 .
MyBatis源码解析系列之十八：MyBatis的其他高级特性与使用技巧
最新发布
阿里渣渣java研发组-群主
06-02 271
在本篇文章中，我们详细介绍了MyBatis的动态SQL、缓存机制、分页插件和插件机制等高级特性和使用技巧。通过合理使用这些特性，开发者可以显著提高MyBatis的性能和灵活性，满足复杂的业务需求。下一篇文章中，我们将探讨MyBatis的代码生成工具和自动生成代码的最佳实践，敬请期待。如果有任何问题或建议，欢迎在评论区留言讨论。如需获取更多MyBatis源码解析的详细内容，请持续关注我的CSDN博客，更多精彩内容等着你！
Mybatis动态SQL（详细介绍）
m0_74777020的博客
08-16 9333
Mybatis的动态SQL介绍及应用——详细介绍
MyBatis动态SQL大全
weixin_44924882的博客
09-03 1326
动态SQL是MyBatis的强大特性之一。在JDBC或其它类似的框架中，通常需要开发人员手动拼接SQL语句。根据不同的条件拼接不同的SQL语句是一件及其麻烦的事情，例如：拼接是要确保添加了必要的空格，还要注意去掉列表最后一个列名的逗号。动态SQL一般是根据用户输入或外部条件动态组合的SQL语句块。通过一些条件的判断，可以实现在不同情况下执行不同的SQL语句，避免了手动拼接SQL的麻烦，不过动态SQL有时候在执行性能上面不如动态SQL，而且使用不恰当，往往会在安全方面存在隐患。如SQL注入的攻击。
Mybatis动态SQL
心流时间的博客
08-13 716
Mybatis 动态Sql
MyBatis动态SQL详解.pdf
04-28
mybatis动态sql 详解.pdf
mybatis的动态sql详解（精）
09-10
MyBatis的动态SQL是其强大特性的体现，它基于OGNL（Object-Graph Navigation Language）表达式，使得在SQL语句中实现复杂的逻辑变得轻松。动态SQL的主要目的是避免手动拼接SQL字符串，减少错误并提高代码的可读性...
MyBatis 执行动态 SQL语句详解
09-01
在 MyBatis 中，动态 SQL 是一个强大的特性，允许我们在 XML 映射文件或注解中编写条件语句，根据运行时的参数来决定 SQL 的具体执行内容。下面我们将深入探讨如何在 MyBatis 中执行动态 SQL 语句。 首先，我们要...
mybatis动态sql语句详解
04-28
mybatis动态sql
MyBatis 动态SQL和缓存机制实例详解
08-29
MyBatis 动态SQL和缓存机制实例详解 MyBatis 是一个基于 Java 的持久层框架，它提供了一个灵活的 SQL 构建方式，称为动态 SQL。动态 SQL 允许用户根据不同的条件动态地构建 SQL 语句，以满足不同的业务需求。同时，...
Mybatis——动态sql
weixin_67659262的博客
09-07 1645
mybatis——动态sql的介绍以及使用，适合初学者~
mybatis之动态SQL
m0_47743175的博客
10-25 914
mybatis动态sql配置
Mybatis-动态SQL
chenchenchencl的博客
05-25 2870
Mybatis-动态SQL
MyBatis 之 动态 SQL
lfm1010123的博客
10-23 1872
动态 SQL
【MyBatis】如何使用“动态SQL”（超详解）
weixin_44825912的博客
04-28 5717
MyBatis提供了10种动态SQL标签：trim、where、set、foreach、if、choose、when、otherwise、bind、include；其执行原理为，使用OGNL从SQL参数对象中计算表达式的值，根据表达式的值动态拼接SQL，以此来完成动态SQL的功能。
mybatis if test 多条件_超全MyBatis动态SQL详解！( 看完SQL爽多了)
06-08
好的，MyBatis 的动态 SQL 确实可以让 SQL 语句更加灵活和可读性更高。下面我来详细介绍一下 MyBatis 中 if test 多条件的用法。 MyBatis 中的 if test 多条件实际上是通过在 SQL 语句中使用 if 判断来动态拼接 SQL...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值