Mybatis配置解析
1.核心配置文件
-
mybatis-config.xml
-
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下:
configuration(配置) properties(属性) settings(设置) typeAliases(类型别名) typeHandlers(类型处理器) objectFactory(对象工厂) plugins(插件) environments(环境配置) environment(环境变量) transactionManager(事务管理器) dataSource(数据源) databaseIdProvider(数据库厂商标识) mappers(映射器)
2.环境配置environments
Mybatis可以配置成适应多种环境
记住:尽管可以配置多个环境,但每个SqlSessionFactory实例只能选择一种环境
关键点:
- 默认使用的环境ID(比如:default=“development”)
- 每个environment元素定义的环境ID(比如:id=“development”)
- 事务管理器的默认配置(type=“JDBC”)
- 数据源的配置(连接池默认type=“POOLED”)
3.属性properties
这些属性可以在外部进行配置,并可以进行动态替换。
既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。【db.properties】
- 编写配置文件
db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
-
在核心配置文件中引入
<properties resource="db.properties"> <!-- 下面这个标签可写可不写,一般是配置文件中没有的属性的补充--> <property name="username" value="root"/> </properties>
里面这个
property
标签可写可不写,一般是配置文件中没有的属性的补充。如果这两个文件中有字段的重复。会优先使用外部的配置文件。
-
value进行字段替换
<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>
4.类型别名
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写。
核心配置文件中
- 第一种用typeAlias
<!--给实体类起别名-->
<typeAliases>
<typeAlias type="com.jy.pojo.User" alias="user"></typeAlias>
</typeAliases>
当这样配置的时候,user
可以用在任何使用com.jy.pojo.User
的地方
-
第二种
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean
<typeAliases> <package name="com.jy.pojo"/> </typeAliases>
扫描实体类的包,它的默认别名就是这个类的类名,首字母小写!!!
-
总结
在实体类比较少的时候,使用第一种方式
在实体类比较多的时候,建议第二种
第一种可以DIY别名,第二种不可以。但是如果想要自己改。可以在实体上增加注解
@Alias("user1") public class User {}
5.设置
https://mybatis.org/mybatis-3/zh/configuration.html#settings
常用的设置
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false | true |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true | false | false |
mapUnderscoreToCamelCase | 是否开启驼峰命名自动映射,即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。 | true | false | False |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
一个配置简单的 settings 元素的示例:
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="multipleResultSetsEnabled" value="true"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="localCacheScope" value="SESSION"/>
</settings>
6.其他配置
- typeHandles(类型处理器
- objectFactory(对象工厂)
- plugins插件
- mybatis-generator-core
- mybatis-plus
- 通用mapper
7.映射器(mappers)、
-
使用相对类路径的资源引用。【推荐与最常用】
<mappers> <mapper resource="com/jy/dao/UserMapper.xml"></mapper> </mappers>
-
使用映射器接口实现类的完全限定类名。也就是使用class文件绑定
<mappers> <mapper class="com.jy.dao.UserMapper"/> </mappers>
-
将包内的映射器接口实现全部注册为映射器。也就是扫描包进行绑定
<mappers> <package name="com.jy.dao"/> </mappers>
-
注意:
2和3的接口和它的Mapper配置文件必须同名,必须在同一个包下。
8.生命周期和作用域
理解之前讨论过的不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
提示 对象生命周期和依赖注入框架
依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器,并将它们直接注入到你的 bean 中,因此可以直接忽略它们的生命周期。
-
SqlSessionFactoryBuilder
- 这个类可以被实例化、使用和丢弃,一旦创建了 SqlSessionFactory,就不再需要它了。
- 局部方法变量
-
SqlSessionFactory
- 相当于数据库连接池
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域。
- 最简单的就是使用单例模式或者静态单例模式。
-
SqlSession
- 也就是连接到连接池的一个请求
- 每个线程都应该有它自己的 SqlSession 实例。
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 用完之后要关闭。否则会造成资源占用
每一个mapper就代表一个具体的业务。