实现笔记回收站与软删除恢复机制
【摘要】 前言笔记类应用里直接删除数据是很危险的操作,用户很容易误删重要内容。我们不直接从RDB数据库中物理删除记录,而是增加软删除标记,搭配回收站页面,支持查看、恢复、永久删除,这是笔记App里很实用的能力。本文基于ArkTS + RDB完成这套回收站逻辑开发。 方案设计思路数据表新增字段:isDeleted(布尔值,false正常,true已移入回收站)、deleteTime(删除时间戳)普通笔...
前言
笔记类应用里直接删除数据是很危险的操作,用户很容易误删重要内容。我们不直接从RDB数据库中物理删除记录,而是增加软删除标记,搭配回收站页面,支持查看、恢复、永久删除,这是笔记App里很实用的能力。本文基于ArkTS + RDB完成这套回收站逻辑开发。
方案设计思路
- 数据表新增字段:
isDeleted(布尔值,false正常,true已移入回收站)、deleteTime(删除时间戳) - 普通笔记列表查询:过滤
isDeleted = false - 回收站列表查询:过滤
isDeleted = true - 恢复:把标记改回false,清空deleteTime
- 永久删除:真正执行数据库delete操作
- 附加自动清理策略:超过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。
踩坑点与优化方向
- 同步逻辑兼容:如果之前做了云端同步,软删除标记也需要同步到云端,否则多端回收站状态不一致;
- 自动清理时机:不要每次打开页面都执行清理,可以记录上次清理时间,间隔24小时才执行一次;
- 批量操作:上面示例是单条恢复/删除,后续可以扩展批量勾选、批量恢复;
- 空间提示:永久删除后才真正释放数据库存储空间,软删除的数据仍然占用存储;
- 弹窗确认:永久删除是不可恢复操作,UI层一定要增加确认弹窗,防止误触。
小结
软删除+回收站是一个非常经典的业务设计,不需要复杂架构,只靠增加字段、修改查询条件就实现数据可找回。这套方案可以直接复用到备忘录、待办、文件管理等同类应用。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)