解码Mybatis：深入解析XML解析与Annotation支持解码Mybatis：深入解析XML解析与Annotation支持

2024-02-17 00:35:25

SEO关键词：

前文对Mybatis的基本知识和架构做了一番梳理。本文我们正式开启Mybatis的源码解析。

XML的解析

Mybatis支持两种不同的映射方式：XML和注解。XML映射是Mybatis最传统的映射方式，也是最常用的方式。

XML映射的解析过程大致可以分为以下几个步骤：

解析XML文件，生成DOM树。
遍历DOM树，将节点信息解析成Java对象。
将Java对象存储在Configuration对象中。

    public void parse(InputStream inputStream) throws IOException, XMLException {
        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
        // 忽略注释
        factory.setIgnoringComments(true);
        // 禁止DTD校验
        factory.setValidating(false);
        DocumentBuilder builder = factory.newDocumentBuilder();
        Document document = builder.parse(inputStream);
        // 解析配置
        configuration.setVariables(parseVariables(document.getElementsByTagName("variable")));
        configuration.setTypeAliases(parseTypeAliases(document.getElementsByTagName("typeAlias")));
        configuration.setMappers(parseMappers(document.getElementsByTagName("mapper")));
    }

Annotation的支持

Mybatis从3.2版本开始支持注解映射。注解映射是一种更简洁、更现代的映射方式。

注解映射的实现原理与XML映射基本相同，也是通过解析器将注解信息解析成Java对象，然后存储在Configuration对象中。

    public void parse(Class<?> mapperInterface, Class<?> pojoClass) {
        if (!mapperInterface.isInterface()) {
            throw new PersistenceException("The mapper interface must be an interface.");
        }
        this.mapperInterface = mapperInterface;
        this.pojoClass = pojoClass;
        this.resource = mapperInterface.getName();
        Method[] methods = mapperInterface.getMethods();
        for (Method method : methods) {
            // 跳过Object方法
            if (method.getDeclaringClass() == Object.class) {
                continue;
            }
            try {
                // 解析方法上的注解
                parseStatement(method);
            } catch (Exception e) {
                throw new PersistenceException("Error parsing statement.  Cause: " + e, e);
            }
        }
    }