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