Mybatis 笔记 - 04 配置解析

4. 配置解析

1. 核心配置

• MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

• configuration（配置）
  
  properties（属性）
  settings（设置）
  typeAliases（类型别名）
  typeHandlers（类型处理器）
  objectFactory（对象工厂）
  plugins（插件）
  environments（环境配置）
  environment（环境变量）
  transactionManager（事务管理器）
  dataSource（数据源）
  databaseIdProvider（数据库厂商标识）
  mappers（映射器）
  
  

2.环境配置（environments）

• MyBatis 可以配置成适应多种环境

• 不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

• 学会使用配置多套运行环境

• mybatis 默认的事务管理器是 JDBC， 连接池： POOLED

3. 属性（properties）

• 这些属性可以在外部进行配置，并可以进行动态替换。即可以在典型的Java属性文件中 配置，也可以通过properties元素的子元素来传递。[db.properties]
• 我们可以通过properties 属性来实现引用配置文件

1. 编写一个配置文件： db.properties

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

2. 在核心配置文件中映入属性配置

   <!-- 映入外部属性配置 -->
       <properties resource="db.properties">
           <property name="username" value="root"/>
           <property name="password" value="111111"/>
       </properties>
   

   • 可以直接映入外部配置文件
   • 可以在其中增加一些属性
   • 如果两个文件有相同的字段，优先使用外部配置文件的。

如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：

• 首先读取在 properties 元素体内指定的属性。
• 然后根据 properties 元素中的 resource 属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
• 最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。

因此，通过方法参数传递的属性具有最高优先级，resource/url 属性中指定的配置文件次之，最低优先级的则是 properties 元素中指定的属性。

4. 类型别名（typeAliases）

• 类型别名可为 Java 类型设置一个缩写名字。

• 它仅用于 XML 配置，意在降低冗余的全限定类名书写。

  <typeAliases>
    <-- 为User类的全限定名 取了个别名： User -->
    <typeAlias alias="User" type="com.javacto.pojo.User"/>
  </typeAliases>
  

• 也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。

  <typeAliases>
  <!--    <typeAlias type="com.javacto.pojo.User" alias="User"/>-->
      	<-- 包下的User类的别名：User/user  -->
          <package name="com.javacto.pojo" />
  </typeAliases>
  

• 除了以上的方式， 还可以使用注解来配置别名,需要注意的是xml中必须进行扫包。

  @Alias("tt")
  public class User {
      private int id;
      private String name;
      private String pwd;
  
      public User(){}
  }
  

5. 设置（settings）

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

一个完整的settings 如下：

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="multipleResultSetsEnabled" value="true"/>
  <setting name="useColumnLabel" value="true"/>
  <setting name="useGeneratedKeys" value="false"/>
  <setting name="autoMappingBehavior" value="PARTIAL"/>
  <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  <setting name="defaultExecutorType" value="SIMPLE"/>
  <setting name="defaultStatementTimeout" value="25"/>
  <setting name="defaultFetchSize" value="100"/>
  <setting name="safeRowBoundsEnabled" value="false"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="localCacheScope" value="SESSION"/>
  <setting name="jdbcTypeForNull" value="OTHER"/>
  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

6.其他配置

• 类型处理器（typeHandlers）

• 对象工厂（objectFactory）

• 插件（plugins）

7. 映射器（mappers）

• 用于注册mapper.xml 文件

  • 相对于类路径的资源引用

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

  • 完全限定资源定位符

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

  • 映射器接口实现类

    <!-- 使用映射器接口实现类的完全限定类名 -->
    <mappers>
      <mapper class="com.javacto.dao.UserMapper"/>
    </mappers>
    

    注意点：

    • 接口和Mapper映射文件需在同一个包下
    • 接口名和Mapper名需相同

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

    <!-- 将包内的映射器接口实现全部注册为映射器 -->
    <mappers>
      <package name="com.javacto.dao.UserMapper"/>
    </mappers>
    

8. 生命周期和作用域

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

SqlSessionFactoryBuilder

• 这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。

• 最佳作用域是方法作用域（也就是局部方法变量）。

SqlSessionFactory

• 一旦被创建就应该在应用的运行期间一直存在。

• 作用域是应用作用域。

• 最简单的就是使用单例模式或者静态单例模式。

SqlSession

• 每个线程都应该有它自己的 SqlSession 实例。

• SqlSession 的实例不是线程安全的，是不能被共享的。

• 它的最佳的作用域是请求或方法作用域。

• 用完之后必须关闭，否则资源被占用，这个关闭操作很重要。