开发: C++知识库 Java知识库 JavaScript Python PHP知识库人工智能区块链大数据移动开发嵌入式开发工具数据结构与算法开发测试游戏开发网络协议系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑笔记本显卡显示器固态硬盘硬盘耳机手机 iphone vivo oppo 小米华为单反装机图拉丁

-> Java知识库 -> Mybatis基础学习之配置解析(上篇) -> 正文阅读

[Java知识库]Mybatis基础学习之配置解析(上篇)

前言：

小伙伴们，大家好，我是狂奔の蜗牛rz，当然你们可以叫我蜗牛君，我是一个学习Java半年多时间的小菜鸟，同时还有一个伟大的梦想，那就是有朝一日，成为一个优秀的Java架构师。

这个Mybatis基础学习系列是用来记录我学习Mybatis框架基础知识的全过程 (这个系列是参照B站狂神的Mybatis最新教程来写的，由于是之前整理的，但当时没有发布出来，所以有些地方可能有错误，希望大家能够及时指正！)

之后我将尽量以一天一更的速度更新这个系列，还没有学习Mybatis3框架的小伙伴可以参照我的博客学习一下；当然学习过的小伙伴，也可以顺便跟我一起复习一下基础。最后，希望能够和大家一同进步吧！加油吧！少年们！

特别提醒：如果对Mybatis基础学习系列感兴趣，可以阅读本系列往期博客：
第一篇：Mybatis基础学习之初识Mybatis
第二篇：Mybatis基础学习之第一个Mybatis程序
第三篇：Mybatis基础学习之CRUD增删改查
第四篇：Mybatis基础学习之万能的Map和模糊查询

由于Mybatis基础学习之配置解析的内容比较多，所以这里我将其拆分为上下两篇来发布。上篇主要介绍Mybatis核心配置中的环境配置、事务管理器、数据源、属性和类型别名等内容；下篇主要介绍设置、其他配置和映射器，以及Mybatis的生命周期等。

今天我们来到了Mybatis基础学习的第五站：配置解析(上篇)，主要内容就是能。废话不多说，让我们开始今天的学习内容吧。

5. 配置解析

5.1 核心配置

5.1.1 核心配置概念

MyBatis的配置文件包含了会深深影响MyBatis行为的设置和属性信息

configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

5.1.2 编写xml配置文件

编写mybatis-config.xml文件

<?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>
    
    <!-- 环境 -->
    <environments default="development">
        <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?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource> 
        </environment>
    </environments>

    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

5.2 环境配置（environments）

MyBatis可以配置成使用多种环境。不过要注意：尽管可以配置多个环境，但每个SqlSessionFactor实例只能选择一种环境。

 <!-- environments：表示环境, 这里使用复数，表示可以设置多道环境
      而这里将默认环境设置为开发环境-->
    <environments default="development">
        
        <!-- 设置第一道环境, 表示开发环境 -->
        <environment id="development">
           <!-- MyBatis的默认数据源类型是POOLED，也就是有池的连接 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </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?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
        
    </environments>

5.3 事务管理器（transactionManager）

常用的数据源包括：JDBC、DBCP、C3P0、Druid ，而MyBatis的默认管理器是JDBC

<?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：核心配置文件 -->
<configuration>
    
    <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置开发环境 -->
        <environment id="development">
            <!-- transactionManager：表示事务管理器, 而MyBatis的默认管理器是JDBC -->
            <transactionManager type="JDBC"/>
            <!-- dataSource：表示数据源，主要作用：连接数据库 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value=
                          "jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

5.4 数据源（DataSource）

5.4.1 数据源概念

MyBatis内置的三种数据源类型：

type="[UNPOOLED |POOLED| UNDI]"

UNPOOLED数据源：其实现只是每次被请求是打开和关闭连接，缺点是有点慢
数据库连接池：用完可以回收
POOLED数据源：其实现利用“池”概念和JDBC连接对象组织起来，避免新创建连接实例所必需的初始化和认证时间。这是一种使得并发Web应用快速响应请求的流行处理方法。

特别提醒：

MyBatis的默认数据源类型是POOLED，也就是有池的连接

5.4.2 编写 mybatis-config.xml 配置文件

