当前位置：首页 > news >正文

Mybatis配置文件详解

news 来源：原创 2025/5/18 4:06:31

MyBatis通过XML或注解的方式将Java对象与数据库中的记录进行映射，极大地简化了数据访问层的开发。而在MyBatis的核心组成部分中，配置文件扮演着举足轻重的角色。它不仅定义了MyBatis的运行环境，还配置了数据源、事务管理、映射器等关键元素，是确保MyBatis能够正确、高效执行数据库操作的基础。

Mybatis标签说明

标签	说明
properties	加载properties文件
settings	全局配置参数
typeAliases	类型别名
typeHandlers	类型处理器
objectFactory	对象工厂
plugins	插件
environments	环境集合属性对象
transactionManager	事务管理
dataSource	数据源
mappers	映射器

properties属性

在实际开发中,我们通常会将数据库连接参数单独配置在db.properties中，只需要在mybatis-config.xml中加载db.properties的属性值。这样我们在mybatis-config.xml中就不需要对数据库连接参数硬编码。

将数据库连接参数只配置在db.properties中，原因：方便对参数进行统一管理，其它xml可以引用该db.properties。引用之后可以使用${key}来引用值

在resources下面新建db.properties，里面以key-value的方式写上数据库的四个参数：key的值可以任意写（不建议）。

q=com.mysql.jdbc.Driver
w=jdbc:mysql://localhost:3306/test
e=root
r=123456

    <properties resource="db.properties"></properties><environments default="development"><environment id="development"><transactionManager type="JDBC"></transactionManager><dataSource type="POOLED"><property name="driver" value="${q}"/><property name="url" value="${w}"/><property name="username" value="${e}"/><property name="password" value="${r}"/></dataSource></environment></environments>

settings全局参数配置

mybatis框架在运行时可以调整一些运行参数。比如开启二级缓存，开启延迟加载。

配置选项	描述	可选值	默认值
cacheEnabled	全局启用或禁用任何Mapper中配置的缓存	true\|false	true
lazyLoadingEnabled	全局启用或禁用延迟加载。当启用后，所有的关系都将被延迟加载。可以通过使用特定关系上的fetchType属性来取代该值。	true\|false	false
aggressiveLazyLoading	当启用时，具有惰性加载属性的对象将完全在调用任何惰性属性时加载。否则，每个属性都将按需加载。	true\|false	true
multipleResultSetsEnabled	允许或不允许从单个语句返回多个结果集（需要兼容的驱动程序）	true\|false	true
useColumnLabe	使用列标签，而不是列名称。不同的驱动程序在这方面的行为也有所不同。请参考驱动程序文档，或测试这两种模式，以确定驱动程序的行为方式。	true\|false	true
useGeneratedKeys	允许JDBC支持已生成的密钥。这时需要一个兼容的驱动程序。这个设置强制生成的键在设置为true时使用，因为一些驱动程序拒绝兼容性但仍然可以工作(例如Derby)。	true\|false	false
autoMappingBehavior	指定MyBatis是否以及如何自动将列映射到字段/属性。NONE禁用自动映射。PARTIAL只自动映射简单,非嵌套的结果集。FULL将自动映射任何复杂度的结果集（包含嵌套或非嵌套的）。	NONE, PARTIAL, FULL	PARTIAL
defaultExecutorType	配置默认的执行器(Executor): SIMPLE: 简单执行器 REUSE:重用prepared statement的执行器 BATCH:重用statement并且执行批量更新的执行器	SIMPLE REUSE BATCH	SIMPLE
defaultStatementTimeout	设置数据库超时时间(单位:秒)	任何正数	Not Set (null)
safeRowBoundsEnabled	允许在嵌套语句上使用行边界。	true\|false	false
mapUnderscoreToCamelCase	是否开启, 数据库列:A_COLUMN自动映射为属性:aColumn	true\|false	false
localCacheScope	MyBatis使用本地缓存来提高查询效率,本地缓存默认Scope是:SESSION, 在同一次SESSION期间执行的所有查询都将被缓存. localCacheScope=STATEME:本地会话将仅用于stateme的执行,对同一Sql会话的两个不同调用之间将不共享任何数据	SESSION\|STATEMENT	SESSION
jdbcTypeForNull	指定空值的JDBC类型,当没有为参数提供特定的JDBC类型时。一些驱动程序需要指定列JDBC类型,常用的值:NULL,VARCHAR,OTHER	JdbcType enumeration.Most common are: NULL,VARCHAR and OTHER	OTHER
lazyLoadTriggerMethods	指定哪个对象的方法会触发延迟加载	方法名列表,多个方法名之间使用逗号分割	equlas, clone, hashCode, toString
defaultScriptingLanguage	指定动态SQL生成时默认使用的语言。	一个类型的别名或完全限定的类名。
callSettersOnNulls	指定在检索到的值为空时，是否会调用设置器或映射的put方法。当您依赖于Map.keySet()或空值初始化时，它很有用。请注意原语，如（int、布尔值等）。将不会被设置为null。	true\|false	false
logPrefix	指定MyBatis将添加到日志记录器名称中的前缀字符串。	任何字符串	未设置
logImpl	指定MyBatis应该使用哪些日志记录实现类。如果此设置日志记录类不存在，则将自动发现日志记录实现。	SLF4J \| LOG4J \| LOG4J2 \| JDK_LOGGING \| COMMONS_LOGGING \| STDOUT_LOGGING \| NO_LOGGING	为设置
proxyFactory	代理工厂指定MyBatis将用于创建能够实现延迟加载功能的对象的代理工具。	CGLIB\|JAVASSIST

typeAliases类型别名

别名	映射的类型
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal

自定义别名

在mybatis主配置文件设置别名，可以在mapper文件中直接使用别名

    <typeAliases><!-- 为单个类定义别名 --><typeAlias alias="User" type="com.example.domain.User"/><!-- 为指定包下的所有类定义别名，别名默认为类名的首字母小写 --><package name="com.example.domain"/></typeAliases>

mappers映射器

配置mapper时有四种写法，分别是：

<mapper resource= " "/>：使用相对于类路径资源
<mapper url= " "/>：使用完全限定路径
<mapper class= " "/>：使用mapper接口类路径 注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。
<package name= " "/>：注册指定包下面的所有接口 注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。