Mybatis实战 之 Settings

Mybatis实战 之 Settings

本章节我们将详细学习Mybatis 的全局配置文件。

---

实例

• Mybatis 配置文件模板参考地址(中文版的)：MybatisConfig.xml

• 配置结构：

  • configuration：全局配置标签

    • properties(属性配置，连接数据库的配置)
      连接数据库的配置可以使静态的也可以是动态的。

      • static Connection

        <properties resource="org/mybatis/example/config.properties">
          <property name="username" value="dev_user"/>
          <property name="password" value="F2Fa3!33TYyg"/>
        properties>

      • dynamic Connnection(一般结合连接池使用，且配置了基本的dbConfig.properties)
        

        <properties resource="org/mybatis/example/config.properties">
          <property name="username" value="${username}"/>
          <property name="password" value="${password}"/>
        properties>

    • settings(常规设置)

      这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。下表描述了设置中各项的意图、默认值等。

      <settings>
        <setting name="cacheEnabled" value="true"/>
        <setting name="lazyLoadingEnabled" value="true"/>
        <setting name="multipleResultSetsEnabled" value="true"/>
        <setting name="useColumnLabel" value="true"/>
        <setting name="useGeneratedKeys" value="false"/>
        <setting name="autoMappingBehavior" value="PARTIAL"/>
        <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
        <setting name="defaultExecutorType" value="SIMPLE"/>
        <setting name="defaultStatementTimeout" value="25"/>
        <setting name="defaultFetchSize" value="100"/>
        <setting name="safeRowBoundsEnabled" value="false"/>
        <setting name="mapUnderscoreToCamelCase" value="false"/>
        <setting name="localCacheScope" value="SESSION"/>
        <setting name="jdbcTypeForNull" value="OTHER"/>
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
      settings>

      这里不赘述，请参考源生配置文件。

    • typeAliases(POJO 类型别名设置)

      类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。

      • 常规设置(为每一个POJO 设置一个别名以便Mapper.xml 文件引用)

        <typeAliases>
          <typeAlias alias="Author" type="domain.blog.Author"/>
          <typeAlias alias="Blog" type="domain.blog.Blog"/>
          <typeAlias alias="Comment" type="domain.blog.Comment"/>
          <typeAlias alias="Post" type="domain.blog.Post"/>
          <typeAlias alias="Section" type="domain.blog.Section"/>
          <typeAlias alias="Tag" type="domain.blog.Tag"/>
        typeAliases>

      • 也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean

        <typeAliases>
          <package name="com.sstps.vo"/>
        typeAliases>

        此时com.sstps.vo包下的每一个实体类都将获得一个属于各自的实体别名即各自类名(第一个字母小写的规则)

      • 在JAVA 代码中知名实体别名(需要使用@Alias注解)

        @Alias("author")
        public class Author {
            ...
        }

    • typeHandlers(类型处理器设置)
      无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时， 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。

      通过类型处理器的泛型，MyBatis 可以得知该类型处理器处理的 Java 类型，不过这种行为可以通过两种方法改变。

      • 在类型处理器的配置元素（typeHandler element）上增加一个 javaType 属性（比如：javaType=”String”）

      • 在类型处理器的类上（TypeHandler class）增加一个 @MappedTypes 注解来指定与其关联的 Java 类型列表。 如果在 javaType 属性中也同时指定，则注解方式将被忽略

      可以通过两种方式来指定被关联的 JDBC 类型：

      • 在类型处理器的配置元素上增加一个 jdbcType 属性（比如：jdbcType=”VARCHAR”）

      • 在类型处理器的类上（TypeHandler class）增加一个 @MappedJdbcTypes 注解来指定与其关联的 JDBC 类型列表。 如果在 jdbcType 属性中也同时指定，则注解方式将被忽略。

    • objectFactory(对象工厂设置)

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

      • JAVA 代码

        // ExampleObjectFactory.java
        public class ExampleObjectFactory extends DefaultObjectFactory {
          public Object create(Class type) {
            return super.create(type);
          }
          public Object create(Class type, List constructorArgTypes, List