组合模式与动态SQL的完美结合在软件设计模式中组合模式Composite Pattern是一种将对象组合成树形结构以表示部分-整体层次结构的设计模式。MyBatis动态SQL的实现正是组合模式的经典应用而MixedSqlNode作为这个模式中的组合对象扮演着至关重要的角色。组合模式在MyBatis中的体现组合模式的核心思想是让客户端能够以统一的方式处理单个对象和对象组合。在MyBatis动态SQL的上下文中这意味着叶子节点如StaticTextSqlNode、IfSqlNode等代表最基本的SQL片段组合节点如MixedSqlNode可以包含其他叶子节点或组合节点统一接口所有节点都实现SqlNode接口提供统一的apply方法这种设计使得复杂的SQL生成逻辑能够通过简单的递归调用来实现极大地简化了系统架构。目录MixedSqlNode动态SQL的骨架核心实现原理在动态SQL解析中的角色组合模式带来的架构优势1. 无限嵌套能力2. 统一的处理接口3. 灵活的可扩展性实际应用中的解析过程XML到SqlNode树的转换解析策略模式性能优化考虑1. 避免过度嵌套2. 提前终止评估设计模式的最佳实践启示1. 接口设计的简洁性2. 上下文对象的精心设计3. 递归思想的巧妙应用总结(❁´◡❁)您的点赞➕评论➕收藏⭐是作者创作的最大动力 支持我点赞收藏⭐️留言欢迎留言讨论我们常常在当下感到时间慢觉得未来遥远但一旦回头看时间已经悄然流逝。对于未来尽管如此也应该保持一种从容的态度相信未来仍有许多可能性等待着我们。MixedSqlNode动态SQL的骨架核心实现原理MixedSqlNode的实现看似简单却蕴含着深刻的设计智慧public class MixedSqlNode implements SqlNode { private final ListSqlNode contents; public MixedSqlNode(ListSqlNode contents) { this.contents contents; } Override public boolean apply(DynamicContext context) { for (SqlNode sqlNode : contents) { sqlNode.apply(context); } return true; } }设计要点分析透明的组合结构MixedSqlNode对外表现与单个SqlNode完全一致递归执行机制通过遍历子节点并递归调用apply方法实现整个SQL树的生成始终返回true由于组合节点包含多个子节点其执行结果通常为成功在动态SQL解析中的角色当MyBatis解析XML配置时遇到动态SQL标签如where、if等会递归地构建SqlNode树SQL映射文件 → XML解析器 → SqlNode树 → SQL生成在这个过程中MixedSqlNode作为容器承载了同一层级的所有SQL片段无论是静态文本还是动态条件。组合模式带来的架构优势1. 无限嵌套能力组合模式使得动态SQL支持任意深度的嵌套结构select idfindUsers SELECT * FROM users where if testdepartment ! null department_id #{department.id} if testdepartment.activeOnly AND status ACTIVE choose when testdepartment.includeSubDepts AND path LIKE CONCAT(#{department.path}, %) /when otherwise AND parent_id #{department.id} /otherwise /choose /if /if /where /select对应的SqlNode树结构呈现为MixedSqlNode (root) ├── StaticTextSqlNode (SELECT * FROM users) └── WhereSqlNode └── MixedSqlNode └── IfSqlNode (testdepartment ! null) └── MixedSqlNode ├── StaticTextSqlNode (department_id #{department.id}) └── IfSqlNode (testdepartment.activeOnly) └── MixedSqlNode ├── StaticTextSqlNode (AND status ACTIVE) └── ChooseSqlNode ├── WhenSqlNode (testdepartment.includeSubDepts) │ └── StaticTextSqlNode (AND path LIKE...) └── OtherwiseSqlNode └── StaticTextSqlNode (AND parent_id ...)2. 统一的处理接口由于所有节点都实现SqlNode接口客户端代码无需关心具体节点类型public class DynamicSqlSource implements SqlSource { private final SqlNode rootSqlNode; public BoundSql getBoundSql(Object parameterObject) { DynamicContext context new DynamicContext(parameterObject); rootSqlNode.apply(context); // 统一接口调用 // ... 后续处理 } }这种统一性大大降低了代码的复杂度和维护成本。3. 灵活的可扩展性新增SQL节点类型时只需实现SqlNode接口即可无缝集成到现有体系中public class CustomSqlNode implements SqlNode { Override public boolean apply(DynamicContext context) { // 自定义逻辑 return true; } }实际应用中的解析过程XML到SqlNode树的转换MyBatis通过XMLScriptBuilder类完成从XML配置到SqlNode树的转换public class XMLScriptBuilder { public SqlNode parseScriptNode() { ListSqlNode contents parseDynamicTags(context); if (contents.size() 1) { return contents.get(0); } else { return new MixedSqlNode(contents); } } private ListSqlNode parseDynamicTags(XNode node) { ListSqlNode contents new ArrayList(); NodeList children node.getNode().getChildNodes(); for (int i 0; i children.getLength(); i) { XNode child node.newXNode(children.item(i)); if (child.getNode().getNodeType() Node.TEXT_NODE) { String data child.getStringBody(); if (data ! null data.trim().length() 0) { contents.add(new StaticTextSqlNode(data)); } } else if (child.getNode().getNodeType() Node.ELEMENT_NODE) { String nodeName child.getNode().getNodeName(); SqlNodeHandler handler nodeHandlers.get(nodeName); if (handler ! null) { handler.handleNode(child, contents); } } } return contents; } }解析策略模式MyBatis采用策略模式来处理不同的动态SQL标签每个标签对应一个SqlNodeHandlerprivate void initNodeHandlerMap() { nodeHandlers.put(if, new IfHandler()); nodeHandlers.put(trim, new TrimHandler()); nodeHandlers.put(where, new WhereHandler()); nodeHandlers.put(set, new SetHandler()); nodeHandlers.put(foreach, new ForEachHandler()); nodeHandlers.put(choose, new ChooseHandler()); // ... 其他处理器 }性能优化考虑1. 避免过度嵌套虽然组合模式支持无限嵌套但实践中应避免过度复杂的嵌套结构!-- 不推荐过度嵌套 -- if testcondition1 if testcondition2 if testcondition3 choose !-- 更多嵌套 -- /choose /if /if /if !-- 推荐适度扁平化 -- if testcondition1 and condition2 and condition3 choose !-- 逻辑 -- /choose /if2. 提前终止评估某些SqlNode实现了短路逻辑可以在满足条件时提前终止评估public class ChooseSqlNode implements SqlNode { Override public boolean apply(DynamicContext context) { for (SqlNode sqlNode : ifSqlNodes) { if (sqlNode.apply(context)) { return true; // 提前返回 } } // ... 其他逻辑 } }设计模式的最佳实践启示1. 接口设计的简洁性SqlNode接口的简洁性是其成功的关键public interface SqlNode { boolean apply(DynamicContext context); }这种极简设计使得实现和理解都变得非常简单。2. 上下文对象的精心设计DynamicContext作为贯穿整个组合结构的上下文对象承载了状态信息和共享数据public class DynamicContext { private final StringBuilder sqlBuilder new StringBuilder(); private final MapString, Object bindings; public void appendSql(String sql) { sqlBuilder.append(sql).append( ); } public String getSql() { return sqlBuilder.toString().trim(); } }3. 递归思想的巧妙应用组合模式天然适合递归处理这种思想在SqlNode树的构建和执行中得到了完美体现// 构建时的递归 SqlNode buildSqlNode(XNode node) { ListSqlNode children buildChildren(node); return new MixedSqlNode(children); } // 执行时的递归 rootSqlNode.apply(context);总结MixedSqlNode作为MyBatis动态SQL实现中的组合对象虽然代码实现简单但其背后的设计思想却十分深刻。通过组合模式的应用MyBatis实现了结构清晰复杂的SQL生成逻辑被分解为简单的树形结构扩展灵活新增节点类型不影响现有架构维护简单统一的接口降低了理解和维护成本功能强大支持任意复杂的嵌套逻辑这种设计不仅适用于SQL生成场景对于其他需要处理层次化结构的业务场景也具有重要的参考价值。理解组合模式在MyBatis中的应用能够帮助我们在自己的项目中更好地进行架构设计构建出更加灵活、可维护的系统。(❁´◡❁)您的点赞➕评论➕收藏⭐是作者创作的最大动力 支持我点赞收藏⭐️留言欢迎留言讨论
组合模式与动态SQL的完美结合在软件设计模式中组合模式Composite Pattern是一种将对象组合成树形结构以表示部分-整体层次结构的设计模式。MyBatis动态SQL的实现正是组合模式的经典应用而MixedSqlNode作为这个模式中的组合对象扮演着至关重要的角色。组合模式在MyBatis中的体现组合模式的核心思想是让客户端能够以统一的方式处理单个对象和对象组合。在MyBatis动态SQL的上下文中这意味着叶子节点如StaticTextSqlNode、IfSqlNode等代表最基本的SQL片段组合节点如MixedSqlNode可以包含其他叶子节点或组合节点统一接口所有节点都实现SqlNode接口提供统一的apply方法这种设计使得复杂的SQL生成逻辑能够通过简单的递归调用来实现极大地简化了系统架构。目录MixedSqlNode动态SQL的骨架核心实现原理在动态SQL解析中的角色组合模式带来的架构优势1. 无限嵌套能力2. 统一的处理接口3. 灵活的可扩展性实际应用中的解析过程XML到SqlNode树的转换解析策略模式性能优化考虑1. 避免过度嵌套2. 提前终止评估设计模式的最佳实践启示1. 接口设计的简洁性2. 上下文对象的精心设计3. 递归思想的巧妙应用总结(❁´◡❁)您的点赞➕评论➕收藏⭐是作者创作的最大动力 支持我点赞收藏⭐️留言欢迎留言讨论我们常常在当下感到时间慢觉得未来遥远但一旦回头看时间已经悄然流逝。对于未来尽管如此也应该保持一种从容的态度相信未来仍有许多可能性等待着我们。MixedSqlNode动态SQL的骨架核心实现原理MixedSqlNode的实现看似简单却蕴含着深刻的设计智慧public class MixedSqlNode implements SqlNode { private final ListSqlNode contents; public MixedSqlNode(ListSqlNode contents) { this.contents contents; } Override public boolean apply(DynamicContext context) { for (SqlNode sqlNode : contents) { sqlNode.apply(context); } return true; } }设计要点分析透明的组合结构MixedSqlNode对外表现与单个SqlNode完全一致递归执行机制通过遍历子节点并递归调用apply方法实现整个SQL树的生成始终返回true由于组合节点包含多个子节点其执行结果通常为成功在动态SQL解析中的角色当MyBatis解析XML配置时遇到动态SQL标签如where、if等会递归地构建SqlNode树SQL映射文件 → XML解析器 → SqlNode树 → SQL生成在这个过程中MixedSqlNode作为容器承载了同一层级的所有SQL片段无论是静态文本还是动态条件。组合模式带来的架构优势1. 无限嵌套能力组合模式使得动态SQL支持任意深度的嵌套结构select idfindUsers SELECT * FROM users where if testdepartment ! null department_id #{department.id} if testdepartment.activeOnly AND status ACTIVE choose when testdepartment.includeSubDepts AND path LIKE CONCAT(#{department.path}, %) /when otherwise AND parent_id #{department.id} /otherwise /choose /if /if /where /select对应的SqlNode树结构呈现为MixedSqlNode (root) ├── StaticTextSqlNode (SELECT * FROM users) └── WhereSqlNode └── MixedSqlNode └── IfSqlNode (testdepartment ! null) └── MixedSqlNode ├── StaticTextSqlNode (department_id #{department.id}) └── IfSqlNode (testdepartment.activeOnly) └── MixedSqlNode ├── StaticTextSqlNode (AND status ACTIVE) └── ChooseSqlNode ├── WhenSqlNode (testdepartment.includeSubDepts) │ └── StaticTextSqlNode (AND path LIKE...) └── OtherwiseSqlNode └── StaticTextSqlNode (AND parent_id ...)2. 统一的处理接口由于所有节点都实现SqlNode接口客户端代码无需关心具体节点类型public class DynamicSqlSource implements SqlSource { private final SqlNode rootSqlNode; public BoundSql getBoundSql(Object parameterObject) { DynamicContext context new DynamicContext(parameterObject); rootSqlNode.apply(context); // 统一接口调用 // ... 后续处理 } }这种统一性大大降低了代码的复杂度和维护成本。3. 灵活的可扩展性新增SQL节点类型时只需实现SqlNode接口即可无缝集成到现有体系中public class CustomSqlNode implements SqlNode { Override public boolean apply(DynamicContext context) { // 自定义逻辑 return true; } }实际应用中的解析过程XML到SqlNode树的转换MyBatis通过XMLScriptBuilder类完成从XML配置到SqlNode树的转换public class XMLScriptBuilder { public SqlNode parseScriptNode() { ListSqlNode contents parseDynamicTags(context); if (contents.size() 1) { return contents.get(0); } else { return new MixedSqlNode(contents); } } private ListSqlNode parseDynamicTags(XNode node) { ListSqlNode contents new ArrayList(); NodeList children node.getNode().getChildNodes(); for (int i 0; i children.getLength(); i) { XNode child node.newXNode(children.item(i)); if (child.getNode().getNodeType() Node.TEXT_NODE) { String data child.getStringBody(); if (data ! null data.trim().length() 0) { contents.add(new StaticTextSqlNode(data)); } } else if (child.getNode().getNodeType() Node.ELEMENT_NODE) { String nodeName child.getNode().getNodeName(); SqlNodeHandler handler nodeHandlers.get(nodeName); if (handler ! null) { handler.handleNode(child, contents); } } } return contents; } }解析策略模式MyBatis采用策略模式来处理不同的动态SQL标签每个标签对应一个SqlNodeHandlerprivate void initNodeHandlerMap() { nodeHandlers.put(if, new IfHandler()); nodeHandlers.put(trim, new TrimHandler()); nodeHandlers.put(where, new WhereHandler()); nodeHandlers.put(set, new SetHandler()); nodeHandlers.put(foreach, new ForEachHandler()); nodeHandlers.put(choose, new ChooseHandler()); // ... 其他处理器 }性能优化考虑1. 避免过度嵌套虽然组合模式支持无限嵌套但实践中应避免过度复杂的嵌套结构!-- 不推荐过度嵌套 -- if testcondition1 if testcondition2 if testcondition3 choose !-- 更多嵌套 -- /choose /if /if /if !-- 推荐适度扁平化 -- if testcondition1 and condition2 and condition3 choose !-- 逻辑 -- /choose /if2. 提前终止评估某些SqlNode实现了短路逻辑可以在满足条件时提前终止评估public class ChooseSqlNode implements SqlNode { Override public boolean apply(DynamicContext context) { for (SqlNode sqlNode : ifSqlNodes) { if (sqlNode.apply(context)) { return true; // 提前返回 } } // ... 其他逻辑 } }设计模式的最佳实践启示1. 接口设计的简洁性SqlNode接口的简洁性是其成功的关键public interface SqlNode { boolean apply(DynamicContext context); }这种极简设计使得实现和理解都变得非常简单。2. 上下文对象的精心设计DynamicContext作为贯穿整个组合结构的上下文对象承载了状态信息和共享数据public class DynamicContext { private final StringBuilder sqlBuilder new StringBuilder(); private final MapString, Object bindings; public void appendSql(String sql) { sqlBuilder.append(sql).append( ); } public String getSql() { return sqlBuilder.toString().trim(); } }3. 递归思想的巧妙应用组合模式天然适合递归处理这种思想在SqlNode树的构建和执行中得到了完美体现// 构建时的递归 SqlNode buildSqlNode(XNode node) { ListSqlNode children buildChildren(node); return new MixedSqlNode(children); } // 执行时的递归 rootSqlNode.apply(context);总结MixedSqlNode作为MyBatis动态SQL实现中的组合对象虽然代码实现简单但其背后的设计思想却十分深刻。通过组合模式的应用MyBatis实现了结构清晰复杂的SQL生成逻辑被分解为简单的树形结构扩展灵活新增节点类型不影响现有架构维护简单统一的接口降低了理解和维护成本功能强大支持任意复杂的嵌套逻辑这种设计不仅适用于SQL生成场景对于其他需要处理层次化结构的业务场景也具有重要的参考价值。理解组合模式在MyBatis中的应用能够帮助我们在自己的项目中更好地进行架构设计构建出更加灵活、可维护的系统。(❁´◡❁)您的点赞➕评论➕收藏⭐是作者创作的最大动力 支持我点赞收藏⭐️留言欢迎留言讨论
