MyBatis整合Spring的实现（3）

分析

MyBatis整合Spring的实现（2）中属性能够知道，XPathParser类在XMLConfigBuilder中充当了很是重要的角色，下面就来分析XPathParser的做用。

1 属性

1.1 XPathParser属性：

/** 整个XML文档 */
private Document document;
/** 是否已验证，true:是，false:否 */
private boolean validation;
/** 用于解析实体的基本接口 */
private EntityResolver entityResolver;
/** 属性 */
private Properties variables;
/** XPath提供了对XPath计算环境和表达式的访问 */
private XPath xpath;

2 构造器

XPathParser实例化的构造器为：

3 方法

根据构造器能够看出，通过2个方法，最后生成了Document。

3.1 commonConstructor

方法中只是把属性放入相应的值。

3.2 createDocument方法

private Document createDocument(InputSource inputSource) {
    // important: this must only be called AFTER common constructor
    try {
      DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
      factory.setValidating(validation);
      factory.setNamespaceAware(false);
      factory.setIgnoringComments(true);
      factory.setIgnoringElementContentWhitespace(false);
      factory.setCoalescing(false);
      factory.setExpandEntityReferences(true);
      DocumentBuilder builder = factory.newDocumentBuilder();
      builder.setEntityResolver(entityResolver);
      builder.setErrorHandler(new ErrorHandler() {
        public void error(SAXParseException exception) throws SAXException {
          throw exception;
        }
        public void fatalError(SAXParseException exception) throws SAXException {
          throw exception;
        }
        public void warning(SAXParseException exception) throws SAXException {
        }
      });
      return builder.parse(inputSource);
    } catch (Exception e) {
      throw new BuilderException("Error creating document instance.  Cause: " + e, e);
    }
}

这里就是JDK底层提供的建立一个Document，这里须要本身去查看JDK API，不在过多的分析。

4 MyBatis配置解析（XMLMapperEntityResolver）

上面只是看到代码解析成Document文档，可是MyBatis是如何找到本身的文档的呢？下面就来分析。

MyBatis整合Spring的实现（2）中2.1已经提到“默认DTD文件解析类(XMLMapperEntityResolver)“。那么就看这里代码如何。

图中红框中发现了，MyBatis配置的全局配置文件定义。

4.1 XMLMapperEntityResolver的接口EntityResolver

EntityResolver用于解析实体的基本接口。只提供了一个方法resolveEntity，且子类必须实现。

4.2 resolveEntity方法

代码先根据publicId获取InputSource，若是没有，在根据systemId获取InputSource。

总结：

通过3章的分析，了解Mybatis若是对全局配置文件进行读取并生成Document。以上的类中已经不少能够公用的，好比XPathParser类，没有具体的逻辑代码，只是一个XML到Document的转换，因此后面分析的Mybatis对SQL配置的解析也使用了此类。本文4中XMLMapperEntityResolver类也已经把SQL的Mapper文件考虑进去。