Mybatis配置文件之<settings>属性配置元素解析

最新推荐文章于 2025-06-11 17:12:24 发布
原创 最新推荐文章于 2025-06-11 17:12:24 发布 · 7.2k 阅读 · 19 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细介绍了MyBatis配置文件中的settings元素，包括各种配置项的意义、默认值及有效值，帮助读者理解并掌握这些配置如何影响MyBatis的运行时行为。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Mybatis配置文件之属性配置元素解析

1. 概述

设置元素在mybatis中最为复杂，同时也是最为重要的配置之一。它会改变mybatis运行时的行为，即使不配置settings元素，mybatis也可以正常运行，不过了解settings的配置内容，对于使用mybatis来说百利而无一害。

2. settings配置属性

settings

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

设置参数描述有效值默认值
cacheEnabled 全局地开启或关闭配置文件中的所有映射器已经配置的任何缓存。 true | false true
lazyLoadingEnabled 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态。 true | false false
aggressiveLazyLoading 当开启时，任何方法的调用都会加载该对象的所有属性。否则，每个属性会按需加载（参考lazyLoadTriggerMethods). true | false false (true in ≤3.4.1)
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: 输出提醒日志 (‘org.apache.ibatis.session.AutoMappingUnknownColumnBehavior’ 的日志等级必须设置为 WARN)
  • FAILING: 映射失败 (抛出 SqlSessionException)
 NONE, WARNING, FAILING NONE
defaultExecutorType 配置默认的执行器。SIMPLE 就是普通的执行器；REUSE 执行器会重用预处理语句（prepared statements）； BATCH 执行器将重用语句并执行批量更新。 SIMPLE REUSE BATCH SIMPLE
defaultStatementTimeout 设置超时时间，它决定驱动等待数据库响应的秒数。 任意正整数 Not Set (null)
defaultFetchSize 为驱动的结果集获取数量（fetchSize）设置一个提示值。此参数只可以在查询设置中被覆盖。 任意正整数 Not Set (null)
safeRowBoundsEnabled 允许在嵌套语句中使用分页（RowBounds）。如果允许使用则设置为false。 true | false False
safeResultHandlerEnabled 允许在嵌套语句中使用分页（ResultHandler）。如果允许使用则设置为false。 true | false True
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 类型，多数情况直接用一般类型即可，比如 NULL、VARCHAR 或 OTHER。 JdbcType 常量. 大多都为: NULL, VARCHAR and OTHER OTHER
lazyLoadTriggerMethods 指定哪个对象的方法触发一次延迟加载。 用逗号分隔的方法列表。 equals,clone,hashCode,toString
defaultScriptingLanguage 指定动态 SQL 生成的默认语言。 一个类型别名或完全限定类名。 org.apache.ibatis.scripting.xmltags.XMLLanguageDriver
defaultEnumTypeHandler 指定 Enum 使用的默认 TypeHandler 。 (从3.4.5开始) 一个类型别名或完全限定类名。 org.apache.ibatis.type.EnumTypeHandler
callSettersOnNulls 指定当结果集中值为 null 的时候是否调用映射对象的 setter（map 对象时为 put）方法，这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意基本类型（int、boolean等）是不能设置成 null 的。 true | false false
returnInstanceForEmptyRow 当返回行的所有列都是空时，MyBatis默认返回null。 当开启这个设置时，MyBatis会返回一个空实例。 请注意，它也适用于嵌套的结果集 (i.e. collectioin and association)。（从3.4.2开始） true | false false
logPrefix 指定 MyBatis 增加到日志名称的前缀。 任何字符串 Not set
logImpl 指定 MyBatis 所用日志的具体实现，未指定时将自动查找。 SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING Not set
proxyFactory 指定 Mybatis 创建具有延迟加载能力的对象所用到的代理工具。 CGLIB | JAVASSIST JAVASSIST (MyBatis 3.3 or above)
vfsImpl 指定VFS的实现 自定义VFS的实现的类全限定名，以逗号分隔。 Not set
useActualParamName 允许使用方法签名中的名称作为语句参数名称。 为了使用该特性，你的工程必须采用Java 8编译，并且加上-parameters选项。（从3.4.1开始） true | false true
configurationFactory 指定一个提供Configuration实例的类。 这个被返回的Configuration实例用来加载被反序列化对象的懒加载属性值。 这个类必须包含一个签名方法static Configuration getConfiguration(). (从 3.2.3 版本开始) 类型别名或者全类名. Not set

一个配置完整的 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="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>
  </div>

3.

