MyBatis 核心配置讲解（上）

王有志2024-04-21 19:46

大家好，我是王有志，一个分享硬核 Java 技术的互金摸鱼侠。

前两篇的文章中我们分别介绍了 MyBatis 和 MyBaits 的应用组成，到这里基础篇的内容就结束了。

从今天开始，我们正式进入 MyBatis 学习的第二阶段：MyBatis 的应用部分。这个阶段从 MyBatis 应用程序的核心配置文件 mybatis-config.xml 开始入手，逐步推进到映射器（Mapper.xml），动态 SQL 语句的编写以及 MyBatis 与 Spring 和 Spring Boot 的集成。

在讲解 MyBatis 的核心配置文件时，以及未来讲解 MyBatis 的映射器（Mapper.xml）时，会少量涉及到文档类型定义（即 DTD，Document Type Definition）的内容，由于很多小伙伴可能不太熟悉 DTD，因此我会在文末的部分通过一张图来简单介绍下 DTD。

Tips：

  • 目前 DTD 正在逐渐被功能更强，标准化程度更高的 XSD（XML Schema Definition）取代，因此我们只要简单了解 DTD 即可；
  • 点击这里可以直接下载 MyBatis 核心配置文件的 DTD。

MyBaits 的核心配置文件

我们打开 mybatis-3-configs.dtd 可以看到，该文档最开始定义了 MyBatis 配置中的 configuration 元素及包含的子元素：

xml 复制代码 
<!ELEMENT configuration (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?, reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)>

configuration 元素是 mybatis-config.xml 的根元素，本身并未定义任何属性，只定义了 11 个子元素，这里需要注意，子元素定义的顺序也是它们在 MyBatis 核心配置文件 mybatis-config.xml 中使用的顺序。

接下来我们按照 DTD 中定义的元素顺序，逐个讲解元素的用法。由于数量比较多，我会分为两期和大家分享，本期分享 configuration 的前 5 个子元素：properties，settings，typeAliases，typeHandlers 和 objectFactory。

properties 元素（配置）

properties 元素用于声明配置，在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT properties (property*)>
<!ATTLIST properties
resource CDATA #IMPLIED
url CDATA #IMPLIED
>

properties 定义了两个属性：resource 属性和 url 属性，以及一个子元素 property。

resource 属性和 url 属性

properties 元素提供了两个属性：resource 和 url，通过它们允许通过其它配置文件或网络中获取配置。

属性 是否必填 说明
resource 非必填 与属性 url 互斥
url 非必填 与属性 resource 互斥

Tips：属性 resource 与 url 互斥的原因，我会在属性与子标签的优先级中提到。

使用它们需要提前准备好配置文件，或能够通过网络获取配置，我这里以使用配置文件为例。首选我们准备一个配置文件 mysql-config.properties，将它放在 resources 目录下，具体内容如下：

properties 复制代码 
mysql.driver=com.mysql.cj.jdbc.Driver
mysql.url=jdbc:mysql://localhost:3306/mybatis
mysql.username=root
mysql.password=123456

接着我们修改 MyBatis 入门中示例的 mybatis-config.xml，如下：

xml 复制代码 
<configuration>
  <properties resource="mysql-config.properties" />

  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${mysql.driver}"/>
        <property name="url" value="${mysql.url}"/>
        <property name="username" value="${mysql.username}"/>
        <property name="password" value="${mysql.password}"/>
      </dataSource>
    </environment>
  </environments>
</configuration>

property 元素

property 元素在 DTD 中的定义如下

xml 复制代码 
<!ELEMENT property EMPTY>
<!ATTLIST property
name CDATA #REQUIRED
value CDATA #REQUIRED
>

通过 property 元素可以在 mybatis-config.xml 中声明配置。

属性 是否必填 说明
name 是 无
value 是 无

在 properties 元素中使用 property 元素无需额外的准备，直接写在 mybatis-config.xml 中即可，如下：

