一、Mybatis简介

一、MyBatis简介

1.1原始JDBC操作的分析

原始JDBC开发存在的问题如下：

①：数据库创建连接，释放连接频繁操作，造成系统资源浪费从而影响系统性能。

②：sql语句在代码中硬编码，造成代码不易维护；实际应用sql变化的可能较大，sql变动需要改变java代码。

③：查询操作时，需要手动将结果集中的数据封装到实体类中。

应对上述问题给出的解决方案:

①：使用数据库连接池初始化连接资源。

②：将sql语句抽取到xml文件中。

③：使用反射、内省等底层技术，自动将实体与表进行属性与字段的自动映射。

1.2 MyBatis简介

MyBatis是一个优秀的基于ORM的半自动轻量级持久层框架，它对jdbc操作数据库的过程进行封装，
使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建
statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

半自动:MyBatis（推荐：可以对手动编写的sql语句进行优化）

全自动：hibernate

本质区别：是否需要手动编写sql语句

轻量级：程序在启动期间所需要消耗的资源的多少

MyBatis历史

MyBatis 本是apache的一个开源项目iBatis, 2010年6月这个项目由apache software foundation 迁移
到了google code，随着开发团队转投到Google Code旗下，iBatis正式改名为MyBatis ，代码于2013
年11月迁移到Github

Github地址：https://github.com/MyBatis/MyBatis-3/

1.2ORM思想

ORM(Object Relation Mapping) 对象关系映射

** O（对象模型）：**

​ 实体对象，即我们在程序中根据数据库表结构建立的一个个实体javaBean

** R（关系型数据库的数据结构）：**

​ 关系数据库领域的Relational（建立的数据库表）

** M（映射） **

​ 从R（数据库）到O（对象模型）的映射，可通过XML文件/注解 映射

实现：

​ （1）让实体类和数据库表进行一一对应关系

​ 先让实体类和数据库表对应

​ 再让实体类属性和表里面字段对应

​ （2）不需要直接操作数据库表，直接操作表对应的实体类对象

ORM作为是一种思想
帮助我们跟踪实体的变化,并将实体的变化翻译成sql脚本,执行到数据库中去,也就是将实体的变化映射到
了表的变化。
MyBatis采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了封装，屏蔽了jdbc api 底层访问
细节，使我们不用与jdbc api 打交道，就可以完成对数据库的持久化操作 。

---

二、MyBatis快速入门

案例需求：通过MyBatis查询数据库user表的所有记录，封装到User对象中，打印到控制台上

1. 创建数据库及user表
2. 创建maven工程，导入依赖（MySQL驱动、MyBatis、junit）
3. 编写User实体类
4. 编写UserMapper.xml映射配置文件（ORM思想）
5. 编写SqlMapConfig.xml核心配置文件
	数据库环境配置
	映射关系配置的引入(引入映射配置文件的路径)
6. 编写测试代码
	// 1.加载核心配置文件
	// 2.获取sqlSessionFactory工厂对象
	// 3.获取sqlSession会话对象
	// 4.执行sql
	// 5.打印结果
	// 6.释放资源

2.1代码实现

(1) 创建user数据表

CREATE DATABASE `MyBatis_db`;
USE `MyBatis_db`;
CREATE TABLE `user` (
`id` INT(11) NOT NULL AUTO_INCREMENT,
`username` VARCHAR(32) NOT NULL COMMENT '用户名称',
`birthday` DATETIME DEFAULT NULL COMMENT '生日',
`sex` CHAR(1) DEFAULT NULL COMMENT '性别',
`address` VARCHAR(256) DEFAULT NULL COMMENT '地址',
PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

-- insert....

INSERT INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) 
VALUES (1,'景天','2020-11-11 00:00:00','男','北京海淀'),
(2,'龙葵','2020-12-12 00:00:00','男','北京海淀');

(2) 导入依赖坐标

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>

    <groupId>cn.xuguowengroupId>
    <artifactId>MyBatis_quickstartartifactId>
    <version>1.0-SNAPSHOTversion>

    <properties>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8maven.compiler.encoding>
        <java.version>1.8java.version>
        <maven.compiler.source>1.8maven.compiler.source>
        <maven.compiler.target>1.8maven.compiler.target>
    properties>

    
    <dependencies>
        
        <dependency>
            <groupId>org.MyBatisgroupId>
            <artifactId>MyBatisartifactId>
            <version>3.5.4version>
        dependency>
        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.37version>
            <scope>runtimescope>
        dependency>
        
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>4.12version>
            <scope>testscope>
        dependency>
    dependencies>

project>

