使用动态 SQL 并非一件易事，但借助可用于任何 SQL 映射语句中的强大的动态 SQL 语言，MyBatis 显著地提升了这一特性的易用性。

    如果你之前用过 JSTL 或任何基于类 XML 语言的文本处理器，你对动态 SQL 元素可能会感觉似曾相识。在 MyBatis 之前的版本中，需要花时间了解大量的元素。借助功能强大的基于 OGNL 的表达式，MyBatis 3 替换了之前的大部分元素，大大精简了元素种类，现在要学习的元素种类比原来的一半还要少。

    • if
    • choose (when, otherwise)
    • trim (where, set)
    • foreach

    使用动态 SQL 最常见情景是根据条件包含 where 子句的一部分。比如：

    这条语句提供了可选的查找文本功能。如果不传入 “title”，那么所有处于 “ACTIVE” 状态的 BLOG 都会返回；如果传入了 “title” 参数，那么就会对 “title” 一列进行模糊查找并返回对应的 BLOG 结果（细心的读者可能会发现，“title” 的参数值需要包含查找掩码或通配符字符）。

    如果希望通过 “title” 和 “author” 两个参数进行可选搜索该怎么办呢？首先，我想先将语句名称修改成更名副其实的名称；接下来，只需要加入另一个条件即可。

    2.      resultType="Blog">
    3.   SELECT * FROM BLOG WHERE state = ‘ACTIVE’
    4.   <if test="title != null">
    5.     AND title like #{title}
    6.   </if>
    7.   <if test="author != null and author.name != null">
    8.     AND author_name like #{author.name}
    9.   </if>
    10. </select>

    choose、when、otherwise

    有时候，我们不想使用所有的条件，而只是想从多个条件中选择一个使用。针对这种情况，MyBatis 提供了 choose 元素，它有点像 Java 中的 switch 语句。

    还是上面的例子，但是策略变为：传入了 “title” 就按 “title” 查找，传入了 “author” 就按 “author” 查找的情形。若两者都没有传入，就返回标记为 featured 的 BLOG（这可能是管理员认为，与其返回大量的无意义随机 Blog，还不如返回一些由管理员精选的 Blog）。

    1. <select id="findActiveBlogLike"
    2.      resultType="Blog">
    3.   SELECT * FROM BLOG WHERE state = ‘ACTIVE’
    4.   <choose>
    5.     <when test="title != null">
    6.       AND title like #{title}
    7.     </when>
    8.     <when test="author != null and author.name != null">
    9.       AND author_name like #{author.name}
    10.     </when>
    11.     <otherwise>
    12.       AND featured = 1
    13.     </otherwise>
    14.   </choose>
    15. </select>

    前面几个例子已经方便地解决了一个臭名昭著的动态 SQL 问题。现在回到之前的 “if” 示例，这次我们将 “state = ‘ACTIVE’” 设置成动态条件，看看会发生什么。

    1. <select id="findActiveBlogLike"
    2.      resultType="Blog">
    3.   SELECT * FROM BLOG
    4.   <if test="state != null">
    5.     state = #{state}
    6.   </if>
    7.   <if test="title != null">
    8.     AND title like #{title}
    9.   </if>
    10.   <if test="author != null and author.name != null">
    11.     AND author_name like #{author.name}
    12.   </if>

    如果没有匹配的条件会怎么样？最终这条 SQL 会变成这样：

    1. SELECT * FROM BLOG
    2. WHERE

    这会导致查询失败。如果匹配的只是第二个条件又会怎样？这条 SQL 会是这样:

    1. SELECT * FROM BLOG
    2. WHERE
    3. AND title like ‘someTitle’

    MyBatis 有一个简单且适合大多数场景的解决办法。而在其他场景中，可以对其进行自定义以符合需求。而这，只需要一处简单的改动：

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

    如果 where 元素与你期望的不太一样，你也可以通过自定义 trim 元素来定制 where 元素的功能。比如，和 where 元素等价的自定义 trim 元素为：

    1. <trim prefix="WHERE" prefixOverrides="AND |OR ">
    2.   ...
    3. </trim>

    prefixOverrides 属性会忽略通过管道符分隔的文本序列（注意此例中的空格是必要的）。上述例子会移除所有 prefixOverrides 属性中指定的内容，并且插入 prefix 属性中指定的内容。

    用于动态更新语句的类似解决方案叫做 set。set 元素可以用于动态包含需要更新的列，忽略其它不更新的列。比如：

    1. <update id="updateAuthorIfNecessary">
    2.   update Author
    3.     <set>
    4.       <if test="username != null">username=#{username},</if>
    5.       <if test="password != null">password=#{password},</if>
    6.       <if test="email != null">email=#{email},</if>
    7.       <if test="bio != null">bio=#{bio}</if>
    8.     </set>
    9.   where id=#{id}
    10. </update>

    这个例子中，set 元素会动态地在行首插入 SET 关键字，并会删掉额外的逗号（这些逗号是在使用条件语句给列赋值时引入的）。

    来看看与 set 元素等价的自定义 trim 元素吧：

    1. <trim prefix="SET" suffixOverrides=",">
    2.   ...
    3. </trim>

    注意，我们覆盖了后缀值设置，并且自定义了前缀值。

    foreach

    动态 SQL 的另一个常见使用场景是对集合进行遍历（尤其是在构建 IN 条件语句的时候）。比如：

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

    foreach 元素的功能非常强大，它允许你指定一个集合，声明可以在元素体内使用的集合项（item）和索引（index）变量。它也允许你指定开头与结尾的字符串以及集合项迭代之间的分隔符。这个元素也不会错误地添加多余的分隔符，看它多智能！

    至此，我们已经完成了与 XML 配置及映射文件相关的讨论。下一章将详细探讨 Java API，以便你能充分利用已经创建的映射配置。

    要在带注解的映射器接口类中使用动态 SQL，可以使用 script 元素。比如:

    1.     @Update({"<script>",
    2.       "update Author",
    3.       "  <set>",
    4.       "    <if test='username != null'>username=#{username},</if>",
    5.       "    <if test='password != null'>password=#{password},</if>",
    6.       "    <if test='email != null'>email=#{email},</if>",
    8.       "  </set>",
    9.       "where id=#{id}",
    10.       "</script>"})
    11.     void updateAuthorValues(Author author);

    bind

    bind 元素允许你在 OGNL 表达式以外创建一个变量，并将其绑定到当前的上下文。比如：

    如果配置了 databaseIdProvider，你就可以在动态代码中使用名为 “_databaseId” 的变量来为不同的数据库构建特定的语句。比如下面的例子：

    1. <insert id="insert">
    2.   <selectKey keyProperty="id" resultType="int" order="BEFORE">
    3.     <if test="_databaseId == 'oracle'">
    4.       select seq_users.nextval from dual
    5.     </if>
    6.     <if test="_databaseId == 'db2'">
    7.       select nextval for seq_users from sysibm.sysdummy1"
    8.     </if>
    9.   </selectKey>
    10.   insert into users values (#{id}, #{name})
    11. </insert>

    动态 SQL 中的插入脚本语言

    MyBatis 从 3.2 版本开始支持插入脚本语言，这允许你插入一种语言驱动，并基于这种语言来编写动态 SQL 查询语句。

    可以通过实现以下接口来插入一种语言：

    1. public interface LanguageDriver {
    2.   ParameterHandler createParameterHandler(MappedStatement mappedStatement, Object parameterObject, BoundSql boundSql);
    3.   SqlSource createSqlSource(Configuration configuration, XNode script, Class<?> parameterType);
    4.   SqlSource createSqlSource(Configuration configuration, String script, Class<?> parameterType);
    5. }

    实现自定义语言驱动后，你就可以在 mybatis-config.xml 文件中将它设置为默认语言：

    1. <typeAliases>
    2.   <typeAlias type="org.sample.MyLanguageDriver" alias="myLanguage"/>
    3. </typeAliases>
    4. <settings>
    5.   <setting name="defaultScriptingLanguage" value="myLanguage"/>
    6. </settings>

    或者，你也可以使用 lang 属性为特定的语句指定语言：

    1. <select id="selectBlog" lang="myLanguage">
    2.   SELECT * FROM BLOG
    3. </select>

    或者，在你的 mapper 接口上添加 @Lang 注解：

    1. public interface Mapper {
    2.   @Lang(MyLanguageDriver.class)
    3.   @Select("SELECT * FROM BLOG")
    4.   List<Blog> selectBlog();

    提示 可以使用 Apache Velocity 作为动态语言，更多细节请参考 MyBatis-Velocity 项目。