<?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: 核心配置文件 -->
<configuration>
    
    <!-- 设置默认环境为开发环境 -->
   <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager：表示事务管理器 -->
            <transactionManager type="JDBC"/>
            <!-- dataSource：表示数据源，主要作用：连接数据库, 而MyBatis的默认数据源类型是POOLED (即有池的连接) -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

5.5 属性（properties）

可以通过properties属性来实现配置引用

这些属性可以在外部进行配置，并可以进行动态替换 (既可以在典型的Java属性文件中配置这些属性，也可以在properties元素的子元素中设置 db.properties)

5.5.1 编写db.properties配置文件

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

5.5.2 在核心配置文件中引入

1.标签位置问题

在这里插入图片描述

2.编写 mybatis-config.xml 配置文件

<?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: 核心配置文件 -->
<configuration>
    
    <!-- 引入外部配置文件 (优先使用外部配置文件) -->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="111111"/>
    </properties>
    
    <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager: 代表事务管理器, 而MyBatis的默认管理器是JDBC-->
            <transactionManager type="JDBC"/>
            <!-- dataSource: 代表数据源，主要作用: 连接数据库, 而MyBatis的默认数据源类型是POOLED，也就是有池的连接 -->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${pwd}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

5.5.3 编写 UserDaoTest 测试类

public class UserDaoTest {
    
    @Test
    public void test(){
        // 获得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 使用getMapper方法来获取接口对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 调用getUserList方法，查询所有用户
            List<User> userList = userMapper.getUserList();
            // 遍历数组
            for (User user : userList) {
                System.out.println(user);
            }
        } catch(Exception e){
            e.printStackTrace();
        } finally {
        // 关闭sqlSession
        sqlSession.close();
        }
    }
    
}

5.5.4 测试结果

在这里插入图片描述

结果：查询用户列表信息成功！

5.5.4 测试结论

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

5.6 类型别名（typeAliases）

5.6.1 类型别名作用

作用：

类型别名是为Java类型设置一个短的名，存在的意义仅在于用来减少类完全限定名的冗余

可以指定一个包名，MyBatis会在包名下面搜索需要的Java Bean

例如，扫描实体类的包，它的默认别名就为这个类的类名，首字母小写

5.6.2 类型别名的使用

1. 给实体类起别名

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

2.通过包起别名

 <!-- 通过包起别名 -->
<typeAliases>
        <package name="com.kuang.pojo"/>
</typeAliases>

5.6.3 使用给实体类起别名方式

1.编写 mybatis-config.xml 配置文件

<?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: 表示核心配置文件 -->
<configuration>
    
    <!-- 引入外部配置文件：优先使用外部配置文件 -->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="111111"/>
    </properties>
    
    <!-- 可以给实体类起别名 -->
    <typeAliases>
        <typeAlias type="com.kuang.pojo.User" alias="User"></typeAlias>
    </typeAliases>
    
    <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager：表示事务管理器, 而MyBatis的默认管理器是JDBC-->
            <transactionManager type="JDBC"/>
            <!-- dataSource: 表示数据源, 主要作用: 连接数据库, 而MyBatis的默认数据源类型是POOLED，也就是有池的连接-->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${pwd}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 每一个Mapper.xml都需要再Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

2. 编写接口配置文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace=绑定一个对应的Dao/Mapper接口 -->
<mapper namespace="com.kuang.dao.UserMapper">
    
    <!-- select查询语句: select的id属性，要和接口中定义的方法名相同
         直接给实体类起别名后，resultType(结果类型)直接使用对应实体类即可 -->
    <select id="getUserList" resultType="User">
        select * from mybatis.user
    </select>
    
</mapper>

3. 编写 UserDaoTest 测试类

public class UserDaoTest {
    
    @Test
    public void test(){
        // 获得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 使用getMapper方法来获取接口对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 调用getUserList方法，查询所有用户
            List<User> userList = userMapper.getUserList();
            // 遍历数组
            for (User user : userList) {
                System.out.println(user);
            }
        } catch(Exception e){
            e.printStackTrace();
        } finally {
        // 关闭sqlSession
        sqlSession.close();
        }
    }
    
}

4. 测试结果

使用标签后测试

在这里插入图片描述

去掉标签后测试

在这里插入图片描述

报错：Cannot find class：User，即找不到User类

5.6.4 使用通过包起别名方式

1.编写 mybatis-config.xml 配置文件

