MyBatis入门——配置解析

Tips：请先阅读：
一、MyBatis入门——第一个MyBatis项目搭建文章
https://blog.csdn.net/Gauss7/article/details/115264612
二、MyBatis入门——基本CRUD代码编写
https://blog.csdn.net/Gauss7/article/details/115280533

---

一、核心配置文件

• mybatis-config.xml

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

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

二、环境配置(environments)

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

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

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

MyBatis的默认的事务管理器是JDBC，连接池是POOLED。

三、属性(properties)

我们可以通过properties属性来实现引用配置文件

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

编写一个配置文件：

1. 第一种方式

db.properties：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/example?uesSSL=false&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456

在核心配置文件中引入：

<properties resource="db.properties"/>

2. 第二种方式

db.properties：

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/example?uesSSL=false&useUnicode=true&characterEncoding=UTF-8

在核心配置文件中引入：

<properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="123456"/>
</properties>

Tips：

1. 可以直接引入外部文件；
2. 可以在其中增加一些属性配置；
3. 如果两个文件有同一个字段，优先使用外部配置文件的。

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

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

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

四、类型别名(typeAliases)

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

第一步：mybatis-config.xml中在properties后添加：

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

第二步：UserMapper.xml中resultType中"com.twy.pojo.User"改成“User”即可：

<select id="getUserList" resultType="User">
    select * from user
</select>

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

扫描实体类的包，它的默认别名就为这个类的类名，首字母小写！

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

第一步：mybatis-config.xml中在properties后添加：

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

第二步：UserMapper.xml中resultType中"com.twy.pojo.User"改成“user”即可。

<select id="getUserList" resultType="user">
    select * from user
</select>

• 在实体类比较少的时候，使用第一种方式。
• 如果实体类十分多，建议使用第二种。
• 但是第一种可以DIY别名，第二种不行，如果非要改，需要在实体上增加注解：

import org.apache.ibatis.type.Alias;
@Alias("user")
public class User {}

五、设置

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

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

六、其他设置

① 类型处理器(typeHandlers)

② 对象工厂(objectFactory)

③ 插件(plugins)

• mybatis-generator
• mybatis-plus
• 通用mapper

七、映射器

MapperRegistry：注册绑定我们的Mapper文件。

方式一：resource

<!-- 每一个Mapper.xml都需要在MyBatis核心配置文件中注册  ! -->
<mappers>
        <mapper resource="com/twy/dao/UserMapper.xml"/>
</mappers>

方式二：使用class文件绑定注册

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

注意点：

• 接口和他的Mapper配置文件必须同名；
• 接口和他的Mapper配置文件必须在同一包下(若将配置文件放在resources里，则所在文件夹需与接口所在文件夹同名)。

方式三：使用扫描包进行注入绑定

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

注意点：

• 接口和他的Mapper配置文件必须同名；
• 接口和他的Mapper配置文件必须在同一包下(若将配置文件放在resources里，则所在文件夹需与接口所在文件夹同名)。

八、生命周期和作用域

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

① SqlSessionFactoryBuilder

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

② SqlSessionFactory

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

③ SqlSession

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

这里面的每一个Mapper，就代表一个具体的业务！