SpringBoot学习笔记（四）——Spring Boot集成MyBatis起步

程序员应该将核心关注点放在业务上，而不应该将时间过多的浪费在CRUD中，多数的ORM框架都把增加、修改与删除做得非常不错了，然后数据库中查询无疑是使用频次最高、复杂度大、与性能密切相关的操作，我们希望得到一种使用方便，查询灵活的ORM框架，MyBatis可以满足这些要求，MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架，它也是SSM框架集成中的重要组成部分。

一、ORM

1.1、ORM简介

ORM可以解决数据库与程序间的异构性，比如在Java中我们使用String表示字符串，而Oracle中可使用varchar2，MySQL中可使用varchar，SQLServer可使用nvarchar。

对象关系映射(英语:Object Relational Mapping，简称ORM，或O/RM，或O/R mapping)，用于实现面向对象编程语言里不同类型系统的数据之间的转换。简单的说，ORM是通过使用描述对象和数据库之间映射的元数据，将程序中的对象与关系数据库相互映射。

没有ORM时我们是这样完成对象与关系数据库之间的映射的：

            //将执行的sql
            String sql = "SELECT name, id, age, password FROM users";
            //创建命令对象
            preparedStatement = connection.prepareStatement(sql);
            //执行并获得结果集
            resultSet = preparedStatement.executeQuery();
            //遍历结果集，将数据库中的数据转换成Java中的对象
            while(resultSet.next()){
                String name = resultSet.getString("name");
                int id = resultSet.getInt("id");
                int age = resultSet.getInt("age");
                String password = resultSet.getString("password");
                User entity= new User(name,id,age,password);
                Users.add(entity);
            }

这种方案存在以下不足： 

持久化层缺乏弹性。一旦出现业务需求的变更，就必须修改持久化层的接口

持久化层同时与域模型与关系数据库模型绑定，不管域模型还是关系数据库模型发生变化，都要修改持久化曾的相关程序代码，增加了软件的维护难度。

将和数据库交互（CRUD）的代码硬编码到JDBC程序中

实现见状的持久化层需要高超的开发技巧，而且编程量很大

对象模型和关系模型的转换非常麻烦

ORM（O/R Mapping：对象关系映射）：

一种将内存中的对象保存到关系型数据库中的技术

负责实体域对象的持久化，封装数据库访问细节

ORM提供了实现持久化层的另一种模式，采用映射元数据（XML）来描述对象-关系的映射细节，使得ORM中间件能在任何一个Java应用的业务逻辑层和数据库之间充当桥梁。

ORM提供了实现持久化层的另一种模式，它采用映射元数据来描述对象关系的映射，使得ORM中间件能在任何一个应用的业务逻辑层和数据库层之间充当桥梁。

Java典型的ORM中有:

hibernate：全自动的框架，强大、复杂、笨重、学习成本较高

Mybatis：半自动的框架(懂数据库的人 才能操作) 必须要自己写sql

JPA：JPA全称Java Persistence API、JPA通过JDK 5.0注解或XML描述对象－关系表的映射关系，是Java自带的框架

ORM的方法论基于三个核心原则：

　　· 简单：以最基本的形式建模数据。

　　· 传达性：数据库结构被任何人都能理解的语言文档化。

　　· 精确性：基于数据模型创建正确标准化了的结构。

1.2、ORM的概念

让我们从O/R开始。字母O起源于"对象"(Object),而R则来自于"关系"(Relational)。几乎所有的程序里面，都存在对象和关系数据库。在业务逻辑层和用户界面层中，我们是面向对象的。当对象信息发生变化的时候，我们需要把对象的信息保存在关系数据库中。

当你开发一个应用程序的时候(不使用O/R Mapping),你可能会写不少数据访问层的代码，用来从数据库保存，删除，读取对象信息，等等。你在DAL中写了很多的方法来读取对象数据，改变状态对象等等任务。而这些代码写起来总是重复的。

ORM解决的主要问题是对象关系的映射。域模型和关系模型分别是建立在概念模型的基础上的。域模型是面向对象的，而关系模型是面向关系的。一般情况下，一个持久化类和一个表对应，类的每个实例对应表中的一条记录，类的每个属性对应表的每个字段。

