configuration 命名空间_MyBatis 核心配置综述之 Configuration详解

爱情不是你想买，想买就能买;

MyBatis 不是你想起，想起就能起……

我承认我唱歌只有一个调。

今儿心情还不错，吐了个槽，还希望大家不要介意。

话说，我最近一直在研究 MyBatis ，研究 MyBatis ，必然逃不了研究 Configuration 对象，这个对象简直是太重要了，它是 MyBatis 起步的核心环境配置，下面我们来一起看一下 Configuration 类

Configuration 的创建

如果你喜欢一个妹子，你是不是闲得问清楚妹子住在哪？只加微信那就只能望梅止渴，主动出击才是硬道理。否则，就算你租了一辆玛莎拉蒂，你都不知道在哪装B。

想要了解 Configuration，得先问清楚它是如何创建的。

在这之前，我先告诉你一个 MyBatis 的入口类，那就是 SqlSessionFactoryBuilder, 为什么要介绍这个类哦？因为这个类可以创建 SqlSession，想要孩子？没有Builder 的功能怎么行？它的创建在这里

SqlSessionFactoryBuilder 在创建完成 XMLConfigBuilder 之后，会完成 Configuration 的创建工作，也就是说Configuration 对象的创建是在 XMLConfigBuilder 中完成的 ，如下图

看到这里，你是不是有点跃跃欲试想要按住 control 键点进去？如你所愿，看一下 new Configuration 到底生出个什么东西

这就是初始化 Configuration 完成的工作了，图中还有一个很关键的类就是 TypeAliasRegistry， 想要注册？你得先知道 “我” 是谁 。

TypeAliasRegistry 在Configuration 创建的时候就被初始化了

protected final TypeAliasRegistry typeAliasRegistry = new TypeAliasRegistry();

so？ 看一下 new 都做了一些什么事情

public TypeAliasRegistry() {  registerAlias("string", String.class);  registerAlias("byte", Byte.class);  registerAlias("long", Long.class);  registerAlias("short", Short.class);  registerAlias("int", Integer.class);  registerAlias("integer", Integer.class);  registerAlias("double", Double.class);  registerAlias("float", Float.class);  registerAlias("boolean", Boolean.class);  registerAlias("byte[]", Byte[].class);  registerAlias("long[]", Long[].class);  registerAlias("short[]", Short[].class);  registerAlias("int[]", Integer[].class);  registerAlias("integer[]", Integer[].class);  registerAlias("double[]", Double[].class);  registerAlias("float[]", Float[].class);  registerAlias("boolean[]", Boolean[].class);  registerAlias("_byte", byte.class);  registerAlias("_long", long.class);  registerAlias("_short", short.class);  registerAlias("_int", int.class);  registerAlias("_integer", int.class);  registerAlias("_double", double.class);  registerAlias("_float", float.class);  registerAlias("_boolean", boolean.class);  registerAlias("_byte[]", byte[].class);  registerAlias("_long[]", long[].class);  registerAlias("_short[]", short[].class);  registerAlias("_int[]", int[].class);  registerAlias("_integer[]", int[].class);  registerAlias("_double[]", double[].class);  registerAlias("_float[]", float[].class);  registerAlias("_boolean[]", boolean[].class);  registerAlias("date", Date.class);  registerAlias("decimal", BigDecimal.class);  registerAlias("bigdecimal", BigDecimal.class);  registerAlias("biginteger", BigInteger.class);  registerAlias("object", Object.class);  registerAlias("date[]", Date[].class);  registerAlias("decimal[]", BigDecimal[].class);  registerAlias("bigdecimal[]", BigDecimal[].class);  registerAlias("biginteger[]", BigInteger[].class);  registerAlias("object[]", Object[].class);  registerAlias("map", Map.class);  registerAlias("hashmap", HashMap.class);  registerAlias("list", List.class);  registerAlias("arraylist", ArrayList.class);  registerAlias("collection", Collection.class);  registerAlias("iterator", Iterator.class);  registerAlias("ResultSet", ResultSet.class);}

好刺激啊，这么一大段代码，不过看起来还是比较清晰明了的，这不就是 MyBatis 常用类型么，并给它们都起了一个各自的别名存起来，用来解析的时候使用。

Configuration 的标签以及使用

说完了 Configuration 的创建，我们不直接切入初始化的主题，先来吃点甜点

