1. 什么是动态 SQL？
在使用 MyBatis 进行数据库查询时，可能会遇到一些需要根据条件动态生成 SQL 语句的情况。MyBatis 提供了强大的动态 SQL 支持，通过标签和条件语句，可以让 SQL 语句根据不同的输入参数动态生成。这大大提高了代码的灵活性，避免了拼接 SQL 语句的繁琐和出错风险。
2. 动态 SQL 的常见场景
- 条件查询：根据不同的参数执行不同的查询条件。
- 批量插入或更新：动态生成多个插入或更新语句。
- 分页查询：根据分页参数动态限制查询范围。
- 可选查询条件：根据用户输入，动态生成 SQL。
3. 动态 SQL 的常用标签
MyBatis 提供了一些标签来支持动态 SQL，包括：
<if>：判断条件，生成部分 SQL。<choose>：类似于switch语句，在多个条件之间选择。<where>：自动添加WHERE，并处理多余的AND或OR。<trim>：在 SQL 前后添加或去除多余的字符（如逗号、AND）。<foreach>：用于循环遍历集合，生成动态 SQL。<set>：在更新语句中处理动态的SET字段。
4. 常见动态 SQL 用法示例
4.1 使用 <if> 标签
假设我们有一个查询用户的需求，根据不同的查询条件（username 和 age）来生成查询 SQL：
Mapper XML 文件：
<select id="selectUsers" parameterType="map" resultType="User">SELECT * FROM users<where><if test="username != null">username = #{username}</if><if test="age != null">AND age = #{age}</if></where>
</select>
生成 SQL 示例：
- 当传入
username="Alice"时：SELECT * FROM users WHERE username = 'Alice'; - 当传入
username="Alice", age=25时：SELECT * FROM users WHERE username = 'Alice' AND age = 25;
4.2 使用 <choose> 标签
<choose> 标签类似于 Java 中的 switch，可以根据条件选择执行某段 SQL。
<select id="selectUserByStatus" parameterType="map" resultType="User">SELECT * FROM users<where><choose><when test="status == 'active'">status = 'active'</when><when test="status == 'inactive'">status = 'inactive'</when><otherwise>1 = 1</otherwise></choose></where>
</select>
SQL 示例：
- 当
status='active'时：SELECT * FROM users WHERE status = 'active'; - 当没有传入
status时：SELECT * FROM users WHERE 1 = 1;
4.3 使用 <foreach> 标签
<foreach> 常用于处理集合类型参数，比如批量插入或查询。
<select id="selectUsersByIds" parameterType="list" resultType="User">SELECT * FROM users WHERE id IN<foreach item="id" index="index" collection="list" open="(" separator="," close=")">#{id}</foreach>
</select>
Java 调用：
List<Integer> ids = Arrays.asList(1, 2, 3);
userMapper.selectUsersByIds(ids);
生成 SQL：
SELECT * FROM users WHERE id IN (1, 2, 3);
4.4 使用 <where> 标签
<where> 会自动处理 SQL 中多余的 AND 或 OR，避免语法错误。
<select id="selectUsers" parameterType="map" resultType="User">SELECT * FROM users<where><if test="username != null">username = #{username}</if><if test="age != null">AND age = #{age}</if></where>
</select>
- 当只传入
age=25时：SELECT * FROM users WHERE age = 25;
4.5 使用 <set> 标签
在更新语句中，如果只有部分字段需要更新，使用 <set> 标签可以避免多余的逗号。
<update id="updateUser" parameterType="User">UPDATE users<set><if test="username != null">username = #{username},</if><if test="age != null">age = #{age},</if><if test="status != null">status = #{status}</if></set>WHERE id = #{id}
</update>
SQL 示例：
- 当传入
username="Alice"和status="active"时：UPDATE users SET username = 'Alice', status = 'active' WHERE id = ?;
5. 动态 SQL 的最佳实践
- 合理使用动态标签：不要将过多逻辑放在 XML 文件中，复杂逻辑可以放在 Java 代码中处理。
- 避免 SQL 注入：使用 MyBatis 提供的参数占位符（
#{}）来避免拼接 SQL。 - 适当分解 SQL 语句：对于复杂的 SQL，可以拆分成多个小查询，减少 XML 文件的复杂度。
- 使用日志调试 SQL：开启 MyBatis 的日志功能，查看生成的 SQL 是否符合预期。
6. 结论
MyBatis 动态 SQL 提供了非常强大的功能，可以根据不同的业务需求生成灵活的 SQL 语句。通过 <if>、<choose>、<foreach> 等标签，我们可以在 XML 中轻松实现复杂的查询逻辑。在使用过程中，我们需要注意 SQL 的可读性和维护性，避免过多复杂逻辑堆积在 XML 文件中。
掌握 MyBatis 的动态 SQL，可以让你的代码更具弹性，适应不同的业务场景。希望这篇文章能帮助你更好地理解和使用 MyBatis 的动态 SQL 功能。
希望你喜欢这篇关于JMyBatis 动态 SQL 详解的博客文章！请各位点赞和收藏加关注一键三连吧。祝三连的帅哥美女们今年都能暴富。如果有更多问题，欢迎随时提问。
