SqlNode的主要职责就是描述Mapper文件中配置的SQL信息,在Mybatis源代码中随处都能看见其身影,可见SqlNode地位是相当高的。SqlNode接口只定义了一个apply方法,且该方法只有一个DynamicContext对象作为入参。DynamicContext对象中不仅封装了Mapper调用时传入的参数信息,还提供了MyBatis内置的_parameter和_databaseId参数。
public interface SqlNode {
boolean apply(DynamicContext context);
}
现如今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;
}
}