目录

1.什么是 MyBatis

• MyBatis 是一款优秀的持久层框架，它?持 自定义 SQL 、 存储过程 以及 高级映射 。
• MyBatis 去除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
• MyBatis 可以通过简单的 XML 或 注解 来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

简单来说 MyBatis 是 更简单完成程序和数据库交互的?具 ，也就是更简单的操作和读取数据库工具。

2.MyBatis 环境搭建

开始搭建 MyBatis 之前，MyBatis 在整个框架中的定位，框架交互流程图：

MyBatis 也是一个 ORM 框架，ORM（Object Relational Mapping），即对象关系映射。在面向对象编程语?中， 将关系型数据库中的数据与对象建立起映射关系 ，进而自动的完成 数据与对象的互相转换 ：

1. 将输入数据（即传入对象）+SQL 映射成原生 SQL
2. 将结果集映射为返回对象，即输出对象

ORM 把数据库映射为对象：

1. 数据库表（table）–> 类（class）
2. 记录（record，行数据）–> 对象（object）
3. 字段（field） --> 对象的属性（attribute）

一般的 ORM 框架，会将数据库模型的每张表都映射为一个 Java 类。 也就是说使用 MyBatis 可以像操作对象?样来操作数据库中的表，可以实现对象和数据库表之间的转换。

2.1 创建数据库和表

-- 创建数据库
drop database if exists mycnblog;
create database mycnblog DEFAULT CHARACTER SET utf8mb4;

-- 使用数据数据
use mycnblog;

-- 创建表[用户表]
drop table if exists  userinfo;
create table userinfo(
    id int primary key auto_increment,
    username varchar(100) not null,
    password varchar(32) not null,
    photo varchar(500) default '',
    createtime datetime default now(),
    updatetime datetime default now(),
    `state` int default 1
) default charset 'utf8mb4';

-- 创建文章表
drop table if exists  articleinfo;
create table articleinfo(
    id int primary key auto_increment,
    title varchar(100) not null,
    content text not null,
    createtime datetime default now(),
    updatetime datetime default now(),
    uid int not null,
    rcount int not null default 1,
    `state` int default 1
)default charset 'utf8mb4';

-- 创建视频表
drop table if exists videoinfo;
create table videoinfo(
  	vid int primary key,
  	`title` varchar(250),
  	`url` varchar(1000),
		createtime datetime default now(),
		updatetime datetime default now(),
  	uid int
)default charset 'utf8mb4';

2.2 添加 MyBatis 框架支持

① 在已有的项目中添加：

<!-- 添加 MyBatis 框架 -->
<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId> 
	<version>2.1.4</version>
</dependency>
<!-- 添加 MySQL 驱动 -->
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId> 
	<scope>runtime</scope>
</dependency>

② 在创建新项目时添加：

2.3 配置数据库连接和MyBatis

在 application.yml 配置数据库连接：

# 配置数据库连接
spring:
  datasource:
    url: jdbc:mysql://127.0.0.1/mycnblog?charsetEncoding=utf8
    username: root
    password: 12345678
    driver-class-name: com.mysql.cj.jdbc.Driver

配置 MyBatis 中的 XML 路径：

