|
|
package net.micode.notes.data;
|
|
|
|
|
|
import android.content.ContentValues;
|
|
|
import android.content.Context;
|
|
|
import android.database.sqlite.SQLiteDatabase;
|
|
|
import android.database.sqlite.SQLiteOpenHelper;
|
|
|
import android.util.Log;
|
|
|
|
|
|
import net.micode.notes.data.Notes.DataColumns;
|
|
|
import net.micode.notes.data.Notes.DataConstants;
|
|
|
import net.micode.notes.data.Notes.NoteColumns;
|
|
|
|
|
|
// NotesDatabaseHelper类继承自SQLiteOpenHelper，用于管理与笔记相关的数据库的创建、升级等操作
|
|
|
// 它负责创建笔记表、数据表以及相关的触发器，处理数据库版本更新等功能
|
|
|
public class NotesDatabaseHelper extends SQLiteOpenHelper {
|
|
|
|
|
|
// 定义数据库文件名
|
|
|
private static final String DB_NAME = "note.db";
|
|
|
|
|
|
// 定义数据库版本号，用于数据库升级时的版本判断等操作
|
|
|
private static final int DB_VERSION = 4;
|
|
|
|
|
|
// 定义内部接口TABLE，用于存放数据库中表的名称常量，方便在代码中统一引用表名，提高可读性和可维护性
|
|
|
public interface TABLE {
|
|
|
// 笔记表的名称常量
|
|
|
public static final String NOTE = "note";
|
|
|
|
|
|
// 数据表的名称常量，可能用于存储笔记相关的附加数据等
|
|
|
public static final String DATA = "data";
|
|
|
}
|
|
|
|
|
|
// 用于日志记录的标签，方便在查看日志时识别是该类输出的日志信息
|
|
|
private static final String TAG = "NotesDatabaseHelper";
|
|
|
|
|
|
// 采用单例模式，保存该类的唯一实例，确保整个应用中只有一个数据库帮助类实例在操作数据库
|
|
|
private static NotesDatabaseHelper mInstance;
|
|
|
|
|
|
// 创建笔记表（TABLE.NOTE）的SQL语句，定义了表的各个列名、数据类型、默认值以及主键等信息
|
|
|
private static final String CREATE_NOTE_TABLE_SQL =
|
|
|
"CREATE TABLE " + TABLE.NOTE + "(" +
|
|
|
NoteColumns.ID + " INTEGER PRIMARY KEY," +
|
|
|
NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
|
|
|
NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
|
|
|
NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
|
|
|
NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
|
|
|
NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
|
|
|
NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
|
|
|
")";
|
|
|
|
|
|
// 创建数据表（TABLE.DATA）的SQL语句，同样定义了表的各列信息，用于存储与笔记相关的数据内容等
|
|
|
private static final String CREATE_DATA_TABLE_SQL =
|
|
|
"CREATE TABLE " + TABLE.DATA + "(" +
|
|
|
DataColumns.ID + " INTEGER PRIMARY KEY," +
|
|
|
DataColumns.MIME_TYPE + " TEXT NOT NULL," +
|
|
|
DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
|
|
|
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
|
|
|
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
|
|
|
DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," +
|
|
|
DataColumns.DATA1 + " INTEGER," +
|
|
|
DataColumns.DATA2 + " INTEGER," +
|
|
|
DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
|
|
|
DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
|
|
|
DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
|
|
|
")";
|
|
|
|
|
|
// 创建基于数据表（TABLE.DATA）中笔记ID（DataColumns.NOTE_ID）字段的索引的SQL语句，用于提高根据笔记ID查询相关数据的效率
|
|
|
private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
|
|
|
"CREATE INDEX IF NOT EXISTS note_id_index ON " +
|
|
|
TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
|
|
|
|
|
|
/**
|
|
|
* 以下是一系列用于数据库操作的触发器（Trigger）相关的SQL语句定义，触发器用于在特定数据库操作发生时自动执行一些额外的逻辑。
|
|
|
* 例如，在更新、插入、删除笔记或数据时，对相关的计数、关联数据等进行相应的调整。
|
|
|
*/
|
|
|
|
|
|
/**
|
|
|
* 当笔记移动到某个文件夹（更新NoteColumns.PARENT_ID字段）后，增加该文件夹的笔记数量的触发器SQL语句。
|
|
|
* 它在TABLE.NOTE表的NoteColumns.PARENT_ID字段更新后触发，通过更新语句增加目标文件夹（新的父文件夹）的NoteColumns.NOTES_COUNT字段值。
|
|
|
*/
|
|
|
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
|
|
|
"CREATE TRIGGER increase_folder_count_on_update " +
|
|
|
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
|
|
|
" BEGIN " +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
|
|
|
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当笔记从某个文件夹移出（更新NoteColumns.PARENT_ID字段）后，减少该文件夹的笔记数量的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表的NoteColumns.PARENT_ID字段更新后触发，条件是原文件夹的NoteColumns.NOTES_COUNT大于0时，减少其数量。
|
|
|
*/
|
|
|
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
|
|
|
"CREATE TRIGGER decrease_folder_count_on_update " +
|
|
|
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
|
|
|
" BEGIN " +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
|
|
|
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
|
|
|
" AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当向某个文件夹插入新笔记后，增加该文件夹的笔记数量的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表插入新记录后触发，通过更新语句增加新笔记所属文件夹（根据NoteColumns.PARENT_ID确定）的NoteColumns.NOTES_COUNT字段值。
|
|
|
*/
|
|
|
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
|
|
|
"CREATE TRIGGER increase_folder_count_on_insert " +
|
|
|
" AFTER INSERT ON " + TABLE.NOTE +
|
|
|
" BEGIN " +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
|
|
|
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当从某个文件夹删除笔记后，减少该文件夹的笔记数量的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表删除记录后触发，条件是原文件夹的NoteColumns.NOTES_COUNT大于0时，减少其数量，基于原笔记所属文件夹ID进行操作。
|
|
|
*/
|
|
|
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
|
|
|
"CREATE TRIGGER decrease_folder_count_on_delete " +
|
|
|
" AFTER DELETE ON " + TABLE.NOTE +
|
|
|
" BEGIN " +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
|
|
|
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
|
|
|
" AND " + NoteColumns.NOTES_COUNT + ">0;" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当向数据表（TABLE.DATA）插入类型为{@link DataConstants#NOTE}的数据时，更新对应笔记的内容（NoteColumns.SNIPPET字段）的触发器SQL语句。
|
|
|
* 在TABLE.DATA表插入记录后触发，且插入的数据类型符合条件时，将对应笔记的内容设置为新插入数据的内容（DataColumns.CONTENT字段）。
|
|
|
*/
|
|
|
private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
|
|
|
"CREATE TRIGGER update_note_content_on_insert " +
|
|
|
" AFTER INSERT ON " + TABLE.DATA +
|
|
|
" WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
|
|
|
" BEGIN" +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
|
|
|
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当数据表（TABLE.DATA）中类型为{@link DataConstants#NOTE}的数据发生更新时，更新对应笔记的内容（NoteColumns.SNIPPET字段）的触发器SQL语句。
|
|
|
* 在TABLE.DATA表更新记录且符合数据类型条件时，将对应笔记的内容更新为新的数据内容（DataColumns.CONTENT字段）。
|
|
|
*/
|
|
|
private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
|
|
|
"CREATE TRIGGER update_note_content_on_update " +
|
|
|
" AFTER UPDATE ON " + TABLE.DATA +
|
|
|
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
|
|
|
" BEGIN" +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
|
|
|
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当数据表（TABLE.DATA）中类型为{@link DataConstants#NOTE}的数据被删除时，更新对应笔记的内容（NoteColumns.SNIPPET字段）为默认空值的触发器SQL语句。
|
|
|
* 在TABLE.DATA表删除记录且符合数据类型条件时，将对应笔记的内容设置为空字符串。
|
|
|
*/
|
|
|
private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
|
|
|
"CREATE TRIGGER update_note_content_on_delete " +
|
|
|
" AFTER delete ON " + TABLE.DATA +
|
|
|
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
|
|
|
" BEGIN" +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.SNIPPET + "=''" +
|
|
|
" WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当笔记被删除后，删除与之关联的数据表（TABLE.DATA）中属于该笔记的数据的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表删除记录后触发，通过删除语句从TABLE.DATA表中删除NoteColumns.ID与被删除笔记的ID匹配的数据记录。
|
|
|
*/
|
|
|
private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
|
|
|
"CREATE TRIGGER delete_data_on_delete " +
|
|
|
" AFTER DELETE ON " + TABLE.NOTE +
|
|
|
" BEGIN" +
|
|
|
" DELETE FROM " + TABLE.DATA +
|
|
|
" WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当文件夹被删除后，删除该文件夹下所有笔记的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表删除记录（即文件夹记录被删除）后触发，通过删除语句从TABLE.NOTE表中删除NoteColumns.PARENT_ID与被删除文件夹的ID匹配的笔记记录。
|
|
|
*/
|
|
|
private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
|
|
|
"CREATE TRIGGER folder_delete_notes_on_delete " +
|
|
|
" AFTER DELETE ON " + TABLE.NOTE +
|
|
|
" BEGIN" +
|
|
|
" DELETE FROM " + TABLE.NOTE +
|
|
|
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
/**
|
|
|
* 当文件夹被移动到回收站文件夹（更新NoteColumns.PARENT_ID字段）后，将该文件夹下所有笔记也移动到回收站文件夹的触发器SQL语句。
|
|
|
* 在TABLE.NOTE表更新记录且新的父文件夹ID为回收站文件夹ID（Notes.ID_TRASH_FOLER）时触发，将对应笔记的父文件夹ID都更新为回收站文件夹ID。
|
|
|
*/
|
|
|
private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
|
|
|
"CREATE TRIGGER folder_move_notes_on_trash " +
|
|
|
" AFTER UPDATE ON " + TABLE.NOTE +
|
|
|
" WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
|
|
|
" BEGIN" +
|
|
|
" UPDATE " + TABLE.NOTE +
|
|
|
" SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
|
|
|
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
|
|
|
" END";
|
|
|
|
|
|
// NotesDatabaseHelper构造函数，调用父类（SQLiteOpenHelper）的构造函数，传入上下文、数据库名、游标工厂（这里为null）和数据库版本号
|
|
|
public NotesDatabaseHelper(Context context) {
|
|
|
super(context, DB_NAME, null, DB_VERSION);
|
|
|
}
|
|
|
|
|
|
// 创建笔记表的方法，接收一个SQLiteDatabase实例，通过执行CREATE_NOTE_TABLE_SQL语句创建表，
|
|
|
// 然后重新创建笔记表相关的触发器，并创建系统文件夹，最后记录日志表示笔记表已创建成功
|
|
|
public void createNoteTable(SQLiteDatabase db) {
|
|
|
db.execSQL(CREATE_NOTE_TABLE_SQL);
|
|
|
reCreateNoteTableTriggers(db);
|
|
|
createSystemFolder(db);
|
|
|
Log.d(TAG, "note table has been created");
|
|
|
}
|
|
|
|
|
|
// 重新创建笔记表相关触发器的方法，先删除已存在的同名触发器（如果有），然后再执行创建各触发器的SQL语句，
|
|
|
// 这样可以确保触发器的定义是最新的，避免因数据库结构变化等原因导致的问题
|
|
|
private void reCreateNoteTableTriggers(SQLiteDatabase db) {
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS delete_data_on_delete");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_insert");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS folder_delete_notes_on_delete");
|
|
|
db.execSQL("DROP TRIGGER IF EXISTS folder_move_notes_on_trash");
|
|
|
|
|
|
db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
|
|
|
db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
|
|
|
db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER);
|
|
|
db.execSQL(NOTE_DELETE_DATA_ON_DELETE_TRIGGER);
|
|
|
db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER);
|
|
|
db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER);
|
|
|
db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
|
|
|
}
|
|
|
|
|
|
// 创建系统文件夹的方法，通过向笔记表（TABLE.NOTE）插入不同类型的系统文件夹记录来实现，
|
|
|
// 每个文件夹记录设置了相应的ID和类型（Notes.TYPE_SYSTEM），用于构建应用中的默认文件夹结构
|
|
|
private void createSystemFolder(SQLiteDatabase db) {
|
|
|
ContentValues values = new ContentValues();
|
|
|
|
|
|
/**
|
|
|
* 通话记录文件夹，用于存放通话相关的笔记（这里假设是相关功能用途）
|
|
|
*/
|
|
|
values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
|
|
|
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
|
|
|
db.insert(TABLE.NOTE, null, values);
|
|
|
|
|
|
/**
|
|
|
* 根文件夹，作为默认的顶级文件夹
|
|
|
*/
|
|
|
values.clear();
|
|
|
values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
|
|
|
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
|
|
|
db.insert(TABLE.NOTE, null, values);
|
|
|
|
|
|
/**
|
|
|
* 临时文件夹，可能用于在笔记移动等操作过程中的临时存放
|
|
|
*/
|
|
|
values.clear();
|
|
|
values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
|
|
|
values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); |
