MyBatisPlus靜態(tài)工具Db的實現方法

更新時間：2026年03月04日 10:52:55 作者：ruleslol

Db是MyBatis-Plus3.5.4+提供的靜態(tài)工具類,無需注入Service或Mapper,直接通過靜態(tài)方法操作數據庫,本文就來詳細的介紹一下MyBatisPlus靜態(tài)工具Db的實現,感興趣的可以了解一下

什么是Db？

Db 是 MyBatis-Plus 3.5.4+ 提供的靜態(tài)工具類，無需注入 Service 或 Mapper，直接通過靜態(tài)方法操作數據庫。本質上是對 IService 的靜態(tài)封裝。

// 傳統方式：需要注入
@Autowired
private UserService userService;
userService.getById(1);

// Db 靜態(tài)工具：直接調用
Db.getById(1, User.class);

一、靜態(tài)工具Db常用方法：

IService接口是非靜態(tài)的，需要自定義接口，并且繼承它，繼承它的過程中還要指定泛型（實體類的類型），目的：通過發(fā)射，得到實體類的字節(jié)碼，才能知道表信息，才能實現CRUD。

靜態(tài)方法是沒有辦法讀取到類上的泛型的，所以，Db上是沒有泛型的，它的方法都需要一個實體類的字節(jié)碼class<T>，才能通過反射拿到實體類的相關信息。

二、核心使用場景

場景一：解決循環(huán)依賴問題 ? 最常用

這是 Db 最重要的使用場景。當兩個 Service 互相依賴時，用 Db 打破循環(huán)。

// ? 傳統方式：循環(huán)依賴，Spring 啟動報錯
@Service
public class OrderService {
    @Autowired
    private UserService userService; // OrderService 依賴 UserService
}

@Service
public class UserService {
    @Autowired
    private OrderService orderService; // UserService 又依賴 OrderService
}

示例：

【注意】：

service比mapper可用的方法更多！

場景二：在非 Service 層直接操作數據庫

在 Mapper、工具類、定時任務、事件監(jiān)聽器等無法方便注入 Service 的地方直接使用。

// 定時任務中直接操作數據庫
@Component
public class DataCleanTask {

    @Scheduled(cron = "0 0 2 * * ?")
    public void cleanExpiredData() {
        // 不需要注入任何 Service，直接靜態(tài)調用
        Db.remove(new LambdaQueryWrapper<Order>()
            .lt(Order::getExpireTime, LocalDateTime.now())
            .eq(Order::getStatus, "EXPIRED")
        );
        
        System.out.println("過期數據清理完成");
    }
}

// 事件監(jiān)聽器中使用
@Component
public class UserEventListener {

    @EventListener
    public void onUserRegister(UserRegisterEvent event) {
        // 直接保存初始積分記錄，無需注入 PointService
        UserPoint point = new UserPoint();
        point.setUserId(event.getUserId());
        point.setPoint(100);
        Db.save(point);
    }
}

場景三：實體類內部直接關聯查詢

讓實體類自己完成關聯數據的獲取，VO 轉換更優(yōu)雅。

@Data
@TableName("order")
public class Order {
    private Long id;
    private Long userId;
    private Long productId;
    private Integer amount;

    // 實體類內部直接查關聯數據
    @TableField(exist = false)
    public User getUser() {
        return Db.getById(this.userId, User.class);
    }

    @TableField(exist = false)
    public Product getProduct() {
        return Db.getById(this.productId, Product.class);
    }
}

場景四：批量操作

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

    public void batchInsert() {
        List<User> users = new ArrayList<>();
        for (int i = 0; i < 100000; i++) {
            users.add(new User("name" + i, i));
        }
        // 靜態(tài)批量插入，batchSize 默認 1000
        Db.saveBatch(users);
        // 也可以指定 batchSize
        Db.saveBatch(users, 500);
    }

    public void batchUpdateById() {
        List<User> users = Db.list(new LambdaQueryWrapper<User>()
            .eq(User::getStatus, 0));
        
        users.forEach(u -> u.setStatus(1));
        
        // 批量更新
        Db.updateBatchById(users);
    }
}

三、常用 API 速查

// ====== 查詢 ======
// 根據 ID 查詢
User user = Db.getById(1L, User.class);

// 條件查詢單條
User user = Db.getOne(new LambdaQueryWrapper<User>()
    .eq(User::getName, "張三"));

// 查詢列表
List<User> users = Db.list(new LambdaQueryWrapper<User>()
    .eq(User::getStatus, 1));

// 查詢數量
long count = Db.count(new LambdaQueryWrapper<User>()
    .eq(User::getStatus, 1));

// 分頁查詢
Page<User> page = Db.page(new Page<>(1, 10), 
    new LambdaQueryWrapper<User>().eq(User::getStatus, 1));

// ====== 插入 ======
Db.save(user);
Db.saveBatch(userList);
Db.saveBatch(userList, 500);

// ====== 更新 ======
Db.updateById(user);
Db.update(user, new LambdaQueryWrapper<User>()
    .eq(User::getName, "張三"));
Db.updateBatchById(userList);

// 有則更新，無則插入
Db.saveOrUpdate(user);

// ====== 刪除 ======
Db.removeById(1L, User.class);
Db.remove(new LambdaQueryWrapper<User>()
    .eq(User::getStatus, 0));
Db.removeByIds(idList, User.class);

總結

對比項	傳統 Service 注入	Db 靜態(tài)工具
使用方式	需要 @Autowired 注入	直接靜態(tài)調用
循環(huán)依賴	容易出現	完全避免
適用場景	主業(yè)務邏輯層	輔助查詢、工具類、監(jiān)聽器
版本要求	無限制	MP 3.5.4+