SpringBoot整合MybatisPlus的基本應(yīng)用指南
一、MybatisPlus簡介
先來看一下官方的簡介吧。
MyBatis-Plus (簡稱 MP)是一個 MyBatis的增強(qiáng)工具,在 MyBatis 的基礎(chǔ)上只做增強(qiáng)不做改變,為 簡化開發(fā)、提高效率而生。Mybatis-Plus提供了通用的Mapper和Service,可以在不編寫任何SQL語句的前提下,快速的實(shí)現(xiàn)單表的增刪改查(CURD),批量,邏輯刪除,分頁等操作。只要把MyBatis-Plus的特性到優(yōu)秀插件,以及多數(shù)據(jù)源的配置進(jìn)行詳細(xì)講解。
我們的愿景是成為 MyBatis 最好的搭檔,就像魂斗羅中的 1P、2P ,基友搭配,效率翻倍。

MybatisPlus的特性
無侵入:只做增強(qiáng)不做改變,引入它不會對現(xiàn)有工程產(chǎn)生影響,如絲般順滑
損耗?。簡蛹磿詣幼⑷牖?CURD,性能基本無損耗,直接面向?qū)ο蟛僮?/p>
強(qiáng)大的 CRUD 操作:內(nèi)置通用 Mapper、通用 Service,僅僅通過少量配置即可實(shí)現(xiàn)單表大部分 CRUD 操作,更有強(qiáng)大的條件構(gòu)造器,滿足各類使用需求
支持 Lambda 形式調(diào)用:通過 Lambda 表達(dá)式,方便的編寫各類查詢條件,無需再擔(dān)心字段寫錯
支持主鍵自動生成:支持多達(dá) 4 種主鍵策略(內(nèi)含分布式唯一 ID 生成器 - Sequence),可自由配置,完美解決主鍵問題
支持 ActiveRecord 模式:支持 ActiveRecord 形式調(diào)用,實(shí)體類只需繼承 Model 類即可進(jìn)行強(qiáng)大的 CRUD 操作
支持自定義全局通用操作:支持全局通用方法注入( Write once, use anywhere )
內(nèi)置代碼生成器:采用代碼或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 層代碼,支持模板引擎,更有超多自定義配置等您來使用
內(nèi)置分頁插件:基于 MyBatis 物理分頁,開發(fā)者無需關(guān)心具體操作,配置好插件之后,寫分頁等同于普通 List 查詢
分頁插件支持多種數(shù)據(jù)庫:支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多種數(shù)據(jù)庫
內(nèi)置性能分析插件:可輸出 SQL 語句以及其執(zhí)行時間,建議開發(fā)測試時啟用該功能,能快速揪出慢查詢
內(nèi)置全局?jǐn)r截插件:提供全表 delete 、 update 操作智能分析阻斷,也可自定義攔截規(guī)則,預(yù)防誤操作
想要更多的了解MybatisPlus,可以到官網(wǎng)去看一下 MyBatis-Plus (baomidou.com)
我們直接上手講解SpringBoot項目如何整合MybatisPlus。
二、SpringBoot整合MybatisPlus
1、創(chuàng)建數(shù)據(jù)庫和表
CREATE DATABASE `mybatis_plus` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; use `mybatis_plus`; CREATE TABLE `user` ( `id` bigint(20) NOT NULL COMMENT '主鍵ID', `name` varchar(30) DEFAULT NULL COMMENT '姓名 ', `age` int(11) DEFAULT NULL COMMENT '年齡 ', `email` varchar(50) DEFAULT NULL COMMENT '郵箱 ', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
2.添加數(shù)據(jù)
INSERT INTO user (id, name, age, email) VALUES (1, 'Jone', 18, 'test1@baomidou.com'), (2, 'Jack', 20, 'test2@baomidou.com'), (3, 'Tom', 28, 'test3@baomidou.com'), (4, 'Sandy', 21, 'test4@baomidou.com'), (5, 'Billie', 24, 'test5@baomidou.com');
3.創(chuàng)建一個SpringBoot項目
因為我沒有配置阿里的服務(wù)器,所以創(chuàng)建的springboot項目沒有Java8版本,我是后期自己修改的,并且使用springboot2.7.16版本,大家可以配置一下服務(wù)器URL。之后就可以創(chuàng)建8版本了。
https://start.aliyun.com

項目結(jié)構(gòu)。 我把a(bǔ)pplication.properties文件修改為了yml格式。

4.導(dǎo)入依賴
如果想要使用lombok插件需要在設(shè)置中找到插件,下載lombok插件。lombok可以簡化我們的開發(fā)。
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.2</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.5</version>
</dependency>創(chuàng)建我們需要的包。

5.修改application.yml文件
這里的密碼需要根據(jù)你自己的情況修改。
spring:
# 配置數(shù)據(jù)源信息
datasource:
# 配置連接數(shù)據(jù)庫信息
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
username: root
password: 20206.創(chuàng)建實(shí)體User的類
在domain目錄下創(chuàng)建User類。
@Data
public class User {
//設(shè)定id自增
@TableId(type = IdType.AUTO)
private Integer id;
private String name;
private Integer age;
private String email;
}7.添加mapper
在mapper目錄下創(chuàng)建UserMapper。UserMapper繼承BaseMapper,BaseMapper中封裝著一些基本的增刪改查操作,這樣就不用我們在自己寫dao層了。
@Mapper
public interface UserMapper extends BaseMapper<User> {
}三、基本的CRUD操作
我們在test方法中實(shí)現(xiàn)測試。
1.查詢所有用戶
調(diào)用selectList()方法,方法需要傳入一個參數(shù)queryWrapper,queryWrapper相當(dāng)于sql語句中的一些限制條件(這里不必在意我的輸出結(jié)果,數(shù)據(jù)庫的表格我已經(jīng)變動過了,大家只要有輸出即可)。
@Test
void getAllUser(){
List<User> users = userMapper.selectList(null);
for (User user : users) {
System.out.println(user);
}
}
2.插入用戶
這里可能會報錯,提示id不存在,我們要把數(shù)據(jù)庫當(dāng)中的id字段改為自動遞增。
@Test
public void testInsert(){
User user = new User(null, "哈__", 23, "ha@test.com");
//INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
int result = userMapper.insert(user);
System.out.println("受影響行數(shù):"+result);
System.out.println("id自動獲?。?+user.getId());
}
3.刪除用戶
@Test
public void testDeleteById(){
//通過id刪除用戶信息
//DELETE FROM user WHERE id=?
int result = userMapper.deleteById(9);
System.out.println("受影響行數(shù):"+result);
}
4.更新用戶
根據(jù)傳入的user的id更新,如果user中的某些字段為null,那么mybatisplus不會把值為null的屬性向數(shù)據(jù)庫進(jìn)行更新。
@Test
public void testUpdateById(){
User user = new User(1, "admin", 22, null);
//UPDATE user SET name=?, age=? WHERE id=?
int result = userMapper.updateById(user);
System.out.println("受影響行數(shù):"+result);
}5.添加MybatisPlus日志
在application.yml文件當(dāng)中寫入如下配置。
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl看效果。

四、service封裝mapper
在service包下創(chuàng)建IUserService接口。并創(chuàng)建impl包,在service.impl包下創(chuàng)建UserServiceImpl。
public interface IUserService extends IService<User> {
}@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService{
}通過service調(diào)用mapper。MybatisPlus官方已經(jīng)幫我們封裝好了。
1.查詢所有用戶
@Resource
UserServiceImpl userService;
@Test
void getAllUser(){
List<User> users = userService.list();
for (User user : users) {
System.out.println(user);
}
}
其他的就不在展示了,大家可以自己探索一下。
五、BaseMapper常用方法
package com.baomidou.mybatisplus.core.mapper;
public interface BaseMapper<T> extends Mapper<T> {
/**
* 插入一條記錄
* @param entity 實(shí)體對象 */
int insert(T entity);
/**
* 根據(jù) ID 刪除
* @param id 主鍵ID */
int deleteById(Serializable id);
/**
* 根據(jù)實(shí)體(ID)刪除
* @param entity 實(shí)體對象
* @since 3.4.4 */
int deleteById(T entity);
/**
* 根據(jù) columnMap 條件,刪除記錄
* @param columnMap 表字段 map 對象 */
int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
/**
* 根據(jù) entity 條件,刪除記錄
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null,里面的 entity 用于生成 where
語句)
*/
int delete(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 刪除(根據(jù)ID 批量刪除)
* @param idList 主鍵ID列表(不能為 null 以及 empty) */
int deleteBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);
/**
* 根據(jù) ID 修改
* @param entity 實(shí)體對象 */
int updateById(@Param(Constants.ENTITY) T entity);
/**
* 根據(jù) whereEntity 條件,更新記錄
* @param entity 實(shí)體對象 (set 條件值 ,可以為 null)
* @param updateWrapper 實(shí)體對象封裝操作類(可以為 null,里面的 entity 用于生成
where 語句)
*/
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);
/**
* 根據(jù) ID 查詢
* @param id 主鍵ID */
T selectById(Serializable id);
/**
* 查詢(根據(jù)ID 批量查詢)
* @param idList 主鍵ID列表(不能為 null 以及 empty) */
List<T> selectBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);
/**
* 查詢(根據(jù) columnMap 條件)
* @param columnMap 表字段 map 對象 */
List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
/**
* 根據(jù) entity 條件,查詢一條記錄
* <p>查詢一條記錄,例如 qw.last("limit 1") 限制取一條記錄 , 注意:多條數(shù)據(jù)會報異常 </p>
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null)
*/
default T selectOne(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper) { List<T> ts = this.selectList(queryWrapper);
if (CollectionUtils.isNotEmpty(ts)) {
if (ts.size() != 1) {
throw ExceptionUtils.mpe("One record is expected, but the query result is multiple records");
}
return ts.get(0);
}
return null;
}
/**
* 根據(jù) Wrapper 條件,查詢總記錄數(shù)
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null) */
Long selectCount(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根據(jù) entity 條件,查詢?nèi)坑涗?
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null) */
List<T> selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根據(jù) Wrapper 條件,查詢?nèi)坑涗?
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null) */
List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根據(jù) Wrapper 條件,查詢?nèi)坑涗?
* <p>注意: 只返回第一個字段的值</p>
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null) */
List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根據(jù) entity 條件,查詢?nèi)坑涗洠ú⒎摚?
* @param page 分頁查詢條件(可以為 RowBounds.DEFAULT)
* @param queryWrapper 實(shí)體對象封裝操作類(可以為 null) */
<P extends IPage<T>> P selectPage(P page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
/**
* 根據(jù) Wrapper 條件,查詢?nèi)坑涗洠ú⒎摚?
* @param page 分頁查詢條件
* @param queryWrapper 實(shí)體對象封裝操作類 */
<P extends IPage<Map<String, Object>>> P selectMapsPage(P page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);以上就是SpringBoot整合MybatisPlus的基本應(yīng)用指南的詳細(xì)內(nèi)容,更多關(guān)于SpringBoot整合MybatisPlus的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
java實(shí)現(xiàn)將結(jié)果集封裝到List中的方法
這篇文章主要介紹了java實(shí)現(xiàn)將結(jié)果集封裝到List中的方法,涉及java數(shù)據(jù)庫查詢及結(jié)果集轉(zhuǎn)換的相關(guān)技巧,具有一定參考借鑒價值,需要的朋友可以參考下2016-07-07
Spring?AI集成DeepSeek實(shí)現(xiàn)流式輸出的操作方法
本文介紹了如何在SpringBoot中使用Sse(Server-SentEvents)技術(shù)實(shí)現(xiàn)流式輸出,后端使用SpringMVC中的SseEmitter對象,前端使用EventSource對象監(jiān)聽SSE接口并展示數(shù)據(jù)流,通過這種方式可以提升用戶體驗,避免大模型響應(yīng)速度慢的問題,感興趣的朋友一起看看吧2025-03-03
Java如何接收并解析HL7協(xié)議數(shù)據(jù)
文章主要介紹了HL7協(xié)議及其在醫(yī)療行業(yè)中的應(yīng)用,詳細(xì)描述了如何配置環(huán)境、接收和解析數(shù)據(jù),以及與前端進(jìn)行交互的實(shí)現(xiàn)方法,文章還分享了使用7Edit工具進(jìn)行調(diào)試的經(jīng)驗,并記錄了一個常見的解析問題及其解決方法2024-12-12
基于Java文件輸入輸出流實(shí)現(xiàn)文件上傳下載功能
這篇文章主要為大家詳細(xì)介紹了基于Java文件輸入輸出流實(shí)現(xiàn)文件上傳下載功能,具有一定的參考價值,感興趣的小伙伴們可以參考一下2018-04-04

