【MyBatis】官方文档阅读笔记（四）

MyBatis动态SQL

前言

demo的项目地址：gitee/mybatis-simple-demo

MyBatis动态SQL的元素种类：两个条件判断、一个控制前缀后缀值、一个用于遍历。

• if
• choose (when, otherwise)
• trim (where, set)
• foreach

if 标签

if标签用于条件判断。使用动态 SQL 最常见情景是根据条件包含 where 子句的一部分。比如：

只使用if标签的一个潜在问题就是下面这种情况：

choose (when, otherwise)标签

与if标签类似，都用于条件判断。有时候，我们不想使用所有的条件，而只是想从多个条件中选择一个使用。针对这种情况，MyBatis 提供了 choose 元素，它有点像 Java 中的 switch 语句。

trim (where, set) 标签

where和set标签都可以认为是trim标签的一个子集，他们能提供的功能，trim都能提供。

where标签

where 元素只会在子元素返回任何内容的情况下才插入 “WHERE” 子句。而且，若子句的开头为 “AND” 或 “OR”，where 元素也会将它们去除。

和 where 元素等价的自定义 trim 元素为：

<trim prefix="WHERE" prefixOverrides="AND |OR ">
  ...
</trim>

where标签的使用demo：

set标签

set 元素可以用于动态包含需要更新的列，忽略其它不更新的列。 。set 元素会动态地在行首插入 SET 关键字，并会删掉额外的逗号（这些逗号是在使用条件语句给列赋值时引入的）。

和 set元素等价的自定义 trim 元素为：

<trim prefix="SET" suffixOverrides=",">
  ...
</trim>

set标签的使用demo：

trim标签

trim标签可以用于前后缀的处理上。

一个完整的trim标签：<trim prefix="" prefixOverrides="" suffix="" suffixOverrides=""></trim>

trim标签的四个属性：

• prefix：在子元素返回任何内容的情况下插入前缀。
• suffix：在子元素返回任何内容的情况下插入后缀。
• prefixOverrides：移除所有 prefixOverrides 属性中指定的内容。prefixOverrides 属性会忽略通过管道符分隔的文本序列，即可以通过管道符|分隔多个内容。
• suffixOverrides: 与prefixOverrides类似。

foreach

常见使用场景是对集合进行遍历（尤其是在构建 IN 条件语句的时候）。

foreach 元素的功能非常强大，它允许你指定一个集合，声明可以在元素体内使用的集合项（item）和索引（index）变量。它也允许你指定开头与结尾的字符串以及集合项迭代之间的分隔符。这个元素也不会错误地添加多余的分隔符。

它可以将任何可迭代对象（如 List、Set 等）、Map 对象或者数组对象作为集合参数传递给 foreach。当使用可迭代对象或者数组时，index 是当前迭代的序号，item 的值是本次迭代获取到的元素。当使用 Map 对象（或者 Map.Entry 对象的集合）时，index 是键，item 是值。