xml 复制代码 
<configuration>
  <properties>
    <property name="mysql.driver" value="com.mysql.cj.jdbc.Driver"/>
    <property name="mysql.url" value="jdbc:mysql://localhost:3306/mybatis"/>
    <property name="mysql.username" value="root"/>
    <property name="mysql.password" value="123456"/>
  </properties>

  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${mysql.driver}"/>
        <property name="url" value="${mysql.url}"/>
        <property name="username" value="${mysql.username}"/>
        <property name="password" value="${mysql.password}"/>
      </dataSource>
    </environment>
  </environments>
</configuration>

Tips：在 mybatis-3-config.dtd 中，property 标签是一个通用元素，会作为很多元素的子元素出现，例如：objectFactory 元素，databaseIdProvider 元素等。

属性与子元素的混合使用

properties 元素支持属性与子元素的混合使用。我们稍微修改下外部配置文件 mysql-config.properties，删除 mysql.driver 和 mysql.url，如下：

properties 复制代码 
mysql.username=root
mysql.password=123456

接着修改 mybatis-config.xml，删除通过 property 元素配置的 mysql.username 和 mysql.password，并且引入外部配置文件 mysql-config.properties，如下：

xml 复制代码 
<configuration>
  <properties resource="mysql-config.properties">
    <property name="mysql.driver" value="com.mysql.cj.jdbc.Driver"/>
    <property name="mysql.url" value="jdbc:mysql://localhost:3306/mybatis"/>
  </properties>

  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="${mysql.driver}"/>
        <property name="url" value="${mysql.url}"/>
        <property name="username" value="${mysql.username}"/>
        <property name="password" value="${mysql.password}"/>
      </dataSource>
    </environment>
  </environments>
</configuration>

通过测试，你会发现 MyBatis 应用依旧可以良好的运转。不过这时你可能会产生疑惑，如果我不删除外部配置文件 mysql-config.properties 中的配置，也不删除 property 元素中的配置，到底会是谁说的算？

属性与子元素的优先级

先说结论，在 properties 元素中，通过属性 resource 和 url 获取的配置优先级高于 property 元素的配置，如果同时使用属性和子元素，且存在相同配置名的配置，最终生效的配置是通过属性获取到的配置。

这里涉及到一些源码，不过非常简单，我们在 MyBatis 应用的组成中提到过，MyBatis 中的 mybatis-config.xml 由 XMLConfigBuilder 负责解析，我们能够非常容易的在 XMLConfigBuilder 中找到解析 properties 的相关的源码：

java 复制代码 
private void propertiesElement(XNode context) throws Exception {
  if (context == null) {
    return;
  }
  
  // 获取子元素的配置
  Properties defaults = context.getChildrenAsProperties();

  // 获取properties的属性
  String resource = context.getStringAttribute("resource");
  String url = context.getStringAttribute("url");

  // 校验resource与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.");
  }

  // 获取通过properties属性的配置
  if (resource != null) {
    defaults.putAll(Resources.getResourceAsProperties(resource));
  } else if (url != null) {
    defaults.putAll(Resources.getUrlAsProperties(url));
  }

  // 获取通过configuration的配置
  Properties vars = configuration.getVariables();
  if (vars != null) {
    defaults.putAll(vars);
  }
  parser.setVariables(defaults);
  configuration.setVariables(defaults);
}

源码中的第 7 行调用了XNode#getChildrenAsProperties并生成了 Properties 对象，作为默认的配置对象 defaults。

java 复制代码 
public Properties getChildrenAsProperties() {
  Properties properties = new Properties();
  for (XNode child : getChildren()) {
    String name = child.getStringAttribute("name");
    String value = child.getStringAttribute("value");
    if (name != null && value != null) {
      properties.setProperty(name, value);
    }
  }
  return properties;
}

