注释main/java/net/micode/notes/gtask/data/Node.java

src/main/java/net/micode/notes/gtask/data/Node.java

@@ -17,36 +17,48 @@
 package net.micode.notes.gtask.data;
 
 import android.database.Cursor;
-
 import org.json.JSONObject;
 
+/**
+ * 抽象节点基类，定义同步任务数据节点的通用属性和行为
+ * 作为所有同步实体（如笔记、任务、子任务等）的父类
+ * 包含同步动作类型定义和基础数据字段管理
+ */
 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_ADD_LOCAL = 2;
-
+    /** 需要删除远程服务器条目 */
     public static final int SYNC_ACTION_DEL_REMOTE = 3;
-
+    /** 需要删除本地数据库条目 */
     public static final int SYNC_ACTION_DEL_LOCAL = 4;
-
+    /** 需要更新远程服务器条目 */
     public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
-
+    /** 需要更新本地数据库条目 */
     public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
-
+    /** 检测到数据冲突需要处理 */
     public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
-
+    /** 同步过程发生错误 */
     public static final int SYNC_ACTION_ERROR = 8;
 
+    // 节点基础属性
+    /** Google Task服务器分配的唯一标识符 */
     private String mGid;
-
+    /** 节点显示名称 */
     private String mName;
-
+    /** 最后修改时间戳（毫秒级） */
     private long mLastModified;
-
+    /** 删除标记（逻辑删除） */
     private boolean mDeleted;
 
+    /**
+     * 节点构造函数
+     * 初始化默认值：gid=null, 名称为空字符串，最后修改时间为0，未删除状态
+     */
     public Node() {
         mGid = null;
         mName = "";
@@ -54,48 +66,86 @@ public abstract class Node {
         mDeleted = false;
     }
 
+    // 抽象方法定义（需子类实现）
+
+    /**
+     * 生成创建动作的JSON数据包
+     * @param actionId 动作标识符（用于保证操作序列）
+     * @return 包含创建指令的JSON对象
+     */
     public abstract JSONObject getCreateAction(int actionId);
 
+    /**
+     * 生成更新动作的JSON数据包
+     * @param actionId 动作标识符
+     * @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常量）
+     */
     public abstract int getSyncAction(Cursor c);
 
+    // 属性访问方法
+
+    /** 设置Google Task服务器ID */
     public void setGid(String gid) {
         this.mGid = gid;
     }
 
+    /** 设置节点名称 */
     public void setName(String name) {
         this.mName = name;
     }
 
+    /** 设置最后修改时间戳 */
     public void setLastModified(long lastModified) {
         this.mLastModified = lastModified;
     }
 
+    /** 设置删除标记 */
     public void setDeleted(boolean deleted) {
         this.mDeleted = deleted;
     }
 
+    /** 获取Google Task服务器ID */
     public String getGid() {
         return this.mGid;
     }
 
+    /** 获取节点名称 */
     public String getName() {
         return this.mName;
     }
 
+    /** 获取最后修改时间戳 */
     public long getLastModified() {
         return this.mLastModified;
     }
 
+    /** 获取删除状态 */
     public boolean getDeleted() {
         return this.mDeleted;
     }
-
 }