​

元素

动态SQL通常要做的事情是有条件地包含where子句的一部分。所以在MyBatis中，元素是最常用的元素。它类似于Java中的if语句。在ch8应用中，测试元素，具体过程如下：

本小节继续使用上一章的实例，在com.mybatis包的UserMapper.xml文件中，添加如下SQL映射语句：

  
    select * from user where 1=1
    
      and uname like concat('%',#{uname},'%')
    
    
      and usex = #{usex}
    
  

这个元素中parameterType用的是POJO类MyUser。所以SQL语句中的#{uname}和 #{usex}的值都是MyUser.uname。

当要构造动态sql语句时为了防止sql语句结构不当,所以加上where 1=1 ，这样SQL语句不会报错，后面的逻辑也很简单，判断#{usex}不为空且不为""的时候在后面添加SQL。

对应的Dao接口：

public  List selectUserByIf(MyUser user);

测试用的Controller：

// 使用if元素查询用户信息
    MyUser ifmu = new MyUser();
    ifmu.setUname("张");
    ifmu.setUsex("女");
    List listByif = userDao.selectUserByIf(ifmu);
    System.out.println("if元素================");
    for (MyUser myUser : listByif) {
      System.out.println(myUser);
    }

测试结果：

​

 我们试着不设置#{uname}的值，看是否正确拼接了SQL语句：

​

 、、元素

有些时候，不想用到所有的条件语句，而只想从中择其一二。针对这种情况，MyBatis 提供了choose选择元素，它有点像Java中的 switch 语句。

映射语句如下：

select * from user where 1=1 and uname like concat('%',#{uname},'%') and usex = #{usex} and uid > 10

元素就是switch语句，就是case语句， 就是default语句。同样需要注意的是，当一个元素条件满足时候就不在执行其他元素和了，将会直接结束整个元素。

Dao接口：

public List selectUserByChoose(MyUser user);

Controller中测试：

// 使用choose元素查询用户信息
    MyUser choosemu = new MyUser();
    choosemu.setUname("");
    choosemu.setUsex("");
    List listByChoose = userDao.selectUserByChoose(choosemu);
    System.out.println("choose元素================");
    for (MyUser myUser : listByChoose) {
      System.out.println(myUser);
    }

我们例子中传入uname和usex为空，所以执行了元素中的语句，如图：

​

 我们这次传一个usex试试，看看语句如何执行：

// 使用choose元素查询用户信息
    MyUser choosemu = new MyUser();
    choosemu.setUname("");
    choosemu.setUsex("女");
    List listByChoose = userDao.selectUserByChoose(choosemu);
    System.out.println("choose元素================");
    for (MyUser myUser : listByChoose) {
      System.out.println(myUser);
    }

结果如下，当不为usex空时，仅执行了这个 元素。

​

 、、元素

1. 元素

元素的主要功能是可以在自己包含的内容前加上某些前缀，也可以在其后加上某些后缀，与之对应的属性是prefix和suffix；可以把包含内容的首部某些内容覆盖，即忽略，也可以把尾部的某些内容覆盖，对应的属性是prefixOverrides和suffixOverrides；正因为元素有这样的功能，所以也可以非常简单地利用来代替元素的功能。

映射语句如下：

  
    select * from user 
      
            
              and uname like concat('%',#{uname},'%')
            
            
              and usex = #{usex} 
              
        
  

的意思是：在整个 元素范围内，为SQL语句加上"where"前缀，同时去掉"and |or"后缀。和我们第一小节的 where 1=1 是一个意思，智能拼接SQL语句。

对应的Dao接口：

public List selectUserByTrim(MyUser user);

在Controller中测试：

//使用trim元素查询用户信息
    MyUser trimmu = new MyUser();
    trimmu.setUname("张");
    trimmu.setUsex("男");
    List listByTrim = userDao.selectUserByTrim(trimmu);
    System.out.println("trim元素================");
    for (MyUser myUser : listByTrim) {
      System.out.println(myUser);
    }

从测试结果中我们可以看到Mybatis智能拼接了SQL语句，加上"where"前缀，同时去掉了"and"后缀。

​

 2. 元素

元素的作用是会在写入元素的地方输出一个where语句，另外一个好处是不需要考虑元素里面的条件输出是什么样子的，MyBatis将智能处理。如果所有的条件都不满足，那么MyBatis就会查出所有的记录，如果输出后是and 开头的，MyBatis会把第一个and忽略，当然如果是or开头的，MyBatis也会把它忽略；此外，在元素中不需要考虑空格的问题，MyBatis将智能加上，都是能够实现智能拼接SQL语句功能。

映射语句如下：

  
    select * from user 
    
      
        and uname like concat('%',#{uname},'%')
      
      
        and usex = #{usex}
      
    
  

在这个 元素中，自动加上了where前缀，并且去掉了and后缀。

Dao接口：

public List selectUserByWhere(MyUser user);

Controller的测试：

//使用where元素查询用户信息
    MyUser wheremu = new MyUser();
    wheremu.setUname("张");
    wheremu.setUsex("男");
    List listByWhere = userDao.selectUserByWhere(wheremu);
    System.out.println("where元素================");
    for (MyUser myUser : listByWhere) {
      System.out.println(myUser);
    }

结果同上一小节一样：

​

 3. 元素

在动态update语句中，可以使用元素动态更新列。

映射语句：

  
    update user 
    
      uname=#{uname},
      usex=#{usex}
    
    where uid = #{uid}
  

在 元素中，当uname不为空时，SQL语句自动加上uname=#{uname}，也就是哪个列传来的值不为空，就会更新此列。

Dao接口：

public int updateUserBySet(MyUser user);

Controller中测试：

//使用set元素修改一个用户
    MyUser setmu = new MyUser();
    setmu.setUid(1);
    setmu.setUname("张九");
    int setup = userDao.updateUserBySet(setmu);
    System.out.println("set元素修改了" + setup + "条记录");
    System.out.println( "================");

从运行截图可以看到，因为uname不为空，所有修改这一列：

​

 元素

元素主要用在构建in条件中，它可以在SQL语句中进行迭代一个集合。foreach元素的属性主要有item，index，collection，open，separator，close。

item表示集合中每一个元素进行迭代时的别名，即变量名。

index指定一个名字，用于表示在迭代过程中，每次迭代到的位置，就是循环索引。

open表示该语句以什么开始，通常构建in时候，以"("作为拼接SQL的前缀。

close表示以什么结束。以")"作为拼接SQL的后缀，

separator表示在每次进行迭代之间以什么符号作为分隔符，视传入参数的类型而定。

在使用时，最关键的也是最容易出错的是collection属性，该属性是必选的，但在不同情况下，该属性的值是不一样的，主要有以下3种情况：

• 如果传入的是单参数且参数类型是一个List的时候，collection属性值为list。

• 如果传入的是单参数且参数类型是一个array数组的时候，collection的属性值为array。

• 如果传入的参数是多个时，需要把它们封装成一个Map，当然单参数也可以封装成Map。Map的key是参数名，collection属性值是传入的List或array对象在自己封装的Map中的key，就是实际需要元素遍历的值名称。

  看着定义很繁琐，其实一个例子就能弄清楚了，如下。

定义映射语句：

  
    select * from user where uid in
    
      #{item}
    
  

parameterType="List"表示传入的参数是List，故而collection的属性是"list"。这段代码用Java解释为：

for (int index = 0; index < list.length; index++) {
     item=list[index];
 }

对应的Dao接口，注意传入和返回的参数类型哦：

public  List selectUserByForeach(List listId);

Controller中测试：

// 使用foreach元素，查询用户信息
    List listId = new ArrayList();
    listId.add(1);
    listId.add(11);
    listId.add(31);
    System.out.println("传入的参数为："+listId);
    List listByForeach = userDao.selectUserByForeach(listId);
    System.out.println("foreach元素================");
    for (MyUser myUser : listByForeach) {
      System.out.println(myUser);
    }

拼接后的SQL语句为：select * from user where uid in ( ? , ? , ? ) 。结果如图：

​

 补充：当传入多个参数，即foreach的参数为map类型时候

我们有时候需要多个条件的查询语句时候，如：select * from user where usex = ? and uid in ( ? , ? , ? ) 这样的语句时候，就需要往元素中传入多个值，这个时候元素中collection属性的值就得为遍历中实际传入item的值了。同样的，看例子就懂了，如下映射语句：

select * from user where usex = #{usex} and uid in #{item}

Dao接口：

List selectUserByForeachMap(HashMap map);

Controller中测试：

// 使用foreach元素，查询用户信息
    List listId = new ArrayList();
    listId.add(1);
    listId.add(11);
    listId.add(31);
    HashMap map = new HashMap();
    //注意这个maps对应元素中collection属性的值
    //因为我们需要其中的id值
      map.put("maps",listId);
      map.put("usex","女");
    System.out.println("传入的参数为："+map);
    List listByForeach = userDao.selectUserByForeachMap(map);
    System.out.println("foreach元素================");
    for (MyUser myUser : listByForeach) {
      System.out.println(myUser);
    }

注意这个map.put("maps",listId);中的maps对应元素中collection属性的值，因为我们需要这个id值来传给元素解析。map.put("usex","女");中的usex对应SQL语句的usex = #{usex}，结果图：

​

 元素

在模糊查询时，如果使用“${}”拼接字符串，则无法防止SQL注入问题。如果使用字符串拼接函数或连接符号，但不同数据库的拼接函数或连接符号不同，如MySQL的concat函数、Oracle的连接符号“||”。这样，SQL映射文件就需要根据不同的数据库提供不同的实现，显然是比较麻烦，且不利于代码的移植。幸运的是，MyBatis提供了元素来解决这一问题。

映射语句：

  
    
    
    select * from user where uname like #{paran_uname}
  

Dao接口：

public  List selectUserByBind(MyUser user);

Controller中测试：

//使用bind元素查询用户信息
    MyUser bindmu = new MyUser();
    bindmu.setUname("张");
    List listByBind = userDao.selectUserByBind(bindmu);
    System.out.println("bind元素================");
    for (MyUser myUser : listByBind) {
      System.out.println(myUser);
    }

看看我们最后正确的字符串拼接结果：%张%

运行截图：

​

 原创作者：浩

​