【Mybatis学习笔记】—— 【二】全局配置文件


MyBatis 的配置文件包含了影响 MyBatis 行为甚深的 设置(settings)和属性(properties)信息。文档的 顶层结构如下:

  • configuration 配置
  • properties 属性
  • settings 设置
  • typeAliases 类型命名
  • typeHandlers 类型处理器
  • objectFactory 对象工厂
  • plugins 插件
  • environments 环境
  • environment 环境变量
  • transactionManager 事务管理器
  • dataSource 数据源
  • databaseIdProvider 数据库厂商标识
  • mappers 映射器

1. properties属性

 <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

相比于上述在全局配置文件中写死的方式,我们可以利用peoperties将数据库配置信息提取出来

mybatis可以使用properties来引入外部properties配置文件的内容;

  • resource :引入类路径下的资源
  • url :引入网络路径或者磁盘路径下的资源
<properties resource="dbconfig.properties"></properties>

在 conf 文件夹下建立 dbconfig.properties 文件,将数据库配置信息写在此处

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

如果属性在不只一个地方进行了配置,那么 MyBatis 将按 照下面的顺序来加载:

  • 在 properties 元素体内指定的属性首先被读取。
  • 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根 据 url 属性指定的路径读取属性文件,并覆盖已读取的同名属性。
  • 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性

2. settings 设置

这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为
在这里插入图片描述
在之后用到这些标签的时候再详细讲解,此处我们先看 mapUnderscoreToCamelCase 参数.

把该参数设置为true,则打开驼峰命名法,像我们在第一篇文章中,数据库字段last_Name,JavaBean字段 lastName ,开启了该参数后,就不需要定义别名了,Myabtis 可以实现该字段的映射

<!-- 
settings包含很多重要的设置项
	setting:用来设置每一个设置项
		name:设置项名
		value:设置项取值
 -->
	<settings>
		<setting name="mapUnderscoreToCamelCase" value="true"/>
	</settings>

3. typeAliases 别名处理器

类型别名是为 Java 类型设置一个短的名字,可以方便我们 引用某个类, 别名不区分大小写

  • typeAlias : 为某个java类型起别名
    type:指定要起别名的类型全类名;默认别名就是类名小写;employee
    alias:指定新的别名
<!-- typeAliases:别名处理器:可以为我们的java类型起别名 
			别名不区分大小写
	-->
	<typeAliases>
		<!-- 1、typeAlias:为某个java类型起别名
				type:指定要起别名的类型全类名;默认别名就是类名小写;employee
				alias:指定新的别名
		 -->
		<typeAlias type="com.atguigu.mybatis.bean.Employee" alias="emp"/> 

	</typeAliases>
  • 类很多的情况下,可以批量设置别名这个包下的每一个类创建一个默认的别名,就是简单类名小写
<typeAliases>		
		<!-- 2、package:为某个包下的所有类批量起别名 
				name:指定包名(为当前包以及下面所有的后代包的每一个类都起一个默认别名(类名小写),)
		-->
		<package name="com.atguigu.mybatis.bean"/>
		
		
</typeAliases>
  • 批量起别名的情况下,使用 @Alias 注解为某个类型指定新的别名
@Alias("emp")
public calss Employee{

值得注意的是,MyBatis已经为许多常见的 Java 类型内建 了相应的类型别名。它们都是大小写不敏感的,我们在起 别名的时候千万不要占用已有的别名
在这里插入图片描述

并不推荐用别名,使用全类名可以方便的 ctrl+左键 进入该类,不用到处找别名。

4. typeHandlers 类型处理器

无论是 MyBatis 在预处理语句(PreparedStatement)中 设置一个参数时,还是从结果集中取出一个值时, 都会 用类型处理器将获取的值以合适的方式转换成 Java 类型
在这里插入图片描述

日期类型的处理

  • 日期和时间的处理,JDK1.8以前一直是个头疼的 问题。我们通常使用JSR310规范领导者Stephen Colebourne创建的Joda-Time来操作。1.8已经实 现全部的JSR310规范了。

  • 日期时间处理上,我们可以使用MyBatis基于 JSR310(Date and Time API)编写的各种日期 时间类型处理器。
    在这里插入图片描述

  • MyBatis3.4以前的版本需要我们手动注册这些处 理器,以后的版本都是自动注册

自定义类型处理器

我们可以重写类型处理器或创建自己的类型处理 器来处理不支持的或非标准的类型。

步骤:

  • 1)、实现org.apache.ibatis.type.TypeHandler 接口或 者继承 org.apache.ibatis.type.BaseTypeHandler

  • 2)、指定其映射某个JDBC类型(可选操作)

  • 3)、在mybatis全局配置文件中注册

5. plugins 插件

插件是MyBatis提供的一个非常强大的机制,我们 可以通过插件来修改MyBatis的一些核心行为。插 件通过动态代理机制,可以介入四大对象的任何 一个方法的执行。后面会有专门的章节来介绍 mybatis 运行原理以及插件

