1

src/小米标签代码/src/net/micode/notes/gtask/data/MetaData.java

@@ -24,59 +24,105 @@ import net.micode.notes.tool.GTaskStringUtils;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * MetaData类
+ * 元数据任务，用于存储与Google Task相关的元信息
+ * 继承自Task类，但仅用于存储元数据，不直接显示给用户
+ */
 public class MetaData extends Task {
+    // 日志标签
     private final static String TAG = MetaData.class.getSimpleName();
 
+    // 关联的Google Task ID
     private String mRelatedGid = null;
 
+    /**
+     * 设置元数据
+     * 将Google Task ID和元信息存储在笔记内容中
+     * @param gid Google Task ID
+     * @param metaInfo 元信息JSON对象
+     */
     public void setMeta(String gid, JSONObject metaInfo) {
         try {
+            // 将Google Task ID添加到元信息中
             metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
         } catch (JSONException e) {
             Log.e(TAG, "failed to put related gid");
         }
+        // 将元信息JSON字符串设置为笔记内容
         setNotes(metaInfo.toString());
+        // 设置任务名称为元数据笔记的特定名称
         setName(GTaskStringUtils.META_NOTE_NAME);
     }
 
+    /**
+     * 获取关联的Google Task ID
+     * @return Google Task ID
+     */
     public String getRelatedGid() {
         return mRelatedGid;
     }
 
+    /**
+     * 检查是否值得保存
+     * 只有当笔记内容不为空时才值得保存
+     * @return 是否值得保存
+     */
     @Override
     public boolean isWorthSaving() {
         return getNotes() != null;
     }
 
+    /**
+     * 从远程JSON设置内容
+     * 解析远程JSON数据，提取关联的Google Task ID
+     * @param js 远程JSON对象
+     */
     @Override
     public void setContentByRemoteJSON(JSONObject js) {
-        super.setContentByRemoteJSON(js);
+        super.setContentByRemoteJSON(js); // 调用父类方法设置基础内容
         if (getNotes() != null) {
             try {
+                // 从笔记内容中解析元信息JSON
                 JSONObject metaInfo = new JSONObject(getNotes().trim());
+                // 提取关联的Google Task ID
                 mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
             } catch (JSONException e) {
                 Log.w(TAG, "failed to get related gid");
-                mRelatedGid = null;
+                mRelatedGid = null; // 解析失败时设置为null
             }
         }
     }
 
+    /**
+     * 从本地JSON设置内容
+     * MetaData不应通过本地JSON设置内容，因此抛出异常
+     * @param js 本地JSON对象
+     */
     @Override
     public void setContentByLocalJSON(JSONObject js) {
-        // this function should not be called
+        // 此函数不应被调用，因为MetaData不应从本地JSON加载
         throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
     }
 
+    /**
+     * 从内容获取本地JSON
+     * MetaData不应生成本地JSON，因此抛出异常
+     * @return 本地JSON对象
+     */
     @Override
     public JSONObject getLocalJSONFromContent() {
         throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
     }
 
+    /**
+     * 获取同步动作
+     * MetaData不应进行同步操作，因此抛出异常
+     * @param c 数据库游标
+     * @return 同步动作类型
+     */
     @Override
     public int getSyncAction(Cursor c) {
         throw new IllegalAccessError("MetaData:getSyncAction should not be called");
     }
-
-}
+}