【Java】Mybatis查询数据库

MyBatis查询数据库

经过前面的学习Spring系列的操作已经差不多了，接下来我们继续学习更加重要的知识，将前端传递的参数存储起来，或者查询数据库里面的数据

1. MyBatis 是什么？

MyBatis是款优秀的持久层框架，它支持自定义SQL、存储过程以及高级映射。MyBatis几乎祛除了所有的JDBC代码以及设置参数和获取结果集的操作。MyBatis可以通过简单的XML或者注解来配置和映射原始类型、接口和Java POJO为数据库中的记录

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

2. 为什么要学习MyBatis？

对于后端程序员来说，程序是由以下两个程序组成的：

1. 后端程序
2. 数据库

而这两个重要的组成部分要通讯，就要依靠数据库连接工具，那么数据库连接工具有哪些？比如JDBC还有今天我们要介绍的MyBatis。既然已经有了JDBC，为什么还要学习MyBatis？这是因为JDBC操作太繁琐了，我们来回顾一下JDBC的操作流程：

1. 创建数据库连接池DataSource
2. 通过DataSource获取数据库连接Connection
3. 编写要带？的占位符的SQL语句
4. 通过Connection及SQL创建操作命令对象Statement
5. 替换占位符：指定要替换的数据库字段类型，占位符索引及要替换的值
6. 使用Statement执行SQL语句
7. 查询操作：返回结果集ResultSet，更新操作：返回更新的数量
8. 处理结果集
9. 释放资源

3. 怎么学MyBatis？

MyBatis的学习只分为两部分：

1. 配置MyBatis开发环境
2. 使用MyBatis模式和语法操作数据库

4. 第一个MyBatis查询

开始搭建MyBatis之前，我们需要先来看看它在整个框架之中的地位

MyBatis也是一个ORM框架，ORM即对象关系映射。在面向对象编程语言当中，讲关系型数据库中的数据与对象建立起映射关系，进行自动完成数据与对象的相互转换

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

ORM把数据库映射为对象：

• 数据表—》 类
• 记录—》对象
• 字段—》对象的属性

一般的ORM框架，会将数据库模型的每一张表都映射为一个Java类

也就是说使用MyBatis可以像操作对象一样操作数据库中的表，可以实现对象和数据表之间的转换，我们接下来看看MyBatis的使用

4.1 创建数据库和表

使用MyBatis的方式来读取用户表当中的所有用户，我们使用个人博客的数据包。

-- 创建数据库
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';
-- 添加⼀个⽤户信息
INSERT INTO `mycnblog`.`userinfo` (`id`, `username`, `password`, `photo`,
`createtime`, `updatetime`, `state`) VALUES
(1, 'admin', 'admin', '', '2021-12-06 17:10:48', '2021-12-06 17:10:48', 1)
;
-- ⽂章添加测试数据
insert into articleinfo(title,content,uid)
values('Java','Java正⽂',1);

