Mybatis config
标签:
properties 属性
1、resources 下的配置文件 mybatis.properties
driver = com.mysql.jdbc.Driver
url = jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8
username = root
password = root
<properties resource="mybatis.properties"> </properties>
- 如果属性在不只一个地方进行了配置,那么 MyBatis 将按 照下面的顺序来加载:
- 在 properties 元素体内指定的属性首先被读取。
- 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根
据 url 属性指定的路径读取属性文件,并覆盖已读取的同名属性。 - 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。
2、settings 设置
- 驼峰命名
<settings>
<setting name="mapUnderscoreToCameCase" value="true"/>
</settings>
3、typeAliases别名处理器
- 类型别名是为 Java 类型设置一个短的名字,可以方便我们 引用某个类。
<typeAliases>
<typeAlias type="com.xxx.Employee" alias="emplyeee" />
<typeAlias type="com.xxx.Department" alias="department" />
</typeAliases>
- 类很多的情况下,可以批量设置别名这个包下的每一个类 创建一个默认的别名,就是简单类名小写。
<typeAliases>
<typeAlias type="com.xxx.bean"/>
</typeAliases>
- 可以使用@Alias注解为期指定一个别名
@Alias("emp")
public class Employee{ }
- 值得注意的是,MyBatis已经为许多常见的 Java 类型内建
了相应的类型别名。它们都是大小写不敏感的,我们在起
别名的时候千万不要占用已有的别名。
- typeHandler类型处理器
- 无论是 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 全局文件中注册
- 1. 实现org.apache.ibatis.type.TypeHandler接口或
- plugins插件
- 插件是MyBatis提供的一个非常强大的机制,我们 可以通过插件来修改MyBatis的一些核心行为。插 件通过动态代理机制,可以介入四大对象的任何 一个方法的执行。后面会有专门的章节我们来介 绍mybatis运行原理以及插件
- Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
- ParameterHandler (getParameterObject, setParameters)
- ResultSetHandler (handleResultSets, handleOutputParameters)
- StatementHandler (prepare, parameterize, batch, update, query)
- environment环境
-
MyBatis可以配置多种环境,比如开发、测试和生 产环境需要有不同的配置。
-
每种环境使用一个environment标签进行配置并指 定唯一标识符
-
可以通过environments标签中的default属性指定 一个环境的标识符来快速的切换环境
- id:指定当前环境的唯一标识
- transactionManger、和 dataSource都必须有
<environments> <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} /> </environment> </environments>
- type:JDBC | MANAGED | 自定义
- JDBC:使用了 JDBC 的提交和回滚设置,依赖于从数 据源得到的连接来管理事务范围。 JdbcTransactionFactory
- MANAGED:不提交或回滚一个连接、让容器来管理 事务的整个生命周期(比如 JEE 应用服务器的上下 文)。 ManagedTransactionFactory
- 自定义:实现TransactionFactory接口,type=全类名/ 别名
- dataSource
- type:UNPOOLED | POOLED | JNDI | 自定义
- UNPOOLED:不使用连接池, UnpooledDataSourceFactory
- POOLED:使用连接池, PooledDataSourceFactory
- JNDI: 在EJB 或应用服务器这类容器中查找指定的数据源
- 自定义:实现DataSourceFactory接口,定义数据源的 获取方式。
- 实际开发中我们使用Spring管理数据源,并进行 事务控制的配置来覆盖上述配置
- databaseidProvider环境
- MyBatis 可以根据不同的数据库厂商执行不同的语句。
<databaseIdProvider type="DB_VENDOR">
<property name="MySQL" value="mysql"/>
<property name="Oracle" value="oracle"/>
<property name="SQL Server" value="sqlserver"/>
</databaseIdProvider>
- Type: DB_VENDOR:使用MyBatis提供的VendorDatabaseIdProvider解析数据库
厂商标识。也可以实现DatabaseIdProvider接口来自定义。 - Property-name:数据库厂商标识
- Property-value:为标识起一个别名,方便SQL语句使用 databaseId属性引用
<SELECT id="getEmployeeByDeptId" resultType="Emp" parameterType="Integer" databaseId="mysql">
SELECT * FROM EMPLOYEE WHERE DEPTID=#{ID}
</select>
- DB_VENDOR
- 会通过DatabaseMetaData#getDatabaseProductName()返回的字符 串进行设置。由于通常情况下这个字符串都非常长而且相同产品的不 同版本会返回不同的值,所以最好通过设置属性别名来使其变短
- Mybatis匹配规则
– 1、如果没有配置databaseIdProvider标签,那么databaseId=null
– 2、如果配置了databaseIdProvider标签,使用标签配置的name去匹 配数据库信息,匹配上设置databaseId=配置指定的值,否则依旧为 null
– 3、如果databaseId不为null,他只会找到配置databaseId的sql语句
– 4、MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。如果同时找到带有 databaseId 和不带 databaseId 的相同语句,则后者会被舍弃。
- mapper映射
- mapper逐个注册SQL映射文件
<mappers>
<mapper resource="myabtis/mapper/PersonDao.xml" />
<mapper url="file://D:/ UserDao.xml" />
<mapper class="com.xxx.PersonDaoAnnotation" />
</mappers>
- 或者使用批量注册
- 这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下
<mappers> <package name="com.xxx.dao"/> </mappers>
- 总结(详细配置如下)
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--
1、mybatis可以使用properties来引入外部properties配置文件的内容;
resource:引入类路径下的资源
url:引入网络路径或者磁盘路径下的资源
-->
<properties resource="dbconfig.properties"></properties>
<!--
2、settings包含很多重要的设置项
setting:用来设置每一个设置项
name:设置项名
value:设置项取值
-->
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<!-- 3、typeAliases:别名处理器:可以为我们的java类型起别名
别名不区分大小写
-->
<typeAliases>
<!-- 1、typeAlias:为某个java类型起别名
type:指定要起别名的类型全类名;默认别名就是类名小写;employee
alias:指定新的别名
-->
<!-- <typeAlias type="com.atguigu.mybatis.bean.Employee" alias="emp"/> -->
<!-- 2、package:为某个包下的所有类批量起别名
name:指定包名(为当前包以及下面所有的后代包的每一个类都起一个默认别名(类名小写),)
-->
<package name="com.atguigu.mybatis.bean"/>
<!-- 3、批量起别名的情况下,使用@Alias注解为某个类型指定新的别名 -->
</typeAliases>
<!--
4、environments:环境们,mybatis可以配置多种环境 ,default指定使用某种环境。可以达到快速切换环境。
environment:配置一个具体的环境信息;必须有两个标签;id代表当前环境的唯一标识
transactionManager:事务管理器;
type:事务管理器的类型;JDBC(JdbcTransactionFactory)|MANAGED(ManagedTransactionFactory)
自定义事务管理器:实现TransactionFactory接口.type指定为全类名
dataSource:数据源;
type:数据源类型;UNPOOLED(UnpooledDataSourceFactory)
|POOLED(PooledDataSourceFactory)
|JNDI(JndiDataSourceFactory)
自定义数据源:实现DataSourceFactory接口,type是全类名
-->
<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>
<!-- 5、databaseIdProvider:支持多数据库厂商的;
type="DB_VENDOR":VendorDatabaseIdProvider
作用就是得到数据库厂商的标识(驱动getDatabaseProductName()),mybatis就能根据数据库厂商标识来执行不同的sql;
MySQL,Oracle,SQL Server,xxxx
-->
<databaseIdProvider type="DB_VENDOR">
<!-- 为不同的数据库厂商起别名 -->
<property name="MySQL" value="mysql"/>
<property name="Oracle" value="oracle"/>
<property name="SQL Server" value="sqlserver"/>
</databaseIdProvider>
<!-- 将我们写好的sql映射文件(EmployeeMapper.xml)一定要注册到全局配置文件(mybatis-config.xml)中 -->
<!-- 6、mappers:将sql映射注册到全局配置中 -->
<mappers>
<!--
mapper:注册一个sql映射
注册配置文件
resource:引用类路径下的sql映射文件
mybatis/mapper/EmployeeMapper.xml
url:引用网路路径或者磁盘路径下的sql映射文件
file:///var/mappers/AuthorMapper.xml
注册接口
class:引用(注册)接口,
1、有sql映射文件,映射文件名必须和接口同名,并且放在与接口同一目录下;
2、没有sql映射文件,所有的sql都是利用注解写在接口上;
推荐:
比较重要的,复杂的Dao接口我们来写sql映射文件
不重要,简单的Dao接口为了开发快速可以使用注解;
-->
<!-- <mapper resource="mybatis/mapper/EmployeeMapper.xml"/> -->
<!-- <mapper class="com.atguigu.mybatis.dao.EmployeeMapperAnnotation"/> -->
<!-- 批量注册: -->
<package name="com.atguigu.mybatis.dao"/>
</mappers>
</configuration>