Mybatis—动态SQL

一、简介

Mybatis框架的动态SQL技术是一种根据特定条件动态拼装SQL语句的功能，它存在的意义是为了解决拼接SQL语句字符串时的痛点问题。

One of the most powerful features of MyBatis has always been its Dynamic SQL capabilities. If you have any experience with JDBC or any similar framework, you understand how painful it is to conditionally concatenate strings of SQL together, making sure not to forget spaces or to omit a comma at the end of a list of columns. Dynamic SQL can be downright painful to deal with.

---

MyBatis的一个强大的特性之一通常是它的动态SQL能力。如果你有使用JDBC或其他相似框架的经验，你就明白条件地串联SQL字符串在一起是多么的痛苦，确保不能忘了空格或在列表的最后省略逗号。动态SQL可以彻底处理这种痛苦。

什么是动态sql：动态sql就是根据不同的条件生成不同的sql语句。所谓的动态sql。本质还是sql语句，只是我们可以在sql层面，去执行一个逻辑代码。动态sql就是在拼接sql语句，我们只要保证sql正确性，按照sql的格式，去排列组合就可以了。 

注意事项

在mapper的动态SQL中如出现大于号，小于号，大于等于号，小于等于号，最好将其转换为实体符号，否则，XML可能会出现解析出错问题
特别是小于号 (<),在XML中绝对不能出现 ，否则一定出错

原符号	实体符号
<	&It;
<=	&It;=
>	>；
>=	>；=
&	&；
’	&apos；
"	"；

二、if和where标签

 

    select emp_id,emp_name,emp_salary from t_emp
    
    
    
        
        
        
            
            or emp_name=#{empName}
        
        
            or emp_salary>#{empSalary}
        
        
    

三、set标签

1、相关业务需求举例

实际开发时，对一个实体类对象进行更新。往往不是更新所有字段，而是更新一部分字段。此时页面上的表单往往不会给不修改的字段提供表单项。

    
    
    年  龄：

    性  别：

    坐  标：

    
    
    
 
    修改
    

例如上面的表单，如果服务器端接收表单时，使用的是User这个实体类，那么userName、userBalance、userGrade接收到的数据就是null。

如果不加判断，直接用User对象去更新数据库，在Mapper配置文件中又是每一个字段都更新，那就会把userName、userBalance、userGrade设置为null值，从而造成数据库表中对应数据被破坏。

此时需要我们在Mapper配置文件中，对update语句的set子句进行定制，此时就可以使用动态SQL的set标签。

2、实际配置方式

    update t_emp
    
    
    
        
            emp_name=#{empName},
        
        
            emp_salary=#{empSalary},
        
    
    where emp_id=#{empId}
    

四、trim标签

使用trim标签控制条件部分两端是否包含某些字符

• prefix属性：指定要动态添加的前缀

• suffix属性：指定要动态添加的后缀

• prefixOverrides属性：指定要动态去掉的前缀，使用“|”分隔有可能的多个值

• suffixOverrides属性：指定要动态去掉的后缀，使用“|”分隔有可能的多个值

    select emp_id,emp_name,emp_age,emp_salary,emp_gender
    from t_emp
    
    
    
    
    
    
    
        
            emp_name=#{empName} and
        
        
            emp_salary>#{empSalary} and
        
        
            emp_age=#{empAge} or
        
        
            emp_gender=#{empGender}
        
    

五、choose/when/otherwise标签

在多个分支条件中，仅执行一个。

    select emp_id,emp_name,emp_salary from t_emp
    where
    
        emp_name=#{empName}
        emp_salary < 3000
        1=1
    
    
    

六、foreach标签

1. 基本用法

用批量插入举例

    
    (#{emp.empName},#{myIndex},#{emp.empSalary},#{emp.empGender})

2. 批量更新时需要注意

上面批量插入的例子本质上是一条SQL语句，而实现批量更新则需要多条SQL语句拼起来，用分号分开。也就是一次性发送多条SQL语句让数据库执行。此时需要在数据库连接信息的URL地址中设置：

liush.dev.url=jdbc:mysql://192.168.198.100:3306/mybatis?allowMultiQueries=true

对应的foreach标签如下：

    
        update t_emp set emp_name=#{emp.empName} where emp_id=#{emp.empId}
    

3. 关于foreach标签的collection属性

如果没有给接口中List类型的参数使用@Param注解指定一个具体的名字，那么在collection属性中默认可以使用collection或list来引用这个list集合。这一点可以通过异常信息看出来：

Parameter 'empList' not found. Available parameters are [collection, list]

在实际开发中，为了避免隐晦的表达造成一定的误会，建议使用@Param注解明确声明变量的名称，然后在foreach标签的collection属性中按照@Param注解指定的名称来引用传入的参数。

七、sql标签

1、抽取重复的SQL片段

    
    
        select emp_id,emp_name,emp_age,emp_salary,emp_gender from t_emp
    

2、引用已抽取的SQL片段