第1章 MyBatis简介

MyBatis框架

尚硅谷java研究院

版本：V 1.0

第1章 MyBatis简介

1.1 MyBatis历史

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

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

1.2 MyBatis简介

1. MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架

2. MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集

3. MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录

4. 半自动ORM（Object Relation Mapping`）框架

1.3 为什么要使用MyBatis – 现有持久化技术的对比

1. JDBC

1. SQL夹在Java代码块里，耦合度高导致硬编码内伤

2. 维护不易且实际开发需求中sql是有变化，频繁修改的情况多见

2. Hibernate和JPA

1. 长难复杂SQL，对于Hibernate而言处理也不容易

2. 内部自动生产的SQL，不容易做特殊优化

3. 基于全映射的全自动框架，大量字段的POJO进行部分映射时比较困难。导致数据库性能下降

3. MyBatis

1. 对开发人员而言，核心sql还是需要自己优化

2. sql和java编码分开，功能边界清晰，一个专注业务、一个专注数据

1.4 如何下载MyBatis

1. 下载网址

https://github.com/mybatis/mybatis-3/

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1PFS411W-1599703793287)(media/image1.png)]{width=“5.141510279965004in” height=“2.6034722222222224in”}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sx0XBz3H-1599703793289)(media/image2.png)]{width=“5.537738407699037in” height=“0.9722222222222222in”}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qt3FA6BS-1599703793291)(media/image3.png)]{width=“4.839622703412074in” height=“2.5748468941382328in”}

第2章 MyBatis HelloWorld

2.1 开发环境的准备

1. 导入MyBatis框架的jar包、Mysql驱动包、log4j的jar包

±--------------------------------------+
| > myBatis-3.4.1.jar |
| > |
| > mysql-connector-java-5.1.37-bin.jar |
| > |
| > log4j.jar |
±--------------------------------------+

2. 导入log4j 的配置文件

±--------------------------------------------------------------------------------------------+
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
±--------------------------------------------------------------------------------------------+

2.2 创建测试表

±---------------------------------------+
| – 创建库 |
| |
| CREATE DATABASE test_mybatis; |
| |
| – 使用库 |
| |
| USE test_mybatis; |
| |
| – 创建表 |
| |
| CREATE TABLE tbl_employee( |
| |
| id INT(11) PRIMARY KEY AUTO_INCREMENT, |
| |
| last_name VARCHAR(50), |
| |
| email VARCHAR(50), |
| |
| gender CHAR(1) |
| |
| ); |
±---------------------------------------+

2.3 创建javaBean

±--------------------------------------------------------------------------------------------------------------------------+
| public class Employee { |
| |
| private Integer id ; |
| |
| private String lastName; |
| |
| private String email ; |
| |
| private String gender ; |
| |
| public Integer getId() { |
| |
| return id; |
| |
| } |
| |
| public void setId(Integer id) { |
| |
| this.id = id; |
| |
| } |
| |
| public String getLastName() { |
| |
| return lastName; |
| |
| } |
| |
| public void setLastName(String lastName) { |
| |
| this.lastName = lastName; |
| |
| } |
| |
| public String getEmail() { |
| |
| return email; |
| |
| } |
| |
| public void setEmail(String email) { |
| |
| this.email = email; |
| |
| } |
| |
| public String getGender() { |
| |
| return gender; |
| |
| } |
| |
| public void setGender(String gender) { |
| |
| this.gender = gender; |
| |
| } |
| |
| @Override |
| |
| public String toString() { |
| |
| return “Employee [id=” + id + “, lastName=” + lastName + “, email=” + email + “, gender=” + gender + “]”; |
| |
| } |
±--------------------------------------------------------------------------------------------------------------------------+

2.3 创建MyBatis的全局配置文件

1. 参考MyBatis的官网手册

±-----------------------------------------------------------------------------------+
| “1.0” encoding=“UTF-8” ?> |
| |
| | |
| PUBLIC “-//mybatis.org//DTD Config 3.0//EN” |
| |
| “http://mybatis.org/dtd/mybatis-3-config.dtd”> |
| |
| |
| |
| |
| |
| “development”> |
| |
| “development”> |
| |
| “JDBC” /> |
| |
| “POOLED”> |
| |
| “driver” value=“com.mysql.jdbc.Driver” /> |
| |
| “url” value=“jdbc:mysql://localhost:3306/mybatis_1129” /> |
| |
| “username” value=“root” /> |
| |
| “password” value=“1234” /> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| “EmployeeMapper.xml” /> |
| |
| |
| |
| |
±-----------------------------------------------------------------------------------+

2.4 创建Mybatis的sql映射文件

1. 参考MyBatis的官方手册

±--------------------------------------------------------------------------------------------+
| “1.0” encoding=“UTF-8” ?> |
| |
| | |
| PUBLIC “-//mybatis.org//DTD Mapper 3.0//EN” |
| |
| “http://mybatis.org/dtd/mybatis-3-mapper.dtd”> |
| |
| “suibian”> |
| |
| “selectEmployee” resultType=“com.atguigu.myabtis.helloWorld.Employee”> |
| |
| select id ,last_name lastName ,email ,gender from tbl_employee where id = #{id} |
| |
| |
| |
| |
| |
| |
±--------------------------------------------------------------------------------------------+

2.5 测试

1. 参考MyBatis的官方手册

±---------------------------------------------------------------------+
| @Test |
| |
| public void test() throws Exception { |
| |
| String resource = “mybatis-config.xml”; |
| |
| InputStream inputStream = Resources.getResourceAsStream(resource); |
| |
| SqlSessionFactory sqlSessionFactory = |
| |
| new SqlSessionFactoryBuilder().build(inputStream); |
| |
| System.out.println(sqlSessionFactory); |
| |
| SqlSession session = sqlSessionFactory.openSession(); |
| |
| try { |
| |
| Employee employee = |
| |
| session.selectOne(“suibian.selectEmployee”, 1001); |
| |
| System.out.println(employee); |
| |
| } finally { |
| |
| session.close(); |
| |
| } |
| |
| } |
±---------------------------------------------------------------------+

2.6 Mapper接口开发MyBatis HelloWorld

1. 编写Mapper接口

±--------------------------------------------------+
| public interface EmployeeMapper { |
| |
| public Employee getEmployeeById(Integer id ); |
| |
| } |
±--------------------------------------------------+

2. 完成两个绑定

1. Mapper接口与Mapper映射文件的绑定

在Mppper映射文件中的标签中的namespace中必须指定Mapper接口

的全类名

2. Mapper映射文件中的增删改查标签的id必须指定成Mapper接口中的方法名.

3. 获取Mapper接口的代理实现类对象

±-----------------------------------------------------------+
| @Test |
| |
| public void test() throws Exception{ |
| |
| String resource = “mybatis-config.xml”; |
| |
| InputStream inputStream = |
| |
| Resources.getResourceAsStream(resource); |
| |
| SqlSessionFactory sqlSessionFactory = |
| |
| new SqlSessionFactoryBuilder() |
| |
| .build(inputStream); |
| |
| SqlSession session = |
| |
| sqlSessionFactory.openSession(); |
| |
| try { |
| |
| //[Mapper]{.ul}接口:获取[Mapper]{.ul}接口的 代理实现类对象 |
| |
| EmployeeMapper mapper = |
| |
| session.getMapper(EmployeeMapper.class); |
| |
| Employee employee = |
| |
| mapper.getEmployeeById(1006); |
| |
| System.out.println(employee); |
| |
| } finally { |
| |
| session.close(); |
| |
| } |
| |
| } |
±-----------------------------------------------------------+

第3章 MyBatis全局配置文件

3.1 MyBatis全局配置文件简介

1. The MyBatis configuration contains settings and properties that have a dramatic effect on how MyBatis behaves.

MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置（settings）和属性（properties）信息。

2. 文件结构如下:

configuration 配置

properties 属性

settings 设置

typeAliases 类型命名

typeHandlers 类型处理器

objectFactory 对象工厂

plugins 插件

environments 环境

environment 环境变量

transactionManager 事务管理器

dataSource 数据源

databaseIdProvider 数据库厂商标识

mappers 映射器

3.2 properties属性

1. 可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来配置

±---------------------------------------------------------------+
| |
| |
| |
| |
| | |
| value=“jdbc:mysql://localhost:3306/test_mybatis” /> |
| |
| |
| |
| |
| |
| |
±---------------------------------------------------------------+

2. 然而properties的作用并不单单是这样，你可以创建一个资源文件，名为jdbc.properties的文件,将四个连接字符串的数据在资源文件中通过键值 对(key=value)的方式放置，不要任何符号，一条占一行

±---------------------------------------------------------+
| jdbc.driver=com.mysql.jdbc.Driver |
| |
| jdbc.url=jdbc:mysql://[localhost]{.ul}:3306/mybatis_1129 |
| |
| jdbc.username=root |
| |
| jdbc.password=1234 |
±---------------------------------------------------------+

±------------------------------------------------------------+
| |
| |
| “db.properties” > |
±------------------------------------------------------------+

3)在environment元素的dataSource元素中为其动态设置

±-------------------------------------------------------------+
| “oracle”> |
| |
| “mysql”> |
| |
| “JDBC” /> |
| |
| “POOLED”> |
| |
| “driver” value="${jdbc.driver}" /> |
| |
| “url” value="${jdbc.url}" /> |
| |
| “username” |
| |
| value="${jdbc.username}" /> |
| |
| “password” |
| |
| value="${jdbc.password}" /> |
| |
| |
| |
| |
| |
| |
±-------------------------------------------------------------+

3.3 settings设置

1. 这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

2. 包含如下的setting设置:

±--------------------------------------------------------------------------+
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| \ |
| | |
| value=“equals,clone,hashCode,toString”/>\ |
| |
±--------------------------------------------------------------------------+

3.4 typeAliases 别名处理

1. 类型别名是为 Java 类型设置一个短的名字，可以方便我们引用某个类。

±----------------------------------------------------------+
| |
| |
| “com.atguigu.mybatis.beans.Employee” |
| |
| alias=“emp”/> |
| |
| |
±----------------------------------------------------------+

2. 类很多的情况下，可以批量设置别名这个包下的每一个类创建一个默认的别名，就是简单类名小写

±--------------------------------------------------+
| |
| |
| “com.atguigu.mybatis.beans”/> |
| |
| |
±--------------------------------------------------+

3. MyBatis已经取好的别名

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-d01d4dmN-1599703793293)(media/image4.png)]{width=“5.757638888888889in” height=“2.6909722222222223in”}

3.5 environments 环境配置

1. MyBatis可以配置多种环境，比如开发、测试和生产环境需要有不同的配置

2. 每种环境使用一个environment标签进行配置并指定唯一标识符

3. 可以通过environments标签中的default属性指定一个环境的标识符来快速的切换环境

4. environment-指定具体环境

id：指定当前环境的唯一标识

transactionManager、和dataSource都必须有

±-----------------------------------------------------------------+
| “oracle”> |
| |
| “mysql”> |
| |
| “JDBC” /> |
| |
| “POOLED”> |
| |
| “driver” value="${jdbc.driver}" /> |
| |
| “url” value="${jdbc.url}" /> |
| |
| “username” value="${jdbc.username}" /> |
| |
| “password” value="${jdbc.password}" /> |
| |
| |
| |
| |
| |
| “oracle”> |
| |
| “JDBC”/> |
| |
| “POOLED”> |
| |
| “driver” value="${orcl.driver}" /> |
| |
| “url” value="${orcl.url}" /> |
| |
| “username” value="${orcl.username}" /> |
| |
| “password” value="${orcl.password}" /> |
| |
| |
| |
| |
| |
| |
±-----------------------------------------------------------------+

5. transactionManager

type： JDBC | MANAGED | 自定义

JDBC：使用了 JDBC 的提交和回滚设置，依赖于从数据源得到的连接来管理事务范 围。 JdbcTransactionFactory

MANAGED：不提交或回滚一个连接、让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 ManagedTransactionFactory

自定义：实现TransactionFactory接口，type=全类名/别名

6. dataSource

type： UNPOOLED | POOLED | JNDI | 自定义

UNPOOLED：不使用连接池， UnpooledDataSourceFactory

POOLED：使用连接池， PooledDataSourceFactory

JNDI： 在EJB 或应用服务器这类容器中查找指定的数据源

自定义：实现DataSourceFactory接口，定义数据源的获取方式。

7. 实际开发中我们使用Spring管理数据源，并进行事务控制的配置来覆盖上述配置

3.6 mappers 映射器

1. 用来在mybatis初始化的时候，告诉mybatis需要引入哪些Mapper映射文件

2. mapper逐个注册SQL映射文件

resource : 引入类路径下的文件

url : 引入网络路径或者是磁盘路径下的文件

class : 引入Mapper接口.

有SQL映射文件 , 要求Mapper接口与 SQL映射文件同名同位置.

没有SQL映射文件 , 使用注解在接口的方法上写SQL语句.

±---------------------------------------------------------------+
| |
| |
| “EmployeeMapper.xml” /> |
| |
| “com.atguigu.mybatis.dao.EmployeeMapper”/> |
| |
| “com.atguigu.mybatis.dao”/> |
| |
| |
±---------------------------------------------------------------+

3. 使用批量注册，这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下

±------------------------------------------------+
| |
| |
| “com.atguigu.mybatis.dao”/> |
| |
| |
±------------------------------------------------+

第4章 MyBatis 映射文件

4.1 Mybatis映射文件简介

1. MyBatis 的真正强大在于它的映射语句，也是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 就是针对 SQL 构建的，并且比普通的方法做的更好。

2. SQL 映射文件有很少的几个顶级元素（按照它们应该被定义的顺序）：

cache – 给定命名空间的缓存配置。

cache-ref – 其他命名空间缓存配置的引用。

resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加 载对象。

parameterMap – 已废弃！老式风格的参数映射。内联参数是首选,这个元素可能 在将来被移除，这里不会记录。

sql – 可被其他语句引用的可重用语句块。

insert – 映射插入语句

update – 映射更新语句

delete – 映射删除语句

select – 映射查询语

4.2 Mybatis使用insert|update|delete|select完成CRUD

4.2.1 select

1. Mapper接口方法

---

public Employee getEmployeeById(Integer id );

2. Mapper映射文件

±-------------------------------------------------------+
| “getEmployeeById” |
| |
| resultType=“com.atguigu.mybatis.beans.Employee” |
| |
| databaseId=“mysql”> |
| |
| select * from tbl_employee where id = ${_parameter} |
| |
| |
±-------------------------------------------------------+

4.2.2 insert

1. Mapper接口方法

---

public Integer insertEmployee(Employee employee);

2. Mapper映射文件

±-------------------------------------------------------------------------------------------+
| “insertEmployee” |
| |
| parameterType=“com.atguigu.mybatis.beans.Employee” |
| |
| databaseId=“mysql”> |
| |
| insert into tbl_employee(last_name,email,gender) values(#{lastName},#{email},#{gender}) |
| |
| |
±-------------------------------------------------------------------------------------------+

4.2.3 update

1. Mapper接口方法

---

public Boolean updateEmployee(Employee employee);

2. Mapper映射文件

±--------------------------------------------------+
| “updateEmployee” > |
| |
| update tbl_employee set last_name = #{lastName}, |
| |
| email = #{email}, |
| |
| gender = #{gender} |
| |
| where id = #{id} |
| |
| |
±--------------------------------------------------+

4.2.4 delete

1. Mapper接口方法

---

public void deleteEmployeeById(Integer id );

2. Mapper映射文件

±-------------------------------------------+
| “deleteEmployeeById” > |
| |
| delete from tbl_employee where id = #{id} |
| |
| |
±-------------------------------------------+

主键生成方式、获取主键值

4.3.1 主键生成方式

1. 支持主键自增，例如MySQL数据库

2. 不支持主键自增，例如Oracle数据库

4.3.2 获取主键值

1. 若数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），则可以设置 useGeneratedKeys=“true”，然后再把 keyProperty 设置到目标属性上。

±-------------------------------------------------------------------------------------------+
| “insertEmployee” parameterType=“com.atguigu.mybatis.beans.Employee” |
| |
| databaseId=“mysql” |
| |
| useGeneratedKeys=“true” |
| |
| keyProperty=“id”> |
| |
| insert into tbl_employee(last_name,email,gender) values(#{lastName},#{email},#{gender}) |
| |
| |
±-------------------------------------------------------------------------------------------+

4.4 参数传递

4.4.1 参数传递的方式

1. 单个普通(基本/包装+String)参数

这种情况MyBatis可直接使用这个参数，不需要经过任 何处理。

取值:#{随便写}

2. 多个参数

任意多个参数，都会被MyBatis重新包装成一个Map传入。Map的key是param1，param2，或者0，1…，值就是参数的值

取值: #{0 1 2 …N / param1 param2 … paramN}

3. 命名参数

为参数使用@Param起一个名字，MyBatis就会将这些参数封装进map中，key就是我们自己指定的名字

取值: #{自己指定的名字 / param1 param2 … paramN}

4. POJO

当这些参数属于我们业务POJO时，我们直接传递POJO

取值: #{POJO的属性名}

5. Map

我们也可以封装多个参数为map，直接传递

取值: #{使用封装Map时自己指定的key}

6. Collection/Array

会被MyBatis封装成一个map传入, Collection对应的key是collection,Array对应的key是array. 如果确定是List集合，key还可以是list.

取值:

Array: #{array}

Collection(List/Set): #{collection}

List : #{collection / list}

4.4.2 参数传递源码分析

1. 以命名参数为例:

±-------------------------------------------------------------------+
| public Employee getEmployeeByIdAndLastName |
| |
| (@Param(“id”)Integer id, @Param(“lastName”)String lastName); |
±-------------------------------------------------------------------+

2. 源码:
   前提: args=[1024,苍老师] names={0=id ,1=lastName}

±-----------------------------------------------------------------------------------------+
| public Object getNamedParams(Object[] args) { |
| |
| final int paramCount = names.size(); |
| |
| if (args == null || paramCount == 0) { |
| |
| return null; |
| |
| } else if (!hasParamAnnotation && paramCount == 1) { |
| |
| return args[names.firstKey()]; |
| |
| } else { |
| |
| final Map param = new ParamMap