43、软删除模式的实现与应用

软删除模式的实现与应用

1. 软删除模式概述

在 API 设计中，软删除模式是一种重要的设计模式。其核心在于依靠一个额外的字段来指示资源是否被删除，而非直接从系统中永久移除资源。这种模式带来了诸多优势，比如可以避免误删除数据，同时也引发了一系列需要解决的问题。

2. 资源删除状态的存储方式

为了在资源类型上启用软删除模式，需要一种方式来表明资源已被系统视为删除。主要有两种方式：布尔标志字段和状态字段。
- 布尔标志字段
- 在大多数情况下，定义一个简单的布尔字段是指示资源已被软删除的最佳方式。该字段默认值为 false，因为新创建的资源不应在生命周期开始时就被标记为删除。
typescript interface ChatRoom { id: string; // ... deleted: boolean; }
- 这个布尔字段应仅作为输出字段处理。这意味着如果有人尝试使用标准更新方法设置该字段，其值将被忽略。只有通过标准删除方法（将值从 false 更改为 true）或自定义的恢复删除方法（将值从 true 更改为 false）才能修改该字段。以下是一个示例：
typescript let chatRoom = GetChatRoom({ id: "1234" }); assert chatRoom.deleted == false; chatRoom.deleted = true; chatRoom = UpdateChatRoom({ resource: chatRoom, fieldMask: ['deleted'] }); assert