Mybatis—SqlNode

  SqlNode的主要职责就是描述Mapper文件中配置的SQL信息，在Mybatis源代码中随处都能看见其身影，可见SqlNode地位是相当高的。SqlNode接口只定义了一个apply方法，且该方法只有一个DynamicContext对象作为入参。DynamicContext对象中不仅封装了Mapper调用时传入的参数信息，还提供了MyBatis内置的_parameter和_databaseId参数。

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

  现如今SqlNode的实现类差不多有十个左右，且每个实现类的职责都很明确，最终有MixedSqlNode实现类将所有SqlNode实现串起来执行，可以理解为一个责任链设计模式。

  从UML图可以看出IfSqlNode、ChooseSqlNode、ForEachSqlNode、MixedSqlNode、TrimSqlNode、StaticTextSqlNode、VarDeclSqlNode和TextSqlNode直接实现自SqlNode接口，SetSqlNode和WhereSqlNode则是继承自TrimSqlNode类。各实现类的职责，

• IfSqlNode，描述XML或者注解中带有标签的内容，XMLLanguageDriver在解析Mapper SQL配置信息时，会将XML或者注解中的标签进行解析，然后将其转换为IfSqlNode对象。
• ChooseSqlNode，描述XML或者注解中带有标签的内容。
• ForEachSqlNode，描述XML或者注解中带有标签的内容。
• MixedSqlNode，将一组SqlNode对象进行串联执行，通常多个SqlNode对象才能联合表述一个SQL信息，所以就需要借助MixedSqlNode来将其进行串联，最终形成一个完整的SQL信息。
• WhereSqlNode，描述XML或者注解中的标签。
• TrimSqlNode，描述XML或者注解中的标签。
• StaticTextSqlNode，描述XML或者注解中不带有任何标签的配置信息，即静态文本内容。
• VarDeclSqlNode，描述XML或者注解中的标签。
• TextSqlNode，如果静态文本中包含$占位符，那么就说明${}中的内容需要在Mapper调用时，执行SQL语句前进行替换，此时就需要用TextSqlNode来描述。
• SetSqlNode，描述XML或者注解中的标签。

MixedSqlNode

  MixedSqlNode将一组SqlNode对象进行串联执行，MixedSqlNode提供的构造函数就需要传入一组SqlNode对象来表述一个动态SQL信息，然后apply方法就会遍历调用各SqlNode的apply方法来完成其逻辑执行。

public class MixedSqlNode implements SqlNode {
  private final List<SqlNode> contents;

  public MixedSqlNode(List<SqlNode> contents) {
    this.contents = contents;
  }

  @Override
  public boolean apply(DynamicContext context) {
    contents.forEach(node -> node.apply(context));
    return true;
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13