Mybatis之全局配置
一 简介
- Mybatis概述
(1)MyBatis 是支持定制化 SQL、存储过程以及高级 映射的优秀的持久层框架。
(2) MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
(3)MyBatis可以使用简单的XML或注解用于配置和原 始映射,将接口和Java的POJO映射成数据库中的记 录。 - 为什么使用Mybatis
(1)MyBatis是一个半自动化的持久化层框架
(2)JDBC
– SQL夹在Java代码块里,耦合度高导致硬编码内伤
– 维护不易且实际开发需求中sql是有变化,频繁修改的情况多见
(3) Hibernate和JPA
– 长难复杂SQL,对于Hibernate而言处理也不容易
– 内部自动生产的SQL,不容易做特殊优化。
– 基于全映射的全自动框架,大量字段的POJO进行部分映射时比较困难。 导致数据库性能下降。
(4)对开发人员而言,核心sql还是需要自己优化
(5)sql和java编码分开,功能边界清晰,一个专注业务、 一个专注数据
二 案例说明
- 创建步骤
(1)数据库创建表
(2)创建实体对象JavaBean
(3)创建mybatis配置文件和sql映射文件
(4)进行测试 - Mybatis操作数据库
(1)创建Mybatis全局配置文件
MyBatis 的全局配置文件包含了影响 MyBatis 行为甚深 的设置(settings)和属性(properties)信息、如数据 库连接池信息等。指导着MyBatis进行工作。我们可以 参照官方文件的配置示例。
(2)创建SQL映射文件
映射文件的作用就相当于是定义Dao接口的实现类如何 工作。这也是我们使用MyBatis时编写的最多的文件。 - 测试
(1)根据全局配置文件,利用SqlSessionFactoryBuilder创建SqlSessionFactory
(2)使用SqlSessionFactory获取sqlSession对象。一个 SqlSession对象代表和数据库的一次会话。
(3)使用SqlSession根据方法id进行操作
三 接口式编写案例说明
- 创建步骤
(1)创建一个Dao接口
(2)修改Mapper文件
(3)测试 - 使用SqlSession获取映射器进行操作
- SqlSession说明
(1) SqlSession 的实例不是线程安全的,因此是不能被共享的。
(2)SqlSession每次使用完成后需要正确关闭,这个关闭操作是必须的
(3)SqlSession可以直接调用方法的id进行数据库操 作,但是我们一般还是推荐使用SqlSession获取 到Dao接口的代理类,执行代理对象的方法,可 以更安全的进行类型检查操作
四 Mybatis全局配置文件
- configuration 配置
• properties 属性
• settings 设置
• typeAliases 类型命名
• typeHandlers 类型处理器
• objectFactory 对象工厂
• plugins 插件
• environments 环境
• environment 环境变量
• transactionManager 事务管理器
• dataSource 数据源
• databaseIdProvider 数据库厂商标识
• mappers 映射器 - properties属性
(1) 如果属性在不只一个地方进行了配置,那么 MyBatis 将按照下面的顺序来加载:
– 在 properties 元素体内指定的属性首先被读取。
– 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件,并覆盖已读取的同名属性。
– 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。 - settings设置
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为 - typeAliases别名处理器
(1)类型别名是为 Java 类型设置一个短的名字,可以方便我们引用某个类
(2) 类很多的情况下,可以批量设置别名这个包下的每一个类 创建一个默认的别名,就是简单类名小写。
(3) 也可以使用@Alias注解为其指定一个别名
(4)MyBatis已经为许多常见的 Java 类型内建 了相应的类型别名。它们都是大小写不敏感的,我们在起 别名的时候千万不要占用已有的别名 - typeHandlers类型处理
(1)无论是 MyBatis 在预处理语句(PreparedStatement)中 设置一个参数时,还是从结果集中取出一个值时, 都会 用类型处理器将获取的值以合适的方式转换成 Java 类型
(2)日期类型的处理
① 日期和时间的处理,JDK1.8以前一直是个头疼的 问题。我们通常使用JSR310规范领导者Stephen Colebourne创建的Joda-Time来操作。1.8已经实 现全部的JSR310规范了。
② 日期时间处理上,我们可以使用MyBatis基于 JSR310(Date and Time API)编写的各种日期时间类型处理器
③ MyBatis3.4以前的版本需要我们手动注册这些处 理器,以后的版本都是自动注册的
(3)自定义类型处理器
我们可以重写类型处理器或创建自己的类型处理 器来处理不支持的或非标准的类型。
步骤:
① 实现org.apache.ibatis.type.TypeHandler接口或 者继承org.apache.ibatis.type.BaseTypeHandler
② 指定其映射某个JDBC类型(可选操作)
③ 在mybatis全局配置文件中注册
④ 使用自定义的类型处理器
步骤一:
//敏感字段加密解密处理器
public class MyTypeHandle implements TypeHandler<String> {
private static String KEY = "123456";
@Override
public void setParameter(PreparedStatement preparedStatement, int i, String s, JdbcType jdbcType) throws SQLException {
try {
String encrypt = DESUtil.encrypt(s, KEY);//加密
preparedStatement.setString(i, encrypt);
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public String getResult(ResultSet resultSet, String s) throws SQLException {
String result = resultSet.getString(s);
if (StringUtils.isNotEmpty(result)) {
try {
return DESUtil.decrypt(result, KEY);//解密
} catch (Exception e) {
e.printStackTrace();
}
}
return result;
}
@Override
public String getResult(ResultSet resultSet, int i) throws SQLException {
String result = resultSet.getString(i);
if (StringUtils.isNotEmpty(result)) {
try {
return DESUtil.decrypt(result, KEY);
} catch (Exception e) {
e.printStackTrace();
}
}
return result;
}
@Override
public String getResult(CallableStatement callableStatement, int i) throws SQLException {
String result = callableStatement.getString(i);
if (StringUtils.isNotEmpty(result)) {
try {
return DESUtil.decrypt(result, KEY);
} catch (Exception e) {
e.printStackTrace();
}
}
return result;
}
}
步骤二:
<!--自定义类型处理器-->
<typeHandlers>
<typeHandler handler="com.mdd.mybatis.typehandle.MyTypeHandle"></typeHandler>
</typeHandlers>
步骤三:
<?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.mdd.mybatis.dao.UserDao" >
<resultMap id="BaseResultMap" type="com.mdd.mybatis.dao.vo.User">
<id column="user_id" property="userId" jdbcType="VARCHAR"/>
<result column="name" property="name" typeHandler="com.mdd.mybatis.typehandle.MyTypeHandle"/>
<result column="password" property="password" jdbcType="VARCHAR"/>
<result column="age" property="age" jdbcType="INTEGER"/>
</resultMap>
<sql id="Base_Column_List" >
user_id,name,password, age
</sql>
<insert id="saveUser">
INSERT INTO t_user(user_id,name, password, age) VALUES (
#{userId,jdbcType=VARCHAR},#{name,jdbcType=VARCHAR},
#{password,jdbcType=VARCHAR},#{age,jdbcType=INTEGER}
)
</insert>
<insert id="saveUserWithType">
INSERT INTO t_user(user_id,name, password, age) VALUES (
#{userId,jdbcType=VARCHAR},#{name,typeHandler=com.mdd.mybatis.typehandle.MyTypeHandle},
#{password,jdbcType=VARCHAR},#{age,jdbcType=INTEGER}
)
</insert>
<select id="queryUser" resultMap="BaseResultMap">
select * from t_user where user_id = #{userId,jdbcType=VARCHAR}
</select>
</mapper>
- environments环境
(1)MyBatis可以配置多种环境,比如开发、测试和生 产环境需要有不同的配置。
(2)每种环境使用一个environment标签进行配置并指定唯一标识符
(3)可以通过environments标签中的default属性指定 一个环境的标识符来快速的切换环境
id:指定当前环境的唯一标识
transactionManager(事务管理器)、和dataSource(数据源)都必须有 - transactionManager事务管理器
(1)type
① JDBC:使用了 JDBC 的提交和回滚设置,依赖于从数 据源得到的连接来管理事务范围
JdbcTransactionFactory
② MANAGED:不提交或回滚一个连接、让容器来管理 事务的整个生命周期(比如 JEE 应用服务器的上下 文)。 ManagedTransactionFactory
③ 自定义:实现TransactionFactory接口,type=全类名/ 别名 - dataSource数据源
(1)type
① UNPOOLED:不使用连接池, UnpooledDataSourceFactory
② POOLED:使用连接池, PooledDataSourceFactor
③ JNDI:在EJB 或应用服务器这类容器中查找指定的数据源
④ 自定义:实现DataSourceFactory接口,定义数据源的获取方式。
实际开发中我们使用Spring管理数据源,并进行事务控制的配置来覆盖上述配置 - databaseIdProvider环境
(1) MyBatis 可以根据不同的数据库厂商执行不同的语句。
(2)type:DB_VENDOR
使用MyBatis提供的VendorDatabaseIdProvider解析数据库厂商标识。也可以实现DatabaseIdProvider接口来自定义。
会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。由于通常情况下1这个字符串都非常长而且相同产品的不 同版本会返回不同的值,所以最好通过设置属性别名来使其变短
(3) Property-name:数据库厂商标识
(4) Property-value:为标识起一个别名,方便SQL语句使用 databaseId属性引用
- MyBatis匹配规则
(1)如果没有配置databaseIdProvider标签,那么databaseId=null
(2)如果配置了databaseIdProvider标签,使用标签配置的name去匹 配数据库信息,匹配上设置databaseId=配置指定的值,否则依旧为 null
(3)如果databaseId不为null,他只会找到配置databaseId的sql语句
(4)MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。如果同时找到带有 databaseId 和不带 databaseId 的相同语句,则后者会被舍弃 - mapper映射
(1)mapper逐个注册SQL映射文件
(2) 使用批量注册
这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下