手写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 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在初始化阶段就能够完成以下工作：

参数占位符解析：将#{}占位符转换为?
参数映射构建：创建ParameterMapping对象，记录参数名称、类型处理器等信息
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的执行流程：

创建动态上下文：DynamicContext用于收集最终SQL片段和参数绑定信息
应用SqlNode树：递归调用rootSqlNode.apply(context)，根据运行时参数动态生成SQL文本
解析生成BoundSql：使用SqlSourceParser对动态生成的SQL进行最终解析
返回可执行对象：生成包含完整SQL和参数映射的BoundSql对象

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

性能与灵活性的平衡

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

RawSqlSource：在启动时消耗资源进行解析，换取运行时的高性能
DynamicSqlSource：将解析延迟到运行时，牺牲部分性能换取最大的灵活性

实际应用中的决策因素

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

SQL复杂度：简单静态SQL适合RawSqlSource，复杂条件查询需要DynamicSqlSource
性能要求：高并发场景应优先考虑RawSqlSource
维护性：动态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(">");
     }
 }

扩展性与可维护性考虑

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

新的动态标签支持：只需实现新的SqlNode并扩展解析逻辑
自定义SqlSource：可以创建特殊用途的SqlSource实现
优化策略：可以根据SQL模式自动选择最优的解析策略

总结

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

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

(❁´◡`❁)您的点赞➕评论➕收藏⭐是作者创作的最大动力
支持我：点赞+收藏⭐️+留言欢迎留言讨论
（源码 + 调试运行 + 问题答疑）
有兴趣可以联系我。文末有免费源码
学习知识需费心，
整理归纳更费神。
源码免费人人喜，
码农福利等你领！
常来我家多看看，
网址：扣棣编程，
感谢支持常陪伴，
点赞关注别忘记！
山高路远坑又深，
大军纵横任驰奔，
谁敢横刀立马行？
唯有点赞+关注成！

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

posted on 2025-10-04 14:27 ycfenxi 阅读(8) 评论(0) 收藏举报