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

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

14天阅读挑战赛

目录

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

1. 引言

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

2. 主要元素

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

在这里插入图片描述

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

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

3. 常用配置元素介绍

3.1 < properties >

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

配置个人数据库连接配置

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

在这里插入图片描述

3.2 < settings >

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

其常见使用方式如下

在这里插入图片描述

3.3 < typeAliases >

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

  1. <typeAliases>
  2.         <!--
  3.         typeAlias：设置某个类型的别名
  4.         属性：
  5.         type：设置需要设置别名的类型
  6.         alias：设置某个类型的别名，若不设置该属性，那么该类型拥有默认的别名，即类名
  7.         且不区分大小写
  8.         -->
  9.         <typeAlias alias="user" type="com.zxy.mybatis.pojo.User"></typeAlias>
  10.     </typeAliases>

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

  1. <typeAliases>
  2.         <!--以包为单位，将包下所有的类型设置默认的类型别名，即类名且不区分大小写-->
  3.         <package name="com.zxy.mybatis.pojo"/>
  4.     </typeAliases>

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

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

在这里插入图片描述

3.4 < typeHandlers >

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

在这里插入图片描述

具体使用方式如下

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

  2. 注册一个包中所有元素的类型处理器
3.5 < plugins >

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

3.6 < environments >

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

  1. <environments default="development">
  2.         <environment id="development">
  3.             <transactionManager type="JDBC"/>
  4.             <dataSource type="POOLED">
  5.                 <!--设置连接数据库的驱动-->
  6.                 <property name="driver" value="${jdbc.driver}"/>
  7.                 <!--设置连接数据库的连接地址-->
  8.                 <property name="url" value="${jdbc.url}"/>
  9.                 <!--设置连接数据库的用户名-->
  10.                 <property name="username" value="${jdbc.username}"/>
  11.                 <!--设置连接数据库的密码-->
  12.                 <property name="password" value="${jdbc.password}"/>
  13.             </dataSource>
  14.         </environment>
  15. </environments>

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

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

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

  1. 类路径引入

    1. <mappers>
    2.         <mapper resource="com/zxy/mybatis/mapper/UserMapper.xml"/>
    3.     </mappers>

  2. 本地文件路径引入

    1. <mappers>
    2.         <mapper url="file:///D:/com/zxy/mapper/UserMapper.xml"/>
    3.     </mappers>

  3. 使用接口类引入

    1. <mappers>
    2.         <mapper class="com.zxy.mybatis.mapper.UserMapper.xml"/>
    3.     </mappers>

  4. 使用包名引入

    1. <mappers>
    2.         <mapper name="com.zxy.mybatis.mapper"/>
    3.     </mappers>

4. 结语

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

发表评论

表情：
评论列表 （有 0 条评论，182人围观）

还没有评论，来说两句吧...

相关阅读