4 配置解析

核心配置文件

• mybatis-config.xml
• MyBatis的配置文件包含了会深深影响MyBatis行为的设置和属性信息

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

环境变量 environments

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

但每个SqlSessionFactory实例只能选择一种环境

MyBatis默认的事务管理器是JDBC ,默认使用连接池POOLED

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 可以配置多个environment 但是只能使用一个 
          default中的是使用的-->
    <environments default="development">
        <environment id="development">
            <!-- 事务管理器（transactionManager）
                 在 MyBatis 中有两种类型的事务管理器
                （也就是 type="[JDBC|MANAGED]" -->
            <transactionManager type="JDBC"/>
            <!-- 数据源（dataSource）
                 UNPOOLED– 这个数据源的实现会每次请求时打开和关闭连接。
                 POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来
                 避免了创建新的连接实例时所必需的初始化和认证时间。-->
            <dataSource type="POOLED">
                <!--driver – 这是 JDBC 驱动的 Java 类全限定名
                   （并不是 JDBC 驱动中可能包含的数据源类）。
                    url – 这是数据库的 JDBC URL 地址。
                    username – 登录数据库的用户名。
                    password – 登录数据库的密码。 -->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=utf-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/qin/dao/UserMapper.xml"/>
    </mappers>
</configuration>

属性properties

通过使用properties属性来实现引用配置文件

这些属性都是可外部配置且可动态替换的,既可以在典型的java属性文件中配置,也可通过properties元素的子元素来传递(db.properties)

db.properties:

drive=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=utf-8
user=root

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!-- 你既可以在典型的 Java 属性文件中配置这些属性
         也可以在 properties 元素的子元素中设置
         如果两个都有同一个属性,优先使用properties文件中的
         原因:优先加载了子元素里面的,然后再加载porperties文件,会覆盖原来的
-->
    <properties resource="db.properties">
        <property name="password" value="123456"/>
    </properties>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${drive}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${user}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/qin/dao/UserMapper.xml"/>
    </mappers>
</configuration>

类型别名（typeAliases）

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

方式一:

mybaits-config.xml

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

UserMapper.xml

<!--  之前:resultType="com.qin.dao.User" -->
<select id="getUserById" parameterType="int" resultType="User">
    select * from `user` where id=#{id}
</select>

方式二:

mybaits-config.xml

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

UserMapper.xml

<!-- 当使用package之下的类时,首字母小写即可 -->
<select id="getUserById" parameterType="int" resultType="user">
    select * from `user` where id=#{id}
</select>

在实体类比较少的时候使用第一种.

如果实体类较多,建议使用第二种

第一种可以diy别名,第二种需要在实体类中加入注解才能diy别名

import org.apache.ibatis.type.Alias;

import java.util.List;
import java.util.Map;
@Alias("hello")
public interface UserMapper {}

设置（settings）

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

设置名	描述	有效值	默认值
cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。	true false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。	true false	false
logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING	未设置

映射器（mappers）

方式一:

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

方式二:

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

方式三:

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

注意:

方式二和方式三的xml文件和类名相同且在同一个文件目录下

其他配置

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

生命周期和作用域

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

SqlSessionFactoryBuilder：

• 一旦创建了SqlSessionFactoryBuilder，就不再需要它了
• 局部变量

SqlSessionFactory：

• 可以理解为数据库连接池
• SqlSessionFactory一旦被创建及应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例
• 因此SqlSessionFactory的最佳作用域是应用作用域
• 最简单的就是使用 单例模式 或者静态单例模式

SqlSession：

• 连接到连接池的请求
• SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳作用域是请求或方法作用域
• 用完之后需要赶紧关闭，否则资源被占用