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. 生命周期和作用域
理解不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
1. SqlSessionFactoryBuilder
- 一旦创建了 SqlSessionFactory,就不再需要SqlSessionFactoryBuilder了
- 局部变量
2. SqlSessionFactory
-
说白了可以想象为,数据库连接池
-
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例
-
SqlSessionFactory 的最佳作用域是应用作用域(程序一旦开始就开始作用,直到程序结束)
-
最简单的就是使用单例模式或者静态单例模式 ==> 保证全局只有一个变量
3. SqlSession
- 连接到连接池的一个请求,需要开启和关闭
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域
- 用完之后需要赶紧关闭,否则资源会被占用
- getMapper方法会创建一个Mapper,每一个Mapper都代表一个具体的业务