初始MyBatis，w字带你解MyBatis

一.什么是mybatis

mybatis的概念

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。1、Mybatis是一个半ORM（对象关系映射）框架，底层封装了JDBC，是程序员在开发时只需要关注SQL语句本身，不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。使得程序员可以花更多的精力放到业务开发中。另外，程序员直接编写原生态sql，严格控制sql执行性能，灵活度高。2、MyBatis 可以使用简单的 XML文件 或注解方式来配置和映射原生信息，将 POJO映射成数据库中的记录，避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。3、通过xml 文件或注解的方式将要执行的各种 statement 配置起来，并通过java对象和 statement中sql的动态参数进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射为java对象并返回。（从执行sql到返回result的过程）。

mybatis的优势

1.mybatis基于sql进行编程，通过将sql语句写入xml文件中，不会对我们当前应用程序和数据库的设计产生任何影响；同时将sql写在xml文件中，解除了sql和程序代码的耦合，便于程序的统一管理，同时提供xml标签，允许实现动态sql，从而提高了sql的可重用性

2.与JDBC相比，代码量减少了50%以上，消除了大量的冗余代码，使我们更多的精力放到了sql的设计

3.提供映射标签，提供java对象和数据库字段的ORM字段映射。

4.很好的与各种数据库兼容（因为MyBatis使用JDBC来连接数据库，所以只要JDBC支持的数据库MyBatis都支持）

5.能够与Spring很好的集成；

二.mybatis相对于JDBC，框架帮我们做了哪些事情？

我们通过对比JDBC进行数据库操作的代码，我们对JDBC和MyBatis进行对比

 public static Blog selectById(Long id){
        //检查id的有效性
        if (LongUtil.isValid(id)){
            return null;
        }
        Connection connection=null;
        PreparedStatement statement=null;
        ResultSet resultSet=null;

        //数据有效，进行数据查询
        //建立连接
        try {
            connection = DBUtil.getConnection();
            //定义sql语句
            String sql="select id,title,content,createTime,userId from blog where id=?";
            //创建执行对象并填充参数
            statement = connection.prepareStatement(sql);
            //填充参数
            statement.setLong(1,id);
            //执行语句
            resultSet = statement.executeQuery();
            //处理运行结果
            if (resultSet.next()){
                //创建新对象返回
                Blog blog = new Blog();
                blog.setId(resultSet.getLong("id"));
                blog.setTitle(resultSet.getString("title"));
                blog.setContent(resultSet.getString("content"));
                blog.setCreateTime(resultSet.getTimestamp("createTime"));
                blog.setUserId(resultSet.getLong("userId"));
                return blog;

            }else {
                //如果结果为空
                return null;
            }

        } catch (SQLException e) {
            throw new RuntimeException(e);
        }finally {
            //断开连接
            DBUtil.close(resultSet, statement, connection);
        }
    }

我们可以从中总结以下七个步骤：①建立连接②定义sql语句③预执行④补充参数⑤执行sql语句⑥返回并处理结果⑦断开连接

而mybatis相对其而言就化简了很多，通过在配置文件中设置数据库连接的相关参数，不需要再手动调用api进行数据库的连接，也不需要手动调用api执行sql语句（内层api），处理结果直接通过对应的mapper接口对应的方法的返回值映射到java类中，更不需要进行手动断开与数据库的连接，总结下来：我们只需要进行mapper接口和对应的xml文件的映射操作和编写sql语句，大大提高了我们进行代码开发的效率，在很大程度上也减少了代码量。

除此之外，我们在mapper的接口和对应的xml文件只进行了命名空间和方法的映射的标识，而实际的映射工作是mybatis框架帮我们做的（mybatis框架对jdbc进行了封装，并通过其他配置自动完成某些工作）

三.对包含mybatis的程序进行实操

1.创建项目

** 选择依赖**

配置编码集

禁用JMX并配置热部署

2.修改配置文件

如果我们在项目启动时没有配置对应的驱动源、url、用户名和密码，会报以下的错误：

原因如下：springboot引入了mybatis框架依赖包，在项目启动时会默认加载一些资源，如果在配置文件中找不到这部分资源，则就会报错

