MyBatis

MyBatis简介 1、MyBatis历史

• MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下， iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github。

• iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。 iBatis提供的持久层框架包括SQL Maps和Data Access Objects（DAO）。

.
.

2、MyBatis特性

• MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
• MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old JavaObjects，普通的Java对象）映射成数据库中的记录
• MyBatis 是一个 半自动的ORM（Object Relation Mapping）框架

.
.

3、MyBatis下载

• MyBatis下载地址：https://github.com/mybatis/mybatis-3

.
.

4、和其它持久化层技术对比

• JDBC
  ① SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
  ② 维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
  ③ 代码冗长，开发效率低

• Hibernate 和 JPA
  ① 操作简便，开发效率高
  ② 程序中的长难复杂 SQL 需要绕过框架
  ③ 内部自动生产的 SQL，不容易做特殊优化
  ④ 基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
  ⑤ 反射操作太多，导致数据库性能下降

• MyBatis
  ① 轻量级，性能出色
  ② SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
  ③ 开发效率稍逊于HIbernate，但是完全能够接受

.
.
.

Mybatis基本用法

.
.

一、搭建框架开发环境

1、导入Maven依赖

.

2、Mybatis 全局配置文件

• 习惯上命名为 mybatis-config.xml

注意：配置文件存放的位置是src/main/resources目录下。

.

3、Mapper 接口
Mybatis 中的 Mapper 接口相当于以前的 Dao。但是区别在于，Mapper 仅仅只是建接口即可，我们不需要提供实现类。

.

4、Mybatis 映射文件

• 注意：Mapper.xml所在的目录要和mybatis-config.xml中使用mapper标签配置的一致。
  
  注意：
• 方法名和SQL的id一致
• 方法返回值和resultType一致
• 方法的参数和SQL的参数一致
• 接口的全类名和映射配置文件的名称空间一致

注意：由于Mapper接口中方法名是作为SQL语句标签的id，不能重复，所以Mapper接口中不能出现重名的方法，不允许重载！

.

5、junit测试代码

说明：

• SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）
• SqlSessionFactory：是“生产”SqlSession的“工厂”。

工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象。

.

刚开始接触框架，我们会认为Java程序会转入XML配置文件中执行，但其实框架会在初始化时将XML文件读取进来，封装到对象中，再然后就都是Java代码的执行了，XML中的配置是没法执行的。

.
.

二、强化基本配置

1、加入日志

• ① 目的：
  在Mybatis工作过程中，通过打印日志的方式，将要执行的SQL语句打印出来
• ②操作

加入依赖
	
	
	    log4j
	    log4j
	    1.2.17
	

• ③ 加入log4j的配置文件
  支持 XML 和 properties 属性文件两种形式。无论使用哪种形式，文件名是固定的：
  log4j.xml
  log4j.properties

xml配置：
	
	
	    
	
	    
	    
	        
	        
	            
	        
	    
	    
	        
	    
	    
	        
	    
	    
	        
	        
	    
	

日志的级别

• FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)
  从左到右打印的内容越来越详细

• ④STDOUT
  是standard output的缩写，意思是标准输出。对于Java程序来说，打印到标准输出就是打印到控制台。

.
.

2、关联外部属性文件
在实际开发时，同一套代码往往会对应多个不同的具体服务器环境。使用的数据库连接参数也不同。为了更好的维护这些信息，我们建议把数据库连接信息提取到Mybatis全局配置文件外边。

• 创建jdbc.properties配置文件
  
• 在Mybatis全局配置文件中指定外部jdbc.properties文件的位置
  
• 在Mybatis全局配置文件中需要具体属性值的时候使用${key}格式引用属性配置文件中的键
  
  .

3、给类配置别名，简便在映射中的操作

.

4、在MyBatis核心配置文件中配置映射文件 --> 以包为单位

.
.
.

MyBatis获取参数值的两种方式（重点） 一、简介

