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

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

示例：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//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对比

测试代码：

    @Test
    public 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>

4-3、属性优先级（默认行为）：

如果你同时指定了外部文件（resource 或 url）和内联属性（<property> 子标签），那么：

内联属性优先，会覆盖外部文件中相同的属性值。

4-4、常见属性用途

位置	用途
`<dataSource>`	数据库连接参数
插件（如分页插件）	配置插件行为
`<settings>`	配置全局行为开关

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