<settings>元素 - java学习教程_ java培训机构_java编程思想

<settings>元素主要用于改变MyBatis运行时的行为，例如开启二级缓存、开启延迟加载等。虽然不配置<settings>元素，也可以正常运行MyBatis，但是熟悉<settings>的配置内容以及它们的作用还是十分必要的。

<settings>元素中的常见配置及其描述如表1所示。

表1 <settings>元素中的常见配置

设置参数	描述	有效值	默认值
cacheEnabled	该配置影响所有映射器中配置的缓存全局开关。	true\|false	true
lazyLoadingEnabled	延迟加载的全局开关。开启时，所有关联对象都会延迟加载。特定关联关系中可以通过设置fetchType属性来覆盖该项的开关状态。	true\|false	false
aggressiveLazyLoading	关联对象属性的延迟加载开关。当启用时，对任意延迟属性的调用会使带有延迟加载属性的对象完整加载；反之，每种属性会按需加载。	true\|false	true
multipleResultSetsEnabled	是否允许单一语句返回多结果集（需要兼容驱动）。	true\|false	true
useColumnLabel	使用列标签代替列名。不同的驱动在这方面有不同的表现。具体可参考驱动文档或通过测试两种模式来观察所用驱动的行为。	true\|false	true
useGeneratedKeys	允许JDBC支持自动生成主键，需要驱动兼容。如果设置为true，则这个设置强制使用自动生成主键，尽管一些驱动不兼容但仍可正常工作。	true\|false	false
autoMappingBehavior	指定MyBatis应如何自动映射列到字段或属性。NONE表示取消自动映射； PARTIAL只会自动映射没有定义嵌套结果集映射的结果集； FULL会自动映射任意复杂的结果集（无论是否嵌套）。	NONE、 PARTIAL、 FULL	PARTIAL
defaultExecutorType	配置默认的执行器。SIMPLE就是普通的执行器；REUSE执行器会重用预处理语句（prepared statements）；BATCH执行器将重用语句并执行批量更新。	SIMPLE、 REUSE、 BATCH	SIMPLE
defaultStatementTimeout	设置超时时间，它决定驱动等待数据库响应的秒数。当没有设置的时候，它取的就是驱动默认的时间。	任何正整数	没有设置
mapUnderscoreToCamelCase	是否开启自动驼峰命名规则（camel case）映射	true\|false	false
jdbcTypeForNull	当没有为参数提供特定的JDBC类型时，为空值指定JDBC类型。某些驱动需要指定列的JDBC类型，多数情况直接用一般类型即可，比如NULL、VARCHAR或OTHER。	NULL、 VARCHAR、 OTHER	OTHER

表1中介绍了<settings>元素中的常见配置，这些配置在配置文件中的使用方式如下：

<!-- 设置 -->
<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" />
    ...
</settings>

上面所介绍的配置内容大多数都不需要开发人员去配置它，通常在需要时只配置少数几项即可。这里读者只需要了解这些可设置的参数值及其含义即可。