Task.java

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

@@ -31,6 +31,9 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
+/**
+ * Task类继承自Node类，代表一个任务实体。
+ */
 
 public class Task extends Node {
     private static final String TAG = Task.class.getSimpleName();
@@ -44,7 +47,9 @@ public class Task extends Node {
     private Task mPriorSibling;
 
     private TaskList mParent;
-
+  /**
+     * 构造一个新的Task实例。
+     */
     public Task() {
         super();
         mCompleted = false;
@@ -53,7 +58,9 @@ public class Task extends Node {
         mParent = null;
         mMetaInfo = null;
     }
-
+ /**
+     * 获取创建任务的行动JSON对象。
+     */
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
@@ -102,7 +109,9 @@ public class Task extends Node {
 
         return js;
     }
-
+ /**
+     * 获取更新任务的行动JSON对象。
+     */
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
@@ -134,7 +143,9 @@ public class Task extends Node {
 
         return js;
     }
-
+    /**
+     * 根据远程JSON对象设置任务内容。
+     */
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
@@ -175,6 +186,9 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 根据本地JSON对象设置任务内容。
+     */
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
                 || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
@@ -203,7 +217,9 @@ public class Task extends Node {
             e.printStackTrace();
         }
     }
-
+    /**
+     * 从任务内容获取本地JSON对象。
+     */
     public JSONObject getLocalJSONFromContent() {
         String name = getName();
         try {
@@ -246,7 +262,9 @@ public class Task extends Node {
             return null;
         }
     }
-
+  /**
+     * 设置任务的元数据信息。
+     */
     public void setMetaInfo(MetaData metaData) {
         if (metaData != null && metaData.getNotes() != null) {
             try {
@@ -257,7 +275,9 @@ public class Task extends Node {
             }
         }
     }
-
+    /**
+     * 根据游标确定任务的同步行动。
+     */
     public int getSyncAction(Cursor c) {
         try {
             JSONObject noteInfo = null;
@@ -311,6 +331,9 @@ public class Task extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    /**
+     * 判断任务是否值得保存。
+     */
     public boolean isWorthSaving() {
         return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
                 || (getNotes() != null && getNotes().trim().length() > 0);