MyBatis-3-配置解析

MyBatis --> 3. 配置解析

3.1 核心配置文件

• mybatis-config.xml

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

• 配置文档的顶层结构如下：

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

3.2 environments（环境配置）

• MyBatis可以配置成适应多种环境；
• 不过要记住：尽管可以配置多个环境，但每个SqlSessionFactory实例只能选择一种环境。
• MyBatis 中有两种类型的transactionManager（事务管理器）（也就是 type="[JDBC|MANAGED]"）,默认是JDBC
• 有三种内建的dataSource（数据源）类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）,默认是POOLED

3.3 properties（属性）

• 通过properties来实现引用配置文件；

• 这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 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="123456"/>
     </properties>
     

     可以直接引入外部文件；

     可以在其中增加一些属性的配置；

     如何两个文件有同一个字段的属性，优先使用外部配置文件的属性。

3.4 typeAliases（类型别名）

• 类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置，意在降低冗余的全限定类名书写。

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

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

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

• 在实体类比较少的时候使用第一种方式，否则使用第二种方式

3.5 settings（设置）

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

  <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>
  

3.6 其他

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

3.7 mappers（映射器）

• 每一个Mapper.xml都需要在mybatis核心配置文件中注册！

• MyBatis 的行为已经由上述元素配置完了，现在就要来定义 SQL 映射语句了。首先，需要告诉 MyBatis 到哪里去找到这些语句;

• 可以使用相对于类路径的资源引用，或完全限定资源定位符（包括 file:/// 形式的 URL），或类名和包名等。

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

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

• 使用类名的注意点
  • 接口和它的Mapper配置文件必须同名
  • 接口和它的Mapper配置文件必须在同一个包下

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

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

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

• SqlSessionFactoryBuilder

  • 一旦创建了 SqlSessionFactory，就不再需要它了；
  • 因此，SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）

• SqlSessionFactory

  • SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例；
  • 因此SqlSessionFactory 的最佳作用域是应用作用域；
  • 最简单的就是使用单例模式或者静态单例模式。

• SqlSession

  • 每个线程都应该有它自己的 SqlSession 实例；
  • SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域；
  • 用完之后需要关闭，否则资源被占用