(3) 编写User实体

public class User {
	private Integer id;
	private String username;
	private Date birthday;
	private String sex;
	private String address;
	// getter/setter 略
}

(4) 编写UserMapper.xml映射文件

DOCTYPE mapper
        PUBLIC "-//MyBatis.org//DTD Mapper 3.0//EN"
        "http://MyBatis.org/dtd/MyBatis-3-mapper.dtd">
<mapper namespace="userMapper">
    
    
    <select id="findAll" resultType="cn.xuguowen.pojo.User">
        select * from user  /*需要注意：sql语句不要加分号*/
    select>
mapper>

(5) 编写MyBatis核心配置文件

DOCTYPE configuration
        PUBLIC "-//MyBatis.org//DTD Config 3.0//EN"
        "http://MyBatis.org/dtd/MyBatis-3-config.dtd">
<configuration>
    
    <environments default="mysql">
        
        <environment id="mysql">
            
            <transactionManager type="JDBC">transactionManager>
            
            <dataSource type="POOLED">
                
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///MyBatis_db"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            dataSource>
        environment>
      
    environments>

    <mappers>
        
        <mapper resource="UserMapper.xml">mapper>
    mappers>
configuration>

(6) 编写测试类

package cn.xuguowen.test;

import cn.xuguowen.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

/**
 * @author 徐国文
 * @create 2021-09-23 17:48
 * 测试MyBatis的快速入门
 */
public class TestMyBatisQuickStart {
    @Test
    public void testFindAll() throws IOException {
        // 1.加载配置文件:因为当前配置文件就在resources目录下，可以直接获取
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");

        // 2.获取SqlSessionFactory工厂对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);

        // 3.获取SqlSession会话对象
        SqlSession sqlSession = factory.openSession();

        // 4.执行sql语句:通过namespace.id定位sql语句
        List<User> users = sqlSession.selectList("userMapper.findAll");

        // 5.遍历输出结果
        for (User user : users) {
            System.out.println(user);
        }

        // 6.释放资源
        sqlSession.close();
    }
}

---

三、MyBatis映射配置文件概述

---

四、MyBatis增删改查

4.1 新增

（1）编写映射配置文件UserMapper.xml

 
    <insert id="save" parameterType="cn.xuguowen.pojo.User">
        insert into user(username,birthday,sex,address)
            values (#{username},#{birthday},#{sex},#{address})
    insert>

（2） 编写测试类

 	/**
     * 测试新增数据
     */
    @Test
    public void testSave() throws IOException {
        // 1.加载MyBatis核心配置文件
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 2.获取SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        // 3.获取SqlSession会话对象
        SqlSession sqlSession = factory.openSession();
        // 准备数据
        User user = new User();
        user.setUsername("徐国文");
        user.setBirthday(new Date());
        user.setSex("男");
        user.setAddress("桃园山庄");
        // 4.执行插入操作
        sqlSession.insert("userMapper.save",user);

        // 5.由于数据库中的表发生了变换，手动提交实务
        sqlSession.commit();

        // 6.释放资源
        sqlSession.close();
    }

4.2 修改

（1）编写映射配置文件UserMapper.xml

<update id="update" parameterType="cn.xuguowen.pojo.User">
    update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#		        {address} where id=#{id}
update>

（2）编写测试类

 	/**
     * 测试更新数据
     */
    @Test
    public void testUpdate() throws IOException {
        // 1.加载MyBatis核心配置文件
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 2.获取SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        // 3.获取SqlSession会话对象
        SqlSession sqlSession = factory.openSession();
        // 准备数据
        User user = new User();
        user.setId(3);
        user.setUsername("王莹");
        user.setBirthday(new Date());
        user.setSex("女");
        user.setAddress("避暑山庄");
        // 4.执行更新操作
        sqlSession.update("userMapper.update",user);

        // 5.由于数据库中的表发生了变换，手动提交实务
        sqlSession.commit();

        // 6.释放资源
        sqlSession.close();
    }

4.3 删除

（1）编写映射配置文件UserMapper.xml

 
    <delete id="delete" parameterType="java.lang.Integer">
        delete from user where id = #{id}
    delete>

（2）编写测试类

	/**
     * 测试删除数据
     */
    @Test
    public void testDelete() throws IOException {
        // 1.加载MyBatis核心配置文件
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 2.获取SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        // 3.获取SqlSession会话对象
        SqlSession sqlSession = factory.openSession();
        // 4.执行删除操作
        sqlSession.delete("userMapper.delete",3);

        // 5.由于数据库中的表发生了变换，手动提交实务
        sqlSession.commit();

        // 6.释放资源
        sqlSession.close();
    }

---

五、MyBatis核心配置文件概述

5.1 MyBatis核心配置文件层级关系

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

配置文档的结构如下：以先后顺序呈现出来的，也就是每个标签的配置顺序的位置

5.2MyBatis常用配置解析

（1）environments标签

数据库环境的配置，支持多环境配置

（2）properties标签

实际开发种，习惯上将数据源的配置信息单独抽取成一个properties文件，该标签可以加载额外配置的properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql:///mybatis_db
jdbc.username=root
jdbc.password=root

（3）typeAliases标签

类型别名：为Java类型设置一个短的名字

• 为了简化映射文中Java类型设置，MyBatis框架为我们设置好一些常用类型的别名，如下图

• 自定义类设置别名

	
	
    <select id="findAll" resultType="user">
        select * from user  /*需要注意：sql语句不要加分号*/
    select>

（4）mappers标签

作用就是加载映射配置的，加载方式有如下几种

1. 使用相对于类路径的资源引用，例如：
		
2. 使用完全限定资源定位符（URL），例如：
		
《下面两种mapper代理开发中使用:暂时了解》
3. 使用映射器接口实现类的完全限定类名，例如：
		
4. 将包内的映射器接口实现全部注册为映射器，例如：
		

---

六、MyBatis API概述

6.1 API介绍

（1）SqlSession工厂构建器SqlSessionFactoryBuilder

常用API：SqlSessionFactory build(InputStream inputStream)
通过加载MyBatis核心配置文件的输入流形式构建一个SqlSessionFactory对象

	// 1.加载mybatis核心配置文件
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        // 2.获取SqlSessionFactory对象
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);

