【Mybatis】MyBatis之动态SQL（六）

　　MyBatis 的强大特性之一便是它的动态 SQL，本章介绍动态 SQL

　　查看本章，请先阅读【Mybatis】MyBatis对表执行CRUD操作（三）。

　　本例表结构

 CREATE TABLE `employee` (
   `id` int(11) NOT NULL AUTO_INCREMENT,
   `last_name` varchar(255) DEFAULT NULL,
   `gender` char(1) DEFAULT NULL,
   `email` varchar(255) DEFAULT NULL
   PRIMARY KEY (`id`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

if

　　if标签：用于逻辑判断，其中test属性，填写的是判断表达式（OGNL）

　　示例

　　1、EmployeeMapper新增Sql如下：

 <!-- if：判断 -->
 <select id="testConditionIf"
     resultType="com.hd.test.pojo.Employee">
     select id, last_name lastName, gender from employee
     <!--
         test：判断表达式（OGNL） OGNL参照PPT或者官方文档。
         c:if test 从参数中取值进行判断 遇见特殊符号应该去写转义字符： &&：

      -->
     where 1 = 1
     <if test="id != null">
         AND id = #{id}
     </if>
     <!-- 表达式中，字符串使用''单引号引起来 -->
     <if test="lastName != null and lastName.trim() != ''">
         AND last_name = #{lastName}
     </if>
     <!-- ognl会进行字符串与数字的转换判断  "0"==0 -->
     <if test="gender==0 or gender==1">
         AND gender = #{gender}
     </if>
     <!-- 转义字符: &amp;&amp; == &&    &quot;&quot; == ""-->
     <if test="email != null &amp;&amp; lastName!=&quot;&quot;">
         AND email = #{email}
     </if>
 </select>

　　2、EmployeeMapper接口中，新增方法

 public List<Employee> testConditionIf(Employee employee);

　　3、测试方法

 @Test
 public void test001() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testConditionIf(new Employee(null, "0", null));
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(list);
         }
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　4、执行结果

　　　　

choose

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

　　示例

　　1、EmployeeMapper新增Sql如下：

 <!-- choose -->
 <select id="testConditionChoose" resultType="com.hd.test.pojo.Employee">
     select id, last_name lastName, gender from employee
     where 1 = 1
     <choose>
         <when test="id != null">
             AND id = #{id}
         </when>
         <when test="lastName != null">
             AND last_name = #{lastName}
         </when>
         <when test="gender != null">
             AND gender = #{gender}
         </when>
         <when test="email != null">
             AND email = #{email}
         </when>
         <otherwise>
             AND 1 = 1
         </otherwise>
     </choose>
 </select>

　　2、EmployeeMapper接口中，新增方法

 public List<Employee> testConditionChoose(Employee employee);

　　3、测试方法　　

 @Test
 public void test002() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testConditionChoose(new Employee(1, null, null, null));
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(list);
         }
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　4、执行结果

　　　　

where

　　where标签：用于编写带where条件的sql，配合if标签使用，它会自动去除首个AND前缀。

　　示例

　　1、EmployeeMapper新增Sql如下：

 <!-- if + where -->
 <select id="testConditionIfWhere"
     resultType="com.hd.test.pojo.Employee">
     select id, last_name lastName, gender from employee
     <where>
         <if test="id != null">
             AND id = #{id}
         </if>
         <if test="lastName != null and lastName.trim() != ''">
             AND last_name = #{lastName}
         </if>
         <if test="gender==0 or gender==1">
             AND gender = #{gender}
         </if>
         <if test="email != null &amp;&amp; lastName!=&quot;&quot;">
             AND email = #{email}
         </if>
     </where>
 </select>

　　2、EmployeeMapper接口中，新增方法

 public List<Employee> testConditionIfWhere(Employee employee);

　　3、测试方法

 @Test
 public void test003() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testConditionIfWhere(new Employee("小红", "1", null));
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(list);
         }
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　4、执行结果

　　　　

trim

　　trim标签：可以去掉字符串的首尾字符串，以及在字符串前后添加前后缀

　　示例

　　1、EmployeeMapper新增Sql如下：

 <select id="testConditionIfTrim" resultType="com.hd.test.pojo.Employee">
     select id, last_name lastName, gender from employee
     <!-- 后面多出的and或者or where标签不能解决
         prefix="":前缀：trim标签体中是整个字符串拼串 后的结果。 prefix给拼串后的整个字符串加一个前缀
         prefixOverrides="": 前缀覆盖： 去掉整个字符串前面多余的字符
         suffix="":后缀 suffix给拼串后的整个字符串加一个后缀
         suffixOverrides="" 后缀覆盖：去掉整个字符串后面多余的字符 -->
     <trim prefix="where" prefixOverrides="AND">
         <if test="id != null">
             AND id = #{id}
         </if>
         <if test="lastName != null">
             AND last_name = #{lastName}
         </if>
         <if test="gender != null">
             AND gender = #{gender}
         </if>
         <if test="email != null">
             AND email = #{email}
         </if>
     </trim>
 </select> 

