# Kite 实现逻辑删除

逻辑删除是一种数据处理方式，指在删除数据时，并非真正从数据库中物理删除记录，而是通过标记的方式表示该记录已被删除。这样做的好处是可以保留数据的完整性和可追溯性，同时也便于在需要时恢复被删除的数据。

## 逻辑删除配置

Kite 提供了逻辑删除的配置选项，你可以在 `LogicalDeletionConfig` 中进行配置。

- Java

```java
import com.tang.kite.config.logical.LogicalDeletionConfig;

// 启用逻辑删除
LogicalDeletionConfig.enabled = true;

// 设置逻辑删除字段名
LogicalDeletionConfig.fieldName = "deleted";

// 自定义逻辑删除处理器
LogicalDeletionConfig.logicalDeletionProcessor = new CustomLogicalDeletionProcessor();
```

- Kotlin

```kotlin
import com.tang.kite.config.logical.LogicalDeletionConfig

// 启用逻辑删除
LogicalDeletionConfig.enabled = true

// 设置逻辑删除字段名
LogicalDeletionConfig.fieldName = "deleted"

// 自定义逻辑删除处理器
LogicalDeletionConfig.logicalDeletionProcessor = CustomLogicalDeletionProcessor()
```

## 逻辑删除注解

Kite 提供了 `@LogicalDeletion` 注解，用于在实体类中指定逻辑删除字段。该注解的优先级大于全局配置的 `fieldName`。

### 使用示例

- Java

```java
import com.tang.kite.annotation.logical.LogicalDeletion;

public class Account {

    private Long id;
    private String name;
    @LogicalDeletion
    private String deleted;

}
```

- Kotlin

```kotlin
import com.tang.kite.annotation.logical.LogicalDeletion

class Account {

    var id: Long? = null
    var name: String? = null
    @LogicalDeletion
    var deleted: String? = null

}
```

## 逻辑删除处理器

### 方法列表

| 方法名                                        | 描述                                                  | 返回值                 |
| --------------------------------------------- | ----------------------------------------------------- | ---------------------- |
| `isTableNeedProcessing(tableClass: Class<*>)` | 判断特定表类是否需要处理。默认返回 true，处理所有表。 | `Boolean`              |
| `process(field: Field)`                       | 处理指定的数据库字段以生成逻辑删除值。                | `LogicalDeletionValue` |

### 默认实现

Kite 提供了一个默认的逻辑删除处理器 `DefaultLogicalDeletionProcessor`，它支持多种数据类型的逻辑删除值生成：

| 数据类型  | 正常值  | 删除值 |
| --------- | ------- | ------ |
| `Boolean` | `false` | `true` |
| `Byte`    | `0`     | `1`    |
| `Short`   | `0`     | `1`    |
| `Int`     | `0`     | `1`    |
| `Long`    | `0L`    | `1L`   |
| `Char`    | `'0'`   | `'1'`  |
| `String`  | `"0"`   | `"1"`  |

### 自定义处理器

你可以实现 `LogicalDeletionProcessor` 接口来自定义逻辑删除处理器：

- Java

```java
import com.tang.kite.config.logical.LogicalDeletionProcessor;
import com.tang.kite.config.logical.LogicalDeletionValue;
import java.lang.reflect.Field;

public class CustomLogicalDeletionProcessor implements LogicalDeletionProcessor {

    @Override
    public boolean isTableNeedProcessing(Class<?> tableClass) {
        return tableClass == Account.class;
    }

    @Override
    public LogicalDeletionValue process(Field field) {
        return new LogicalDeletionValue("N", "Y");
    }

}
```

- Kotlin

```kotlin
import com.tang.kite.config.logical.LogicalDeletionProcessor
import com.tang.kite.config.logical.LogicalDeletionValue
import java.lang.reflect.Field

class CustomLogicalDeletionProcessor : LogicalDeletionProcessor {

    override fun isTableNeedProcessing(tableClass: Class<*>): Boolean {
        return tableClass == Account::class.java

    }

    override fun process(field: Field): LogicalDeletionValue {
        return LogicalDeletionValue("N", "Y")
    }

}
```

### 配置自定义处理器

- Java

```java
LogicalDeletionConfig.logicalDeletionProcessor = CustomLogicalDeletionProcessor();
```

- Kotlin

```kotlin
LogicalDeletionConfig.logicalDeletionProcessor = CustomLogicalDeletionProcessor()
```

## 逻辑删除管理器

Kite 提供了 `LogicalDeletionManager` 类，用于在特定场景下跳过逻辑删除或者临时使用逻辑删除。

### 方法列表

- Java

