settings 中的设置是非常关键的,它们会改变 MyBatis 的运行时行为。下表描述了设置中各项的意图、默认值等。
设置参数 | 含义 | 描述 | 有效值 | 默认 |
---|---|---|---|---|
cacheEnabled | 是否使用缓存 | 是整个工程中所有映射器配置缓存的开关,既是一个全局缓存开关 | true\false | true |
lazyLoadingEnabled | 是否开启延迟加载 | 控制全局是否使用延迟加载。当开启时,所有关联对象都会延迟加载。当有特殊关联关系需要单独配置时,可以使用fedchType属性来覆盖此配置 | true\false | false |
aggressiveLazyLoading | 是否按需加载属性 | 开启式,不论调用什么方法加载某个对象,都会加载该对象的所有属性,关闭之后只会按需加载 | true\false | true |
multipleResultSetsEnabled | 是否允许单一语句返回多个结果集(需要兼容驱动) | 即Mapper配置中一个单一的sql配置是否能返回多个结果集 | true\false | true |
useColumnLabel | 使用列标签代替列名 | 设置是否使用列标签代替列名,不同的驱动在这方面会有不同的表现,具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。 | true\false | true |
useGeneratedKeys | 是否支持JDBC自动生成组件 | 设置后将会强制使用自动生成主键的策略。允许 JDBC 支持自动生成主键,需要驱动兼容。如果设置为 true 则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby)。 | true\false | false |
autoMappingBehavior | 指定MyBaits自动映射字段或属性的方式 | 有三种方式:NONE 表示取消自动映射;PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。FULL 会自动映射任意复杂的结果集(包括嵌套和其他情况)。 | NONE \ PARTIAL \ FULL | PARTIAL |
defaultExecutorType | 设置默认的执行器 | 有三种执行器,SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(prepared statements);BATCH 执行器将重用语句并执行批量更新。 | SIMPLE \ REUSE \ BATCH | SIMPLE |
defaultStatementTimeout | 设置超时时间 | 该超市时间即数据库驱动连接数据库是,等待数据库回应的最大秒数。它决定驱动等待数据库响应的秒数。 | 任意正整数 | 无 |
defaultFetchSize | 设置驱动的结果集 | 为了防止从数据库查询出来的结果过多,而导致内存溢出可以通过设置fetchSize参数来控制结果集的数量 | 任意正整数 | 无 |
safeRowBoundsEnabled | 允许在嵌套语句中使用分页(RowBounds),即结果集处理 | 如果允许在sql内行嵌套语句中使用分页就设置该值为false | true\false | false |
mapUnderscoreToCamelCase | 是否开启自动驼峰命名规则(camel case)映射 | 即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。 | true \ false | false |
localCacheScope | MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询 | 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。 | SESSION \ STATEMENT | SESSION |
jdbcTypeForNull | JDBC类型的默认设置 | 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。 | JDBC类型枚举。最常见的是: NULL, VARCHAR 、OTHER | OTHER |
lazyLoadTriggerMethods | 指定哪个对象的方法触发一次延迟加载 | 配置需要触发延迟加载的方法和名字,该方法就会触发一次延迟加载 | 用逗号分隔的方法名列表 | equals,clone,hashCode,toString |
defaultScriptingLanguage | 动态sql默认语言 | 指定动态 SQL 生成的默认语言。 | 一个类型别名或者一个类的全路径名 | org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver |
callSettersOnNulls | 是否在空值情况下调用Set方法 | 指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意原始类型(int、boolean等)是不能设置成 null 的。 | true \ false | false |
logPrefix | 日志前缀 | 指定 MyBatis 增加到日志名称的前缀。 | Any String | Not set |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J \ LOG4J \ LOG4J2 \ JDK_LOGGING \ COMMONS_LOGGING \ STDOUT_LOGGING \ NO_LOGGING | Not set | |
proxyFactory | 为 Mybatis 用来创建具有延迟加载能力的对象设置代理工具。 |
配置一个完整的 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"/>
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="30"/>
<setting name="defaultFetchSize" value="200"/>
<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>
转载
https://blog.csdn.net/fageweiketang/article/details/80767532
https://www.cnblogs.com/LingCoder/p/9063730.html
网友评论