冰糖心书房
冰糖心书房

MyBatis XMLMapperBuilder 是如何将 SQL 语句解析成可执行的对象？ 如何将结果映射规则解析成对应的处理器？

1. XMLMapperBuilder 如何将 SQL 语句解析成可执行对象 (MappedStatement):

XMLMapperBuilder 解析 , , , 元素体内的 SQL 语句文本。 SQL 语句文本可能包含：

  • 静态 SQL: 普通的 SQL 语句，不包含任何动态 SQL 标签或占位符。
  • 动态 SQL: 包含 MyBatis 的动态 SQL 标签 (例如 , , , , , , ${}, #{} 等)。
  • 参数占位符: #{} 和 ${} 占位符，用于在运行时动态地替换参数值。

XMLMapperBuilder 会根据 SQL 语句文本的类型，创建不同的 SqlSource 对象来表示 SQL 语句的来源和处理方式。 SqlSource 接口是 MyBatis 中表示 SQL 语句来源的抽象接口，它有以下几种实现类：

  • RawSqlSource: 用于表示 静态 SQL。 对于静态 SQL，SQL 语句文本在解析时就已经确定，运行时无需动态构建。
  • DynamicSqlSource: 用于表示 动态 SQL。 对于动态 SQL，SQL 语句文本在运行时需要根据参数值进行动态构建。 DynamicSqlSource 会负责解析和处理动态 SQL 标签，并生成最终的可执行 SQL 语句。
  • ProviderSqlSource: 用于表示 基于 Provider 类的 SQL。 SQL 语句不是直接写在 XML 文件中，而是通过一个 Java Provider 类动态生成。

XMLMapperBuilder 会根据 SQL 语句是否包含动态 SQL 标签来判断创建 RawSqlSource 还是 DynamicSqlSource。 如果 SQL 语句中使用了动态 SQL 标签，则创建 DynamicSqlSource，否则创建 RawSqlSource。 如果是基于 Provider 类的 SQL，则创建 ProviderSqlSource。

示例代码 (简化版，展示 XMLMapperBuilder 如何创建 SqlSource):

// 假设 XMLMapperBuilder 解析  元素的 XNode 对象
String sqlText = selectNode.getStringBody(); // 获取 , , ,  元素的 parameterMap 属性引用外部定义的  元素。 XMLMapperBuilder 会解析  元素及其子元素 ，构建 ParameterMap 对象，并将其关联到 MappedStatement。 parameterMap 方式已经过时，不推荐使用。 
     
  • 内联参数映射 (#{} 和 ${}): 在 SQL 语句文本中直接使用 #{} 和 ${} 占位符进行参数映射。 这是 现代 MyBatis 开发中推荐使用的参数映射方式。 XMLMapperBuilder 会解析 SQL 语句文本中的 #{} 和 ${} 占位符，并提取占位符中的参数属性名、jdbcType、typeHandler 等信息。
    •  
     
    XMLMapperBuilder 会将解析得到的参数映射信息 存储到 MappedStatement 对象中，以便在运行时进行参数绑定。
      
   
  •  
    1.3. 解析结果映射 (ResultMap 和 resultType):
     
    XMLMapperBuilder 会解析  元素的 resultMap 属性引用外部定义的  元素。 XMLMapperBuilder 会解析  元素及其子元素 (, , , , ), 构建 ResultMap 对象，并将其关联到 MappedStatement。 resultMap 方式适用于复杂的结果集映射场景 (例如关联查询、集合属性、多态映射等)。
    •  
     
  • resultType 属性: 通过  元素配置的 resultMap 或 resultType 属性， 创建 ResultMap 对象 (如果使用 resultMap) 或记录 resultType，并将结果映射信息存储到 MappedStatement 对象中，以便在运行时进行结果集映射。
     
    •  
   
  •  
    1.4. 构建 MappedStatement 对象:
     
    XMLMapperBuilder 在完成 SQL 语句文本 (SqlSource)、参数映射和结果映射的解析后，会将这些信息，以及