Java优学网MyBatis动态SQL教程：告别重复代码，轻松应对多变查询条件

想象一下这样的场景：你需要开发一个用户查询功能，查询条件可能包含用户名、手机号、注册时间等多个字段。用户在前端可能只填写其中一两个条件，也可能全部填写。如果用传统方式，你可能需要写多个相似的SQL语句来应对不同条件组合——这简直是一场噩梦。

MyBatis动态SQL就是为了解决这类问题而生的。它允许你在XML映射文件中编写灵活的SQL语句，根据传入参数的不同动态生成最终的SQL。就像搭积木一样，你可以把各种查询条件模块化，运行时再按需组合。

1.1 为什么需要动态SQL？

我曾在项目中遇到过这样的困扰：一个商品搜索功能需要支持十多个筛选条件。如果采用静态SQL，要么写几十个方法覆盖所有条件组合，要么在Java代码中拼接SQL字符串——前者代码冗余严重，后者容易引发SQL注入风险。

动态SQL的出现让这些问题迎刃而解。它让你能够： - 根据业务逻辑动态构建SQL语句 - 避免在Java代码中拼接SQL字符串 - 减少重复的SQL代码编写 - 提高代码的可维护性和安全性

实际开发中，几乎所有的查询功能都会遇到条件不确定的情况。动态SQL就像是给你的SQL语句装上了智能开关，需要哪个条件就打开哪个，不需要的就自动关闭。

1.2 动态SQL与传统SQL的区别是什么？

传统SQL是静态的、一成不变的。就像印刷好的表格，每个字段、每个条件都是固定的。而动态SQL更像是一张可填写的表格，你可以根据实际情况选择填写哪些内容。

举个例子来说： - 传统SQL：SELECT * FROM users WHERE name = ? AND age = ? - 动态SQL：可以根据传入参数决定是否添加name条件、age条件，或者两个都不添加

这种灵活性带来的改变是革命性的。我记得第一次使用动态SQL时，原本需要写十几个查询方法的功能，现在只需要一个方法就搞定了。代码量减少了70%，维护起来也轻松多了。

1.3 MyBatis动态SQL的核心优势有哪些？

开发效率的大幅提升是最直观的感受。你不用再为每个微小的条件变化编写新的SQL语句，也不用在Java代码中写那些丑陋的字符串拼接。

代码可读性的改善也很明显。所有SQL逻辑都集中在XML文件中，结构清晰，易于理解。新同事接手项目时，能很快理解业务逻辑和数据处理方式。

维护成本的降低同样重要。当业务需求变化时，你只需要修改对应的动态SQL片段，而不需要改动大量重复的代码。

从技术层面看，MyBatis动态SQL还提供了类型安全的参数处理，自动防止SQL注入攻击。这种设计既保证了灵活性，又不牺牲安全性。

动态SQL不是万能的，但在处理条件多变的查询场景时，它确实是最优雅的解决方案之一。随着我们深入后面的章节，你会更加体会到它的强大之处。

SELECT * FROM users 
WHERE 1=1
<if test="name != null and name != ''">
    AND name = #{name}
</if>
<if test="age != null">
    AND age = #{age}
</if>

SELECT * FROM products 
<where>
    <if test="brand != null">
        AND brand = #{brand}
    </if>
    <if test="minPrice != null">
        AND price >= #{minPrice}
    </if>
    <if test="maxPrice != null">
        AND price <= #{maxPrice}
    </if>
    <if test="category != null">
        AND category_id = #{category}
    </if>
</where>

SELECT * FROM orders WHERE status = #{status}

SELECT * FROM users WHERE id = #{userId}

SELECT * FROM products
<where>
    <if test="keyword != null and keyword != ''">
        AND (name LIKE CONCAT('%', #{keyword}, '%') 
             OR description LIKE CONCAT('%', #{keyword}, '%'))
    </if>
    <if test="categoryId != null">
        AND category_id = #{categoryId}
    </if>
    <if test="minPrice != null">
        AND price >= #{minPrice}
    </if>
    <if test="maxPrice != null">
        AND price <= #{maxPrice}
    </if>
    <if test="brandIds != null and brandIds.size() > 0">
        AND brand_id IN
        <foreach collection="brandIds" item="brandId" open="(" separator="," close=")">
            #{brandId}
        </foreach>
    </if>
</where>
ORDER BY 
    <choose>
        <when test="sortField == 'price'">price</when>
        <when test="sortField == 'sales'">sales_count</when>
        <otherwise>create_time</otherwise>
    </choose>
    <choose>
        <when test="sortOrder == 'desc'">DESC</when>
        <otherwise>ASC</otherwise>
    </choose>