BaseMapper 丨Mybatis Plus BaseMapper使用手册

引导类中添加 @MapperScan 注解，扫描 Mapper 文件夹

@SpringBootApplication
@MapperScan("")
public class MPApplication {

    public static void main(String[] args) {
        (, args);
    }

}

建立实体类

自行建立一个实体，可以是最简单的学生，姓名，班级，学号

建立Mapper层

继承BaseMapper，后面的实体写自己的实体

@Mapper
public interface UserMapper extends BaseMapper<UserEntity>{

}

Mapper Interface接口内容说明

BaseMapper 是 Mybatis-Plus 提供的一个通用 Mapper 接口，它封装了一系列常用的数据库操作方法，包括增、删、改、查等。通过继承 BaseMapper，开发者可以快速地对数据库进行操作，而无需编写繁琐的 SQL 语句。

提示

泛型 T 为任意实体对象

参数 Serializable 为任意类型主键 Mybatis-Plus 不推荐使用复合主键约定每一张表都有自己的唯一 id 主键

对象 Wrapper 为条件构造器

插入操作insert

// 插入一条记录
int insert(T entity);

功能描述： 插入一条记录。
返回值： int，表示插入操作影响的行数，通常为 1，表示插入成功。
参数说明：

类型	参数名	描述
T	entity	实体对象

示例：

User user = new User();
("John Doe");
("@");
int rows = (user); // 调用 insert 方法
if (rows > 0) {
    ("User inserted successfully.");
} else {
    ("Failed to insert user.");
}

生成的 SQL:

INSERT INTO user (name, email) VALUES (?, ?)

通过上述示例，我们可以看到 insert 方法是如何在 Mapper 层进行插入操作的，以及它对应的 SQL 语句。这个方法简化了插入操作的实现，使得开发者无需手动编写 SQL 语句。

删除操作delete

// 根据 entity 条件，删除记录
int delete(@Param() Wrapper<T> wrapper);
// 删除（根据ID 批量删除）
int deleteBatchIds(@Param() Collection<? extends Serializable> idList);
// 根据 ID 删除
int deleteById(Serializable id);
// 根据 columnMap 条件，删除记录
int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);

功能描述： 删除符合条件的记录。
返回值： int，表示删除操作影响的行数，通常为 1，表示删除成功。
参数说明：

类型	参数名	描述
Wrapper<T>	wrapper	实体对象封装操作类（可以为 null）
Collection<? extends Serializable>	idList	主键 ID 列表(不能为 null 以及 empty)
Serializable	id	主键 ID
Map<String, Object>	columnMap	表字段 map 对象

示例：

对象删除

// 假设有一个 QueryWrapper 对象，设置查询条件为 age > 25，删除满足条件的用户
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
("age", 25);
int rows = (queryWrapper); // 调用 delete 方法
if (rows > 0) {
    ("Users deleted successfully.");
} else {
    ("No users deleted.");
}

生成的SQL：

DELETE FROM user WHERE age > 25

根据ID删除：

// 根据 ID 删除单个用户
int userId = 1;
int rows = (userId); // 调用 deleteById 方法
if (rows > 0) {
    ("User deleted successfully.");
} else {
    ("No user deleted.");
}

生成SQL：

DELETE FROM user WHERE id = 1

批量删除：

// 假设有一组 ID 列表，批量删除用户
List<Integer> ids = (1, 2, 3);
int rows = (ids); // 调用 deleteBatchIds 方法
if (rows > 0) {
    ("Users deleted successfully.");
} else {
    ("No users deleted.");
}

生成的SQL：

DELETE FROM user WHERE id IN (1, 2, 3)

通过上述示例，我们可以看到 delete 系列方法是如何在 Mapper 层进行删除操作的，以及它们对应的 SQL 语句。这些方法提供了灵活的数据删除方式，可以根据不同的条件进行删除操作。

更新操作update

// 根据 whereWrapper 条件，更新记录
int update(@Param() T updateEntity, @Param() Wrapper<T> whereWrapper);
// 根据 ID 修改
int updateById(@Param() T entity);