将关系数据库中表中的记录映射成为对象，以对象的形式展现，程序员可以把对数据库的操作转化为对对象的操作。

因此ORM的目的是为了方便开发人员以面向对象的思想来实现对数据库的操作。

1.3、ORM的优缺点

优点：

1.提高了开发效率。由于ORM可以自动对Entity对象与数据库中的Table进行字段与属性的映射，所以我们实际可能已经不需要一个专用的、庞大的数据访问层。

2.ORM提供了对数据库的映射，不用sql直接编码，能够像操作对象一样从数据库获取数据。

缺点：

牺牲程序的执行效率和会固定思维模式，降低了开发的灵活性。

从系统结构上来看,采用ORM的系统一般都是多层系统，系统的层次多了，效率就会降低。ORM是一种完全的面向对象的做法，而面向对象的做法也会对性能产生一定的影响。

在我们开发系统时，一般都有性能问题。性能问题主要产生在算法不正确和与数据库不正确的使用上。ORM所生成的代码一般不太可能写出很高效的算法，在数据库应用上更有可能会被误用，主要体现在对持久对象的提取和和数据的加工处理上，如果用上了ORM,程序员很有可能将全部的数据提取到内存对象中，然后再进行过滤和加工处理，这样就容易产生性能问题。

在对对象做持久化时，ORM一般会持久化所有的属性，有时，这是不希望的。

但ORM是一种工具，工具确实能解决一些重复，简单的劳动。这是不可否认的。但我们不能指望工具能一劳永逸的解决所有问题，有些问题还是需要特殊处理的，但需要特殊处理的部分对绝大多数的系统，应该是很少的。

二、MyBatis

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

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

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

2.1、MyBatis的特点

简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。

灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql基本上可以实现我们不使用数据访问框架可以实现的所有功能，或许更多。

解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。

提供映射标签，支持对象与数据库的ORM字段关系映射

提供对象关系映射标签，支持对象关系组建维护

提供XML标签，支持编写动态sql。

2.2、MyBatis工作流程

(1)、加载配置并初始化

触发条件：加载配置文件

配置来源于两个地方，一处是配置文件，一处是Java代码的注解，将SQL的配置信息加载成为一个个MappedStatement对象（包括了传入参数映射配置、执行的SQL语句、结果映射配置），存储在内存中。

(2)、接收调用请求

触发条件：调用Mybatis提供的API

传入参数：为SQL的ID和传入参数对象

处理过程：将请求传递给下层的请求处理层进行处理。

(3)、处理操作请求 触发条件：API接口层传递请求过来　

传入参数：为SQL的ID和传入参数对象

处理过程：
　　(A)根据SQL的ID查找对应的MappedStatement对象。

　　(B)根据传入参数对象解析MappedStatement对象，得到最终要执行的SQL和执行传入参数。

　　(C)获取数据库连接，根据得到的最终SQL语句和执行传入参数到数据库执行，并得到执行结果。

　　(D)根据MappedStatement对象中的结果映射配置对得到的执行结果进行转换处理，并得到最终的处理结果。

　　(E)释放连接资源。

(4)、返回处理结果将最终的处理结果返回。

无论是用过的hibernate,mybatis,你都可以法相他们有一个共同点：

在java对象和数据库之间有做mapping的配置文件，也通常是xml 文件

从配置文件(通常是XML配置文件中)得到 SessionFactory

由SessionFactory 产生 Session

在Session中完成对数据的增删改查和事务提交等

在用完之后关闭Session

2.3、MyBatis架构

Mybatis的功能架构分为三层：

API接口层：提供给外部使用的接口API，开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。

数据处理层：负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。

基础支撑层：负责最基础的功能支撑，包括连接管理、事务管理、配置加载和缓存处理，这些都是共用的东西，将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑。

2.4、MyBatis的主要成员如层次结构

主要成员：

Configuration：MyBatis所有的配置信息都保存在Configuration对象之中，配置文件中的大部分配置都会存储到该类中

SqlSession：作为MyBatis工作的主要顶层API，表示和数据库交互时的会话，完成必要数据库增删改查功能

