mybatis 作为数据的 ORM 框架，在国内的应用市场还是非常可观的，当初刚开始工作时使用 spring + mybatis 进行开发，后来也使用过 hibernate, jdbctemplate, jooq，mybatisplus 等其他的一些框架，

就个人使用感触来讲 jooq 的使用姿势和写 sql 差不多，基本上可以会写 sql 的无需额外的培训，立马可以上手；

hibernate 最大的特点就是借助方法名来映射 sql 语句，非常有特点，但是当查询条件复杂一些的话，对小白而言就没有那么友好了；

而 jdbctemplate，这个在小项目，轻量的 db 操作中，用起来还是很爽的，非常灵活，但是也有一些点需要特别注意，比如 queryForObject，查不到数据时抛异常而不是返回 null；

至于 mybatis 以及衍生的 mybatis-plus，也就是接下来的主角了，它的特点如何，为什么受到国内大量开发者的追捧，将它作为 db 操作的第一 ORM 框架，让我们看完之后再说

I. 基础环境搭建

接下来的 Mybatis 的项目演示，主要是在 SpringBoot 的环境下运行，底层的数据库采用 MySql，对应的版本信息如下

springboot: 2.2.0.RELEASE
mysql: 5.7.22

1. SpringBoot 项目配置

关于 SpringBoot 的项目创建过程省略，下面是核心的 pom 依赖

<dependencies>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
</dependencies>

核心的依赖 mybatis-spring-boot-starter，至于版本选择，到 mvn 仓库中，找最新的

另外一个不可获取的就是 db 配置信息， appliaction.yml

spring:
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/story?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password:

2. 数据库准备

在本地数据库中，新增了一个表如下