还记得你是如何搭建一个 MyBatis 项目么？其中很关键的是不是有一个叫做 mybatis-config.xml的这么一个配置？

这个配置就是 标签存在的意义了。

我在最外侧写了一个 configuration 标签，然后 dtd 语言约束就给我提示这么多属性可以设置，它们都是属于 Configuration 内的标签，那么这些标签都是啥呢？别急，慢慢来，掌握好频率和节奏还有力度，别太猛，年轻人要沉稳。

我不想按着标签的顺序来了，请跟好我的节奏。

首先很重要的两个属性就是 properties 和 environments ，properties 就是外部属性配置，你可以这么配置它

导入外部配置文件，config.properties 文件中是一系列关于数据库的配置，给你举个例子吧，看你着急的

载入外部属性配置后，需要配置 environments 标签，它可以配置事务管理、数据源、读取配置文件等

明白否？

还有一个很关键的配置就是 mapper 标签，你可以把它理解为 ComponentScan ，ComponentScan 完成的是 Bean 定义的查找，而 mapper 完成的是 接口的查找，该接口要与对应的 XML 命名空间相匹配才可以。例如

再继续深入，来看一下 都需要哪些内容，你可以设置下面这些，下面这些配置有些多，你可以查看(http://www.mybatis.org/mybatis-3/zh/configuration.html#settings) 来具体查看这些配置。

// ExampleObjectFactory.javapublic class ExampleObjectFactory extends DefaultObjectFactory {  public Object create(Class type) {    return super.create(type);  }  public Object create(Class type, List constructorArgTypes, List constructorArgs) {    return super.create(type, constructorArgTypes, constructorArgs);  }  public void setProperties(Properties properties) {    super.setProperties(properties);  }  public  boolean isCollection(Class type) {    return Collection.class.isAssignableFrom(type);  }}

你知道 Oracle 和 MySQL 都可以对表，字段设置别名吗？MyBatis 也可以设置别名，采用的是 typeAliases 属性，比如

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。 MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。 如果同时找到带有 databaseId 和不带 databaseId 的相同语句，则后者会被舍弃。 为支持多厂商特性只要像下面这样在 mybatis-config.xml 文件中加入 databaseIdProvider 即可：

// ExampleObjectFactory.javapublic class ExampleObjectFactory extends DefaultObjectFactory {  public Object create(Class type) {    return super.create(type);  }  public Object create(Class type, List constructorArgTypes, List constructorArgs) {    return super.create(type, constructorArgTypes, constructorArgs);  }  public void setProperties(Properties properties) {    super.setProperties(properties);  }  public  boolean isCollection(Class type) {    return Collection.class.isAssignableFrom(type);  }}

DB_VENDOR 对应的 databaseIdProvider 实现会将 databaseId 设置为 DatabaseMetaData#getDatabaseProductName() 返回的字符串。 由于通常情况下这些字符串都非常长而且相同产品的不同版本会返回不同的值，所以你可能想通过设置属性别名来使其变短，如下：

MyBatis 每次创建结果对象的新实例时，它都会使用一个对象工厂(ObjectFactory)实例来完成。 默认的对象工厂需要做的仅仅是实例化目标类，要么通过默认构造方法，要么在参数映射存在的时候通过参数构造方法来实例化。 如果想覆盖对象工厂的默认行为，则可以通过创建自己的对象工厂来实现。比如：

// ExampleObjectFactory.javapublic class ExampleObjectFactory extends DefaultObjectFactory {  public Object create(Class type) {    return super.create(type);  }  public Object create(Class type, List constructorArgTypes, List constructorArgs) {    return super.create(type, constructorArgTypes, constructorArgs);  }  public void setProperties(Properties properties) {    super.setProperties(properties);  }  public  boolean isCollection(Class type) {    return Collection.class.isAssignableFrom(type);  }}

ObjectFactory 的作用就很像是 Spring 中的 FactoryBean ，如果不是很了解关于 FactoryBean 的讲解，请移步至

(https://mp.weixin.qq.com/s/aCFzCopCX1mK6Zg-dT_KgA) 进行了解

MyBatis 留给开发人员的后门是可以进行插件开发的，插件开发在何处体现呢？其实 MyBatis 四大组件都会有体现， MyBatis 的插件开发其实也是代理的一种应用，如图

Configuration.java

这是 Executor 插件开发的调用位置，那么 StatementHandler, ParameterHandler, ResultSetHandler 的调用和 Executor 基本一致，如图

过 MyBatis 提供的强大机制，使用插件是非常简单的，只需实现 Interceptor 接口，并指定想要拦截的方法签名即可。例如官网的这个例子

// ExamplePlugin.java@Intercepts({@Signature(  type= Executor.class,  method = "update",  args = {MappedStatement.class,Object.class})})public class ExamplePlugin implements Interceptor {  private Properties properties = new Properties();  public Object intercept(Invocation invocation) throws Throwable {    // implement pre processing if need    Object returnObject = invocation.proceed();    // implement post processing if need    return returnObject;  }  public void setProperties(Properties properties) {    this.properties = properties;  }}

只需要再把这个插件告诉 MyBatis， 这里有个插件拦截器，记得用奥

typeHandlers 也叫做类型转换器，主要用在参数转换的地方，哪里进行参数转换呢？其实有两点：

• PreparedStatementHandler 在解析 SQL 参数，进行参数设置的时候，需要把 Java Type 转换为 JDBC 类型
• ResultSetHandler 返回的结果集，需要把 JDBC 类型转换为 Java Type

可以编写自己的类型转换器，如下：

// ExampleTypeHandler.java@MappedJdbcTypes(JdbcType.VARCHAR)public class ExampleTypeHandler extends BaseTypeHandler {  @Override  public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {    ps.setString(i, parameter);  }  @Override  public String getNullableResult(ResultSet rs, String columnName) throws SQLException {    return rs.getString(columnName);  }  @Override  public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {    return rs.getString(columnIndex);  }  @Override  public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {    return cs.getString(columnIndex);  }}

也需要告诉 MyBatis ，这里面有个参数转换器，别忘了转换！

Configuration 标签的解析

现在有了上面的这些标签的定义，应该在哪解析呢？就好比合适的人在合适的岗位才能创造出最大的价值一样。

现在就需要续上 SqlSessionFactoryBuilder 的第三步了， Configuration 的解析工作

在 XMLConfigBuilder 中

这是不是就和上面的标签对应起来了？解析工作是在这里进行的，这也是一种好的编码习惯，一个方法只做一件事情，应该多多借鉴这种写法。

Configuration 子标签的源码分析

假如你能从上向下看到这里，就说明你对这篇文章产生了浓厚的兴趣，恭喜你，你的段位又升级了。我不打王者荣耀，我之前一直打魔兽solo，solo是很需要手速的，同时也需要考虑到各种因素：比如你是 ORC(兽族)，你的 BM(剑圣) 开 W(疾风步) 抢怪的时间要掌握好，你骚扰 NE (暗夜精灵) 采木材的时间要掌握好，抢宝的时间要掌握好，比如你玩的是 Turtle Rock(龟岛)，你单刷蓝胖的时间也要算好，等等等等。

你既要sky的中规中矩，你也要MOON的不羁，你还要fly100%的沉稳，你也需要TED的坚持。也就印证了一句话，小孩子才做选择，成年人都要！

所以你不仅仅要知其果，还要懂其因。

第一步：Properties 解析

第一个方法: propertiesElement(root.evalNode("properties"))，点进去可以看到其源码，我这里已经做了注释，方便你去理解

// 其实一个个 <> 的标签就是 一个个的XNode节点  private void propertiesElement(XNode context) throws Exception {    if (context != null) {      // 首先判断要解析的属性是否有无子节点      Properties defaults = context.getChildrenAsProperties();      // 解析 解析完成就变为配置文件的 SimpleName      String resource = context.getStringAttribute("resource");      // 解析      String url = context.getStringAttribute("url");      // 如果都为空，抛出异常      if (resource != null && url != null) {        throw new BuilderException("The properties element cannot specify both a URL and a resource based property file reference.  Please specify one or the other.");      }      // 如果不为空的话，就把配置文件的内容都放到 Resources 类中      if (resource != null) {        defaults.putAll(Resources.getResourceAsProperties(resource));      } else if (url != null) {        defaults.putAll(Resources.getUrlAsProperties(url));      }            // 这块应该是判断有无之前的配置      Properties vars = configuration.getVariables();      if (vars != null) {        defaults.putAll(vars);      }      parser.setVariables(defaults);      // 最后放入 configuration 属性中      configuration.setVariables(defaults);    }  }

第二步：Settings 解析

在这里我们以二级缓存的开启为例来做解析

那么它在settingsAsProperties(root.evalNode("settings")) 中是如何解析的呢？

// XNode 就是一个个的 标签private Properties settingsAsProperties(XNode context) {  if (context == null) {    return new Properties();  }  // 获取字标签，字标签也就是  中的   Properties props = context.getChildrenAsProperties();  // Check that all settings are known to the configuration class  // 用反射确保所有的设置都在 Configuration 类中。  MetaClass metaConfig = MetaClass.forClass(Configuration.class, localReflectorFactory);  for (Object key : props.keySet()) {    // 如果反射没有确保这个key 在类中，就抛出异常    if (!metaConfig.hasSetter(String.valueOf(key))) {      throw new BuilderException("The setting " + key + " is not known.  Make sure you spelled it correctly (case sensitive).");    }  }  return props;}

解析完成后的 settings 对象，底层是用 Hashtable 存储了一个个的 entry 对象。

第三步：TypeAliases 解析

TypeAliases 用于别名注册，你可以为实体类指定它的别名，源码如下

private void typeAliasesElement(XNode parent) {  if (parent != null) {    // 也是首先判断有无子标签    for (XNode child : parent.getChildren()) {      // 如果有字标签，那么取出字标签的属性名，如果是 package      if ("package".equals(child.getName())) {        // 那么取出 字标签 的name属性        String typeAliasPackage = child.getStringAttribute("name");        configuration.getTypeAliasRegistry().registerAliases(typeAliasPackage);      } else {        // typeAliases 下面有两个标签，一个是 package 一个是 TypeAlias        String alias = child.getStringAttribute("alias");        String type = child.getStringAttribute("type");        try {          Class> clazz = Resources.classForName(type);          if (alias == null) {            typeAliasRegistry.registerAlias(clazz);          } else {            typeAliasRegistry.registerAlias(alias, clazz);          }        } catch (ClassNotFoundException e) {          throw new BuilderException("Error registering typeAlias for '" + alias + "'. Cause: " + e, e);        }      }    }  }}

第四步：Plugins 解析

MyBatis 中的插件都在这一步进行解析注册

private void pluginElement(XNode parent) throws Exception {  if (parent != null) {    for (XNode child : parent.getChildren()) {      // 取出 interceptor 的名称      String interceptor = child.getStringAttribute("interceptor");      Properties properties = child.getChildrenAsProperties();      // 生成新实例，设置属性名      Interceptor interceptorInstance = (Interceptor) resolveClass(interceptor).newInstance();      interceptorInstance.setProperties(properties);      // 添加到 configuration 中      configuration.addInterceptor(interceptorInstance);    }  }}

其他步骤

其实后面的源码分析步骤都差不多，大体上都是判断有无此 XNode 节点，然后判断它的子节点标签，得到标签的属性，放入 Configuration 对象中，这样就完成了 Configuration 对象的初始化，其实你可以看出，MyBatis 中的 Configuration 也是一个大的容器，来为后面的SQL语句解析和初始化提供保障。

总结

本文主要概括了

• Configuration 的创建过程

SqlSessionFactoryBuilder 创建 XMLConfigBuilder ，XMLConfigBuilder 再创建 Configuration ， Configuration 的创建会装载一些基本属性，如事务，数据源，缓存，日志，代理等，它们由 TypeAliasRegistry 进行注册，而TypeAliasRegistry 初始化也注册了一些基本数据类型，map，list，collection等，Configuration 还初始化了其他很多属性，由此完成 Configuration 的创建。

• Configuration 的标签以及使用

此步骤分析了 Configuration 中的标签以及使用，此部分不用去记忆，只知道有哪几个比较重要的标签就可以了，比如： properties， environment，mappers，settings，typeHandler，如果有开发需求直接查找官网就好

(http://www.mybatis.org/mybatis-3/zh/configuration.html)

• Configuration 对标签的解析

此步骤分析了 XMLConfigBuilder 对 Configuration 类下所有标签的解析工作，解析工作大部分模式都差不多

大体上都是判断有无此 XNode 节点，然后判断它的子节点标签，得到标签的属性，放入 Configuration 对象中。

参考资料：

Mybatis-Configuration-详解

http://www.mybatis.org/mybatis-3/zh/configuration.html