AI专业者开发社区 1 号成员
  •  0 回帖  •  1 浏览  •  5 个月前
 

MyBatis动态SQL语法

【注：摘自MyBatis 官网 】

1、动态 SQL 的元素：

2、if 语句：
 
<select id="findActiveBlogWithTitleLike" resultType="Blog">
  SELECT * FROM BLOG 
  WHERE state = ‘ACTIVE’ 
  <if test="title != null">
    AND title like #{title}
  </if>
</select>
这条语句会提供一个可选的文本查找功能。如果你没有传递 title, 那么所有激活的博客都会被返回。但是如果你传递了 title, 那么就会查找相近的 title(对于敏锐的检索, 这中情况下你的参数值需要包含任意的遮掩或通配符) 的博客。
 
假若我们想可选地搜索 title 和 author 呢? 首先, 要改变语句的名称让它有意义。然后 简单加入另外的一个条件。
<select id="findActiveBlogLike" resultType="Blog">
  SELECT * FROM BLOG WHERE state = ‘ACTIVE’ 
  <if test="title != null">
    AND title like #{title}
  </if>
  <if test="author != null and author.name != null">
    AND author_name like #{author.name}
  </if>
</select>
 
3、choose（when, otherwise）
 
有时我们不想应用所有的条件, 相反我们想选择很多情况下的一种。Java 中的 switch 和语句相似,MyBatis 提供 choose 元素。
我们使用上面的示例, 但是现在我们来搜索当 title 提供时仅有 title 条件, 当 author 提 供时仅有 author 条件。如果二者都没提供, 只返回 featured blogs。
 
<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>
【注：choose 语句中的 when 是只要满足一个条件之后就放弃继续比较了，比较方式同 Java 中的 Switch 语句类似。】
 
4、trim（where, set）
 
考虑，多个动态查询条件情况：
<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>
</select>

如果这些条件都没有匹配上将会发生什么? 这条 SQL 结束时就会成这样:

SELECT * FROM BLOG 
WHERE

这会导致查询失败。如果仅仅第二个条件匹配是什么样的? 这条 SQL 结束时就会是这 样:

SELECT * FROM BLOG 
WHERE 
AND title like ‘someTitle’

这个查询也会失败。这个问题不能简单的用条件来解决, 如果你从来没有这样写过, 那 么你以后也不会这样来写。

MyBatis 有一个简单的处理, 这在 90% 的情况下都会有用。而在不能使用的地方, 你可 以自定义处理方式。加上一个简单的改变, 所有事情都会顺利进行:

<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>
where 元素知道如果由被包含的标记返回任意内容, 就仅仅插入“WHERE” 。而且, 如 果以“AND”或“OR”开头的内容, 那么就会跳过 WHERE 不插入。
 
如果 where 元素没有做出你想要的, 你可以使用 trim 元素来自定义。比如, 和 where 元素相等的trim元素是:
<trim prefix="WHERE" prefixOverrides="AND |OR">
  ... 
</trim>
prefixOverrides属性采用管道文本分隔符来覆盖, 这里的空白也是重要的。它的结果就是移除在 prefixOverrides 属性中指定的内容, 插入在 with 属性中的内容。
 
和动态更新语句相似的解决方案是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>
这里,set 元素会动态前置 SET 关键字, 而且也会消除任意无关的逗号, 那也许在应用 条件之后来跟踪定义的值。
 
如果你对和这相等的 trim 元素好奇, 它看起来就是这样的:
<trim prefix="SET" suffixOverrides=",">
  ...
</trim>
注意这种情况下我们覆盖一个后缀, 而同时也附加前缀。
 
5、foreach
 
另外一个动态 SQL 通用的必要操作是迭代一个集合, 通常是构建在 IN 条件中的。
<select id="selectPostIn" resultType="domain.blog.Post">
  SELECT *
  FROM POST P
  WHERE ID in
  <foreach item="item" index="index" collection="list"
      open="(" separator="," close=")">
        #{item}
  </foreach>
</select> 
foreach 元素是非常强大的, 它允许你指定一个集合, 声明集合项和索引变量, 它们可 以用在元素体内。它也允许你指定开放和关闭的字符串, 在迭代之间放置分隔符。这个元素 是很智能的, 它不会偶然地附加多余的分隔符。
注意 你可以传递一个 List 实例或者数组作为参数对象传给 MyBatis。当你这么做的时候,MyBatis 会自动将它包装在一个 Map 中, 用名称在作为键。List 实例将会以“list” 作为键, 而数组实例将会以“array”作为键。
 
6、bind
 
bind 元素允许你在自定义变量（不用符合 OGNL 规范），并且应用到上下文中。例如：
<select id="selectBlogsLike" resultType="Blog">
  <bind name="pattern" value="'%' + _parameter.getTitle() + '%'" />
  SELECT * FROM BLOG
  WHERE title LIKE #{pattern}
</select>