MyBatis学习——动态SQL

　　开发人员在使用JDBC框架或者其他类似的框架进行数据库开发时，通常都要根据需求去手动拼接SQL，这样非常麻烦，而myBatis提供了对SQL语句动态组装的功能，恰好解决了这一问题。

一，动态SQL中的元素

　　动态SQL是MyBatis的强大特性之一，MyBatis 3后采用了基于OGNL的表达式来完成动态SQL，

　　MyBatis动态SQL中的主要元素，如下：

元素	说明
<if>	判断语句，用于单条件分支判断
<choose>(<when>,<otherwise>)	相当于Java中的switch..case...default
<where>,<trim>,<set>	补助元素，用于处理一些SQL拼接，特殊字符问题
<foreach>	循环语句，常用于in语句等例举条件中
<bind>	从OGNL表达式中创建一个变量，并将其绑定到上下文中，常用于模糊查询的sql中

二.

1.<if>元素：通常用于通过多个条件来精确查询某个数据

　　在MyBatis中，<if>元素是最常用的判断语句，它类似Java中的if语句，主要用于简单的条件判断。

　　（1）在映射文件中使用<if>元素来编写根据客户名和客户职业组合信息来查询客户信息.

<!-- 使用if元素来进行查询 -->
    <select id="findCustomerByNameAndJobs" parameterType="com.itheima.po.Customer"
                                          resultType="com.itheima.po.Customer">
        select * from t_customer where 1=1
        <if test="username != null and username !='' ">
            and username like concat('%',#{username},'%')
        </if>
        <if test="jobs != null and jobs !='' ">
            and jobs=#{jobs}
        </if>
    </select>

　　使用<if>元素的test属性对username和jobs进行了非空判断（test属性常用于条件判断中，用于判断真假，大部分时候是用于进行非空判断),如果传入的条件非空，就进行sql拼接。

　　（2）在测试类中，编写测试方法findCustomerByNameAndJobs:

/**
     * 根据用户名和用户的工作来查询用户
     */
    @Test
    public void findCustomerByNameAndJobsTest() {
        //通过工具类来生成SqlSession对象
        SqlSession sqlSession=MyBatisUtils.getSession();
        //创建Customer对象，封装需要组合查询的条件
        Customer customer=new Customer();
        customer.setJobs("teacher");
        customer.setUsername("jack");

        //执行SqlSession对象的查询方法，返回一个结果集
        List<Customer> customers=sqlSession.selectList("com.itheima.mapper.CustomerMapper.findCustomerByNameAndJobs", customer);
        //输出查询结果
        for(Customer customer2:customers) {
            System.out.println(customer2);
        }

        //关闭sqlSession
        sqlSession.close();
    }

　　（3）测试结果：

　　（4）如果将上面代码中的设值注释掉，如下，就会将所有的信息都输出来：

     /**
      * 根据用户名和用户的工作来查询用户
      */
     @Test
     public void findCustomerByNameAndJobsTest() {
         //通过工具类来生成SqlSession对象
         SqlSession sqlSession=MyBatisUtils.getSession();
         //创建Customer对象，封装需要组合查询的条件
         Customer customer=new Customer();
         //customer.setJobs("teacher");
         //customer.setUsername("jack");

         //执行SqlSession对象的查询方法，返回一个结果集
         List<Customer> customers=sqlSession.selectList("com.itheima.mapper.CustomerMapper.findCustomerByNameAndJobs", customer);
         //输出查询结果
         for(Customer customer2:customers) {
             System.out.println(customer2);
         }

         //关闭sqlSession
         sqlSession.close();
     }

 2.<choose>，<when>,<otherwise>：从多个选项中选一个去执行

　　在<if>中，只要test属性中的条件为真，就去执行元素中的条件语句，但是有时候在实际生活中是需要从多个选项中选择一个去执行，例如

　　当客户名不可空，则只根据客户名进行客户筛选，

　　当客户名为空，职业不为空时就根据客户职业进行客户筛选，

　　如果两者都为空，就查询出所有电话不为空的客户信息

　　在此种情况下，是不能使用<if>元素的，针对如上情况，可以使用<choose>,<when>,<otherwise>元素组合实现上面的情况