其中， Resources 工具类，这个类在 org.apache.ibatis.io 包中。Resources 类帮助你从类路径下、文件系统或一个 web URL 中加载资源文件。

（2）SqlSession工厂对象SqlSessionFactory

SqlSessionFactory 有多个个方法创建SqlSession 实例。常用的有如下两个：

方法	说明
openSession	会默认开启一个事务，但事务不会自动提交，也就意味着需要手动提交该事务，更新操作数据才会持久化到数据库中
openSession(boolean autoCommit)	是否自动提交事务，如果设置为true，那么就不需要手动提交事务

（3） SqlSession会话对象

SqlSession 实例在 MyBatis 中是非常强大的一个类。在这里你会看到所有执行语句、提交或回滚事务和获取映射器实例的方法。

• 执行sql语句的方法主要有：

<T> T selectOne(String statement, Object parameter)
<E> List<E> selectList(String statement, Object parameter)
int insert(String statement, Object parameter)
int update(String statement, Object parameter)
int delete(String statement, Object parameter)

• 操作事务的方法主要有

void commit()
void rollback()

6.2 MyBatis基本原理介绍

---

七、MyBatis的dao层开发

7.1 传统开发方式

（1）编写UserDao接口

package cn.xuguowen.dao;

import cn.xuguowen.pojo.User;

import java.io.IOException;
import java.util.List;

/**
 * @author 徐国文
 * @create 2021-09-25 12:38
 */
public interface UserDao {
    /**
     * 查询所有用户
     * @return
     */
    List<User> findAll() throws IOException;

    /**
     * 根据id查询用户
     * @param id
     * @return
     */
    User findOne(Integer id) throws IOException;
}

（2）编写UserDaoImpl实现类

package cn.xuguowen.dao.impl;

import cn.xuguowen.dao.UserDao;
import cn.xuguowen.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

/**
 * @author 徐国文
 * @create 2021-09-25 12:39
 * 传统模式下的dao开发，你会发现两个问题
 *  1.会出现重复代码
 *          InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
 *         SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
 *         SqlSession sqlSession = factory.openSession();
 *  2.出现硬编码问题：statementId硬编码问题
 *      List users = sqlSession.selectList("userMapper.findAll");
 *      如果将来映射配置文件中namespace.id发生变化，那么代码也需要发生变化
 */
public class UserDaoImpl implements UserDao {
    /**
     * 查询所有用户
     * @return
     */
    public List<User> findAll() throws IOException {
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = factory.openSession();

        List<User> users = sqlSession.selectList("userMapper.findAll");
        return users;
    }

    /**
     * 根据id查询用户
     * @param id
     * @return
     */
    @Override
    public User findOne(Integer id) throws IOException {
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = factory.openSession();

        User user = sqlSession.selectOne("userMapper.findOne",id);


        return user;
    }
}

（3）编写UserMapper.xml映射配置文件

DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="userMapper">
    
    <select id="findAll" resultType="user">
        select * from user
    select>

    <select id="findOne" parameterType="int" resultType="user">
        select * from user where id = #{id}
    select>
mapper>

（4）核心配置文件SqlMapperConfig.xml

DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    
    <properties resource="jdbc.properties">properties>
    
    <typeAliases>
        

        
        
        <package name="cn.xuguowen.pojo"/>
    typeAliases>
    
    <environments default="mysql">
        
        <environment id="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>
      
    environments>

    <mappers>
        <mapper resource="mapper/userMapper.xml">mapper>
    mappers>
configuration>

（5）测试

package cn.xuguowen.testdao;

import cn.xuguowen.dao.UserDao;
import cn.xuguowen.dao.impl.UserDaoImpl;
import cn.xuguowen.pojo.User;
import org.junit.Test;

import java.io.IOException;
import java.util.List;

/**
 * @author 徐国文
 * @create 2021-09-25 12:47
 * 测试用户模块下的dao
 */
public class TestUserDao {

    @Test
    public void testFindAll() throws IOException {
        UserDao userDao = new UserDaoImpl();
        List<User> users = userDao.findAll();
        for (User user : users) {
            System.out.println(user);
        }
    }

    @Test
    public void testFindOne() throws IOException {
        UserDao userDao = new UserDaoImpl();
        User one = userDao.findOne(1);
        System.out.println(one);

    }
}

传统开发方式的问题

• 在实现类中，存在mybatis代码重复

		InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = factory.openSession();

• 实现类调用方法时，xml中的sql statement硬编码到Java代码中

List<User> users = sqlSession.selectList("userMapper.findAll");

问题全部出现在实现类中!

思考:能否只编写接口和映射配置文件呢？

7.2 代理开发方式（重点）

（1）介绍

采用 Mybatis 的基于接口代理方式实现持久层 的开发。基于接口代理方式的开发只需要程序员编写 Mapper 接口，Mybatis 框架会为我们动态生成实现类的对象。
这种开发方式需要我们遵守一定的规范

• Mapper.xml映射文件中的namespace与mapper接口的全限定类名相同
• Mapper接口方法名和Mapper.xml映射文件中定义的每个statement的id相同
• Mapper接口方法的输入参数类型和mapper.xml映射文件中定义的每个sql的parameterType的类型相同
• Mapper接口方法的输出参数类型和mapper.xml映射文件中定义的每个sql的resultType的类型相同

Mapper 接口开发方法只需要程序员编写Mapper 接口（相当于Dao 接口），由Mybatis 框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

（2）编写UserMapper接口

package cn.xuguowen.mapper;

import cn.xuguowen.pojo.User;

/**
 * @author 徐国文
 * @create 2021-09-25 17:07
 * mybatis动态代理开发方式
 */
public interface UserMapper {
    /**
     * 根据id查询用户信息
     * @param id
     * @return
     */
    User findById(int id);
}

（3）编写UserMapper.xml文件

DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">


<mapper namespace="cn.xuguowen.mapper.UserMapper">
    
    <select id="findById" parameterType="int" resultType="user">
        select * from user where id = #{id}
    select>
mapper>

（4）测试

package cn.xuguowen.UserMapperTest;

import cn.xuguowen.mapper.UserMapper;
import cn.xuguowen.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;

/**
 * @author 徐国文
 * @create 2021-09-25 17:15
 * 测试UserMapper代理开发方式
 */

public class TestUserMapper {

    /**
     * 测试查询单个用户
     * 每当要测试的时候，都先要去检查下核心配置文件有没有引入映射配置文件
     */
    @Test
    public void testFindById() throws IOException {
        InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        SqlSession sqlSession = factory.openSession();
        // mybatis动态代理生成UserMapper接口的实现类，无需我们手动编写他的实现类
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.findById(2);
        System.out.println(user);

    }
}

（5）补充

在核心配置文件中SqlMapConfig.xml文件中，引入映射配置文件的方式

	<mappers>
        
        

        


        
        <package name="cn.xuguowen.mapper"/>
    mappers>

---

（6）MyBatis基于接口代理方式的内部执行原理

我们的持久层现在只有一个接口，接口实际上是一种规范，并不是实际干活的，那么是谁在做查询的操作呢？
下面我们追踪源码看一下：

①、通过追踪源码我们会发现，我们使用的mapper实际上是一个代理对象,是由MapperProxy代理产生的

②、追踪MapperProxy的invoke方法会发现，其最终调用了mapperMethod.execute(sqlSession, args)

③、进入execute方法会发现，最终工作的还是sqlSession