功能描述： 更新符合条件的记录。
返回值： int，表示更新操作影响的行数，通常为 1，表示更新成功。
参数说明：

类型	参数名	描述
T	entity	实体对象 (set 条件值,可为 null)
Wrapper<T>	updateWrapper	实体对象封装操作类（可以为 null,里面的 entity 用于生成 where 语句）

示例

根据对象进行更新

// 假设有一个 UpdateWrapper 对象，设置查询条件为 age > 25，更新满足条件的用户的邮箱
UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
("age", 25);
User updateUser = new User();
("@");
int rows = (updateUser, updateWrapper); // 调用 update 方法
if (rows > 0) {
    ("Users updated successfully.");
} else {
    ("No users updated.");
}

生成的SQL：

UPDATE user SET email = ? WHERE age > 25

根据ID进行更新:

// 假设要更新 ID 为 1 的用户的邮箱
User updateUser = new User();
(1);
("@");
int rows = (updateUser); // 调用 updateById 方法
if (rows > 0) {
    ("User updated successfully.");
} else {
    ("No user updated.");
}

生成的SQL：

UPDATE user SET email = ? WHERE id = 1

通过上述示例，我们可以看到 update 系列方法是如何在 Mapper 层进行更新操作的，以及它们对应的 SQL 语句。这些方法提供了灵活的数据更新方式，可以根据不同的条件进行更新操作。

查询操作select

// 根据 ID 查询
T selectById(Serializable id);
// 根据 entity 条件，查询一条记录
T selectOne(@Param() Wrapper<T> queryWrapper);

// 查询（根据ID 批量查询）
List<T> selectBatchIds(@Param() Collection<? extends Serializable> idList);
// 根据 entity 条件，查询全部记录
List<T> selectList(@Param() Wrapper<T> queryWrapper);
// 查询（根据 columnMap 条件）
List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
// 根据 Wrapper 条件，查询全部记录
List<Map<String, Object>> selectMaps(@Param() Wrapper<T> queryWrapper);
// 根据 Wrapper 条件，查询全部记录。注意： 只返回第一个字段的值
List<Object> selectObjs(@Param() Wrapper<T> queryWrapper);

// 根据 entity 条件，查询全部记录（并翻页）
IPage<T> selectPage(IPage<T> page, @Param() Wrapper<T> queryWrapper);
// 根据 Wrapper 条件，查询全部记录（并翻页）
IPage<Map<String, Object>> selectMapsPage(IPage<T> page, @Param() Wrapper<T> queryWrapper);
// 根据 Wrapper 条件，查询总记录数
Integer selectCount(@Param() Wrapper<T> queryWrapper);

功能描述： 查询符合条件的记录。
返回值： 查询结果，可能是实体对象、Map 对象或其他类型。
参数说明：

类型	参数名	描述
Serializable	id	主键 ID
Wrapper<T>	queryWrapper	实体对象封装操作类（可以为 null）
Collection<? extends Serializable>	idList	主键 ID 列表(不能为 null 以及 empty)
Map<String, Object>	columnMap	表字段 map 对象
IPage<T>	page	分页查询条件（可以为）

根据ID进行查询

// 根据 ID 查询单个用户
int userId = 1;
User user = (userId); // 调用 selectById 方法
("User: " + user);

生成的SQL：

SELECT * FROM user WHERE id = 1

根据对象进行查询

// 假设有一个 QueryWrapper 对象，设置查询条件为 age > 25，查询一条满足条件的用户
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
("age", 25);
User user = (queryWrapper); // 调用 selectOne 方法
("User: " + user);

生成的SQL：

SELECT * FROM user WHERE age > 25

批量查询

// 假设有一组 ID 列表，批量查询用户
List<Integer> ids = (1, 2, 3);
List<User> users = (ids); // 调用 selectBatchIds 方法
for (User u : users) {
    ("User: " + u);
}

生成的SQL：

SELECT * FROM user WHERE id IN (1, 2, 3)

分页查询：