# 设置mysql数据源驱动
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 设置url
spring.datasource.url=jdbc:mysql://localhost:3307/java23characterEncoding=utf8&useSSL=false
# 设置用户名
spring.datasource.username=root
# 设置密码
spring.datasource.password=abc123
# 定义mapper文件的配置
mybatis.mapper-locations=classpath:mapper/**Mapper.xml

3.准备数据库相关内容

建表语句如下：

-- 创建数据库
drop database if exists java23;
create database java23 DEFAULT CHARACTER SET utf8;

-- 使用数据数据
use java23;

-- 创建表[用户表]
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,
 `state` int default 1
);

-- 创建文章表
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,
                            uid int not null,
                            rcount int not null default 1,
                            `state` int default 1
);

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

-- 添加一个用户信息
INSERT INTO `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 `userinfo` (`id`, `username`, `password`, `photo`, `createtime`, `updatetime`, `state`) VALUES
    (2, 'abc', '123', '', '2021-12-06 17:10:48', '2021-12-06 17:10:48', 1);

-- 文章添加测试数据
insert into articleinfo(title,content,uid,createtime) values('Java','Java正文',1,'2023-05-05 19:09');
insert into articleinfo(title,content,uid,createtime) values('C++','C++正文',1,'2023-05-04 19:09');
insert into articleinfo(title,content,uid,createtime) values('#C','#C正文',1,'2023-05-03 19:09');
insert into articleinfo(title,content,uid,createtime) values('Python','Python正文',2,'2023-05-03 19:09');

4.准备对应的xml文件和对应的mapper接口

设置mapper接口

源码：

import com.ljl.mybatis_study.model.ArticleInfo;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

/**
 * @author tongchen
 * @create 2023-05-05 15:15
 */
@Mapper
public interface ArticleMapper {
    List<ArticleInfo> listAll();
    List<ArticleInfo >listOne(Integer id);
    Integer add(ArticleInfo info);
    Integer del(Integer id);
    List<ArticleInfo>order(String column ,String orders);
    List<ArticleInfo>likeName(String name);

}

设置对应的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.ljl.mybatis_study.mapper.ArticleMapper">
    <select id="listAll" resultType="com.ljl.mybatis_study.model.ArticleInfo">
        select *from articleinfo
    </select>

</mapper>

5.定义对应的sql语句

在对应的标签中写入对应的sql语句

在此处就是在select标签内写入对应的sql语句

select *from articleinfo

6.准备对应的java类

select语句返回的是具体的sql对象，在我们的程序中由数据库以字符串的形式传输过来之后，需要映射到具体的java类，而这个类，需要对应我们程序中的具体实体类

我们给出实体类的源码：

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

import java.util.Date;

/**
 * @author tongchen
 * @create 2023-05-05 15:24
 */
@Setter
@Getter
@ToString
public class ArticleInfo {
    private Integer id;
    private String title;
    private String content;
    private Date createtime;
    private Date updatetime;
    private Integer uid;
    private Integer rcount;
    private Integer state;
    private Userinfo userinfo;
}

四.占位符

在mybatis中存在两种类型的占位符：#{对应的变量名称}和${对应的变量名称}：两者的区别如下：#{}对应的到具体的sql语句中存在单引号，即为'变量名'，它的特征也侧面反映了它的应用场景：存放某个变量中具体的值。它的实现原理如下：通过jdbc的预处理，变量名对应的位置首先用？进行占位，之后调用preparedStatement.setxxx来进行替换

而${}对应的变量在sql语句中没有单引号，因此它的应用场景一般如下：例如order by 变量名 遍历顺序 ，它的实现原理是字符串的拼接：****但是字符串拼接存在一个相对严重的安全隐患：sql注入，而预处理恰好可以解决此问题，预处理解决问题的方式如下：对''进行转义

我们以like语句进行举例说明：

五.多表查询

我们在前后端传输过程汇中从sql中的对象到java类中对象的映射过程中对应着java类中具体的对象类型，但是如果我们在进行多表查询时，查询到的数据通常是除了具体的java类之外还包括其他的额外字段，这时我们又该如何进行从sql对象到java对象的映射呢?

answer:使用resultMap（结果映射）：resultMap是Mybatis最强大的元素，它可以将查询到的复杂数据（比如查询到几个表中数据）映射到一个结果集当中。使用resultType进行输出映射，只有查询出来的列名和pojo（实体bean）中的属性名一致，该列才可以映射成功。简单来说也就是你的数据库字段和JavaBean里的字段名称必须一致才能映射成功。所以当我们JavaBean中的字段名和数据库字段名称有不同的时候，或者是多表查询的时候，一般会使用resultMap

resultMap的作用和意义：　resultMap 元素是 MyBatis 中最重要最强大的元素。它就是让你远离 90%的需要从结果 集中取出数据的 JDBC 代码的那个东西, 而且在一些情形下允许你做一些 JDBC 不支持的事 情。 事实上, 编写相似于对复杂语句联合映射这些等同的代码, 也许可以跨过上千行的代码。 ResultMap 的设计就是简单语句不需要明确的结果映射,而很多复杂语句确实需要描述它们 的关系。

resultMap一般存在的字段如下：
id映射的主键信息property映射到javaBean的字段名称columnsql语句返回的查询结果对应的列名
基本的结果映射如下：

