【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 数据库别名