// 假设要进行分页查询，每页显示10条记录，查询第1页，查询条件为 age > 25
IPage<User> page = new Page<>(1, 10);
QueryWrapper<User> queryWrapper = new QueryWrapper<>();
("age", 25);
IPage<User> userPage = (page, queryWrapper); // 调用 selectPage 方法
List<User> userList = ();
long total = ();
("Total users (age > 25): " + total);
for (User user : userList) {
    ("User: " + user);
}

生成的SQL：

SELECT * FROM user WHERE age > 25 LIMIT 10 OFFSET 0

选装件说明

alwaysUpdateSomeColumnById

int alwaysUpdateSomeColumnById(T entity);

源码：alwaysUpdateSomeColumnById
功能：这个方法用于在更新操作时，无论实体对象的某些字段是否有变化，都会强制更新这些字段。这在某些业务场景下非常有用，比如更新时间戳字段，确保每次更新操作都会更新该字段。
使用场景：当你需要在每次更新记录时，都更新某些特定的字段（如更新时间、版本号等），即使这些字段在实体对象中没有变化。

insertBatchSomeColumn

int insertBatchSomeColumn(List<T> entityList);

源码：insertBatchSomeColumn
功能：这个方法用于批量插入实体对象，但只插入实体对象中指定的某些字段。这在需要批量插入数据，但又不希望插入所有字段时非常有用。
使用场景：当你需要批量插入数据，并且希望只插入实体对象中的部分字段，以提高插入效率或保护敏感数据。

logicDeleteByIdWithFill

int logicDeleteByIdWithFill(T entity);

源码：logicDeleteByIdWithFill
功能：这个方法用于逻辑删除记录，并填充实体对象中的某些字段。逻辑删除意味着不是真正从数据库中删除记录，而是通过更新某个字段（如 deleted 字段）来标记记录已被删除。
使用场景：当你需要实现逻辑删除功能，并且希望在删除操作时自动填充实体对象中的某些字段（如删除时间、删除人等）。

使用提示

在使用这些选装件之前，确保你的项目中已经正确配置了 Sql 注入器。
这些方法通常需要在 Mapper 接口中显式声明，以便 Mybatis-Plus 能够识别并生成相应的 SQL 语句。
每个选装件都有其特定的使用场景，根据业务需求选择合适的方法。
在实际使用中，可能需要结合实体对象的注解（如 @TableField、@TableLogic 等）来实现更复杂的功能。

通过使用这些选装件，可以进一步扩展 Mybatis-Plus 的功能，满足更多样化的业务需求。

Chain

Chain 是 Mybatis-Plus 提供的一种链式编程风格，它允许开发者以更加简洁和直观的方式编写数据库操作代码。Chain 分为 query 和 update 两大类，分别用于查询和更新操作。每类又分为普通链式和 lambda 链式两种风格，其中 lambda 链式提供了类型安全的查询条件构造，但不支持 Kotlin。

使用步骤

query

提供链式查询操作，可以连续调用方法来构建查询条件。

// 链式查询 普通

QueryChainWrapper<T> query();

// 链式查询 lambda 式。注意：不支持 Kotlin

LambdaQueryChainWrapper<T> lambdaQuery();

示例:

// 普通链式查询示例

query().eq("name", "John").list(); // 查询 name 为 "John" 的所有记录

// lambda 链式查询示例

lambdaQuery().eq(User::getAge, 30).one(); // 查询年龄为 30 的单条记录

update

提供链式更新操作，可以连续调用方法来构建更新条件。

// 链式更改 普通

UpdateChainWrapper<T> update();

// 链式更改 lambda 式。注意：不支持 Kotlin

LambdaUpdateChainWrapper<T> lambdaUpdate();

示例:


// 普通链式更新示例

update().set("status", "inactive").eq("name", "John").update(); // 将 name 为 "John" 的记录 status 更新为 "inactive"

// lambda 链式更新示例

User updateUser = new User();

("@");

lambdaUpdate().set(User::getEmail, ()).eq(User::getId, 1).update(); // 更新 ID 为 1 的用户的邮箱

使用提示

