[Mybatis] 详解核心配置文件

🌈有幸相识 ,我是小相。有一个大厂梦，努力奔赴！加油陌生人！🌈
☁️该文章是跟随B站狂神学习Mybatis时的笔记与心得，若与您有用，感谢点赞。文章不免有不足之处，请指出，我会及时改正！

该部分代码位于：mybatis-02-configFile · xcy.小相/web-Mybatis - 码云 - 开源中国 (gitee.com)

1. mybatis-config.xml

XML核心配置文件包含了对Mybatis的核心配置和全局配置。包括：

• settings标签 ：全局配置标签，用于开启或关闭mybatis中的某些功能

• typeAliases标签：类型别名，意在降低冗余的全限定类名书写。

• environments标签：环境配置标签，获取数据库连接实例的数据源（driver、url、username、password等）。

• mappers标签：映射器，用于告诉mybatis去哪里寻找SQL映射语句。 每一个*Mapper.xml都需要在mybatis核心配置文件中注册。

• properties标签：属性标签，用于引入外部配置文件或自定义属性。

• plugins（插件）

• typeHandlers（类型处理器）

• objectFactory（对象工厂）

• databaseIdProvider（数据库厂商标识）

mybatis默认的事务管理器是JDBC，默认的数据源是POOLED。

2. 环境配置（environments）

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
</environments>

• environment：MyBatis 可以通过配置多个environment标签来配置多种环境，并且通过default来指定默认的环境。

  • 尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
  • ID：该环境的标识，可通过environments标签的default属性来指定默认环境。

• transactionManager： 事务管理器。在 MyBatis 中有两种类型（type属性）的事务管理器

  • JDBC:这个配置直接使用了 JDBC 的提交和回滚设施，这也是mybatis默认的配置。
  • MANAGED:这个配置几乎没做什么。

• dataSource： 数据源。dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）。

  • UNPOOLED：这个数据源的实现会每次请求时打开和关闭连接。
  • POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。 这种处理方式很流行，能使并发 Web 应用快速响应请求。这也是mybatis的默认配置。
  • JNDI：这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的数据源引用。

• driver – JDBC 驱动的 Java 类全限定名
• url – 数据库的 JDBC URL 地址
• username – 登录数据库的用户名
• password – 登录数据库的密码
• defaultTransactionIsolationLevel – 默认的连接事务隔离级别
• defaultNetworkTimeout – 等待数据库操作完成的默认网络超时时间（单位：毫秒）

3. （属性）properties

• properties：properties标签可以用来引入外部配置。最典型的就是引入db.properties文件。然后通过${}获取对应的值。

db.properties:

Driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&charsetEncoding=utf-8
user=root
root=123456

mybatis-config.xml:

<!--引入外部配置文件-->
<properties resource="db.properties"/>

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <!--                连接数据的配置信息-->
            <property name="driver" value="${Driver}"/>
            <property name="url" value="${Url}"/>
            <property name="username" value="${User}"/>
            <property name="password" value="${Pwd}"/>
        </dataSource>
    </environment>
</environments>

除此之外还可以在properties标签内部配置数据。

<properties resource="db.properties">
     <property name="Driver" value="123456"/>
     <property name="User" value="root"/>
 </properties>

需要注意的是这两种方式具有一定的优先级：直接赋值 > 外部配置文件 > 内部配置文件。

4.类型别名（typeAliases）

为了降低全限定名的冗余，mybatis提供了设置别名的方法:<typeAliases>。通过配置后的别名可以在任意地方使用。

<typeAliases>
    <typeAlias type="top.xcyxiaoxiang.pojo.User" alias="User"/>
</typeAliases>

使用时直接使用别名代替全限定名即可。

<!--    <update id="updateUser" parameterType="top.xcyxiaoxiang.pojo.User" >-->
<update id="updateUser" parameterType="User" >
    update users set name=#{name},pwd=#{pwd} where id=#{id}
</update>

同时也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean。在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。 比如 top.xcyxiaoxiang.pojo.User 的别名为 user；若有注解，则别名为其注解值。

<typeAliases>
    <package name="top.xcyxiaoxiang.pojo"/>
</typeAliases>

import org.apache.ibatis.type.Alias;

@Alias("user_test")
public class User {……}
// 则别名为user_test

小结：设置别名的方式有3种

• 直接指定
• 通过包指定
• 使用注解指定

6. 设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。 常用的较为重要的配置如下：

设置名	描述	有效值	默认值
cacheEnabled	全局性地开启或关闭所有缓存	true | false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。	true | false	false
logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING	未设置

7. 映射器（mappers）

告诉 MyBatis 到哪里去找Mapper文件，即注册mapper文件。

• 方式一（资源路径）：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="top/xcyxiaoxiang/Dao/UserMapper.xml"/>
</mappers>

• 方式二（完全限定名）：

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>

</mappers>

• 方式三（包名）：

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

注意：f使用方式二和方式三时

• 接口名称必须和mapper名称相同。

• mapper文件和接口在同一个包中。