接着执行到第 10 行和第 11 行，分别从 properties 元素获取属性 resource 和 url 的值，并在 14~16 行校验了两者不能同时存在，否则会抛出异常 BuilderException，这也是 properties 元素的属性 resource 与 url 互斥的原因。

接着是 19~21 行，从属性 resource 或 url 中获取配置，并通过Properties#putAll方法添加到默认的配置对象 defaults 中。Properties 是 Java 提供的工具类，底层使用的容器是 ConcurrentHashMap，到这里就能够解释为什么通过属性 resource 和 url 获取到配置的优先级高于通过子元素 property 获取到的配置了。

最后是 26~29 行的内容，这里是获取 Configuration 对象中的配置，并添加到默认配置对象 defaults 中，那么 Configuration 对象中的配置是如何来的呢？

还记得我们构建 SqlSessionFactory 时调用的SqlSessionFactoryBuilder#build方法吗？它有非常多的重载方法：

java 复制代码 
public SqlSessionFactory build(Reader reader);

public SqlSessionFactory build(Configuration config);

public SqlSessionFactory build(Reader reader, Properties properties);

重载方法中允许我们通过 Java 编码的方式来设置 Properties，这时设置的 Properties 对象会加载到 Configuration 对象中，例如：

java 复制代码 
Reader reader = Resources.getResourceAsReader("mybatis-config.xml");

Properties properties = new Properties();
properties.setProperty("mysql.password", "123456");

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader, properties);

这时生效的配置信息是通过代码设置的 Properties。

综合上面的内容，我们可以得到 MyBatis 中配置优先级的完整结论：优先级最高的是通过代码设置的配置，其次是通过 Properties 元素的属性 resource 和 url 设置的配置，优先级最低的是通过 Properties 元素的Property 子元素设置的配置。

settings 元素（设置）

settings 元素用于调整 MyBatis 中的各项设置，它在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT settings (setting+)>

<!ELEMENT setting EMPTY>
<!ATTLIST setting
name CDATA #REQUIRED
value CDATA #REQUIRED
>

settings 元素没有属性，只有一个 setting 子元素，也是典型的 K-V 形式。这也就是说，如果想要调整 MyBatis 应用的设置，必须要使用 setting 子元素。

settings 元素本身没有什么特别的，重要的是它提供了非常对的 MyBatis 的配置功能，如下图：

Tips ：以上部分截取自MyBatis中文网：设置（settings）。

typeAliases 元素（别名）

tyoeAliases 元素用于为 Java 类型设置别名，它在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT typeAliases (typeAlias*,package*)>

<!ELEMENT typeAlias EMPTY>
<!ATTLIST typeAlias
type CDATA #REQUIRED
alias CDATA #IMPLIED
>

<!ELEMENT package EMPTY>
<!ATTLIST package
name CDATA #REQUIRED
>

typeAliases 元素本身没有任何属性，只有两个子元素：typeAlias 元素和 package 元素。

typeAlias 元素

typeAlias 元素用于设定单个 Java 类型的别名。

属性 是否必填 说明
type 是 使用 Java 类型的全限名
alias 否 自定义的别名

我们看到，alias 属性是非必填的，如果没有填写的话，MyBatis 会如何处理呢？MyBatis 会默认使用将首字母小写后 Java 类型的名字作为别名，例如：

xml 复制代码 
<configuration>
  <!-- 省略其它配置 -->
  <typeAliases>
    <typeAlias type="com.wyz.entity.UserDO"/>
  </typeAliases>
  <!--省略其它配置 -->
</configuration>

此时 UserDO 在 MyBatis 中的别名是 userDO， 配置别名后我们就可以直接在映射器（Mapper.xml）中使用：

xml 复制代码 
<mapper namespace="com.wyz.mapper.UserMapper">
  <select id="selectAll" resultType="userDO" >
    select user_id, name, age, gender, id_type, id_number from user
  </select>
</mapper>

package 元素

package 元素用于设定包下所有 Java 类型的别名。