链式操作通过返回 QueryChainWrapper 或 UpdateChainWrapper 的实例，允许开发者连续调用方法来构建查询或更新条件。
lambda 链式操作提供了类型安全的查询条件构造，通过方法引用 Entity::getId 等方式，避免了字符串硬编码，提高了代码的可读性和安全性。
在使用链式操作时，注意链式方法的调用顺序，通常是先设置条件，然后执行查询或更新操作。
链式操作支持多种条件构造方法，如 eq、ne、gt、lt、like 等，可以根据实际需求选择合适的方法。
链式操作返回的结果可以是单条记录、多条记录、总记录数等，具体取决于最后调用的方法。

通过使用 Chain，开发者可以更加高效地编写数据库操作代码，同时保持代码的清晰和可维护性。

ActiveRecord

ActiveRecord 模式是一种设计模式，它允许实体类直接与数据库进行交互，实体类既是领域模型又是数据访问对象。在 Mybatis-Plus 中，实体类只需继承 Model 类即可获得强大的 CRUD 操作能力。

注意

使用 ActiveRecord 模式前，需要确保项目中已注入对应实体的 BaseMapper。

使用步骤

继承 Model 类

import ;

public class User extends Model<User> {

// 实体类的字段定义...

private Long id;

private String name;

private Integer age;

// ... 其他字段和 getter/setter 方法

}

调用 CRUD 方法

// 创建新用户并插入数据库

User user = new User();

("John Doe");

(30);

boolean isInserted = (); // 返回值表示操作是否成功

// 查询所有用户

List<User> allUsers = ();

// 根据 ID 更新用户信息

(1L);

("Updated Name");

boolean isUpdated = (); // 返回值表示操作是否成功

// 根据 ID 删除用户

boolean isDeleted = (); // 返回值表示操作是否成功

使用提示

在 ActiveRecord 模式下，实体类可以直接调用 insert、selectAll、updateById、deleteById 等方法进行数据库操作。
实体类继承 Model 类后，会自动获得一系列数据库操作方法，无需手动编写 SQL 语句。
实体类中的字段需要与数据库表中的列对应，通常通过注解（如 @TableField、@TableId 等）来指定字段与列的映射关系。
在进行更新或删除操作时，通常需要先查询出实体对象，然后修改其属性，最后调用更新或删除方法。
插入和更新操作通常会返回一个布尔值，表示操作是否成功。
查询操作会返回相应的查询结果，如单个实体对象或实体对象列表。

通过使用 ActiveRecord 模式，开发者可以更加简洁地编写数据库操作代码，同时保持代码的清晰和可维护性。这种模式尤其适合于简单的 CRUD 操作，可以大大减少重复代码的编写。

SimpleQuery

SimpleQuery 是 Mybatis-Plus 提供的一个工具类，它对 selectList 查询后的结果进行了封装，使其可以通过 Stream 流的方式进行处理，从而简化了 API 的调用。

SimpleQuery 的一个特点是它的 peeks 参数，这是一个可变参数，类型为 Consumer...，意味着你可以连续添加多个操作，这些操作会在查询结果被处理时依次执行。

SimpleQuery 的使用方式可以参考官方测试用例。

注意

使用 SimpleQuery 前，需要确保项目中已注入对应实体的 BaseMapper。

使用步骤

引入 SimpleQuery 工具类

import ;

import ;

import ;

使用 SimpleQuery 进行查询

// 假设有一个 User 实体类和对应的 BaseMapper

List<Long> ids = (

(), // 使用 lambda 查询构建器

User::getId, // 提取的字段，这里是 User 的 id

::println, // 第一个 peek 操作，打印每个用户的 id

user -> (()) // 第二个 peek 操作，将每个用户的名字添加到 userNames 列表中

);

使用提示

SimpleQuery 工具类提供了一种简洁的方式来处理查询结果，它允许你在查询结果上应用多个操作，这些操作会按照添加的顺序依次执行。
在使用 SimpleQuery 时，你需要提供一个查询构建器（如 ()），一个用于提取结果的字段（如 User::getId），以及一个或多个 Consumer 类型的 peek 操作。
peek 操作可以用于执行任何副作用操作，如打印日志、更新缓存、发送通知等，而不会影响查询结果本身。
SimpleQuery 返回的结果是一个列表，包含了所有查询到的实体对象，这些对象已经应用了所有的 peek 操作。
通过使用 SimpleQuery，你可以将查询和结果处理逻辑分离，使代码更加清晰和易于维护。