先来熟悉以下四大对象

  • 执行器: Executor(update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
  • 参数处理器:ParameterHandler (getParameterObject, setParameters)
  • 结果集处理器:ResultSetHandler (handleResultSets, handleOutputParameters)
  • sql 语句处理器:StatementHandler (prepare, parameterize, batch, update, query)

6. environments 环境

MyBatis可以配置多种环境,比如开发、测试和生 产环境需要有不同的配置。

  • 每种环境使用一个environment标签进行配置并指 定唯一标识符
  • 可以通过environments标签中的 default 属性指定 一个环境的标识符来快速的切换环境
<environments default="dev_mysql">
		<environment id="dev_mysql">
			<transactionManager type="JDBC"></transactionManager>
			<dataSource type="POOLED">
				<property name="driver" value="${jdbc.driver}" />
				<property name="url" value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />
			</dataSource>
		</environment>
	
		<environment id="dev_oracle">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${orcl.driver}" />
				<property name="url" value="${orcl.url}" />
				<property name="username" value="${orcl.username}" />
				<property name="password" value="${orcl.password}" />
			</dataSource>
		</environment>
	</environments>
  • id:指定当前环境的唯一标识
  • transactionManager、和dataSource都必须有

transactionManager

type: JDBC | MANAGED | 自定义

  • JDBC:使用了 JDBC 的提交和回滚设置,依赖于从数 据源得到的连接来管理事务范围。 JdbcTransactionFactory

  • MANAGED:不提交或回滚一个连接、让容器来管理 事务的整个生命周期(比如 JEE 应用服务器的上下 文)。 ManagedTransactionFactory

  • 自定义:实现TransactionFactory接口,type=全类名/ 别名

dataSource

type: UNPOOLED | POOLED | JNDI | 自定义

  • UNPOOLED:不使用连接池, UnpooledDataSourceFactory
  • POOLED:使用连接池, PooledDataSourceFactory
  • JNDI: 在EJB 或应用服务器这类容器中查找指定的数据源
  • 自定义:实现DataSourceFactory接口,定义数据源的 获取方式。

实际开发中我们使用Spring管理数据源,并进行 事务控制的配置来覆盖上述配置

7. databaseIdProvider 环境

MyBatis 可以根据不同的数据库厂商执行不同的语句。

databaseIdProvider:支持多数据库厂商的;
type="DB_VENDOR" :VendorDatabaseIdProvider
作用就是得到数据库厂商的标识 (驱动getDatabaseProductName()),mybatis就能根据数据库厂商标识来执行不同的sql;

  • MySQL
  • Oracle
  • SQL Server
  • 。。。。。。
<databaseIdProvider type="DB_VENDOR">
	<!-- 为不同的数据库厂商起别名 -->
	<property name="MySQL" value="mysql"/>
	<property name="Oracle" value="oracle"/>
	<property name="SQL Server" value="sqlserver"/>
</databaseIdProvider>
	<select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee">
		select * from tbl_employee where id = #{id}
	</select>
	
	<select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee"
		databaseId="mysql">
		select * from tbl_employee where id = #{id}
	</select>
	
	<select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee"
		databaseId="oracle">
		select EMPLOYEE_ID id,LAST_NAME	lastName,EMAIL email 
		from employees where EMPLOYEE_ID=#{id}
	</select>

MyBatis匹配规则如下:

  • 1、如果没有配置databaseIdProvider标签,那么databaseId=null

  • 2、如果配置了databaseIdProvider标签,使用标签配置的name去匹 配数据库信息,匹配上设置databaseId=配置指定的值,否则依旧为 null

  • 3、如果databaseId不为null,他只会找到配置databaseId的sql语句

  • 4、MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。如果同时找到带有 databaseId 和不带 databaseId 的相同语句,则后者会被舍弃。

8. mapper 映射

  1. mapper逐个注册SQL映射文件
	<!-- mappers:将sql映射注册到全局配置中 -->
	<mappers>
		<!-- 
			mapper:注册一个sql映射 
				注册配置文件
				resource:引用类路径下的sql映射文件
					mybatis/mapper/EmployeeMapper.xml
				url:引用网路路径或者磁盘路径下的sql映射文件
					file:///var/mappers/AuthorMapper.xml
		-->
						
		<mapper resource="mybatis/mapper/EmployeeMapper.xml"/> 
		
	</mappers>
  1. 也可以采用 注册接口 的方法

class :引用(注册)接口,

  • 有sql映射文件,映射文件名必须和接口同名,并且放在与接口同一目录下;
 <mapper class="com.atguigu.mybatis.dao.EmployeeMapperAnnotation"/>
  • 没有sql映射文件,所有的sql都是利用注解写在接口上;
@Select("select * from tbl_employee where id = #{id}")
public Employee getEmeById(Integer id){}

推荐:

  • 比较重要的,复杂的Dao接口我们来写sql映射文件
  • 不重要,简单的Dao接口为了开发快速可以使用注解;
  1. 批量注册

这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下

<mappers>
<!-- 批量注册: -->
	<package name="com.smallbeef.mybatis.dao"/>
<mappers>


👉 👉 👉 My Blog - 小牛肉的个人博客,欢迎来访~👈 👈 👈

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章