核心配置文件
- mybatis-config.xml(官方建议命名)系统核心配置文件
- Mybatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息
- 可配置的内容如下:
- configuration(配置)
- properties(属性)
- settings(设置)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境配置)
- environment(环境变量)
- transactionManager(事务管理器)
- dataSource(数据源)
- databaseIdProvider(数据库厂商标识)
- mappers(映射器)
- <!-- 注意元素节点的顺序!顺序不对会报错 -->
environments元素
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<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>
- 配置Mybatis的多套运行环境,将SQL映射到多个不同的数据库上,必须指定其中一个为默认运行环境(通过default指定)
- 子元素节点:environment
- 具体的一套环境,通过设置id进行区别,id保证唯一!
- 子元素节点:transactionManager【事务管理器】
<!-- 语法 --> <transactionManager type="[ JDBC | MANAGED ]"/>
- 子元素节点:数据源(dataSource)
- dataSource 元素使用标准的JDBC数据源接口来配置JDBC链接对象的资源。
- 数据源是必须配置的。
- 有三种内建的数据源类型:type="[UNPOOLED | POOLED | JNDI]")
- unpooled:这个数据源的实现只是每次被请求时打开和关闭链接。
- pooled:这个数据源的实现利用 “池” 的概念将JDBC链接对象组织起来,这是一种使得并发Web应用快速响应请求的流行处理方式。
- jndi:这个数据源的实现是为了能在如Sping 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个JNDI上下文的引用。
- 数据源也有很多第三方的实现,比如dbcp,c3p0等...
mappers元素
- 映射器:定义映射SQL语句文件
- 既然Mybatis的行为其它元素已经配置完了,我们现在就要定义SQL映射语句了。但是首先我们需要告诉Mybatis到哪里去找到这些语句。Java在自动查找方面没有提供一个很好的方法,所以最佳的方式是告诉Mybatis到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符,或类名和包名等。映射器是Mybatis中最核心的组件之一,在Mybatis 3之前,只支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。
引入资源的方式【建议使用第一种方式】:
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>
<!--
使用映射器接口实现类的完全限定类名
需要配置文件名称和接口名称一致,并且位于同一目录下
-->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>
Mapper文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.damin.mapper.UserMapper">
</mapper>
- namespace 中文意思:命名空间,作用如下:
- namespace和子元素的id联合保证唯一,区别不同的mapper
- 绑定DAO接口
- namespace的命名必须跟某个接口名同名
- 接口中的方法与映射文件中sql语句id应该一一对应
- namespace命名规则:包名+类名
Mybatis的真正强大在于它的映射语句,这是它的魔力所在。由于它的异常强大,映射器的XML文件就显得相对简单。Mybatis为聚焦于SQL而构建,以尽可能地为我们减少麻烦。
Properties优化
数据库这些属性都是可以外部配置且可动态替换的,既可以在典型的Java属性文件中配置,也可通过properties元素的子元素来传递
优化配置文件的具体步骤:
第一步,在资源目录下新建一个db.properties文件
driver = com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username = root
password = 123456
第二步,将文件导入properties配置文件
<configuration>
<!--导入properties文件-->
<properties resource="db.properties"/>
<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>
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
更多具体操作,详见官方文档.
settings元素 (详见官方文档)
设置(settings)
- 懒加载
- 日志加载
- 缓存开启关闭
一个完整的settings元素的示例(了解):
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="multipleResultSetsEnabled" value="true"/>
<setting name="useColumnLabel" value="true"/>
<setting name="useGeneratedKeys" value="false"/>
<setting name="autoMappingBehavior" value="PARTIAL"/>
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="defaultFetchSize" value="100"/>
<setting name="safeRowBoundsEnabled" value="false"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="localCacheScope" value="SESSION"/>
<setting name="jdbcTypeForNull" value="OTHER"/>
<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>
生命周期和作用域
作用域(Scope)和生命周期
理解我们目前已经讨论过的不同作用域和生命周期类型是至关重要的,因为错误的使用会导致非常严重的并发问题。
下图为Mybatis的执行过程:
作用域理解
- SqlSessionFactoryBuilder的作用在于创建SqlSessionFactory,创建成功后,SqlSessionFactoryBuilder就失去了作用,所以它只能存在于创建SqlSessionFactory 的方法中,而不要让其长期存在。因此SqlSessionFactoryBuilder实例的最佳作用域是方法作用域(也就是局部方法变量)。
- SqlSessionFactory 可以被认为是一个数据库连接池,它的作用是创建SqlSession接口对象。因为Mybatis的本质就是Java对数据库的操作,所以SqlsessionFactory的生命周期存在于整个Mybatis的应用中,所以可以认为SqlSessionFactory的生命周期就等于Mybatis的应用周期。
- 由于SqlSessionFactory 是一个对数据库的连接池,所以它占据着数据库的连接资源。如果创建多个SqlSessionFactory,那么就存在多个数据库连接池,这样不利于对数据库资源的控制,也会导致数据库连接资源被消耗光,所以尽量避免发生这样的情况。
- 因此在一般的应用中我们往往希望SqlSessionFactory 作为一个单例,让它在应用中被共享。所以说SqlSessionFactory的最佳作用域是应用作用域。
- 如果说SqlsSessionFactory相当于数据库连接池,那么SqlSession 就相当于一个数据库链接(Connection对象),你可以在一个事务里面执行多条SQL,然后通过它的commit、rollback等方法,提交或者回滚事务。所以它应该存活在一个业务请求中,处理完整个请求后,应该关闭这条链接,让它归还給SqlSessionFactory,否则数据库资源就很快被消耗精光,系统就会瘫痪,所以用try...catch...finally...语句来保证其正确关闭。
- 所以SqlSession的最佳的作用域是请求或方法作用域。
感谢“狂神”老师的视频讲解,好人一生平安。