Mybatis的动态Sql组合模式详情

Mybatis 中动态Sql的组合模式使得我们可以根据不同的条件转换为不同的Sql语句，从而能够满足更加灵活的业务需求。在 Mybatis 中，动态 Sql 的组合模式主要采用了 OGNL 表达式的方式来实现。在本文中，我们将详细讲解 Mybatis 中动态Sql组合模式的使用方法和示例。

1. 动态Sql的组合模式

动态Sql 的组合模式一般有以下几种方式：

if

if 条件判断语句可以用于非常简单的条件场景，它的语法非常简单，主要包含以下三部分：

• test：指定判断条件，可以是任意的 OGNL 表达式。
• 开始标签：用于指定 if 的开始位置。
• 结束标签：用于指定 if 的结束位置。

具体语法如下：

<select id="findUser" parameterType="User" resultMap="userResultMap">
  SELECT * FROM tb_user
  WHERE 1=1
  <if test="id != null">
    AND id=#{id}
  </if>
  <if test="username != null">
    AND username=#{username}
  </if>
</select>

在这个例子中，如果传入的参数中包含 id，那么生成的Sql中将包含 AND id=#{id} 这部分语句；如果传入的参数中包含 username，那么生成的Sql中将包含 AND username=#{username} 这部分语句。

choose、when、otherwise

choose、when、otherwise 三个语句结合起来可以实现多条件查询。choose 语句必须放在最外层，否则会报错。具体语法如下：

<select id="findUser" parameterType="User" resultMap="userResultMap">
  SELECT * FROM tb_user
  WHERE 1=1
  <choose>
    <when test="id != null">
      AND id=#{id}
    </when>
    <when test="username != null">
      AND username=#{username}
    </when>
    <otherwise>
      AND 1=2
    </otherwise>
  </choose>
</select>

在这个例子中，如果传入的参数中包含 id，那么生成的Sql中将包含 AND id=#{id} 这部分语句；如果传入的参数中包含 username，那么生成的Sql中将包含 AND username=#{username} 这部分语句；如果传入的参数中既没有 id 也没有 username，那么生成的Sql中将包含 AND 1=2 这部分语句。

foreach

foreach 语句可以用于处理集合类型的参数，例如 List、Array、Set 等等。具体语法如下：

<select id="findUser" parameterType="List" resultMap="userResultMap">
  SELECT * FROM tb_user
  WHERE 1=1
  <foreach collection="list" item="user" separator="OR">
    (id=#{user.id} AND username=#{user.username})
  </foreach>
</select>

在这个例子中，传入的参数是一个 List，其中包含多个 User 对象，通过 foreach 语句遍历这个 List，并将 User 对象的 id 和 username 作为参数传递给 Sql 语句，生成的Sql中将包含 (id=#{user.id} AND username=#{user.username}) 这部分语句，同时多个语句之间用 OR 连接。

2. 示例

下面我们通过两个示例来说明动态 Sql 的组合模式的使用方法。

示例一

一个简单的用户列表查询，需要根据用户的 username 和 email 进行模糊查询。如果传入的参数中包含 username 和 email，则根据它们进行查询；如果只包含其中一个，则根据这个参数进行查询；如果都不包含，则查询所有用户。

<select id="findUser" parameterType="User" resultMap="userResultMap">
  SELECT * FROM tb_user
  WHERE 1=1
  <if test="username != null and email != null">
    AND username LIKE CONCAT('%', #{username}, '%')
    AND email LIKE CONCAT('%', #{email}, '%')
  </if>
  <if test="username != null and email == null">
    AND username LIKE CONCAT('%', #{username}, '%')
  </if>
  <if test="username == null and email != null">
    AND email LIKE CONCAT('%', #{email}, '%')
  </if>
</select>

在这个例子中，当同时包含 username 和 email 参数时，Sql 语句中将同时包含查询语句 AND username LIKE CONCAT('%', #{username}, '%') 和 AND email LIKE CONCAT('%', #{email}, '%')；当只包含 username 参数时，Sql 语句中将仅包含查询语句 AND username LIKE CONCAT('%', #{username}, '%')；当只包含 email 参数时，Sql 语句中将仅包含查询语句 AND email LIKE CONCAT('%', #{email}, '%')。如果 username 和 email 参数都为空，则 Sql 语句中将不包含查询语句。

示例二

一个简单的用户列表查询，需要根据用户的 username 进行精确查询。username 的列表是一个 List 类型的参数。

<select id="findUser" parameterType="List" resultMap="userResultMap">
  SELECT * FROM tb_user
  WHERE 1=1
  <foreach collection="list" item="username" separator="OR">
    username=#{username}
  </foreach>
</select>

在这个例子中，传入的参数是一个 List，其中包含多个 username，通过 foreach 语句遍历这个 List，并将 username 作为参数传递给 Sql 语句，生成的Sql中将包含 username=#{username} 这部分语句，同时多个语句之间用 OR 连接。