属性 是否必填 说明
name 是 包名

如果只使用 package 元素的话，MyBatis 同样会使用将首字母小写后的 Java 类型的名字作为别名 。但 MyBatis 也提供了@Alias注解，方便为每个类型起别名，例如：

java 复制代码 
package com.wyz.entity;

@Alias("user")
public class UserDO implements Serializable {
  // 省略属性
}

接着在 mybatis-config.xml 中配置：

xml 复制代码 
<configuration>
  <!-- 省略其它配置 -->
  <typeAliases>
    <package name="com.wyz.entity"/>
  </typeAliases>
  <!--省略其它配置 -->
</configuration>

此时，我们就可以在映射器（Mapper.xml）中使用 user 作为 com.wyz.entity.UserDO 的别名了。

MyBatis 内置的别名

上面是自定义别名的部分，实际上 MyBatis 已经为常见的 Java 类型定义了别名，例如：java.lang.String 在 MyBatis 中的别名是"string"，java.lang.Integer 在 MyBatis 中的别名是"int"。

你可能会有疑惑，那基本数据类型 int 有别名吗？

答案是有的，MyBatis 为 Java 中的每个基础数据类型都定义了别名，与它们的包装类型的别名有所差异，我们一起来看一下:

基础数据类型 别名 包装类型 别名
byte _byte Byte byte
char _char/_character Character char/character
long _long Long long
int _int/_integer Integer int/integer
short _short Short short
double _double Double double
float _float Float float
boolean _boolean Boolean boolean

基础数据类型"痛失真名"~~

当然，以上只是一部分 MyBatis 为 Java 类型定义的别名，更多常见 Java 类型的别名定义可以参考 MyBatis 的源码 TypeAliasRegistry 类。

Tips：通常我不使用 typeAliases 标签，因为使用全限名能够更加方便的在映射器（Mapper.xml）中查找到对应的 Java 类型。

typeHandlers 元素（类型处理器）

typeHandlers 元素用于定义类型处理器，即 Java 类型与数据库类型的相互转换的处理器，它在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT typeHandlers (typeHandler*,package*)>

typeHandlers 元素没有属性，只定义了两个子元素：typeHandler 元素和 package 元素。

typeHandler 元素

typeHandler 元素在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT typeHandler EMPTY>
<!ATTLIST typeHandler
javaType CDATA #IMPLIED
jdbcType CDATA #IMPLIED
handler CDATA #REQUIRED
>

typeHandler 元素中定义了 3 个属性：

属性 是否必填 说明
javaType 否 Java 类型
jdbcType 否 JDBC 类型
handler 是 类型处理器全限名

typeHandler 元素，可以定义 Java 类型与 JDBC 类型互相转换的类型处理器，如：

xml 复制代码 
<configuration>
  <typeHandlers>
    <typeHandler jdbcType="VARCHAR" javaType="java.lang.String" handler="org.apache.ibatis.type.StringTypeHandler"/>
  </typeHandlers>
</configuration>

StringTypeHandler 是 MyBatis 内置的类型处理器，MyBatiis 已经为我们内置了非常多的类型处理器，完全能够满足日常项目中的使用了。

Tips：

  • 关于 MyBatis 内置处理器，下面会在 MyBatis 的内置处理器的部分提到；
  • 关于 typeHandler 元素中 jdbcType 属性和 javaType 属性非必填的问题，会在自定义类型处理器的部分提到。

package 元素

在 typeHandlers 元素下使用 package 元素，会加载 package 元素中指定包名下所有符合条件的类型处理器。例如：

xml 复制代码 
<configuration>
  <typeHandlers>
    <package name="com.wyz.customize.handler.type"/>
  </typeHandlers>
</configuration>

如上的定义，会加载 com.wyz.customize.handler.type 中所有符合条件的类型处理器。但是 package 元素只能指定包名，MyBatis 该如何识别类型处理器是哪些 Java 类型与数据库类型之间的转换呢？