CREATE TABLE `money` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(20) NOT NULL DEFAULT '' COMMENT '用户名',
  `money` int(26) NOT NULL DEFAULT '0' COMMENT '钱',
  `is_deleted` tinyint(1) NOT NULL DEFAULT '0',
  `create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `name` (`name`)
) ENGINE=InnoDB AUTO_INCREMENT=551 DEFAULT CHARSET=utf8mb4;

接下来本文涉及到的 CURD 都是针对这张表来说的

II. MyBatis CURD

接下来我们将从 0 到 1，实现基于 mybatis 进行 mysql 操作的全流程

1. 基本对象

经常使用 Mybatis 的小伙伴可能知道，操作一个 db，通常会伴随几个不可或缺的东西

数据库实体类：可以理解为数据库表锁映射到的 Java Bean 对象
Mapper 接口：interface 类，其中定义 db 的操作方法
xml 文件：与上面接口对应，xml 文件中写实际的 sql

mybatis 推荐的玩法是借助 xml 来写 sql，但是官方也提供了注解的方式，因此 xml 文件并不是必须的；后面会介绍注解的操作方式；本文将主要是传统的 xml 配套使用姿势

针对上面这张表，第一步定义实体类 MoneyPo

@Data
@NoArgsConstructor
@AllArgsConstructor
public class MoneyPo {
    private Integer id;
    private String name;
    private Long money;
    private Integer isDeleted;
    private Timestamp createAt;
    private Timestamp updateAt;
}

上面的三个注解属于 lombok 的知识点，有不清楚的小伙伴可以搜索一下

接下来是 Mapper 接口, MoneyMapper如下

// 注意这个@Mapper注解，用于表明这个接口属于Mybatis的Mapper对象
@Mapper
public interface MoneyMapper {
}

然后是 Mapper 接口对应的 xml 文件 MoneyMapper.xml

注意 xml 文件放在资源文件 resources下面，且 xml 文件的目录结构，与上面的 Mapper 接口的包路径保持完全一致。

<?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.git.hui.boot.mybatis.mapper.MoneyMapper">
</mapper>

2. 数据插入

前面的三步骤，将我们需要的实体类，接口对象，xml 文件都初始化完毕，接下来就是进入我们的 CURD 环节，实现数据库的增删改查，这里主要使用 insert标签

比如我们现在希望插入一条数据，首先需要做的就是在 Mapper 接口中定义一个方法

int savePo(@Param("po") MoneyPo po);

接着就是在 xml 文件中对应的 sql

<insert id="savePo" parameterType="com.git.hui.boot.mybatis.entity.MoneyPo" useGeneratedKeys="true"
        keyProperty="po.id">
  INSERT INTO `money` (`name`, `money`, `is_deleted`)
  VALUES
(#{po.name}, #{po.money}, #{po.isDeleted});
</insert>

2.1 解析说明

注意上面的 xml 文件

parameterType: 用于指定传参类型
useGenerateKeys + keyProperty: 表明需要将插入 db 的主键 id，会写到这个实体类的 id 字段上
sql 语句传参：形如 #{}，大括号里面填写变量名，上面用的是 po.name，po 为接口定义中的参数名，这个就表示使用 po 对象的 name 成员，作为 db 的 name 字段

接下来就是重要知识点：

传参除了使用 #{}之外，还可以使用 ${}，区别在于前面为参数参数占位，后面为字符串替换，因此存在 sql 注入的风险

举例说明

select * from money where id=${id}
select * from money where id=#{id}

针对上面这两个 sql，当 id = 1 or 1=1，对应的两个 sql 变成

-- 第一个sql会返回所有的数据
select * from money where id = 1 or 1 =1
-- 下面这个会抛sql异常
select * from money where id = '1 or 1=1'

2.2 批量插入

除了上面的单挑插入，批量插入也是 ok 的，和前面的使用姿势差不多

int batchSave(@Param("list") List<MoneyPo> list);

对应的 sql 如下

<insert id="batchSave" parameterType="com.git.hui.boot.mybatis.entity.MoneyPo"  useGeneratedKeys="true" keyProperty="id">
    insert ignore into `money` (`name`, `money`, `is_deleted`)
    values
    <foreach collection="list" item="item" index="index" separator=",">
        (#{item.name}, #{item.money}, #{item.isDeleted})
    </foreach>
</insert>

对于 foreach 标签的说明，会放在后面的博文中专门进行介绍，这里简单理解为遍历即可

3. 数据查询

查询可以说是我们日常开发中最常见的情况了，这里先给出简单的查询 demo，至于更复杂的查询条件（如联表，子查询，条件查询等）在后面的博文中进行介绍

如根据主键进行查询，主要借助 select标签来实现

MoneyPo findById(int id);

对应的 sql

  <resultMap id="BaseResultMap" type="com.git.hui.boot.mybatis.entity.MoneyPo">
    <id column="id" property="id" jdbcType="INTEGER"/>
    <result column="name" property="name" jdbcType="VARCHAR"/>
    <result column="money" property="money" jdbcType="INTEGER"/>
    <result column="is_deleted" property="isDeleted" jdbcType="TINYINT"/>
    <result column="create_at" property="createAt" jdbcType="TIMESTAMP"/>
    <result column="update_at" property="updateAt" jdbcType="TIMESTAMP"/>
</resultMap>
<sql id="money_po">
  id, name, money, is_deleted, create_at, update_at
</sql>
<select id="findById" parameterType="java.lang.Integer" resultMap="BaseResultMap">
    select
    <include refid="money_po"/>
    from money where id=#{id}
</select>

重点关注下上面的实现，select 语句内容比较简单，但是有几个需要注意的点

sql 标签：内部定义需要查询的 db 字段，最大的特点是供后面的查询语句，通过 include来引入，从而实现代码片段的复用
resullMap 标签：从 db 字段与 MoneyPo 实体类对比，我们可以知道部分字段名不是完全一样，如 db 中使用下划线，java 中使用驼峰，那么 db 字段与 java 成员变量如何映射呢？这里使用 result标签来指定两者的映射关系，以及类型

（上面这个相信会始终伴随各位小伙伴的开发生涯）

4. 数据更新

更新主要借助 update标签，相比较上面的两个，它的知识点就比较少了

int addMoney(@Param("id") int id, @Param("money") int money);

对应的 sql 如下

<update id="addMoney" parameterType="java.util.Map">
    update money set money=money+#{money} where id=#{id}
</update>

说明

上面标签中的 parameterType，在这里实际上是可以省略的
@Param注解：主要用于指定参数名，在 xml 中可以使用内部定义的名字来作为参数变量；如果不加上这个注解，在 xml 中，参数变量则使用 param0, param1来替代

5. 数据删除

删除使用 delete标签

int delPo(@Param("id") int id);

对应的 sql 如下

<delete id="delPo" parameterType="java.lang.Integer">
    delete from money where id = #{id,jdbcType=INTEGER}
</delete>

6. 使用演示

上面的 mapper 接口中定义了完整的 CURD，接下来就是使用这个 Mapper 接口来实现交互了，在 Spring 中，使用姿势就非常简单了，直接当一个 Spring Bean 对象注入到 service 类中即可

@Repository
public class MoneyRepository {
    @Autowired
    private MoneyMapper moneyMapper;
    public void testBasic() {
        MoneyPo po = new MoneyPo();
        po.setName("mybatis user");
        po.setMoney((long) random.nextInt(12343));
        po.setIsDeleted(0);
        moneyMapper.savePo(po);
        System.out.println(po);
        MoneyPo out = moneyMapper.findById(po.getId());
        System.out.println("query:" + out);
        moneyMapper.addMoney(po.getId(), 100);
        System.out.println("after update:" + moneyMapper.findById(po.getId()));
        moneyMapper.delPo(po.getId());
        System.out.println("after del:" + moneyMapper.findById(po.getId()));
    }
}

执行输出结果如下

MoneyPo(id=552, name=mybatis user, money=7719, isDeleted=0, createAt=null, updateAt=null)
query:MoneyPo(id=552, name=mybatis user, money=7719, isDeleted=0, createAt=2021-08-01 11:47:23.0, updateAt=2021-08-01 11:47:23.0)
after update:MoneyPo(id=552, name=mybatis user, money=7819, isDeleted=0, createAt=2021-08-01 11:47:23.0, updateAt=2021-08-01 11:47:23.0)
after del:null

7. 小结

相信各位小伙伴看到这里，搭建一个 mybatis 实现数据库的 CURD 的项目应该是问题不大了，本文的主要知识点如下

mybatis 项目的三套件：实体类 + mapper 接口 + xml 文件
数据库的增删改查

其中有一些知识点比较重要，本文只是抛出来了，有兴趣的小伙伴可以持续关注后续更新

下面这些知识点，后面会进行更详细的说明

如何获取插入数据的主键 id
批量场景下的 foreach标签使用
数据库表结构与 java 实体类的映射 resultMap标签
Mapper 接口与 xml 文件的关联方式
Mapper 接口如何被扫描到，并被 Spring bean 对象
Mapper 接口与 xml 的传参方式 @Param注解
sql 参数替换的两种写法 ${}, #{}
传参类型，返回值类型定义
代码复用片段 sql标签

最后

一直想整理出一份完美的面试宝典，但是时间上一直腾不开，这套 一千多道面试题宝典，结合今年金三银四各种大厂面试题，以及 GitHub 上 star 数超 30K+ 的文档整理出来的，我上传以后，毫无意外的短短半个小时点赞量就达到了 13k，说实话还是有点不可思议的。

需要完整版的小伙伴，可以一键三连后，点击这里！

一千道互联网 Java 工程师面试题

内容涵盖：Java、MyBatis、ZooKeeper、Dubbo、Elasticsearch、Memcached、Redis、MySQL、Spring、SpringBoot、SpringCloud、RabbitMQ、Kafka、Linux等技术栈（485页）

《Java核心知识点合集（283页）》

内容涵盖：Java基础、JVM、高并发、多线程、分布式、设计模式、Spring全家桶、Java、MyBatis、ZooKeeper、Dubbo、Elasticsearch、Memcached、MongoDB、Redis、MySQL、RabbitMQ、Kafka、Linux、Netty、Tomcat、数据库、云计算等

《Java中高级核心知识点合集（524页）》

《Java高级架构知识点整理》

由于篇幅限制，详解资料太全面，细节内容太多，所以只把部分知识点截图出来粗略的介绍，每个小节点里面都有更细化的内容!

需要完整版的小伙伴，可以一键三连后，点击这里！

ITPub博客

SpringBoot + Mybatis系列教程之 CURD 基本使用姿势

I. 基础环境搭建

1. SpringBoot 项目配置

2. 数据库准备

II. MyBatis CURD

1. 基本对象

2. 数据插入

2.1 解析说明

2.2 批量插入

3. 数据查询

4. 数据更新

5. 数据删除

6. 使用演示

7. 小结

最后

一千道互联网 Java 工程师面试题

《Java核心知识点合集（283页）》

《Java中高级核心知识点合集（524页）》

《Java高级架构知识点整理》

最新文章