Mybatis【核心配置文件说明】

配置解析

1、核心配置文件

• mybatis-config.xml

注意：

• 在配置 mybatis-config.xml 时，要注意标签的顺序：
  

2、环境变量（environments）

MyBatis 可以配置成适应多种环境
不过要记住：尽管可以配置多个环境，但每个SqlSessionFactory 实例只能选择一种环境。直接通过设置environments的default参数的值来切换不同的环境（比如Oracle、MySQL、Sqlite）

<environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"/>
                <dataSource type="POOLED">
                    <property name="driver" value="com.mysql.cj.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="Yan1029."/>
                </dataSource>
            </environment>
        </environments>

![在这里插入图片描述](https://img-blog.csdnimg.cn/31888777e62e40b8a3ad1b7de1f42303.png)

3、属性（Properties）

• 我们可以通过properties属性来实现引用配置文件。
• 这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件（db.properties、log4j.properties）中配置这些属性，也可以在 properties 元素的子元素中设置。

编写一个Java属性文件 db.peroperties：
注意：

1. 不需要在& 后面+ amp;
2. mysql8版本对应的驱动是 com.mysql.cj.jdbc.Driver

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

在核心配置文件中引用:

• xml文件需要注意标签的顺序，mybatis-config.xml 中，properties标签必须在environments标签之上。

<configuration>

    <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="${username}"/>
                    <property name="password" value="${password}"/>
                </dataSource>
            </environment>
        </environments>

    <mappers>
        <mapper resource="com/study/dao/UserMapper.xml"/>
    </mappers>
</configuration>

此外，在properties标签中也可以设置属性值，但是，相同字段时，外部配置文件优先级 > properties标签

<properties resource="org/mybatis/example/config.properties">
  <property name="username" value="root"/>
  <property name="password" value="xxxx"/>
</properties>

4、类型别名（typeAliases）

• 类型别名可为 Java 类型设置一个缩写名字。
• 它仅用于 XML 配置，意在降低冗余的全限定类名书写。
• typeAliases 标签应到放到 mybatis-config.xml 的第三个标签位置。（也就是 properties > seeting > typeAliases）

问题：

• 在我们之前的 UserMapper.xml 映射文件中，存在大量的类名冗余。我们通过在 mybatis-config.xml 中设置别名来将这些全限定名简化。

实现：

• 在mybatis-config.xml 中新增下面的语句

    <typeAliases>
        <typeAlias type="com.study.pojo.User" alias="User"/>
    </typeAliases>

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

    <typeAliases>
        <package name="com.study.pojo"/>
    </typeAliases>

在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。

这样我们原本需要写 “com.study.pojo.User” 就简化为 “user” 了。

总结

• 在实体类比较少的时候，使用第一种方式。
• 在实体类特别多的时候，使用第二种方式。
• 第一种方式可以自定义别名，第二种需要注解再能使用注解的名称作为别名。

下面是一些为常见的 Java 类型内建的类型别名。除了普通的数据类型采用 下划线+类型名 作为别名之外，包装类型和集合类型都是使用小写作为别名的。

5、seeting（设置）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

• logImpl
  • 指定 MyBatis 所用日志的具体实现，未指定时将自动查找。
• cacheEnabled
  • 开启缓存
• lazyLoadingEnabled
  • 懒加载

6、其它配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • mybatis-generator-core
  • mybatis-plus

7、映射器（mappers）

1. 使用相对于类路径的资源引用

    <mappers>
        <mapper resource="com/study/dao/UserMapper.xml"/>
    </mappers>

2. 使用映射器接口实现类的完全限定类名

    <mappers>
    <mapper class="com.study.dao.UserMapper"/>
    </mappers>

注意点：

• 接口和它的Mapper配置文件必须同名！
• 接口和它的配置文件必须在同一个包下！

3. 将包内的映射器接口实现全部注册为映射器

    <mappers>
        <package name="com.study.dao"/>
    </mappers>

注意点：

• 接口和它的Mapper配置文件必须同名！
• 接口和它的配置文件必须在同一个包下！

8、作用域和生命周期

不同作用域和生命周期类别是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder

• 一旦创建生成了 SqlSessionFactory，就不再需要它了。

SqlSessionFactory

• 可以理解为数据库连接池

• 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。

• SqlSessionFactory 的最佳作用域是应用作用域。（程序开始它就开始，程序结束它就结束）

• 最简单的就是使用单例模式或者静态单例模式。（保证全局只有一份）

SqlSession

• 图中的也每一个 Mapper 代表一个具体的业务！
• 每个线程都应该有它自己的 SqlSession 实例。（连接到连接池的一个请求）
• 需要开启和关闭请求
• SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。（所以用完赶紧关闭释放掉，否则资源被占用！尽量写到 finally 中确保关闭）