初始MyBatis，w字带你解MyBatis

妖狐艹你老母 2024-03-22 12:33 107阅读 0赞

**目录**

一.什么是mybatis

mybatis的概念

mybatis的优势

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

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

1.创建项目

2.修改配置文件

3.准备数据库相关内容

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

5.定义对应的sql语句

6.准备对应的java类

四.占位符

五.多表查询

一对多的映射

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

一对一映射：

一对多的映射

六.动态sql

--------------------

## 一.什么是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.创建项目** ####

![a07716e893cd40d18a9d66717687ad0b.png][]

**选择依赖**![7590c0eb9e364e959368eb53a1697b5f.png][]

**配置编码集**

![7e77eb4682bf46509e5417676d72cfc8.png][]

![6031dd8a07594fbf9b797b362c6ead9e.png][]

**禁用JMX并配置热部署**![90962ab93aed45a68d5e97623adbdf6d.png][]

#### 2.修改配置文件 ####

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

原因如下：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接口**

![1ce2f4e6aad24f24ab3578947e4f341e.png][]

源码：

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文件

![7e99749c30474f7ca518bd22df66c3f1.png][]

源码如下：

<?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语句进行举例说明：

![373f23057a9841bd9a450159a6a75948.png][]

## 五.多表查询 ##

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

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

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

**resultMap一般存在的字段如下：**

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>映射的主键信息</td> 
  </tr> 
  <tr> 
   <td>property</td> 
   <td>映射到javaBean的字段名称</td> 
  </tr> 
  <tr> 
   <td>column</td> 
   <td>sql语句返回的查询结果对应的列名</td> 
  </tr> 
 </tbody> 
</table>

**基本的结果映射如下：**

![61ae4c74810541a28a73afa2f38fecde.png][]

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

映射的类名不匹配:

![dba584fdcad94d68a6e0ab74ecde74e8.png][]

**一对一的映射**

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

**这里引出了association联合：**

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

![992977293f774fda832c21bd649233e2.png][]

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

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

除此之外，还需要对返回值类型对应的主类中添加对应的字段：  
![027896f9261b4f4c9985053fd1fbc03f.png][]

源码如下：

### 一对多的映射 ###

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

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

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

![02474160b334462d841d49489dd673e8.png][]

##  ##

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

#### **一对一映射：**    ####

![4cbe9bca316f44488fb86b77894fd7ba.png][]

![419934c0e3294220a880d5430b4398ea.png][]

![7781adf1c7274e55bcd473539d650b01.png][]

#### 一对多的映射 ####

![6e2f8a93609148a4b134719a38a4c092.png][]

![49d30da1b73248a2ae528ce3f2cca542.png][]

![3120b7e8391b4a719a03a48de71de6df.png][]

## 六.动态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语句符合语法规则，提高效率**

#### **<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类型**

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

![0a9d09aca9564191b0093537ce512833.png][]

复杂类型：

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

[a07716e893cd40d18a9d66717687ad0b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/5c12ebd252ed4cd495e1020a3e3a28b2.png
[7590c0eb9e364e959368eb53a1697b5f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/5c503fce72c04b1780db471e3c4a1f2a.png
[7e77eb4682bf46509e5417676d72cfc8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/22762636709245228b5e199dcf3524a3.png
[6031dd8a07594fbf9b797b362c6ead9e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/a44a864e3928488d91eb18a93e637625.png
[90962ab93aed45a68d5e97623adbdf6d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/ce48b7499dae441a9e0a53270e532929.png
[716f3d6d4c654c4cbc4d9c7de088638a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/a10370d26191438e9594f65956bcbdce.png
[1ce2f4e6aad24f24ab3578947e4f341e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/8fabee12c5e24963b351c6441a086e57.png
[7e99749c30474f7ca518bd22df66c3f1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/d07a29fcacfc45ad81b441f5de6738ed.png
[373f23057a9841bd9a450159a6a75948.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/4ddebd4969dc4f8b9611958d6f0e063e.png
[61ae4c74810541a28a73afa2f38fecde.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/736c4901df564f38b17b68a9a4f23eba.png
[dba584fdcad94d68a6e0ab74ecde74e8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/5fa58166fd23435790fc86d4af4b0d25.png
[992977293f774fda832c21bd649233e2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/ca3da15bbfa24f32a91067745722c0b0.png
[027896f9261b4f4c9985053fd1fbc03f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/4eee36c64a3849d1acba727a7e0ccc30.png
[02474160b334462d841d49489dd673e8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/da1077d377254e20a2286f6a4c017015.png
[4cbe9bca316f44488fb86b77894fd7ba.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/89b03fa7a2b0472580e790ac334c84c8.png
[419934c0e3294220a880d5430b4398ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/50041f5b8d52418d88c65aa74e965c86.png
[7781adf1c7274e55bcd473539d650b01.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/287604a852b14232a802cff00777e70d.png
[6e2f8a93609148a4b134719a38a4c092.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/73abb954c0594b1c8c92d482a677f355.png
[49d30da1b73248a2ae528ce3f2cca542.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/3dfe50d0dbc3481e95cc9a80d6665441.png
[3120b7e8391b4a719a03a48de71de6df.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/28093b7205f74eecb8f5a99b0a977c85.png
[0a9d09aca9564191b0093537ce512833.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/9b0d4bcaad834c8a94d08b42f354588b.png