diff --git a/src/net/micode/notes/gtask/data/Task.java b/src/net/micode/notes/gtask/data/Task.java index b2a5551..3b87056 100644 --- a/src/net/micode/notes/gtask/data/Task.java +++ b/src/net/micode/notes/gtask/data/Task.java @@ -35,15 +35,15 @@ import org.json.JSONObject; public class Task extends Node { private static final String TAG = Task.class.getSimpleName(); - private boolean mCompleted;//表示任务是否完成 + private boolean mCompleted;//琛ㄧず浠诲姟鏄惁瀹屾垚 - private String mNotes;//表示任务备注的字符串 + private String mNotes;//琛ㄧず浠诲姟澶囨敞鐨勫瓧绗︿覆 - private JSONObject mMetaInfo;//表示任务元信息的JSONObject对象 + private JSONObject mMetaInfo;//琛ㄧず浠诲姟鍏冧俊鎭殑JSONObject瀵硅薄 - private Task mPriorSibling;//表示任务前一个兄弟任务的Task对象 + private Task mPriorSibling;//琛ㄧず浠诲姟鍓嶄竴涓厔寮熶换鍔$殑Task瀵硅薄 - private TaskList mParent;//表示任务所属任务列表的TaskList对象 + private TaskList mParent;//琛ㄧず浠诲姟鎵灞炰换鍔″垪琛ㄧ殑TaskList瀵硅薄 public Task() { super(); @@ -52,23 +52,23 @@ public class Task extends Node { mPriorSibling = null; mParent = null; mMetaInfo = null; - }//初始化 + }//鍒濆鍖 public JSONObject getCreateAction(int actionId) { JSONObject js = new JSONObject(); try { - // action_type 表示动作类型为“创建” + // action_type 琛ㄧず鍔ㄤ綔绫诲瀷涓衡滃垱寤衡 js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE); - // action_id 表示该动作ID + // action_id 琛ㄧず璇ュ姩浣淚D js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - // index 表示Task在所属TaskList的位置 + // index 琛ㄧずTask鍦ㄦ墍灞濼askList鐨勪綅缃 js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this)); - // entity_delta 表示创建的Task的具体信息,包括名称,创建者ID,类型,笔记等 + // entity_delta 琛ㄧず鍒涘缓鐨凾ask鐨勫叿浣撲俊鎭紝鍖呮嫭鍚嶇О锛屽垱寤鸿匢D锛岀被鍨嬶紝绗旇绛 JSONObject entity = new JSONObject(); entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null"); @@ -79,17 +79,17 @@ public class Task extends Node { } js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity); - // parent_id 表示所属TaskList的ID + // parent_id 琛ㄧず鎵灞濼askList鐨処D js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid()); - // dest_parent_type 表示所属TaskList的类型 + // dest_parent_type 琛ㄧず鎵灞濼askList鐨勭被鍨 js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE, GTaskStringUtils.GTASK_JSON_TYPE_GROUP); - // list_id 表示所属TaskList的ID + // list_id 琛ㄧず鎵灞濼askList鐨処D js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid()); - // prior_sibling_id 表示排在该Task之前的兄弟Task的ID + // prior_sibling_id 琛ㄧず鎺掑湪璇ask涔嬪墠鐨勫厔寮烼ask鐨処D if (mPriorSibling != null) { js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid()); } @@ -101,23 +101,23 @@ public class Task extends Node { } return js; - }//返回JSONObject对象,表示用于创建该Task的动作 + }//杩斿洖JSONObject瀵硅薄锛岃〃绀虹敤浜庡垱寤鸿Task鐨勫姩浣 public JSONObject getUpdateAction(int actionId) { JSONObject js = new JSONObject(); try { - // action_type 操作类型(更新操作) + // action_type 鎿嶄綔绫诲瀷锛堟洿鏂版搷浣滐級 js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE); - // action_id 操作ID + // action_id 鎿嶄綔ID js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - // id 要更新的任务的ID + // id 瑕佹洿鏂扮殑浠诲姟鐨処D js.put(GTaskStringUtils.GTASK_JSON_ID, getGid()); - // entity_delta 更新的内容。包含了任务的名称、备注、是否已删除等信息。 + // entity_delta 鏇存柊鐨勫唴瀹广傚寘鍚簡浠诲姟鐨勫悕绉般佸娉ㄣ佹槸鍚﹀凡鍒犻櫎绛変俊鎭 JSONObject entity = new JSONObject(); entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); if (getNotes() != null) { @@ -133,62 +133,62 @@ public class Task extends Node { } return js; - }//返回JSONObject对象,包含更新Google Task的相关数据 + }//杩斿洖JSONObject瀵硅薄锛屽寘鍚洿鏂癎oogle Task鐨勭浉鍏虫暟鎹 public void setContentByRemoteJSON(JSONObject js) { if (js != null){ try { - // id 检查"JSON"对象是否包含id属性 + // id 妫鏌"JSON"瀵硅薄鏄惁鍖呭惈id灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_ID)) { setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID)); - }//如果是,则将其值设置为任务对象的gid属性 + }//濡傛灉鏄紝鍒欏皢鍏跺艰缃负浠诲姟瀵硅薄鐨刧id灞炴 - // last_modified 检查JSON对象是否包含last_modified属性 + // last_modified 妫鏌SON瀵硅薄鏄惁鍖呭惈last_modified灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) { setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)); - }//如果是,将其值设置为任务对象的lastModified属性 + }//濡傛灉鏄紝灏嗗叾鍊艰缃负浠诲姟瀵硅薄鐨刲astModified灞炴 - // name 检查JSON对象是否包含name属性 + // name 妫鏌SON瀵硅薄鏄惁鍖呭惈name灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) { setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME)); - }//如果是,则将其值设置为任务对象的name属性 + }//濡傛灉鏄紝鍒欏皢鍏跺艰缃负浠诲姟瀵硅薄鐨刵ame灞炴 - // notes 它检查JSON对象是否包含notes属性 + // notes 瀹冩鏌SON瀵硅薄鏄惁鍖呭惈notes灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) { setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES)); - }//如果是,则将其值设置为任务对象的notes属性 + }//濡傛灉鏄紝鍒欏皢鍏跺艰缃负浠诲姟瀵硅薄鐨刵otes灞炴 - // deleted 检查JSON对象是否包含deleted属性 + // deleted 妫鏌SON瀵硅薄鏄惁鍖呭惈deleted灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) { setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED)); - }//如果是,则将其值设置为任务对象的deleted属性 + }//濡傛灉鏄紝鍒欏皢鍏跺艰缃负浠诲姟瀵硅薄鐨刣eleted灞炴 - // completed 检查JSON对象是否包含completed属性 + // completed 妫鏌SON瀵硅薄鏄惁鍖呭惈completed灞炴 if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) { setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED)); - }//如果是,则将其值设置为任务对象的completed属性 + }//濡傛灉鏄紝鍒欏皢鍏跺艰缃负浠诲姟瀵硅薄鐨刢ompleted灞炴 } catch (JSONException e) { Log.e(TAG, e.toString()); e.printStackTrace(); - throw new ActionFailureException("fail to get task content from jsonobject");//如果解析JSON对象时出现异常,将会抛出一个ActionFailureException异常 + throw new ActionFailureException("fail to get task content from jsonobject");//濡傛灉瑙f瀽JSON瀵硅薄鏃跺嚭鐜板紓甯革紝灏嗕細鎶涘嚭涓涓狝ctionFailureException寮傚父 } } - }//从远程JSON对象中获取任务的各种属性并将其设置到任务对象中 + }//浠庤繙绋婮SON瀵硅薄涓幏鍙栦换鍔$殑鍚勭灞炴у苟灏嗗叾璁剧疆鍒颁换鍔″璞′腑 public void setContentByLocalJSON(JSONObject js) { if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE) || !js.has(GTaskStringUtils.META_HEAD_DATA)) { Log.w(TAG, "setContentByLocalJSON: nothing is avaiable"); - }//判断传入的JSONObject对象是否为空以及是否包含所需的键名,如果不包含,则打印警告日志并直接返回 + }//鍒ゆ柇浼犲叆鐨凧SONObject瀵硅薄鏄惁涓虹┖浠ュ強鏄惁鍖呭惈鎵闇鐨勯敭鍚,濡傛灉涓嶅寘鍚紝鍒欐墦鍗拌鍛婃棩蹇楀苟鐩存帴杩斿洖 try { JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA); - //从META_HEAD_NOTE键对应的JSON对象中获取类型 + //浠嶮ETA_HEAD_NOTE閿搴旂殑JSON瀵硅薄涓幏鍙栫被鍨 if (note.getInt(NoteColumns.TYPE) != Notes.TYPE_NOTE) { Log.e(TAG, "invalid type"); return; - }//类型不为Notes.TYPE_NOTE,则打印错误日志并返回 + }//绫诲瀷涓嶄负Notes.TYPE_NOTE锛屽垯鎵撳嵃閿欒鏃ュ織骞惰繑鍥 for (int i = 0; i < dataArray.length(); i++) { JSONObject data = dataArray.getJSONObject(i); @@ -196,23 +196,23 @@ public class Task extends Node { setName(data.getString(DataColumns.CONTENT)); break; } - }//遍历元素,若MIME_TYPE键值为DataConstants.NOTE,将其CONTENT设置为该对象的name属性值。 + }//閬嶅巻鍏冪礌,鑻IME_TYPE閿间负DataConstants.NOTE锛屽皢鍏禖ONTENT璁剧疆涓鸿瀵硅薄鐨刵ame灞炴у笺 } catch (JSONException e) { Log.e(TAG, e.toString()); e.printStackTrace(); } - }//从本地存储的JSON对象中读取内容,并设置到该对象的属性中 + }//浠庢湰鍦板瓨鍌ㄧ殑JSON瀵硅薄涓鍙栧唴瀹癸紝骞惰缃埌璇ュ璞$殑灞炴т腑 public JSONObject getLocalJSONFromContent() { - String name = getName();//从任务对象中获取名称,检查是否存在 mMetaInfo JSON 对象 + String name = getName();//浠庝换鍔″璞′腑鑾峰彇鍚嶇О锛屾鏌ユ槸鍚﹀瓨鍦 mMetaInfo JSON 瀵硅薄 try { if (mMetaInfo == null) { - // new task created from web 不存在,则说明任务对象是从 Web 创建的 + // new task created from web 涓嶅瓨鍦紝鍒欒鏄庝换鍔″璞℃槸浠 Web 鍒涘缓鐨 if (name == null) { Log.w(TAG, "the note seems to be an empty one"); return null; } - //创建一个新的 JSON 对象并返回 + //鍒涘缓涓涓柊鐨 JSON 瀵硅薄骞惰繑鍥 JSONObject js = new JSONObject(); JSONObject note = new JSONObject(); JSONArray dataArray = new JSONArray(); @@ -224,7 +224,7 @@ public class Task extends Node { js.put(GTaskStringUtils.META_HEAD_NOTE, note); return js; } else { - // synced task 如果存在 mMetaInfo JSON 对象,则说明任务对象是同步 + // synced task 濡傛灉瀛樺湪 mMetaInfo JSON 瀵硅薄锛屽垯璇存槑浠诲姟瀵硅薄鏄悓姝 JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA); @@ -235,7 +235,7 @@ public class Task extends Node { break; } } - //从现有的 JSON 对象中更新数据并返回。 + //浠庣幇鏈夌殑 JSON 瀵硅薄涓洿鏂版暟鎹苟杩斿洖銆 note.put(NoteColumns.TYPE, Notes.TYPE_NOTE); return mMetaInfo; } @@ -244,18 +244,18 @@ public class Task extends Node { e.printStackTrace(); return null; } - }//将任务对象的内容转换为本地 JSON 对象 + }//灏嗕换鍔″璞$殑鍐呭杞崲涓烘湰鍦 JSON 瀵硅薄 public void setMetaInfo(MetaData metaData) { - if (metaData != null && metaData.getNotes() != null) {//检查metaData是否为空且其notes属性是否存在 + if (metaData != null && metaData.getNotes() != null) {//妫鏌etaData鏄惁涓虹┖涓斿叾notes灞炴ф槸鍚﹀瓨鍦 try { - mMetaInfo = new JSONObject(metaData.getNotes());//尝试将notes属性的值转换为一个JSONObject对象,并将其赋值给类成员变量mMetaInfo + mMetaInfo = new JSONObject(metaData.getNotes());//灏濊瘯灏唍otes灞炴х殑鍊艰浆鎹负涓涓狫SONObject瀵硅薄锛屽苟灏嗗叾璧嬪肩粰绫绘垚鍛樺彉閲弇MetaInfo } catch (JSONException e) { Log.w(TAG, e.toString()); - mMetaInfo = null;//记录一个警告日志,并将mMetaInfo设置为null + mMetaInfo = null;//璁板綍涓涓鍛婃棩蹇楋紝骞跺皢mMetaInfo璁剧疆涓簄ull } } - }//检查metaData + }//妫鏌etaData public int getSyncAction(Cursor c) { try { @@ -284,22 +284,22 @@ public class Task extends Node { // there is no local update if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) { // no update both side - return SYNC_ACTION_NONE;//本地和远程都没有更新,无需同步 + return SYNC_ACTION_NONE;//鏈湴鍜岃繙绋嬮兘娌℃湁鏇存柊锛屾棤闇鍚屾 } else { // apply remote to local - return SYNC_ACTION_UPDATE_LOCAL;//远程有更新,需要将远程的更新同步到本地 + return SYNC_ACTION_UPDATE_LOCAL;//杩滅▼鏈夋洿鏂帮紝闇瑕佸皢杩滅▼鐨勬洿鏂板悓姝ュ埌鏈湴 } } else { // validate gtask id if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) { Log.e(TAG, "gtask id doesn't match"); - return SYNC_ACTION_ERROR;//发生异常 + return SYNC_ACTION_ERROR;//鍙戠敓寮傚父 } if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) { // local modification only - return SYNC_ACTION_UPDATE_REMOTE;//本地有更新,需要将本地的更新同步到远程 + return SYNC_ACTION_UPDATE_REMOTE;//鏈湴鏈夋洿鏂帮紝闇瑕佸皢鏈湴鐨勬洿鏂板悓姝ュ埌杩滅▼ } else { - return SYNC_ACTION_UPDATE_CONFLICT;//本地和远程都有更新,需要解决冲突并同步更新 + return SYNC_ACTION_UPDATE_CONFLICT;//鏈湴鍜岃繙绋嬮兘鏈夋洿鏂帮紝闇瑕佽В鍐冲啿绐佸苟鍚屾鏇存柊 } } } catch (Exception e) { @@ -308,43 +308,43 @@ 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); - }//判断任务是否值得保存 + }//鍒ゆ柇浠诲姟鏄惁鍊煎緱淇濆瓨 public void setCompleted(boolean completed) { this.mCompleted = completed; - }//// 设置任务的完成状态 + }//// 璁剧疆浠诲姟鐨勫畬鎴愮姸鎬 public void setNotes(String notes) { this.mNotes = notes; - }//将note赋值给该待办事项的mNotes成员变量 + }//灏唍ote璧嬪肩粰璇ュ緟鍔炰簨椤圭殑mNotes鎴愬憳鍙橀噺 public void setPriorSibling(Task priorSibling) { this.mPriorSibling = priorSibling; - }//给定一个Task对象作为参数,设置它作为当前Task对象的前一个兄弟节点 + }//缁欏畾涓涓猅ask瀵硅薄浣滀负鍙傛暟锛岃缃畠浣滀负褰撳墠Task瀵硅薄鐨勫墠涓涓厔寮熻妭鐐 public void setParent(TaskList parent) { this.mParent = parent; - }//设置当前Task的父任务列表 + }//璁剧疆褰撳墠Task鐨勭埗浠诲姟鍒楄〃 public boolean getCompleted() { return this.mCompleted; - }//获取任务的“完成”状态 + }//鑾峰彇浠诲姟鐨勨滃畬鎴愨濈姸鎬 public String getNotes() { return this.mNotes; - }//获取任务的备注信息 + }//鑾峰彇浠诲姟鐨勫娉ㄤ俊鎭 public Task getPriorSibling() { return this.mPriorSibling; - }//返回当前任务的前一个兄弟任务 + }//杩斿洖褰撳墠浠诲姟鐨勫墠涓涓厔寮熶换鍔 public TaskList getParent() { return this.mParent; - }//表示当前任务的父任务列表。该方法并未接收任何参数 + }//琛ㄧず褰撳墠浠诲姟鐨勭埗浠诲姟鍒楄〃銆傝鏂规硶骞舵湭鎺ユ敹浠讳綍鍙傛暟 -}//同步任务,将创建、更新和同步动作包装成JSON对象,用本地和远程的JSON对结点内容进行设置获取同步信息,进行本地和远程的同步 +}//鍚屾浠诲姟锛屽皢鍒涘缓銆佹洿鏂板拰鍚屾鍔ㄤ綔鍖呰鎴怞SON瀵硅薄锛岀敤鏈湴鍜岃繙绋嬬殑JSON瀵圭粨鐐瑰唴瀹硅繘琛岃缃幏鍙栧悓姝ヤ俊鎭紝杩涜鏈湴鍜岃繙绋嬬殑鍚屾