该系列文章针对 Mybatis 3.5.1 版本
一、<Settings>
标签
在 <settings>
中配置的是可以影响 Mybaits 运行时行为的配置,比如:cacheEnabled
配置可以影响 xml 的缓存配置是否生效。
更多的配置信息,可以通过 Mybatis 官方文档查阅
官方文档部分描述信息如下:
如图所示,针对每个配置项的可选值,默认值,文档都有详细的描述。
当我们需要定制化配置的时候,可以在 mybatis-config.xml
配置文件中使用 <settings>
标签配置,案例如下:
二、<settings>
标签解析
来回顾一下,XMLConfigBuilder
解析时序简图,如下:
在时序图中 <settings>
加载解析在
XMLConfigBuilder#settingsAsProperties
中完成,相关解析代码如下:
上述代码逻辑就是从 mybatis-config.xml
中的 <settings>
标签中读取数据,然后通过 MetaClass
将相关的属性配置设置到 Configuration
对象中。
具体操作可以查看MetaClass
中Reflector
。
<settings>
配置信息在 Configuration 中的表示
如上图所示,mybatis-config.xml
中<settings>
标签下的配置信息会以属性的方式存在于 Configuration 中。相关的逻辑图如下
三、<settings>
配置信息使用
以
cacheEnabled
属性为例
在 Mybatis 核心处理层中,SQL 执行的起始入口为 Executor
,执行器的入口也有很多种,而其中支持缓存功能的执行器为 CachingExecutor
,
而关于执行器的实现使用 CachingExecutor
作为执行器 与 cacheEnabled
有关。
来看一下执行器 Executor 实例对象获取代码,在 Configuration#newExecutor
中,相关代码如下:
如上述代码所示,根据 cacheEnabled
来判断是否需要需要使用 CachingExecutor
来对原有的 Executor
进行缓存支持的增强。
更多关于变量对Mybatis运行时的影响,自行查阅相关代码