手写MyBatis第89弹：动态SQL解析与执行时机深度剖析

深入解析MyBatis动态SQL：从XML解析到执行时机的设计哲学

「手写MyBatis框架核心：动态SQL解析与执行时机深度剖析」

在现代Java持久层框架中，动态SQL是一个至关重要的特性，它允许开发者根据运行时条件构建灵活的SQL语句。本文将深入探讨MyBatis框架中动态SQL的实现原理，重点分析XML配置解析、SqlNode树构建以及不同SqlSource的执行时机差异。
🥂(❁´◡`❁)您的点赞👍➕评论📝➕收藏⭐是作者创作的最大动力🤞

💖📕🎉🔥 支持我：点赞👍+收藏⭐️+留言📝欢迎留言讨论

🔥🔥🔥（源码 + 调试运行 + 问题答疑）

🔥🔥🔥 有兴趣可以联系我。文末有免费源码

免费获取源码。

更多内容敬请期待。如有需要可以联系作者免费送

更多源码定制，项目修改，项目二开可以联系作者

点击可以进行搜索(每人免费送一套代码)：千套源码目录（点我）

2025元旦源码免费送（点我）

我们常常在当下感到时间慢，觉得未来遥远，但一旦回头看，时间已经悄然流逝。对于未来，尽管如此，也应该保持一种从容的态度，相信未来仍有许多可能性等待着我们。

动态SQL解析的架构设计

XML配置解析的核心机制

MyBatis框架通过XMLMapperParser类负责解析Mapper XML文件中的SQL语句。当解析器遇到<select>、<insert>、<update>或<delete>等SQL节点时，需要判断其内容是否包含动态SQL标签。

 public class XMLMapperParser {
     private void buildStatementFromContext(List<XNode> list) {
         for (XNode context : list) {
             final XMLStatementBuilder statementParser = 
                 new XMLStatementBuilder(configuration, builderAssistant, context, requiredDatabaseId);
             statementParser.parseStatementNode();
         }
     }
 }

解析过程中的关键决策点在于识别SQL文本中是否包含动态标签（如<if>、<where>、<foreach>等）。这一判断直接影响后续SQL处理流程的选择：

• 静态SQL：不包含任何动态标签的SQL语句

• 动态SQL：包含至少一个动态标签的SQL语句

SqlNode树的构建过程

动态SQL解析的核心是构建SqlNode树，这是一种组合设计模式的典型应用。每个动态SQL标签都对应一个特定的SqlNode实现：

• IfSqlNode：处理<if test="...">条件判断

• WhereSqlNode：处理<where>标签，智能添加WHERE关键字和处理AND/OR前缀

• ForEachSqlNode：处理<foreach>循环标签

• TextSqlNode：处理普通SQL文本片段

 public interface SqlNode {
     boolean apply(DynamicContext context);
 }

解析器会递归遍历XML节点树，为每个动态标签创建对应的SqlNode对象，最终形成一棵完整的SqlNode树。这棵树的根节点将作为DynamicSqlSource的输入。

SqlSource的二元世界

RawSqlSource：静态SQL的优化处理

RawSqlSource专门处理不包含动态标签的静态SQL语句。它的关键特性在于提前解析：

 public class RawSqlSource implements SqlSource {
     private final SqlSource sqlSource;
     
     public RawSqlSource(Configuration configuration, String sql, Class<?> parameterType) {
         SqlSourceBuilder sqlSourceParser = new SqlSourceBuilder(configuration);
         this.sqlSource = sqlSourceParser.parse(sql, parameterType, new HashMap<>());
     }
     
     @Override
     public BoundSql getBoundSql(Object parameterObject) {
         return sqlSource.getBoundSql(parameterObject);
     }
 }

为什么RawSqlSource可以提前解析？

这是因为静态SQL在应用启动时就已经完全确定，不依赖于运行时参数。SqlSourceParser在初始化阶段就能够完成以下工作：

1. 参数占位符解析 ：将#{}占位符转换为?

2. 参数映射构建 ：创建ParameterMapping对象，记录参数名称、类型处理器等信息

3. SQL标准化：生成标准的、可被JDBC直接执行的SQL语句

这种提前解析带来了显著的性能优势：在每次SQL执行时，RawSqlSource只需简单返回预解析的BoundSql对象，无需重复解析过程。

DynamicSqlSource：动态SQL的运行时处理

与RawSqlSource相反，DynamicSqlSource处理包含动态标签的SQL语句，其解析过程被延迟到实际执行时：

 public class DynamicSqlSource implements SqlSource {
     private final Configuration configuration;
     private final SqlNode rootSqlNode;
     
     public DynamicSqlSource(Configuration configuration, SqlNode rootSqlNode) {
         this.configuration = configuration;
         this.rootSqlNode = rootSqlNode;
     }
     
     @Override
     public BoundSql getBoundSql(Object parameterObject) {
         DynamicContext context = new DynamicContext(configuration, parameterObject);
         rootSqlNode.apply(context);
         
         SqlSourceBuilder sqlSourceParser = new SqlSourceBuilder(configuration);
         Class<?> parameterType = parameterObject == null ? Object.class : parameterObject.getClass();
         SqlSource sqlSource = sqlSourceParser.parse(context.getSql(), parameterType, context.getBindings());
         
         return sqlSource.getBoundSql(parameterObject);
     }
 }

DynamicSqlSource的执行流程：

1. 创建动态上下文 ：DynamicContext用于收集最终SQL片段和参数绑定信息

2. 应用SqlNode树 ：递归调用rootSqlNode.apply(context)，根据运行时参数动态生成SQL文本

3. 解析生成BoundSql ：使用SqlSourceParser对动态生成的SQL进行最终解析

4. 返回可执行对象 ：生成包含完整SQL和参数映射的BoundSql对象

设计哲学：执行时机的权衡

性能与灵活性的平衡

RawSqlSource和DynamicSqlSource的不同设计体现了软件工程中经典的空间换时间权衡：

• RawSqlSource：在启动时消耗资源进行解析，换取运行时的高性能

• DynamicSqlSource：将解析延迟到运行时，牺牲部分性能换取最大的灵活性

实际应用中的决策因素

在实际框架设计中，选择哪种SqlSource的依据主要包括：

1. SQL复杂度 ：简单静态SQL适合RawSqlSource，复杂条件查询需要DynamicSqlSource

2. 性能要求 ：高并发场景应优先考虑RawSqlSource

3. 维护性：动态SQL虽然灵活，但调试和维护相对复杂

框架集成策略

MappedStatement的创建过程

在创建MappedStatement时，框架需要根据SQL内容智能选择正确的SqlSource实现：

public class XMLStatementBuilder {
     public void parseStatementNode() {
         String sql = context.getSql();
         SqlSource sqlSource;
         
         // 判断是否为动态SQL
         if (isDynamicSQL(sql)) {
             // 解析动态SQL标签，构建SqlNode树
             SqlNode rootSqlNode = parseDynamicTags(context);
             sqlSource = new DynamicSqlSource(configuration, rootSqlNode);
         } else {
             // 静态SQL直接创建RawSqlSource
             sqlSource = new RawSqlSource(configuration, sql, parameterTypeClass);
         }
         
         builderAssistant.addMappedStatement(/* ... */, sqlSource, /* ... */);
     }
     
     private boolean isDynamicSQL(String sql) {
         // 检查是否包含动态标签特征
         return sql.contains("<") && sql.contains(">");
     }
 }

扩展性与可维护性考虑

这种设计具有良好的扩展性：

1. 新的动态标签支持 ：只需实现新的SqlNode并扩展解析逻辑

2. 自定义SqlSource ：可以创建特殊用途的SqlSource实现

3. 优化策略：可以根据SQL模式自动选择最优的解析策略

总结

MyBatis动态SQL的设计体现了框架设计中的多个重要原则：关注点分离、策略模式和延迟决策。通过RawSqlSource和DynamicSqlSource的二元设计，MyBatis在保持灵活性的同时优化了性能表现。

理解这一设计不仅有助于更好地使用MyBatis框架，也为开发者设计自己的解析和执行引擎提供了宝贵参考。在实际项目开发中，应根据具体场景合理选择静态和动态SQL，在开发效率和运行时性能之间找到最佳平衡点。

🥂(❁´◡`❁)您的点赞👍➕评论📝➕收藏⭐是作者创作的最大动力🤞

💖📕🎉🔥 支持我：点赞👍+收藏⭐️+留言📝欢迎留言讨论

🔥🔥🔥（源码 + 调试运行 + 问题答疑）

🔥🔥🔥 有兴趣可以联系我。文末有免费源码

💖学习知识需费心，
📕整理归纳更费神。
🎉源码免费人人喜，
🔥码农福利等你领！

💖常来我家多看看，
📕网址：扣棣编程** ，
🎉感谢支持常陪伴，
🔥点赞关注别忘记！**

💖山高路远坑又深，
📕大军纵横任驰奔，
🎉谁敢横刀立马行？
🔥唯有点赞+关注成！

往期文章推荐：

基于Springboot + vue实现的学生宿舍信息管理系统
免费获取宠物商城源码--SpringBoot+Vue宠物商城网站系统
【2025小年源码免费送】

⬇⬇⬇⬇⬇⬇⬇⬇⬇⬇点击此处获取源码⬇⬇⬇⬇⬇⬇⬇⬇⬇