# 设置Mybatis的xml保存路径
mybatis:
  mapper-locations: classpath:mybatis/**Mapper.xml

2.4 添加代码

按照后端开发的工程思路来实现 MyBatis 查询所有用户的功能：

目录结构：

2.4.1 添加实体类

添加用户的实体类：

@Setter
@Getter
@ToString
public class UserInfo {
 
    private int id;
    private String username;
    private String password;
    private String photo;
    private String createtime;
    private String updatetime;
    private int state;
}

2.4.2 添加 mapper 接口

数据持久层的接口定义：

@Mapper
public interface UserMapper {
 
	public List<UserInfo> getAll(); 
}

2.4.3 添加 UserMapper.xml

数据持久层的实现，mybatis 的固定 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="com.example.demo.mapper.UserMapper"> 
</mapper>

UserMapper.xml 查询所有用户的具体实现 SQL：

<?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.example.demo.mapper.UserMapper">
	<select id="getAll" resultType="com.example.demo.model.UserInfo"> 
        select * from userinfo
	</select> 
</mapper>

标签说明：

• <mapper> 标签 ：需要指定 namespace 属性，表示命名空间，值为 mapper 接口的全限定名，包括全包名.类名。
• <select> 查询标签 ：是用来执行数据库的查询操作的：
• id ：是和 Interface（接口）中定义的方法名称?样的，表示对接口的具体实现方法。
• resultType ：是返回的数据类型，也就是开头我们定义的实体类。

2.4.4 添加 Service

服务层实现代码如下：

@Service
public class UserService {
 
	@Resource
	private UserMapper userMapper; 
	public List<UserInfo> getAll() {
 
		return userMapper.getAll();
    } 
}

2.4.5 添加 Controller

控制器层的实现代码如下：

@RestController
@RequestMapping("/user")
public class UserController {
 
    @Resource
    private UserService userService;

    @RequestMapping("/getuserbyid")
    public UserInfo getUserById(Integer id) {
 
        if (id != null && id > 0) {
 
            return userService.getUserById(id);
        } else {
 
            return new UserInfo();
        }
    }
}

3.MyBatis 增删改查操作

操作步骤：

• 添加 controller
• 添加 service
• 添加 mapper （dao）
• 添加 xml

3.1 增加操作

① 添加 controller：

@RequestMapping("/insert")
    public Integer insert(UserInfo userInfo) {
 
        return userService.insert(userInfo);
    }

② 添加 service：

public Integer insert(UserInfo userInfo) {
 
        return userMapper.insert(userInfo);
    }

③ 添加 mapper ：

Integer insert(UserInfo userInfo);

④ 添加 xml：

<insert id="add">
  insert into userinfo(username,password,photo,state) 
  values(#{username},#{password},#{photo},1)
</insert>

说明：参数占位符 #{} 和 ${}

• #{} ：预编译处理。
• ${} ：字符直接替换。
  预编译处理是指：MyBatis 在处理#{}时， 会将 SQL 中的 #{} 替换为 ? 号 ，使用用PreparedStatement 的set 方法来赋值。直接替换：是MyBatis 在处理 ${} 时， 就是把 ${} 替换成 变量的值 。

特殊的增加

默认情况下返回的是受影响的行号，如果想要 返回自增 id ，具体实现如下:

controller 实现代码：

public Integer add2(@RequestBody UserInfo userInfo) {
 
	userService.getAdd2(userInfo); 
	return user.getId();
}

mapper 接口：

@Mapper
public interface UserMapper {
 
	// 添加，返回?增id 
	void add2(User user);
}

mapper.xml 实现如下：

<insert id="add2" useGeneratedKeys="true" keyProperty="id"> 
    insert into userinfo(username,password,photo,state) 
    values(#{username},#{password},#{photo},1)
</insert>

useGeneratedKeys
keyColumn
keyProperty

3.2 删除操作

前面三个步骤操作类似，重点看下第四步，数据持久层的实现（xml）。

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

3.3 修改操作

<update id="update">
    update userinfo set username=#{name} where id=#{id}
</update>

3.4 查询操作

3.4.1 单表查询

查询操作需要设置返回类型，绝大数查询场景可以使? resultType 进行返回，它的优点是使用方便，直接定义到某个实体类即可。

<!-- 查询单条数据（根据id）-->
    <select id="getUserById" resultType="com.example.demo.model.UserInfo">
        select *
        from userinfo
        where id = #{id}
    </select>

3.4.2 多表查询

但有些场景就需要用到返回字典映射（ resultMap ）比如：

• 字段名称和程序中的属性名不同的情况；
• ?对?和?对多关系。

① 字段名和属性名不同的情况

xml 如下：

<resultMap id="BaseMap" type="com.example.demo.model.UserInfo"> 
<id column="id" property="id"></id>
<result column="username" property="username"></result> 
<result column="password" property="pwd"></result>
</resultMap>
<select id="getUserById"
resultMap="com.example.demo.mapper.UserMapper.BaseMap"> 
    select * from userinfo where id=#{id}
</select>

② 一对一映射

一对一映射要使用 <association> 标签，具体实现如下（一篇文章只对应一个作者）：

<resultMap id="BaseMap" type="com.example.demo.model.ArticleInfo">
	<id property="id" column="id"></id>
	<result property="title" column="title"></result>
	<result property="content" column="content"></result>
	<result property="createtime" column="createtime"></result>
	<result property="updatetime" column="updatetime"></result>
	<result property="uid" column="uid"></result>
	<result property="rcount" column="rcount"></result>
	<result property="state" column="state"></result>
	<association property="user"
		resultMap="com.example.demo.mapper.UserMapper.BaseMap" 
		columnPrefix="u_">
	</association> 
</resultMap>
<select id="getAll" resultMap="BaseMap">
  select a.*,u.username u_username from articleinfo a 
  left join userinfo u on a.uid=u.id
</select>

• property 属性：指定 Article 中对应的属性，即用户。
• resultMap 属性：指定关联的结果集映射，将基于该映射配置来组织用户数据。
• columnPrefix 属性：绑定一对一对象时，是通过
  columnPrefix+association.resultMap.column 来映射结果集字段。

③ 一对多映射

一对多需要使用 <collection> 标签，用法和 <association> 相同，如下所示：

<resultMap id="BaseMap" type="com.example.demo.model.UserInfo"> 
	<id column="id" property="id" />
	<result column="username" property="username"></result> 
	<result column="password" property="password"></result> 
	<result column="photo" property="photo"></result>
	<collection property="alist"
		resultMap="com.example.demo.mapper.ArticleInfoMapper.BaseMap"
		columnPrefix="a_">
	</collection> 
</resultMap>
<select id="getUserById" resultMap="BaseMap"> 
  select u.*,a.title a_title from userinfo u
  left join articleinfo a on u.id=a.uid where u.id=#{id}
</select>

3.4.3 like查询

like 使用 #{} 会报错，可以考虑使用 mysql 的内置函数 concat() 来处理，实现代码如下：

<select id="getUserByLikeName" resultType="com.example.demo.model.UserInfo">
        select *
        from userinfo
        where username like concat('%', #{username}, '%')
    </select>

4.动态SQL使用

动态 sql 是Mybatis的强大特性之一，能够完成不同条件下不同的 sql 拼接。

可以参考官方文档： Mybatis动态sql

4.1 if 标签

<insert id="add3">
        insert into userinfo(username,
        <if test="photo!=null">
            photo,
        </if>
        password)
        values (#{username},
        <if test="photo!=null">
            #{photo},
        </if>
        #{password})
    </insert>

test中的对象是传入对象的属性，当它不为空时，才拼接里面的内容。

4.2 trim 标签

<trim> 标签中有如下属性：

prefix
suffix
prefixOverrides
suffixOverrides

示例：

<insert id="add4">
        insert into userinfo
        <trim prefix="(" suffix=")" suffixOverrides=",">
            <if test="username!=null">
                username,
            </if>
            <if test="photo!=null">
                photo,
            </if>
            <if test="password!=null">
                password
            </if>
        </trim>
        values
        <trim prefix="(" suffix=")" suffixOverrides=",">
            <if test="username!=null">
                #{username},
            </if>
            <if test="photo!=null">
                #{photo},
            </if>
            <if test="password!=null">
                #{password}
            </if>
        </trim>
    </insert>

4.3 where 标签

传入的用户对象，根据属性做where条件查询，用户对象中属性不为 null 的，都为查询条件。

• <where> 标签, 如果有查询条件就会生成where, 如果没有查询条件就不会生成where
• <where> 会判断第一个条件前面有没有 and , 如果有就会去掉.

<select id="getList" resultMap="BaseMap">
        select * from userinfo
        <where>
            <if test="username!=null">
                username=#{username}
            </if>
            <if test="password!=null">
                and password=#{password}
            </if>
        </where>
    </select>

4.4 set 标签

更新的时候也会出现问题, 使用 <set> 标签来解决（与 <where> 标签类似）：

<update id="updateById">
        update userinfo
        <set>
            <if test="username!=null">
                username=#{username},
            </if>
            <if test="password!=null">
                password=#{password}
            </if>
        </set>
        where id=#{id}
    </update>

4.5 foreach 标签

对集合进行遍历时可以使用该标签。标签有如下属性：

collection
item
open
close
separator

示例：

<delete id="delete">
        delete from userinfo where id in
        <foreach collection="list" item="id" open="(" close=")" separator=",">
            #{id}
        </foreach>
    </delete>