　　2、EmployeeMapper接口中，新增方法

 public List<Employee> testConditionIfTrim(Employee employee); 

　　3、测试方法

 @Test
 public void test004() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testConditionIfTrim(new Employee(1, null, null, null));
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(list);
         }
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　4、执行结果

　　　　

　　　　

foreach

　　动态 SQL 的另外一个常用的操作需求是对一个集合进行遍历，通常是在构建 IN 条件语句的时候

　　示例

　　1、EmployeeMapper新增Sql如下：　

 <!-- foreach -->
 <select id="testConditionForeach" resultType="com.hd.test.pojo.Employee">
     select id, last_name lastName, gender from employee
     <!--
          collection：指定要遍历的集合：
              list类型的参数会特殊处理封装在map中，map的key就叫list
          item：将当前遍历出的元素赋值给指定的变量
          separator:每个元素之间的分隔符
          open：遍历出所有结果拼接一个开始的字符
          close:遍历出所有结果拼接一个结束的字符
          index:索引。遍历list的时候是index就是索引，item就是当前值
                        遍历map的时候index表示的就是map的key，item就是map的值

          #{变量名}就能取出变量的值也就是当前遍历出的元素
        -->
     <foreach collection="ids" item="id" separator="," open="where id in (" close=")" >
         #{id}
     </foreach>
 </select>

　　2、EmployeeMapper接口中，新增方法

 public List<Employee> testConditionForeach(@Param("ids")List<Integer> ids);

　　3、测试方法

 @Test
 public void test005() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testConditionForeach(Arrays.asList(1, 2, 3, 4));
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(list);
         }
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 } 

　　4、执行结果

　　　　

set

　　set 元素会动态前置 SET 关键字，同时也会删掉无关的逗号，因为用了条件语句之后很可能就会在生成的 SQL 语句的后面留下这些逗号

　　示例

　　1、EmployeeMapper新增Sql如下：　

 <!-- set -->
 <update id="testConditionSet">
     update employee
     <set>
         <if test="lastName != null">
             last_name = #{lastName},
         </if>
         <if test="gender != null">
             gender = #{gender},
         </if>
         <if test="email != null">
             email = #{email},
         </if>
     </set>
     where id = #{id}
 </update> 

　　2、EmployeeMapper接口中，新增方法

 public boolean testConditionSet(Employee employee);

　　3、测试方法

 @Test
 public void test006() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         boolean f = mapper.testConditionSet(new Employee(1, "小白", "1", null));
         System.out.println(f);
         session.commit();
     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　4、执行结果

　　　　

bind

　　bind 元素可以从 OGNL 表达式中创建一个变量并将其绑定到上下文。比如：

 <select id="testConditionBind" resultType="Blog">
     <bind name="pattern" value="'%' + keyword + '%'" />
     SELECT * FROM employee  WHERE last_name LIKE #{pattern}
 </select>

sql

　　可以用来包含其他sql

 <sql id="selectSql">select id, last_name lastName, gender from employee</sql>

 <select id="testConditionInclude" resultType="com.hd.test.pojo.Employee">
     <include refid="selectSql"></include>
     where id = 1
 </select>

Mybatis中2个内置参数 _parameter和_databaseId

　　示例

　　1、EmployeeMapper新增Sql如下：

 <!-- 两个内置参数：
      不只是方法传递过来的参数可以被用来判断，取值。。。
      mybatis默认还有两个内置参数：
      _parameter:代表整个参数
          单个参数：_parameter就是这个参数
          多个参数：参数会被封装为一个map；_parameter就是代表这个map

      _databaseId:
          如果配置了databaseIdProvider标签。 _databaseId就是代表当前数据库的别名mysql
          如果没配置了databaseIdProvider标签。 _databaseId为null
   -->
 <select id="testInnerParameter" resultType="com.hd.test.pojo.Employee">
     <if test="_databaseId == 'mysql'">select * from ${_parameter}</if>
     <if test="_databaseId != 'mysql'">select * from ${_parameter} where 1 = 1</if>
 </select>

　　2、mybatis-config.xml中的配置

 <databaseIdProvider type="DB_VENDOR">
     <!-- 为不同的数据库厂商起别名 -->
     <property name="MySQL" value="mysql"/>
     <property name="Oracle" value="oracle"/>
     <property name="SQL Server" value="sqlserver"/>
 </databaseIdProvider>

　　3、EmployeeMapper接口中，新增方法　

 public List<Employee> testInnerParameter(String tableName);

　　4、测试方法

 @Test
 public void test007() throws IOException {

     InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
     SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

     SqlSession session = sessionFactory.openSession();

     try {
         EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
         List<Employee> list = mapper.testInnerParameter("employee");
         System.out.println(list.size());
         for (Employee employee : list) {
             System.out.println(employee);
         }

     } catch (Exception e) {
         e.printStackTrace();
     } finally {
         session.close();
     }
 }

　　5、执行结果，从执行结果可以看出，_parameter == employee 参数，_databaseId == mysql 数据库别名