Mybatis核心配置解析

Mybatis核心配置解析

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

查看官方文档
以下是一些总结

1.环境配置(environments)

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

尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

<environments default="development">
        <environment id="development">
<!--        事务管理器（transactionManager）.默认JDBC-->
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;userUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

1.1 事务管理器（transactionManager）

在 MyBatis 中有两种类型的事务管理器（也就是 type="[JDBC|MANAGED]"）：

<transactionManager type="JDBC|MANAGED"/>

• JDBC – 这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域。
• MANAGED – 这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接。然而一些容器并不希望连接被关闭，因此需要将 closeConnection 属性设置为 false 来阻止默认的关闭行为。

1.2 数据源（dataSource）

dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

<dataSource type="UNPOOLED|POOLED|JNDI">

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

2.属性（properties）

这些属性可以在外部进行配置，并可以进行动态替换,可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置

数据库配置文件db.properties

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

在核心配置文件中引入

<!--    在核心配置文件中引入-->
        <properties resource="db.properties">
        <!--可以用自结束标签-->
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
        </properties>

• 可以直接引入外部文件
• 可以在其中加入一些属性配置
• 如果外部配置文件与内部冲突,外部优先级高于内部

3.类型别名（typeAliases）

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

<!--    别名-->
    <typeAliases>
        <typeAlias type="com.fww.pojo.User" alias="User"/>
    </typeAliases>

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

每一个在包 domain.blog 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。 比如 domain.blog.Author 的别名为 author；若有注解，则别名为其注解值。

<typeAliases>
  <package name="com.fww"/>
</typeAliases>

@Alias("author")
public class Author {
    ...
}

实体类比较少,用第一种

4.设置（settings）

比较重要的就是前2条和日志缓存

<settings>
  <setting name="cacheEnabled" value="true"/>
  全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。	true | false	默认true
  <setting name="lazyLoadingEnabled" value="true"/>
  延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。	true | false	默认false
  <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>

日志缓存要用

5.映射器（mappers）

MapperRegistry:注册绑定Mapper文件
方式一

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

方式二

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

• UserMapper接口和UserMapper.xml文件必须同名
• UserMapper接口和UserMapper.xml文件必须在同一个包下

6.生命周期和作用域

SqlSessionFactoryBuilder

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

SqlSessionFactory

• 相对于连接池,应用运行期间不要重复创建多次
• SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在
• 因此 SqlSessionFactory 的最佳作用域是应用作用域。
• 最简单的就是使用单例模式或者静态单例模式。

SqlSession

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

• SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。

• 需要开启和及时关闭

• SqlSession 放在一个和 HTTP 请求相似的作用域中。