通过使用 SimpleQuery 工具类，开发者可以更加高效地处理查询结果，同时保持代码的简洁性和可读性。这种工具类尤其适合于需要对查询结果进行复杂处理的场景。

功能详解

keyMap

SimpleQuery 的 keyMap 方法提供了一种便捷的方式来查询数据库，并将查询结果封装成一个 Map，其中实体的某个属性作为键（key），实体本身作为值（value）。这个方法还支持在处理查询结果时执行额外的副作用操作，如打印日志或更新缓存。

方法签名

// 查询表内记录，封装返回为 Map<属性,实体>

Map<A, E> keyMap(LambdaQueryWrapper<E> wrapper, SFunction<E, A> sFunction, Consumer<E>... peeks);

// 查询表内记录，封装返回为 Map<属性,实体>，考虑了并行流的情况

Map<A, E> keyMap(LambdaQueryWrapper<E> wrapper, SFunction<E, A> sFunction, boolean isParallel, Consumer<E>... peeks);

参数说明

类型	参数名	描述
E	entity	实体对象类型，即查询结果的实体类型。
A	attribute	实体属性类型，也是返回的 `Map` 中键（key）的类型。
LambdaQueryWrapper<E>	wrapper	支持 lambda 表达式的条件构造器，用于构建查询条件。
SFunction<E, A>	sFunction	实体中属性的 getter 方法引用，用于确定 `Map` 中键（key）的值。
boolean	isParallel	如果设置为 `true`，则底层使用并行流执行查询，可以提高处理大量数据时的效率。
Consumer<E>…	peeks	可变参数，用于指定在处理查询结果时执行的额外操作，如打印日志、更新缓存等。

使用示例

// 假设有一个 User 实体类和对应的 BaseMapper

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();

(User::getStatus, "active"); // 查询状态为 "active" 的用户

// 使用 keyMap 方法查询并封装结果

Map<String, User> userMap = (

queryWrapper, // 查询条件构造器

User::getUsername, // 使用用户名作为键

user -> ("Processing user: " + ()) // 打印处理的用户名

);

// 遍历结果

for (<String, User> entry : ()) {

("Key: " + () + ", Value: " + ());

}

使用提示

keyMap 方法适用于需要根据实体的某个属性快速查找实体的场景。
通过 sFunction 参数，你可以指定任何实体属性作为 Map 的键，这使得查询结果的访问更加直观和高效。
peeks 参数允许你在处理查询结果时执行额外的副作用操作，这些操作不会影响最终的 Map 结果。
当处理大量数据时，可以考虑将 isParallel 参数设置为 true 以启用并行流，从而提高查询效率。

通过使用 SimpleQuery 的 keyMap 方法，开发者可以更加高效地处理查询结果，并将其封装成易于使用的数据结构，同时还可以执行额外的副作用操作，使代码更加简洁和灵活。

map

SimpleQuery 的 map 方法提供了一种便捷的方式来查询数据库，并将查询结果封装成一个 Map，其中实体的某个属性作为键（key），另一个属性作为值（value）。这个方法还支持在处理查询结果时执行额外的副作用操作，如打印日志或更新缓存。

方法签名

// 查询表内记录，封装返回为 Map<属性,属性>

Map<A, P> map(LambdaQueryWrapper<E> wrapper, SFunction<E, A> keyFunc, SFunction<E, P> valueFunc, Consumer<E>... peeks);

// 查询表内记录，封装返回为 Map<属性,属性>，考虑了并行流的情况

Map<A, P> map(LambdaQueryWrapper<E> wrapper, SFunction<E, A> keyFunc, SFunction<E, P> valueFunc, boolean isParallel, Consumer<E>... peeks);

参数说明

