mybatis源码解析(二)-加载过程

mybatis源码解析(一)-开篇
mybatis源码解析(二)-加载过程
mybatis源码解析(三)-SqlSession.selectOne类似方法调用过程
mybatis源码解析(四)-Mapper方法调用过程
mybatis源码解析(五)-mybatis如何实现的事务控制
mybatis源码解析(六)-配合spring-tx实现事务的原理
mybatis源码解析(七)-当mybatis一级缓存遇上spring

转载请标明出处:
http://blog.csdn.net/bingospunky/article/details/79197665
本文出自马彬彬的博客

mybatis加载过程概览

mybatis的加载过程,最重要的就是基于xml配置文件的加载,基于xml配置文件的加载过程主要由org.apache.ibatis.builder.xml.XMLConfigBuilder类来完成,主要代码如下:

Code 1
org.apache.ibatis.builder.xml.XMLConfigBuilder

    private void parseConfiguration(XNode root) {
        try {
            Properties settings = this.settingsAsPropertiess(root.evalNode("settings"));
            this.propertiesElement(root.evalNode("properties"));
            this.loadCustomVfs(settings);
            this.typeAliasesElement(root.evalNode("typeAliases"));
            this.pluginElement(root.evalNode("plugins"));
            this.objectFactoryElement(root.evalNode("objectFactory"));
            this.objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
            this.reflectionFactoryElement(root.evalNode("reflectionFactory"));
            this.settingsElement(settings);
            this.environmentsElement(root.evalNode("environments"));
            this.databaseIdProviderElement(root.evalNode("databaseIdProvider"));
            this.typeHandlerElement(root.evalNode("typeHandlers"));
            this.mapperElement(root.evalNode("mappers"));
        } catch (Exception var3) {
            throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + var3, var3);
        }
    }

上述代码针对mybatis xml主配置文件的内容一一做了解析处理。我们这里主要关注一下mybatis xxxMapper.xml相关的加载过程。

mybatis xxxMapper.xml加载过程

每一个xxxMapper.xml,都对应一个XMLMapperBuilder,由XMLMapperBuilder的parse方法解析,代码如下:

Code 2
org.apache.ibatis.builder.xml.XMLMapperBuilder

    public void parse() {
        if (!this.configuration.isResourceLoaded(this.resource)) {
            this.configurationElement(this.parser.evalNode("/mapper"));
            this.configuration.addLoadedResource(this.resource);
            this.bindMapperForNamespace();
        }
        this.parsePendingResultMaps();
        this.parsePendingChacheRefs();
        this.parsePendingStatements();
    }
解析xxxMapper.xml文件

Code 2第3行解析标签里的内容,处理过程如下:

Code 3
org.apache.ibatis.builder.xml.XMLMapperBuilder

    private void configurationElement(XNode context) {
        try {
            String namespace = context.getStringAttribute("namespace");
            if (namespace != null && !namespace.equals("")) {
                this.builderAssistant.setCurrentNamespace(namespace);
                this.cacheRefElement(context.evalNode("cache-ref"));
                this.cacheElement(context.evalNode("cache"));
                this.parameterMapElement(context.evalNodes("/mapper/parameterMap"));
                this.resultMapElements(context.evalNodes("/mapper/resultMap"));
                this.sqlElement(context.evalNodes("/mapper/sql"));
                this.buildStatementFromContext(context.evalNodes("select|insert|update|delete"));
            } else {
                throw new BuilderException("Mapper's namespace cannot be empty");
            }
        } catch (Exception var3) {
            throw new BuilderException("Error parsing Mapper XML. Cause: " + var3, var3);
        }
    }

context对应的内容就是这个xxxMapper.xml的完整内容。第9行,把这个里的resultMap标签的内容都添加到protected final Map

解析xxxMapper.java文件

Code 2第5行的方法,代码如下:

Code 4
org.apache.ibatis.builder.xml.XMLMapperBuilder

    private void bindMapperForNamespace() {
        String namespace = this.builderAssistant.getCurrentNamespace();
        if (namespace != null) {
            Class boundType = null;
            try {
                boundType = Resources.classForName(namespace);
            } catch (ClassNotFoundException var4) {
                ;
            }
            if (boundType != null && !this.configuration.hasMapper(boundType)) {
                this.configuration.addLoadedResource("namespace:" + namespace);
                this.configuration.addMapper(boundType);
            }
        }
    }

该方法获取xxxMapper.xml里的namespace的值,根据这个字符串获取Class类,如果该类存在,那么就解析这个类。解析这个类时,就是获取它的所有方法,如果某个方法包含特定的注解时,就把这个方法转化为对应的MappedStatement。

特定的注解如下:

Code 5

        this.sqlAnnotationTypes.add(Select.class);
        this.sqlAnnotationTypes.add(Insert.class);
        this.sqlAnnotationTypes.add(Update.class);
        this.sqlAnnotationTypes.add(Delete.class);
        this.sqlProviderAnnotationTypes.add(SelectProvider.class);
        this.sqlProviderAnnotationTypes.add(InsertProvider.class);
        this.sqlProviderAnnotationTypes.add(UpdateProvider.class);
        this.sqlProviderAnnotationTypes.add(DeleteProvider.class);

把某个方法转化为MappedStatement的过程是很复杂的,概括地说就是:对于符合条件的方法,通过方法上的注解生成SqlSource,这个SqlSource主要就包含sql语句和参数,再生成一些其他的信息,比如org.apache.ibatis.mapping.SqlCommandType。通过这些其他信息和SqlSource生成org.apache.ibatis.mapping.MappedStatement.Builder,然后通过Builder创建MappedStatement

最后把MappedStatement添加到org.apache.ibatis.session.Configuration中,key为 package+ p a c k a g e + {className}+${methodName}

当mapper.xml里和mapper.java里都配置一个sql时,出现什么情况?

会抛出如下第3行异常。

Code 6

    public V put(String key, V value) {
            if (this.containsKey(key)) {
                throw new IllegalArgumentException(this.name + " already contains value for " + key);
            } else {
                if (key.contains(".")) {
                    String shortKey = this.getShortName(key);
                    if (super.get(shortKey) == null) {
                        super.put(shortKey, value);
                    } else {
                        super.put(shortKey, new Configuration.StrictMap.Ambiguity(shortKey));
                    }
                }
                return super.put(key, value);
            }
        }

mybatis框架添加了一个StrictMap类,继承自HashMap,当put已经存在的key时,抛出异常。
从上面的过程中我们可以看到,在xml解析的key和方法注解解析出来的key是有可能重复的,如果重复了StrictMap的put方法就会抛出异常。

mybatis加载相关的类一览

mybatis加载相关的类主要都在builder这个包下,我们已经见识了多数的类,builder包结构如下:

http://p049fjos5.bkt.clouddn.com/mybatis-builder-package.png

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值