Mybatis-配置解析

配置解析

配置解析

1. 核心配置文件

mybatis-config.xml(官方建议的文件名,建在resource目录下)
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
包含如下的配置
- properties（属性）
- settings（设置）
- typeAliases（类型别名）
- typeHandlers（类型处理器）
- objectFactory（对象工厂）
- plugins（插件）
- environments（环境配置）
- environment（环境变量）
- transactionManager（事务管理器）
- dataSource（数据源）
- databaseIdProvider（数据库厂商标识）
- mappers（映射器）

2. 环境变量（environments）

MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中

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

Mybatis默认的事务管理器就是JDBC,连接池:POOLED

学会使用多套运行环境(选择对应的id)

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
        </dataSource>
    </environment>
    
    <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
        </dataSource>
    </environment>
</environments>

3. 属性(properties)

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

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

1. 编写一个配置文件

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

2. 在核心配置文件中引入

由于在XML中可以规定标签的顺序,properties必须写在上面!

<!--引入外部配置文件,由于此处都在resource目录下,直接写文件名-->
<properties resource="db.properties"/>

可以在properties中指定参数,利用键值对的方式(name,value)

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

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

写完配置后,在environment中使用

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
</environments>

3. 类型别名（typeAliases）

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

<!--可以给实体类起别名-->
<typeAliases>
    <typeAlias type="com.wang.pojo.User" alias="User"/>
</typeAliases>

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

扫描实体类的包,它的默认别名就为之歌类的类名,其中首字母小写!

<typeAliases>
    <typeAlias type="com.wang.pojo"/>
</typeAliases>

在实体类比较少的时候,使用第一种方式

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

第一种可以DIY别名,第二种则不行,如果非要改,需要在实体类上增加注解

@Alias("user")
public class User {
    
}

使用内建类型时,加_的才是基本类型,不加的就为包装类型

如:_int ==> int int ==> Integer

4. 设置(setting)

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

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

5. 其他配置

typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
- MyBatis Generator Core
- MyBatis Plus
- 通用Mapper

6. 映射器(mappers)

MapperRegistry: 注册绑定我们的Mapper文件

1. 方式一: 使用完全限定名[推荐使用]

使用完全限定名

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

2. 方式二: 使用class文件绑定注册

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

注意点:

接口和它的Mapper配置文件必须同名!
接口和它的Mapper配置文件必须放在同一个包下!

3. 方式三: 使用包扫描进行注入绑定

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

注意点:

接口和它的Mapper配置文件必须同名!
接口和它的Mapper配置文件必须放在同一个包下!

4. 生命周期和作用域

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

graph TD id1[mybatis-config.xml配置文件] id2[开始] id3[SqlSessionFactoryBuilder] id4[SQLSessionFactory] id5[SQLSession] id6[SQL Mapper] id7[结束] id1 --> id3 id2 --> id3 id3 --> id4 id4 --> id5 id5 --> id6 id6 --> id7 id5 --已废弃,不推荐使用--> id7

1. SqlSessionFactoryBuilder

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

2. SqlSessionFactory

说白了可以想象为,数据库连接池
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例
SqlSessionFactory 的最佳作用域是应用作用域(程序一旦开始就开始作用,直到程序结束)
最简单的就是使用单例模式或者静态单例模式 ==> 保证全局只有一个变量

3. SqlSession

连接到连接池的一个请求,需要开启和关闭
SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域
用完之后需要赶紧关闭,否则资源会被占用
getMapper方法会创建一个Mapper,每一个Mapper都代表一个具体的业务