实现笔记回收站与软删除恢复机制

举报
yd_284811271 发表于 2026/11/17 14:54:11 2026/11/17
【摘要】 前言笔记类应用里直接删除数据是很危险的操作,用户很容易误删重要内容。我们不直接从RDB数据库中物理删除记录,而是增加软删除标记,搭配回收站页面,支持查看、恢复、永久删除,这是笔记App里很实用的能力。本文基于ArkTS + RDB完成这套回收站逻辑开发。 方案设计思路数据表新增字段:isDeleted(布尔值,false正常,true已移入回收站)、deleteTime(删除时间戳)普通笔...

前言

笔记类应用里直接删除数据是很危险的操作,用户很容易误删重要内容。我们不直接从RDB数据库中物理删除记录,而是增加软删除标记,搭配回收站页面,支持查看、恢复、永久删除,这是笔记App里很实用的能力。本文基于ArkTS + RDB完成这套回收站逻辑开发。

方案设计思路

  1. 数据表新增字段:isDeleted(布尔值,false正常,true已移入回收站)、deleteTime(删除时间戳)
  2. 普通笔记列表查询:过滤 isDeleted = false
  3. 回收站列表查询:过滤 isDeleted = true
  4. 恢复:把标记改回false,清空deleteTime
  5. 永久删除:真正执行数据库delete操作
  6. 附加自动清理策略:超过30天的回收站笔记自动清除(可选)

优势:用户误删可以找回;相比单独一张回收站表,改造简单,数据关联不容易出错。

第一步:修改RDB实体与建表语句

// NoteEntity.ets
export class NoteEntity {
  id: number;
  title: string;
  content: string;
  createTime: number;
  updateTime: number;
  // 软删除字段
  isDeleted: boolean;
  deleteTime: number;

  constructor() {
    this.id = 0;
    this.title = "";
    this.content = "";
    this.createTime = 0;
    this.updateTime = 0;
    this.isDeleted = false;
    this.deleteTime = 0;
  }
}

// 建表SQL
const CREATE_TABLE_NOTE = `CREATE TABLE IF NOT EXISTS note (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  title TEXT,
  content TEXT,
  createTime INTEGER,
  updateTime INTEGER,
  isDeleted INTEGER DEFAULT 0,
  deleteTime INTEGER DEFAULT 0
)`;

SQLite没有bool类型,用0/1代表false/true。

第二步:封装数据库操作方法

// RdbHelper.ets
import { relationalStore } from '@kit.RelationalStoreKit';

// 移入回收站(软删除)
async function moveToRecycleBin(store: relationalStore.RdbStore, noteId: number): Promise<void> {
  const time = Date.now();
  await store.update(
    'note',
    { isDeleted: 1, deleteTime: time },
    relationalStore.Predicates.equalTo('id', noteId)
  );
}

// 恢复笔记
async function restoreNote(store: relationalStore.RdbStore, noteId: number): Promise<void> {
  await store.update(
    'note',
    { isDeleted: 0, deleteTime: 0 },
    relationalStore.Predicates.equalTo('id', noteId)
  );
}

// 永久删除
async function deletePermanently(store: relationalStore.RdbStore, noteId: number): Promise<void> {
  await store.delete(
    'note',
    relationalStore.Predicates.equalTo('id', noteId)
  );
}

// 查询回收站笔记
async function queryRecycleNotes(store: relationalStore.RdbStore): Promise<NoteEntity[]> {
  const resultSet = await store.query(
    'note',
    ['id','title','content','createTime','deleteTime'],
    relationalStore.Predicates.equalTo('isDeleted', 1).orderBy('deleteTime', relationalStore.SortOrder.DESC)
  );
  const list: NoteEntity[] = [];
  while (resultSet.goToNextRow()) {
    const item = new NoteEntity();
    item.id = resultSet.getLong(0);
    item.title = resultSet.getString(1);
    item.content = resultSet.getString(2);
    item.createTime = resultSet.getLong(3);
    item.deleteTime = resultSet.getLong(4);
    list.push(item);
  }
  resultSet.close();
  return list;
}

// 自动清理30天以上的回收站笔记
async function autoCleanExpireNote(store: relationalStore.RdbStore): Promise<void> {
  const expireTs = Date.now() - 30 * 24 * 60 * 60 * 1000;
  await store.delete(
    'note',
    relationalStore.Predicates.equalTo('isDeleted', 1).lessThan('deleteTime', expireTs)
  );
}

第三步:回收站页面UI实现

// RecycleBinPage.ets
@Entry
@Component
struct RecycleBinPage {
  @State recycleList: NoteEntity[] = [];
  private rdbStore: relationalStore.RdbStore | null = null;

  aboutToAppear() {
    this.loadData();
  }

  async loadData() {
    if (!this.rdbStore) return;
    // 先自动清理过期笔记
    await autoCleanExpireNote(this.rdbStore);
    this.recycleList = await queryRecycleNotes(this.rdbStore);
  }

  build() {
    Column() {
      Text("回收站")
        .fontSize(22)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 16, bottom: 12 })

      if (this.recycleList.length === 0) {
        Text("回收站空空如也")
          .fontColor("#999")
          .margin({ top: 40 })
      } else {
        List() {
          ForEach(this.recycleList, (item: NoteEntity) => {
            ListItem() {
              Column() {
                Text(item.title || "无标题笔记")
                  .fontSize(16)
                  .width('100%')
                Text(`删除时间:${new Date(item.deleteTime).toLocaleString()}`)
                  .fontSize(12)
                  .fontColor("#666")
                  .margin({ top:4 })

                Row() {
                  Button("恢复", { type: ButtonType.Normal, stateEffect: true })
                    .onClick(async () => {
                      await restoreNote(this.rdbStore!, item.id);
                      this.loadData();
                    })
                  Button("永久删除", { type: ButtonType.Normal })
                    .backgroundColor("#dc3545")
                    .margin({ left:12 })
                    .onClick(async () => {
                      await deletePermanently(this.rdbStore!, item.id);
                      this.loadData();
                    })
                }
                .margin({ top:8 })
              }
              .padding(12)
              .width('100%')
            }
          }, (item: NoteEntity) => item.id.toString())
        }
        .layoutWeight(1)
      }
    }
    .padding(16)
    .width('100%')
    .height('100%')
    .backgroundColor('#f5f5f5')
  }
}

第四步:主笔记列表修改查询条件

原来查询笔记列表的代码,Predicate需要加上过滤条件,只展示未删除笔记:

relationalStore.Predicates.equalTo('isDeleted', 0)

在笔记详情页,删除按钮不再直接delete,而是调用 moveToRecycleBin。

踩坑点与优化方向

  1. 同步逻辑兼容:如果之前做了云端同步,软删除标记也需要同步到云端,否则多端回收站状态不一致;
  2. 自动清理时机:不要每次打开页面都执行清理,可以记录上次清理时间,间隔24小时才执行一次;
  3. 批量操作:上面示例是单条恢复/删除,后续可以扩展批量勾选、批量恢复;
  4. 空间提示:永久删除后才真正释放数据库存储空间,软删除的数据仍然占用存储;
  5. 弹窗确认:永久删除是不可恢复操作,UI层一定要增加确认弹窗,防止误触。

小结

软删除+回收站是一个非常经典的业务设计,不需要复杂架构,只靠增加字段、修改查询条件就实现数据可找回。这套方案可以直接复用到备忘录、待办、文件管理等同类应用。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。