1 MyBatis动态SQL之综述和 if 语句

摘要：使用 MyBatis 动态SQL，通过 if, choose, when, otherwise, trim, where, set, foreach和bind等标签，可组合成非常灵活的SQL语句，从而既提高 SQL 语句的准确性，也大大提高攻城狮的开关效率。

1 MyBatis动态SQL之if 语句
2 MyBatis动态sql之where标签|转
3 MyBatis动态SQL之set标签|转
4 MyBatis动态SQL之trim元素|转
5 MyBatis动态sql中foreach标签的使用
6 MyBatis动态SQL之choose(when、otherwise)语句
7 MyBatis动态SQL之bind标签|转

综述

  动态 SQL 是 MyBatis 的强大特性之一。如果你使用过 JDBC 或其它类似的框架，你应该能理解根据不同条件拼接 SQL 语句有多痛苦，例如拼接时要确保不能忘记添加必要的空格，还要注意去掉列表最后一个列名的逗号。利用动态 SQL，可以彻底摆脱这种痛苦。

  使用动态 SQL 并非一件易事，但MyBatis 3 基于功能强大的 OGNL 表达式借助可用于任何 SQL 映射语句中的、强大的动态 SQL 语言，显著地提升了这一特性的易用性。

OGNL，全称为Object-Graph Navigation Language，它是一个功能强大的表达式语言，用来获取和设置Java对象的属性，它旨在提供一个更高的更抽象的层次来对Java对象图进行导航。

  如果你之前用过 JSTL 或任何基于类 XML 语言的文本处理器，你对动态 SQL 元素可能会感觉似曾相识。MyBatis 3 常用的动态SQL元素包括:

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

  下面我们就用一个简单示例来看看在MyBatis中怎么使用动态SQL。

定义表结果和实体类

  首先，在数据库创建一个表tb_employee，并插入测试数据。SQL脚本如下:

CREATE TABLE tb_employee(
ID INT(11) PRIMARY KEY AUTO_INCREMENT,
loginname VARCHAR(18),
PASSWORD VARCHAR(18),
NAME VARCHAR(18) DEEAULT NULL,
SEX CHAR(2) DEEAULT NULL,
AGE INT(11) DEFAULT NULL,
phone VARCHAR(21),
sal DOUBLE,
state VARCHAR(18)
);
INSERT INTO tb_employee(loginname,PASSWORD,NAMB,sex,age,phone,sal,state
VALUES('jack','123456','楼兰胡杨",'男',26,'13900000001',9800,'ACTIVE');
INSERT INTO tb_employee (loginname,PASSWORD,NAMB,sex,age,phone,sal,state)
VALUES('rose','123456','Wiener','女',21,'13900000002',6800,'ACTIVE');
INSERT INTO tb_employee (loginname,PASSWORD,NAME,sex,age,phone,sal,state)
VALUES('tom','123456','汤姆','男',25,'13900000003,8800,'ACTIVE');
INSERT INTO tb_employee (loginname,PASSWORD,NAME sex,age,phone,sal,state)
VALUES('alice','123456','爱丽丝','女’,20,'13900000004,5800,ACTIVE');

  在数据库中执行SQL 脚本，完成创建tb_employee的操作。用实体类Employee映射tb_employee表。tb_employee 和 mployee将贯穿动态SQL所有章节。

if语句

  动态SQL通常会做的事情是有条件地包含where子句的一部分。比如:

<select id="selectEmployeeById" resultType="cn.mybatis.domain.Employee">
SELECT * FROM tb_employee WHERE state = 'ACTIVE'
<!-- 可选条件，如果传进来的参数有id属性，则加上id查询条件-->
<if test="id != null">
and id = #{id}
</if>
</select>

  假设在上述SQL中查询条件id的值不为null，那么控制台打印出来的SQL为：

SBLECT * EROM tb_employee WHERE state = 'ACTIVE' and id = ?

  以上语句提供了一个可选的、根据id查找Employee的功能。如果没有传入id,那么所有处于“ACTIVE”状态的Employee都会被返回; 反之若传入了id，那么就会把查找id内容的Employee结果返回。如果想通过两个条件搜索该怎么办呢? 很简单，只要多加入一个条件即可，例如：

<select id="selectEmployeeByIdLike" resultType="cn.mybatis.domain.Employee">
SELECT * FROM tb_employee WHERE state = 'ACTIVE'
<!-- 可选条件，如果传进来的参数有id属性，则加上id查询条件-->
<if test="id != null">
and id = #{id}
</if>
<!-- 两个可选条件，例如登录功能的登录名和密码查询-->
<if test="loginname != null and password != null">
and loginname = #{loginname} and password = #{password)
</if>
</select>

可以使用两个等于号==判断id等于null的场景，if语句示例如下：

<if test="id == null">

  如果不使用if语句，则其SQL脚本如下：

<select id="selectByName" resultType="cn.mybatis.domain.Employee">
    <!-- 这和普通的sql 查询语句十分相似 -->
    select * from tb_employee WHERE state = 'ACTIVE'and id = #{id} and loginname=#{loginname} and password=#{password}
</select>

  我们从上面的查询语句可以发现，如果 #{loginname} 为空，那么查询结果也是空，使用起来缺乏灵活性，而动态SQL完全不畏惧这个。这就是动态SQL的长处之所在。

Reference

• https://mybatis.org/mybatis-3/zh/dynamic-sql.html