这里忘记设置 implementation,或人为的将 implementation 设为空。如果不对 implementation 进行判空,会导致 build 方法在构建实例时触发空指针异常,对于框架来说,出现空指针异常是很尴尬的,这是一个低级错误。这里以及之前做了这么多判空,就是为了避免出现空指针的情况,以提高框架的健壮性。好了,关于 setDefaultImplementations 方法的分析先到这,继续往下分析。
我们在使用 MyBatis 内置缓存时,一般不用为它们配置自定义属性。但使用第三方缓存时,则应按需进行配置。比如前面演示 MyBatis 整合 Ehcache 时,就为 Ehcache 配置了一些必要的属性。下面我们来看一下这部分配置是如何设置到缓存实例中的。
private void setCacheProperties(Cache cache) { if (properties != null) { /* * 为缓存实例生成一个“元信息”实例,forObject 方法调用层次比较深,但最终调用了 * MetaClass 的 forClass 方法。关于 MetaClass 的源码,我在上一篇文章中已经 * 详细分析过了,这里不再赘述。 */ MetaObject metaCache = SystemMetaObject.forObject(cache); for (Map.Entry<Object, Object> entry : properties.entrySet()) { String name = (String) entry.getKey(); String value = (String) entry.getValue(); if (metaCache.hasSetter(name)) { // 获取 setter 方法的参数类型 Class<?> type = metaCache.getSetterType(name); /* * 根据参数类型对属性值进行转换,并将转换后的值 * 通过 setter 方法设置到 Cache 实例中 */ if (String.class == type) { metaCache.setValue(name, value); } else if (int.class == type || Integer.class == type) { /* * 此处及以下分支包含两个步骤: * 1.类型转换 → Integer.valueOf(value) * 2.将转换后的值设置到缓存实例中 → metaCache.setValue(name, value) */ metaCache.setValue(name, Integer.valueOf(value)); } else if (long.class == type || Long.class == type) { metaCache.setValue(name, Long.valueOf(value)); } else if (short.class == type || Short.class == type) {...} else if (byte.class == type || Byte.class == type) {...} else if (float.class == type || Float.class == type) {...} else if (boolean.class == type || Boolean.class == type) {...} else if (double.class == type || Double.class == type) {...} else { throw new CacheException("Unsupported property type for cache: '" + name + "' of type " + type); } } } } // 如果缓存类实现了 InitializingObject 接口,则调用 initialize 方法执行初始化逻辑 if (InitializingObject.class.isAssignableFrom(cache.getClass())) { try { ((InitializingObject) cache).initialize(); } catch (Exception e) { throw new CacheException("Failed cache initialization for '" + cache.getId() + "' on '" + cache.getClass().getName() + "'", e); } } }上面的大段代码用于对属性值进行类型转换,和设置转换后的值到 Cache 实例中。关于上面代码中出现的 MetaObject,大家可以自己尝试分析一下。最后,我们来看一下设置标准装饰器的过程。如下:
private Cache setStandardDecorators(Cache cache) { try { // 创建“元信息”对象 MetaObject metaCache = SystemMetaObject.forObject(cache); if (size != null && metaCache.hasSetter("size")) { // 设置 size 属性, metaCache.setValue("size", size); } if (clearInterval != null) { // clearInterval 不为空,应用 ScheduledCache 装饰器 cache = new ScheduledCache(cache); ((ScheduledCache) cache).setClearInterval(clearInterval); } if (readWrite) { // readWrite 为 true,应用 SerializedCache 装饰器 cache = new SerializedCache(cache); } /* * 应用 LoggingCache,SynchronizedCache 装饰器, * 使原缓存具备打印日志和线程同步的能力 */ cache = new LoggingCache(cache); cache = new SynchronizedCache(cache); if (blocking) { // blocking 为 true,应用 BlockingCache 装饰器 cache = new BlockingCache(cache); } return cache; } catch (Exception e) { throw new CacheException("Error building standard cache decorators. Cause: " + e, e); } }以上代码用于为缓存应用一些基本的装饰器,除了 LoggingCache 和 SynchronizedCache 这两个是必要的装饰器,其他的装饰器应用与否,取决于用户的配置。
到此,关于缓存的解析过程就分析完了。这一块的内容比较多,不过好在代码逻辑不是很复杂,耐心看还是可以弄懂的。其他的就不多说了,进入下一节的分析。
2.1.2 解析 <cache-ref> 节点在 MyBatis 中,二级缓存是可以共用的。这需要使用 <cache-ref> 节点配置参照缓存,比如像下面这样。
<!-- Mapper1.xml --> <mapper namespace="xyz.coolblog.dao.Mapper1"> <!-- Mapper1 与 Mapper2 共用一个二级缓存 --> <cache-ref namespace="xyz.coolblog.dao.Mapper2"/> </mapper> <!-- Mapper2.xml --> <mapper namespace="xyz.coolblog.dao.Mapper2"> <cache/> </mapper>