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

Mybatis配置文件解析（详细）

article 2026/2/22 3:36:10

引言

在了解Mybatis如何帮助客户进行数据的存取后，便对Mybatis的配置文件起了兴趣，在查阅官方文档后，总结了平时能用到的配置，希望能对大家有帮助

1.核心配置文件

主要是指Mybatis-config.xml中其包含了会深深影响Mybatis行为的设置与属性信息

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- ...-->
</configuration>

2.environments(环境配置)

概述：Mybatis可以配置成多种环境，但是每一个SqlSessionFactory实例只能选择一种环境，

以下代码里有环境development和test，默认是development环境

<environments default="test"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><property name="username" value="root"/><property name="password" value="211314"/></dataSource></environment><environment id="test"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis"/><property name="username" value="root"/><property name="password" value="211314"/></dataSource></environment>
</environments>

2-1.transcationManager(事务管理器)

在Mybatis中有两种类型的事务管理器（也就是type = "[JDBC | MANAGED]"）

JDBC-这个配置直接使用了JDBC的提交和回滚设施，它依赖从数据源获得的链接来管理事务作用域
MANAGED – 这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。默认情况下它会关闭连接。然而一些容器并不希望连接被关闭，因此需要将 closeConnection 属性设置为 false 来阻止默认的关闭行为。

例如

<transactionManager type="MANAGED"><property name="closeConnection" value="false"/>
</transactionManager>

2-2.dataSource（数据源）

作用：连接数据库 dbcp cp30 druid

dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

大多数 MyBatis 应用程序会按示例中的例子来配置数据源。虽然数据源配置是可选的，但如果要启用延迟加载特性，就必须配置数据源。

有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）

mybatis默认的事务管理器就是JDBC，连接池就是POOLED

3.properties(属性)

可以通过properties属性来实现引用配置文件这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置（即db.properties）

注：在xml中，所有的标签都可以规定其顺序

编写一个配置文件

driver = com.mysql.jdbc.Driver
url = jdbc:mysql://localhost:3306/mybatis?useSSL=true?useUnicode=true&characterEncoding=UTF-8
username = root
password = 211314

在核心配置文件映入

<!--   映入外部配置文件--><properties resource="db.properties"><property name="username" value="root"/><property name="password" value="211314"/></properties>

可以直接引入外部文件
可以在其中增加一些属性配置
如果两个文件有同一个字段，优先使用外部配置文件

注：外部配置文件的优先级比在xml文件中写的配置优先级更高

4.类型别名（typeAliases）

类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置，
存在的意义就是降低冗余的全限定类名书写。

<!--    可以给实体类起别名--><typeAliases><typeAlias type="com.lyc.pojo.User" alias="User"/></typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean,每一个在包 domain.blog 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。比如 domain.blog.Author 的别名为 author；

 <typeAliases><package name="com.lyc.pojo"/></typeAliases>

也可以使用注解@Alias("user")

@Alias("user")
public class User {private int id;private String name;private String pwd;
}

注：在实体类比较少的时候，使用第一种方式

如果实体类十分多，可以用第二种

5.设置（settings）

是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。下表描述了平时能用到设置中各项设置的含义、默认值等。

cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。	true \| false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。特定关联关系中可通过设置 `fetchType` 属性来覆盖该项的开关状态。	true \| false	false

logImpl

指定 MyBatis 所用日志的具体实现，未指定时将自动查找。

6.映射器（mappers）

MapperRegistry:绑定注册我们的Mapper文件；（没有绑定会报这个错误）

org.apache.ibatis.binding.BindingException: Type interface com.lyc.mapper.UserMapper is not known to the MapperRegistry.

//方式一：
//每一个mapper.xml都需要在Mybatis核心配置文件中注册
<mappers><mapper resource="com/lyc/mapper/UserMapper.xml"/>
</mappers>//方式二：<mappers>
<!--        <mapper resource="com/lyc/mapper/UserMapper.xml"/>--><mapper class="com.lyc.mapper.UserMapper"/></mappers>
//方式三：<mappers>
<!--        <mapper resource="com/lyc/mapper/UserMapper.xml"/>-->
<!--        <mapper class="com.lyc.mapper.UserMapper"/>--><package name="com.lyc.mapper"/></mappers>

注意点：

接口和它的Mapper配置文件必须同名
接口和它的配置文件必须在同一个包下

7.生命周期和作用域

生命周期、作用域是至关重要的，因为错误的使用会导致非常严重的并发问题

SqlSessionFactoryBuilder

一旦创建了sqlSessionFactory，就不需要他了，它的作用域就是局部变量

SqlSessionFactory

可以想象成数据库连接池，用完还可以循环利用
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另外一个实例
最简单的就是用单例模式或静态单例模式

SQLSession

连接到连接池的一个请求
SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
用完之后要赶紧关闭，否则被占用资源
最合适的

try (SqlSession session = sqlSessionFactory.openSession()) {// 你的应用逻辑代码
}
finally{
session.close();
}

这里面的每一个Mapper，就代表一个具体的业务

小结：

以上就是平时可以用到的配置文件解析，希望帮助到大家！！！

引言