• MyBatis获取参数值的两种方式：${}和#{}
• ${}的本质就是字符串拼接，#{}的本质就是占位符赋值
• ${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

1、#{}方式
Mybatis会在运行过程中，把配置文件中的SQL语句里面的#{}转换为“?”占位符，发送给数据库执行。

• ① 配置文件中的SQL：
  
• ② 实际执行的SQL：
  
  .

2、${}方式

将会根据${}拼字符串

• ①SQL语句

    select emp_id empId,emp_name empName,emp_salary empSalary from t_emp where emp_name like '%${empName}%'

• ② 实际打印的SQL

select emp_id empId,emp_name empName,emp_salary empSalary from t_emp where emp_name like '%r%'

.

3、注意

• 在SQL语句中，数据库表的表名不确定，需要外部动态传入，此时不能使用#{}，因为 SQL 语法不允许表名位置使用问号占位符，此时只能使用${}。

• 其他情况，只要能用#{}肯定不用${}，避免SQL注入。

.
.

二、各种参数情况

1、单个字面量类型的参数

• 此时可以使用 ${} 和 #{} 以任意的名称 (获以@Param注解定义键的方式) 获取参数的值，注意 ${} 需要手动加单引号

.

2、多个字面量类型的参数

• 此时MyBatis会自动将这些参数放在一个map集合中：
• ① 以arg0,arg1…为键，以参数为值；
• ② 以param1,param2…为键，以参数为值；
• 因此只需要通过 ${} 和 #{} 访问map集合的键就可以获取相对应的值，注意 ${} 需要手动加单引号

.

3、map集合类型的参数

• 若mapper接口中的方法需要的参数为多个时，此时可以手动创建map集合，
• 将这些数据放在map中只需要通过 ${} 和#{}访问map集合的键就可以获取相对应的值，注意 ${} 需要手动加单引号

.

4、实体类类型的参数

• 此时可以使用 ${} 和#{}，通过访问实体类对象中的属性名获取属性值，注意 ${} 需要手动加单引号

.

5、使用@Param标识参数

• 此时，会将这些参数放在map集合中：
• ① 以@Param注解的value属性值为键，以参数为值；
• ② 以param1,param2…为键，以参数为值；
• 只需要通过 ${} 和 #{} 访问map集合的键就可以获取相对应的值，注意 ${} 需要手动加单引号

.
.
.

MyBatis查询功能

.
.

一、MyBatis的各种查询功能

1、查询一个实体类对象

.

2、查询一个list集合

.

3、查询单个数据

.

4、查询一条数据为map集合

.

5、查询多条数据为map集合

• 方式一：
  

• 方式二：
  

.
.

二、特殊SQL的执行

1、模糊查询

.

2、批量删除

.

3、动态设置表名

.

4、添加功能获取自增的主键

• 例如：
  t_clazz(clazz_id,clazz_name)
  t_student(student_id,student_name,clazz_id)
  1、添加班级信息
  2、获取新添加的班级的id
  3、为班级分配学生

.

个人总结：

• #{} 和 ${} 主要理解针对于赋的值为字符串形式的 一个自动加 ’ ’ ，一个不加 ’ ’

.
.
.

自定义映射resultMap 一、resultMap处理字段和属性的映射关系

1、问题引入：若字段名和实体类中的属性名不一致，但是字段名符合数据库的规则（使用_），实体类中的属性 名符合Java的规则（使用驼峰）

.

2、通过以下三种方式处理字段名和实体类中的属性的映射关系

• ① 可以通过为字段起别名的方式，保证和实体类中的属性名保持一致。

• ② 可以在MyBatis的核心配置文件中设置一个全局配置信息mapUnderscoreToCamelCase，可以在查询表中数据时，自动将_类型的字段名转换为驼峰。
  
  例如：字段名user_name，设置了mapUnderscoreToCamelCase，此时字段名就会转换为userName

• ③ 可以通过resultMap设置自定义映射
  但使用resultMap一般都是处理一对多，多对一情况~
  

.
.

二、多对一映射处理

员工表为主表，获取员工类的实例并给员工类中的部门属性赋值

方式1、级联方式处理映射关系

.

方式2、使用association处理映射关系

.

方式3、分步查询（常用）

• 第一步：查询员工信息
  
• 第二步：根据员工所对应的部门id查询部门信息
  

.
.

三、一对多映射处理

部门表为主表，获取部门类的实例并给部门类中员工集合的属性赋值

方式1、使用collection标签

.

方式2、分步查询

• 第一步：查询部门信息
  

• 第二步：根据部门id查询部门中的所有员工
  员工的Mapper接口中的返回值对应 collection标签中参数(emps)的类型
  

.

分步查询的优点：可以实现延迟加载，但是必须在核心配置文件中设置全局配置信息：
lazyLoadingEnabled：延迟加载的全局开关。当开启时，所有关联对象都会延迟加载
aggressiveLazyLoading：当开启时，任何方法的调用都会加载该对象的所有属性。 否则，每个属性会按需加载
此时就可以实现按需加载，获取的数据是什么，就只会执行相应的sql。此时可通过association和
collection中的fetchType属性设置当前的分步查询是否使用延迟加载，fetchType=“lazy(延迟加
载)|eager(立即加载)”

.
.
.

动态SQL

Mybatis框架的动态SQL技术是一种根据特定条件动态拼装SQL语句的功能，它存在的意义是为了解决拼接SQL语句字符串时的痛点问题。

一、if

if标签可通过test属性的表达式进行判断，若表达式的结果为true，则标签中的内容会执行；反之标签中的内容不会执行

.
.

二、where

where和if一般结合使用

• 若where标签中的if条件都不满足，则where标签没有任何功能，即不会添加where关键字
• 若where标签中的if条件满足，则where标签会自动添加where关键字，并将条件最前方多余的and去掉

注意：where标签不能去掉条件最后多余的and或or，只能去掉前面多余的and或or

.
.

三、trim

trim用于去掉或添加标签中的内容

• 常用属性：
  prefix：在trim标签中的内容的前面添加某些内容
  prefixOverrides：在trim标签中的内容的前面去掉某些内容
  suffix：在trim标签中的内容的后面添加某些内容
  suffixOverrides：在trim标签中的内容的后面去掉某些内容
  

.
.

四、choose、when、otherwise

choose、when、otherwise相当于if...else if..else

.
.

五、foreach

• 属性：
  collection：设置要循环的数组或集合
  item：表示集合或数组中的每一个数据
  separator：设置循环体之间的分隔符
  open：设置foreach标签中的内容的开始符
  close：设置foreach标签中的内容的结束符
  

.
.

六、SQL片段

• sql片段，可以记录一段公共sql片段，在使用的地方通过include标签进行引入
  

.
.
.

MyBatis的缓存 一、MyBatis的一级缓存

1、简介

• 一级缓存是SqlSession级别的，通过同一个SqlSession查询的数据会被缓存，下次查询相同的数据，就会从缓存中直接获取，不会从数据库重新访问。
  .

2、使一级缓存失效的四种情况

• 不同的SqlSession对应不同的一级缓存
• 同一个SqlSession但是查询条件不同
• 同一个SqlSession两次查询期间执行了任何一次增删改操作
• 同一个SqlSession两次查询期间手动清空了缓存

.
.

二、MyBatis的二级缓存

1、简介

• 二级缓存是SqlSessionFactory级别，通过同一个SqlSessionFactory创建的SqlSession查询的结果会被缓存；此后若再次执行相同的查询语句，结果就会从缓存中获取。

.

2、二级缓存开启的条件

• ① 在核心配置文件中，设置全局配置属性cacheEnabled="true"，默认为true，不需要设置
• ② 在映射文件中设置标签
• ③ 二级缓存必须在SqlSession关闭或提交之后有效
• ④ 查询的数据所转换的实体类类型必须实现序列化的接口

.

3、使二级缓存失效的情况

• 两次查询之间执行了任意的增删改，会使一级和二级缓存同时失效

.

4、二级缓存的相关配置

• 在mapper配置文件中添加的cache标签可以设置一些属性
  

.

5、MyBatis缓存查询的顺序

• 先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用。
• 如果二级缓存没有命中，再查询一级缓存
• 如果一级缓存也没有命中，则查询数据库
• SqlSession关闭之后，一级缓存中的数据会写入二级缓存

.
.

三、整合第三方缓存EHCache

只能代替二级缓存，不能代替一级缓存

1、添加依赖

• 各jar包功能
  

.

2、创建EHCache的配置文件ehcache.xml

.

3、设置二级缓存的类型

.

4、加入logback日志

• 创建logback的配置文件logback.xml
  

.

5、EHCache配置文件说明

.
.
.

MyBatis的逆向工程

• 正向工程：先创建Java实体类，由框架负责根据实体类生成数据库表。Hibernate是支持正向工程的。
• 逆向工程：先创建数据库表，由框架负责根据数据库表，反向生成如下资源：
  ① Java实体类
  ② Mapper接口
  ③ Mapper映射文件

一、创建逆向工程的步骤

• 1、添加依赖和插件
  
• 2、创建MyBatis的核心配置文件：和之前一样主要是为了操作增删改查的方法和创建逆向工厂无关。
• 3、创建逆向工程的配置文件
  文件名必须是：generatorConfig.xml
  
• 4、执行MBG插件的generate目标
  

.
.

二、逆向工程的QBC查询

.
.

三、分页插件

1、分页插件使用步骤

• ① 添加依赖
  
• ② 配置分页插件
  

.

2、分页插件的使用

• ① 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能

pageNum：当前页的页码
pageSize：每页显示的条数

• ② 在查询获取list集合之后，使用PageInfo pageInfo = new PageInfo<>(List list, intnavigatePages)获取分页相关数据

list：分页之后的数据
navigatePages：导航分页的页码数

• 分页相关数据
  

• 常用数据：
  pageNum：当前页的页码
  pageSize：每页显示的条数
  size：当前页显示的真实条数
  total：总记录数
  pages：总页数
  prePage：上一页的页码
  nextPage：下一页的页码
  isFirstPage/isLastPage：是否为第一页/最后一页
  hasPreviousPage/hasNextPage：是否存在上一页/下一页
  navigatePages：导航分页的页码数
  navigatepageNums：导航分页的页码，[1,2,3,4,5]