diff --git a/.gradle/8.0/fileHashes/fileHashes.lock b/.gradle/8.0/fileHashes/fileHashes.lock index 3db30b7..43781ec 100644 Binary files a/.gradle/8.0/fileHashes/fileHashes.lock and b/.gradle/8.0/fileHashes/fileHashes.lock differ diff --git a/app/src/main/java/net/micode/notes/data/Contact.java b/app/src/main/java/net/micode/notes/data/Contact.java index 4460cba..c1b8d27 100644 --- a/app/src/main/java/net/micode/notes/data/Contact.java +++ b/app/src/main/java/net/micode/notes/data/Contact.java @@ -3,16 +3,14 @@ package net.micode.notes.data; // 导入的类 -import android.content.Context; -import android.database.Cursor; -import android.provider.ContactsContract.CommonDataKinds.Phone; -import android.provider.ContactsContract.Data; -import android.telephony.PhoneNumberUtils; -import android.util.Log; -import java.util.HashMap; - -// 联系人类，用于管理联系人信息 +import android.content.Context; // 提供应用程序环境的全局信息，如资源、启动活动、接收广播等 +import android.database.Cursor; // 用于对数据库查询结果进行读取和遍历的接口 +import android.provider.ContactsContract.CommonDataKinds.Phone; // 定义联系人电话信息的数据结构和常量 +import android.provider.ContactsContract.Data; // 定义用于访问Android联系人数据表的常量 +import android.telephony.PhoneNumberUtils; // 提供电话号码相关的实用程序方法，如格式化 +import android.util.Log; // Android日志工具类，用于打印日志信息 +import java.util.HashMap;// 联系人类，用于管理联系人信息 public class Contact { // 缓存联系人名称与电话号码的映射关系 private static HashMap sContactCache; @@ -73,3 +71,19 @@ public class Contact { } } } +//用于与联系人相关数据交互的助手类。该类主要目的是从设备的联系人数据库中检索并缓存联系人名称。 +// +//核心操作是 `getContact` 函数，它检查给定电话号码是否已缓存。如果没有，在联系人数据库中查找匹配的联系人，并将结果缓存以加速后续查询。 +// +//以下是对这段代码的解释和注释： +// +//- `Context` 类是Android应用程序的环境信息接口，通过它可以访问资源、启动活动或服务等。 +//- `Cursor` 提供了遍历数据库查询结果集的接口。 +//- `ContactsContract.CommonDataKinds.Phone` 和 `ContactsContract.Data` 提供了访问联系人相关数据的特定字段和常量。 +//- `PhoneNumberUtils` 包含了一些与电话号码操作相关的辅助函数，如格式化电话号码。 +//- `Log` 用于输出调试信息。 +//- `HashMap` 用于缓存电话号码和联系人名称的对应关系。 +// +//在 `getContact` 函数中，代码通过查询Android的联系人数据库来获取电话号码对应的显示名称。查询使用了特定的选择字符串 `CALLER_ID_SELECTION`，其中采用了匹配电话号码的过滤条件。 +// +//当找到匹配的电话号码时，联系人名称会被放入缓存中并返回。如果没有找到匹配项或查询过程中发生异常，将会记录相应的日志。 \ No newline at end of file diff --git a/app/src/main/java/net/micode/notes/data/Notes.java b/app/src/main/java/net/micode/notes/data/Notes.java index 6732146..5608143 100644 --- a/app/src/main/java/net/micode/notes/data/Notes.java +++ b/app/src/main/java/net/micode/notes/data/Notes.java @@ -18,7 +18,7 @@ // 包声明，指定这个文件属于哪个包 package net.micode.notes.data; -// 导入所需的类 +// 用于表示网络和文件系统中的统一资源标识符（URI）。它通常用于在Android应用程序中处理URL和文件路径。 import android.net.Uri; // 定义一个公开的 Notes 类，用于管理笔记相关的数据和常量 @@ -31,7 +31,7 @@ public class Notes { // 定义不同类型的笔记 public static final int TYPE_NOTE = 0; // 普通笔记类型 - public static final int TYPE_FOLDER = 1; // 文件夹类型 + public static final int TYPE_FOLDER = 1; // 文件夹类型，用于组织笔记 public static final int TYPE_SYSTEM = 2; // 系统文件夹类型 // 系统文件夹的标识符 diff --git a/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java b/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java index c106a33..7d4eb31 100644 --- a/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java +++ b/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java @@ -19,111 +19,388 @@ package net.micode.notes.data; // 导入所需的类 +// 导入ContentValues类，用于存储和传递以键值对形式存储的数据，便于操作数据库中的行 import android.content.ContentValues; +// 导入Context类，代表应用程序环境的上下文，可以访问应用级别的资源、类和服务 import android.content.Context; +// 导入SQLiteDatabase类，代表SQLite数据库的一个实例，提供创建、查询、更新和删除数据库中数据的方法 import android.database.sqlite.SQLiteDatabase; +// 导入SQLiteOpenHelper类，用于管理数据库的创建和版本管理，是SQLite数据库访问的一个辅助类 import android.database.sqlite.SQLiteOpenHelper; +// 导入Log类，用于输出日志，方便调试和测试 import android.util.Log; +// 导入DataColumns接口，定义了Notes数据库中data表的数据库列名和类型 import net.micode.notes.data.Notes.DataColumns; +// 导入DataConstants类，定义了与Notes数据相关联的一些常量值 import net.micode.notes.data.Notes.DataConstants; +// 导入NoteColumns接口，定义了Notes数据库中note表的数据库列名和类型 import net.micode.notes.data.Notes.NoteColumns; // 创建一个数据库帮助类，用于处理记事本应用的数据库创建和版本管理 public class NotesDatabaseHelper extends SQLiteOpenHelper { // 定义数据库的名称和版本 private static final String DB_NAME = "note.db"; - private static final int DB_VERSION = 4; + private static final int DB_VERSION = 4; // 定义表名的常量接口 + public interface TABLE { public static final String NOTE = "note"; + public static final String DATA = "data"; } - // 日志记录的标签 - private static final String TAG = "NotesDatabaseHelper"; + private static final String TAG = "NotesDatabaseHelper"; // 使用单例模式，保证只有一个实例化对象 - private static NotesDatabaseHelper mInstance; + private static NotesDatabaseHelper mInstance; // 包含创建Note表SQL语句的字符串 - private static final String CREATE_NOTE_TABLE_SQL = - // 使用“CREATE TABLE”SQL命令创建note表。为Note表定义列名和列类型。 - // Note表用来存储记事本的信息，例如ID、父ID、创建日期、修改日期等。 - "..."; + 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" + + ")"; // 包含创建Data表SQL语句的字符串 - private static final String CREATE_DATA_TABLE_SQL = - // 使用“CREATE TABLE”SQL命令创建data表。为Data表定义列名和列类型。 - // Data表用来存储note的内容和附件信息等。 - "..."; + 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 ''" + + ")"; // 包含创建Data的Note表索引SQL语句的字符串 + private static final String CREATE_DATA_NOTE_ID_INDEX_SQL = "CREATE INDEX IF NOT EXISTS note_id_index ON " + TABLE.DATA + "(" + DataColumns.NOTE_ID + ");"; + /** + * Increase folder's note count when move note to the folder + */ // 包含创建触发器的SQL语句的字符串 // 触发器用于在更新、插入或删除note时自动更新相关的信息。 - private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER = "..."; - private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER = "..."; - private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER = "..."; - private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER = "..."; - // ...更多触发器定义省略 + 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"; + /** + * Decrease folder's note count when move note from folder + */ + //在更新笔记的PARENT_ID字段后，更新父文件夹的NOTES_COUNT字段，将其减少1。 + 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"; + + /** + * Increase folder's note count when insert new note to the folder + */ + //在插入新笔记到文件夹时，更新父文件夹的NOTES_COUNT字段，将其增加1。 + 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"; + + /** + * Decrease folder's note count when delete note from the folder + */ + //在从文件夹中删除笔记时，更新父文件夹的NOTES_COUNT字段，将其减少1。 + 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"; + + /** + * Update note's content when insert data with type {@link DataConstants#NOTE} + */ + //在插入类型为"NOTE"的新数据时，更新笔记的内容。 + 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"; + + /** + * Update note's content when data with {@link DataConstants#NOTE} type has changed + */ + //当类型为"NOTE"的数据发生更改时，更新笔记的内容。 + 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"; + + /** + * Update note's content when data with {@link DataConstants#NOTE} type has deleted + */ + //当类型为"NOTE"的数据被删除时，更新笔记的内容。 + 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"; + + /** + * Delete datas belong to note which has been deleted + */ + //当删除一个笔记时，删除与该笔记关联的数据。 + 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"; + + /** + * Delete notes belong to folder which has been deleted + */ + //当删除一个文件夹时，删除属于该文件夹的所有笔记。 + 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"; + + /** + * Move notes belong to folder which has been moved to trash folder + */ + //当将一个文件夹移动到垃圾文件夹时，将属于该文件夹的所有笔记也移动到垃圾文件夹中。 + 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的公共构造函数。 // 需要传入Context对象来实例化SQLiteOpenHelper。 + public NotesDatabaseHelper(Context context) { super(context, DB_NAME, null, DB_VERSION); } - // 用于创建Note表的方法 + public void createNoteTable(SQLiteDatabase db) { db.execSQL(CREATE_NOTE_TABLE_SQL); reCreateNoteTableTriggers(db); createSystemFolder(db); Log.d(TAG, "note table has been created"); } + //方法用于重新创建笔记表的触发器。它首先删除现有的触发器， + // 然后执行一系列的CREATE TRIGGER语句来创建新的触发器。 + 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); + } + //用于创建系统文件夹。它向NOTE表中插入了一些系统文件夹的记录， + // 包括通话记录文件夹、根文件夹、临时文件夹和垃圾文件夹。 + private void createSystemFolder(SQLiteDatabase db) { + ContentValues values = new ContentValues(); - // ... 类的其他部分包括更多触发器的创建、重建、以及表的升级方法已经省略。 + /** + * call record foler for call notes + */ + values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER); + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); + db.insert(TABLE.NOTE, null, values); + /** + * root folder which is default folder + */ + values.clear(); + values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER); + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); + db.insert(TABLE.NOTE, null, values); + + /** + * temporary folder which is used for moving note + */ + values.clear(); + values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER); + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); + db.insert(TABLE.NOTE, null, values); + + /** + * create trash folder + */ + values.clear(); + values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER); + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); + db.insert(TABLE.NOTE, null, values); + } + //用于创建数据表。它首先执行一个CREATE TABLE语句来创建数据表， + // 然后调用reCreateDataTableTriggers方法来重新创建数据表的触发器。 + public void createDataTable(SQLiteDatabase db) { + db.execSQL(CREATE_DATA_TABLE_SQL); + reCreateDataTableTriggers(db); + db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL); + Log.d(TAG, "data table has been created"); + } + //用于重新创建数据表的触发器。 + private void reCreateDataTableTriggers(SQLiteDatabase db) { + db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert"); + db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update"); + db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete"); + + db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER); + db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER); + db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER); + } // getInstance方法用于获取NotesDatabaseHelper的单例对象。 // 如果还没有创建，它会创建一个新的实例并返回；如果已经创建，它将返回现有实例。 + static synchronized NotesDatabaseHelper getInstance(Context context) { if (mInstance == null) { mInstance = new NotesDatabaseHelper(context); } return mInstance; } + // 当数据库首次创建时调用onCreate方法。这个方法里调用前面定义的创建表的方法 - // 当数据库首次创建时调用onCreate方法。这个方法里调用前面定义的创建表的方法。 @Override public void onCreate(SQLiteDatabase db) { createNoteTable(db); createDataTable(db); } - // 如果数据库版本升级，onUpgrade方法将被调用。 // 这个方法包含多种情况下的升级逻辑，以确保数据库结构是最新的。 + @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { - // ... 升级相关代码已省略 - } + boolean reCreateTriggers = false; + boolean skipV2 = false; + + if (oldVersion == 1) { + upgradeToV2(db); + skipV2 = true; // this upgrade including the upgrade from v2 to v3 + oldVersion++; + } + + if (oldVersion == 2 && !skipV2) { + upgradeToV3(db); + reCreateTriggers = true; + oldVersion++; + } + if (oldVersion == 3) { + upgradeToV4(db); + oldVersion++; + } + + if (reCreateTriggers) { + reCreateNoteTableTriggers(db); + reCreateDataTableTriggers(db); + } + + if (oldVersion != newVersion) { + throw new IllegalStateException("Upgrade notes database to version " + newVersion + + "fails"); + } + } // 包含从数据库版本1升级到版本2的方法。 + private void upgradeToV2(SQLiteDatabase db) { - // ... 升级逻辑已省略 + db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE); + db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA); + createNoteTable(db); + createDataTable(db); } - // 包含从数据库版本2升级到版本3的方法。 + private void upgradeToV3(SQLiteDatabase db) { - // ... 升级逻辑已省略 + // drop unused triggers + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert"); + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete"); + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update"); + // add a column for gtask id + db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID + + " TEXT NOT NULL DEFAULT ''"); + // add a trash system folder + ContentValues values = new ContentValues(); + values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER); + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); + db.insert(TABLE.NOTE, null, values); } - // 包含从数据库版本3升级到版本4的方法。 + private void upgradeToV4(SQLiteDatabase db) { - // ... 升级逻辑已省略 + db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION + + " INTEGER NOT NULL DEFAULT 0"); } } diff --git a/app/src/main/java/net/micode/notes/data/NotesProvider.java b/app/src/main/java/net/micode/notes/data/NotesProvider.java index edb0a60..f3ab4a7 100644 --- a/app/src/main/java/net/micode/notes/data/NotesProvider.java +++ b/app/src/main/java/net/micode/notes/data/NotesProvider.java @@ -14,9 +14,10 @@ * limitations under the License. */ +// 定义应用程序的数据包名 package net.micode.notes.data; - +// 导入安卓系统类准备数据库和URI操作 import android.app.SearchManager; import android.content.ContentProvider; import android.content.ContentUris; @@ -29,18 +30,22 @@ import android.net.Uri; import android.text.TextUtils; import android.util.Log; +// 导入自定义类用于数据库字段和资源引用 import net.micode.notes.R; import net.micode.notes.data.Notes.DataColumns; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.data.NotesDatabaseHelper.TABLE; - public class NotesProvider extends ContentProvider { + // URI匹配器，用于匹配传入的URI到指定操作 private static final UriMatcher mMatcher; + // SQLite数据库辅助类实例 private NotesDatabaseHelper mHelper; + // Log的标签 private static final String TAG = "NotesProvider"; + // 定义URI类型的常量 private static final int URI_NOTE = 1; private static final int URI_NOTE_ITEM = 2; @@ -49,6 +54,7 @@ public class NotesProvider extends ContentProvider { private static final int URI_SEARCH = 5; private static final int URI_SEARCH_SUGGEST = 6; + // 在静态初始化块中初始化URI匹配器，并将不同类型的URI添加到匹配器 static { mMatcher = new UriMatcher(UriMatcher.NO_MATCH); @@ -65,6 +71,7 @@ public class NotesProvider extends ContentProvider { * x'0A' represents the '\n' character in sqlite. For title and content in the search result, * we will trim '\n' and white space in order to show more information. */ + // 定义用于搜索提议和搜索查询的SQL语句，移除字符串中的换行，并配置各列属性 private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + "," + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + "," + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + "," @@ -78,12 +85,14 @@ public class NotesProvider extends ContentProvider { + " WHERE " + NoteColumns.SNIPPET + " LIKE ?" + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE; + // 当ContentProvider被创建时会调用onCreate，并初始化DatabaseHelper @Override public boolean onCreate() { mHelper = NotesDatabaseHelper.getInstance(getContext()); return true; } + // 实现ContentProvider的query方法，针对不同类型的URI执行不同的查询 @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, @@ -146,6 +155,7 @@ public class NotesProvider extends ContentProvider { } return c; } + // 实现ContentProvider的insert方法，根据不同URI在相应的表中插入数据 @Override public Uri insert(Uri uri, ContentValues values) { @@ -180,6 +190,7 @@ public class NotesProvider extends ContentProvider { return ContentUris.withAppendedId(uri, insertedId); } + // 实现ContentProvider的delete方法，根据不同URI从相应的表中删除数据 @Override public int delete(Uri uri, String selection, String[] selectionArgs) { @@ -226,6 +237,7 @@ public class NotesProvider extends ContentProvider { } return count; } + // 实现ContentProvider的update方法，根据不同URI更新相应表中的数据 @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { @@ -266,10 +278,12 @@ public class NotesProvider extends ContentProvider { } return count; } + // 将额外的筛选条件附加到SQL查询的WHERE子句，用于SQL构建 private String parseSelection(String selection) { return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""); } + // 当执行更新操作时增加笔记的版本，用于更新追踪更改 private void increaseNoteVersion(long id, String selection, String[] selectionArgs) { StringBuilder sql = new StringBuilder(120); @@ -295,7 +309,7 @@ public class NotesProvider extends ContentProvider { mHelper.getWritableDatabase().execSQL(sql.toString()); } - + // 根据传入的URI返回相应的MIME类型 @Override public String getType(Uri uri) { // TODO Auto-generated method stub @@ -303,3 +317,6 @@ public class NotesProvider extends ContentProvider { } } +//数据管理，包括创建、查询、更新和删除笔记和相关数据。它采用 `UriMatcher` 来识别不同的请求类型， +// 实现了数据的CRUD操作。代码中也定义了触发器来自动更新关联数据，如删除笔记时级联删除相关数据等，以确保数据一致性。 + diff --git a/app/src/main/java/net/micode/notes/data/草稿.java b/app/src/main/java/net/micode/notes/data/草稿.java new file mode 100644 index 0000000..e69de29