| 方法名                                  | 描述                                 | 参数                                | 返回值             |
| --------------------------------------- | ------------------------------------ | ----------------------------------- | ------------------ |
| `withLogical(block: Runnable)`          | 临时使用逻辑删除执行代码块           | `block: Runnable` 要执行的代码块    | 无                 |
| `withLogical(block: Supplier): T` | 临时使用逻辑删除执行代码块并返回结果 | `block: Supplier` 要执行的代码块 | `T` 代码块的返回值 |
| `withSkip(block: Runnable)`             | 跳过逻辑删除执行代码块               | `block: Runnable` 要执行的代码块    | 无                 |
| `withSkip(block: Supplier): T`    | 跳过逻辑删除执行代码块并返回结果     | `block: Supplier` 要执行的代码块 | `T` 代码块的返回值 |

- Kotlin

| 方法名                              | 描述                                 | 参数                               | 返回值             |
| ----------------------------------- | ------------------------------------ | ---------------------------------- | ------------------ |
| `withLogical(block: () -> Unit)`    | 临时使用逻辑删除执行代码块           | `block: () -> Unit` 要执行的代码块 | 无                 |
| `withLogical(block: () -> T): T` | 临时使用逻辑删除执行代码块并返回结果 | `block: () -> T` 要执行的代码块    | `T` 代码块的返回值 |
| `withSkip(block: () -> Unit)`       | 跳过逻辑删除执行代码块               | `block: () -> Unit` 要执行的代码块 | 无                 |
| `withSkip(block: () -> T): T`    | 跳过逻辑删除执行代码块并返回结果     | `block: () -> T` 要执行的代码块    | `T` 代码块的返回值 |

### 使用示例

#### 临时使用逻辑删除

- Java

```java
import com.tang.kite.logical.LogicalDeletionManager;

LogicalDeletionManager.withLogical(() -> {
    accountMapper.deleteById(1L);
});
```

- Kotlin

```kotlin
import com.tang.kite.logical.LogicalDeletionManager

LogicalDeletionManager.withLogical {
    accountMapper.deleteById(1L)
}
```

#### 跳过逻辑删除

- Java

```java
import com.tang.kite.logical.LogicalDeletionManager;

LogicalDeletionManager.withSkip(() -> {
    accountMapper.deleteById(1L);
});
```

- Kotlin

```kotlin
import com.tang.kite.logical.LogicalDeletionManager

LogicalDeletionManager.withSkip {
    accountMapper.deleteById(1L)
}
```

## 官方文档

详细的使用文档请参考：

- [中文文档](https://tangllty.eu.org/zh/advanced/logical-deletion)
- [英文文档](https://tangllty.eu.org/advanced/logical-deletion)

## 源码

Kite 的源码托管在 GitHub 和 Gitee 上，您可以在以下地址查看和贡献：

- [Kite GitHub 仓库](https://github.com/tangllty/kite)
- [Kite Gitee 仓库](https://gitee.com/tangllty/kite)

## 总结

Kite 是一个功能强大、易于使用的 ORM 框架，它通过全自动映射和简洁的 API，大大简化了数据库操作的开发工作。无论是在 Kotlin 项目还是 Java 项目中，都能提供高效、便捷的数据库访问体验。

如果您正在寻找一个轻量级、高性能的 ORM 框架，Kite 绝对值得一试！

逻辑删除是一种数据处理方式，指在删除数据时，并非真正从数据库中物理删除记录，而是通过标记的方式表示该记录已被删除。这样做的好处是可以保留数据的完整性和可追溯性，同时也便于在需要时恢复被删除的数据。

Kite 实现逻辑删除

Kite框架提供了完整的逻辑删除功能实现方案，包括配置选项、注解支持和处理器扩展。开发者可以全局启用逻辑删除并指定标记字段，也可通过@LogicalDeletion注解在实体类中单独配置。框架内置默认处理器支持常见数据类型的逻辑值转换，同时允许自定义处理器实现特殊业务逻辑。此外，LogicalDeletionManager类提供了灵活的临时启用/跳过逻辑删除的机制，满足不同场景需求。这种设计既保证

数据库

后端

Kite框架提供完善的逻辑删除功能，支持通过注解或全局配置实现数据标记删除而非物理删除。可自定义删除处理器，灵活设置不同数据类型的删除标记值，并支持临时跳过或启用逻辑删除功能，满足数据恢复和审计需求。

Kotlin

GitHub

Java

2026采购季 | AI焕新·智启新局

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Kite 实现逻辑删除-腾讯云开发者社区-腾讯云

Kite 实现逻辑删除

Kite 实现逻辑删除

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