generated from dellevin/template
82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
# 数据访问层
|
||
|
||
## DAO 模式
|
||
|
||
每个实体有独立的 DAO 类，封装 SQLite CRUD 操作：
|
||
|
||
| DAO | 文件 | 实体 |
|
||
|-----|------|------|
|
||
| `MovieDao` | `lib/utils/movie/movie_dao.dart` | Movie |
|
||
| `BookDao` | `lib/utils/book/book_dao.dart` | Book |
|
||
| `NoteDao` | `lib/utils/note/note_dao.dart` | Note |
|
||
| `MovieReviewDao` | `lib/utils/movie/movie_review_dao.dart` | MovieReview |
|
||
| `MoviePosterDao` | `lib/utils/movie/movie_poster_dao.dart` | MoviePoster |
|
||
| `BookReviewDao` | `lib/utils/book/book_review_dao.dart` | BookReview |
|
||
| `BookExcerptDao` | `lib/utils/book/book_excerpt_dao.dart` | BookExcerpt |
|
||
| `TagDao` | `lib/utils/tag/tag_dao.dart` | Tag |
|
||
|
||
## DatabaseHelper
|
||
|
||
`lib/utils/database_helper.dart` — SQLite 数据库单例管理器。
|
||
|
||
```dart
|
||
class DatabaseHelper {
|
||
static final DatabaseHelper instance = DatabaseHelper._init();
|
||
static Database? _database;
|
||
|
||
Future<Database> get database; // 获取数据库实例（懒初始化）
|
||
Future<void> reopenDatabase(); // 关闭并重新打开（WebDAV 同步后调用）
|
||
Future<void> close(); // 关闭数据库
|
||
}
|
||
```
|
||
|
||
- 数据库文件名：`mooknote.db`
|
||
- 当前版本：13
|
||
- 初始化时执行 `_createDB`，版本不匹配时执行 `_onUpgrade` 迁移链
|
||
|
||
## DAO 通用方法
|
||
|
||
以 `MovieDao` 为例：
|
||
|
||
```dart
|
||
getAllMovies() // 获取所有未删除记录
|
||
getMoviesPaged({status, limit, offset}) // 分页查询
|
||
getMoviesByStatus(status) // 按状态筛选
|
||
getMoviesByDirector(director) // 按导演筛选
|
||
getMoviesByActor(actor) // 按演员筛选
|
||
insertMovie(movie) // 插入
|
||
updateMovie(movie) // 更新
|
||
deleteMovie(id) // 软删除
|
||
getDeletedMovies() // 获取已删除记录
|
||
restoreMovie(id) // 恢复
|
||
permanentDeleteMovie(id) // 彻底删除
|
||
```
|
||
|
||
## 软删除机制
|
||
|
||
所有实体使用 `is_deleted` 字段实现软删除：
|
||
|
||
```
|
||
删除操作 → UPDATE SET is_deleted = 1 WHERE id = ?
|
||
查询操作 → WHERE is_deleted = 0
|
||
恢复操作 → UPDATE SET is_deleted = 0 WHERE id = ?
|
||
彻底删除 → DELETE FROM table WHERE id = ?
|
||
```
|
||
|
||
回收站页面（`lib/pages/recycle_bin_page.dart`）展示所有 `is_deleted = 1` 的记录，支持恢复和彻底删除。
|
||
|
||
## TagDao
|
||
|
||
标签 DAO 管理 `tags` 表，支持：
|
||
|
||
- `getTagsByType(type)` — 获取某类型所有标签
|
||
- `addTag(name, type)` — 添加标签（UNIQUE 约束防重复）
|
||
- `renameTag(tagId, newName)` — 重命名标签并级联更新关联条目
|
||
- `deleteTag(tagId, {replacementName})` — 删除标签，可选替换关联条目中的标签名
|
||
- `deleteTagOnly(tagId)` — 仅删除标签记录，不修改关联条目
|
||
- `getTagById(tagId)` — 获取单个标签
|
||
|
||
标签级联逻辑：重命名或删除标签时，会遍历关联实体表（movies.genres / books.genres / notes.tags），将旧标签名替换为新名称或移除。
|
||
|
||
[返回首页](Home.md)
|