Mybatis之全局配置

Mybatis之全局配置

一 简介

1. Mybatis概述
   （1）MyBatis 是支持定制化 SQL、存储过程以及高级 映射的优秀的持久层框架。
   （2） MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
   （3）MyBatis可以使用简单的XML或注解用于配置和原 始映射，将接口和Java的POJO映射成数据库中的记 录。
2. 为什么使用Mybatis
   （1）MyBatis是一个半自动化的持久化层框架
   （2）JDBC
   – SQL夹在Java代码块里，耦合度高导致硬编码内伤
   – 维护不易且实际开发需求中sql是有变化，频繁修改的情况多见
   （3） Hibernate和JPA
   – 长难复杂SQL，对于Hibernate而言处理也不容易
   – 内部自动生产的SQL，不容易做特殊优化。
   – 基于全映射的全自动框架，大量字段的POJO进行部分映射时比较困难。 导致数据库性能下降。
   （4）对开发人员而言，核心sql还是需要自己优化
   （5）sql和java编码分开，功能边界清晰，一个专注业务、 一个专注数据

二 案例说明

1. 创建步骤
   （1）数据库创建表
   （2）创建实体对象JavaBean
   （3）创建mybatis配置文件和sql映射文件
   （4）进行测试
2. Mybatis操作数据库
   （1）创建Mybatis全局配置文件
   MyBatis 的全局配置文件包含了影响 MyBatis 行为甚深 的设置（settings）和属性（properties）信息、如数据 库连接池信息等。指导着MyBatis进行工作。我们可以 参照官方文件的配置示例。
   （2）创建SQL映射文件
   映射文件的作用就相当于是定义Dao接口的实现类如何 工作。这也是我们使用MyBatis时编写的最多的文件。
3. 测试
   （1）根据全局配置文件，利用SqlSessionFactoryBuilder创建SqlSessionFactory
   
   （2）使用SqlSessionFactory获取sqlSession对象。一个 SqlSession对象代表和数据库的一次会话。
   （3）使用SqlSession根据方法id进行操作

三 接口式编写案例说明

1. 创建步骤
   （1）创建一个Dao接口
   （2）修改Mapper文件
   （3）测试
2. 使用SqlSession获取映射器进行操作
3. SqlSession说明
   （1） SqlSession 的实例不是线程安全的，因此是不能被共享的。
   （2）SqlSession每次使用完成后需要正确关闭，这个关闭操作是必须的
   （3）SqlSession可以直接调用方法的id进行数据库操 作，但是我们一般还是推荐使用SqlSession获取 到Dao接口的代理类，执行代理对象的方法，可 以更安全的进行类型检查操作

四 Mybatis全局配置文件

1. configuration 配置
   • properties 属性
   • settings 设置
   • typeAliases 类型命名
   • typeHandlers 类型处理器
   • objectFactory 对象工厂
   • plugins 插件
   • environments 环境
   • environment 环境变量
   • transactionManager 事务管理器
   • dataSource 数据源
   • databaseIdProvider 数据库厂商标识
   • mappers 映射器
2. properties属性
   （1） 如果属性在不只一个地方进行了配置，那么 MyBatis 将按照下面的顺序来加载：
   – 在 properties 元素体内指定的属性首先被读取。
   – 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件，并覆盖已读取的同名属性。
   – 最后读取作为方法参数传递的属性，并覆盖已读取的同名属性。
3. settings设置
   这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为
4. typeAliases别名处理器
   （1）类型别名是为 Java 类型设置一个短的名字，可以方便我们引用某个类
   （2） 类很多的情况下，可以批量设置别名这个包下的每一个类 创建一个默认的别名，就是简单类名小写。
   （3） 也可以使用@Alias注解为其指定一个别名
   
   （4）MyBatis已经为许多常见的 Java 类型内建 了相应的类型别名。它们都是大小写不敏感的，我们在起 别名的时候千万不要占用已有的别名
5. 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>

6. environments环境
   （1）MyBatis可以配置多种环境，比如开发、测试和生 产环境需要有不同的配置。
   （2）每种环境使用一个environment标签进行配置并指定唯一标识符
   （3）可以通过environments标签中的default属性指定 一个环境的标识符来快速的切换环境
   id：指定当前环境的唯一标识
   transactionManager（事务管理器）、和dataSource（数据源）都必须有
7. transactionManager事务管理器
   （1）type
   ① JDBC：使用了 JDBC 的提交和回滚设置，依赖于从数 据源得到的连接来管理事务范围
   JdbcTransactionFactory
   ② MANAGED：不提交或回滚一个连接、让容器来管理 事务的整个生命周期（比如 JEE 应用服务器的上下 文）。 ManagedTransactionFactory
   ③ 自定义：实现TransactionFactory接口，type=全类名/ 别名
8. dataSource数据源
   （1）type
   ① UNPOOLED：不使用连接池， UnpooledDataSourceFactory
   ② POOLED：使用连接池， PooledDataSourceFactor
   ③ JNDI：在EJB 或应用服务器这类容器中查找指定的数据源
   ④ 自定义：实现DataSourceFactory接口，定义数据源的获取方式。
   实际开发中我们使用Spring管理数据源，并进行事务控制的配置来覆盖上述配置
9. databaseIdProvider环境
   （1） MyBatis 可以根据不同的数据库厂商执行不同的语句。
   （2）type:DB_VENDOR
   使用MyBatis提供的VendorDatabaseIdProvider解析数据库厂商标识。也可以实现DatabaseIdProvider接口来自定义。
   会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。由于通常情况下1这个字符串都非常长而且相同产品的不 同版本会返回不同的值，所以最好通过设置属性别名来使其变短
   （3） Property-name：数据库厂商标识
   （4） Property-value：为标识起一个别名，方便SQL语句使用 databaseId属性引用
   
10. MyBatis匹配规则
    （1）如果没有配置databaseIdProvider标签，那么databaseId=null
    （2）如果配置了databaseIdProvider标签，使用标签配置的name去匹 配数据库信息，匹配上设置databaseId=配置指定的值，否则依旧为 null
    （3）如果databaseId不为null，他只会找到配置databaseId的sql语句
    （4）MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库 databaseId 属性的所有语句。如果同时找到带有 databaseId 和不带 databaseId 的相同语句，则后者会被舍弃
11. mapper映射
    （1）mapper逐个注册SQL映射文件
    （2） 使用批量注册
    这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下