Executor：MyBatis执行器，是MyBatis 调度的核心，负责SQL语句的生成和查询缓存的维护

StatementHandler：封装了JDBC Statement操作，负责对JDBC statement 的操作，如设置参数等

ParameterHandler：负责对用户传递的参数转换成JDBC Statement 所对应的数据类型

ResultSetHandler：负责将JDBC返回的ResultSet结果集对象转换成List类型的集合

TypeHandler：负责java数据类型和jdbc数据类型(也可以说是数据表列类型)之间的映射和转换

MappedStatement：MappedStatement维护一条<select|update|delete|insert>节点的封装

SqlSource：负责根据用户传递的parameterObject，动态地生成SQL语句，将信息封装到BoundSql对象中，并返回

BoundSql：表示动态生成的SQL语句以及相应的参数信息

层次结构：

 

更多请参考：《深入理解mybatis原理》 MyBatis的架构设计以及实例分析

2.5、学习资源

mybatis3中文帮助：http://www.mybatis.org/mybatis-3/zh/index.html

mybatis-spring：http://www.mybatis.org/spring/zh/index.html

MyBatis中国分站：http://www.mybatis.cn/

源代码：https://github.com/mybatis/mybatis-3/

三、Spring Boot集成MyBatis快速入门示例

3.1、在IDEA中创建Spring Boot项目

添加依赖

Maven POM

<?xml version="1.0" encoding="UTF-8"?>
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.7</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.zhangguo</groupId>
    <artifactId>mybatisdemo2</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>mybatisdemo2</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

3.2、创建数据库与表

创建数据库和表，针对MySQL数据库

SQL脚本如下：

CREATE TABLE `category` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '类型编号',
  `name` varchar(64) NOT NULL COMMENT '类型名称',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8;

将SQL脚本在MySQL数据库中执行，完成创建数据库和表的操作，如下：

表中的数据如下：

3.3、添加实体类

Category实体类代码如下：

package com.zhangguo.mybatisdemo2.entity;

import java.io.Serializable;

public class Category implements Serializable {
    private int id;
    private String name;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "Category{" +
                "id=" + id +
                ", name='" + name + '\'' +
                '}';
    }
}

3.4、定义数据访问接口

CategoryDao对应的代码如下：

package com.zhangguo.restdemo.dao;

import com.zhangguo.restdemo.entity.Category;

import java.util.List;

public interface CategoryDao {
    List<Category> findAll();
}

3.5、定义sql映射文件

在resources目录下创建一个mapper目录，专门用于存放sql映射文件，在目录中创建一个CategoryDao.xml文件，如下图所示：

CategoryDao.xml文件的内容如下：

<?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，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的
-->
<mapper namespace="com.zhangguo.mybatisdemo2.dao.CategoryDao">
    <!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性为findAll，id属性值必须是唯一的，不能够重复，且与接口中的一致
,resultType属性指明查询返回的结果集类型，因为设置了别名，这里直接用类名即可
-->
    <select id="findAll" resultType="Category">
        SELECT
            category.id,
            category.`name`
            FROM
        category
    </select>
</mapper>

解释

参考：https://www.cnblogs.com/hellokitty1/p/5216025.html

3.6、定义配置文件

application.yaml映射文件中主要包含了数据库连接信息与mybatis配置信息：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
    url: jdbc:mysql://localhost:3306/gomall?serverTimezone=GMT&useUnicode=true&characterEncoding=utf-8

