MyBatis 史诗级的裹脚布可以烧了！！！

作为一名 Java 开发者，你一定经历过被 MyBatis XML 支配的恐惧。

当你打开一个UserMapper.xml，迎面而来的是几百行甚至上千行的,,,标签。原本清爽的 SQL 语句被这些 XML 标签切割得支离破碎，仿佛老太太的裹脚布——又臭又长。

如果你也受够了在 XML 标签里写逻辑，受够了为了一个简单的非空判断就要写三行 XML，那么请继续往下看。dbVisitor 的动态 SQL 规则机制，也许就是你一直在寻找的"剪刀"。

MyBatis 的 XML 地狱​

让我们先回顾一下，一个标准的、带有几个查询条件的 MyBatis SQL 是什么样子的：

    SELECT * FROM tb_user                        AND name = #{name}                            AND age = #{age}                            AND status = #{status}                            AND create_time >= #{createTime}            

这段代码的问题在哪里，已经不用多言！这种一坨一坨的开发体验看到就难受至极，更别提还要去维护它。

革命性的解法​

dbVisitor 作为一个新一代的数据库访问工具，最核心的设计理念之一就是：让 SQL 回归 SQL。

利用 dbVisitor 独创的规则机制，上面的 XML 代码可以精简为：

SELECT * FROM tb_user   @{and, name = :name}   @{and, age = :age}   @{and, status = :status}   @{and, create_time >= :createTime}

假设只传入参数name="Tom"，生成的 SQL 如下：

SELECT * FROM tb_user WHERE name = ?

是不是瞬间清爽了？没有了尖括号的视觉干扰，没有了冗余的 XML 闭合标签，只有纯粹的 SQL 逻辑。

你可能会问：@{and, ...}到底做了什么？它是简单的字符串拼接吗？

当然不是！dbVisitor 的规则引擎是非常智能的。以@{and, name = :name}为例，它内置了以下逻辑：

1. 智能判空：引擎会自动检查key = :key表达式中的参数。如果参数:key为null，整个@{and}规则块会被自动忽略，不会生成任何 SQL（注意：空字符串""被视为有效值，不会忽略）。

2. WHERE 处理：如果内容不为空，@{and}会识别它是否是 WHERE 子句的开头。如果是开头（例如前面没有1=1），它会自动抹去AND，直接生成WHERE name = ?（这一点类似 MyBatis 的标签，但更加隐形）。

这一切都是自动发生的，你只需要声明规则，剩下的交给 dbVisitor。

条件判断本该如此性感​

MyBatis 中 90% 的标签都是为了做两件事：

1. 参数不为空时，追加查询条件。

2. 开关开启时，追加查询条件。

dbVisitor 将这两类高频场景直接内化为最基础的规则，无需任何复杂的标签嵌套。

1. 智能补全

自动检查条件状态选择是否需要自动补全WHERE/AND/OR关键字。

-- 唯一条件下，自动补全 WHERESELECT * FROM tb_user     @{and, name = :name}-- 多组条件中，自动追加 ANDSELECT * FROM tb_user where type = 'employee'    @{and, name = :name} -- 生成 and name = ?

2. 智能判空：@{and}/@{or}

这是你最常用的规则。它们会自动检查参数是否为null。

SELECT * FROM tb_user    @{and, name = :name}    -- 仅当 name 不为空时生成 and name = ?    @{or,  age > :age}      -- 仅当 age 不为空时生成  or  age > ?

3. 开关控制：@{ifand}/@{ifor}

当你需要用布尔值来控制 SQL 时，使用@{ifand}或@{ifor}。

-- 只有当 showAll 为 false 时，才拼接入 AND is_delete = 0SELECT * FROM tb_user @{ifand, !showAll, is_delete = 0}

对比 MyBatis 的臃肿写法以及像老鼠屎一样无处不在的1=1

SELECT * FROM tb_user WHERE 1=1    AND is_delete = 0

仅仅是一个简单的条件，dbVisitor 让你少写了 3 行代码，减少无用的条件判断，这就是效率。

一行代码的 IN 查询​

MyBatis 的标签简直是反人类设计：collection, item, open, close... 配置项多达七八个。 而且为了防止集合为空导致 SQL 语法错误，通常还得在外面套一层，简直令人窒息：

SELECT * FROM tb_user WHERE 1=1    AND id IN          #{id}    

