SpringBoot3整合Mybatis plus

Java版本：17
Spring Boot版本：3.1.10
Mybatis plus版本：3.5.5
源码地址：Gitee仓库

01 创建我们的项目工程

首先，我们创建一个maven工程spring-boot3-demo，pom文件配置如下。

• 这里我们将spring-boot-starter-parent作为我们的父pom
• 我们引入了Lombok依赖，用于简化我们的代码

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.10</version>
    </parent>

    <groupId>com.knowz.demo</groupId>
    <artifactId>spring-boot3-demo</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <modules>
        <module>mybatis-plus-demo</module>
    </modules>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>
</project>

02 创建一个module，用于整合Mybatis plus

首先，配置我们的pom文件，引入我们需要的依赖。
这里我们主要引入了web依赖、MySQL链接依赖和Mybatis plus依赖。
web依赖和MySQL链接的依赖版本号都继承自spring-boot-starter-parent管理的版本号

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.knowz.demo</groupId>
        <artifactId>spring-boot3-demo</artifactId>
        <version>1.0.0</version>
    </parent>

    <artifactId>mybatis-plus-demo</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.5</version>
        </dependency>

        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
        </dependency>
    </dependencies>
</project>

03 接下来是对我们的项目进行一些配置

主要是需要配置我们的数据库链接、Mybatis plus的一些配置

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 这是我本地的虚拟机的ip，大家改为自己数据库ip即可
spring.datasource.url=jdbc:mysql://172.16.81.100:3306/spring_boot3_demo?useUnicode=true&characterEncoding=UTF-8
spring.datasource.username=root
# 记得修改自己数据库的用户名和密码
spring.datasource.password=qwe123

# 当我们数据库表的主键是自增id时，配置为AUTO即可
mybatis-plus.global-config.db-config.id-type=AUTO
# 打印SQL日志，这里有2种配置，任选其一即可，后面我会演示其效果
#mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl
logging.level.com.knowz.demo.mybatisplus.mapper=debug

04 开始使用Mybatis plus

4.1 创建我们的数据库表

我们首先创建一张用户表，SQL脚本如下：

CREATE TABLE `t_user` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
  `name` varchar(10) NOT NULL COMMENT '姓名',
  `age` smallint DEFAULT NULL COMMENT '年龄',
  `status` tinyint DEFAULT NULL COMMENT '状态',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='用户表';

4.2 编写我们的Java代码

• 创建我们的实体类

package com.knowz.demo.mybatisplus.model;

import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("t_user")
public class User {
    private Long id;
    private String name;
    private Integer age;
    private Integer status;
}

• 编写mapper层代码

package com.knowz.demo.mybatisplus.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.knowz.demo.mybatisplus.model.User;

public interface UserMapper extends BaseMapper<User> {
}

• 编写service层代码，这里我们继承了ServiceImpl，它给我们提供了很多常用的方法

package com.knowz.demo.mybatisplus.service;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.knowz.demo.mybatisplus.mapper.UserMapper;
import com.knowz.demo.mybatisplus.model.User;
import org.springframework.stereotype.Service;

@Service
public class UserService extends ServiceImpl<UserMapper, User> {
}

• 编写controller层代码

package com.knowz.demo.mybatisplus.controller;

import com.knowz.demo.mybatisplus.model.User;
import com.knowz.demo.mybatisplus.service.UserService;
import jakarta.annotation.Resource;
import jakarta.websocket.server.PathParam;
import org.springframework.web.bind.annotation.*;

import java.util.List;

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

    @GetMapping("list")
    public List<User> list() {
        return userService.list();
    }

    @PostMapping("save")
    public boolean save(@RequestBody User user) {
        return userService.save(user);
    }

    @GetMapping("{id}")
    public User getById(@PathVariable("id") Long id) {
        return userService.getById(id);
    }
}

4.3 最后，启动我们的main方法

我们在main方法有个@MapperScan注解，配置我们的mapper类路径后，Spring Boot 会帮我们生成bean放到IOC容器中，这样我们就不用每个mapper类写一个@Mapper注解了。

@MapperScan("com.knowz.demo.mybatisplus.mapper")
@SpringBootApplication
public class MybatisPlusApplication {
    public static void main(String[] args) {
        SpringApplication.run(MybatisPlusApplication.class, args);
    }
}

启动成功后，调用我们的接口localhost:8080/users/3，就能够获取数据了。
我们使用postman调用截图如下：

当我们在application.properties文件配置了打印SQL日志时的效果：

2024-04-13T16:31:55.337+08:00 DEBUG 88356 --- [nio-8080-exec-3] c.k.d.m.mapper.UserMapper.selectById     : ==>  Preparing: SELECT id,name,age,status FROM t_user WHERE id=?
2024-04-13T16:31:55.338+08:00 DEBUG 88356 --- [nio-8080-exec-3] c.k.d.m.mapper.UserMapper.selectById     : ==> Parameters: 3(Long)
2024-04-13T16:31:55.339+08:00 DEBUG 88356 --- [nio-8080-exec-3] c.k.d.m.mapper.UserMapper.selectById     : <==      Total: 1