9.2.3 settings设置

发表于 更新于 分类于 ， ， Waline： 本文字数： 2.9k 阅读时长 ≈ 3 分钟

9.2 深入Mybatis配置文件 9.2.3 settings设置

MyBatis的配置文件包含了影响MyBatis行为的信息。文档的结构如下:

  • 顶层configuration配置
  • properties属性
  • settings设置
  • typeAliases类型命名
  • typeHandlers类型处理器
  • objectFactory对象工厂
  • plugins插件
  • environments环境
  • environment环境变量
  • transactionManager事务管理器
  • dataSource数据源
  • databaseldProvider数据库厂商标识
  • mappers映射器

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

表9.1 settings设置的详细说明


设置参数 描述 有效值 默认值
cacheEabled 该配置影响所有映射器中配置的缓存的全局开关 true|false true
lazyLoadingEnabled 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态 true,false false
aggressiveLazyLoading 当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载:反之,每种属性将会按需加载 true,false true
multipleResultSetsEnabled 是否允许单一语句返回多结果集(需要兼容驱动) true|false true
useColumnLabel 使用列标签代替列名。不同的驱动在这方面会有不同的表现，具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果 true|false true
useGeneratedKeys 允许JDBC支持自动生成主键，需要驱动兼容。如果设置为true则这个设置强制使用自动生成主键，尽管一些驱动不能兼容但仍可正常工作（比如Derby) true|false false
autoMappingBehavior 指定MyBatis应如何自动映射列到字段或属性。NONE表示取消自动映射；PARTIAL只会自动映射没有定义嵌套结果集映射的结果集。FULL会自动映射任意复杂的结果集（无论是否嵌套） NONE|PARTIAL|FULL PARTIAL
autoMappingUnknownColumnBehavior NONE:什么都不做；WARNING:输出警告；FAILING:映射失败，抛出SqlSessionException; NONE|WARNING|FAILING NONE
defaultExecutorType 配置默认的执行器。SIMPLE就是普通的执行器；REUSE执行器会重用预处理语句(prepared statements);BATCH执行器将重用语句并执行批量更新 SIMPLE|REUSE|BATCH SIMPLE
defaultStatementTimeout 设置超时时间，它决定驱动等待数据库响应的秒数 integer 没有设置(null)
defaultFetchSize 默认返回的结果集的大小 integer 没有设置(null)
safeRowBoundsEnabled 允许在嵌套语句中使用分页(RowBounds) true|false false
mapUnderscoreToCamelCase 是否开启自动驼峰命名规则(camelcase)映射 true|false false
localCacheScope MyBatis利用本地缓存机制(LocalCache)防止循环引用(circularreferences)和加速重复嵌套查询。默认值为SESSION,这种情况下会缓存一个会话中执行的所有查询。若设置值为STATEMENT,则本地会话仅用在语句执行上，对相同SqlSession的不同调用将不会共享数据 SESSION|STATEMENT SESSION
jdbcTypeForNull 当没有为参数提供特定的JDBC类型时，为空值指定JDBC类型。某些驱动需要指定列的DBC类型，多数情况直接用一般类型即可，比如NULL、VARCHAR或OTHER NULL|VARCHAR|OTHER OTHER
lazyLoadTriggerMethods 指定哪个对象的方法触发一次延迟加载 方法名的list集合 equals,clone,hashCode,toString
defaultScriptingLanguage 指定动态SQL生成的默认语言 一个类型别名或完全限定类名 org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver
callSettersOnNulls 指定当结果集中值为null时是否调用映射对象的setter(map对象时为put)方法，这对于有Map.keySetO依赖或null值初始化时是有用的。注意基本类型(int、boolean等)是不能设置成null的 true|false false
logPrefix 指定MyBatis增加到日志名称的前缀 String 没有设置（null）
logImpl 指定MyBatis所用日志的具体实现未指定时将自动查找 SLF4J
|LOG4J
|LOG4J2
|JDK_LOGGING
|COMMONS_LOGGING
|STDOUT_LOGGING
|NO_LOGGING		 没有设置(null)
proxyFactory 指定MyBatis创建具有延迟加载能力的对象所用到的代理工具 CGLIB|JAVASSIST JAVASSIST(MyBatis 3.3 or above)

实例

在MyBatis配置文件mybatis-config.xml中设置日志实现,如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<!-- XML 配置文件包含对 MyBatis 系统的核心设置 -->
<configuration>
    ......
    <!-- 指定 MyBatis 所用日志的具体实现 -->
    <settings>
        <setting
            name="logImpl"
            value="LOG4J"/>
    </settings>
    ......
</configuration>