而在 dbVisitor 中，利用@{ifand}和@{in}两个规则的嵌套使用，你只需要一行：

-- ifand 接受 OGNL 表达式，!idList.isEmpty 确保集合有值时才生成 SQLSELECT * FROM tb_user @{ifand, !idList.isEmpty, id IN @{in, :idList}}

对比一下，这代节省的可不是一点点，而是降维打击！

忘掉 ：忘掉逗号​

在写 Update 语句时，处理末尾的逗号是最烦人的。dbVisitor 的@{set}规则完美解决，引擎会自动处理字段间的逗号：

UPDATE tb_userSET    @{set, name  = :name}    @{set, age   = :age}    @{set, email = :email}WHERE id = #{id}

MyBatis 用了一个标签来解决这个问题：

UPDATE tb_user    name = #{name},    age = #{age},    email = #{email},WHERE id = #{id}

⚠️ 虽然@{set}规则很强大，但规则的判断是依赖已经生成的 SQL 进行推断。

当规则没有匹配时，一些意外情况

UPDATE tb_user SET    @{set, name = :name},  -- ❌ 规则无法删除身后的逗号    fixed_col = 123,          @{set, email = :email} -- ❌ 规则虽然不会添加新的逗号但也不会删除上一个条件中的逗号WHERE id = :id-- 正确的写法是UPDATE tb_user SET    fixed_col = 123        -- 先写固定列，再写动态列    @{set, name = :name}   -- 规则会自动处理前置逗号    @{set, email = :email}WHERE id = :id

分支判断的救星​

MyBatis 的--结构冗长得令人发指，写起来仿佛在填表。 最大的麻烦在于即便是使用@Select注解仍然逃脱不了 XML 的魔咒

SELECT * FROM t_blog WHERE 1 = 1            AND title = #{title}                AND content = #{content}                AND owner = "defaultOwner"    

@Select({""})List queryBlogs(@Param("title") String title,                      @Param("content") String content);

dbVisitor 让你用 SQL 的思维写 SQL，更符合编程直觉。同样的场景，dbVisitor 只需要这样：

CASE 规则 IF-ELSE 模式

SELECT * FROM t_blog@{and, @{case, , @{when, title != null,   title = #{title}},                 @{when, content != null, content = #{content}},                 @{else,                  owner = "defaultOwner"}        }}

换一个例子：根据 encryptMode 的值选择加密方式

CASE 规则 Switch 模式

SELECT * FROM tb_user@{and, @{case, encryptMode, @{when, true, password = @{md5, :pwd}},                            @{else,       password = :pwd}        }}

像乐高积木一样组合​

规则引擎最强大的地方在于其可组合性。所有规则都可以像乐高积木一样嵌套使用。这意味着你可以用@{case}的结果去驱动@{and}，或者在@{else}里再写一组@{if}。

比如一个常见的权限控制场景：

• 如果是管理员 (ADMIN)，查询所有数据；

• 如果是部门经理 (MGR)，查询本部门数据；

• 如果是普通员工，只能查自己的数据。

SELECT * FROM tb_report@{and, @{case, role, @{when, 'ADMIN', /* 不加限制 */},                     @{when, 'MGR',   dept_id = :deptId},                     @{else,          user_id = :userId}       }}

注意看，外层的@{and}会自动处理连接词：

• 当role是 'ADMIN' 时，@{case}输出空，整个@{and}消失。

  • 生成SELECT * FROM tb_report WHERE 1=1。

• 当role是 'MGR' 时，内部输出dept_id = ?，外层自动加上AND。

  • 生成... WHERE 1=1 AND dept_id = ?。

这种自然的嵌套组合，让你能用 SQL 结构直接表达复杂的业务逻辑，而不是在 Java 代码和 XML 之间反复横跳。

这就结束了？​

规则的强大之处在于无处不在。你不需要为了使用动态 SQL 而强迫自己切换开发模式。无论你身处哪个层级，dbVisitor 的动态规则都能无缝集成。

1. 在 编程式 API (JdbcTemplate) 中使用

不需要 StringBuilder，不需要拼接字符串。

// 直接在 SQL 字符串中使用规则jdbcTemplate.queryForList("SELECT * FROM users @{and, name = :name}", args);

2. 在 声明式 API (注解) 中使用

彻底摆脱@Script或者