上一篇介绍了Configuration的属性,今天就看看属性的设置过程。
回顾
前面两篇文章最后都讲到最后是通过parse方法调用的parseConfiguration来设置Configuration的属性的,具体源码如下图:
可以看到parseConfiguration方法中几乎每一行代码都是调用一个方法,那么接下来我们就来一行一行的分析parseConfiguration代码。
propertiesElement方法分析
首先第一行执行的是propertiesElement(root.evalNode("properties"));可以看到是拿到mybatis配置文件中properties节点内容然后执行propertiesElement,我们看到propertiesElement方法源码如下图:
上图已经对这个方法有比较详细的说明了,这里在梳理一下,首先这个方法主要分三步,目的是设置Properties这个类,这个类继承Hashtable只是扩展了一些方法,主流程三步详解:
1、遍历properties节点的子节点填充到Properties的一个对象中;
2、获取properties节点的resource和url属性,利用Properties类的扩展方法读取对应文件中的数据,从代码中可以看出来两个属性至少要存在一个;
3、把configuration中的variables设置进properties,最后把properties设置到configuration的variables属性;
从上面这三个步骤我们可以得出一些结论:
1、mybatis配置文件的properties节点resource和url属性至少需要一个,并且resource是要优先与url配置的;
2、properties读取顺序是:首先读取在 properties 元素体内指定的属性。
然后根据 properties 元素中的 resource或url 属性读取类路径下属性文件,并覆盖之前读取过的同名属性。最后读取configuration中的variables(在初始化XMLConfigBuilder时传递的参数),并覆盖之前读取过的同名属性。
所以properties参数的优先级是:通过方法参数传递的属性具有最高优先级,resource/url 属性中指定的配置文件次之,最低优先级的则是 properties 元素中指定的属性。这个是一个面试题考点。
settings类型属性设置
接下来是对settings类型的属性设置,源码如下图:
和properties属性读取差不多,settings中的属性属于Configuration的基础属性,限制比较严格不允许出现Configuration没有的属性。从代码中可以看到打印日志的类也是在settings中设置的。还可以扩展一些mybatis加载本地文件的类。
总结
今天相当于只梳理了mybatis配置文件中的properties和settings两个节点的内容,不过我们也清楚了properties配置的优先级。并且settings中不能设置mybatis不能识别的属性,自定义日志输出类也可以设置在settings配置中。
接下来还有好几个扩展配置的加载过程,后面继续分享。
Java程序员日常学习笔记,如理解有误欢迎各位交流讨论!