【12.MyBatis源码剖析与架构实战】15.1 if和where标签执⾏过程剖析-初始化时

在 MyBatis 中，<if>和<where>标签在初始化阶段被解析为IfSqlNode和WhereSqlNode对象，并纳入语法树。下面将从入口调用、NodeHandler 注册机制、标签处理逻辑三个层面，结合底层源码和流程图进行剖析。

一、初始化阶段入口：从 XMLScriptBuilder 开始

MyBatis 启动时通过XMLScriptBuilder.parseDynamicTags()方法解析 SQL 节点。该方法接收一个 XNode 参数（代表整个<select>、<insert>等 SQL 语句节点），遍历其所有子节点，将文本节点和元素节点分别转换为对应的 SqlNode 对象，存入List<SqlNode>集合中，最终包装为MixedSqlNode作为语法树的根节点。

核心判断逻辑如下：

• 文本节点：直接封装为StaticTextSqlNode（静态文本）或TextSqlNode（含${}的动态文本）。
• 元素节点：通过节点名称（如if、where、foreach）从nodeHandlerMap中获取对应的NodeHandler处理，一旦遇到任何元素节点，就标记isDynamic = true，最终创建DynamicSqlSource。

二、NodeHandler 注册机制

XMLScriptBuilder在构造时会调用initNodeHandlerMap()方法，将所有动态标签与对应的NodeHandler实现类进行映射绑定：

// XMLScriptBuilder.initNodeHandlerMap()Map<String,NodeHandler>map=newHashMap<>();map.put("trim",newTrimHandler());map.put("where",newWhereHandler());map.put("set",newSetHandler());map.put("foreach",newForEachHandler());map.put("if",newIfHandler());map.put("choose",newChooseHandler());// ...

当解析到where节点时，nodeHandlerMap.get("where")返回WhereHandler；解析到if节点时，返回IfHandler。这种设计使得新增动态标签只需增加一个NodeHandler实现并注册即可，符合开闭原则。

三、WhereHandler：解析 标签

WhereHandler是XMLScriptBuilder的内部类，负责处理<where>标签：

privateclassWhereHandlerimplementsNodeHandler{publicWhereHandler(){}@OverridepublicvoidhandleNode(XNodenodeToHandle,List<SqlNode>targetContents){// 1. 递归解析 <where> 节点内部的子内容，生成 MixedSqlNodeMixedSqlNodemixedSqlNode=parseDynamicTags(nodeToHandle);// 2. 创建 WhereSqlNode，将 mixedSqlNode 作为其内部 contentsWhereSqlNodewhere=newWhereSqlNode(configuration,mixedSqlNode);// 3. 将 WhereSqlNode 添加到父级 contents 列表中targetContents.add(where);}}

核心流程：

1. 递归解析：调用parseDynamicTags(nodeToHandle)解析<where>标签内部的 SQL 片段（如<if>标签和静态文本），生成一个MixedSqlNode。
2. 构建 WhereSqlNode：将MixedSqlNode作为构造参数传入WhereSqlNode。WhereSqlNode本质上是TrimSqlNode的子类，预设了前缀"WHERE"以及需要覆盖的前缀列表AND |OR。
3. 挂载到父级：将创建好的WhereSqlNode添加到targetContents中，成为语法树的一部分。

四、IfHandler：解析 标签

IfHandler同样定义在XMLScriptBuilder内部，负责处理<if test="...">标签：

privateclassIfHandlerimplementsNodeHandler{@OverridepublicvoidhandleNode(XNodenodeToHandle,List<SqlNode>targetContents){// 1. 递归解析 <if> 节点内部的子内容，生成 MixedSqlNodeMixedSqlNodemixedSqlNode=parseDynamicTags(nodeToHandle);// 2. 获取 test 属性值Stringtest=nodeToHandle.getStringAttribute("test");// 3. 创建 IfSqlNodeIfSqlNodeifSqlNode=newIfSqlNode(mixedSqlNode,test);// 4. 将 IfSqlNode 添加到父级 contents 列表中targetContents.add(ifSqlNode);}}

核心流程：

1. 递归解析：同样调用parseDynamicTags(nodeToHandle)解析<if>内部的 SQL 片段，生成MixedSqlNode。
2. 获取条件表达式：从 XML 节点中读取test属性值（OGNL 表达式），用于运行时条件判断。
3. 构建 IfSqlNode：将解析得到的MixedSqlNode和test表达式传入构造器。IfSqlNode在运行时通过ExpressionEvaluator对test表达式求值，决定是否将内部 SQL 片段拼接到最终 SQL 中。
4. 挂载到父级：将IfSqlNode添加到父级contents列表中。

五、完整解析流程 UML 流程图