类型	参数名	描述
E	entity	实体对象类型，即查询结果的实体类型。
A	attribute	实体属性类型，作为返回的 `Map` 中键（key）的类型。
P	attribute	实体属性类型，作为返回的 `Map` 中值（value）的类型。
LambdaQueryWrapper<E>	wrapper	支持 lambda 表达式的条件构造器，用于构建查询条件。
SFunction<E, A>	keyFunc	实体中属性的 getter 方法引用，用于确定 `Map` 中键（key）的值。
SFunction<E, P>	valueFunc	实体中属性的 getter 方法引用，用于确定 `Map` 中值（value）的值。
boolean	isParallel	如果设置为 `true`，则底层使用并行流执行查询，可以提高处理大量数据时的效率。
Consumer<E>…	peeks	可变参数，用于指定在处理查询结果时执行的额外操作，如打印日志、更新缓存等。

使用示例

// 假设有一个 User 实体类和对应的 BaseMapper

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();

(User::getStatus, "active"); // 查询状态为 "active" 的用户

// 使用 map 方法查询并封装结果

Map<String, Integer> userMap = (

queryWrapper, // 查询条件构造器

User::getUsername, // 使用用户名作为键

User::getAge, // 使用年龄作为值

user -> ("Processing user: " + ()) // 打印处理的用户名

);

// 遍历结果

for (<String, Integer> entry : ()) {

("Username: " + () + ", Age: " + ());

}

使用提示

map 方法适用于需要根据实体的某个属性快速查找另一个属性的场景。
通过 keyFunc 和 valueFunc 参数，你可以指定任何实体属性作为 Map 的键和值，这使得查询结果的访问更加直观和高效。
peeks 参数允许你在处理查询结果时执行额外的副作用操作，这些操作不会影响最终的 Map 结果。
当处理大量数据时，可以考虑将 isParallel 参数设置为 true 以启用并行流，从而提高查询效率。

通过使用 SimpleQuery 的 map 方法，开发者可以更加高效地处理查询结果，并将其封装成易于使用的数据结构，同时还可以执行额外的副作用操作，使代码更加简洁和灵活。

group

SimpleQuery 的 group 方法提供了一种便捷的方式来查询数据库，并将查询结果按照实体的某个属性进行分组，封装成一个 Map。这个方法还支持在处理查询结果时执行额外的副作用操作，如打印日志或更新缓存。此外，它还允许你使用 Collector 对分组后的集合进行进一步的处理。

方法签名


// 查询表内记录，封装返回为 Map<属性,List<实体>>

Map<K, List<T>> group(LambdaQueryWrapper<T> wrapper, SFunction<T, K> sFunction, Consumer<T>... peeks);

// 查询表内记录，封装返回为 Map<属性,List<实体>>，考虑了并行流的情况

Map<K, List<T>> group(LambdaQueryWrapper<T> wrapper, SFunction<T, K> sFunction, boolean isParallel, Consumer<T>... peeks);

// 查询表内记录，封装返回为 Map<属性,分组后对集合进行的下游收集器>

M group(LambdaQueryWrapper<T> wrapper, SFunction<T, K> sFunction, Collector<? super T, A, D> downstream, Consumer<T>... peeks);

// 查询表内记录，封装返回为 Map<属性,分组后对集合进行的下游收集器>，考虑了并行流的情况

M group(LambdaQueryWrapper<T> wrapper, SFunction<T, K> sFunction, Collector<? super T, A, D> downstream, boolean isParallel, Consumer<T>... peeks);

参数说明

类型	参数名	描述
T	entity	实体对象类型，即查询结果的实体类型。
K	attribute	实体属性类型，作为返回的 `Map` 中键（key）的类型。
D	-	下游收集器返回类型，作为 `Map` 中值（value）的类型。
A	-	下游操作中间类型，用于 `Collector` 的中间结果。
M	-	最终结束返回的 `Map<K, D>` 类型。
LambdaQueryWrapper<T>	wrapper	支持 lambda 表达式的条件构造器，用于构建查询条件。
SFunction<T, K>	sFunction	分组依据，实体中属性的 getter 方法引用，用于确定 `Map` 中键（key）的值。
Collector<T, A, D>	downstream	下游收集器，用于对分组后的集合进行进一步的处理。
boolean	isParallel	如果设置为 `true`，则底层使用并行流执行查询，可以提高处理大量数据时的效率。
Consumer<T>…	peeks	可变参数，用于指定在处理查询结果时执行的额外操作，如打印日志、更新缓存等。

