Mybatis3.3.x技术内幕（九）：Mybatis初始化流程（下）
Mybatis初始化流程，其实就是组装重量级All-In-One对象Configuration的过程，主要分为系统环境参数初始化和Mapper映射初始化。
上一节中，粗略讲述了Mybatis初始化的基本步骤，本节，将详细分析具体的初始化过程中的细节问题，细节决定成败。
1. Properties variables的作用
通常，我们会单独配置jdbc.properties文件，保存于variables变量中，而Xml文件内可以使用${driver}占位符，读取时可动态替换占位符的值。
String value = PropertyParser.parse(attribute.getNodeValue(), variables);
Mybatis中的PropertyParser类，就是用来动态替换占位符参数的。
2. 扫描package
<typeAliases> <typeAlias alias="Student" type="com.mybatis3.domain.Student" /> <typeAlias alias="Teacher" type="com.mybatis3.domain.Teacher" /> <package name="com.mybatis3.domain" /> </typeAliases>
前两个typeAlias，很容易理解，那么<package>元素如何处理呢？
public void registerAliases(String packageName, Class<?> superType){
ResolverUtil<Class<?>> resolverUtil = new ResolverUtil<Class<?>>();
resolverUtil.find(new ResolverUtil.IsA(superType), packageName);
Set<Class<? extends Class<?>>> typeSet = resolverUtil.getClasses();
for(Class<?> type : typeSet){
// 排除内部类、接口
if (!type.isAnonymousClass() && !type.isInterface() && !type.isMemberClass()) {
registerAlias(type);
}
}
}
扫描package下所有的Class，并注册。此时，String alias = type.getSimpleName()。在处理typeHandlers和mappers时，处理package元素的原理也是一样。
3. namespace如何映射Mapper接口
org.apache.ibatis.builder.xml.XMLMapperBuilder.bindMapperForNamespace()。
// namespace="com.mybatis3.mappers.StudentMapper"
private void bindMapperForNamespace() {
String namespace = builderAssistant.getCurrentNamespace();
if (namespace != null) {
Class<?> boundType = null;
try {
boundType = Resources.classForName(namespace);
} catch (ClassNotFoundException e) {
//ignore, bound type is not required
}
if (boundType != null) {
if (!configuration.hasMapper(boundType)) {
configuration.addLoadedResource("namespace:" + namespace);
configuration.addMapper(boundType);
}
}
}
}
直接使用Class.forName()，成功找到就注册，找不到就什么也不做。
Mybatis中的namespace有两个功能。
1. 和其名字含义一样，作为名称空间使用。namespace + id，就能找到对应的Sql。
2. 作为Mapper接口的全限名使用，通过namespace，就能找到对应的Mapper接口（也有称Dao接口的）。Mybatis推荐的最佳实践，但并不强制使用。
Mapper接口注册至Configuration的MapperRegistry mapperRegistry内。
private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new HashMap<Class<?>, MapperProxyFactory<?>>();
Mapper接口将通过MapperProxyFactory创建动态代理对象。
可参看动态代理之投鞭断流（自动映射器Mapper的底层实现原理）博文。
4. 一个MappedStatement被缓存了两个引用的原理及原因
configuration.addMappedStatement(statement);
调用上面一句话，往Map里放置一个MappedStatement对象，结果Map中变成两个元素。
com.mybatis3.mappers.StudentMapper.findAllStudents=org.apache.ibatis.mapping.MappedStatement@add0edd findAllStudents=org.apache.ibatis.mapping.MappedStatement@add0edd
我们的问题是，为什么会变成两个元素？同一个对象，为什么要存有两个键的引用？
其实，在Mybatis中，这些Map，都是StrictMap类型，Mybatis在StrictMap内做了手脚。
protected static class StrictMap<V> extends HashMap<String, V> {
public V put(String key, V value) {
if (containsKey(key)) {
throw new IllegalArgumentException(name + " already contains value for " + key);
}
if (key.contains(".")) {
final String shortKey = getShortName(key);
if (super.get(shortKey) == null) {
super.put(shortKey, value);
} else {
super.put(shortKey, (V) new Ambiguity(shortKey));
}
}
return super.put(key, value);
}
}
Mybatis重写了put方法，将id和namespace+id的键，都put了进去，指向同一个MappedStatement对象。
这样做的好处是，方便我们编程。
Student std = sqlSession.selectOne("findStudentById", 1);
Student std = sqlSession.selectOne("com.mybatis3.mappers.StudentMapper.findStudentById", 1);
上面两句代码，是等价的，Mybatis不强制我们一定要加namespace名称空间，所以，这是存放两个键的良苦用心。
5. 初始化过程中的mapped和incomplete对象
翻译为搞定的和还没搞定的。这恐怕是Mybatis框架中比较奇葩的设计了，给人很多迷惑，我们来看看它具体是什么意思。
<resultMap type="Student" id="StudentResult" extends="Parent"> <id property="studId" column="stud_id" /> <result property="name" column="name" /> <result property="email" column="email" /> <result property="dob" column="dob" /> </resultMap> <resultMap type="Student" id="Parent"> <result property="phone" column="phone" /> </resultMap>
Mapper.xml中的很多元素，是可以指定父元素的，像上面extends="Parent"。然而，Mybatis解析元素时，是按顺序解析的，于是先解析的id="StudentResult"的元素，然而该元素继承自id="Parent"的元素，但是，Parent被配置在下面了，还没有解析到，内存中尚不存在，怎么办呢？Mybatis就把id="StudentResult"的元素标记为incomplete的，然后继续解析后续元素。等程序把id="Parent"的元素也解析完后，再回过头来解析id="StudentResult"的元素，就可以正确继承父元素的内容。
简言之就是，你的父元素可以配置在你的后边，不限制非得配置在前面。无论你配置在哪儿，Mybatis都能“智能”的获取到，并正确继承。
这便是在Configuration对象内，有的叫mapped，有的叫incomplete的原因。
protected final Collection<XMLStatementBuilder> incompleteStatements = new LinkedList<XMLStatementBuilder>(); protected final Collection<CacheRefResolver> incompleteCacheRefs = new LinkedList<CacheRefResolver>(); protected final Collection<ResultMapResolver> incompleteResultMaps = new LinkedList<ResultMapResolver>(); protected final Collection<MethodResolver> incompleteMethods = new LinkedList<MethodResolver>();
org.apache.ibatis.builder.xml.XMLMapperBuilder.parse()方法内，触发了incomplete的再度解析。
public void parse() {
if (!configuration.isResourceLoaded(resource)) {
configurationElement(parser.evalNode("/mapper"));
configuration.addLoadedResource(resource);
bindMapperForNamespace();
}
// 执行incomplete的地方
parsePendingResultMaps();
parsePendingChacheRefs();
parsePendingStatements();
}
Pending含义为待定的，悬而未决的意思。
总结：有了这些细节储备，阅读源码就变得更加得心应手了。