setup 获取globalProperties

转载

游侠小影 2024-12-16 11:00:03

文章标签 数据库 mybatis bc sql Source 文章分类 架构后端开发

文章目录

1. properties属性
2. settings 设置
3. typeAliases 别名处理器
4. typeHandlers 类型处理器

日期类型的处理
自定义类型处理器

5. plugins 插件
6. environments 环境

transactionManager
dataSource

7. databaseIdProvider 环境
8. mapper 映射

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 的运行时行为

setup 获取globalProperties_sql

在之后用到这些标签的时候再详细讲解，此处我们先看 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 类型内建了相应的类型别名。它们都是大小写不敏感的，我们在起别名的时候千万不要占用已有的别名

setup 获取globalProperties_sql_02

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

4. typeHandlers 类型处理器

无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时，都会用类型处理器将获取的值以合适的方式转换成 Java 类型

setup 获取globalProperties_Source_03

日期类型的处理

日期和时间的处理，JDK1.8以前一直是个头疼的问题。我们通常使用JSR310规范领导者Stephen Colebourne创建的Joda-Time来操作。1.8已经实现全部的JSR310规范了。
日期时间处理上，我们可以使用MyBatis基于 JSR310（Date and Time API）编写的各种日期时间类型处理器。

setup 获取globalProperties_Source_04

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 映射

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>

也可以采用 注册接口 的方法

class ：引用（注册）接口，

有sql映射文件，映射文件名必须和接口同名，并且放在与接口同一目录下；

<mapper class="com.atguigu.mybatis.dao.EmployeeMapperAnnotation"/>

没有sql映射文件，所有的sql都是利用注解写在接口上;

@Select("select * from tbl_employee where id = #{id}")
public Employee getEmeById(Integer id){}

官方博客	全部文章	热门标签	班级博客
了解我们	网站地图	意见反馈

鸿蒙开发者社区	51CTO学堂
51CTO	软考资讯