【MyBatis框架】核心配置文件讲解

左手的ㄟ右手 2024-04-03 14:17 93阅读 0赞

[14天阅读挑战赛][14]

#### 目录 ####

*   *   *  1. 引言
         *  2. 主要元素
         *  3. 常用配置元素介绍
         *   *  3.1 < properties >
             *  3.2 < settings >
             *  3.3 < typeAliases >
             *  3.4 < typeHandlers >
             *  3.5 < plugins >
             *  3.6 < environments >
             *  3.7 < mappers >
         *  4. 结语

#### 1. 引言 ####

在MyBatis的核心配置中，包含了很多影响MyBatis行为的重要信息，这些信息通常在一个项目中只会在一个配置文件中编写，并且编写后也不会轻易改动。虽然在实际项目中需要开发人员编写或修改的配置文件不多，但是熟悉配置文件中各个元素的功能还是十分重要的。

#### 2. 主要元素 ####

在MyBatis框架的核心配置文件中，< configuration >元素是配置文件的根元素，其他元素都要在< configuration >元素内进行配置，其配置文件的主要元素如图

![在这里插入图片描述][dad6f8ebe5db4b29be69e2c2e6bb49ec.png]

从图中可以看出，在MyBatis的配置文件中包含了 多个元素，这些元素在配置文件中分别发挥着不同的作用。开发人员索要熟悉的就是图中的< configuration >元素各个子元素的配置。

> 这里要特别注意，< configuration >的子元素必须按照图中由上到下的顺序进行配置，否则MyBatis在解析XML文件的时候会报错

#### 3. 常用配置元素介绍 ####

##### 3.1 < properties > #####

< properties >是一个配置属性的元素，该元素常用于将内部的配置外在化，即通过外部的配置来动态的替换内部定义的属性，例如数据库的连接等属性，就可以通过配置文件进行转化。

配置个人数据库连接配置

jdbc.driver=com.mysql.jdbc.Driver
    jdbc.url=jdbc:mysql://localhost:3306/zxy_db01
    jdbc.username=root
    jdbc.pwd=zxy

![在这里插入图片描述][d34718def6944167b40987992316badd.png]

##### 3.2 < settings > #####

< settings >元素主要用于改变MyBatis运行时的行为，例如开启二级缓存，开启延迟加载等。即使不配置< settings >元素，也可以正常运行MyBatis。但是熟悉其中的元素还是很有必要的。  
![在这里插入图片描述][9f663c1e9b9d4df2a7f6e8c8399cfb4a.png]

其常见使用方式如下

![在这里插入图片描述][d042626a68254147b914e35981f18012.png]

##### 3.3 < typeAliases > #####

< typeAliases >元素用于给配置文件中的Java类型起别名。

当POJO类过多时，可以通过自动扫描包的形式自定义别名

默认会以首字母小写的方式来取别名。

除了可以使用 < typeAliases >元素自定义别名外，MyBatis框架还默认为许多常见的`Java`类型提供了相应地类型别名

![在这里插入图片描述][4df3acf570844a8687f920aa1a3b1215.png]

##### 3.4 < typeHandlers > #####

MyBatis在预处理语句中设置一个参数或者从结果集中取出一个值时，都会用其框架内部注册的`typeHandler`（类型处理器）进行相关处理。`typeHandler`的作用就是将预处理语句中传入的参数从`javaType`（java类型）转换为`dbcType`（JDBC类型），或者从数据库去除结果时将`jdbcType`转换成`javaType`。

![在这里插入图片描述][77f9407ae3394baa8deba06d7894844c.png]

具体使用方式如下

1.  注册一个类的类型处理器

1.  注册一个包中所有元素的类型处理器

##### 3.5 < plugins > #####

< plugins >元素的作用是配置用户所开发的插件

##### 3.6 < environments > #####

在配置文件中，< environments >用于对环境进行配置，MyBatis的环境配置实际上就是数据源的配置，我们可以通过对< environments >元素配置多种数据源，即配置多种数据库。

在MyBatis中，可以配置两种类型的事务管理器，分别是`JDBC`和`MANAGED`，关于这两个事务管理器的描述如下：

1.  `JDBC`：此配置使用了JDBC的提交和回滚设置，它依赖于从数据源得到的连接来管理事物的作用域。
2.  `MANAGED`：此配置从来不提交或回滚一个连接，而是让容器来管理事物的整个生命周期。在默认情况下，它会关闭连接，但一些容器并不希望这样，为此可以将closeConnection的属性设置为false来阻止它的默认行为。

##### 3.7 < mappers > #####

在配置文件中，< mappers >元素用于指定MyBatis映射文件的位置，一般可以使用如下4种方式引入映射器文件。

1.  类路径引入
    
        <mappers>
                <mapper resource="com/zxy/mybatis/mapper/UserMapper.xml"/>
            </mappers>
2.  本地文件路径引入
    
        <mappers>
                <mapper url="file:///D:/com/zxy/mapper/UserMapper.xml"/>
            </mappers>
3.  使用接口类引入
    
        <mappers>
                <mapper class="com.zxy.mybatis.mapper.UserMapper.xml"/>
            </mappers>
4.  使用包名引入
    
        <mappers>
                <mapper name="com.zxy.mybatis.mapper"/>
            </mappers>

#### 4. 结语 ####

MyBatis的核心配置文件是十分重要的，关系着框架是否能正常运转，应该多熟悉结构，比如本人曾经写错了 < mappers >的配置导致映射文件找不到，十分头痛。

[14]: https://marketing.csdn.net/p/bb9f9e25975dba9f9b87f5272afded16
[dad6f8ebe5db4b29be69e2c2e6bb49ec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/571f6d7c4e9f45ff9324b297d2d6c3b9.png
[d34718def6944167b40987992316badd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/62ef5413776d4852b6f9969e1334a2b6.png
[9f663c1e9b9d4df2a7f6e8c8399cfb4a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/e20c39f1d67644e689da5c24291888ca.png
[d042626a68254147b914e35981f18012.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/36e88539c32c4420bf74c4a5e9d7e3b1.png
[4df3acf570844a8687f920aa1a3b1215.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/25cb92fff679483e9329bf4c619db241.png
[77f9407ae3394baa8deba06d7894844c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/03/7ca40c663e07444b975a563d484594e8.png