if
if 标签通常用于 WHE阻 语句中,通过判断参数值来决定是否使用某个查询条件,它也经常用于 UPDATE 语句中判断是否更新某一个字段 , 还可以在 INSERT 语句中用来判断是否插入某个字段的值。
if 标签有一个必填的属性 test, test 的属性值是一个符合 OGNL 要求的判断表达式,表达式的结果可以是 true 或 false ,除此之外所有的非 0值都为 true ,只有0为 false 。 为了方便理解,在表达式中 ,建议只用 true 或 false 作为结果 。
- 判断条件 property ! =nu ll 或 property == null : 适用于任何类型的宇段 ,用于判断属性值是否为空。
- 判断条件 property != '' 或 prope rty == '': 仅适用于 String 类型的宇段 ,用于判断是否为空字符串 。
- and 和 or :当有多个判断条件时,使用 and 或 or 进行连接,嵌套的判断可以使用小括号分组, and 相当于
Java 中的与(&&), or 相当于 Java 中的或 (||)。
上面两个条件的属性类型都是 String,对字符串的判断和 Java 中的判断类似,首先需要判断字段是否为 null ,然后再去判断是否为空(在 OGNL 表达式中 ,这两个判断的顺序不会影响判断的结果,也不会有空指针异常)。在本章所有例子中,字符串的判断几乎都包含 null和空的判断,这两个条件不是必须写在一起,可以根据实际业务决定是否需要空值判断 。
choose when otherwise
if 标签提供了基本的条件判断,但是它无法实现 if. . . else 、 if ... else ...的逻辑,要想实现这样的逻辑,就需用到 choose when otherwise 标签。
choose 元素中包含 when和 otherwise 两个标签,一个 choose 中至少有一个 when ,有 0 个或者1 个
otherwise 。在己有的 sys_user 表中,除了主键 id 外,我们认为 user_name (用户名)也是唯一的,所有的用户名都不可以重复 。 现在进行如下查询:
当参数 id 有值的时候优先使用 id 查询,当 id 没有值时就去判断用户名是否有值,如果有值就用用户名查询 ,如果用 户名也没有值,就使 SQL 查询无结果 。
在以上查询中,如果没有 otherwise 这个限制条件,所有的用户都会被查询出来,因为
我们在对应 的接口方法中使用了 Sys User 作为返回值,所以当实际查询结果是多个时就会报
错。 添加 otherwise 条件后,由于 where 条件不满足,因此在这种情况下就查询不到结果。
where
这 3 个标签解决了类似的问题,并且 where 和 set 都属于 trim 的一种具体用法。下面分别来看这 3 个标签。
where 标签的作用:如果该标签包含的元素中有返回值,就插入一个 where ;如果 where后面的字符串是以 AND 和 OR 开头的,就将它们剔除。
当 if 条件都不满足的时候, where 元素中没有内容,所以在 SQL 中不会出现 where , 如果 if 条件满足, where 元素的内容就是以 and 开头的条件, where 会自动去掉开头的 and,这也能保证 where 条件正确 。这种情况下生成的 SQL 更干净、更贴切,不会在任何情况下都有 where 1 = 1 这样的条件 。
set
set 标签的作用:如果该标签包含的元素中有返回值,就插入一个 set :如果 set 后面的字符串是 以逗号结尾的,就将这个逗号剔除 。
update sys_user
user name= #{userName} ,
if>
user password= #{userPassword} ,
user email = #{userEmail} ,
if>
user info = #{userinfo},
head_img = #{headimg, jdbcType=BLOB},
create_time = #{createTime, jdbcType=TIMESTAMP},
id = # {id} ,
where id = #{id}
update>
在 set 标签的用法中 , SQL 后面的逗号没有问题了,但是如果 set 元素中没有内容,照样
会出现 SQL 错误,所以为了避免错误产生,类似 id = #{id }这样必然存在的赋值仍然有保留
的必要。从这一点来看, set 标签并没有解决全部的问题,使用时仍然需要注意。
trim
where 和 set 标签 的功能都可以用 trim 标签来实现,并且在底层就是通过TrimSqlNode 实现的 。
where 标签对应 trim 的实现如下。
......
trim>
这里的 AND 和 OR 后面的空格不能省略,为了避免匹配到 andes 、 orders 等单词 。
实际的 prefixeOverrides 包含“AND”、“OR”、“AND\n ”、“OR\n ”、“AND\r”、OR\r”、“AND\t ”、 “ OR \t ”, 不仅仅是上面提到的两个带空格的前缀 。
set 标签对应 的 trim 实现如下 。
.....
trim>
trim 标签有如下属性。
prefix :当 trim 元素内包含内容时,会给内容增加 prefix 指定的前缀。
prefixOverrides :当 trim 元素内包含内容时,会把内容中匹配的前缀字符串去掉。
suffix :当 trim 元素内包含内容时,会给内容增加 suffix 指定的后缀。
suffixOverrides :当 trim 元素内包含内容时,会把内容中匹配的后缀字符串去掉。
foreach
SQL 语句中有时会使用 IN 关键字,例如 id in ( 1 , 2 , 3 )。可以使用${ids}方式直接获取值,但这种写法不能防止 SQL 注入,想避免 SQL 注入就需要用#{}的方式,这时就要配合使用 foreach 标签来满足需求。
foreach 可以对数组、 Map 或实现了工 terable 接口(如 List 、 Set )的对象进行遍历。数组在处理时会转换为 List 对象,因此 foreach 遍历的对象可以分为两大类 : Iterable类型和 Map 类型
foreach 实现 in 集合(或数组)是最简单和常用的一种情况
#{id}
foreach 包含以下属性。
- collection : 必填,值为要选代循环的属性名。这个属性值的情况有很多。
- item:变量名,值为从法代对象中取出的每一个值。
- index :索引的属性名,在集合数组情况下值为当前索引值 ,当选代循环的对象是 Map类型时,这个值为 Map 的 key (键值)。
- open:整个循环内容开头的字符串 。
- close : 整个循环内容结尾的字符串。
- separator :每次循环的分隔符 。
bind
bind 标签可以使用 OGNL 表达式创建一个变量井将其绑定到上下文中。在前面的例子中,UserMapper.xml 有一个 selectByUser 方法,这个方法用到了 like 查询条件,部分代码如下 。
and user name like concat ( ’ % ’, #{ userNarne },’ % ’ )
使用 con cat 函数连接字符串,在 MySQL 中,这个函数支持多个参数,但在 Oracle 中只支持两个参数。由于不 同数据库之间的语法差异 ,如果更换数据库,有些 SQL 语句可能就需要重写。针对这种情况,可 以使用 bind 标签来避免由于更换数据库带来的一些麻烦。将上面的
方法改为 bind 方式后,代码如下。