diff --git a/doc/~$开源代码阅读.docx b/doc/~$开源代码阅读.docx new file mode 100644 index 0000000..e0f6beb Binary files /dev/null and b/doc/~$开源代码阅读.docx differ diff --git a/src/Notes-master/src/net/micode/notes/data/Contact.java b/src/Notes-master/src/net/micode/notes/data/Contact.java index ea388b2..4389c06 100644 --- a/src/Notes-master/src/net/micode/notes/data/Contact.java +++ b/src/Notes-master/src/net/micode/notes/data/Contact.java @@ -26,7 +26,7 @@ import android.util.Log; import java.util.HashMap; /** - * 联系人工具类 + * 联系人工具 * 用于根据电话号码获取联系人名称,并使用缓存提高性能 */ public class Contact { diff --git a/src/Notes-master/src/net/micode/notes/data/Notes.java b/src/Notes-master/src/net/micode/notes/data/Notes.java index 6dd8a97..dbee197 100644 --- a/src/Notes-master/src/net/micode/notes/data/Notes.java +++ b/src/Notes-master/src/net/micode/notes/data/Notes.java @@ -19,7 +19,7 @@ package net.micode.notes.data; import android.net.Uri; /** - * 笔记应用的数据结构定义类 + * 笔记应用的数据结构定义 * 包含所有笔记相关的常量、接口和内部类定义 * 纯定义类,不包含函数实现 */ @@ -78,104 +78,87 @@ public class Notes { public interface NoteColumns { /** * 行的唯一ID - *
类型: INTEGER (long)
*/ public static final String ID = "_id"; /** * 笔记或文件夹的父级ID - *类型: INTEGER (long)
*/ public static final String PARENT_ID = "parent_id"; /** * 笔记或文件夹的创建日期 - *类型: INTEGER (long)
*/ public static final String CREATED_DATE = "created_date"; /** * 最近修改日期 - *类型: INTEGER (long)
*/ public static final String MODIFIED_DATE = "modified_date"; /** * 提醒日期 - *类型: INTEGER (long)
*/ public static final String ALERTED_DATE = "alert_date"; /** * 文件夹名称或笔记内容摘要 - *类型: TEXT
*/ public static final String SNIPPET = "snippet"; /** * 笔记关联的小组件ID - *类型: INTEGER (long)
*/ public static final String WIDGET_ID = "widget_id"; /** * 笔记关联的小组件类型 - *类型: INTEGER (long)
*/ public static final String WIDGET_TYPE = "widget_type"; /** * 笔记背景颜色ID - *类型: INTEGER (long)
*/ public static final String BG_COLOR_ID = "bg_color_id"; /** * 是否有附件标识 - *类型: INTEGER
* 对于文本笔记,没有附件;对于多媒体笔记,至少有一个附件 */ public static final String HAS_ATTACHMENT = "has_attachment"; /** * 文件夹中包含的笔记数量 - *类型: INTEGER (long)
*/ public static final String NOTES_COUNT = "notes_count"; /** * 文件类型:文件夹或笔记 - *类型: INTEGER
*/ public static final String TYPE = "type"; /** * 最后同步ID - *类型: INTEGER (long)
*/ public static final String SYNC_ID = "sync_id"; /** * 本地修改状态标识 - *类型: INTEGER
*/ public static final String LOCAL_MODIFIED = "local_modified"; /** * 移动到临时文件夹前的原始父级ID - *类型: INTEGER
*/ public static final String ORIGIN_PARENT_ID = "origin_parent_id"; /** * 谷歌任务ID - *类型: TEXT
*/ public static final String GTASK_ID = "gtask_id"; /** * 版本号 - *类型: INTEGER (long)
*/ public static final String VERSION = "version"; } @@ -186,67 +169,56 @@ public class Notes { public interface DataColumns { /** * 行的唯一ID - *类型: INTEGER (long)
*/ public static final String ID = "_id"; /** * 该行代表的项的MIME类型 - *类型: Text
*/ public static final String MIME_TYPE = "mime_type"; /** * 该数据所属的笔记ID - *类型: INTEGER (long)
*/ public static final String NOTE_ID = "note_id"; /** * 创建日期 - *类型: INTEGER (long)
*/ public static final String CREATED_DATE = "created_date"; /** * 最近修改日期 - *类型: INTEGER (long)
*/ public static final String MODIFIED_DATE = "modified_date"; /** * 数据内容 - *类型: TEXT
*/ public static final String CONTENT = "content"; /** * 通用数据列1,含义由{@link #MIMETYPE}决定,用于整数类型 - *类型: INTEGER
*/ public static final String DATA1 = "data1"; /** * 通用数据列2,含义由{@link #MIMETYPE}决定,用于整数类型 - *类型: INTEGER
*/ public static final String DATA2 = "data2"; /** * 通用数据列3,含义由{@link #MIMETYPE}决定,用于文本类型 - *类型: TEXT
*/ public static final String DATA3 = "data3"; /** * 通用数据列4,含义由{@link #MIMETYPE}决定,用于文本类型 - *类型: TEXT
*/ public static final String DATA4 = "data4"; /** * 通用数据列5,含义由{@link #MIMETYPE}决定,用于文本类型 - *类型: TEXT
*/ public static final String DATA5 = "data5"; } @@ -257,7 +229,6 @@ public class Notes { public static final class TextNote implements DataColumns { /** * 笔记模式:指示文本是否处于 checklist 模式 - *类型: Integer 1:checklist模式 0:普通模式
*/ public static final String MODE = DATA1; @@ -276,13 +247,11 @@ public class Notes { public static final class CallNote implements DataColumns { /** * 通话记录的通话日期 - *类型: INTEGER (long)
*/ public static final String CALL_DATE = DATA1; /** * 通话记录的电话号码 - *类型: TEXT
*/ public static final String PHONE_NUMBER = DATA3; diff --git a/src/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java b/src/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java index 9d11d9c..b06ea01 100644 --- a/src/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java +++ b/src/Notes-master/src/net/micode/notes/data/NotesDatabaseHelper.java @@ -27,7 +27,7 @@ import net.micode.notes.data.Notes.DataConstants; import net.micode.notes.data.Notes.NoteColumns; /** - * 笔记数据库帮助类 + * 笔记数据库帮助 * 负责数据库的创建、升级和维护 */ public class NotesDatabaseHelper extends SQLiteOpenHelper { @@ -65,7 +65,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper { NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," + NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" + - "); + ")"; // 创建笔记数据表的SQL语句 private static final String CREATE_DATA_TABLE_SQL = @@ -81,12 +81,12 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper { DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," + DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," + DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" + - "); + ")"; // 创建笔记数据表中note_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 + ");" + TABLE.DATA + "(" + DataColumns.NOTE_ID + ")"; /** * 当笔记移动到文件夹时增加文件夹的笔记计数 diff --git a/src/Notes-master/src/net/micode/notes/data/NotesProvider.java b/src/Notes-master/src/net/micode/notes/data/NotesProvider.java index fe3ccf3..69acdc6 100644 --- a/src/Notes-master/src/net/micode/notes/data/NotesProvider.java +++ b/src/Notes-master/src/net/micode/notes/data/NotesProvider.java @@ -36,7 +36,7 @@ import net.micode.notes.data.NotesDatabaseHelper.TABLE; /** - * 笔记内容提供者类 + * 笔记内容提供者 * 负责处理笔记和数据的CRUD操作,提供ContentProvider接口 * 支持搜索和搜索建议功能 */ diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/MetaData.java b/src/Notes-master/src/net/micode/notes/gtask/data/MetaData.java index 47e11e3..e268f87 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/MetaData.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/MetaData.java @@ -26,7 +26,7 @@ import org.json.JSONObject; /** - * 元数据类 - 继承自Task类 + * 元数据 - 继承自Task * 用于处理Google任务的元数据信息 */ public class MetaData extends Task { diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/Node.java b/src/Notes-master/src/net/micode/notes/gtask/data/Node.java index eb88d61..09a0dc8 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/Node.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/Node.java @@ -21,7 +21,7 @@ import android.database.Cursor; import org.json.JSONObject; /** - * 同步节点抽象类 - 定义了同步操作的基本结构和接口 + * 同步节点抽象 - 定义了同步操作的基本结构和接口 * 所有需要进行同步的对象都应该继承这个类 */ public abstract class Node { diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/SqlData.java b/src/Notes-master/src/net/micode/notes/gtask/data/SqlData.java index a11dcc8..04c3b71 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/SqlData.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/SqlData.java @@ -36,7 +36,7 @@ import org.json.JSONObject; /** - * SQL数据处理类 - 负责处理笔记数据的CRUD操作 + * SQL数据处理 - 负责处理笔记数据的CRUD操作 * 与ContentResolver交互,实现数据的加载、保存和更新 */ public class SqlData { diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/SqlNote.java b/src/Notes-master/src/net/micode/notes/gtask/data/SqlNote.java index bf7cbc3..0681b2d 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/SqlNote.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/SqlNote.java @@ -39,7 +39,7 @@ import java.util.ArrayList; /** - * SqlNote 类 - 用于管理笔记和相关数据的同步操作 + * SqlNote - 用于管理笔记和相关数据的同步操作 * 该类负责将笔记数据与 Google Tasks 进行同步,处理数据的创建、更新和删除操作 */ public class SqlNote { diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/Task.java b/src/Notes-master/src/net/micode/notes/gtask/data/Task.java index 54df06b..c368bd6 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/Task.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/Task.java @@ -33,7 +33,7 @@ import org.json.JSONObject; /** - * Task类 - 表示Google Tasks中的一个任务 + * Task - 表示Google Tasks中的一个任务 * 继承自Node类,扩展了任务特定的功能 */ public class Task extends Node { diff --git a/src/Notes-master/src/net/micode/notes/gtask/data/TaskList.java b/src/Notes-master/src/net/micode/notes/gtask/data/TaskList.java index 394ae8a..610651e 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/data/TaskList.java +++ b/src/Notes-master/src/net/micode/notes/gtask/data/TaskList.java @@ -31,7 +31,7 @@ import java.util.ArrayList; /** - * TaskList类 - 表示Google Tasks中的一个任务列表 + * TaskList - 表示Google Tasks中的一个任务列表 * 继承自Node类,包含任务列表的基本信息和子任务 */ public class TaskList extends Node { diff --git a/src/Notes-master/src/net/micode/notes/gtask/exception/ActionFailureException.java b/src/Notes-master/src/net/micode/notes/gtask/exception/ActionFailureException.java index caaf20f..7e3605b 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/exception/ActionFailureException.java +++ b/src/Notes-master/src/net/micode/notes/gtask/exception/ActionFailureException.java @@ -17,7 +17,7 @@ package net.micode.notes.gtask.exception; /** - * 操作失败异常类,用于表示Google Tasks同步操作失败的情况 + * 操作失败异常,用于表示Google Tasks同步操作失败的情况 */ public class ActionFailureException extends RuntimeException { /** 序列化版本UID */ diff --git a/src/Notes-master/src/net/micode/notes/gtask/exception/NetworkFailureException.java b/src/Notes-master/src/net/micode/notes/gtask/exception/NetworkFailureException.java index cb07b99..1b3ee32 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/exception/NetworkFailureException.java +++ b/src/Notes-master/src/net/micode/notes/gtask/exception/NetworkFailureException.java @@ -17,7 +17,7 @@ package net.micode.notes.gtask.exception; /** - * 网络失败异常类,用于表示Google Tasks同步过程中网络连接失败的情况 + * 网络失败异常,用于表示Google Tasks同步过程中网络连接失败的情况 */ public class NetworkFailureException extends Exception { /** 序列化版本UID */ diff --git a/src/Notes-master/src/net/micode/notes/gtask/remote/GTaskASyncTask.java b/src/Notes-master/src/net/micode/notes/gtask/remote/GTaskASyncTask.java index 5993ad1..9772ec8 100644 --- a/src/Notes-master/src/net/micode/notes/gtask/remote/GTaskASyncTask.java +++ b/src/Notes-master/src/net/micode/notes/gtask/remote/GTaskASyncTask.java @@ -30,7 +30,7 @@ import net.micode.notes.ui.NotesPreferenceActivity; /** - * GTaskASyncTask类 - 用于在后台执行Google Tasks同步操作的异步任务 + * GTaskASyncTask- 用于在后台执行Google Tasks同步操作的异步任务 */ public class GTaskASyncTask extends AsyncTask