<?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：核心配置文件 -->
<configuration>
    
    <!-- 引入外部配置文件: 优先使用外部配置文件 -->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="111111"/>
    </properties>
    
     <!-- 通过包起别名 -->
    <typeAliases>
            <package name="com.kuang.pojo"/>
    </typeAliases>  
    
        <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager：表示事务管理器, 而MyBatis的默认管理器是JDBC-->
            <transactionManager type="JDBC"/>
            <!-- dataSource: 表示数据源, 主要作用: 连接数据库, 而MyBatis的默认数据源类型是POOLED，也就是有池的连接-->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${pwd}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!--每一个Mapper.xml都需要再Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

2. 编写接口配置文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace=绑定一个对应的Dao/Mapper接口 -->
<mapper namespace="com.kuang.dao.UserMapper">
    
    <!-- select查询语句：select的id属性，要和接口中定义的方法名相同
         通过包起别名后，resultType(结果类型)直接使用对应实体类（使用时注意首字母小写）-->
    <select id="getUserList" resultType="user">
        select * from mybatis.user
    </select>
    
</mapper>

3. 编写 UserDaoTest 测试类

public class UserDaoTest {
    
    @Test
    public void test(){
        // 获得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 使用getMapper方法来获取接口对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 调用getUserList方法，查询所有用户
            List<User> userList = userMapper.getUserList();
            // 遍历数组
            for (User user : userList) {
                System.out.println(user);
            }
        } catch(Exception e){
            e.printStackTrace();
        } finally {
        // 关闭sqlSession
        sqlSession.close();
        }
    }
    
}

4. 测试结果

在这里插入图片描述

结果：查询用户列表信息成功！

5.6.4 两种方式的区别

在实体类比较少的时候使用第一种方式（直接给实体类起别名）
如果实体类比较多，建议使用第二种（通过给包起别名）
第一种方式可以DIY别名，第二种方式则不行，如果非要改，需要在实体类上增加注解
```
// 增加别名注解
@Alias("hello")
public class User {}   
```

5.6.5 使用注解起别名

1.编写mybatis配置文件

<?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: 表示核心配置文件 -->
<configuration>
    
    <!-- 引入外部配置文件：优先使用外部配置文件 -->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="pwd" value="111111"/>
    </properties>
    
    <!-- 设置默认环境为开发环境 -->
    <environments default="development">
        <!-- 设置一道环境为开发环境 -->
        <environment id="development">
            <!-- transactionManager：表示事务管理器, 而MyBatis的默认管理器是JDBC-->
            <transactionManager type="JDBC"/>
            <!-- dataSource: 表示数据源, 主要作用: 连接数据库, 而MyBatis的默认数据源类型是POOLED，也就是有池的连接-->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${pwd}"/>
            </dataSource>
        </environment>
    </environments>
    
    <!--每一个Mapper.xml都需要再Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
    
</configuration>

2.编写User实体类

// 增加别名注解
@Alias("hello")
public class User {
    
    private int id;
    private String name;
    private String pwd;
    
    public User() {
    }
    
    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }
    
    public int getId() {
        return id;
    }
    
    public void setId(int id) {
        this.id = id;
    }
    
    public String getName() {
        return name;
    }
    
    public void setName(String name) {
        this.name = name;
    }
    
    public String getPwd() {
        return pwd;
    }
    
    public void setPwd(String pwd) {
        this.pwd = pwd;
    }
    
    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }
    
}

3. 编写接口配置文件

<?xml version="1.0" encoding="UTF-8" ?>
        <!DOCTYPE mapper
                PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
                "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace=绑定一个对应的Dao/Mapper接口 -->
<mapper namespace="com.kuang.dao.UserMapper">
    
    <!-- select查询语句：select的id属性，要和接口中定义的方法名相同
         resultTyp中设置为"hello", 表示使用注解自定义别名 -->
    <select id="getUserList" resultType="hello">
        select * from mybatis.user
    </select>
    
</mapper>

4. 编写 UserDaoTest 测试类

public class UserDaoTest {
    
    @Test
    public void test(){
        // 获得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 使用getMapper方法来获取接口对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 调用getUserList方法，查询所有用户
            List<User> userList = userMapper.getUserList();
            // 遍历数组
            for (User user : userList) {
                System.out.println(user);
            }
        } catch(Exception e){
            e.printStackTrace();
        } finally {
        // 关闭sqlSession
        sqlSession.close();
        }
    }
}