Update Node.java

源程序代码-小米便签-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;
     }