** 映射时需要注意的是：property 和 column所对应的数据变量名必须相对应，即java类中的属性名和property对应的变量名应该完全一致，column和对应的变量名和sql语句返回对象对应的字段名称也应该保持一致。**

映射的类名不匹配:

一对一的映射

这里进行的一对一映射和一对多映射才真正涉及到多表查询

这里引出了association联合：

**　　联合元素用来处理“一对一”的关系。需要指定映射的Java实体类的属性，属性的javaType（通常MyBatis 自己会识别）。**

** type:resultMap中对应的java中的类**

除了上所示例的对应的属性的对应关系之外，还需要一个association来进行额外关系的映射（除了某个具体的java类对应的字段之外的额外字段）

    <resultMap id="BaseMap" type="com.ljl.mybatis_study.model.ArticleInfo">
        <id column="id" property="id"/>
        <result column="title" property="title"/>
        <result column="content" property="content"/>
        <result column="createtime" property="createtime"/>
        <result column="updatetime" property="updatetime"/>
        <result column="uid" property="uid"/>
        <result column="rcount" property="rcount"/>
        <result column="state" property="state"/>
        <association property="userinfo" resultMap="UserMap" columnPrefix="u_"/>

    </resultMap>

除此之外，还需要对返回值类型对应的主类中添加对应的字段：

源码如下：

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

import java.util.Date;

/**
 * @author tongchen
 * @create 2023-05-05 15:24
 */
@Setter
@Getter
@ToString
public class ArticleInfo {
    private Integer id;
    private String title;
    private String content;
    private Date createtime;
    private Date updatetime;
    private Integer uid;
    private Integer rcount;
    private Integer state;
    private Userinfo userinfo;
}

一对多的映射

由于是一对多，所以这里就引出了collection聚集：

　　聚集元素用来处理“一对多”的关系。需要指定映射的Java实体类的属性，属性的javaType（一般为ArrayList）；列表中对象的类型ofType（Java实体类）。

同样，type代表的是这个resultmap对应的java类

<resultMap id="UserMap" type="com.ljl.mybatis_study.model.Userinfo">
        <id column="id" property="id"/>
        <result column="username" property="username" />
        <result column="password" property="password" />
        <result column="photo" property="photo" />
        <result column="createtime" property="createtime" />
        <result column="updatetime" property="updatetime" />
        <result column="state" property="state" />
        <collection property="articleInfos" resultMap="BaseMap"
                    columnPrefix="a_"/>
    </resultMap>

我们引入具体的前后端交互的逻辑关系：

一对一映射：

一对多的映射

六.动态sql

**<if>**标签

语法规则：<if test="条件语句">

if标签通常结合trim标签结合使用，是动态sql的语句符合SQL的语法规则

实例：

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

**<trim>****标签 **

语法规则：

*prefix：表示整个语句块，以prefix***的值作为前缀 **

*suffix：表示整个语句块，以suffix***的值作为后缀 **

*prefixOverrides***：表示整个语句块要去除掉的前缀 **

suffixOverrides****：表示整个语句块要去除掉的后缀

作用：加入或删除某些sql语句的内容，使sql语句符合语法规则，提高效率

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

**<where>****标签 **

对动态sql语句进行条件限制，并可以去除where条件下第一个and符号

在作用上相当于：** <trim prefix="where" prefixOverrides="and">**

具体使用：

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

**<set>****标签 **

用于sql语句中的update语句，并且可以去除最后一个逗号

**set标签也可以使用 **<trim prefix="set" suffixOverrides=","> 替换。

具体使用如下：

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

**<foreach>****标签 **

对集合进行遍历时使用该标签

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

对于使用foreach进行遍历的元素，一般将其划分为两种，集合中存在的基本数据类型或者是其包装类，另一种是自定义的数据类型，对于集合中储存基本数据类型，我们一般要在Controller层对应的方法参数中添加@RequestParam注解，如果不加传输的数据当做普通元素进行处理，会报错，报错信息如下：Request processing failed; nested exception is java.lang.IllegalStateException: No primary or single unique constructor found for interface java.util.List
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1014) ~[spring-webmvc-5.3.27.jar:5.3.27]
at org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:909) ~[spring-webmvc-5.3.27.jar:5.3.27]

即没有唯一的构造方法

而对于我们自定义的方法，我们一般使用的则是@RequestBody这个注解，此时前端传输的数据通常是json类型

我们对一个简单类型和复杂类型分别进行遍历：
简单类型：

复杂类型：

  <insert id="dynamicInsertMore">
    insert into userinfo (username ,password ,photo)
    values
    <foreach collection="list" item="userinfo"  separator=",">
        (#{userinfo.username},#{userinfo.password},#{userinfo.photo})
    </foreach>