1.XML配置(config)
Mybatis的配置文件包含了很多影响Mybatis行为的设置和属性信息。
这些配置都是写在配置文件中的。映射的mapper会自动受到影响。
主要包括:
- properties(属性)
- settings(设置)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境配置)
- environment(环境变量)
- transactionManager(事务管理器)
- dataSource(数据源)
- environment(环境变量)
- databaseIdProvider(数据库厂商标识)
- mappers(映射器)
全面的查看官方文档:https://mybatis.org/mybatis-3/zh/configuration.html
1.1属性(Properties)
属性都是可外部配置&&动态替换的。既可以在典型的java属性文件中配置,也可以通过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
然后在配置文件中就能使用了。这里为了表现用法,就新用了一个标签。都是一样的。注意这里是rooot。资源文件和标签存在优先级的。
<properties resource="db.properties">
<property name="username" value="rooot"/>
</properties>
下面就可以用${key}
进行引用了。
1.2设置(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 | 未设置 |
mapUnderscoreToCamelCase | 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。 | true | false | False |
1.3类型别名(typeAliases)
类型别名为Java类型设置一个短的名字。它只和xml配置有关。存在的意义仅在于减少类完全限定类名的冗余。官方样例:
<typeAliases>
<typeAlias alias="Author" tyoe="domain.blog.Author"/>
<typeAlias alias="Blog" tyoe="domain.blog.Blog"/>
<typeAlias alias="Comment" tyoe="domain.blog.Comment"/>
<typeAlias alias="Post" tyoe="domain.blog.Post"/>
<typeAlias alias="Section" tyoe="domain.blog.Section"/>
<typeAlias alias="Tag" tyoe="domain.blog.Tag"/>
</typeAliases>
还可以扫描包来直接搜索实体类。样例(domain目录下blog包下的所有类)
<typeAliases>
<package name="domain.blog"/>
</typeAliases>
还可以通过注解来指定别名:
@Alias("tttt")
public class User {
}
这样就可以方便我们的使用了。
1.4环境配置(environments)
MyBatis 可以配置成适应多种环境,这种机制有助于将 SQL 映射应用于多种数据库之中。但是每个SqlSessionFactory实例只能选择一种环境。
官方文档给出了样例:
- 事务处理器
- JDBC:直接使用了JDBC的提交和回滚。
- MANAGED:没什么用,让容器来管理事务的整个生命周期。
- 数据源
- UNPOOLED:没有连接池
- POOLED:有连接池
- JNDI:容器集中或在外部配置数据源。上下文引用。
1.5映射器(mappers)
定义 SQL 映射语句,告诉 MyBatis 到哪里去找到这些语句。
可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:///
的 URL),或类名和包名等。官方样例:
1.6类型处理器(typeHandlers)
无论是Mybatis预处理语句(preparedStatement)中设置一个参数时,还是从结果集中取出一个值时,都会用 类型处理器 将获取的值以合适的方式转换成Java类型。
2.XML映射文件(mapper)
MyBatis 为聚焦于 SQL 而构建,以尽可能地减少麻烦。由于它的异常强大,映射器的 XML 文件就显得相对简单。
cache
– 对给定命名空间的缓存配置。cache-ref
– 对其他命名空间缓存配置的引用。resultMap
– 用来描述如何从数据库结果集中来加载对象。- sql语句
sql
– 可被其他语句引用的可重用语句块。insert
– 映射插入语句update
– 映射更新语句delete
– 映射删除语句select
– 映射查询语句
2.1 结果集映射resultMap。
resultMap元素是 MyBatis 中最重要最强大的元素。省略简单的代码,我们只用描述复杂映射的关系就好了。
2.1.1简单的resultMap解决数据库列名和实体类元素的名命不统一问题。
数据库:id name pwd
实体类:id username password
如果使用resultType会出现username=null和password=null的问题。这时候我们就可以使用resultMap来对结果集进行映射。
<resultMap id="userMap" type="User">
<result column="id" property="id"/>
<result column="name" property="username"/>
<result column="pwd" property="password"/>
</resultMap>
<!--查询所有-->
<select id="getUserList" resultMap="userMap">
select * from user
</select>
效果等同于给变量取别名:
<select id="selectUsers" resultType="User">
select
id as "id",
name as "username",
pwd as "password"
from user
where id = #{id}
</select>
但是很明显更简单。
2.1.2 结果映射的子元素。
经过了2.1.1的例子相信大家已经有很多想法了,确实,resultMap还可以实现更加复杂的操作,比如映射到一个对象中,这个对象有着许多的子对象。
我们先说一下resultMap的子元素,然后举一个官方的例子,分析一下这个例子就好了。
更加复杂具体的操作可以查看官方的帮助文档:https://mybatis.org/mybatis-3/zh/sqlmap-xml.html
结果映射(resultMap)
- constructor:用于在实例化类时,注入结果到构造方法中
- idArg:ID参数
- arg:将被注入到构造方法的一个普通结果
- id:一个id结果
- result:注入到字段或JavaBean普通属性的普通结果
- association:一个复杂类型的关联,许多结果将包装成这种类型
- 嵌套结果映射,关联本身可以是一个resultMap元素。
- collection:复杂类型集合。
- 嵌套结果映射,集合本身可以是一个resultMap元素。
- discriminator:使用结果值来接定使用那个resultMap
- case:基于某些值的结果映射,本身可以是一个resultMap元素
其实就是几个元素来回嵌套,没多少东西。
- case:基于某些值的结果映射,本身可以是一个resultMap元素
还有就是在讨论数据库关系的时候,多对一,多对多的结果映射时要再次学习,这里先做一个了解。
2.2 缓存(cache)
Mybatis中内置了一个强大的事务性查询缓存机制。
默认情况下,只启用了对一个会话中的数据进行缓存,要开启二级缓存,只需要在mapper中添加
<cache/>
这个简单的语句就行了。提供:
- 映射语句文件中的所有 select 语句的结果将会被缓存。
- 映射语句文件中的所有 insert、update 和 delete 语句会刷新缓存。
- 缓存会使用最近最少使用算法(LRU, Least Recently Used)算法来清除不需要的缓存。
- 缓存不会定时进行刷新(也就是说,没有刷新间隔)。
- 缓存会保存列表或对象(无论查询方法返回哪种)的 1024 个引用。
- 缓存会被视为读/写缓存,这意味着获取到的对象并不是共享的,可以安全地被调用者修改,而不干扰其他调用者或线程所做的潜在修改。
还可以修改一些属性。
<cache
eviction="FIFO" 清除策略
flushInterval="60000" 刷新间隔
size="512" 引用数目
readOnly="true"/> 只读
此外。还可以自定义缓存。这些我们留在缓存学习时再进行详细学习。
3.生命周期和作用域
错误使用不同作用域和生命周期类会导致非常严重的并发问题。
还记得我们的图吗?
-
SqlSessionFactoryBuilder:
- 这个类可以被实例化,使用和丢弃。一旦创建了SqlSessionFactory,就不需要builder了。
- 该实例的最佳作用域是方法作用域(局部方法变量)。
- 可以用builder来创建多个factory实例,但最好还是不要让其一直存在,把xml解析资源释放用来做其他事情。
-
SqlSessionFactory:
- 这个类一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 使用 SqlSessionFactory 的最佳方法是在应用运行期间不要重复创建多次。
- 其最佳作用域是应用作用域。 有很多方法可以做到,最简单的就是使用单例模式或者静态单例模式。
-
SqlSession:
- 每个线程都应该有它自己的 SqlSession 实例。
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 使用完应该立刻关闭连接。