使用示例

// 假设有一个 User 实体类和对应的 BaseMapper

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();

(User::getStatus, "active"); // 查询状态为 "active" 的用户

// 使用 group 方法查询并封装结果，按照用户名分组

Map<String, List<User>> userGroup = (

queryWrapper, // 查询条件构造器

User::getUsername, // 使用用户名作为分组键

user -> ("Processing user: " + ()) // 打印处理的用户名

);

// 遍历结果

for (<String, List<User>> entry : ()) {

("Username: " + ());

for (User user : ()) {

(" - User: " + user);

}

}

使用提示

group 方法适用于需要根据实体的某个属性对查询结果进行分组的场景。
通过 sFunction 参数，你可以指定任何实体属性作为分组的依据，这使得查询结果的组织更加灵活。
downstream 参数允许你使用 Collector 对分组后的集合进行进一步的处理，如计数、求和、平均值等。
peeks 参数允许你在处理查询结果时执行额外的副作用操作，这些操作不会影响最终的 Map 结果。
当处理大量数据时，可以考虑将 isParallel 参数设置为 true 以启用并行流，从而提高查询效率。

通过使用 SimpleQuery 的 group 方法，开发者可以更加高效地处理查询结果，并将其按照特定属性进行分组，同时还可以执行额外的副作用操作，使代码更加简洁和灵活。

list

SimpleQuery 的 list 方法提供了一种便捷的方式来查询数据库，并将查询结果封装成一个 List，其中列表的元素是实体的某个属性。这个方法还支持在处理查询结果时执行额外的副作用操作，如打印日志或更新缓存。

方法签名

// 查询表内记录，封装返回为 List<属性>

List<A> list(LambdaQueryWrapper<E> wrapper, SFunction<E, A> sFunction, Consumer<E>... peeks);

// 查询表内记录，封装返回为 List<属性>，考虑了并行流的情况

List<A> list(LambdaQueryWrapper<E> wrapper, SFunction<E, A> sFunction, boolean isParallel, Consumer<E>... peeks);

参数说明

类型	参数名	描述
E	entity	实体对象类型，即查询结果的实体类型。
A	attribute	实体属性类型，作为返回的 `List` 中元素的类型。
LambdaQueryWrapper<E>	wrapper	支持 lambda 表达式的条件构造器，用于构建查询条件。
SFunction<E, A>	sFunction	实体中属性的 getter 方法引用，用于确定 `List` 中元素的值。
boolean	isParallel	如果设置为 `true`，则底层使用并行流执行查询，可以提高处理大量数据时的效率。
Consumer<E>…	peeks	可变参数，用于指定在处理查询结果时执行的额外操作，如打印日志、更新缓存等。

使用示例

// 假设有一个 User 实体类和对应的 BaseMapper

LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();

(User::getStatus, "active"); // 查询状态为 "active" 的用户

// 使用 list 方法查询并封装结果，提取所有用户的用户名

List<String> userNames = (

queryWrapper, // 查询条件构造器

User::getUsername, // 提取用户名作为列表元素

user -> ("Processing user: " + ()) // 打印处理的用户名

);

// 遍历结果

for (String username : userNames) {

("Username: " + username);

}

使用提示

list 方法适用于需要根据实体的某个属性快速获取一个列表的场景。
通过 sFunction 参数，你可以指定任何实体属性作为 List 的元素，这使得查询结果的访问更加直观和高效。
peeks 参数允许你在处理查询结果时执行额外的副作用操作，这些操作不会影响最终的 List 结果。
当处理大量数据时，可以考虑将 isParallel 参数设置为 true 以启用并行流，从而提高查询效率。

通过使用 SimpleQuery 的 list 方法，开发者可以更加高效地处理查询结果，并将其封装成易于使用的数据结构，同时还可以执行额外的副作用操作，使代码更加简洁和灵活。

Db Kit

