Mybatis 全局配置文件 mybatis-config.xml

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

猜你喜欢

转载自blog.csdn.net/u014641168/article/details/130319671