系列四、全局配置文件mybatis-config.xml

一、全局配置文件中的属性

mybatis全局配置中的文件非常多，主要有如下几个：

properties（属性）

settings（全局配置参数）

typeAliases（类型别名）

typeHandlers（类型处理器）

objectFactory（对象工厂）

plugins（插件）

environments（环境集合属性对象）

environment（环境集合属性子对象）

transactionManager（事务管理器）

dataSource（数据源）

mappers（映射器）

1.1、properties

properties可以用来引入一个外部配置，最常见的例子就是引入数据库的基本配置信息，例如在resources目录新建了一个db.properties文件，内容如下：
复制代码
db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/20231101_mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF8&serverTimezone=GMT
db.username=root
db.password=123456
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>
    <!-- 引入外部的配置文件 -->
    <properties resource="db.properties"></properties>

    <environments default="deployment">
        <environment id="deployment">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <!--
                    # yml中的写法，xml中要把&转换为 &amp;
                    driver: jdbc:mysql://localhost:3306/20231101_mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF8&serverTimezone=GMT
                -->
                <!--
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/20231101_mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF8&amp;serverTimezone=GMT"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
                -->

                <!-- 读取外部配置文件中的信息进行注入 -->
                <property name="driver" value="${db.driver}"/>
                <property name="url" value="${db.url}"/>
                <property name="username" value="${db.username}"/>
                <property name="password" value="${db.password}"/>
            </dataSource>
        </environment>
    </environments>

    <!--
        配置mapper的位置
        注意事项：
            如果xxxMapper.xml是在resources目录配置的，那么需要创建和src中mapper同名的Directory才行，否则的话就会报
            "org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)错误"
            （1）如果xxxMapper.xml文件和xxxMapper在同一个目录，需要配置为package方式，并且修改pom.xml的配置信息
            （2）如果xxxMapper.xml文件想单独配置在resources目录，如将其放在resources/mappers目录，可以使用mapper的方式
    -->
    <mappers>
        <!---->
        <package name="org.star.mapper"/>
        <!--<mapper resource="mappers/UserMapper.xml"></mapper>-->
    </mappers>

</configuration>

1.2、settings

1.3、typeAliases

XML 复制代码

<typeAliases>
	<!--
		批量起别名：此处配置的是为 org.star.entity.model 包下的所有持久层类起别名
		起别名规则：首字母小写，例如UserDO的别名是userDO，这样配置的话在xxxMapper.xml中的返回值就不用写类的完整路径了
	-->
	<package name="org.star.entity.model"/>
</typeAliases>

1.4、typeHandlers

八种基本数据类型的增删改查之所以能够处理成功，就是因为有上边的各种类型的默认处理器，这些处理器处理基本数据类型够用了，但是要是处理特殊类型就需要我们自定义类型处理器了，比如User有一个爱好字段，类型为 private List<String> interests; 在数据库中对应的类型为varchar，那么这种情况下就需要我们自定义类型处理器了，这个自定义的类型处理器需要满足如下功能：

（1）数据存储时，自动地将List集合转换为字符串（格式自定义）；

（2）数据查询时，将查询到的字符串在转换为List集合；

1.5、mappers

xxxMapper.xml配置位置的几种写法：

XML 复制代码

<mappers>
	<!-- 方式一： -->
	<!--<mapper resource="mappers/UserMapper.xml"></mapper>-->
	
	<!--方式二：使用绝对路径，不推荐-->
	<!--<mapper url="D:\augenstemn@gitee\mybatis-parent\mybatis\src\main\java\org\star\mapper\UserMapper.xml"></mapper>-->
	
	<!-- 
		方式三：使用mapper接口路径
		注意事项：此种方式要求mapper接口和映射文件的名称相同，且放在同一个目录中 
	-->
	<!--<mapper class="org/star/mapper/UserMapper.xml"></mapper>-->
	
	<!-- 
		方式四：注册指定包下的所有mapper接口
		注意事项：此种方式要求mapper接口和映射文件的名称相同，且放在同一个目录中 
		实际项目中多采用此种方式，推荐 
	-->
	<package name="org.star.mapper"/>
</mappers>