mybatis:
  type-aliases-package: com.zhangguo.mybatisdemo2.entity
  mapper-locations: classpath:/mapper/*.xml

type-aliases-package作用是在Mybatis的mapper.xml文件中resultType的type或者paramterType会返回自定义entity,此时可以用全类名名来指定这些实体。

mapper-locations用于指定映射文件的扫描位置。

3.7、配置映射接口所在的包

Mybatisdemo2Application.java启动文件的内容如下：

package com.zhangguo.mybatisdemo2;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.zhangguo.mybatisdemo2.dao")
public class Mybatisdemo2Application {

    public static void main(String[] args) {
        SpringApplication.run(Mybatisdemo2Application.class, args);
    }

}

标注的@MapperScan 获取basePackage或者根据@Mapper获取所在packages，之后通过 ClassPathMapperScanner去扫描包，获取所有Mapper接口类的BeanDefinition，之后具体配置，设置beanClass为MapperFactoryBean，设置MapperFactoryBean的构造器参数为实际的Mapper接口类，通过ClassPathBeanDefinitionScanner父类进行bean注册，自动注入的时候，就会调用MapperFactoryBean的getObject方法获取实际类型的实例。

简单说@MapperScan作用是指定要变成实现类的接口所在的包，然后包下面的所有接口在编译之后都会生成相应的实现类。

3.8、编写单元测试

package com.zhangguo.mybatisdemo2;

import com.zhangguo.mybatisdemo2.dao.CategoryDao;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
class Mybatisdemo2ApplicationTests {

    @Autowired
    CategoryDao categoryDao;

    @Test
    void categoryDaoTest() {
        System.out.println(categoryDao.findAll());
    }

}

 测试结果

四、基于XML映射实现完整数据访问

MyBatis可以使用XML或注解作为映射器的描述，XML强大且可以解偶，注解方便且简单。

因为每一个操作都需要先拿到会话，这里先定义一个工具类以便复用：

XML映射器CategoryDao.xml：

<?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，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的
-->
<mapper namespace="com.zhangguo.mybatisdemo2.dao.CategoryDao">
    <!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性为findAll，id属性值必须是唯一的，不能够重复，且与接口中的一致
,resultType属性指明查询返回的结果集类型，因为设置了别名，这里直接用类名即可
-->
    <select id="findAll" resultType="Category">
        SELECT
            category.id,
            category.`name`
            FROM
        category
    </select>

    <select id="findById" resultType="Category">
        SELECT
            category.id,
            category.`name`
            FROM
        category
            where id=#{id}
    </select>

    <select id="findByName" resultType="Category" parameterType="String">
        SELECT
            category.id,
            category.`name`
            FROM
        category
            where name like '%${value}%'
    </select>

    <insert id="insertCategory" parameterType="Category">
        insert into category(name) value(#{name});
    </insert>

    <update id="updateCategory" parameterType="Category">
        update category set name=#{name} where id=#{id}
    </update>

    <delete id="deleteCategory" parameterType="int">
        delete from category where id=#{id}
    </delete>
</mapper>

数据访问类CategoryDao.java：

package com.zhangguo.mybatisdemo2.dao;

import com.zhangguo.mybatisdemo2.entity.Category;

import java.util.List;

public interface CategoryDao {
    /**获取所有*/
    List<Category> findAll();
    /**获取对象通过编号*/
    Category findById(int id);
    /**获取对象列表通过名称*/
    List<Category> findByName(String name);
    /**新增*/
    int insertCategory(Category category);
    /**更新*/
    int updateCategory(Category category);
    /**删除通过编号*/
    int deleteCategory(int id);
}

单元测试：

package com.zhangguo.mybatisdemo2;

import com.zhangguo.mybatisdemo2.dao.CategoryDao;
import com.zhangguo.mybatisdemo2.entity.Category;
import org.junit.jupiter.api.MethodOrderer;
import org.junit.jupiter.api.Order;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.TestMethodOrder;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
class Mybatisdemo2ApplicationTests {

    @Autowired
    CategoryDao categoryDao;

    @Test
    @Order(1)
    void categoryDaoTest() {
        System.out.println(categoryDao.findAll());
    }

    @Test
    @Order(2)
    void findByIdTest(){
        System.out.println(categoryDao.findById(1));
    }

    @Test
    @Order(3)
    void findByNameTest(){
        System.out.println(categoryDao.findByName("鲜"));
    }

    @Test
    @Order(4)
    void insertCategoryTest(){
        Category category=new Category();
        category.setName("其它");
        System.out.println(categoryDao.insertCategory(category));
    }

    @Test
    @Order(5)
    void updateCategoryTest(){
        Category category;
        category = categoryDao.findById(14);
        category.setName("其它类型");
        System.out.println(categoryDao.updateCategory(category));
    }