别急，我们接着往下看。

自定义类型处理器

现在，我们已经知道了如何在 mybatis-config.xml 中配置类型处理器了，接下来我们就定义自己的类型处理器。

MyBatis 中提供了两种定义类型处理器的方法：

  • 实现 TypeHandler 接口；
  • 继承抽象类 BaseTypeHandler。

其中抽象类 BaseTypeHandler 中已经做了非常多的通用实现，采用继承 BaseTypeHandler 的方法可以省去大量的编码工作，因此我这里在实现自定义类型处理器的时候选择了继承 BaseTypeHandler。

我们定义一个针对于 String 与 Varchar 的类型处理器，实现一个简单且无意义的需求：针对于参数和结果集，我们对 String 类型的字段添加后缀"_wyz"，我将这个类型处理器命名为 NewStringTypeHandler，代码如下：

java 复制代码 
package com.wyz.customize.handler.type;

import org.apache.ibatis.type.BaseTypeHandler;
import org.apache.ibatis.type.JdbcType;
import org.apache.ibatis.type.MappedJdbcTypes;
import org.apache.ibatis.type.MappedTypes;

import java.sql.*;

public class NewStringTypeHandler extends BaseTypeHandler<String> {
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter + "_wyz");
    }

    @Override
    public String getNullableResult(ResultSet rs, String columnName) throws SQLException {
        return rs.getString(columnName) + "_wyz";
    }

    @Override
    public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        return rs.getString(columnIndex) + "_wyz";
    }

    @Override
    public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        return cs.getString(columnIndex) + "_wyz";
    }
}

接下来，我们在 mybatis-config.xml 中配置这个类型处理器：

xml 复制代码 
<configuration>
  <typeHandlers>
    <typeHandler jdbcType="VARCHAR" javaType="java.lang.String" handler="com.wyz.customize.handler.type.NewStringTypeHandler"/>  </typeHandlers>
</configuration>

最后我们通过测试可以看到，所有查询语句的响应结果中 VARCHAR 类型的字段都添加了后缀"_wyz"，而所有插入或修改语句在提交后，数据库中存储的所有 VARCHAR 类型的字段也被添加上了后缀"_wyz"。

前面我们已经提到了，typeHandler 元素中的属性 jdbcType 与 javaType 是非必填的，如果我们不设置 jdbcType 与 javaType 的话会发生什么？答案是自定义类型处理器依旧会被注册到 MyBatis 的类型处理器中，但是我们无法使用（涉及到源码，这部分我们放在 MyBatis 的源码分析篇中再聊）。

那么为什么 typeHandler 元素中这两个属性是非必填的呢？因为 MyBatis 还提供了两个注解 @MappedTypes和 @MappedJdbcTypes，允许我们在自定义类型处理器上定义 Java 类型与数据库类型，如下：

java 复制代码 
@MappedTypes({String.class})
@MappedJdbcTypes({JdbcType.VARCHAR, JdbcType.CHAR})
public class NewStringTypeHandler extends BaseTypeHandler<String> {
    // 省略代码
}

这样，我们即便不在 typeHandler 元素中设置属性 jdbcType 与 javaType，MyBatis 也同样能够正确的注册自定义类型处理器。

再来看 package 元素，虽然没有元素中没有设置 jdbcType 与 javaType 的属性，但是我们想到 package 元素也可以通过@MappedTypes和@MappedJdbcTypes注解，来指定 Java 类型与数据库类型的转换方式，这里我们就不再写相关的代码了。

MyBatis 内置的类型处理器

最后我们来看 MyBatis 中内置的类型处理器，在 MyBatis 3.5.15 版本中，MyBatis 为 80 种类型定义了 51 个类型处理器，我们可以通过查看 BaseTypeHandler 的实现类来查看 MyBatis 的内置处理器的数量。

为什么类型与类型处理器的数量不一致呢？

