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

MyBatis02-mybatis-config.xml配置文件讲解

news 2025/7/12 12:40:14

mybatis-config.xml 是 MyBatis 的核心配置文件，用于配置整个 MyBatis 框架的全局行为，比如环境（数据源）、事务、类型别名、插件、Mapper 映射等。

示例：

<?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><!-- 映入外部的properties文件 --><properties resource="db.properties"/><!-- 开启Mybatis对标准日志的视线 --><settings><setting name="logImpl" value="SLF4J"/></settings><environments default="development"><!-- 每一个environment对应一个SqlSessionFactory --><environment id="development"><!-- 事务管理器 --><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments><!-- 执行XxxMapper.xml文件的路径 --><!-- resource路径自动会从根路径下开始查找资源 --><mappers><mapper resource="CarMapper.xml"/></mappers>
</configuration>

一、xml配置文件的开头：

1、任意的xml文件的首行，都是如下的配置：

<?xml version="1.0" encoding="UTF-8" ?>

2、xml文件中根标签的名字

3、dtd是对xml文件的约束：能有什么标签，标签的顺序，标签的属性，有哪些子标签......

二、<environments>：环境标签

可以配置多个环境，一个环境对应一个sqlsessionFactory对象。

在java中创建sqlSessionFactory的时候，可以指定环境的id，表明，用哪一个数据库创建的sqlSessionFactory：

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();// 两种方式创建sqlSessionFactory
// 1、没有指明具体的environment中的id，则用默认的environment
SqlSessionFactory sqlSessionFactory1 = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));// 2、指明具体的environment中的id
SqlSessionFactory sqlSessionFactory2 = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"),

三、Mybatis的事务管理器

<transactionManager>标签：

1、作用：配置事务管理器。指定mybatis具体使用什么方式去管理事务。

2、type属性有两个值：

第一个：JDBC：使用原生的JDBC代码来管理事务。

第二个：MANAGED：mybatis不再负责事务的管理，将事务管理交给其它的JEE(JavaEE)容器来管理。例如：spring

3、大小写无所谓。不区分大小写。但是不能写其他值。只能是二选一： jdbc、managed

4、在mybatis中提供了一个事务管理器接口：Transaction 该接口下有两个实现类：

JdbcTransaction
ManagedTransaction

如果type="JDBC"，那么底层会实例化JdbcTransaction对象。

如果type="MANAGED"，那么底层会实例化ManagedTransaction。

四、dataSource配置

3-1、基本配置介绍

1、dataSource被称为数据源。

2、dataSource作用是什么？

为程序提供Connection对象。

【注意】：
但凡是给程序提供Connection对象的，都叫做数据源。

3、数据源实际上是一套规范（接口）。

JDK中有这套规范：javax.sql.DataSource（这个数据源的规范，这套接口实际上是JDK规定的。）

4、我们自己也可以编写数据源组件，只要实现javax.sql.DataSource接口就行了。实现接口当中所有的方法。这样就有了自己的数据源。

比如你可以写一个属于自己的数据库连接池（数据库连接池是提供连接对象的，所以数据库连接池就是一个数据源）。

5、常见的数据源组件有哪些呢【常见的数据库连接池有哪些呢】？

阿里巴巴的德鲁伊连接池：druid

c3p0

dbcp

....

6、type属性用来指定数据源的类型，就是指定具体使用什么方式来获取Connection对象：

type属性有三个值：必须是三选一。

type="[UNPOOLED|POOLED|JNDI]"

UNPOOLED：不使用数据库连接池技术。每一次请求过来之后，都是创建新的Connection对象。
POOLED：使用mybatis自己实现的数据库连接池。
JNDI：集成其它第三方的数据库连接池。

3-2、JNDI

JNDI是一套规范，大部分web容器都实现了这个规范：例如Tomcat、Jetty、WebLogic、WebSphere。这些服务器（容器）都实现了JNDI规范。

所以，可以把对应的连接池，配置到服务器（容器）中，如：druid配置到Tomcat中，然后Tomcat会给druid提供一个上下文的名称，将上下文的名称配到对应的<datasource>位置即可。

使用 <dataSource type="JNDI"> 就是告诉 MyBatis：别自己创建数据库连接了，去应用服务器（Tomcat/GlassFish/WebLogic）拿现成的连接池资源。

3-3、type = "POOLED"和UNPOOLED对比

测试代码：

    @Testpublic void testType() throws Exception{SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));// SqlSessionFactory可以创建多个SqlSession!SqlSession sqlSession = sqlSessionFactory.openSession();Object selectById = sqlSession.selectOne("selectById", 12);System.out.println(selectById);sqlSession.commit();sqlSession.close();// 第二次创建SqlSession sqlSession2 = sqlSessionFactory.openSession();Object selectById2 = sqlSession2.selectOne("selectById", 12);System.out.println(selectById2);sqlSession2.commit();sqlSession2.close();}

情况一：type = "UNPOOLED"

两个connection对象不一样！

情况二：type = "POOLED"

同一个connection对象！

五、property标签

在 MyBatis 的 mybatis-config.xml 配置文件中，<properties> 标签用于引入外部属性文件或者在 XML 中内联配置参数，这些参数可以被用于整个配置文件中的占位符（${}）替换，例如数据库连接、分页插件参数等。

一句话理解：

<properties> 就是给 MyBatis 提供参数值的地方，支持从外部 .properties 文件读取，也可以直接在 XML 中写死键值对，用于 ${xxx} 占位符替换。

4-1、用法示例 1：引入外部属性文件

文件结构

src/
├── mybatis-config.xml
└── db.properties

db.properties 内容：

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydb
jdbc.username=root
jdbc.password=123456

mybatis-config.xml 内容：

<configuration><!-- 映入外部的properties文件 --><properties resource="db.properties"/><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments></configuration>

resource 路径是 classpath 相对路径
示例：resource="db.properties" 表示类路径下的 db.properties

【备注】：

不建议！

4-2、用法示例 2：在 XML 中内联写属性

<configuration><properties><property name="jdbc.driver" value="com.mysql.cj.jdbc.Driver"/><property name="jdbc.url" value="jdbc:mysql://localhost:3306/mydb"/><property name="jdbc.username" value="root"/><property name="jdbc.password" value="123456"/></properties><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments></configuration>