【Spring】— MyBatis配置文件元素
衍生星球的博客
05-23 2281
元素的子元素中的type属性用于指定需要被定义别名的类的全限定名；在上述代码中，子元素的name属性用于指定类型处理器所在的包名，使用这种方式后，系统会在启动时自动扫描com.ssm.type包下所有的文件，并把它们作为类型处理器。中的name属性用于指定要被定义别名的包，MyBatis会将所有com.ssm.po包中的POJO类以首字母小写的非限定类名作为它的别名。使用MyBatis框架进行开发，需要创建MyBatis的核心配置文件，该配置文件包含重要的元素，熟悉配置文件中各个元素的功能十分重要。
【MyBatis框架】核心配置文件讲解
一个真ikun
10-19 2586
本篇详细介绍了MyBatis框架的核心配置文件，以及各个配置元素的作用。
MyBatis源码--解析mybatis-config.xml
蜗牛人生
03-16 648
查询数据库操作步骤如下： Reader reader = Resources.getResourceAsReader("mybatis-config.xml"); sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);//初始化configuration reader.close(); SqlSession sqlS...
Mybatis（二）-----settings配置
热门推荐
沐淼的博客
09-12 1万+
<!-- MyBatis 利用本地缓存机制（Local Cache）防止循环引用（circular references）和加速重复嵌套查询。 默认值为 SESSION，这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT，本地会话仅用在语句执行上，对相同 SqlSession 的不同调用将不会共享数据。 -->
MyBatis实战指南（六）自动映射
2402_83322742的博客
06-11 1569
本文深入解析MyBatis自动映射机制，主要涵盖以下内容： 自动映射概念：将数据库字段自动填充到Java对象对应属性 核心配置项详解： mapUnderscoreToCamelCase：下划线转驼峰命名 autoMappingBehavior：控制自动映射范围（NONE/PARTIAL/FULL） autoMappingUnknownColumnBehavior：处理未知列策略 实战配置示例与建议 开发阶段建议启用WARNING级别日志 简单项目可开启FULL自动映射 复杂查询建议明确定义resultMap
MyBatis全局配置文件中的设置（settings）
weixin_45738468的博客
10-19 2309
Mybatis配置项–settings 1. settings的作用 settings是MyBatis中极为重要的调整设置，会改变Mybatis的运行时行为。 2.settings的设置 <settings> <setting name="cacheEnabled" value="true"/> <setting name="lazyLoadingEnabled" value="true"/> <setting name="multipleResultSet
Mybatis配置文件（二）：Settings配置
weixin_42762407的博客
12-25 601
Settings是MyBatis中最复杂的配置，它们会修改MyBatis运行时的行为方式，大多数采用默认值即可，一般会修改的有：自动映射、驼峰命名映射、是否启动缓存等。 下表的设置信息来自于mybatis 官方文档： 设置参数 描述 有效值 默认值 cacheEnabled 这个配置使全局的映射器启用或禁用缓存。 true | false true lazyLoadingEna...
Mybatis Settings
小丸子
02-20 865
1.cacheEnabled  要不要用一级二级缓存？  默认值true.      * 一级缓存: 也就 Session 级的缓存(默认开启)     */     @Test     public void testCache1() {     SqlSession session = MybatisUtils.getSession();     String stateme
MyBatis核心配置文件详解：从层级关系到实战配置
F2022697486的博客
02-06 939
作用：处理 JDBC 类型与 Java 类型间的转换，例如日期格式、枚举类型。示例：自定义处理器：public class LocalDateTimeTypeHandler extends BaseTypeHandler<LocalDateTime> {// 实现类型转换逻辑</MyBatis 的配置文件通过层级化的结构，将数据源、事务、类型处理、SQL 映射等模块解耦，开发者只需按需配置即可快速集成。理解每个元素的作用及优先级，能够避免常见的配置错误，并灵活应对多环境、多数据库等复杂场景。附录。
检查我的pom.xml文件 <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.4.4</version> <relativePath/> <!-- lookup parent from repository --> </parent> <groupId>com.example</groupId> <artifactId>batis623</artifactId> <version>0.0.1-SNAPSHOT</version> <name>batis623</name> <description>batis623</description> <properties> <java.version>17</java.version> </properties> <dependencies> <!-- Spring Boot Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <!-- Spring Boot Starter Test --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <!-- MyBatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.13</version> </dependency> <!-- MySQL Connector --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> </dependency> <!-- JUnit 4 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <version>5.8.2</version> <scope>test</scope> </dependency> <dependency> <groupId>org.testng</groupId> <artifactId>testng</artifactId> <version>RELEASE</version> <scope>compile</scope> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> </dependency> </dependencies> <build> <plugin
04-03
<think>嗯，用户的问题是关于如何验证他们的pom.xml文件是否正确配置，特别是包含了Spring Boot、MyBatis以及测试框架的设置。首先，我需要回忆一下Maven项目中pom.xml的基本结构和常见依赖项的配置方式。 首先，...
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.6.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <groupId>com.xq.tmall</groupId> <artifactId>tmall</artifactId> <version>1.0-SNAPSHOT</version> <packaging>jar</packaging> <name>tmall</name> <description>Demo project for Spring Boot</description> <properties> <java.version>1.8</java.version> <mybatisplus-spring-boot-starter.version>1.0.5</mybatisplus-spring-boot-starter.version> <mybatisplus.version>2.3.1</mybatisplus.version> <poi.version>3.9</poi.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> <optional>true</optional> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <!-- 添加Servlet依赖模块 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <scope>provided</scope> </dependency> <!-- 添加JSTL标签库依赖模块 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> </dependency> <!-- 使用JSP引擎，SpringBoot内置Tomcat没有此依赖 --> <dependency> <groupId>org.apache.tomcat.embed</groupId> <artifactId>tomcat-embed-jasper</artifactId> <scope>provided</scope> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.13</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.83</version> </dependency> <!-- swagger2生成api文档 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> <!-- mybatis-plus begin --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatisplus-spring-boot-starter</artifactId> <version>${mybatisplus-spring-boot-starter.version}</version> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus</artifactId> <version>${mybatisplus.version}</version> </dependency> <!-- mybatis-plus end --> <!-- commons --> <dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.6</version> </dependency> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.3</version> </dependency> <dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.2</version> </dependency> <!-- Mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.4.5</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.3.1</version> </dependency> <!-- lombok --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <!-- log4j --> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.10.0</version> </dependency> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-api</artifactId> <version>RELEASE</version> <scope>test</scope> </dependency> <!-- 支付宝支付 --> <dependency> <groupId>com.alipay.sdk</groupId> <artifactId>alipay-sdk-java</artifactId> <version>4.33.10.ALL</version> </dependency> <!-- 微信支付 --> <dependency> <groupId>com.github.wechatpay-apiv3</groupId> <artifactId>wechatpay-apache-httpclient</artifactId> <version>0.4.8</version> </dependency> <dependency> <groupId>com.github.binarywang</groupId> <artifactId>weixin-java-pay</artifactId> <version>4.3.8.B</version> </dependency> <!-- hutool --> <dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-all</artifactId> <version>5.8.5</version> </dependency> <!-- Redis --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> <!-- poi office --> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>${poi.version}</version> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>${poi.version}</version> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml-schemas</artifactId> <version>${poi.version}</version> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <version>1.4.2.RELEASE</version> </plugin> </plugins> <resources> <!-- 打包时将jsp文件拷贝到META-INF目录下--> <resource> <!-- 指定resources插件处理哪个目录下的资源文件 --> <directory>src/main/webapp</directory> <!-- 注意必须要放在此目录下才能被访问到 --> <targetPath>META-INF/resources</targetPath> <filtering>false</filtering> <includes> <include>**/**</include> </includes> </resource> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> </resources> </build> </project>
最新发布
06-25
###解决方案详细步骤####1.**更新Lombok版本**-在Maven项目中，修改`pom.xml`文件中的Lombok依赖版本：```xml<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.34</...
MyBatis的setting标签对应属性和值
04-05
MyBatis的setting标签对应属性和值
mybatis配置setting
water_java的博客
11-18 316
① cacheEnabled 说明：该配置影响的所有映射器中配置的缓存的全局的开关 默认值为true 有效值：true/false ② lazyLoadingEnabled 说明：延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。特定关联对象中可以通过设置fetcType属性来覆盖该项的开关状态 默认值为false 有效值：true/false ③ aggressiveLazyLoadi...
mybatis-config配置setting说明
CaptainUsop的博客
07-19 1812
转自：https://blog.youkuaiyun.com/u010987379/article/details/52095695   1.       &lt;!– 配置设置 –&gt;   2.           &lt;settings&gt;   3.               &lt;!– 配置全局性 cache 的 ( 开 / 关) default:true –&gt;   4. ...
mybatis 配置_MyBatis配置文件详解
weixin_40004051的博客
12-05 229
MyBatis 的配置文件包含了会影响 MyBatis 行为的设置和属性信息，决定了mybatis的运行轨迹，能充分了解这些配置的以及配置所带来的的影响，你就是大神！配置文件的根节点是configuration，他的子孙节点有：properties(属性)settings(设置)typeAliases(类型别名)typeHandlers(类型处理器)objectFactory(对象工厂)plugi...
MyBatis 配置 setting 详解
发哥微课堂
06-21 1万+
0x00：前言参考 之前的《MyBatis 中 SqlMapConfig 配置文件详解》记了一下 MyBatis 中的核心配置文件各个标签的作用和使用场景，这篇文章细说一下配置文件中 setting 标签的详细使用。 0x01：标签介绍 setting 标签的配置是配置 MyBatis 框架运行时的一些行为的，例如缓存、延迟加载、结果集控制、执行器、分页设置、命名规则等一系列控制性参数，其所...
mybatis启动过程分析五setting解析
zhenghuangyu的博客
12-16 248
objectFactory和objectWrapperFactory平时用的很少主要是mybatis内部反射用，几乎不会涉及暂不分析，后面有空补上。 本章分析setting分析 configuration.setAutoMappingBehavior(AutoMappingBehavior.valueOf(props.getProperty(&quot;autoMappingBehavior&quot;, &quot;PART...
MyBatis--settings属性配置详解
吴声子夜歌的博客
10-26 1789
settings 在 MyBatis 中 settings 是最复杂的配置，它能深刻影响 MyBatis 底层的运行，但是在大部分情况下使用默认值便可以运行，所以在大部分情况下不需要大量配置它，只需要修改一些常用的规则即可，比如自动映射、驼峰命名映射、级联规则、是否启动缓存、执行器（Executor）类型等。settings 配置项说明，如下表所示： 配置项 作用 配置选项 默认值 ...
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值