1、全局配置文件的用处
mybatis通过配置文件可以配置数据源、事务管理器、运行时行为、处理别名、类型处理、插件等信息。在mybatis应用初始化时,程序会解析全局配置文件,使用配置的信息实例化Configuration组件,完成基本配置的初始化。在mybatis的全局配置文件中通过对应的标签完成对应的配置,其整体标签结构如下:
注意:全局配置文件中的标签在编写的时候必须要按着上述顺序进行编写,否则会有问题;另外对mybatis进行初始化配置时不一定非要使用xml配置文件的方式,也可以通过java api 的方式实现,因为不管使用哪种方式最终在mybatis启动初始化时都会实例化成配置类Configuration。
2、标签的用途
上边所介绍的标签都有什么用途呢,接下来通过一个表格看一下
3、标签的详细介绍和使用
properties
用于引入外部properties配置文件的信息,两种使用方式:
<properties resource="类入类路径下的资源"></properties>
<properties url="网络或者磁盘路径"></properties>
settings
主要是控制mybatis运行时的一些行为,这里只举一些常用到的属性,未涉及到的可以去mybatis官网查看 mybatis – MyBatis 3 | 配置
<settings>
<!-- 全局性开启和关闭任何缓存 -->
<setting name="cacheEnabled" value="true"/>
<!-- 延迟加载的全局开关 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 允许单条语句返回多个结果集 -->
<setting name="multipleResultSetsEnabled" value="true"/>
<!-- 允许使用数据字段列的别名代替数据列名 -->
<setting name="useColumnLabel" value="true"/>
<!-- 设置为true时,允许jdbc自动生成主键 -->
<setting name="useGeneratedKeys" value="false"/>
<!-- 设置超时时间,它决定数据库驱动等待数据库响应的秒数 -->
<setting name="defaultStatementTimeout" value="25"/>
<!-- 是否开启驼峰命名自动映射 -->
<setting name="mapUnderscoreToCamelCase" value="false"/>
</settings>
typeAliases
别名处理器, 将一些名字(路径)太长的java类起一个别名,以后使用别名即可
具体使用如下:
<!-- 用来为java类型设置一个简称,主要用于降低冗余的全限定类型名书写 -->
<typeAliases>
<!-- 直接指定一个类型,为其取别名 -->
<typeAlias alias="User" type="com.app.test.mapper.User" />
<!-- 给包起别名,其包下对应的所有类型的别名在没有使用@Alias注解的情况下会使用 Bean 的首字母小写的非限定类名来作为它的别名 -->
<package name="com.app.test.mapper"/>
<!-- 例如此处,设置后,com.app.test.mapper下所有的Bean的别名为 Bean的首字母小写的非限定类名 -->
<!-- 在为包起别名基础上,也可以通过注解方式设置别名, @Alias('别名') -->
</typeAliases>
mybatis中有一些内置的别名,具体如下:
typeHandlers
typeHandlers 为类型处理器, jdk 1.8已经实现全部的JSR310规范,可以使用mybatis基于JSR310编写的各种日期时间处理器,mybatis 3.4以前的版本需要我们手动注册这些处理器,以后的版本是自动注册的。这个没什么可说的,自己觉的目前这个标签作用在于配置自定义处理器。
开发者可以自定义类型处理器,通过实现 org.apache.ibatis.type.TypeHandler 接口, 或继承一个很便利的类 org.apache.ibatis.type.BaseTypeHandler。由于我在开发过程中还未自己定义过类型处理器,这里不做详解,如需自定义可以查看mybatis官网。
plugins
MyBatis 允许在映射语句执行过程中的某一点进行拦截调用。这里不详解,具体在后边的mybatis中插件的实现和使用中介绍。
environments、environment、transactionManager、dataSource
这四个标签是嵌套的关系,也是一起使用,具体如下:
environments 中可以配置多个 environment, 用来表示不同的数据源,每一个数据源对应一个 environment,每一个 environment有一个唯一的id,用来区分不同的数据源。
transactionManager 用来配置事务管理器,有两种方式:JDBC和MANAGED,一般使用JDBC即可,在使用spring+mybatis项目中,此处无需配置,spring 管理事务。
dataSource 用来配置数据源的连接信息、事务隔离级别、连接数、超时时间等。
<!-- enviroments中可以配置多个environment, 其中default属性指定某种环境, 可以达到快速切换的效果 -->
<environments default="development">
<!-- 用于配置一个具体的环境信息,id属性代表当前环境的唯一标识,enviroments中的default属性就是根据这里的id进行转换 -->
<environment id="development">
<!-- 事务管理器:
type属性:事务管理器的类型,可以是自带的JDBC,也可以是自定义的事务管理器
自定义的事务管理器实现TransactionFactory接口,设置type时,使用全类名
-->
<transactionManager type="JDBC"/>
<!-- 数据源:
type属性:数据源类型有三个UNPOOLED、POOLED、JNDI
也可以使用自定义数据源,自定义的数据源实现DataSourceFactory接口,设置type时,使用全类名
-->
<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>
databaseIdProvider
支持多数据库厂商,具体使用如下:
<!-- 配置支持多个厂商的数据库 -->
<databaseIdProvider type="DB_VENDOR">
<property name="MySQL" value="mysql"/>
<property name="Oracle" value="oracle"/>
</databaseIdProvider>
这里配置的数据库在sql映射文件中使用,指定sql语句对应的数据库类型
<?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.app.test.mapper.UserMapper">
<select id="selectUser" parameterType="long" resultType="com.app.test.mapper.User" databaseId="mysql">
select * from oa_user where id = #{id}
</select>
<select id="selectUser" parameterType="long" resultType="com.app.test.mapper.User" databaseId="oracle">
select * from oa_user where id = #{id}
</select>
</mapper>
mappers
使用mappers标签将sql映射文件注册到全局配置文件中
<mappers>
<mapper resource="com/app/test/mapper/UserMapper.xml"/>
<!-- 批量注册 -->
<package name="com.app.test.mapper"/>
</mappers>
以上就是对mybatis全局配置文件的一个简单的介绍。
文章稍作修改,参考文章:https://blog.csdn.net/chaizepeng/article/details/119605823