在 MyBatis 中 settings 是最复杂的配置,它能深刻影响 MyBatis 底层的运行,但是在大部分情况下使用默认值便可以运行,所以在大部分情况下不需要大量配置它,只需要修改一些常用的规则即可,比如自动映射、驼峰命名映射、级联规则、是否启动缓存、执行器(Executor)类型等。settings 配置项说明,如表 1 所示。
表 1 settings 配置项说明
配置项 |
作用 |
配置选项 |
默认值 |
cacheEnabled |
该配置影响所有映射器中配置缓存的全局开关 |
true|false |
true |
lazyLoadingEnabled |
延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。在特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态 |
true|false |
false |
aggressiveLazyLoading |
当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载;反之,每种属性将会按需加载 |
true|felse |
版本3.4.1 (不包含)
之前 true,之后 false |
multipleResultSetsEnabled |
是否允许单一语句返回多结果集(需要兼容驱动) |
true|false |
true |
useColumnLabel |
使用列标签代替列名。不同的驱动会有不同的表现,具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果 |
true|false |
true |
useGeneratedKeys |
允许JDBC 支持自动生成主键,需要驱动兼容。如果设置为 true,则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby) |
true|false |
false |
autoMappingBehavior |
指定 MyBatis 应如何自动映射列到字段或属性。
NONE 表示取消自动映射。
PARTIAL 表示只会自动映射,没有定义嵌套结果集和映射结果集。
FULL 会自动映射任意复杂的结果集(无论是否嵌套) |
NONE、PARTIAL、FULL |
PARTIAL |
autoMappingUnkno wnColumnBehavior |
指定自动映射当中未知列(或未知属性类型)时的行为。 默认是不处理,只有当日志级别达到 WARN 级别或者以下,才会显示相关日志,如果处理失败会抛出 SqlSessionException 异常 |
NONE、WARNING、FAILING |
NONE |
defaultExecutorType |
配置默认的执行器。SIMPLE 是普通的执行器;REUSE 会重用预处理语句(prepared statements);BATCH 执行器将重用语句并执行批量更新 |
SIMPLE、REUSE、BATCH |
SIMPLE |
defaultStatementTimeout |
设置超时时间,它决定驱动等待数据库响应的秒数 |
任何正整数 |
Not Set (null) |
defaultFetchSize |
设置数据库驱动程序默认返回的条数限制,此参数可以重新设置 |
任何正整数 |
Not Set (null) |
safeRowBoundsEnabled |
允许在嵌套语句中使用分页(RowBounds)。如果允许,设置 false |
true|false |
false |
safeResultHandlerEnabled |
允许在嵌套语句中使用分页(ResultHandler)。如果允许,设置false |
true|false |
true |
mapUnderscoreToCamelCase |
是否开启自动驼峰命名规则映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射 |
true|false |
false |
|
发表评论