MyBatis最佳实践之——动态SQL语句

使用动态 SQL 并非一件易事，但借助可用于任何 SQL 映射语句中的强大的动态 SQL 语言，MyBatis 显著地提升了这一特性的易用性。
动态SQL主要是用来解决SQL语句生成的问题。

借助功能强大的基于 OGNL 的表达式，MyBatis 3 替换了之前的大部分元素，大大精简了元素种类，现在要学习的元素种类比原来的一半还要少。

• if
• choose（when，otherwise）
• trim（where，set）
• foreach

场景1：是否启用where条件，根据传参来决定：
如下所示，当sn不为空时，根据sn来查询device信息。
一般用在查询列表的附加条件上。

<select id="findDeviceBySn"
     resultType="Device">
  SELECT * FROM t_device
  WHERE state = '1'
  <if test="sn != null">
    AND sn = #{sn}
  </if>
</select>

场景2：
在查询条件中，我们不想使用所有的条件，只是想从多个条件中选择一个使用。（类似java的switch）
如下示例：传入了 “title” 就按 “title” 查找，传入了 “author” 就按 “author” 查找的情形。若两者都没有传入，就返回标记为 featured 的 BLOG（这可能是管理员认为，与其返回大量的无意义随机 Blog，还不如返回一些由管理员精选的 Blog）。

<select id="findActiveBlogLike"
     resultType="Blog">
  SELECT * FROM BLOG WHERE state = ‘ACTIVE’
  <choose>
    <when test="title != null">
      AND title like #{title}
    </when>
    <when test="author != null and author.name != null">
      AND author_name like #{author.name}
    </when>
    <otherwise>
      AND featured = 1
    </otherwise>
  </choose>
</select>

场景3 ：
where关键字之后，不一定有查询条件。这是可以使用where标签。如下所示：

where 元素只会在子元素返回任何内容的情况下才插入 “WHERE” 子句。而且，若子句的开头为 “AND” 或 “OR”，where 元素也会将它们去除。

<select id="findActiveBlogLike"
     resultType="Blog">
  SELECT * FROM BLOG
  <where>
    <if test="state != null">
         state = #{state}
    </if>
    <if test="title != null">
        AND title like #{title}
    </if>
    <if test="author != null and author.name != null">
        AND author_name like #{author.name}
    </if>
  </where>
</select>

场景4：在update语句中set内容与where类似，用于动态更新语句的类似解决方案叫做 set。set 元素可以用于动态包含需要更新的列，忽略其它不更新的列。
示例如下：

<update id="updateAuthorIfNecessary">
  update Author
    <set>
      <if test="username != null">username=#{username},</if>
      <if test="password != null">password=#{password},</if>
      <if test="email != null">email=#{email},</if>
      <if test="bio != null">bio=#{bio}</if>
    </set>
  where id=#{id}
</update>

场景五：trim标签的用法

<!--
trim 的使用
替代where标签的使用
-->
<select id="selectListTrim" resultMap="BaseResultMap" parameterType="user">
	select <include refid="baseSQL"></include>
	<!-- <where>
	<if test="username!=null">
	and name = #{username}
	</if>
	</where> -->
	<trim prefix="where" prefixOverrides="AND |OR ">
		<if test="userName!=null">
		and user_name = #{userName}
		</if>
		<if test="age != 0">
		and age = #{age}
		</if>
	dsa</trim>
</select>
<!-- 替代set标签的使用，我们覆盖了后缀值设置，并且自定义了前缀值 -->
<update id="updateUser" parameterType="User">
	update t_user
	<trim prefix="set" suffixOverrides=",">
		<if test="userName!=null">
			user_name = #{userName},
		</if>
		<if test="age != 0">
			age = #{age}
		</if>
	</trim>
	where id=#{id}
</update>

场景六：对集合进行遍历（尤其是在构建 IN 条件语句的时候）。比如：

<select id="selectPostIn" resultType="domain.blog.Post">
  SELECT *
  FROM POST P
  <where>
    <foreach item="item" index="index" collection="list"
        open="ID in (" separator="," close=")" nullable="true">
          #{item}
    </foreach>
  </where>
</select>

foreach 元素允许你指定一个集合，声明可以在元素体内使用的集合项（item）和索引（index）变量。
它也允许你指定开头与结尾的字符串以及集合项迭代之间的分隔符。
这个元素也不会错误地添加多余的分隔符。
可以将任何可迭代对象（如 List、Set 等）、Map 对象或者数组对象作为集合参数传递给 foreach。当使用可迭代对象或者数组时，index 是当前迭代的序号，item 的值是本次迭代获取到的元素。当使用 Map 对象（或者 Map.Entry 对象的集合）时，index 是键，item 是值。

<delete id="deleteByList" parameterType="java.util.List">
	delete from t_user
	where id in
	<foreach collection="list" item="item" open="(" separator="," close=")">
		#{item.id,jdbcType=INTEGER}
	</foreach>
</delete>