Node.java

src/Notes-master/Notes-master/src/net/micode/notes/gtask/data/Node.java

@@ -16,37 +16,33 @@
 
 package net.micode.notes.gtask.data;
 
-import android.database.Cursor;
-
 import org.json.JSONObject;
 
+/**
+ * Node类是一个抽象类，代表数据结构中的一个节点，可用于任务或笔记同步。
+ * 它提供了一系列同步操作的常量和处理同步过程的方法。
+ */
 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;
 
+    // 节点属性
     private String mGid;
-
     private String mName;
-
     private long mLastModified;
-
     private boolean mDeleted;
 
+    /**
+     * 构造一个新的Node，默认值为空。
+     */
     public Node() {
         mGid = null;
         mName = "";
@@ -54,18 +50,37 @@ public abstract class Node {
         mDeleted = false;
     }
 
+    /**
+     * 返回代表此节点创建操作的JSONObject。
+     */
     public abstract JSONObject getCreateAction(int actionId);
 
+    /**
+     * 返回代表此节点更新操作的JSONObject。
+     */
     public abstract JSONObject getUpdateAction(int actionId);
 
+    /**
+     * 根据远程JSON对象设置此节点的内容。
+     */
     public abstract void setContentByRemoteJSON(JSONObject js);
 
+    /**
+     * 根据本地JSON对象设置此节点的内容。
+     */
     public abstract void setContentByLocalJSON(JSONObject js);
 
+    /**
+     * 返回代表此节点本地内容的JSONObject。
+     */
     public abstract JSONObject getLocalJSONFromContent();
 
+    /**
+     * 根据Cursor确定此节点的同步操作。
+     */
     public abstract int getSyncAction(Cursor c);
 
+    // 节点属性的getter和setter方法
     public void setGid(String gid) {
         this.mGid = gid;
     }
@@ -97,5 +112,4 @@ public abstract class Node {
     public boolean getDeleted() {
         return this.mDeleted;
     }
-
-}
+}