MyBatis（四）配置文件解析

基于白嫖：【狂神说Java】Mybatis最新完整教程IDEA版通俗易懂

1 核心配置文件

mybatis-config.xml里面的相关配置；

1.1 环境配置（environments）

• MyBatis 可以配置成适应多种环境；
• 尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境；
• 每个数据库对应一个 SqlSessionFactory 实例；
• 事务管理器（transactionManager）属性：一是JDBC直接使用了 JDBC 的提交和回滚设施；二是MANAGED这个配置几乎没做什么，它从不提交或回滚一个连接； 如果正在使用 Spring + MyBatis，则没有必要配置事务管理器，因为 Spring 模块会使用自带的管理器来覆盖前面的配置。默认JDBC；
• 数据源（dataSource）属性：就是连接数据库，例如dbcp、c3p0、druid；UNPOOLED–这个数据源的实现会每次请求时打开和关闭连接。POOLED连接池一直打开。JNDI为了能在如 EJB 或应用服务器这类容器中使用。默认POOLED；

1.2 属性（properties）

• 可以通过properties属性来实现引用配置文件；
• 这些属性可以在外部进行配置，并可以进行动态替换，比如账号、密码、url等；

可以在resource目录下db.properties配置：

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://127.0.0.1:3306/datasets?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC
username=root
password=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="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
</environments>

注意使用变量的方式："${key}"不同于xml中SQL语句的书写引用变量#{key}；如果字段相同优先使用db.properties；

1.3 类型别名（typeAliases）

1.3.1 类型别名

<typeAliases>
    <typeAlias alias="Student" type="pojo.Student"/><!--pojo实体下面的直接使用-->
</typeAliases>

直接使用Student就是使用pojo.Student，能够找到；

1.3.2 包别名

<package name="pojo"/>

扫描pojo包下的实体类，首字母小写的非限定类名来作为它的别名。 比如 domain.blog.Author 的别名为 author；包别名可以使用@Alias("name")修改别名；

1.4 设置（settings）

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

• cacheEnabled：缓存是否开启，默认true；
• lazyLoadingEnabled：懒加载，使用才加载，默认false；
• useGeneratedKeys：允许 JDBC 支持自动生成主键，需要数据库驱动支持，默认false；
• mapUnderscoreToCamelCase：是否开启驼峰命名自动映射（数据库列和实体类属性），默认false；
• logImpl：指定 MyBatis 所用日志的具体实现，未指定时将自动查找，默认未设置；

1.5 mappers（映射器）

注册绑定Mapper文件；

1.5.1 资源引用法

<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

1.5.2 接口法

<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
</mappers>

要求接口和Mapper配置文件必须同名；接口和Mapper配置文件必须在同一个包下；

1.5.3 包法

<mappers>
  <package name="org.mybatis.builder"/>
</mappers>

要求接口和Mapper配置文件必须同名；接口和Mapper配置文件必须在同一个包下；

1.5.4 URL法

<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
  <mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>

1.6 其他配置（较少涉及）

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）

2 作用域（Scope）和生命周期

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

• SqlSessionFactoryBuilder：一旦创建了 SqlSessionFactory，就不再需要它了，所以使用局部方法变量。
• SqlSessionFactory： 一旦被创建就应该在应用的运行期间一直存在，使用单例模式或者静态单例模式。
• SqlSession：每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。用完需要关闭。注意每一个SqlSession可以映射多个Mapper；