Db Kit 是 Mybatis-Plus 提供的一个工具类，它允许开发者通过静态调用的方式执行 CRUD 操作，从而避免了在 Spring 环境下可能出现的 Service 循环注入问题，简化了代码，提升了开发效率。

Db Kit 的完整使用方式可以参考官方测试用例。

注意

使用 Db Kit 前，需要确保项目中已注入对应实体的 BaseMapper。
当参数为 Wrapper 时，需要在 Wrapper 中传入 Entity 或者 EntityClass，以便寻找对应的 Mapper。
不建议在循环中频繁调用 Db Kit 的方法，如果是批量操作，建议先将数据构造好，然后使用 (数据) 等批量方法进行保存。

使用示例


// 假设有一个 User 实体类和对应的 BaseMapper

// 根据 id 查询单个实体

User user = (1L, );

// 根据 id 查询多个实体

List<User> userList = ((1L, 2L, 3L), );

// 根据条件构造器查询

LambdaQueryWrapper<User> queryWrapper = ()

.eq(User::getStatus, "active");

List<User> activeUsers = (queryWrapper);

// 插入新实体

User newUser = new User();

("newUser");

(25);

boolean isInserted = (newUser);

// 根据 id 更新实体

User updateUser = new User();

(1L);

("updatedUser");

boolean isUpdated = (updateUser);

// 根据条件构造器更新

LambdaUpdateWrapper<User> updateWrapper = ()

.set(User::getAge, 30)

.eq(User::getUsername, "updatedUser");

boolean isUpdatedByWrapper = (null, updateWrapper);

// 根据 id 删除实体

boolean isDeleted = (1L);

// 根据条件构造器删除

LambdaDeleteWrapper<User> deleteWrapper = ()

.eq(User::getStatus, "inactive");

boolean isDeletedByWrapper = (deleteWrapper);

// 批量插入

List<User> batchUsers = (

new User("user1", 20),

new User("user2", 22),

new User("user3", 24)

);

boolean isBatchInserted = (batchUsers);

// 批量更新

List<User> batchUpdateUsers = (

new User(1L, "user1", 21),

new User(2L, "user2", 23),

new User(3L, "user3", 25)

);

boolean isBatchUpdated = (batchUpdateUsers);

使用提示

Db Kit 提供了一系列静态方法，可以直接调用进行数据库操作，无需通过 Service 层，简化了代码结构。
在使用 Db Kit 时，确保传入的参数正确，特别是当使用 Wrapper 时，需要指定实体类或实体对象。
对于批量操作，如批量插入或更新，建议使用 Db Kit 提供的批量方法，以提高效率。
避免在循环中频繁调用 Db Kit 的方法，这可能会导致性能问题。

通过使用 Db Kit，开发者可以更加高效地执行数据库操作，同时保持代码的简洁性和可读性。这种工具类尤其适合于简单的 CRUD 操作，可以大大减少重复代码的编写。

BaseMapper 丨Mybatis Plus BaseMapper使用手册

引导类中添加 @MapperScan 注解，扫描 Mapper 文件夹

建立实体类

建立Mapper层

Mapper Interface接口内容说明

插入操作insert

示例：

生成的 SQL:

删除操作delete

示例：

对象删除

生成的SQL：

根据ID删除：

生成SQL：

批量删除：

生成的SQL：

更新操作update

根据对象进行更新

生成的SQL：

根据ID进行更新:

生成的SQL：

查询操作select

根据ID进行查询

生成的SQL：

根据对象进行查询

生成的SQL：

批量查询

生成的SQL：

分页查询：

生成的SQL：

选装件说明

alwaysUpdateSomeColumnById

insertBatchSomeColumn

logicDeleteByIdWithFill

使用提示

Chain

使用步骤

query

update

使用提示

ActiveRecord

使用步骤

使用提示

SimpleQuery

使用步骤

使用提示

功能详解

keyMap

方法签名

参数说明

使用示例

使用提示

map

方法签名

参数说明

使用示例

使用提示

group

方法签名

参数说明

使用示例

使用提示

list

方法签名

参数说明

使用示例

使用提示

Db Kit

使用示例

使用提示

相关文章