是因为 MyBatis 为了兼容 Java 中的基础类型与包装类型，以及不同数据库之间相同类型的叫法不同，需要为每种类型都注册类型处理器，但他们可以共用同一个类型处理器，例如，在 MyBatis 注册内置处理器的 TypeHandlerRegistry 的构造方法中为布尔类型注册类型处理器时：

java 复制代码 
public TypeHandlerRegistry(Configuration configuration) {
  // 省略代码
  register(Boolean.class, new BooleanTypeHandler());
  register(boolean.class, new BooleanTypeHandler());
  register(JdbcType.BOOLEAN, new BooleanTypeHandler());
  register(JdbcType.BIT, new BooleanTypeHandler());
  // 省略代码
}

这里我就不一一展示了，感兴趣的小伙伴可以自行查看 TypeHandlerRegistry 构造方法的源码。

objectFactory 元素（对象工厂）

objectFactory 元素用于定义对象工厂，对象工厂用于创建结果集的映射对象，它在 DTD 中的定义如下：

xml 复制代码 
<!ELEMENT objectFactory (property*)>
<!ATTLIST objectFactory
type CDATA #REQUIRED
>

objectFactory 元素本身并没有任何属性，只定义了一个子元素 property，用于定义 objectFactory 的参数。通过 property 元素配置的属性，会在 ObjectFactory 初始化之后通过 ObjectFactory#setProperties方法传递到对象工厂中。

默认情况下（即不配置自定义对象工厂），MyBatis 会使用对象工厂的唯一实现类 DefaultObjectFactory，它的实现非常简单，仅仅是通过反射调用结果集对象的无参构造器完成了对象的实例化，除此之外，并没有额外的处理。

自定义对象工厂

同自定义类型处理器一样，MyBatis 提供了两种自定义对象工厂的方式：

  • 实现 ObjectFactory 接口；
  • 继承 DefaultObjectFactory。

同样的，我们可以选择继承 DefaultObjectFactory 来完成自定义对象工厂，并实现相应的方法即可。接下来，我们写一个比较"荒诞"的需求，因为我实在是没想到太好的自定义对象工厂的实际案例。

这个需求是这样的，为数据库中 user 表的查询结果的 VARCHAR 类型字段添加默认值"wyz"，即 UserDO 实例对象中 String 类型的字段为 NULL 时赋默认值"wyz"。当然实现这个需求我们有好几种方式可以选择，如：通过为数据库中的字段设置默认值，或者为 Java 对象的字段设置默认值来完成。不过这里为了展示 MyBatis 的自定义对象工厂的使用方法，我通过自定义工厂来实现这个需求。

首先，我们为这个自定义工厂命名为 CustomizeObjectFactory，并在 MyBatis 的核心配置 mybatis-config.xml 中配置这个自定义对象工厂，例如：

xml 复制代码 
<configuration>
  <!-- 省略配置 -->
  <objectFactory type="com.wyz.customize.factory.object.CustomizeObjectFactory">
    <property name="default" value="wyz"/>
  </objectFactory>
  <!-- 省略配置 -->
</configuration>

其中子元素 property 中定义了我们将要使用的默认值。

接着我们来完成这个自定义对象工厂，通过继承 DefaultObjectFactory 并实现相应的方法，代码如下：

java 复制代码 
package com.wyz.customize.factory.object;

import com.alibaba.fastjson2.JSON;
import com.wyz.entity.UserDO;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.factory.DefaultObjectFactory;

import java.lang.reflect.Field;
import java.util.List;
import java.util.Properties;

public class CustomizeObjectFactory extends DefaultObjectFactory {
  
    String defaultValue;

    @Override
    public void setProperties(Properties properties) {
        defaultValue = properties.getProperty("default");
    }

