MyBatis 的动态 SQL 武器库：if、choose、when 和 otherwise 深入解析

2023-10-20 08:17:24

MyBatis 动态 SQL：提升代码可读性与维护性

简介

在持久层开发中，MyBatis 是一个广受好评的框架。它的动态 SQL 功能允许开发者根据不同的条件拼接 SQL 语句，极大地提高了代码的可读性和可维护性，同时减少了代码重复。

动态 SQL 语法

MyBatis 提供了四种动态 SQL 语法：if、choose、when 和 otherwise。

if 语法： 根据一个条件判断是否执行 SQL 代码。

<if test="condition">
  SQL 代码
</if>

choose 语法： 根据多个条件选择执行哪段 SQL 代码。

<choose>
  <when test="condition1">
    SQL 代码 1
  </when>
  <when test="condition2">
    SQL 代码 2
  </when>
  <otherwise>
    SQL 代码 3
  </otherwise>
</choose>

when 语法： 指定某个条件满足时执行哪段 SQL 代码。

<when test="condition">
  SQL 代码
</when>

otherwise 语法： 指定所有条件都不满足时执行哪段 SQL 代码。

<otherwise>
  SQL 代码
</otherwise>

代码示例

以下代码示例展示了如何使用动态 SQL 语法：

根据用户角色查询数据：

<select id="getDataByRole" resultType="com.example.domain.Data">
  <choose>
    <when test="role == 'admin'">
      SELECT * FROM data WHERE 1=1
    </when>
    <when test="role == 'user'">
      SELECT * FROM data WHERE user_id = #{userId}
    </when>
    <otherwise>
      SELECT * FROM data WHERE 1=2
    </otherwise>
  </choose>
</select>

根据用户 ID 查询用户信息：

<select id="getUserById" resultType="com.example.domain.User">
  SELECT * FROM user WHERE id = #{id}
  <if test="username != null">
    AND username = #{username}
  </if>
</select>

最佳实践

在使用 MyBatis 动态 SQL 时，需要注意以下最佳实践：