　　（1）.在映射文件中配置如下

<!-- <choose>(<when>,<otherwise>元素的组合使用) -->
    <select id="findCustomerByNameOrJobs" parameterType="com.itheima.po.Customer"
                                          resultType="com.itheima.po.Customer">
        select * from t_customer where 1=1
        <choose>

            <when test="username != null and username != '' ">
                and username like concat('%',#{username},'%')
            </when>
            <when test="jobs != null and jobs !='' ">
                and jobs=#{jobs}
            </when>
            <otherwise>
                and phone is not null
            </otherwise>

        </choose>
    </select>

　　在上述代码中，使用了<choose>,<when>,<otherwise>组合，当第一个<when>元素中的条件为真时，则只动态地组装第一个<when>元素中的条件，否则就继续向下判断第二个<when>元素中的条件是否为真，依次类推，如果<when>中的条件都不为真时，就会执行<otherwise>内的SQL片段。

　　（2）创建测试方法

/**
     * 根据用户名或者职业来查询用户信息
     */
    @Test
    public void findCustomerByNameOrJobs() {
        //通过工具类来生成SqlSession对象
        SqlSession sqlSession=MyBatisUtils.getSession();
        //创建Customer对象，封装需要组合查询的条件
        Customer customer=new Customer();
        customer.setJobs("teacher");
        customer.setUsername("jack");

        //执行SqlSession对象的查询方法，返回一个结果集
        List<Customer> customers=sqlSession.selectList("com.itheima.mapper.CustomerMapper.findCustomerByNameOrJobs", customer);
        //输出查询结果
        for(Customer customer2:customers) {
            System.out.println(customer2);
        }

        //关闭sqlSession
        sqlSession.close();
    }

　　（3）测试结果

　　（4）当把customer.setUsername("jack")注释掉后，结果为：

　　（5）如果把customer.setJobs（“teacher”）也注释掉后，结果为：

　　

3.<where>,<trim>元素

　　在前面的小节中编写的SQL后面都添加了“where 1=1 "这个条件，那么为什么要这么写呢？是应为如果将后面的”where 1=1“去掉，那么MyBatis拼接出来的SQL语句将会出错

　　SELECT *from t_customer  where and usename like  concat( '%',#{username}, '%');

　　在上面的语句中，where后面跟的是and，这样将出错，而加入了where 1=1 后，既保证了where后面的条件成立，也保证了避免where后面跟着是and或者or.

那么在Mybatis中有什么办法是可以不加入”1=1“这个条件也可以呢？

　　MyBatis提供了<where>元素来处理这样的问题。例如

 　　<select id="findCustomerByNameAndJobs" parameterType="com.itheima.po.Customer"
                                          resultType="com.itheima.po.Customer">
        select * from t_customer 
　　　　　<where>
           <if test="username != null and username !='' ">
               and username like concat('%',#{username},'%')
           </if>
           <if test="jobs != null and jobs !='' ">
               and jobs=#{jobs}
           </if> 
　　　　</where>
   </select>

　　在上面的语句中,使用<where>元素取代了”where 1=1“, where元素会自动判断组合条件下的拼接的sql语句，只有当<where>里的条件成立时，才会在拼接sql时，加入where元素，否则不会添加，即使where后面有多余的"and"，“or”，<where>元素会自动将它们除去。

4.<set>元素

　　在Hibernate中，如果要更新一条数据，就需要发送所有的字段给持久化对象，然而在实际应用中，大多数情况下，是只跟新某一个字段或者几个字段，如果更新的每一条数据都要将所有的属性都更新一遍，那么其执行效率是非常的低，有没有办法使程序只更新需要更新的字段？

　　在MyBatis中，提供了<set>元素来完成这一工作，<set>元素的作用用于更新操作，其主要作用是在动态包含的SQL语句前输出一个SET关键字，并且将SQL语句中最后一个多余的逗号去除。

　　例如，在入门案例中，使用<set>元素对更新操作的代码进行修改如下:

<!-- set元素的使用 -->
    <update id="updateCustomer" parameterType="com.itheima.po.Customer">

        update t_customer
        <set>
            <if test="username != null and username !='' ">
                username=#{username},
            </if>
            <if test="jobs != null and jobs != ''">
                jobs=#{jobs},
            </if>
            <if test ="phone != null and phone != ''">
                phone=#{phone},
            </if>
        </set>
        where id=#{id}

    </update>

　　 在上面的sql语句中，使用了<set>和<if>语句相组合的方法将组装update语句，其中<set>元素会自动的动态前置SET关键字，同时也会消除sql语句的最后一个多余的逗号，<if>元素是用来判断相应的字段是否传入值，如果传入的更新字段非空，就将此字段进行动态的组装，并且更新此字段，否则此字段不更新。

　　在测试类中编写如下代码：

    /**
     *使用set 更新客户
     */
    @Test
    public void updateCustomer1Test() {
        //1.通过工具类来生成SqlSession对象
        SqlSession sqlSession=MyBatisUtils.getSession();
        //2.创建Customer对象，并向对象中添加数据
        Customer customer=new Customer();
        customer.setId(3);
        customer.setPhone("444444");
        //3.执行sqlSession的更新方法，返回的是受影响的行数
        int rows=sqlSession.update("com.itheima.mapper.CustomerMapper.updateCustomer", customer);
        //4.根据返回的结果来判断是否更新成功
        if(rows>0) {
            System.out.println("更新成功！");
        }else {
            System.out.println("更新失败！");
        }

        //5.提交事务
        sqlSession.commit();
        //6.关闭事务
        sqlSession.close();
    }
    

　　测试结果如下：

　　注意：使用<set>和<if>元素组合进行update语句动态的SQL组装时，如果<set>中的内容都为空，则会出现sql语法错误，所以在<set>元素进行动态更新时，要确保传入的更新字段不为空。

5.<foreach>元素

　　该元素是用于数组和集合循环遍历。

　　<foreach>元素是通常在构建IN条件语句时使用的，其使用方法如下

<select id="findCustomerByIds" parameterType="List" resultType="com.itheima.po.Customer">
        select * from t_customer where id in
        <foreach item="id" index="index" collection="list" open="("  separator="," close=")">
            #{id}
        </foreach>
    </select>

　　在上述代码中，使用了<foreach>元素对传入的集合进行了遍历并进行了动态的SQL组转，其属性如下：

　　item：配置的是循环中当前的元素。

　　index:配置的是当前元素在集合的位置下标。

　　collection：配置的list是传递过来的参数类型（首字母小写），她可以是一个array，list（或者是collection），Map集合的建，POJO包装类中数组或者集合类型的属性名。

　　open和close：配置的是以什么符号将这些集合元素包装起来。

　　separate：配置的是各个元素之间的间隔符。

　　在测试类中编写如下代码，验证

/**
     * 根据客户编号批量查询客户信息
     */
    @Test
    public void findCustomerByIdsTest() {
        //1.获取SqlSession对象
        SqlSession sqlSession=MyBatisUtils.getSession();
        //2.创建一个list集合，用来封装查询的id值
        List<Integer> ids=new ArrayList<Integer>();
        ids.add(2);
        ids.add(3);
        //3.执行SqlSession的查询方法，返回结果集
        List<Customer> customers=sqlSession.selectList("com.itheima.mapper.CustomerMapper.findCustomerByIds", ids);
        //4.输出查询的结果
        for(Customer customer:customers) {
            System.out.println(customer);
        }
        //5.关闭sqlSession
        sqlSession.close();
    }

　　测试结果如下：

　　注意：在使用<foreach>元素时，应注意的事项是collection属性值，该属性是必须要指定的，并且在不同的情况下，该属性的值是不同的，主要三种情况：

　　（1）如果在调用该sql语句时，传入的是一个参数，并且参数的类型是一个数组或者是list的时候，该collection属性值就是array和list（或者collection）

　　（2）如果传入的是多个参数的时候，就需要把它们封装成一个Map，单个参数也是可以这样封装的，这时候collection属性值就是Map的键

　　（3）如果传进来的是POJO的包装类的时候，collection属性值就是该包装类中需要进行遍历的数组或者集合的属性名。