    @Test
    @Order(6)
    void deleteCategory(){
        System.out.println(categoryDao.deleteCategory(14));
    }
}

测试结果

参考映射文件1：

<?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">

<!-- namespace：需要和mapper接口的全限定名一致 -->
<mapper namespace="com.san.mapper.UserMapper">

    <!-- 通过ID查询用户 -->
    <select id="findUserById" parameterType="int" resultType="user">
        select * from user where id=#{id}
    </select>

    <!-- 定义sql片段 -->
    <!-- sql片段内，可以定义sql语句中的任何内容 -->
    <!-- sql片段内，最好不要使用where和select关键字声明在内 -->
    <sql id="whereClause">
        <!-- if标签：对输入的参数进行判断 -->
        <!-- test标签：指定判断的表达式 -->
        <if test="user!=null">
            <!-- 判断用户名不为空 -->
            <if test="user.username!=null and user.username!=''">
                and username like '%${user.username}%'
            </if>

            <!-- 判断性别不为空 -->
            <if test="user.sex!=null and user.sex!=''">
                and sex=#{user.sex}
            </if>
        </if>

        <!-- 判断集合 -->
        <!-- collection：表示pojo中集合属性的属性名称 -->
        <!-- item：为遍历出的结果声明一个变量名称 -->
        <!-- open：遍历开始时，需要拼接的字符串 -->
        <!-- close：遍历结束时，需要拼接的字符串 -->
        <!-- separator：遍历中间需要拼接的字符串 -->
        <if test="idList!=null">
            and id in
            <foreach collection="idList" item="id" open="(" close=")" separator=",">
                <!-- and id in (#{id},#{id},#{id}) -->
                #{id}
            </foreach>
        </if>
    </sql>

    <!-- 综合查询，查询用户列表 -->
    <!-- #{}中的参数名称要和包装pojo中的对象层级一致，并且属性名称要一致 -->
    <select id="findUserList" parameterType="com.san.model.UserQueryvo" resultType="user">
        select * from user
        <!-- where标签：默认去掉后面第一个and，如果没有参数，则把自己干掉 -->
        <where> 
            <!-- 引入sql片段 -->
            <include refid="whereClause"></include>
        </where>
    </select>

    <!-- 综合查询，查询用户的总数 -->
    <select id="findUserCount" parameterType="com.san.model.UserQueryvo" resultType="int">
        select count(*) from user 
        <where>
            <include refid="whereClause"></include>
        </where>

    </select>

    <!-- id标签：专门为查询结果中唯一列映射 -->
    <!-- result标签：映射查询结果中的普通列 -->
    <!-- type标签：返回类型 -->
    <resultMap type="user" id="UserResMap">
        <id column="id_" property="id"/>
        <result column="username_" property="username"/>
        <result column="sex_" property="sex"/>
    </resultMap>    
    <select id="findUserRstMap" parameterType="int" resultMap="UserResMap">
        select id id_,username username_,sex sex_ from user where id=#{id}  
    </select>
</mapper>

 参考映射文件2：

<?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">
<!-- namespace命名空间,作用就是对sql进行分类化的管理,理解为sql隔离
    注意:使用mapper代理开发时，namespace有特殊作用
 -->
<mapper namespace="test">
<!-- 在映射文件中配置很多sql语句 -->
<!-- 需求：通过Id查询用户表的记录 -->
<!-- 通过SELECT执行数据库查询 
    id:标识映射文件中的sql，称为statement的id;
        将sql语句封装在mapperStatement的对象中，所以Id称为Statement的id;
    parameterType:指定输入参数的类型,这里指定int型
    #{}:表示一个占位符;
    #{id}:其中Id表示接收输入的参数，参数名称就是Id,如果输入参数是简单类型，#{}中的参数名可以任意，可以是value或者其它名称;
    resultType:指定sql输出结果所映射的java对象类型,select指定resultType表示将单条记录映射成java对象。
-->
<select id="findUserById" parameterType="int" resultType="com.mybatis.entity.User" >
    select * from t_user where id=#{id}
</select>
<!-- 根据用户名称模糊查询用户信息,可能返回多条数据
    resultType:指定的就是单条记录所映射的java类型;
    ${}:表示拼接sql字符串，将接收到的参数内容不加任何修饰拼接在sql中.
    使用${}拼接sql，可能会引起sql注入
    ${value}:接收输入参数的内容，如果传入的是简单类型,${}中只能使用value
 -->
<select id="findUserByName" parameterType="java.lang.String" resultType="com.mybatis.entity.User" >
    select * from t_user where username LIKE '%${value}%'
</select>
<!-- 添加用户 
parameterType:指定输入的参数类型是pojo(包括用户信息);
#{}中指定pojo的属性名称，接收到pojo对象的属性值    ,mybatis通过OGNL(类似struts2的OGNL)获取对象的属性值
-->
<insert id="insertUser" parameterType="com.mybatis.entity.User" >
    <!-- 
        将insert插入的数据的主键返回到User对象中;
        select last_insert_id():得到刚insert进去记录的主键值，只适用于自增主键;
        keyProperty:将查询到的主键值，设置到parameterType指定的对象的那个属性
        order:select last_insert_id()执行顺序，相对于insert语句来说它的执行顺序。
        resultType:指定select last_insert_id()的结果类型;
     -->
    <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
        select last_insert_id()
    </selectKey>
    <!-- 
        使用mysql的uuid()，实现非自增主键的返回。
        执行过程:通过uuid()得到主键，将主键设置到user对象的Id的属性中，其次，在insert执行时，从user对象中取出Id属性值;
     <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
        select uuid()
    </selectKey>
        insert into t_user (id,username,birthday,sex,address) values(#{id},#{username},#{birthday},#{sex},#{address})
     -->
    insert into t_user (username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
</insert>
<!-- 删除用户 
    根据ID删除用户,需要输入Id值
-->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from t_user where id=#{id}
    </delete>
<!-- 更新用户 
    需要传入用户的Id和用户的更新信息
    parameterType:指定User对象，包括Id和用户的更新信息,注意：Id是必须存在的
    #{id}:从输入的User对象中获取Id的属性值
-->
<update id="updateUser" parameterType="com.mybatis.entity.User">
    update t_user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} 
    where id=#{id}
</update>

</mapper>

五、基于注解映射实完整数据访问

定义表并添加数据

CREATE TABLE `student` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(10) NOT NULL,
  `sex` enum('boy','girl','secret') DEFAULT 'secret',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;

映射器，StudentDao接口：

package com.zhangguo.mybatis02.dao;

import com.zhangguo.mybatis02.entities.Student;
import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;

import java.util.List;

public interface StudentMapper {
    /**
     * 根据学生编号获得学生对象
     */
    @Select("select id,name,sex from student where id=#{id}")
    Student selectStudentById(int id);

    /**
     * 根据学生姓名获得学生集合
     */
    @Select("SELECT id,name,sex from student where name like '%${value}%'")
    List<Student> selectStudentsByName(String name);

    /**
     * 添加学生
     */
    @Insert("insert into student(name,sex) values(#{name},#{sex})")
    int insertStudent(Student entity);

    /**
     * 更新学生
     */
    @Update("update student set name=#{name},sex=#{sex} where id=#{id}")
    int updateStudent(Student entity);

    /**
     * 删除学生
     */
    @Delete("delete from student where id=#{id}")
    int deleteStudent(int id);
}

单元测试：

package com.zhangguo.mybatis02.dao;

import com.zhangguo.mybatis02.entities.Student;
import org.junit.After;
import org.junit.Assert;
import org.junit.Before;
import org.junit.Test;

import java.util.List;

/**
 * StudentDao Tester.
 *
 * @author <Authors name>
 * @version 1.0
 * @since <pre>09/26/2018</pre>
 */
public class StudentDaoAnnoTest {
    StudentMapper dao;
    @Before
    public void before() throws Exception {
        dao=new StudentDaoAnno();
    }

    @After
    public void after() throws Exception {
    }

    /**
     * Method: selectStudentById(int id)
     */
    @Test
    public void testSelectStudentById() throws Exception {
        Student entity=dao.selectStudentById(1);
        System.out.println(entity);
        Assert.assertNotNull(entity);
    }

    /**
     * Method: selectStudentsByName(String name)
     */
    @Test
    public void testSelectStudentsByName() throws Exception {
        List<Student> students=dao.selectStudentsByName("e");
        System.out.println(students);
        Assert.assertNotNull(students);
    }

    /**
     * Method: insertStudent
     */
    @Test
    public void testInsertStudent() throws Exception {
        Student entity=new Student();
        entity.setName("张小强");
        entity.setSex("boy");

        Assert.assertEquals(1,dao.insertStudent(entity));
    }

    /**
     * Method: updateStudent
     */
    @Test
    public void testUpdateStudent() throws Exception {
        Student entity=dao.selectStudentById(7);
        entity.setName("张美丽");
        entity.setSex("girl");

        Assert.assertEquals(1,dao.updateStudent(entity));
    }

    /**
     * Method: deleteStudent
     */
    @Test
    public void testDeleteStudent() throws Exception {
        Assert.assertEquals(1,dao.deleteStudent(7));
    }
} 

测试结果：

参考映射文件：

package com.winterchen.mapper;

import com.winterchen.domain.User;
import org.apache.ibatis.annotations.*;

import java.util.List;
import java.util.Map;

/**
 * User映射类
 * Created by Administrator on 2017/11/24.
 */
@Mapper
public interface UserMapper {

    @Select("SELECT * FROM T_USER WHERE PHONE = #{phone}")
    User findUserByPhone(@Param("phone") String phone);

    @Insert("INSERT INTO T_USER(NAME, PASSWORD, PHONE) VALUES(#{name}, #{password}, #{phone})")
    int insert(@Param("name") String name, @Param("password") String password, @Param("phone") String phone);

    @Insert("INSERT INTO T_USER(NAME, PASSWORD, PHONE) VALUES(" +
            "#{name, jdbcType=VARCHAR}, #{password, jdbcType=VARCHAR}, #{phone, jdbcType=VARCHAR})")
    int insertByMap(Map<String, Object> map);

    @Insert("INSERT INTO T_USER(NAME, PASSWORD, PHONE) VALUES(#{name}, #{password}, #{phone})")
    int insertByUser(User user);

    @Update("UPDATE T_USER SET NAME = #{name}, PASSWORD = #{password} WHERE PHONE = #{phone}")
    void update(User user);

    @Delete("DELETE FROM T_USER WHERE ID = #{id}")
    void delete(Integer id);

    @Results({
            @Result(property = "name", column = "NAME"),
            @Result(property = "password", column = "PASSWORD"),
            @Result(property = "phone", column = "PHONE")
    })
    @Select("SELECT NAME, PASSWORD, PHONE FROM T_USER")
    List<User> findAll();

}

六、说明与注意事项

6.1、parameterType和resultType的区别

parameterType:在映射文件中通过parameterType指定输入参数的类型。

resultType:在映射文件中通过resultType指定输出结果的类型

6.2、#{}和${}的区别

#{}

#{}表示一个占位符号，#{}接收输入参数，类型可以是简单类型，pojo、hashmap;

如果接收简单类型，#{}中可以写成value或其它名称;

#{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值。使用#{}意味着使用的预编译的语句，即在使用jdbc时的preparedStatement，sql语句中如果存在参数则会使用?作占位符，我们知道这种方式可以防止sql注入，并且在使用#{}时形成的sql语句，已经带有引号，例，select? * from table1 where id=#{id}? 在调用这个语句时我们可以通过后台看到打印出的sql为：select * from table1 where id='2' 加入传的值为2.也就是说在组成sql语句的时候把参数默认为字符串。

${}

表示一个拼接符号，会引用sql注入，所以不建议使用${}；

＄{}接收输入参数，类型可以是简单类型，pojo、hashmap;

如果接收简单类型，${}中只能写成value;

＄{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值。

使用＄{}时的sql不会当做字符串处理，是什么就是什么，如上边的语句：select * from table1 where id=${id} 在调用这个语句时控制台打印的为：select * from table1 where id=2 ，假设传的参数值为2
从上边的介绍可以看出这两种方式的区别，我们最好是能用#{}则用它，因为它可以防止sql注入，且是预编译的，在需要原样输出时才使用＄{}，如，
select * from ＄{tableName} order by ＄{id} 这里需要传入表名和按照哪个列进行排序 ，加入传入table1、id 则语句为：select * from table1 order by id
如果是使用#{} 则变成了select * from 'table1' order by 'id' 我们知道这样就不对了。

6.3、selectOne()和selectList()的区别

selectOne表示查询出一条记录进行映射。如果使用selectOne可以实现使用selectList也可以实现（list中只有一个对象），如果查询结果为多条则会报错。

selectList表示查询出一个列表（多条记录）进行映射，可以是0到n条记录返回。

6.4、映射器选择XML还是注解

以下是MyBatis官网对Mapper Annotations的解释：

Mapper Annotations

Since the very beginning, MyBatis has been an XML driven framework. The configuration is XML based, and the Mapped Statements are defined in XML. With MyBatis 3, there are new options available. MyBatis 3 builds on top of a comprehensive and powerful Java based Configuration API. This Configuration API is the foundation for the XML based MyBatis configuration, as well as the new Annotation based configuration. Annotations offer a simple way to implement simple mapped statements without introducing a lot of overhead.

NOTE ： Java Annotations are unfortunately limited in their expressiveness and flexibility. Despite a lot of time spent in investigation, design and trials, the most powerful MyBatis mappings simply cannot be built with Annotations – without getting ridiculous that is. C# Attributes (for example) do not suffer from these limitations, and thus MyBatis.NET will enjoy a much richer alternative to XML. That said, the Java Annotation based configuration is not without its benefits.

翻译：

（最初MyBatis是基于XML驱动的框架。MyBatis的配置是基于XML的，语句映射也是用XML定义的。对于MyBatis3，有了新的可选方案。MyBatis3 是建立在全面且强大的Java配置API之上的。 该配置API是MyBatis基于XML配置的基础，也是基于注解配置的基础。注解提供了简单的方式去实现简单的映射语句，不需要花费大量的开销。

注意：很不幸的是，java注解在表现和灵活性上存在限制。虽然在调研、设计和测试上花费了很多时间，但是最强大的MyBatis映射功能却无法用注解实现。这没有什么可笑的。举例来说，C#的特性就没有这个限制，所以MyBatis.NET 能拥有一个功能丰富的多的XML替代方案。所以，Java基于注解的配置是依赖于其自身特性的。）

长远来看建议选择XML作为映射器

http://www.mybatis.org/mybatis-3/java-api.html

6.5、开启热部署

springboot提供了热部署，所谓热部署就是当你修改了代码，不用重新启动服务器部署应用，而你只要重新编译一下当前项目，修改的代码就自动生效了，这样极大的节省了部署应用时间，对于开发体验还是有很大提升的，因为我们不用一修改了代码就部署应用，因为部署应用也是会花费很长时间的。在idea中点击如下按钮：

1.首先在pom文件中添加依赖和插件

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <optional>true</optional>
        <scope>true</scope>
    </dependency>

    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <fork>true</fork>
            </configuration>
        </plugin>
    </plugins>

2.打开settings进行配置

3.window系统中摁快捷键 Shift+Ctrl+Alt+/

4.选择compiler.automake.allow.when.app.running这一项

5.重启IDEA，验证Sringboot热部署是否成功。

 

七、视频

https://www.bilibili.com/video/av32447485/

八、示例

https://git.coding.net/zhangguo5/MyBatis02.git

九、作业

1、请使用MyBatis完成一个用户管理的数据访问功能，要求实现根据用户名查询用户对象（id,username,password,name,email,state）功能，表中至少5个字段。

2、请分别使用XML与注解两种方式实现对象用户表（Users）的单条记录查询、多条记录查询、增加、修改与删除功能，要求单元测试通过。

3、添加用户成功后返回用户的编号，而不是影响行数。（选作）

4、实现多个条件组合查询，类似在电商平台购物可以选择0-n个条件，且可以自由组合。（选作）

5、实现分页功能。（选作）