-- 添加视频
insert into videoinfo(vid,title,url,uid) values(1,'java title','http://ww
w.baidu.com',1);

4.2 添加MyBatis框架支持

添加MyBatis框架支持分为两种情况：一种情况是对之前的Spring项目进行升级，另一种情况是创建一个全新的MyBatis和Spring Boot项目

扩展：在老项目当中快速的添加框架，更简单的操作是使用EditStarters插件

4.3 配置连接字符串和MyBatis

此步骤需要进行两项设置，数据库连接字符串设置和MyBatis的XML文件配置

4.3.1 配置连接数据库

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/mycnblog?characterEncoding=utf8&&useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver

注意事项：

如果使用mysql-connector-java是5.x之前使用的con.mysql.jdbc.Driver如果大于5.x使用的是com.mysql.cj.jdbc.Driver

配置MyBatis中的XML路径

MyBatis的XML中保存的是查询数据库的具体操作的SQL，配置如下：

mybatis:
  mapper-locations: classpath:mybatis/**Mapper.xml

4.4 添加业务代码

下面按照后端开发的工程思路，也就是下面的流程来实现MyBatis查询所有用户的功能：

4.4.1 添加实体类

先添加用户的实体类：

import lombok.Data;
import java.util.Date;
@Data
public class User {
    
    
 private Integer id;
 private String username;
 private String password;
 private String photo;
 private Date createTime;
 private Date updateTime;
}

4.4.2 添加Mapper接口

数据持久层的接口定义：

@Mapper
public interface UserMapper {
    
    
    public UserInfo getUserById(@Param("id") Integer id);

    public void add(@RequestBody UserInfo userInfo);
}

4.4.3 添加UserMapper.xml

数据持久层的实现，MyBatis的固定格式：

<?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="getUserById" resultType="com.example.demo.model.UserInfo">
        select * from userinfo where id = #{id}
    </select>
</mapper>

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

4.4.4 添加Service

服务层代码如下：

@Service
public class UserService {
    
    
    @Resource
    private UserMapper userMapper;

    public UserInfo getUserById(Integer id) {
    
    
        return userMapper.getUserById(id);
    }
}

4.4.5 添加Controller

控制层的代码实现如下：

@Controller
@ResponseBody
public class UserController {
    
    
    @Resource
    private UserService userService;

    @RequestMapping("/getuserbyid")
    public UserInfo getUserById(Integer id) {
    
    
        return userService.getUserById(id);
    }
}

5. 增、删、改操作

5.1 增加用户的操作

<insert id="add">
    insert into userinfo(username, password, photo) values (#{username}, #{password}, #{photo})
</insert>
<insert id="getId" useGeneratedKeys="true" keyProperty="id" keyColumn="id">
    insert into userinfo(username, password, photo) values (#{username}, #{password}, #{photo})
</insert>

• useGeneratedKeys: 这会令MyBatis使用JDBC的getGeneratedKeys 方法取出由数据库内部生成的主键。（像MySQL和SQL service这样的关系型数据库关系系统自增主键）默认值是：false
• keyColumn: 设置生成建在表中的列名，在某些数据库当中，当主键的列不是第一列的时候，是必须设置的。如果生成列不止一个，可以用逗号分割各个属性名称
• keyProperty：指定能够唯一

5.2 删除用户的操作

<delete id="del">
    delete from userinfo where id = #{id}
</delete>

5.3 修改用户操作

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

6. 查询操作

6.1 单表查询

controller代码如下：

@RequestMapping("/getuserbyid")
public UserInfo getUserById(Integer id) {
    
    
    return userService.getUserById(id);
}

Mapper.xml实现代码如下：

<select id="getUserById" resultType="com.example.demo.model.UserInfo">
    select * from userinfo where id = #{id}
</select>

6.1.1 参数占位符 #{} 和 ${}

• #{} ：预编译处理
• ${}：字符直接替换

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

6.1.2 $优点

使用${}可以实现排序查询，而是用#{}就不能实现排序查询，因为当使用#{}查询时，如果传递的值为String则会加引号，就会导致SQL错误。

6.1.3 SQL 注入问题

<select id="isLogin" resultType="com.example.demo.model.User">
	select * from userinfo where username='${name}' and password='${pwd}'
</select>

结论：用于查询的字段，尽量使用#{}预查询的方式

6.1.4 like查询

like使用#{}报错，这个时候不能使用${}，可以考虑使用MySQL内置的函数concat()来处理，实现代码如下：

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

concat可以连接字符。

6.2 多表查询

如果增、删、改返回影响的行数，那么在mapper.xml中可以不设置返回的类型的。但是即使是最简单的查询，也要设置返回类型否则就会出现错误。

也就是说**对于<select>查询标签，至少存在两个属性：

• id 属性：用于标识实现接口的那个方法
• 结果映射属性：结果映射有两种实现标签：<resultType和<resultMap

6.2.1 返回类型

绝大多数查询场景可以使用resultType进行返回，如下代码所示：

<select id="getNameById" resultType="java.lang.String">
    select username from userinfo where id=#{id}
</select>

它的优点就是使用方便、直接定义到某个实体类就可以

6.2.2 返回字典映射：resultMap

resultMap使用场景：

• 字段名称和程序中的属性名称不相同的情况，可以使用resultMap配置映射
• 一对一和多对一关系可以使用resultMap映射并查询数据

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

<resultMap id="BaseMap" type="com.example.demo.model.User">
    <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>

6.2.3 多表查询

在多表查询的时候，如果使用resultMap标签，在一个类中包含了另一个对象是查询不出来包含的对象的。如下图所示：

此时我们就需要使用特殊手段来实现联表查询了。

6.2.3.1 一对一的映射

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

<resultMap id="BaseMap" type="com.example.demo.model.ArticleInfo">
    <id column="id" property="id"></id>
    <result column="title" property="title"></result>
    <result column="content" property="content"></result>
    <result column="createtime" property="createtime"></result>
    <result column="updatetime" property="updatetime"></result>
    <result column="uid" property="uid"></result>
    <result column="rcount" property="rcount"></result>
    <result column="state" property="state"></result>
    <association property="userInfo" resultMap="com.example.demo.mapper.UserMapper.BaseMap" columnPrefix="u_">				</association>
</resultMap>

<select id="getArticleById" resultMap="BaseMap">
    select a.*, u.id u_id, u.username u_username, u.password u_password from articleinfo a left join userinfo u on a.uid = u.id where a.id = #{id}
</select>

以上使用<assciation>标签，表示一对一的结果映射：

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

注意：columnPrefix属性不能省略，如果省略当联表中有相同的字段，那么会导致查询出错

6.2.3.2 一对多的映射

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

<resultMap id="BaseMap" type="com.example.demo.model.ArticleInfo">
    <id column="id" property="id"></id>
    <result column="title" property="title"></result>
    <result column="content" property="content"></result>
    <result column="createtime" property="createtime"></result>
    <result column="updatetime" property="updatetime"></result>
    <result column="uid" property="uid"></result>
    <result column="rcount" property="rcount"></result>
    <result column="state" property="state"></result>
    <association property="userInfo" resultMap="com.example.demo.mapper.UserMapper.BaseMap" columnPrefix="u_">		    </association>
</resultMap>

<select id="getArticleById" resultMap="BaseMap">
    select a.*, u.id u_id, u.username u_username, u.password u_password from articleinfo a left join userinfo u on a.uid = u.id where a.id = #{id}
</select>

7. 复杂情况

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

7.1 <if>标签

在注册的时候，我们可能遇到这样一个问题。注册分为两个字段：必填字段和非必传字段，那如果在添加用户的时候又不确定的字段传入，程序应该如何实现？

这个时候我们就需要使用动态标签了。

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

注意test中的，是传入对象的属性，不是数据库字段

7.2 <trim>标签

之前的插入功能，只是有一个字段为可选项，如果所有字段都是非必选项，就需要考虑用标签结合标签，对多个字段都采用动态生成的方式。

标签当中有如下属性：

• prefix: 表示整个语句块，以prefix值为前缀
• suffix：表示整个语句块，以suffix的值为后缀
• prefixOverrides：表示整个语句块要去除的前缀
• suffixOverrides：表示整个语句块要去除的后缀

使用方法如下：

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

以上SQL动态解析时，会将第一个trim部分如下处理：

• 基于prefix配置，开始加上（
• 基于suffix配置，结束部分加上）
• 多个if组织的语句都以, 结尾，在最后拼接好的字符串还会以,结尾会基于suffixOverrides配置去掉最后一个,
• if 中的test是传入对象的属性

7.3 <where>标签

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

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

7.4 <set>标签

根据传入的用户对象属性来更新用户数据，可以使用标签来指定动态内容

<update id="updateById" parameterType="org.example.model.User">
    update user
    <set>
        <if test="username != null">
            username=#{username},
        </if>
        <if test="password != null">
            password=#{password},
        </if>
        <if test="nickname != null">
            nickname=#{nickname},
        </if>
        <if test="sex != null">
            sex=#{sex},
        </if>
        <if test="birthday != null">
            birthday=#{birthday},
        </if>
        <if test="head != null">
            head=#{head},
        </if>
        <if test="createTime != null">
            create_time=#{createTime},
        </if>
    </set>
    where id=#{id}
</update>

7.5 <foreach>标签

对集合进行遍历时， 可以使用该标签。<foreach>标签有以下属性。

• collection：绑定方法参数中的集合，如List、Set、Map或数组对象
• item：遍历时的每一个对象
• open：语句块开头的字符串
• close：语句块结束时的字符串