From c80dcb451bcb0d8cb6dcddcb1d50538ed89ace70 Mon Sep 17 00:00:00 2001 From: pasky49wx <1515867307@qq.com> Date: Thu, 15 May 2025 15:34:49 +0800 Subject: [PATCH] Update Node.java --- .../src/net/micode/notes/gtask/data/Node.java | 74 +++++++++++++------ 1 file changed, 53 insertions(+), 21 deletions(-) diff --git a/源程序代码-小米便签-Notes-master/Notes-master/src/net/micode/notes/gtask/data/Node.java b/源程序代码-小米便签-Notes-master/Notes-master/src/net/micode/notes/gtask/data/Node.java index 63950e0..3aedcf5 100644 --- a/源程序代码-小米便签-Notes-master/Notes-master/src/net/micode/notes/gtask/data/Node.java +++ b/源程序代码-小米便签-Notes-master/Notes-master/src/net/micode/notes/gtask/data/Node.java @@ -19,34 +19,40 @@ package net.micode.notes.gtask.data; import android.database.Cursor; import org.json.JSONObject; - +/** + * 同步节点抽象类，定义同步操作的基础模型和行为 + * 用于表示Google Tasks中的任务、列表等实体的同步状态和数据 + */ public abstract class Node { - public static final int SYNC_ACTION_NONE = 0; - - public static final int SYNC_ACTION_ADD_REMOTE = 1; + // 同步操作类型常量定义 + public static final int SYNC_ACTION_NONE = 0;// 无操作 - public static final int SYNC_ACTION_ADD_LOCAL = 2; + public static final int SYNC_ACTION_ADD_REMOTE = 1;// 远程添加 - public static final int SYNC_ACTION_DEL_REMOTE = 3; + public static final int SYNC_ACTION_ADD_LOCAL = 2;// 本地添加 - public static final int SYNC_ACTION_DEL_LOCAL = 4; + public static final int SYNC_ACTION_DEL_REMOTE = 3;// 远程删除 - public static final int SYNC_ACTION_UPDATE_REMOTE = 5; + public static final int SYNC_ACTION_DEL_LOCAL = 4;// 本地删除 - public static final int SYNC_ACTION_UPDATE_LOCAL = 6; + public static final int SYNC_ACTION_UPDATE_REMOTE = 5;// 远程更新 - public static final int SYNC_ACTION_UPDATE_CONFLICT = 7; + public static final int SYNC_ACTION_UPDATE_LOCAL = 6;// 本地更新 - public static final int SYNC_ACTION_ERROR = 8; + public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;// 更新冲突 - private String mGid; + public static final int SYNC_ACTION_ERROR = 8;// 操作错误 + // 节点核心属性 + private String mGid;// Google Tasks全局唯一标识符（GID - private String mName; + private String mName;// 节点名称（如任务标题、列表名称） - private long mLastModified; - - private boolean mDeleted; + private long mLastModified;// 最后修改时间戳 + private boolean mDeleted;// 是否已删除标记 + /** + * 构造方法，初始化节点默认状态 + */ public Node() { mGid = null; mName = ""; @@ -54,18 +60,44 @@ public abstract class Node { mDeleted = false; } - public abstract JSONObject getCreateAction(int actionId); + // ====================== 抽象方法（子类必须实现） ====================== + /** + * 获取创建操作的JSON数据 + * @param actionId 操作ID，用于标识不同的创建场景 + * @return 包含创建操作的JSON对象 + */ + public abstract JSONObject getCreateAction(int actionId); + /** + * 获取更新操作的JSON数据 + * @param actionId 操作ID，用于标识不同的更新场景 + * @return 包含更新操作的JSON对象 + */ public abstract JSONObject getUpdateAction(int actionId); - + /** + * 从远程JSON数据中解析并设置节点内容（供同步模块调用） + * @param js 包含远程数据的JSON对象 + */ public abstract void setContentByRemoteJSON(JSONObject js); - + /** + * 从本地JSON数据中解析并设置节点内容（供本地存储模块调用） + * @param js 包含本地数据的JSON对象 + */ public abstract void setContentByLocalJSON(JSONObject js); - + /** + * 将节点内容转换为本地存储的JSON格式 + * @return 表示节点内容的JSON对象 + */ public abstract JSONObject getLocalJSONFromContent(); - + /** + * 获取节点的同步操作类型（根据数据库游标数据判断） + * @param c 包含节点数据的数据库游标 + * @return 同步操作类型常量（如SYNC_ACTION_ADD_LOCAL） + */ public abstract int getSyncAction(Cursor c); + // ====================== 基础属性访问方法 ====================== + public void setGid(String gid) { this.mGid = gid; }