    @Override
    public <T> T create(Class<T> type) {
        T t = super.create(type);
        if(type.equals(UserDO.class)) {
            Field[] fields = type.getDeclaredFields();
            for(Field field : fields) {
                if(field.getType().equals(String.class)) {
                    field.setAccessible(true);
                    try {
                        field.set(t, defaultValue);
                    } catch (IllegalAccessException e) {
                        throw new RuntimeException(e);
                    }
                }
            }
        }
        return t;
    }

    @Override
    public <T> T create(Class<T> type, List<Class<?>> constructorArgTypes, List<Object> constructorArgs) {
        return super.create(type, constructorArgTypes, constructorArgs);
    }

    @Override
    protected Class<?> resolveInterface(Class<?> type) {
        return super.resolveInterface(type);
    }

    @Override
    public <T> boolean isCollection(Class<T> type) {
        return super.isCollection(type);
    }
}

可以看到，我重写了ObjectFactory#setProperties方法，并在该方法中为类成员变量 defaultValue 赋值，前面我们提到过，ObjectFactory#setProperties方法的作用时间是在对象工厂初始化完成之后。

接着我重写了其中一个ObjectFactory#create方法，通过super.create调用父类 DefaultObjectFactory 实现的ObjectFactory#create方法完成默认的实例化后，我们判断其类型为 UserDO，并通过反射对 UserDO 实例对象中 String 类型的字段赋默认值。

我们先把数据库中的某些字段修改为 NULL，如：

接着，执行我们的查询全部用户的测试案例，可以看到输出结果中，用户名为小明的用户，他的性别赋上了默认值"wyz"。

通常来说，我们在应用程序中，MyBatis 提供的 DefaultObjectFactory 已经能够满足绝大部分的应用场景了，我们不需要实现自定义对象工厂。

附录：DTD 简介

这部分并不是完整的 DTD 教程，如果想要完成的学习 DTD ，请移步相关教程，本文只对 mybatis-3-confg.dtd 中出现的相关语法做一个简单的介绍。

DTD（Document Type Definition）即文档类型定义，这里我引用维基百科中关于 DTD 的定义：

XML文件的文档类型定义（Document Type Definition）可以看成一个或者多个XML文件的模板，在这里可以定义XML文件中的元素、元素的属性、元素的排列方式、元素包含的内容等等。

DTD 主要用于 XML 文档的结构定义和约束，主要功能包括：

  • 定义 XML 文档中的可使用的元素，元素间的顺序，元素的嵌套关系和元素的属性等；
  • 用于验证 XML 文档的结构，在 XML 文件中引入 DTD，解析器会根据 DTD 的定义验证文档的结构；
  • 约定通过 XML 进行数据交换的标准格式，保证数据交换的正确性。

我们来截取 mybatis-3-config.dtd 的部分内容：

xml 复制代码 
<!ELEMENT configuration (properties?, settings?)>

<!ELEMENT properties (property*)>
<!ATTLIST properties
resource CDATA #IMPLIED
url CDATA #IMPLIED
>

<!ELEMENT property EMPTY>
<!ATTLIST property
name CDATA #REQUIRED
value CDATA #REQUIRED
>

通过一张图来解释下上面 DTD 的内容：

关于 DTD 的内容就简单介绍到这里，已经足够应付 MyBatis 的 DTD 了。

本文为稀土掘金技术社区首发签约文章，30天内禁止转载，30天后未获授权禁止转载，侵权必究！

好了，今天的内容就到这里了，如果本文对你有帮助的话，希望多多点赞支持，如果文章中出现任何错误，还请批评指正。最后欢迎大家关注分享硬核 Java 技术的金融摸鱼侠 王有志，我们下次再见！

热门推荐
01玄机平台应急响应—webshell查杀02Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04智能车联网安全发展形势、挑战05文件或文件夹名称中有空格如何批量去除06组基轨迹建模 GBTM的介绍与实现（Stata 或 R）07【TC3xx芯片】TC3xx芯片电源管理系统PMS详解08优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间09基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测10液体神经网络：LNN是个啥概念？