diff --git a/src/notes/gtask/data/SqlNote.java b/src/notes/gtask/data/SqlNote.java
new file mode 100644
index 0000000..7eaab22
--- /dev/null
+++ b/src/notes/gtask/data/SqlNote.java
@@ -0,0 +1,668 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.appwidget.AppWidgetManager;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+import net.micode.notes.tool.ResourceParser;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.ArrayList;
+
+/**
+ * 笔记应用note表及关联data表的核心数据操作封装类
+ * 该类是GTask同步过程中处理笔记/文件夹数据的核心类，封装了以下关键功能：
+ * 1. 加载已有数据：从Cursor、note表ID加载note表数据，并联动加载关联的data表数据；
+ * 2. 数据差异记录：通过mDiffNoteValues仅存储变化的字段，减少数据库操作开销；
+ * 3. JSON序列化/反序列化：实现与JSON的互相转换，支撑GTask同步的网络数据传输；
+ * 4. 数据持久化：支持新数据插入、已有数据更新，联动处理data表的提交，并提供版本验证机制保证同步一致性；
+ * 5. 区分数据类型：对笔记（TYPE_NOTE）、文件夹（TYPE_FOLDER）、系统文件夹（TYPE_SYSTEM）做差异化处理。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class SqlNote {
+ /**
+ * 日志标签，使用类的简单名称，便于调试时定位日志来源
+ */
+ private static final String TAG = SqlNote.class.getSimpleName();
+
+ /**
+ * 无效的ID常量，用于标记note表ID尚未初始化或不存在（区别于数据库的自增ID）
+ */
+ private static final int INVALID_ID = -99999;
+
+ /**
+ * note表的查询投影（Projection），定义了查询时需要返回的所有核心列
+ * 包含note表的全部业务字段，减少数据传输开销，适配所有数据加载场景
+ */
+ public static final String[] PROJECTION_NOTE = new String[] {
+ NoteColumns.ID, NoteColumns.ALERTED_DATE, NoteColumns.BG_COLOR_ID,
+ NoteColumns.CREATED_DATE, NoteColumns.HAS_ATTACHMENT, NoteColumns.MODIFIED_DATE,
+ NoteColumns.NOTES_COUNT, NoteColumns.PARENT_ID, NoteColumns.SNIPPET, NoteColumns.TYPE,
+ NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE, NoteColumns.SYNC_ID,
+ NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
+ NoteColumns.VERSION
+ };
+
+ // ====================== PROJECTION_NOTE的列索引常量 ======================
+ /** PROJECTION_NOTE中ID列的索引（对应NoteColumns.ID） */
+ public static final int ID_COLUMN = 0;
+ /** PROJECTION_NOTE中提醒时间列的索引（对应NoteColumns.ALERTED_DATE） */
+ public static final int ALERTED_DATE_COLUMN = 1;
+ /** PROJECTION_NOTE中背景颜色ID列的索引（对应NoteColumns.BG_COLOR_ID） */
+ public static final int BG_COLOR_ID_COLUMN = 2;
+ /** PROJECTION_NOTE中创建时间列的索引（对应NoteColumns.CREATED_DATE） */
+ public static final int CREATED_DATE_COLUMN = 3;
+ /** PROJECTION_NOTE中是否有附件列的索引（对应NoteColumns.HAS_ATTACHMENT） */
+ public static final int HAS_ATTACHMENT_COLUMN = 4;
+ /** PROJECTION_NOTE中修改时间列的索引（对应NoteColumns.MODIFIED_DATE） */
+ public static final int MODIFIED_DATE_COLUMN = 5;
+ /** PROJECTION_NOTE中文件夹笔记数量列的索引（对应NoteColumns.NOTES_COUNT） */
+ public static final int NOTES_COUNT_COLUMN = 6;
+ /** PROJECTION_NOTE中父级ID列的索引（对应NoteColumns.PARENT_ID） */
+ public static final int PARENT_ID_COLUMN = 7;
+ /** PROJECTION_NOTE中摘要/名称列的索引（对应NoteColumns.SNIPPET） */
+ public static final int SNIPPET_COLUMN = 8;
+ /** PROJECTION_NOTE中类型列的索引（对应NoteColumns.TYPE） */
+ public static final int TYPE_COLUMN = 9;
+ /** PROJECTION_NOTE中小组件ID列的索引（对应NoteColumns.WIDGET_ID） */
+ public static final int WIDGET_ID_COLUMN = 10;
+ /** PROJECTION_NOTE中小组件类型列的索引（对应NoteColumns.WIDGET_TYPE） */
+ public static final int WIDGET_TYPE_COLUMN = 11;
+ /** PROJECTION_NOTE中同步ID列的索引（对应NoteColumns.SYNC_ID） */
+ public static final int SYNC_ID_COLUMN = 12;
+ /** PROJECTION_NOTE中本地修改标记列的索引（对应NoteColumns.LOCAL_MODIFIED） */
+ public static final int LOCAL_MODIFIED_COLUMN = 13;
+ /** PROJECTION_NOTE中原始父级ID列的索引（对应NoteColumns.ORIGIN_PARENT_ID） */
+ public static final int ORIGIN_PARENT_ID_COLUMN = 14;
+ /** PROJECTION_NOTE中GTask ID列的索引（对应NoteColumns.GTASK_ID） */
+ public static final int GTASK_ID_COLUMN = 15;
+ /** PROJECTION_NOTE中版本号列的索引（对应NoteColumns.VERSION） */
+ public static final int VERSION_COLUMN = 16;
+
+ // ====================== 成员变量 ======================
+ /** 上下文对象，用于获取资源、ContentResolver等 */
+ private Context mContext;
+
+ /** Android内容解析器，用于访问ContentProvider进行note/data表的增删改查 */
+ private ContentResolver mContentResolver;
+
+ /** 数据创建标记：true表示新数据（需插入数据库），false表示已有数据（需更新数据库） */
+ private boolean mIsCreate;
+
+ /** note表的主键ID，关联到具体的行数据 */
+ private long mId;
+
+ /** 笔记的提醒时间戳（毫秒） */
+ private long mAlertDate;
+
+ /** 笔记/文件夹的背景颜色ID（对应资源文件中的颜色配置） */
+ private int mBgColorId;
+
+ /** 数据创建时间戳（毫秒） */
+ private long mCreatedDate;
+
+ /** 是否有附件：0表示无，1表示有（整型标记） */
+ private int mHasAttachment;
+
+ /** 数据最后修改时间戳（毫秒） */
+ private long mModifiedDate;
+
+ /** 父级ID：关联到文件夹的note ID（根文件夹为0） */
+ private long mParentId;
+
+ /** 摘要/名称：笔记的内容摘要、文件夹的名称 */
+ private String mSnippet;
+
+ /** 数据类型：{@link Notes#TYPE_NOTE}（笔记）、{TYPE_FOLDER}（文件夹）、{TYPE_SYSTEM}（系统文件夹） */
+ private int mType;
+
+ /** 关联的小组件ID（无效时为{@link AppWidgetManager#INVALID_APPWIDGET_ID}） */
+ private int mWidgetId;
+
+ /** 关联的小组件类型（无效时为{@link Notes#TYPE_WIDGET_INVALIDE}） */
+ private int mWidgetType;
+
+ /** 原始父级ID：用于记录文件夹移动前的原始父级，支撑同步回滚 */
+ private long mOriginParent;
+
+ /** 版本号：用于同步时的版本验证，防止并发修改冲突 */
+ private long mVersion;
+
+ /** note表的差异数据容器，仅存储有变化的字段，用于提交到数据库 */
+ private ContentValues mDiffNoteValues;
+
+ /** 关联的data表数据列表（存储笔记的具体内容，如文本、通话记录等） */
+ private ArrayList mDataList;
+
+ // ====================== 构造方法 ======================
+ /**
+ * 构造方法：初始化新的SqlNote对象（用于创建新笔记/文件夹）
+ * 初始化所有成员变量为默认值，设置为新数据状态
+ *
+ * @param context 上下文对象
+ */
+ public SqlNote(Context context) {
+ mContext = context;
+ mContentResolver = context.getContentResolver();
+ mIsCreate = true;
+ mId = INVALID_ID;
+ mAlertDate = 0;
+ mBgColorId = ResourceParser.getDefaultBgId(context); // 默认背景颜色
+ mCreatedDate = System.currentTimeMillis(); // 当前时间为创建时间
+ mHasAttachment = 0;
+ mModifiedDate = System.currentTimeMillis(); // 当前时间为修改时间
+ mParentId = 0;
+ mSnippet = "";
+ mType = Notes.TYPE_NOTE; // 默认类型为普通笔记
+ mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; // 无效小组件ID
+ mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 无效小组件类型
+ mOriginParent = 0;
+ mVersion = 0;
+ mDiffNoteValues = new ContentValues(); // 初始化差异容器
+ mDataList = new ArrayList(); // 初始化data数据列表
+ }
+
+ /**
+ * 构造方法：从Cursor中加载已有note表数据初始化SqlNote对象
+ * 同时加载关联的data表数据（仅笔记类型）
+ *
+ * @param context 上下文对象
+ * @param c 包含note表数据的Cursor对象（需使用PROJECTION_NOTE投影查询）
+ */
+ public SqlNote(Context context, Cursor c) {
+ mContext = context;
+ mContentResolver = context.getContentResolver();
+ mIsCreate = false; // 标记为已有数据
+ loadFromCursor(c); // 从Cursor加载note表数据
+ mDataList = new ArrayList();
+ if (mType == Notes.TYPE_NOTE) // 仅笔记类型加载关联的data表数据
+ loadDataContent();
+ mDiffNoteValues = new ContentValues(); // 初始化差异容器
+ }
+
+ /**
+ * 构造方法：根据note表ID加载已有数据初始化SqlNote对象
+ * 先通过ID查询获取Cursor，再加载数据，最后加载关联的data表数据（仅笔记类型）
+ *
+ * @param context 上下文对象
+ * @param id note表的主键ID
+ */
+ public SqlNote(Context context, long id) {
+ mContext = context;
+ mContentResolver = context.getContentResolver();
+ mIsCreate = false; // 标记为已有数据
+ loadFromCursor(id); // 根据ID加载note表数据
+ mDataList = new ArrayList();
+ if (mType == Notes.TYPE_NOTE) // 仅笔记类型加载关联的data表数据
+ loadDataContent();
+ mDiffNoteValues = new ContentValues(); // 初始化差异容器
+ }
+
+ // ====================== 私有辅助方法 ======================
+ /**
+ * 根据note表ID查询数据，获取Cursor并加载到成员变量
+ * 自动关闭Cursor，防止资源泄漏
+ *
+ * @param id note表的主键ID
+ */
+ private void loadFromCursor(long id) {
+ Cursor c = null;
+ try {
+ // 查询note表：根据ID获取单条数据
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",
+ new String[] { String.valueOf(id) }, null);
+ if (c != null) {
+ c.moveToNext(); // 移动到第一条数据（唯一结果）
+ loadFromCursor(c); // 加载数据到成员变量
+ } else {
+ Log.w(TAG, "loadFromCursor: cursor = null");
+ }
+ } finally {
+ // 最终关闭Cursor，释放资源
+ if (c != null)
+ c.close();
+ }
+ }
+
+ /**
+ * 从Cursor中加载note表数据到成员变量
+ * 需保证Cursor使用PROJECTION_NOTE投影查询，否则会出现列索引越界异常
+ *
+ * @param c 包含note表数据的Cursor对象
+ */
+ private void loadFromCursor(Cursor c) {
+ mId = c.getLong(ID_COLUMN);
+ mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
+ mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
+ mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
+ mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
+ mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
+ mParentId = c.getLong(PARENT_ID_COLUMN);
+ mSnippet = c.getString(SNIPPET_COLUMN);
+ mType = c.getInt(TYPE_COLUMN);
+ mWidgetId = c.getInt(WIDGET_ID_COLUMN);
+ mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
+ mVersion = c.getLong(VERSION_COLUMN);
+ }
+
+ /**
+ * 加载当前note关联的data表数据，存入mDataList
+ * 根据note ID查询data表，创建SqlData对象并添加到列表中
+ */
+ private void loadDataContent() {
+ Cursor c = null;
+ mDataList.clear(); // 清空原有数据
+ try {
+ // 查询data表：根据note ID获取关联的所有数据
+ c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA,
+ "(note_id=?)", new String[] { String.valueOf(mId) }, null);
+ if (c != null) {
+ if (c.getCount() == 0) {
+ Log.w(TAG, "it seems that the note has not data");
+ return;
+ }
+ // 遍历Cursor，创建SqlData对象并添加到列表
+ while (c.moveToNext()) {
+ SqlData data = new SqlData(mContext, c);
+ mDataList.add(data);
+ }
+ } else {
+ Log.w(TAG, "loadDataContent: cursor = null");
+ }
+ } finally {
+ // 最终关闭Cursor，释放资源
+ if (c != null)
+ c.close();
+ }
+ }
+
+ // ====================== 公共核心方法 ======================
+ /**
+ * 根据JSON对象设置笔记/文件夹内容，并记录数据差异到差异容器
+ * 区分系统文件夹、普通文件夹、笔记类型做差异化处理：
+ * - 系统文件夹：不允许修改，仅输出警告
+ * - 普通文件夹：仅更新名称和类型
+ * - 笔记：更新所有字段，并处理关联的data表数据
+ *
+ * @param js 包含笔记/文件夹数据的JSON对象
+ * @return true表示设置成功，false表示JSON解析失败
+ */
+ public boolean setContent(JSONObject js) {
+ try {
+ // 获取JSON中的note核心数据（GTask约定的字段名）
+ JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+
+ // 系统文件夹：不允许修改，输出警告
+ if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
+ Log.w(TAG, "cannot set system folder");
+ }
+ // 普通文件夹：仅更新名称和类型
+ else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
+ // 更新摘要/名称
+ String snippet = note.has(NoteColumns.SNIPPET) ? note.getString(NoteColumns.SNIPPET) : "";
+ if (mIsCreate || !mSnippet.equals(snippet)) {
+ mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
+ }
+ mSnippet = snippet;
+
+ // 更新类型
+ int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE) : Notes.TYPE_NOTE;
+ if (mIsCreate || mType != type) {
+ mDiffNoteValues.put(NoteColumns.TYPE, type);
+ }
+ mType = type;
+ }
+ // 普通笔记：更新所有字段，并处理关联的data表数据
+ else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
+ // 获取JSON中的data数组（笔记的具体内容）
+ JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+
+ // 1. 处理note表的各个字段，记录差异
+ long id = note.has(NoteColumns.ID) ? note.getLong(NoteColumns.ID) : INVALID_ID;
+ if (mIsCreate || mId != id) {
+ mDiffNoteValues.put(NoteColumns.ID, id);
+ }
+ mId = id;
+
+ long alertDate = note.has(NoteColumns.ALERTED_DATE) ? note.getLong(NoteColumns.ALERTED_DATE) : 0;
+ if (mIsCreate || mAlertDate != alertDate) {
+ mDiffNoteValues.put(NoteColumns.ALERTED_DATE, alertDate);
+ }
+ mAlertDate = alertDate;
+
+ int bgColorId = note.has(NoteColumns.BG_COLOR_ID) ? note.getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
+ if (mIsCreate || mBgColorId != bgColorId) {
+ mDiffNoteValues.put(NoteColumns.BG_COLOR_ID, bgColorId);
+ }
+ mBgColorId = bgColorId;
+
+ long createDate = note.has(NoteColumns.CREATED_DATE) ? note.getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
+ if (mIsCreate || mCreatedDate != createDate) {
+ mDiffNoteValues.put(NoteColumns.CREATED_DATE, createDate);
+ }
+ mCreatedDate = createDate;
+
+ int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT) ? note.getInt(NoteColumns.HAS_ATTACHMENT) : 0;
+ if (mIsCreate || mHasAttachment != hasAttachment) {
+ mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT, hasAttachment);
+ }
+ mHasAttachment = hasAttachment;
+
+ long modifiedDate = note.has(NoteColumns.MODIFIED_DATE) ? note.getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
+ if (mIsCreate || mModifiedDate != modifiedDate) {
+ mDiffNoteValues.put(NoteColumns.MODIFIED_DATE, modifiedDate);
+ }
+ mModifiedDate = modifiedDate;
+
+ long parentId = note.has(NoteColumns.PARENT_ID) ? note.getLong(NoteColumns.PARENT_ID) : 0;
+ if (mIsCreate || mParentId != parentId) {
+ mDiffNoteValues.put(NoteColumns.PARENT_ID, parentId);
+ }
+ mParentId = parentId;
+
+ String snippet = note.has(NoteColumns.SNIPPET) ? note.getString(NoteColumns.SNIPPET) : "";
+ if (mIsCreate || !mSnippet.equals(snippet)) {
+ mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
+ }
+ mSnippet = snippet;
+
+ int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE) : Notes.TYPE_NOTE;
+ if (mIsCreate || mType != type) {
+ mDiffNoteValues.put(NoteColumns.TYPE, type);
+ }
+ mType = type;
+
+ int widgetId = note.has(NoteColumns.WIDGET_ID) ? note.getInt(NoteColumns.WIDGET_ID) : AppWidgetManager.INVALID_APPWIDGET_ID;
+ if (mIsCreate || mWidgetId != widgetId) {
+ mDiffNoteValues.put(NoteColumns.WIDGET_ID, widgetId);
+ }
+ mWidgetId = widgetId;
+
+ int widgetType = note.has(NoteColumns.WIDGET_TYPE) ? note.getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
+ if (mIsCreate || mWidgetType != widgetType) {
+ mDiffNoteValues.put(NoteColumns.WIDGET_TYPE, widgetType);
+ }
+ mWidgetType = widgetType;
+
+ long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID) ? note.getLong(NoteColumns.ORIGIN_PARENT_ID) : 0;
+ if (mIsCreate || mOriginParent != originParent) {
+ mDiffNoteValues.put(NoteColumns.ORIGIN_PARENT_ID, originParent);
+ }
+ mOriginParent = originParent;
+
+ // 2. 处理关联的data表数据
+ for (int i = 0; i < dataArray.length(); i++) {
+ JSONObject data = dataArray.getJSONObject(i);
+ SqlData sqlData = null;
+
+ // 根据data ID查找已有SqlData对象（更新场景）
+ if (data.has(DataColumns.ID)) {
+ long dataId = data.getLong(DataColumns.ID);
+ for (SqlData temp : mDataList) {
+ if (dataId == temp.getId()) {
+ sqlData = temp;
+ break;
+ }
+ }
+ }
+
+ // 未找到则创建新SqlData对象（新增场景）
+ if (sqlData == null) {
+ sqlData = new SqlData(mContext);
+ mDataList.add(sqlData);
+ }
+
+ // 设置data内容并记录差异
+ sqlData.setContent(data);
+ }
+ }
+ } catch (JSONException e) {
+ // JSON解析失败，输出错误日志并返回false
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ return false;
+ }
+ return true;
+ }
+
+ /**
+ * 将笔记/文件夹数据及关联的data表数据序列化为JSON对象
+ * 区分笔记、文件夹、系统文件夹做差异化序列化：
+ * - 笔记：序列化所有note字段 + 关联的data数组
+ * - 文件夹/系统文件夹：仅序列化核心字段（ID、类型、名称）
+ *
+ * @return 包含完整数据的JSON对象，若为新数据则返回null
+ */
+ public JSONObject getContent() {
+ try {
+ JSONObject js = new JSONObject();
+
+ // 新数据尚未持久化，输出错误日志并返回null
+ if (mIsCreate) {
+ Log.e(TAG, "it seems that we haven't created this in database yet");
+ return null;
+ }
+
+ JSONObject note = new JSONObject();
+ // 普通笔记：序列化所有字段 + 关联的data数组
+ if (mType == Notes.TYPE_NOTE) {
+ note.put(NoteColumns.ID, mId);
+ note.put(NoteColumns.ALERTED_DATE, mAlertDate);
+ note.put(NoteColumns.BG_COLOR_ID, mBgColorId);
+ note.put(NoteColumns.CREATED_DATE, mCreatedDate);
+ note.put(NoteColumns.HAS_ATTACHMENT, mHasAttachment);
+ note.put(NoteColumns.MODIFIED_DATE, mModifiedDate);
+ note.put(NoteColumns.PARENT_ID, mParentId);
+ note.put(NoteColumns.SNIPPET, mSnippet);
+ note.put(NoteColumns.TYPE, mType);
+ note.put(NoteColumns.WIDGET_ID, mWidgetId);
+ note.put(NoteColumns.WIDGET_TYPE, mWidgetType);
+ note.put(NoteColumns.ORIGIN_PARENT_ID, mOriginParent);
+ js.put(GTaskStringUtils.META_HEAD_NOTE, note);
+
+ // 序列化关联的data表数据为JSON数组
+ JSONArray dataArray = new JSONArray();
+ for (SqlData sqlData : mDataList) {
+ JSONObject data = sqlData.getContent();
+ if (data != null) {
+ dataArray.put(data);
+ }
+ }
+ js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
+ }
+ // 文件夹/系统文件夹：仅序列化核心字段
+ else if (mType == Notes.TYPE_FOLDER || mType == Notes.TYPE_SYSTEM) {
+ note.put(NoteColumns.ID, mId);
+ note.put(NoteColumns.TYPE, mType);
+ note.put(NoteColumns.SNIPPET, mSnippet);
+ js.put(GTaskStringUtils.META_HEAD_NOTE, note);
+ }
+
+ return js;
+ } catch (JSONException e) {
+ // JSON序列化失败，输出错误日志
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ }
+ return null;
+ }
+
+ // ====================== 字段设置方法（记录差异） ======================
+ /**
+ * 设置父级ID，并记录到差异容器
+ * @param id 新的父级ID（文件夹的note ID）
+ */
+ public void setParentId(long id) {
+ mParentId = id;
+ mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
+ }
+
+ /**
+ * 设置GTask ID，并记录到差异容器
+ * @param gid GTask的唯一标识ID
+ */
+ public void setGtaskId(String gid) {
+ mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
+ }
+
+ /**
+ * 设置同步ID，并记录到差异容器
+ * @param syncId 同步ID（用于标记同步状态）
+ */
+ public void setSyncId(long syncId) {
+ mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId);
+ }
+
+ /**
+ * 重置本地修改标记为0，并记录到差异容器
+ * 用于同步完成后标记数据已同步，无本地修改
+ */
+ public void resetLocalModified() {
+ mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0);
+ }
+
+ // ====================== 字段获取方法 ======================
+ /**
+ * 获取note表的主键ID
+ * @return 主键ID，未初始化则返回INVALID_ID
+ */
+ public long getId() {
+ return mId;
+ }
+
+ /**
+ * 获取父级ID
+ * @return 父级文件夹的note ID
+ */
+ public long getParentId() {
+ return mParentId;
+ }
+
+ /**
+ * 获取摘要/名称
+ * @return 笔记摘要或文件夹名称
+ */
+ public String getSnippet() {
+ return mSnippet;
+ }
+
+ /**
+ * 判断当前数据是否为笔记类型
+ * @return true表示是笔记（TYPE_NOTE），false表示否
+ */
+ public boolean isNoteType() {
+ return mType == Notes.TYPE_NOTE;
+ }
+
+ /**
+ * 提交数据变更到数据库（插入/更新），并联动处理关联的data表数据
+ * 支持版本验证机制，保证同步过程中数据的一致性，提交后刷新本地数据。
+ *
+ * @param validateVersion 是否开启版本验证：true表示验证，false表示不验证
+ */
+ public void commit(boolean validateVersion) {
+ // 新数据：执行插入操作
+ if (mIsCreate) {
+ // 若ID为无效值且差异容器中包含ID，移除该ID（数据库自增ID，无需手动设置）
+ if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) {
+ mDiffNoteValues.remove(NoteColumns.ID);
+ }
+
+ // 插入note表数据，获取返回的Uri（包含新数据的ID）
+ Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI, mDiffNoteValues);
+ try {
+ // 从Uri中解析出新数据的ID（Uri路径分段的第二个元素，如note/123中的123）
+ mId = Long.valueOf(uri.getPathSegments().get(1));
+ } catch (NumberFormatException e) {
+ // 解析ID失败，输出错误日志并抛出同步失败异常
+ Log.e(TAG, "Get note id error :" + e.toString());
+ throw new ActionFailureException("create note failed");
+ }
+ // ID为0表示创建失败，抛出异常
+ if (mId == 0) {
+ throw new IllegalStateException("Create thread id failed");
+ }
+
+ // 笔记类型：联动提交关联的data表数据
+ if (mType == Notes.TYPE_NOTE) {
+ for (SqlData sqlData : mDataList) {
+ sqlData.commit(mId, false, -1); // 无需版本验证
+ }
+ }
+ }
+ // 已有数据：执行更新操作
+ else {
+ // 验证ID有效性（排除系统文件夹的有效ID）
+ if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
+ Log.e(TAG, "No such note");
+ throw new IllegalStateException("Try to update note with invalid id");
+ }
+
+ // 仅当存在差异时执行更新操作
+ if (mDiffNoteValues.size() > 0) {
+ mVersion ++; // 版本号自增
+ int result = 0;
+ if (!validateVersion) {
+ // 不验证版本：直接更新数据（根据note ID）
+ result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+ + NoteColumns.ID + "=?)", new String[] { String.valueOf(mId) });
+ } else {
+ // 验证版本：仅当note表的版本号小于等于当前版本时才更新
+ result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+ + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
+ new String[] { String.valueOf(mId), String.valueOf(mVersion) });
+ }
+ // 更新结果为0，说明数据未更新（可能同步时用户修改了数据），输出警告日志
+ if (result == 0) {
+ Log.w(TAG, "there is no update. maybe user updates note when syncing");
+ }
+ }
+
+ // 笔记类型：联动提交关联的data表数据（支持版本验证）
+ if (mType == Notes.TYPE_NOTE) {
+ for (SqlData sqlData : mDataList) {
+ sqlData.commit(mId, validateVersion, mVersion);
+ }
+ }
+ }
+
+ // 提交后刷新本地数据：重新加载note和关联的data表数据
+ loadFromCursor(mId);
+ if (mType == Notes.TYPE_NOTE)
+ loadDataContent();
+
+ // 清空差异容器，标记为已有数据
+ mDiffNoteValues.clear();
+ mIsCreate = false;
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/data/Task.java b/src/notes/gtask/data/Task.java
new file mode 100644
index 0000000..885b80e
--- /dev/null
+++ b/src/notes/gtask/data/Task.java
@@ -0,0 +1,510 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+/**
+ * GTask任务节点类，继承自核心抽象节点类{@link Node}
+ * 该类是GTask中「任务（Task）」的具体实现，封装了GTask任务的核心属性（完成状态、备注、元信息、层级关系等），
+ * 并实现了父类的抽象方法，完成以下核心功能：
+ * 1. 生成GTask的创建/更新动作JSON（用于向远程GTask服务发送请求）；
+ * 2. 从远程GTask的JSON数据初始化任务内容（远程→本地同步）；
+ * 3. 从本地笔记的JSON数据初始化任务内容（本地→远程同步）；
+ * 4. 将任务内容序列化为本地笔记的JSON数据（GTask→本地笔记转换）；
+ * 5. 根据本地数据库Cursor判断同步动作类型（核心同步逻辑）；
+ * 6. 管理任务的层级关系（父任务列表、前序兄弟任务）。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class Task extends Node {
+ /**
+ * 日志标签，使用类的简单名称，便于调试时定位日志来源
+ */
+ private static final String TAG = Task.class.getSimpleName();
+
+ // ====================== 成员变量 ======================
+ /**
+ * 任务完成状态：true表示已完成，false表示未完成
+ */
+ private boolean mCompleted;
+
+ /**
+ * 任务的备注信息（GTask的Notes字段，对应本地笔记的附加内容）
+ */
+ private String mNotes;
+
+ /**
+ * 本地笔记的元信息JSON对象，存储笔记的完整数据（用于GTask与本地笔记的映射）
+ */
+ private JSONObject mMetaInfo;
+
+ /**
+ * 前序兄弟任务：用于维护GTask任务的排序（当前任务的上一个同级任务）
+ */
+ private Task mPriorSibling;
+
+ /**
+ * 父任务列表：当前任务所属的GTask列表（{TaskList}实例），维护层级关系
+ */
+ private TaskList mParent;
+
+ /**
+ * 构造方法：初始化GTask任务节点的默认属性
+ * 调用父类{@link Node}的构造方法，同时初始化当前类的成员变量为默认值
+ */
+ public Task() {
+ super();
+ mCompleted = false; // 默认未完成
+ mNotes = null; // 默认无备注
+ mPriorSibling = null; // 默认无前序兄弟任务
+ mParent = null; // 默认无父任务列表
+ mMetaInfo = null; // 默认无本地元信息
+ }
+
+ /**
+ * 实现父类抽象方法：生成创建GTask任务的动作JSON对象
+ * 该JSON遵循GTask服务的接口规范，包含创建任务所需的所有参数（动作类型、ID、名称、父节点、排序等），
+ * 用于向远程GTask服务发送创建任务的请求。
+ *
+ * @param actionId 动作唯一标识ID（用于GTask服务识别本次动作）
+ * @return 包含创建任务动作的JSON对象
+ * @throws ActionFailureException JSON生成失败时抛出该异常
+ */
+ public JSONObject getCreateAction(int actionId) {
+ JSONObject js = new JSONObject();
+
+ try {
+ // 1. 动作类型：创建（CREATE）
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+ GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
+
+ // 2. 动作ID：唯一标识本次创建动作
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+ // 3. 任务索引：当前任务在父列表中的位置（用于排序）
+ js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this));
+
+ // 4. 实体增量：任务的核心属性（名称、创建者、类型、备注等）
+ JSONObject entity = new JSONObject();
+ entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); // 任务名称（对应笔记标题/内容）
+ entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null"); // 创建者ID（此处设为null）
+ entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
+ GTaskStringUtils.GTASK_JSON_TYPE_TASK); // 实体类型：任务（TASK）
+ if (getNotes() != null) {
+ entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes()); // 任务备注（非空时添加）
+ }
+ js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+ // 5. 父节点ID：当前任务所属父列表的GID
+ js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
+
+ // 6. 目标父类型：父节点的类型为分组（GROUP，对应TaskList）
+ js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
+ GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
+
+ // 7. 列表ID：所属父列表的GID（与父节点ID一致）
+ js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
+
+ // 8. 前序兄弟ID：存在前序兄弟任务时添加该字段（用于排序）
+ if (mPriorSibling != null) {
+ js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
+ }
+
+ } catch (JSONException e) {
+ // JSON解析/写入失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to generate task-create jsonobject");
+ }
+
+ return js;
+ }
+
+ /**
+ * 实现父类抽象方法：生成更新GTask任务的动作JSON对象
+ * 该JSON遵循GTask服务的接口规范，包含更新任务所需的核心参数（动作类型、ID、名称、备注、删除标记等），
+ * 用于向远程GTask服务发送更新任务的请求。
+ *
+ * @param actionId 动作唯一标识ID（用于GTask服务识别本次动作）
+ * @return 包含更新任务动作的JSON对象
+ * @throws ActionFailureException JSON生成失败时抛出该异常
+ */
+ public JSONObject getUpdateAction(int actionId) {
+ JSONObject js = new JSONObject();
+
+ try {
+ // 1. 动作类型：更新（UPDATE）
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+ GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
+
+ // 2. 动作ID：唯一标识本次更新动作
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+ // 3. 任务ID：当前任务的GID（标识要更新的任务）
+ js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
+
+ // 4. 实体增量：需要更新的任务属性（名称、备注、删除标记）
+ JSONObject entity = new JSONObject();
+ entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); // 任务名称
+ if (getNotes() != null) {
+ entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes()); // 任务备注（非空时添加）
+ }
+ entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted()); // 删除标记（是否被删除）
+ js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+ } catch (JSONException e) {
+ // JSON解析/写入失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to generate task-update jsonobject");
+ }
+
+ return js;
+ }
+
+ /**
+ * 实现父类抽象方法：根据远程GTask的JSON数据设置任务内容
+ * 从远程GTask返回的JSON中解析出任务的核心属性（GID、修改时间、名称、备注、删除标记、完成状态等），
+ * 完成远程GTask数据到本地Task对象的映射（远程→本地同步）。
+ *
+ * @param js 远程GTask返回的任务JSON对象
+ * @throws ActionFailureException JSON解析失败时抛出该异常
+ */
+ public void setContentByRemoteJSON(JSONObject js) {
+ if (js != null) {
+ try {
+ // 1. 任务GID：远程GTask的唯一标识
+ if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
+ setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
+ }
+
+ // 2. 最后修改时间：用于同步时的版本对比
+ if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
+ setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
+ }
+
+ // 3. 任务名称：对应本地笔记的内容
+ if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
+ setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
+ }
+
+ // 4. 任务备注：对应本地笔记的附加内容
+ if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
+ setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
+ }
+
+ // 5. 删除标记：是否被远程删除（用于同步删除操作）
+ if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
+ setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
+ }
+
+ // 6. 完成状态：任务是否被远程标记为完成
+ if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
+ setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
+ }
+ } catch (JSONException e) {
+ // JSON解析失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to get task content from jsonobject");
+ }
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：根据本地笔记的JSON数据设置任务内容
+ * 从本地笔记的JSON中解析出核心内容（仅处理普通笔记类型），将笔记内容映射为GTask任务的名称，
+ * 完成本地笔记数据到GTask Task对象的映射（本地→远程同步）。
+ *
+ * @param js 本地笔记的JSON对象（包含note和data字段）
+ */
+ public void setContentByLocalJSON(JSONObject js) {
+ // 校验JSON的有效性：必须包含note和data核心字段
+ if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
+ || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
+ Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+ return;
+ }
+
+ try {
+ // 1. 解析note核心字段（笔记基础信息）
+ JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+ // 2. 解析data数组（笔记具体内容）
+ JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+
+ // 仅处理普通笔记类型（TYPE_NOTE），其他类型直接返回
+ if (note.getInt(NoteColumns.TYPE) != Notes.TYPE_NOTE) {
+ Log.e(TAG, "invalid type");
+ return;
+ }
+
+ // 3. 遍历data数组，获取文本笔记的内容并设置为任务名称
+ for (int i = 0; i < dataArray.length(); i++) {
+ JSONObject data = dataArray.getJSONObject(i);
+ // 匹配文本笔记的MIME类型（DataConstants.NOTE）
+ if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
+ setName(data.getString(DataColumns.CONTENT));
+ break; // 仅取第一个文本内容
+ }
+ }
+
+ } catch (JSONException e) {
+ // JSON解析失败，输出日志
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：将任务内容序列化为本地笔记的JSON对象
+ * 根据任务的元信息（mMetaInfo）状态，分为两种场景：
+ * 1. 无元信息：新创建的GTask任务，生成空的本地笔记JSON（仅包含核心字段）；
+ * 2. 有元信息：已同步的任务，更新笔记的内容字段为当前任务名称，保留原有元信息；
+ * 最终完成GTask Task对象到本地笔记JSON的映射（GTask→本地笔记转换）。
+ *
+ * @return 本地笔记的JSON对象，若序列化失败则返回null
+ */
+ public JSONObject getLocalJSONFromContent() {
+ String name = getName(); // 获取当前任务名称
+ try {
+ // 场景1：无元信息（新任务，从GTask网页端创建）
+ if (mMetaInfo == null) {
+ // 任务名称为空，输出警告并返回null
+ if (name == null) {
+ Log.w(TAG, "the note seems to be an empty one");
+ return null;
+ }
+
+ // 构建空的本地笔记JSON对象
+ JSONObject js = new JSONObject();
+ JSONObject note = new JSONObject();
+ JSONArray dataArray = new JSONArray();
+ JSONObject data = new JSONObject();
+ data.put(DataColumns.CONTENT, name); // 任务名称作为笔记内容
+ dataArray.put(data);
+ js.put(GTaskStringUtils.META_HEAD_DATA, dataArray); // 写入data数组
+ note.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 标记为普通笔记
+ js.put(GTaskStringUtils.META_HEAD_NOTE, note); // 写入note字段
+ return js;
+ }
+ // 场景2：有元信息（已同步的任务，更新内容）
+ else {
+ // 从元信息中解析note和data字段
+ JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+ JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+
+ // 遍历data数组，更新文本笔记的内容为当前任务名称
+ for (int i = 0; i < dataArray.length(); i++) {
+ JSONObject data = dataArray.getJSONObject(i);
+ if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
+ data.put(DataColumns.CONTENT, getName());
+ break;
+ }
+ }
+
+ // 标记为普通笔记类型
+ note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+ return mMetaInfo; // 返回更新后的元信息
+ }
+ } catch (JSONException e) {
+ // JSON序列化失败，输出日志并返回null
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ return null;
+ }
+ }
+
+ /**
+ * 设置本地笔记的元信息（从MetaData对象中解析）
+ * 将MetaData中的笔记JSON字符串转换为JSONObject，存储到mMetaInfo成员变量，
+ * 用于GTask任务与本地笔记的映射。
+ *
+ * @param metaData 本地笔记的元数据对象（包含笔记的JSON字符串）
+ */
+ public void setMetaInfo(MetaData metaData) {
+ if (metaData != null && metaData.getNotes() != null) {
+ try {
+ // 将JSON字符串转换为JSONObject
+ mMetaInfo = new JSONObject(metaData.getNotes());
+ } catch (JSONException e) {
+ // 解析失败，输出警告并置空元信息
+ Log.w(TAG, e.toString());
+ mMetaInfo = null;
+ }
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：根据本地数据库Cursor判断当前任务的同步动作类型
+ * 核心同步逻辑：对比本地笔记数据与远程GTask任务数据的状态（ID、修改时间、本地修改标记、GID等），
+ * 返回对应的同步动作常量（无操作、更新本地、更新远程、冲突、错误等）。
+ *
+ * @param c 本地数据库的Cursor对象（包含note表的核心字段）
+ * @return 同步动作类型（对应{@link Node}中的SYNC_ACTION_*常量）
+ */
+ public int getSyncAction(Cursor c) {
+ try {
+ // 从元信息中解析note核心字段（笔记基础信息）
+ JSONObject noteInfo = null;
+ if (mMetaInfo != null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) {
+ noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+ }
+
+ // 场景1：元信息中无note字段（笔记元数据被删除）→ 更新远程
+ if (noteInfo == null) {
+ Log.w(TAG, "it seems that note meta has been deleted");
+ return SYNC_ACTION_UPDATE_REMOTE;
+ }
+
+ // 场景2：note字段中无ID（远程笔记ID丢失）→ 更新本地
+ if (!noteInfo.has(NoteColumns.ID)) {
+ Log.w(TAG, "remote note id seems to be deleted");
+ return SYNC_ACTION_UPDATE_LOCAL;
+ }
+
+ // 校验笔记ID：本地Cursor中的ID与元信息中的ID必须匹配
+ if (c.getLong(SqlNote.ID_COLUMN) != noteInfo.getLong(NoteColumns.ID)) {
+ Log.w(TAG, "note id doesn't match");
+ return SYNC_ACTION_UPDATE_LOCAL;
+ }
+
+ // 核心同步逻辑：根据本地修改标记和同步时间判断
+ if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
+ // 子场景1：本地无修改
+ if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+ // 本地和远程都无修改 → 无操作
+ return SYNC_ACTION_NONE;
+ } else {
+ // 远程有修改 → 更新本地
+ return SYNC_ACTION_UPDATE_LOCAL;
+ }
+ } else {
+ // 子场景2：本地有修改
+ // 校验GTask ID：本地Cursor中的GID与任务的GID必须匹配，否则为错误
+ if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
+ Log.e(TAG, "gtask id doesn't match");
+ return SYNC_ACTION_ERROR;
+ }
+ if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+ // 仅本地有修改 → 更新远程
+ return SYNC_ACTION_UPDATE_REMOTE;
+ } else {
+ // 本地和远程都有修改 → 冲突
+ return SYNC_ACTION_UPDATE_CONFLICT;
+ }
+ }
+ } catch (Exception e) {
+ // 异常捕获：所有异常都标记为同步错误
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ }
+
+ return SYNC_ACTION_ERROR;
+ }
+
+ /**
+ * 判断当前任务是否值得保存（是否有有效数据）
+ * 判定条件：有元信息，或任务名称非空，或任务备注非空 → 值得保存
+ *
+ * @return true表示值得保存，false表示无需保存（空任务）
+ */
+ public boolean isWorthSaving() {
+ return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
+ || (getNotes() != null && getNotes().trim().length() > 0);
+ }
+
+ // ====================== 成员变量的setter/getter方法 ======================
+ /**
+ * 设置任务的完成状态
+ * @param completed true表示已完成，false表示未完成
+ */
+ public void setCompleted(boolean completed) {
+ this.mCompleted = completed;
+ }
+
+ /**
+ * 设置任务的备注信息
+ * @param notes 备注字符串
+ */
+ public void setNotes(String notes) {
+ this.mNotes = notes;
+ }
+
+ /**
+ * 设置任务的前序兄弟任务（用于排序）
+ * @param priorSibling 前序兄弟任务实例
+ */
+ public void setPriorSibling(Task priorSibling) {
+ this.mPriorSibling = priorSibling;
+ }
+
+ /**
+ * 设置任务的父任务列表（维护层级关系）
+ * @param parent 父任务列表实例
+ */
+ public void setParent(TaskList parent) {
+ this.mParent = parent;
+ }
+
+ /**
+ * 获取任务的完成状态
+ * @return true表示已完成，false表示未完成
+ */
+ public boolean getCompleted() {
+ return this.mCompleted;
+ }
+
+ /**
+ * 获取任务的备注信息
+ * @return 备注字符串，若未设置则返回null
+ */
+ public String getNotes() {
+ return this.mNotes;
+ }
+
+ /**
+ * 获取任务的前序兄弟任务
+ * @return 前序兄弟任务实例，若未设置则返回null
+ */
+ public Task getPriorSibling() {
+ return this.mPriorSibling;
+ }
+
+ /**
+ * 获取任务的父任务列表
+ * @return 父任务列表实例，若未设置则返回null
+ */
+ public TaskList getParent() {
+ return this.mParent;
+ }
+
+}
\ No newline at end of file
diff --git a/src/notes/gtask/data/TaskList.java b/src/notes/gtask/data/TaskList.java
new file mode 100644
index 0000000..28c6bc7
--- /dev/null
+++ b/src/notes/gtask/data/TaskList.java
@@ -0,0 +1,516 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.ArrayList;
+
+/**
+ * GTask任务列表类，继承自核心抽象节点类{@link Node}
+ * 该类是GTask中「任务列表（TaskList/Group）」的具体实现，对应本地笔记的「文件夹」/「系统文件夹」，
+ * 封装了任务列表的核心属性（排序索引、子任务列表），并实现了父类的抽象方法，完成以下核心功能：
+ * 1. 生成GTask的创建/更新动作JSON（用于向远程GTask服务发送请求）；
+ * 2. 从远程GTask的JSON数据初始化列表内容（远程→本地同步）；
+ * 3. 从本地文件夹的JSON数据初始化列表内容（本地→远程同步，区分普通文件夹/系统文件夹）；
+ * 4. 将列表内容序列化为本地文件夹的JSON数据（GTask→本地文件夹转换）；
+ * 5. 根据本地数据库Cursor判断同步动作类型（核心同步逻辑，文件夹冲突直接采用本地修改）；
+ * 6. 管理子任务的增删改查、排序与层级关系（维护子任务的前序兄弟、父列表关联）。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class TaskList extends Node {
+ /**
+ * 日志标签，使用类的简单名称，便于调试时定位日志来源
+ */
+ private static final String TAG = TaskList.class.getSimpleName();
+
+ // ====================== 成员变量 ======================
+ /**
+ * 任务列表的排序索引：用于GTask服务中任务列表的显示排序（默认值为1）
+ */
+ private int mIndex;
+
+ /**
+ * 子任务列表：存储当前任务列表下的所有{@link Task}实例，维护父子层级关系
+ */
+ private ArrayList mChildren;
+
+ /**
+ * 构造方法：初始化GTask任务列表的默认属性
+ * 调用父类{@link Node}的构造方法，初始化子任务列表为空集合，排序索引为1
+ */
+ public TaskList() {
+ super();
+ mChildren = new ArrayList(); // 初始化子任务列表
+ mIndex = 1; // 默认排序索引为1
+ }
+
+ /**
+ * 实现父类抽象方法：生成创建GTask任务列表的动作JSON对象
+ * 该JSON遵循GTask服务的接口规范，包含创建列表所需的所有参数（动作类型、ID、名称、类型、排序索引等），
+ * 用于向远程GTask服务发送创建任务列表的请求。
+ *
+ * @param actionId 动作唯一标识ID（用于GTask服务识别本次动作）
+ * @return 包含创建任务列表动作的JSON对象
+ * @throws ActionFailureException JSON生成失败时抛出该异常
+ */
+ public JSONObject getCreateAction(int actionId) {
+ JSONObject js = new JSONObject();
+
+ try {
+ // 1. 动作类型：创建（CREATE）
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+ GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
+
+ // 2. 动作ID：唯一标识本次创建动作
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+ // 3. 列表索引：用于GTask服务中列表的排序
+ js.put(GTaskStringUtils.GTASK_JSON_INDEX, mIndex);
+
+ // 4. 实体增量：任务列表的核心属性（名称、创建者、类型）
+ JSONObject entity = new JSONObject();
+ entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); // 列表名称（对应文件夹名称）
+ entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null"); // 创建者ID（此处设为null）
+ entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
+ GTaskStringUtils.GTASK_JSON_TYPE_GROUP); // 实体类型：分组（GROUP，对应任务列表）
+ js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+ } catch (JSONException e) {
+ // JSON解析/写入失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to generate tasklist-create jsonobject");
+ }
+
+ return js;
+ }
+
+ /**
+ * 实现父类抽象方法：生成更新GTask任务列表的动作JSON对象
+ * 该JSON遵循GTask服务的接口规范，包含更新列表所需的核心参数（动作类型、ID、名称、删除标记等），
+ * 用于向远程GTask服务发送更新任务列表的请求。
+ *
+ * @param actionId 动作唯一标识ID（用于GTask服务识别本次动作）
+ * @return 包含更新任务列表动作的JSON对象
+ * @throws ActionFailureException JSON生成失败时抛出该异常
+ */
+ public JSONObject getUpdateAction(int actionId) {
+ JSONObject js = new JSONObject();
+
+ try {
+ // 1. 动作类型：更新（UPDATE）
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+ GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
+
+ // 2. 动作ID：唯一标识本次更新动作
+ js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+ // 3. 列表ID：当前任务列表的GID（标识要更新的列表）
+ js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
+
+ // 4. 实体增量：需要更新的列表属性（名称、删除标记）
+ JSONObject entity = new JSONObject();
+ entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); // 列表名称
+ entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted()); // 删除标记（是否被删除）
+ js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+ } catch (JSONException e) {
+ // JSON解析/写入失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to generate tasklist-update jsonobject");
+ }
+
+ return js;
+ }
+
+ /**
+ * 实现父类抽象方法：根据远程GTask的JSON数据设置任务列表内容
+ * 从远程GTask返回的JSON中解析出列表的核心属性（GID、修改时间、名称），
+ * 完成远程GTask数据到本地TaskList对象的映射（远程→本地同步）。
+ *
+ * @param js 远程GTask返回的任务列表JSON对象
+ * @throws ActionFailureException JSON解析失败时抛出该异常
+ */
+ public void setContentByRemoteJSON(JSONObject js) {
+ if (js != null) {
+ try {
+ // 1. 列表GID：远程GTask的唯一标识
+ if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
+ setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
+ }
+
+ // 2. 最后修改时间：用于同步时的版本对比
+ if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
+ setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
+ }
+
+ // 3. 列表名称：对应本地文件夹的名称
+ if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
+ setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
+ }
+
+ } catch (JSONException e) {
+ // JSON解析失败，输出日志并抛出同步失败异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("fail to get tasklist content from jsonobject");
+ }
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：根据本地文件夹的JSON数据设置任务列表内容
+ * 从本地文件夹的JSON中解析出核心信息（区分普通文件夹/系统文件夹），
+ * 将文件夹名称（添加MIUI前缀）映射为GTask列表名称，完成本地文件夹到GTask TaskList对象的映射（本地→远程同步）。
+ *
+ * @param js 本地文件夹的JSON对象（包含note核心字段）
+ */
+ public void setContentByLocalJSON(JSONObject js) {
+ // 校验JSON的有效性：必须包含note核心字段
+ if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
+ Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+ return;
+ }
+
+ try {
+ // 解析note核心字段（文件夹基础信息）
+ JSONObject folder = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+
+ // 场景1：普通文件夹（TYPE_FOLDER）→ 名称添加MIUI前缀
+ if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
+ String name = folder.getString(NoteColumns.SNIPPET);
+ setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + name);
+ }
+ // 场景2：系统文件夹（TYPE_SYSTEM）→ 根据ID映射为固定名称（根文件夹/通话记录文件夹）
+ else if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
+ if (folder.getLong(NoteColumns.ID) == Notes.ID_ROOT_FOLDER) {
+ // 根文件夹：映射为默认文件夹名称（添加MIUI前缀）
+ setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT);
+ } else if (folder.getLong(NoteColumns.ID) == Notes.ID_CALL_RECORD_FOLDER) {
+ // 通话记录文件夹：映射为通话笔记文件夹名称（添加MIUI前缀）
+ setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE);
+ } else {
+ Log.e(TAG, "invalid system folder");
+ }
+ }
+ // 场景3：无效类型 → 输出错误日志
+ else {
+ Log.e(TAG, "error type");
+ }
+ } catch (JSONException e) {
+ // JSON解析失败，输出日志
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：将任务列表内容序列化为本地文件夹的JSON对象
+ * 移除列表名称的MIUI前缀，根据名称判断文件夹类型（系统/普通），
+ * 完成GTask TaskList对象到本地文件夹JSON的映射（GTask→本地文件夹转换）。
+ *
+ * @return 本地文件夹的JSON对象，若序列化失败则返回null
+ */
+ public JSONObject getLocalJSONFromContent() {
+ try {
+ JSONObject js = new JSONObject();
+ JSONObject folder = new JSONObject();
+
+ // 移除列表名称的MIUI前缀，还原本地文件夹名称
+ String folderName = getName();
+ if (getName().startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)) {
+ folderName = folderName.substring(GTaskStringUtils.MIUI_FOLDER_PREFFIX.length(), folderName.length());
+ }
+ // 设置文件夹名称（SNIPPET字段）
+ folder.put(NoteColumns.SNIPPET, folderName);
+
+ // 判断文件夹类型：默认/通话笔记文件夹为系统类型，其余为普通文件夹
+ if (folderName.equals(GTaskStringUtils.FOLDER_DEFAULT) || folderName.equals(GTaskStringUtils.FOLDER_CALL_NOTE)) {
+ folder.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+ } else {
+ folder.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
+ }
+
+ // 写入note核心字段
+ js.put(GTaskStringUtils.META_HEAD_NOTE, folder);
+
+ return js;
+ } catch (JSONException e) {
+ // JSON序列化失败，输出日志并返回null
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ return null;
+ }
+ }
+
+ /**
+ * 实现父类抽象方法：根据本地数据库Cursor判断当前任务列表的同步动作类型
+ * 核心同步逻辑：对比本地文件夹数据与远程GTask列表数据的状态（本地修改标记、同步时间、GID），
+ * 特别处理文件夹冲突：直接采用本地修改（返回更新远程），其余逻辑与Task一致。
+ *
+ * @param c 本地数据库的Cursor对象（包含note表的核心字段）
+ * @return 同步动作类型（对应{@link Node}中的SYNC_ACTION_*常量）
+ */
+ public int getSyncAction(Cursor c) {
+ try {
+ if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
+ // 子场景1：本地无修改
+ if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+ // 本地和远程都无修改 → 无操作
+ return SYNC_ACTION_NONE;
+ } else {
+ // 远程有修改 → 更新本地
+ return SYNC_ACTION_UPDATE_LOCAL;
+ }
+ } else {
+ // 子场景2：本地有修改
+ // 校验GTask ID：本地Cursor中的GID与列表的GID必须匹配，否则为错误
+ if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
+ Log.e(TAG, "gtask id doesn't match");
+ return SYNC_ACTION_ERROR;
+ }
+ if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+ // 仅本地有修改 → 更新远程
+ return SYNC_ACTION_UPDATE_REMOTE;
+ } else {
+ // 本地和远程都有修改（文件夹冲突）→ 直接采用本地修改，更新远程
+ return SYNC_ACTION_UPDATE_REMOTE;
+ }
+ }
+ } catch (Exception e) {
+ // 异常捕获：所有异常都标记为同步错误
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ }
+
+ return SYNC_ACTION_ERROR;
+ }
+
+ // ====================== 子任务管理：基础查询方法 ======================
+ /**
+ * 获取子任务的数量
+ * @return 子任务列表的大小
+ */
+ public int getChildTaskCount() {
+ return mChildren.size();
+ }
+
+ /**
+ * 根据GID查找子任务
+ * @param gid 子任务的GID
+ * @return 匹配的{@link Task}实例，未找到则返回null（注：与getChilTaskByGid方法重复，保留原有逻辑）
+ */
+ public Task findChildTaskByGid(String gid) {
+ for (int i = 0; i < mChildren.size(); i++) {
+ Task t = mChildren.get(i);
+ if (t.getGid().equals(gid)) {
+ return t;
+ }
+ }
+ return null;
+ }
+
+ /**
+ * 获取子任务在列表中的索引位置
+ * @param task 子任务实例
+ * @return 子任务的索引，未找到则返回-1
+ */
+ public int getChildTaskIndex(Task task) {
+ return mChildren.indexOf(task);
+ }
+
+ /**
+ * 根据索引获取子任务
+ * @param index 子任务的索引
+ * @return 对应索引的{@link Task}实例，索引无效则返回null
+ */
+ public Task getChildTaskByIndex(int index) {
+ if (index < 0 || index >= mChildren.size()) {
+ Log.e(TAG, "getTaskByIndex: invalid index");
+ return null;
+ }
+ return mChildren.get(index);
+ }
+
+ /**
+ * 根据GID查找子任务（与findChildTaskByGid方法重复，保留原有逻辑）
+ * @param gid 子任务的GID
+ * @return 匹配的{@link Task}实例，未找到则返回null
+ */
+ public Task getChilTaskByGid(String gid) {
+ for (Task task : mChildren) {
+ if (task.getGid().equals(gid))
+ return task;
+ }
+ return null;
+ }
+
+ /**
+ * 获取子任务列表的完整集合
+ * @return 子任务的ArrayList集合
+ */
+ public ArrayList getChildTaskList() {
+ return this.mChildren;
+ }
+
+ // ====================== 子任务管理：增删改查与排序 ======================
+ /**
+ * 追加添加子任务到列表末尾，并维护子任务的前序兄弟和父列表关联
+ * @param task 要添加的子任务实例
+ * @return true表示添加成功，false表示任务为空或已存在
+ */
+ public boolean addChildTask(Task task) {
+ boolean ret = false;
+ // 校验任务有效性：非空且未存在于列表中
+ if (task != null && !mChildren.contains(task)) {
+ ret = mChildren.add(task);
+ if (ret) {
+ // 设置子任务的前序兄弟（列表最后一个元素的前一个元素）
+ task.setPriorSibling(mChildren.isEmpty() ? null : mChildren.get(mChildren.size() - 1));
+ // 设置子任务的父列表为当前列表
+ task.setParent(this);
+ }
+ }
+ return ret;
+ }
+
+ /**
+ * 在指定索引位置添加子任务，并更新相关子任务的前序兄弟关联（维护排序）
+ * @param task 要添加的子任务实例
+ * @param index 要添加的索引位置
+ * @return true表示添加成功，false表示索引无效或任务已存在
+ */
+ public boolean addChildTask(Task task, int index) {
+ // 校验索引有效性
+ if (index < 0 || index > mChildren.size()) {
+ Log.e(TAG, "add child task: invalid index");
+ return false;
+ }
+
+ // 检查任务是否已存在
+ int pos = mChildren.indexOf(task);
+ if (task != null && pos == -1) {
+ // 在指定索引添加任务
+ mChildren.add(index, task);
+
+ // 获取当前任务的前序和后序任务（用于维护排序）
+ Task preTask = null; // 前序任务
+ Task afterTask = null; // 后序任务
+ if (index != 0) {
+ preTask = mChildren.get(index - 1);
+ }
+ if (index != mChildren.size() - 1) {
+ afterTask = mChildren.get(index + 1);
+ }
+
+ // 设置当前任务的前序兄弟
+ task.setPriorSibling(preTask);
+ // 更新后序任务的前序兄弟为当前任务
+ if (afterTask != null) {
+ afterTask.setPriorSibling(task);
+ }
+ }
+
+ return true;
+ }
+
+ /**
+ * 从列表中移除子任务，并重置该任务的关联关系，同时更新后续任务的前序兄弟关联
+ * @param task 要移除的子任务实例
+ * @return true表示移除成功，false表示任务不存在
+ */
+ public boolean removeChildTask(Task task) {
+ boolean ret = false;
+ // 获取任务的索引位置
+ int index = mChildren.indexOf(task);
+ if (index != -1) {
+ // 移除任务
+ ret = mChildren.remove(task);
+
+ if (ret) {
+ // 重置该任务的前序兄弟和父列表关联
+ task.setPriorSibling(null);
+ task.setParent(null);
+
+ // 更新后续任务的前序兄弟关联（若存在后续任务）
+ if (index != mChildren.size()) {
+ mChildren.get(index).setPriorSibling(index == 0 ? null : mChildren.get(index - 1));
+ }
+ }
+ }
+ return ret;
+ }
+
+ /**
+ * 将子任务移动到指定索引位置（先移除后添加，维护排序）
+ * @param task 要移动的子任务实例
+ * @param index 目标索引位置
+ * @return true表示移动成功，false表示索引无效、任务不存在或位置未变
+ */
+ public boolean moveChildTask(Task task, int index) {
+ // 校验索引有效性
+ if (index < 0 || index >= mChildren.size()) {
+ Log.e(TAG, "move child task: invalid index");
+ return false;
+ }
+
+ // 检查任务是否存在于列表中
+ int pos = mChildren.indexOf(task);
+ if (pos == -1) {
+ Log.e(TAG, "move child task: the task should in the list");
+ return false;
+ }
+
+ // 位置未变，直接返回成功
+ if (pos == index) {
+ return true;
+ }
+
+ // 先移除任务，再添加到指定索引位置
+ return (removeChildTask(task) && addChildTask(task, index));
+ }
+
+ // ====================== 成员变量的setter/getter方法 ======================
+ /**
+ * 设置任务列表的排序索引
+ * @param index 新的排序索引
+ */
+ public void setIndex(int index) {
+ this.mIndex = index;
+ }
+
+ /**
+ * 获取任务列表的排序索引
+ * @return 排序索引值
+ */
+ public int getIndex() {
+ return this.mIndex;
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/exception/ActionFailureException.java b/src/notes/gtask/exception/ActionFailureException.java
new file mode 100644
index 0000000..d9466fe
--- /dev/null
+++ b/src/notes/gtask/exception/ActionFailureException.java
@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * GTask同步动作失败的自定义运行时异常类
+ * 该异常继承自{@link RuntimeException}（非受检异常），用于封装GTask同步过程中各类动作失败的场景，
+ * 主要包括：
+ * 1. 生成GTask创建/更新动作的JSON对象失败（如{@link net.micode.notes.gtask.data.Task#getCreateAction(int)}）；
+ * 2. 从远程GTask的JSON数据解析内容失败（如{@link net.micode.notes.gtask.data.TaskList#setContentByRemoteJSON(org.json.JSONObject)}）；
+ * 3. 其他GTask同步相关的核心动作执行失败。
+ * 采用运行时异常的设计，允许在同步流程中快速抛出并处理失败，无需强制捕获，简化代码逻辑。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class ActionFailureException extends RuntimeException {
+ /**
+ * 序列化版本号（Serial Version UID）
+ * 用于Java对象序列化的版本一致性校验，固定值保证序列化/反序列化时的兼容性。
+ */
+ private static final long serialVersionUID = 4425249765923293627L;
+
+ /**
+ * 无参构造方法：创建一个空的GTask动作失败异常
+ * 调用父类{@link RuntimeException}的无参构造方法，无异常消息和根因。
+ */
+ public ActionFailureException() {
+ super();
+ }
+
+ /**
+ * 带异常消息的构造方法：创建包含指定错误信息的GTask动作失败异常
+ * 调用父类的对应构造方法，传入自定义的异常描述信息，便于定位失败原因。
+ *
+ * @param paramString 异常的详细描述消息（如"fail to generate task-create jsonobject"）
+ */
+ public ActionFailureException(String paramString) {
+ super(paramString);
+ }
+
+ /**
+ * 带异常消息和根因的构造方法：创建包含错误信息和底层异常的GTask动作失败异常
+ * 调用父类的对应构造方法，既传入自定义消息，又关联底层异常（如{@link org.json.JSONException}），
+ * 便于追溯异常的完整调用链。
+ *
+ * @param paramString 异常的详细描述消息
+ * @param paramThrowable 底层异常（根因异常，如JSON解析异常、IO异常等）
+ */
+ public ActionFailureException(String paramString, Throwable paramThrowable) {
+ super(paramString, paramThrowable);
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/exception/NetworkFailureException.java b/src/notes/gtask/exception/NetworkFailureException.java
new file mode 100644
index 0000000..3f39f6e
--- /dev/null
+++ b/src/notes/gtask/exception/NetworkFailureException.java
@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * GTask同步过程中网络操作失败的自定义受检异常类
+ * 该异常继承自{@link Exception}（受检异常），用于封装GTask同步流程中各类网络相关的失败场景，
+ * 主要包括：
+ * 1. 与GTask远程服务的网络连接失败（如无网络、连接超时）；
+ * 2. 向GTask服务发送请求/接收响应时的网络传输失败；
+ * 3. 网络IO异常、数据接收不完整等网络相关错误。
+ * 作为受检异常，调用者必须显式捕获并处理该异常，强制开发者关注网络操作的容错处理，提升程序健壮性。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class NetworkFailureException extends Exception {
+ /**
+ * 序列化版本号（Serial Version UID）
+ * 用于Java对象序列化的版本一致性校验，固定值保证异常对象在序列化/反序列化时的兼容性，
+ * 是Java序列化机制的标准规范要求。
+ */
+ private static final long serialVersionUID = 2107610287180234136L;
+
+ /**
+ * 无参构造方法：创建一个空的网络失败异常
+ * 调用父类{@link Exception}的无参构造方法，无异常消息和根因，适用于无需详细描述的网络失败场景。
+ */
+ public NetworkFailureException() {
+ super();
+ }
+
+ /**
+ * 带异常消息的构造方法：创建包含指定错误信息的网络失败异常
+ * 调用父类的对应构造方法，传入自定义的异常描述信息（如"network connection timeout"），
+ * 便于开发者快速定位网络失败的具体原因。
+ *
+ * @param paramString 异常的详细描述消息，用于说明网络失败的具体情况
+ */
+ public NetworkFailureException(String paramString) {
+ super(paramString);
+ }
+
+ /**
+ * 带异常消息和根因的构造方法：创建包含错误信息和底层异常的网络失败异常
+ * 调用父类的对应构造方法，既传入自定义消息，又关联底层的根因异常（如{@link java.net.SocketTimeoutException}、{@link java.io.IOException}等），
+ * 便于追溯网络异常的完整调用链，排查底层问题。
+ *
+ * @param paramString 异常的详细描述消息
+ * @param paramThrowable 底层根因异常（如Socket超时、IO异常等网络相关的原始异常）
+ */
+ public NetworkFailureException(String paramString, Throwable paramThrowable) {
+ super(paramString, paramThrowable);
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/remote/GTaskASyncTask.java b/src/notes/gtask/remote/GTaskASyncTask.java
new file mode 100644
index 0000000..a466c1a
--- /dev/null
+++ b/src/notes/gtask/remote/GTaskASyncTask.java
@@ -0,0 +1,262 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.AsyncTask;
+import android.os.Build;
+
+import androidx.core.app.NotificationCompat;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesListActivity;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+/**
+ * GTask同步的异步任务类，继承自{@link AsyncTask}
+ * 该类负责在后台线程执行GTask的同步逻辑，在主线程更新同步进度、显示系统通知，并处理同步结果，
+ * 同时适配Android 8.0+的通知渠道机制和高版本PendingIntent的FLAG_IMMUTABLE要求，
+ * 是GTask同步功能与用户交互的核心类。
+ *
+ * 泛型说明：
+ * - 第一个泛型：doInBackground的输入参数类型，无参数
+ * - 第二个泛型：进度更新的参数类型，传递同步进度消息
+ * - 第三个泛型：后台任务返回的结果类型，传递同步状态码
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ * @modified 适配Android O+通知渠道、高版本PendingIntent标记
+ */
+public class GTaskASyncTask extends AsyncTask {
+
+ /**
+ * GTask同步通知的唯一标识ID，用于发送和取消通知
+ */
+ private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
+
+ /**
+ * 通知渠道ID（Android 8.0+必需），用于标识GTask同步的通知渠道
+ */
+ private static final String CHANNEL_ID = "gtask_sync_channel";
+
+ /**
+ * 同步完成的回调接口，用于在同步任务结束后触发后续操作
+ */
+ public interface OnCompleteListener {
+ /**
+ * 同步任务完成时的回调方法
+ */
+ void onComplete();
+ }
+
+ // ====================== 成员变量 ======================
+ /**
+ * 上下文对象，用于获取系统服务、资源、启动界面等
+ */
+ private Context mContext;
+
+ /**
+ * 通知管理器，用于发送和管理系统通知
+ */
+ private NotificationManager mNotifiManager;
+
+ /**
+ * GTask管理器实例，用于执行实际的GTask同步逻辑
+ */
+ private GTaskManager mTaskManager;
+
+ /**
+ * 同步完成的回调监听者，接收同步结束的通知
+ */
+ private OnCompleteListener mOnCompleteListener;
+
+ /**
+ * 构造方法：初始化GTask同步异步任务
+ * @param context 上下文对象，不能为null
+ * @param listener 同步完成的回调监听者，可为null（不处理回调）
+ */
+ public GTaskASyncTask(Context context, OnCompleteListener listener) {
+ mContext = context;
+ mOnCompleteListener = listener;
+ // 获取系统通知管理器服务
+ mNotifiManager = (NotificationManager) mContext
+ .getSystemService(Context.NOTIFICATION_SERVICE);
+ // 获取GTaskManager单例实例
+ mTaskManager = GTaskManager.getInstance();
+ // 初始化通知渠道（仅Android 8.0+需要，否则通知无法显示）
+ createNotificationChannel();
+ }
+
+ /**
+ * （新增适配方法）创建通知渠道（Android 8.0+必需）
+ * Android 8.0（API 26）及以上版本要求所有通知必须属于某个通知渠道，否则无法显示
+ */
+ private void createNotificationChannel() {
+ // 判断系统版本是否为Android O及以上
+ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+ // 渠道名称：使用应用名称（从资源文件获取）
+ CharSequence name = mContext.getString(R.string.app_name);
+ // 渠道描述：说明该渠道的用途（GTask同步通知）
+ String description = "GTask同步通知";
+ // 通知重要性：默认级别（可弹出、有声音、在状态栏显示）
+ int importance = NotificationManager.IMPORTANCE_DEFAULT;
+ // 创建通知渠道实例
+ NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
+ channel.setDescription(description);
+ // 向系统注册通知渠道（必须通过NotificationManager注册）
+ if (mNotifiManager != null) {
+ mNotifiManager.createNotificationChannel(channel);
+ }
+ }
+ }
+
+ /**
+ * 取消当前的GTask同步任务
+ * 调用GTaskManager的取消方法，终止正在执行的同步逻辑
+ */
+ public void cancelSync() {
+ mTaskManager.cancelSync();
+ }
+
+ /**
+ * 发布同步进度（封装AsyncTask的publishProgress方法，简化调用）
+ * @param message 同步进度的提示消息，将在通知中显示
+ */
+ public void publishProgess(String message) {
+ publishProgress(new String[] {
+ message
+ });
+ }
+
+ /**
+ * 显示系统通知，用于展示同步进度、结果、错误信息等
+ * 使用NotificationCompat兼容库构建通知，适配不同Android版本
+ * @param tickerId 通知滚动提示文字的资源ID（如同步中、成功、失败）
+ * @param content 通知的详细内容文字
+ */
+ private void showNotification(int tickerId, String content) {
+ // 使用NotificationCompat.Builder构建通知（兼容低版本），关联指定的通知渠道
+ NotificationCompat.Builder builder = new NotificationCompat.Builder(mContext, CHANNEL_ID)
+ .setSmallIcon(R.drawable.notification) // 通知小图标（必需，从资源文件获取）
+ .setContentTitle(mContext.getString(R.string.app_name)) // 通知标题（应用名称）
+ .setContentText(content) // 通知详细内容
+ .setTicker(mContext.getString(tickerId)) // 状态栏滚动提示文字
+ .setWhen(System.currentTimeMillis()) // 通知创建时间（当前时间戳）
+ .setDefaults(Notification.DEFAULT_LIGHTS) // 通知灯光效果（使用系统默认）
+ .setAutoCancel(true); // 点击通知后自动取消
+
+ // 设置通知的跳转意图（PendingIntent）：根据提示类型跳转到不同界面
+ PendingIntent pendingIntent;
+ if (tickerId != R.string.ticker_success) {
+ // 同步失败/取消：跳转到笔记设置界面（NotesPreferenceActivity）
+ pendingIntent = PendingIntent.getActivity(
+ mContext,
+ 0,
+ new Intent(mContext, NotesPreferenceActivity.class),
+ PendingIntent.FLAG_IMMUTABLE // 高版本Android要求使用IMMUTABLE标记，避免安全警告
+ );
+ } else {
+ // 同步成功：跳转到笔记列表界面（NotesListActivity）
+ pendingIntent = PendingIntent.getActivity(
+ mContext,
+ 0,
+ new Intent(mContext, NotesListActivity.class),
+ PendingIntent.FLAG_IMMUTABLE // 高版本Android要求使用IMMUTABLE标记
+ );
+ }
+ // 为通知设置跳转意图
+ builder.setContentIntent(pendingIntent);
+
+ // 发送通知：使用固定的通知ID，后续通知会覆盖之前的通知
+ mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, builder.build());
+ }
+
+ /**
+ * AsyncTask后台任务方法：在子线程执行GTask同步逻辑
+ * 该方法运行在非主线程，不能更新UI，可通过publishProgress更新进度
+ * @param unused 输入参数（无参数，泛型为Void）
+ * @return 同步状态码（对应GTaskManager的STATE_*常量，如成功、网络错误、内部错误等）
+ */
+ @Override
+ protected Integer doInBackground(Void... unused) {
+ // 发布初始进度：显示登录中（同步账户名）
+ publishProgess(mContext.getString(
+ R.string.sync_progress_login,
+ NotesPreferenceActivity.getSyncAccountName(mContext)
+ ));
+ // 调用GTaskManager执行同步逻辑，传入上下文和当前任务（用于进度回调）
+ return mTaskManager.sync(mContext, this);
+ }
+
+ /**
+ * AsyncTask进度更新方法：在主线程处理进度更新（由publishProgress触发）
+ * 该方法运行在主线程，可更新UI、显示通知
+ * @param progress 进度消息数组（对应泛型String，仅取第一个元素）
+ */
+ @Override
+ protected void onProgressUpdate(String... progress) {
+ // 显示同步中的通知，内容为进度消息
+ showNotification(R.string.ticker_syncing, progress[0]);
+ // 如果上下文是GTaskSyncService，发送广播更新同步进度（服务端的进度通知）
+ if (mContext instanceof GTaskSyncService) {
+ ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
+ }
+ }
+
+ /**
+ * AsyncTask结果处理方法：在主线程处理同步结果（后台任务完成后触发）
+ * 该方法运行在主线程，可更新UI、显示结果通知、触发回调
+ * @param result 后台任务返回的同步状态码（GTaskManager的STATE_*常量）
+ */
+ @Override
+ protected void onPostExecute(Integer result) {
+ // 根据同步状态码显示对应的通知
+ if (result == GTaskManager.STATE_SUCCESS) {
+ // 同步成功：显示成功通知，记录最后同步时间
+ showNotification(
+ R.string.ticker_success,
+ mContext.getString(R.string.success_sync_account, mTaskManager.getSyncAccount())
+ );
+ // 更新SharedPreferences中的最后同步时间为当前时间
+ NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
+ } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
+ // 网络错误：显示网络异常通知
+ showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network));
+ } else if (result == GTaskManager.STATE_INTERNAL_ERROR) {
+ // 内部错误：显示内部异常通知
+ showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_internal));
+ } else if (result == GTaskManager.STATE_SYNC_CANCELLED) {
+ // 同步取消：显示取消通知
+ showNotification(R.string.ticker_cancel, mContext.getString(R.string.error_sync_cancelled));
+ }
+
+ // 触发同步完成的回调（在新线程执行，避免阻塞主线程）
+ if (mOnCompleteListener != null) {
+ new Thread(new Runnable() {
+ @Override
+ public void run() {
+ mOnCompleteListener.onComplete();
+ }
+ }).start();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/remote/GTaskClient.java b/src/notes/gtask/remote/GTaskClient.java
new file mode 100644
index 0000000..fc25081
--- /dev/null
+++ b/src/notes/gtask/remote/GTaskClient.java
@@ -0,0 +1,849 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.accounts.AccountManagerFuture;
+import android.app.Activity;
+import android.os.Bundle;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.gtask.data.Node;
+import net.micode.notes.gtask.data.Task;
+import net.micode.notes.gtask.data.TaskList;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.gtask.exception.NetworkFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.client.ClientProtocolException;
+import org.apache.http.client.entity.UrlEncodedFormEntity;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.methods.HttpPost;
+import org.apache.http.cookie.Cookie;
+import org.apache.http.impl.client.BasicCookieStore;
+import org.apache.http.impl.client.DefaultHttpClient;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.params.BasicHttpParams;
+import org.apache.http.params.HttpConnectionParams;
+import org.apache.http.params.HttpParams;
+import org.apache.http.params.HttpProtocolParams;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.zip.GZIPInputStream;
+import java.util.zip.Inflater;
+import java.util.zip.InflaterInputStream;
+
+/**
+ * GTask客户端核心类，采用**单例模式**实现，负责与Google Tasks（GTask）服务进行底层网络交互
+ * 该类是GTask同步功能的核心通信层，主要完成以下职责：
+ * 1. Google账户认证：获取Google账户的AuthToken，处理账户切换、Token失效重取逻辑；
+ * 2. GTask服务登录：通过AuthToken登录GTask服务，获取认证Cookie和客户端版本号（client_version）；
+ * 3. HTTP请求处理：封装GET/POST请求，处理Gzip/Deflate压缩的响应数据，解析JSON结果；
+ * 4. GTask核心操作：实现任务（Task）/任务列表（TaskList）的创建、更新、删除、移动，以及列表数据的获取；
+ * 5. 批量更新优化：维护更新动作数组，限制单次批量更新的最大数量（10条），减少网络请求次数。
+ *
+ * 注意：该类依赖Apache HttpClient（已被Android高版本弃用，但保留原有逻辑），
+ * 所有网络操作会抛出{@link NetworkFailureException}（网络异常）或{@link ActionFailureException}（业务逻辑异常）。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class GTaskClient {
+ /**
+ * 日志标签，使用类的简单名称，便于调试时定位日志来源
+ */
+ private static final String TAG = GTaskClient.class.getSimpleName();
+
+ // ====================== GTask服务URL常量 ======================
+ /**
+ * GTask服务基础URL
+ */
+ private static final String GTASK_URL = "https://mail.google.com/tasks/";
+
+ /**
+ * GTask服务GET请求URL（用于登录、获取任务列表元数据）
+ */
+ private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig";
+
+ /**
+ * GTask服务POST请求URL（用于执行创建、更新、移动、删除等操作）
+ */
+ private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig";
+
+ // ====================== 单例模式相关 ======================
+ /**
+ * GTaskClient单例实例，通过{@link #getInstance()}获取
+ */
+ private static GTaskClient mInstance = null;
+
+ // ====================== 网络请求相关成员变量 ======================
+ /**
+ * Apache HttpClient实例，用于发送HTTP请求、管理Cookie
+ */
+ private DefaultHttpClient mHttpClient;
+
+ /**
+ * 动态的GTask GET请求URL（适配自定义域名账户，如企业邮箱）
+ */
+ private String mGetUrl;
+
+ /**
+ * 动态的GTask POST请求URL（适配自定义域名账户）
+ */
+ private String mPostUrl;
+
+ // ====================== GTask服务认证/版本相关 ======================
+ /**
+ * GTask客户端版本号（从GTask服务返回的JSON中解析，用于请求标识）
+ */
+ private long mClientVersion;
+
+ /**
+ * 登录状态标记：true表示已成功登录GTask服务，false表示未登录/需要重新登录
+ */
+ private boolean mLoggedin;
+
+ /**
+ * 最后一次登录时间戳（用于判断是否需要重新登录，默认5分钟有效期）
+ */
+ private long mLastLoginTime;
+
+ /**
+ * 动作ID：自增的唯一标识，用于标记每个GTask操作的动作（创建、更新等）
+ */
+ private int mActionId;
+
+ /**
+ * 当前同步的Google账户实例（存储账户名称、类型等信息）
+ */
+ private Account mAccount;
+
+ // ====================== 批量更新相关 ======================
+ /**
+ * 更新动作数组：存储待提交的更新动作（Task/TaskList的updateAction），用于批量提交
+ */
+ private JSONArray mUpdateArray;
+
+ /**
+ * 私有构造方法：初始化GTaskClient的默认属性（单例模式禁止外部实例化）
+ * 初始化URL、状态标记、计数器等为默认值，确保单例的唯一性
+ */
+ private GTaskClient() {
+ mHttpClient = null;
+ mGetUrl = GTASK_GET_URL; // 默认使用官方GET URL
+ mPostUrl = GTASK_POST_URL; // 默认使用官方POST URL
+ mClientVersion = -1; // 初始化为无效版本号
+ mLoggedin = false; // 初始未登录
+ mLastLoginTime = 0; // 初始无登录时间
+ mActionId = 1; // 动作ID从1开始自增
+ mAccount = null; // 初始无账户
+ mUpdateArray = null; // 初始无批量更新动作
+ }
+
+ /**
+ * 获取GTaskClient的单例实例（线程安全的同步方法）
+ * @return GTaskClient唯一实例
+ */
+ public static synchronized GTaskClient getInstance() {
+ if (mInstance == null) {
+ mInstance = new GTaskClient();
+ }
+ return mInstance;
+ }
+
+ /**
+ * 执行GTask服务的登录流程（核心登录方法）
+ * 登录逻辑分为三步：
+ * 1. 检查登录状态：若5分钟内已登录且账户未切换，直接返回成功；
+ * 2. 获取Google账户的AuthToken：通过AccountManager获取当前同步账户的认证Token；
+ * 3. 登录GTask服务：先尝试自定义域名URL（非Gmail账户），失败则使用官方URL；
+ * @param activity 上下文Activity（用于AccountManager获取Token、处理账户授权）
+ * @return true表示登录成功，false表示登录失败
+ */
+ public boolean login(Activity activity) {
+ // 步骤1：判断登录有效期（5分钟），超时则标记为未登录
+ final long interval = 1000 * 60 * 5; // 5分钟毫秒数
+ if (mLastLoginTime + interval < System.currentTimeMillis()) {
+ mLoggedin = false;
+ }
+
+ // 步骤2：判断账户是否切换，切换则标记为未登录
+ if (mLoggedin && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity.getSyncAccountName(activity))) {
+ mLoggedin = false;
+ }
+
+ // 步骤3：已登录则直接返回成功
+ if (mLoggedin) {
+ Log.d(TAG, "already logged in");
+ return true;
+ }
+
+ // 步骤4：记录本次登录时间，开始新的登录流程
+ mLastLoginTime = System.currentTimeMillis();
+ // 获取Google账户的AuthToken
+ String authToken = loginGoogleAccount(activity, false);
+ if (authToken == null) {
+ Log.e(TAG, "login google account failed");
+ return false;
+ }
+
+ // 步骤5：处理非Gmail/GoogleMail账户（自定义域名，如企业邮箱）
+ if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase().endsWith("googlemail.com"))) {
+ // 构建自定义域名的GTask URL
+ StringBuilder url = new StringBuilder(GTASK_URL).append("a/");
+ int index = mAccount.name.indexOf('@') + 1; // 截取@后的域名部分
+ String suffix = mAccount.name.substring(index);
+ url.append(suffix + "/");
+ mGetUrl = url.toString() + "ig"; // 自定义GET URL
+ mPostUrl = url.toString() + "r/ig"; // 自定义POST URL
+
+ // 尝试使用自定义URL登录GTask
+ if (tryToLoginGtask(activity, authToken)) {
+ mLoggedin = true;
+ }
+ }
+
+ // 步骤6：自定义URL登录失败/是Gmail账户，使用官方URL登录
+ if (!mLoggedin) {
+ mGetUrl = GTASK_GET_URL;
+ mPostUrl = GTASK_POST_URL;
+ if (!tryToLoginGtask(activity, authToken)) {
+ return false;
+ }
+ }
+
+ // 登录成功，标记状态
+ mLoggedin = true;
+ return true;
+ }
+
+ /**
+ * 登录Google账户并获取AuthToken（底层账户认证方法）
+ * 流程：
+ * 1. 获取设备上的所有Google账户；
+ * 2. 匹配设置中的同步账户名称；
+ * 3. 通过AccountManager获取该账户的AuthToken（类型为goanna_mobile）；
+ * 4. 若传入invalidateToken为true，失效旧Token并重新获取；
+ * @param activity 上下文Activity
+ * @param invalidateToken 是否失效旧的AuthToken（用于Token过期时重取）
+ * @return Google账户的AuthToken，获取失败则返回null
+ */
+ private String loginGoogleAccount(Activity activity, boolean invalidateToken) {
+ String authToken;
+ // 获取AccountManager服务
+ AccountManager accountManager = AccountManager.get(activity);
+ // 获取所有Google类型的账户（type为com.google）
+ Account[] accounts = accountManager.getAccountsByType("com.google");
+
+ // 无Google账户，返回null
+ if (accounts.length == 0) {
+ Log.e(TAG, "there is no available google account");
+ return null;
+ }
+
+ // 获取设置中的同步账户名称
+ String accountName = NotesPreferenceActivity.getSyncAccountName(activity);
+ Account account = null;
+ // 匹配账户名称
+ for (Account a : accounts) {
+ if (a.name.equals(accountName)) {
+ account = a;
+ break;
+ }
+ }
+
+ // 匹配成功，存储账户实例
+ if (account != null) {
+ mAccount = account;
+ } else {
+ Log.e(TAG, "unable to get an account with the same name in the settings");
+ return null;
+ }
+
+ // 获取AuthToken
+ AccountManagerFuture accountManagerFuture = accountManager.getAuthToken(
+ account,
+ "goanna_mobile", // GTask服务的Token类型
+ null,
+ activity,
+ null,
+ null
+ );
+
+ try {
+ // 获取Token结果
+ Bundle authTokenBundle = accountManagerFuture.getResult();
+ authToken = authTokenBundle.getString(AccountManager.KEY_AUTHTOKEN);
+ // 失效旧Token并重新获取（递归调用）
+ if (invalidateToken) {
+ accountManager.invalidateAuthToken("com.google", authToken);
+ authToken = loginGoogleAccount(activity, false);
+ }
+ } catch (Exception e) {
+ Log.e(TAG, "get auth token failed");
+ authToken = null;
+ }
+
+ return authToken;
+ }
+
+ /**
+ * 尝试登录GTask服务（处理Token失效重取逻辑）
+ * 流程：
+ * 1. 使用传入的AuthToken登录GTask；
+ * 2. 若登录失败，失效旧Token并重新获取，再次尝试登录；
+ * 3. 两次失败则返回false，否则返回true；
+ * @param activity 上下文Activity
+ * @param authToken Google账户的AuthToken
+ * @return true表示登录成功，false表示登录失败
+ */
+ private boolean tryToLoginGtask(Activity activity, String authToken) {
+ if (!loginGtask(authToken)) {
+ // Token过期，失效并重新获取
+ authToken = loginGoogleAccount(activity, true);
+ if (authToken == null) {
+ Log.e(TAG, "login google account failed");
+ return false;
+ }
+
+ // 再次尝试登录
+ if (!loginGtask(authToken)) {
+ Log.e(TAG, "login gtask failed");
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * 实际执行GTask服务的登录（核心网络登录方法）
+ * 流程：
+ * 1. 初始化HttpClient：设置连接超时、Socket超时，配置CookieStore；
+ * 2. 发送GET请求：携带AuthToken访问GTask的GET URL，获取响应；
+ * 3. 检查认证Cookie：判断响应中是否包含GTL认证Cookie；
+ * 4. 解析客户端版本号：从响应中提取_setup()方法内的JSON，获取client_version；
+ * @param authToken Google账户的AuthToken
+ * @return true表示登录成功，false表示登录失败
+ */
+ private boolean loginGtask(String authToken) {
+ // 配置HTTP参数：连接超时10秒，Socket超时15秒
+ int timeoutConnection = 10000;
+ int timeoutSocket = 15000;
+ HttpParams httpParameters = new BasicHttpParams();
+ HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection);
+ HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket);
+
+ // 初始化HttpClient，配置CookieStore
+ mHttpClient = new DefaultHttpClient(httpParameters);
+ BasicCookieStore localBasicCookieStore = new BasicCookieStore();
+ mHttpClient.setCookieStore(localBasicCookieStore);
+ // 禁用Expect-Continue头，避免部分服务器不兼容
+ HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false);
+
+ // 执行GTask登录
+ try {
+ // 构建登录URL：携带AuthToken
+ String loginUrl = mGetUrl + "?auth=" + authToken;
+ HttpGet httpGet = new HttpGet(loginUrl);
+ HttpResponse response = mHttpClient.execute(httpGet);
+
+ // 检查认证Cookie（GTL开头的Cookie为GTask认证Cookie）
+ List cookies = mHttpClient.getCookieStore().getCookies();
+ boolean hasAuthCookie = false;
+ for (Cookie cookie : cookies) {
+ if (cookie.getName().contains("GTL")) {
+ hasAuthCookie = true;
+ }
+ }
+ if (!hasAuthCookie) {
+ Log.w(TAG, "it seems that there is no auth cookie");
+ }
+
+ // 解析响应内容，获取客户端版本号（client_version）
+ String resString = getResponseContent(response.getEntity());
+ String jsBegin = "_setup("; // JSON数据的起始标记
+ String jsEnd = ")}"; // JSON数据的结束标记
+ int begin = resString.indexOf(jsBegin);
+ int end = resString.lastIndexOf(jsEnd);
+ String jsString = null;
+ // 截取_setup()方法内的JSON字符串
+ if (begin != -1 && end != -1 && begin < end) {
+ jsString = resString.substring(begin + jsBegin.length(), end);
+ }
+ // 解析JSON，获取client_version
+ JSONObject js = new JSONObject(jsString);
+ mClientVersion = js.getLong("v");
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ return false;
+ } catch (Exception e) {
+ // 捕获所有异常（HTTP请求、IO、解析等）
+ Log.e(TAG, "httpget gtask_url failed");
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * 获取自增的动作ID（每次调用后ID+1）
+ * 每个GTask操作（创建、更新、移动等）需要唯一的动作ID标识
+ * @return 下一个动作ID
+ */
+ private int getActionId() {
+ return mActionId++;
+ }
+
+ /**
+ * 创建HTTP POST请求（封装POST请求的公共配置）
+ * 设置请求头：Content-Type为form-urlencoded，AT为1（GTask服务要求）
+ * @return 配置好的HttpPost实例
+ */
+ private HttpPost createHttpPost() {
+ HttpPost httpPost = new HttpPost(mPostUrl);
+ // 设置内容类型：表单编码，UTF-8字符集
+ httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
+ // GTask服务要求的AT头（固定为1）
+ httpPost.setHeader("AT", "1");
+ return httpPost;
+ }
+
+ /**
+ * 解析HTTP响应的内容（处理Gzip/Deflate压缩）
+ * 流程：
+ * 1. 获取响应的编码类型（Content-Encoding）；
+ * 2. 根据编码类型创建对应的输入流（GzipInputStream/InflaterInputStream）；
+ * 3. 读取输入流内容，转换为字符串返回；
+ * @param entity HTTP响应的实体（HttpEntity）
+ * @return 响应的字符串内容
+ * @throws IOException IO异常（流读取失败、关闭失败等）
+ */
+ private String getResponseContent(HttpEntity entity) throws IOException {
+ String contentEncoding = null;
+ // 获取响应的编码类型（gzip/deflate/null）
+ if (entity.getContentEncoding() != null) {
+ contentEncoding = entity.getContentEncoding().getValue();
+ Log.d(TAG, "encoding: " + contentEncoding);
+ }
+
+ // 根据编码类型创建输入流
+ InputStream input = entity.getContent();
+ if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) {
+ // Gzip压缩：使用GZIPInputStream解压缩
+ input = new GZIPInputStream(entity.getContent());
+ } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) {
+ // Deflate压缩：使用InflaterInputStream解压缩（启用nowrap模式）
+ Inflater inflater = new Inflater(true);
+ input = new InflaterInputStream(entity.getContent(), inflater);
+ }
+
+ // 读取输入流内容
+ try {
+ InputStreamReader isr = new InputStreamReader(input);
+ BufferedReader br = new BufferedReader(isr);
+ StringBuilder sb = new StringBuilder();
+
+ String buff;
+ while ((buff = br.readLine()) != null) {
+ sb.append(buff);
+ }
+ return sb.toString();
+ } finally {
+ // 确保输入流关闭，释放资源
+ input.close();
+ }
+ }
+
+ /**
+ * 发送POST请求到GTask服务（核心网络请求方法）
+ * 流程：
+ * 1. 检查登录状态：未登录则抛出异常；
+ * 2. 构建POST请求：将JSON参数封装为表单参数（key为r）；
+ * 3. 执行POST请求：获取响应并解析为JSON对象返回；
+ * 4. 异常处理：捕获不同异常，抛出对应的自定义异常；
+ * @param js 要发送的JSON参数对象
+ * @return GTask服务返回的JSON响应对象
+ * @throws NetworkFailureException 网络异常（客户端协议错误、IO错误）
+ * @throws ActionFailureException 业务逻辑异常（未登录、JSON解析失败）
+ */
+ private JSONObject postRequest(JSONObject js) throws NetworkFailureException {
+ // 检查登录状态
+ if (!mLoggedin) {
+ Log.e(TAG, "please login first");
+ throw new ActionFailureException("not logged in");
+ }
+
+ HttpPost httpPost = createHttpPost();
+ try {
+ // 封装JSON参数为表单参数（key为r，值为JSON字符串）
+ LinkedList list = new LinkedList();
+ list.add(new BasicNameValuePair("r", js.toString()));
+ UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8");
+ httpPost.setEntity(entity);
+
+ // 执行POST请求
+ HttpResponse response = mHttpClient.execute(httpPost);
+ // 解析响应内容为JSON对象
+ String jsString = getResponseContent(response.getEntity());
+ return new JSONObject(jsString);
+
+ } catch (ClientProtocolException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new NetworkFailureException("postRequest failed");
+ } catch (IOException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new NetworkFailureException("postRequest failed");
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("unable to convert response content to jsonobject");
+ } catch (Exception e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("error occurs when posting request");
+ }
+ }
+
+ /**
+ * 创建任务（Task）到GTask服务
+ * 流程：
+ * 1. 提交已有的批量更新动作（确保之前的更新生效）；
+ * 2. 构建创建任务的JSON请求：包含动作列表、客户端版本；
+ * 3. 发送POST请求，获取响应中的新任务GID并设置到Task对象；
+ * @param task 要创建的Task对象
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public void createTask(Task task) throws NetworkFailureException {
+ commitUpdate();
+ try {
+ JSONObject jsPost = new JSONObject();
+ JSONArray actionList = new JSONArray();
+
+ // 添加创建任务的动作（getCreateAction返回创建动作的JSON）
+ actionList.put(task.getCreateAction(getActionId()));
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
+
+ // 添加客户端版本号
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ // 发送POST请求
+ JSONObject jsResponse = postRequest(jsPost);
+ // 解析响应中的新任务GID（NEW_ID字段）
+ JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
+ task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
+
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("create task: handing jsonobject failed");
+ }
+ }
+
+ /**
+ * 创建任务列表（TaskList）到GTask服务
+ * 流程与创建任务一致，区别在于使用TaskList的创建动作
+ * @param tasklist 要创建的TaskList对象
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public void createTaskList(TaskList tasklist) throws NetworkFailureException {
+ commitUpdate();
+ try {
+ JSONObject jsPost = new JSONObject();
+ JSONArray actionList = new JSONArray();
+
+ // 添加创建任务列表的动作
+ actionList.put(tasklist.getCreateAction(getActionId()));
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
+
+ // 添加客户端版本号
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ // 发送POST请求
+ JSONObject jsResponse = postRequest(jsPost);
+ // 解析响应中的新列表GID
+ JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
+ tasklist.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
+
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("create tasklist: handing jsonobject failed");
+ }
+ }
+
+ /**
+ * 提交批量更新动作（将mUpdateArray中的更新动作发送到GTask服务）
+ * 若更新数组不为空，则构建POST请求发送，发送后清空数组
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public void commitUpdate() throws NetworkFailureException {
+ if (mUpdateArray != null) {
+ try {
+ JSONObject jsPost = new JSONObject();
+
+ // 添加更新动作列表
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray);
+
+ // 添加客户端版本号
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ // 发送POST请求
+ postRequest(jsPost);
+ // 清空更新数组
+ mUpdateArray = null;
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("commit update: handing jsonobject failed");
+ }
+ }
+ }
+
+ /**
+ * 添加更新动作到批量更新数组（优化网络请求，批量提交）
+ * 逻辑：
+ * 1. 若更新数组大小超过10，先提交已有动作（避免单次请求数据过大）；
+ * 2. 若数组为空，初始化数组；
+ * 3. 将节点的更新动作添加到数组；
+ * @param node 要更新的节点（Task/TaskList）
+ * @throws NetworkFailureException 网络异常（提交时可能抛出）
+ */
+ public void addUpdateNode(Node node) throws NetworkFailureException {
+ if (node != null) {
+ // 限制单次批量更新的最大数量为10条，避免请求失败
+ if (mUpdateArray != null && mUpdateArray.length() > 10) {
+ commitUpdate();
+ }
+
+ // 初始化更新数组
+ if (mUpdateArray == null) {
+ mUpdateArray = new JSONArray();
+ }
+ // 添加节点的更新动作
+ mUpdateArray.put(node.getUpdateAction(getActionId()));
+ }
+ }
+
+ /**
+ * 移动任务（在不同列表间/同列表内移动任务）
+ * 流程：
+ * 1. 提交已有批量更新动作；
+ * 2. 构建移动动作的JSON请求：区分同列表/不同列表的参数；
+ * 3. 发送POST请求执行移动操作；
+ * @param task 要移动的任务
+ * @param preParent 任务的原父列表
+ * @param curParent 任务的新父列表
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public void moveTask(Task task, TaskList preParent, TaskList curParent) throws NetworkFailureException {
+ commitUpdate();
+ try {
+ JSONObject jsPost = new JSONObject();
+ JSONArray actionList = new JSONArray();
+ JSONObject action = new JSONObject();
+
+ // 配置移动动作的参数
+ action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_MOVE);
+ action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
+ action.put(GTaskStringUtils.GTASK_JSON_ID, task.getGid()); // 要移动的任务ID
+
+ // 同列表移动且任务非第一个：添加前序兄弟ID（用于排序）
+ if (preParent == curParent && task.getPriorSibling() != null) {
+ action.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, task.getPriorSibling());
+ }
+
+ // 原列表ID
+ action.put(GTaskStringUtils.GTASK_JSON_SOURCE_LIST, preParent.getGid());
+ // 新父列表ID
+ action.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT, curParent.getGid());
+
+ // 不同列表移动：添加目标列表ID
+ if (preParent != curParent) {
+ action.put(GTaskStringUtils.GTASK_JSON_DEST_LIST, curParent.getGid());
+ }
+
+ // 添加动作到列表，发送请求
+ actionList.put(action);
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ postRequest(jsPost);
+
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("move task: handing jsonobject failed");
+ }
+ }
+
+ /**
+ * 删除节点（Task/TaskList）：标记为已删除并发送更新请求
+ * 流程：
+ * 1. 提交已有批量更新动作；
+ * 2. 设置节点的deleted标记为true；
+ * 3. 构建删除动作的JSON请求并发送；
+ * 4. 清空更新数组；
+ * @param node 要删除的节点（Task/TaskList）
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public void deleteNode(Node node) throws NetworkFailureException {
+ commitUpdate();
+ try {
+ JSONObject jsPost = new JSONObject();
+ JSONArray actionList = new JSONArray();
+
+ // 标记节点为已删除
+ node.setDeleted(true);
+ // 添加删除动作（更新动作包含deleted标记）
+ actionList.put(node.getUpdateAction(getActionId()));
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ // 发送请求，清空更新数组
+ postRequest(jsPost);
+ mUpdateArray = null;
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("delete node: handing jsonobject failed");
+ }
+ }
+
+ /**
+ * 获取所有任务列表的元数据（从GTask服务获取）
+ * 流程：
+ * 1. 检查登录状态；
+ * 2. 发送GET请求到GTask的GET URL；
+ * 3. 解析响应中的任务列表JSON数组（lists字段）；
+ * @return 任务列表的JSON数组
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public JSONArray getTaskLists() throws NetworkFailureException {
+ if (!mLoggedin) {
+ Log.e(TAG, "please login first");
+ throw new ActionFailureException("not logged in");
+ }
+
+ try {
+ HttpGet httpGet = new HttpGet(mGetUrl);
+ HttpResponse response = mHttpClient.execute(httpGet);
+
+ // 解析响应内容，获取任务列表数组
+ String resString = getResponseContent(response.getEntity());
+ String jsBegin = "_setup(";
+ String jsEnd = ")}";
+ int begin = resString.indexOf(jsBegin);
+ int end = resString.lastIndexOf(jsEnd);
+ String jsString = null;
+ if (begin != -1 && end != -1 && begin < end) {
+ jsString = resString.substring(begin + jsBegin.length(), end);
+ }
+ JSONObject js = new JSONObject(jsString);
+ // 返回lists字段的JSON数组
+ return js.getJSONObject("t").getJSONArray(GTaskStringUtils.GTASK_JSON_LISTS);
+ } catch (ClientProtocolException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new NetworkFailureException("gettasklists: httpget failed");
+ } catch (IOException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new NetworkFailureException("gettasklists: httpget failed");
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("get task lists: handing jasonobject failed");
+ }
+ }
+
+ /**
+ * 获取指定任务列表下的所有任务（从GTask服务获取）
+ * 流程：
+ * 1. 提交已有批量更新动作；
+ * 2. 构建GETALL动作的JSON请求：指定列表ID，不获取已删除任务；
+ * 3. 发送POST请求，返回任务数组；
+ * @param listGid 任务列表的GID
+ * @return 任务的JSON数组
+ * @throws NetworkFailureException 网络异常
+ * @throws ActionFailureException JSON解析/业务逻辑异常
+ */
+ public JSONArray getTaskList(String listGid) throws NetworkFailureException {
+ commitUpdate();
+ try {
+ JSONObject jsPost = new JSONObject();
+ JSONArray actionList = new JSONArray();
+ JSONObject action = new JSONObject();
+
+ // 配置GETALL动作：获取列表下的所有任务
+ action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, GTaskStringUtils.GTASK_JSON_ACTION_TYPE_GETALL);
+ action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
+ action.put(GTaskStringUtils.GTASK_JSON_LIST_ID, listGid); // 指定列表ID
+ action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false); // 不获取已删除任务
+
+ // 添加动作到列表，发送请求
+ actionList.put(action);
+ jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
+ jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
+
+ // 解析响应中的任务数组
+ JSONObject jsResponse = postRequest(jsPost);
+ return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS);
+ } catch (JSONException e) {
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("get task list: handing jsonobject failed");
+ }
+ }
+
+ /**
+ * 获取当前同步的Google账户
+ * @return 当前的Account实例，未登录则返回null
+ */
+ public Account getSyncAccount() {
+ return mAccount;
+ }
+
+ /**
+ * 重置批量更新数组（清空待提交的更新动作）
+ * 用于同步取消、异常处理时清空未提交的更新
+ */
+ public void resetUpdateArray() {
+ mUpdateArray = null;
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/remote/GTaskManager.java b/src/notes/gtask/remote/GTaskManager.java
new file mode 100644
index 0000000..b544fc6
--- /dev/null
+++ b/src/notes/gtask/remote/GTaskManager.java
@@ -0,0 +1,1092 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Activity;
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.data.MetaData;
+import net.micode.notes.gtask.data.Node;
+import net.micode.notes.gtask.data.SqlNote;
+import net.micode.notes.gtask.data.Task;
+import net.micode.notes.gtask.data.TaskList;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.gtask.exception.NetworkFailureException;
+import net.micode.notes.tool.DataUtils;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.Map;
+
+/**
+ * GTask同步核心管理类，采用**单例模式**实现，是GTask同步功能的统筹管理者
+ * 该类负责整个GTask同步流程的调度和控制，主要完成以下职责：
+ * 1. 同步状态管理：维护同步中、已取消等状态，防止并发同步；
+ * 2. 数据映射存储：维护本地与远程的ID映射（GID→NID、NID→GID）、GTask列表/任务/元数据的缓存；
+ * 3. 同步流程调度：执行登录→初始化GTask列表→同步文件夹→同步笔记→清理数据的完整流程；
+ * 4. 内容同步处理：处理本地/远程的增、删、改、移动等同步动作，解决同步冲突；
+ * 5. 元数据管理：处理GTask的元数据（MetaData）同步，关联笔记的额外信息；
+ * 6. 异常处理：捕获网络/业务异常，返回对应的同步状态码。
+ *
+ * 同步状态码说明：
+ * - {@link #STATE_SUCCESS}：同步成功
+ * - {@link #STATE_NETWORK_ERROR}：网络异常（登录失败、请求失败等）
+ * - {@link #STATE_INTERNAL_ERROR}：内部业务异常（JSON解析失败、未知同步动作等）
+ * - {@link #STATE_SYNC_IN_PROGRESS}：同步正在进行中
+ * - {@link #STATE_SYNC_CANCELLED}：同步被取消
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class GTaskManager {
+ /**
+ * 日志标签，使用类的简单名称，便于调试时定位日志来源
+ */
+ private static final String TAG = GTaskManager.class.getSimpleName();
+
+ // ====================== 同步状态码常量 ======================
+ /**
+ * 同步状态：成功
+ */
+ public static final int STATE_SUCCESS = 0;
+
+ /**
+ * 同步状态：网络错误（登录失败、HTTP请求失败等）
+ */
+ public static final int STATE_NETWORK_ERROR = 1;
+
+ /**
+ * 同步状态：内部错误（JSON解析失败、未知同步动作、数据不存在等）
+ */
+ public static final int STATE_INTERNAL_ERROR = 2;
+
+ /**
+ * 同步状态：同步正在进行中（防止并发同步）
+ */
+ public static final int STATE_SYNC_IN_PROGRESS = 3;
+
+ /**
+ * 同步状态：同步被取消
+ */
+ public static final int STATE_SYNC_CANCELLED = 4;
+
+ // ====================== 单例模式相关 ======================
+ /**
+ * GTaskManager单例实例，通过{link #getInstance()}获取
+ */
+ private static GTaskManager mInstance = null;
+
+ // ====================== 上下文/服务相关成员变量 ======================
+ /**
+ * Activity上下文，用于GTaskClient获取Google账户的AuthToken（需要Activity上下文处理授权）
+ */
+ private Activity mActivity;
+
+ /**
+ * 应用上下文，用于获取ContentResolver、资源字符串等
+ */
+ private Context mContext;
+
+ /**
+ * 内容解析器，用于访问本地笔记数据库（ContentProvider）
+ */
+ private ContentResolver mContentResolver;
+
+ // ====================== 同步状态相关成员变量 ======================
+ /**
+ * 同步状态标记：true表示正在同步，false表示同步未进行/已完成
+ */
+ private boolean mSyncing;
+
+ /**
+ * 同步取消标记：true表示同步被取消，false表示同步正常执行
+ */
+ private boolean mCancelled;
+
+ // ====================== GTask远程数据缓存相关 ======================
+ /**
+ * GTask任务列表缓存：Key为GID（远程唯一标识），Value为TaskList对象
+ */
+ private HashMap mGTaskListHashMap;
+
+ /**
+ * GTask节点缓存（包含TaskList和Task）：Key为GID，Value为Node对象
+ */
+ private HashMap mGTaskHashMap;
+
+ /**
+ * GTask元数据缓存：Key为关联的Task GID，Value为MetaData对象
+ */
+ private HashMap mMetaHashMap;
+
+ /**
+ * 元数据任务列表（存储MetaData的TaskList，名称为MIUI_FOLDER_PREFFIX + FOLDER_META）
+ */
+ private TaskList mMetaList;
+
+ // ====================== 本地数据同步相关 ======================
+ /**
+ * 本地已删除笔记ID集合：存储需要从本地数据库批量删除的笔记ID（回收站中的笔记、远程删除的本地笔记）
+ */
+ private HashSet mLocalDeleteIdMap;
+
+ /**
+ * GID→NID映射：Key为远程GID，Value为本地笔记ID（用于关联本地与远程数据）
+ */
+ private HashMap mGidToNid;
+
+ /**
+ * NID→GID映射：Key为本地笔记ID，Value为远程GID（反向映射，便于快速查找）
+ */
+ private HashMap mNidToGid;
+
+ /**
+ * 私有构造方法：初始化GTaskManager的默认属性（单例模式禁止外部实例化）
+ * 初始化各类缓存集合、状态标记为默认值，确保单例的唯一性
+ */
+ private GTaskManager() {
+ mSyncing = false; // 初始未同步
+ mCancelled = false; // 初始未取消
+ mGTaskListHashMap = new HashMap(); // 初始化任务列表缓存
+ mGTaskHashMap = new HashMap(); // 初始化节点缓存
+ mMetaHashMap = new HashMap(); // 初始化元数据缓存
+ mMetaList = null; // 初始无元数据列表
+ mLocalDeleteIdMap = new HashSet(); // 初始化本地删除ID集合
+ mGidToNid = new HashMap(); // 初始化GID→NID映射
+ mNidToGid = new HashMap(); // 初始化NID→GID映射
+ }
+
+ /**
+ * 获取GTaskManager的单例实例（线程安全的同步方法）
+ * @return GTaskManager唯一实例
+ */
+ public static synchronized GTaskManager getInstance() {
+ if (mInstance == null) {
+ mInstance = new GTaskManager();
+ }
+ return mInstance;
+ }
+
+ /**
+ * 设置Activity上下文（用于GTaskClient登录时获取AuthToken）
+ * 该方法需要在同步前调用，传入处理账户授权的Activity
+ * @param activity 用于获取AuthToken的Activity上下文
+ */
+ public synchronized void setActivityContext(Activity activity) {
+ // 注释：用于获取Google账户的AuthToken（需要Activity上下文处理用户授权）
+ mActivity = activity;
+ }
+
+ /**
+ * 执行GTask同步的核心方法（统筹整个同步流程）
+ * 同步流程：
+ * 1. 状态检查：若正在同步，返回STATE_SYNC_IN_PROGRESS；
+ * 2. 初始化：清空缓存、重置状态、获取ContentResolver；
+ * 3. 登录GTask：调用GTaskClient登录，失败则抛出网络异常；
+ * 4. 初始化GTask列表：从远程获取TaskList和Task数据，缓存到本地集合；
+ * 5. 同步内容：先处理回收站笔记，再同步文件夹，最后同步普通笔记；
+ * 6. 异常处理：捕获网络/业务异常，返回对应状态码；
+ * 7. 清理资源：清空缓存，重置同步状态；
+ * 8. 返回结果：根据取消标记返回STATE_SYNC_CANCELLED或STATE_SUCCESS；
+ * @param context 应用上下文（用于访问本地数据库、资源）
+ * @param asyncTask GTaskASyncTask实例（用于发布同步进度）
+ * @return 同步状态码（STATE_*常量）
+ */
+ public int sync(Context context, GTaskASyncTask asyncTask) {
+ // 步骤1：检查同步状态，正在同步则直接返回
+ if (mSyncing) {
+ Log.d(TAG, "Sync is in progress");
+ return STATE_SYNC_IN_PROGRESS;
+ }
+
+ // 步骤2：初始化同步环境
+ mContext = context;
+ mContentResolver = mContext.getContentResolver();
+ mSyncing = true;
+ mCancelled = false;
+ // 清空所有缓存集合，避免旧数据干扰
+ mGTaskListHashMap.clear();
+ mGTaskHashMap.clear();
+ mMetaHashMap.clear();
+ mLocalDeleteIdMap.clear();
+ mGidToNid.clear();
+ mNidToGid.clear();
+
+ try {
+ // 步骤3：获取GTaskClient实例，重置批量更新数组
+ GTaskClient client = GTaskClient.getInstance();
+ client.resetUpdateArray();
+
+ // 步骤4：登录GTask服务（未取消则执行）
+ if (!mCancelled) {
+ if (!client.login(mActivity)) {
+ throw new NetworkFailureException("login google task failed");
+ }
+ }
+
+ // 步骤5：发布进度：初始化GTask列表
+ asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
+ // 初始化GTask列表（从远程获取数据并缓存）
+ initGTaskList();
+
+ // 步骤6：发布进度：正在同步内容
+ asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
+ // 执行内容同步（文件夹、笔记、回收站）
+ syncContent();
+ } catch (NetworkFailureException e) {
+ // 网络异常：返回STATE_NETWORK_ERROR
+ Log.e(TAG, e.toString());
+ return STATE_NETWORK_ERROR;
+ } catch (ActionFailureException e) {
+ // 业务逻辑异常：返回STATE_INTERNAL_ERROR
+ Log.e(TAG, e.toString());
+ return STATE_INTERNAL_ERROR;
+ } catch (Exception e) {
+ // 未知异常：返回STATE_INTERNAL_ERROR
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ return STATE_INTERNAL_ERROR;
+ } finally {
+ // 步骤7：清理资源，重置同步状态（无论成功/失败都会执行）
+ mGTaskListHashMap.clear();
+ mGTaskHashMap.clear();
+ mMetaHashMap.clear();
+ mLocalDeleteIdMap.clear();
+ mGidToNid.clear();
+ mNidToGid.clear();
+ mSyncing = false;
+ }
+
+ // 步骤8：返回结果：取消则返回STATE_SYNC_CANCELLED，否则返回STATE_SUCCESS
+ return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
+ }
+
+ /**
+ * 初始化GTask列表（从远程获取TaskList、Task、MetaData并缓存）
+ * 流程：
+ * 1. 获取远程所有TaskList的JSON数组；
+ * 2. 初始化元数据列表（MetaList）：查找名称为MIUI_FOLDER_PREFFIX + FOLDER_META的TaskList，获取其下的MetaData；
+ * 3. 若元数据列表不存在，则创建并上传到远程；
+ * 4. 初始化普通TaskList：过滤以MIUI_FOLDER_PREFFIX开头的非MetaList，获取其下的Task并缓存；
+ * @throws NetworkFailureException 网络异常（GTaskClient请求失败）
+ * @throws ActionFailureException 业务异常（JSON解析失败）
+ */
+ private void initGTaskList() throws NetworkFailureException {
+ // 同步被取消则直接返回
+ if (mCancelled) {
+ return;
+ }
+
+ GTaskClient client = GTaskClient.getInstance();
+ try {
+ // 步骤1：从远程获取所有TaskList的JSON数组
+ JSONArray jsTaskLists = client.getTaskLists();
+
+ // 步骤2：初始化元数据列表（MetaList）
+ mMetaList = null;
+ for (int i = 0; i < jsTaskLists.length(); i++) {
+ JSONObject object = jsTaskLists.getJSONObject(i);
+ String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+ String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
+
+ // 匹配元数据列表的名称：MIUI_FOLDER_PREFFIX + FOLDER_META
+ if (name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) {
+ mMetaList = new TaskList();
+ // 根据远程JSON初始化TaskList内容
+ mMetaList.setContentByRemoteJSON(object);
+
+ // 步骤3：加载元数据列表下的MetaData
+ JSONArray jsMetas = client.getTaskList(gid);
+ for (int j = 0; j < jsMetas.length(); j++) {
+ object = jsMetas.getJSONObject(j);
+ MetaData metaData = new MetaData();
+ metaData.setContentByRemoteJSON(object);
+ // 仅保存有价值的元数据（isWorthSaving为true）
+ if (metaData.isWorthSaving()) {
+ mMetaList.addChildTask(metaData);
+ // 缓存元数据：Key为关联的Task GID（relatedGid）
+ if (metaData.getGid() != null) {
+ mMetaHashMap.put(metaData.getRelatedGid(), metaData);
+ }
+ }
+ }
+ }
+ }
+
+ // 步骤4：若元数据列表不存在，则创建并上传到远程
+ if (mMetaList == null) {
+ mMetaList = new TaskList();
+ mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META);
+ GTaskClient.getInstance().createTaskList(mMetaList);
+ }
+
+ // 步骤5：初始化普通TaskList（以MIUI_FOLDER_PREFFIX开头，非MetaList）
+ for (int i = 0; i < jsTaskLists.length(); i++) {
+ JSONObject object = jsTaskLists.getJSONObject(i);
+ String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+ String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
+
+ // 过滤条件：以MIUI_FOLDER_PREFFIX开头，且不是MetaList
+ if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)
+ && !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) {
+ TaskList tasklist = new TaskList();
+ tasklist.setContentByRemoteJSON(object);
+ // 缓存TaskList
+ mGTaskListHashMap.put(gid, tasklist);
+ // 缓存到节点集合（包含TaskList和Task）
+ mGTaskHashMap.put(gid, tasklist);
+
+ // 步骤6：加载该TaskList下的所有Task
+ JSONArray jsTasks = client.getTaskList(gid);
+ for (int j = 0; j < jsTasks.length(); j++) {
+ object = jsTasks.getJSONObject(j);
+ gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+ Task task = new Task();
+ task.setContentByRemoteJSON(object);
+ // 仅保存有价值的Task
+ if (task.isWorthSaving()) {
+ // 设置元数据（从缓存中获取）
+ task.setMetaInfo(mMetaHashMap.get(gid));
+ tasklist.addChildTask(task);
+ // 缓存Task
+ mGTaskHashMap.put(gid, task);
+ }
+ }
+ }
+ }
+ } catch (JSONException e) {
+ // JSON解析失败，抛出业务异常
+ Log.e(TAG, e.toString());
+ e.printStackTrace();
+ throw new ActionFailureException("initGTaskList: handing JSONObject failed");
+ }
+ }
+
+ /**
+ * 同步内容（统筹本地与远程的笔记、文件夹同步）
+ * 流程：
+ * 1. 处理本地回收站中的笔记：远程删除对应节点，记录本地删除ID；
+ * 2. 同步文件夹（优先同步文件夹，再同步笔记）；
+ * 3. 处理本地普通笔记：根据GID匹配远程节点，执行对应的同步动作；
+ * 4. 处理远程新增的节点：本地添加对应笔记/文件夹；
+ * 5. 批量删除本地标记的笔记：从数据库中删除回收站/远程删除的笔记；
+ * 6. 提交剩余的批量更新，刷新本地同步ID（lastModified）；
+ * @throws NetworkFailureException 网络异常（GTaskClient请求失败）
+ * @throws ActionFailureException 业务异常（批量删除失败、数据不存在等）
+ */
+ private void syncContent() throws NetworkFailureException {
+ int syncType;
+ Cursor c = null;
+ String gid;
+ Node node;
+
+ // 清空本地删除ID集合
+ mLocalDeleteIdMap.clear();
+
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ // 步骤1：处理本地回收站中的笔记（标记为删除，需要远程删除对应节点）
+ try {
+ // 查询回收站中的非系统笔记（parent_id=ID_TRASH_FOLER，type<>TYPE_SYSTEM）
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
+ "(type<>? AND parent_id=?)", new String[] {
+ String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER)
+ }, null);
+ if (c != null) {
+ while (c.moveToNext()) {
+ // 获取笔记的GTask ID
+ gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ // 从远程缓存中获取对应节点
+ node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，执行远程删除动作
+ mGTaskHashMap.remove(gid);
+ doContentSync(Node.SYNC_ACTION_DEL_REMOTE, node, c);
+ }
+ // 记录本地删除ID，后续批量删除
+ mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN));
+ }
+ } else {
+ Log.w(TAG, "failed to query trash folder");
+ }
+ } finally {
+ // 关闭Cursor，释放资源
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+
+ // 步骤2：优先同步文件夹
+ syncFolder();
+
+ // 步骤3：处理本地普通笔记（非回收站的TYPE_NOTE类型）
+ try {
+ // 查询非回收站的普通笔记（type=TYPE_NOTE，parent_id<>ID_TRASH_FOLER）
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
+ "(type=? AND parent_id<>?)", new String[] {
+ String.valueOf(Notes.TYPE_NOTE), String.valueOf(Notes.ID_TRASH_FOLER)
+ }, NoteColumns.TYPE + " DESC");
+ if (c != null) {
+ while (c.moveToNext()) {
+ // 获取笔记的GTask ID
+ gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ // 从远程缓存中获取对应节点
+ node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，记录ID映射
+ mGTaskHashMap.remove(gid);
+ mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
+ mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
+ // 获取同步动作类型（根据本地/远程的修改时间判断）
+ syncType = node.getSyncAction(c);
+ } else {
+ // 远程无对应节点：判断是本地新增还是远程删除
+ if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
+ // GID为空：本地新增，需要远程添加
+ syncType = Node.SYNC_ACTION_ADD_REMOTE;
+ } else {
+ // GID非空：远程已删除，需要本地删除
+ syncType = Node.SYNC_ACTION_DEL_LOCAL;
+ }
+ }
+ // 执行同步动作
+ doContentSync(syncType, node, c);
+ }
+ } else {
+ Log.w(TAG, "failed to query existing note in database");
+ }
+ } finally {
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+
+ // 步骤4：处理远程新增的节点（缓存中剩余的节点，本地无对应数据）
+ Iterator> iter = mGTaskHashMap.entrySet().iterator();
+ while (iter.hasNext()) {
+ Map.Entry entry = iter.next();
+ node = entry.getValue();
+ // 本地添加该节点
+ doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
+ }
+
+ // 步骤5：批量删除本地标记的笔记（未取消则执行）
+ if (!mCancelled) {
+ if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) {
+ throw new ActionFailureException("failed to batch-delete local deleted notes");
+ }
+ }
+
+ // 步骤6：提交剩余的批量更新，刷新本地同步ID（未取消则执行）
+ if (!mCancelled) {
+ GTaskClient.getInstance().commitUpdate();
+ refreshLocalSyncId();
+ }
+ }
+
+ /**
+ * 同步文件夹（处理本地与远程的文件夹同步，优先于笔记同步）
+ * 流程：
+ * 1. 同步系统文件夹：根文件夹（ID_ROOT_FOLDER）、通话记录文件夹（ID_CALL_RECORD_FOLDER）；
+ * 2. 同步本地普通文件夹：非回收站的TYPE_FOLDER类型；
+ * 3. 处理远程新增的文件夹：本地添加对应文件夹；
+ * 4. 提交批量更新；
+ * @throws NetworkFailureException 网络异常（GTaskClient请求失败）
+ */
+ private void syncFolder() throws NetworkFailureException {
+ Cursor c = null;
+ String gid;
+ Node node;
+ int syncType;
+
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ // 步骤1：同步根文件夹（ID_ROOT_FOLDER）
+ try {
+ // 查询根文件夹
+ c = mContentResolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, Notes.ID_ROOT_FOLDER),
+ SqlNote.PROJECTION_NOTE, null, null, null);
+ if (c != null) {
+ c.moveToNext();
+ gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，记录ID映射
+ mGTaskHashMap.remove(gid);
+ mGidToNid.put(gid, (long) Notes.ID_ROOT_FOLDER);
+ mNidToGid.put((long) Notes.ID_ROOT_FOLDER, gid);
+ // 系统文件夹仅更新远程名称（若不一致）
+ if (!node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) {
+ doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
+ }
+ } else {
+ // 远程无对应文件夹，添加到远程
+ doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c);
+ }
+ } else {
+ Log.w(TAG, "failed to query root folder");
+ }
+ } finally {
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+
+ // 步骤2：同步通话记录文件夹（ID_CALL_RECORD_FOLDER）
+ try {
+ // 查询通话记录文件夹
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, "(_id=?)",
+ new String[] { String.valueOf(Notes.ID_CALL_RECORD_FOLDER) }, null);
+ if (c != null) {
+ if (c.moveToNext()) {
+ gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，记录ID映射
+ mGTaskHashMap.remove(gid);
+ mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER);
+ mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid);
+ // 系统文件夹仅更新远程名称（若不一致）
+ if (!node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) {
+ doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
+ }
+ } else {
+ // 远程无对应文件夹，添加到远程
+ doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c);
+ }
+ }
+ } else {
+ Log.w(TAG, "failed to query call note folder");
+ }
+ } finally {
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+
+ // 步骤3：同步本地普通文件夹（非回收站的TYPE_FOLDER类型）
+ try {
+ // 查询非回收站的文件夹（type=TYPE_FOLDER，parent_id<>ID_TRASH_FOLER）
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
+ "(type=? AND parent_id<>?)", new String[] {
+ String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)
+ }, NoteColumns.TYPE + " DESC");
+ if (c != null) {
+ while (c.moveToNext()) {
+ gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，记录ID映射
+ mGTaskHashMap.remove(gid);
+ mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
+ mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
+ // 获取同步动作类型
+ syncType = node.getSyncAction(c);
+ } else {
+ // 远程无对应文件夹：判断是本地新增还是远程删除
+ if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
+ // GID为空：本地新增，远程添加
+ syncType = Node.SYNC_ACTION_ADD_REMOTE;
+ } else {
+ // GID非空：远程删除，本地删除
+ syncType = Node.SYNC_ACTION_DEL_LOCAL;
+ }
+ }
+ // 执行同步动作
+ doContentSync(syncType, node, c);
+ }
+ } else {
+ Log.w(TAG, "failed to query existing folder");
+ }
+ } finally {
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+
+ // 步骤4：处理远程新增的文件夹（本地无对应数据）
+ Iterator> iter = mGTaskListHashMap.entrySet().iterator();
+ while (iter.hasNext()) {
+ Map.Entry entry = iter.next();
+ gid = entry.getKey();
+ node = entry.getValue();
+ if (mGTaskHashMap.containsKey(gid)) {
+ // 从缓存中移除，本地添加该文件夹
+ mGTaskHashMap.remove(gid);
+ doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
+ }
+ }
+
+ // 步骤5：提交批量更新（未取消则执行）
+ if (!mCancelled) {
+ GTaskClient.getInstance().commitUpdate();
+ }
+ }
+
+ /**
+ * 执行具体的内容同步动作（根据同步类型处理本地/远程的增删改）
+ * 同步类型说明（Node类的SYNC_ACTION_*常量）：
+ * - ADD_LOCAL：远程新增，本地添加
+ * - ADD_REMOTE：本地新增，远程添加
+ * - DEL_LOCAL：远程删除，本地删除
+ * - DEL_REMOTE：本地删除，远程删除
+ * - UPDATE_LOCAL：远程更新，本地更新
+ * - UPDATE_REMOTE：本地更新，远程更新
+ * - UPDATE_CONFLICT：同步冲突（当前采用本地覆盖远程）
+ * - NONE：无动作
+ * - ERROR：错误动作（抛出异常）
+ * @param syncType 同步动作类型（Node.SYNC_ACTION_*常量）
+ * @param node 远程节点（Task/TaskList），可为null（如本地新增时）
+ * @param c 本地数据库的Cursor（包含笔记/文件夹数据），可为null（如远程新增时）
+ * @throws NetworkFailureException 网络异常（GTaskClient请求失败）
+ * @throws ActionFailureException 业务异常（未知同步类型、数据不存在等）
+ */
+ private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ MetaData meta;
+ // 根据同步类型执行对应操作
+ switch (syncType) {
+ case Node.SYNC_ACTION_ADD_LOCAL:
+ // 远程新增，本地添加
+ addLocalNode(node);
+ break;
+ case Node.SYNC_ACTION_ADD_REMOTE:
+ // 本地新增，远程添加
+ addRemoteNode(node, c);
+ break;
+ case Node.SYNC_ACTION_DEL_LOCAL:
+ // 远程删除，本地删除：先删除元数据，再记录本地删除ID
+ meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN));
+ if (meta != null) {
+ GTaskClient.getInstance().deleteNode(meta);
+ }
+ mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN));
+ break;
+ case Node.SYNC_ACTION_DEL_REMOTE:
+ // 本地删除，远程删除：先删除元数据，再删除节点
+ meta = mMetaHashMap.get(node.getGid());
+ if (meta != null) {
+ GTaskClient.getInstance().deleteNode(meta);
+ }
+ GTaskClient.getInstance().deleteNode(node);
+ break;
+ case Node.SYNC_ACTION_UPDATE_LOCAL:
+ // 远程更新，本地更新
+ updateLocalNode(node, c);
+ break;
+ case Node.SYNC_ACTION_UPDATE_REMOTE:
+ // 本地更新，远程更新
+ updateRemoteNode(node, c);
+ break;
+ case Node.SYNC_ACTION_UPDATE_CONFLICT:
+ // 同步冲突：当前采用本地覆盖远程的策略（可优化为合并修改）
+ updateRemoteNode(node, c);
+ break;
+ case Node.SYNC_ACTION_NONE:
+ // 无动作，直接返回
+ break;
+ case Node.SYNC_ACTION_ERROR:
+ default:
+ // 未知同步类型，抛出业务异常
+ throw new ActionFailureException("unkown sync action type");
+ }
+ }
+
+ /**
+ * 本地添加远程节点（远程新增，本地创建对应笔记/文件夹）
+ * @param node 远程节点（Task/TaskList）
+ * @throws NetworkFailureException 网络异常（元数据处理失败）
+ * @throws ActionFailureException 业务异常（父节点不存在）
+ */
+ private void addLocalNode(Node node) throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ SqlNote sqlNote;
+ // 区分节点类型：TaskList（文件夹）或Task（笔记）
+ if (node instanceof TaskList) {
+ // 处理文件夹节点
+ if (node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) {
+ // 根文件夹：使用固定ID（ID_ROOT_FOLDER）
+ sqlNote = new SqlNote(mContext, Notes.ID_ROOT_FOLDER);
+ } else if (node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) {
+ // 通话记录文件夹：使用固定ID（ID_CALL_RECORD_FOLDER）
+ sqlNote = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER);
+ } else {
+ // 普通文件夹：创建新的SqlNote，设置内容和父节点（根文件夹）
+ sqlNote = new SqlNote(mContext);
+ sqlNote.setContent(node.getLocalJSONFromContent());
+ sqlNote.setParentId(Notes.ID_ROOT_FOLDER);
+ }
+ } else {
+ // 处理笔记节点（Task）
+ sqlNote = new SqlNote(mContext);
+ JSONObject js = node.getLocalJSONFromContent();
+ try {
+ // 处理笔记ID冲突：若ID已存在，移除ID（由数据库自动生成）
+ if (js.has(GTaskStringUtils.META_HEAD_NOTE)) {
+ JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+ if (note.has(NoteColumns.ID)) {
+ long id = note.getLong(NoteColumns.ID);
+ if (DataUtils.existInNoteDatabase(mContentResolver, id)) {
+ note.remove(NoteColumns.ID);
+ }
+ }
+ }
+
+ // 处理笔记数据ID冲突：若ID已存在，移除ID
+ if (js.has(GTaskStringUtils.META_HEAD_DATA)) {
+ JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+ for (int i = 0; i < dataArray.length(); i++) {
+ JSONObject data = dataArray.getJSONObject(i);
+ if (data.has(DataColumns.ID)) {
+ long dataId = data.getLong(DataColumns.ID);
+ if (DataUtils.existInDataDatabase(mContentResolver, dataId)) {
+ data.remove(DataColumns.ID);
+ }
+ }
+ }
+ }
+ } catch (JSONException e) {
+ Log.w(TAG, e.toString());
+ e.printStackTrace();
+ }
+ // 设置笔记内容
+ sqlNote.setContent(js);
+
+ // 获取父文件夹的本地ID（从GID→NID映射中获取）
+ Long parentId = mGidToNid.get(((Task) node).getParent().getGid());
+ if (parentId == null) {
+ Log.e(TAG, "cannot find task's parent id locally");
+ throw new ActionFailureException("cannot add local node");
+ }
+ // 设置父节点ID
+ sqlNote.setParentId(parentId.longValue());
+ }
+
+ // 步骤1：设置GTask ID，提交到本地数据库
+ sqlNote.setGtaskId(node.getGid());
+ sqlNote.commit(false);
+
+ // 步骤2：更新ID映射
+ mGidToNid.put(node.getGid(), sqlNote.getId());
+ mNidToGid.put(sqlNote.getId(), node.getGid());
+
+ // 步骤3：更新远程元数据
+ updateRemoteMeta(node.getGid(), sqlNote);
+ }
+
+ /**
+ * 本地更新远程节点（远程更新，本地更新对应笔记/文件夹）
+ * @param node 远程节点（Task/TaskList）
+ * @param c 本地数据库的Cursor（包含旧数据）
+ * @throws NetworkFailureException 网络异常（元数据处理失败）
+ * @throws ActionFailureException 业务异常（父节点不存在）
+ */
+ private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ SqlNote sqlNote;
+ // 步骤1：创建SqlNote并加载本地旧数据
+ sqlNote = new SqlNote(mContext, c);
+ // 步骤2：更新内容为远程节点的内容
+ sqlNote.setContent(node.getLocalJSONFromContent());
+
+ // 步骤3：设置父节点ID（区分Task和TaskList）
+ Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
+ : new Long(Notes.ID_ROOT_FOLDER);
+ if (parentId == null) {
+ Log.e(TAG, "cannot find task's parent id locally");
+ throw new ActionFailureException("cannot update local node");
+ }
+ sqlNote.setParentId(parentId.longValue());
+
+ // 步骤4：提交更新到本地数据库
+ sqlNote.commit(true);
+
+ // 步骤5：更新远程元数据
+ updateRemoteMeta(node.getGid(), sqlNote);
+ }
+
+ /**
+ * 远程添加本地节点（本地新增，远程创建对应Task/TaskList）
+ * @param node 远程节点（可为null，本地新增时无远程节点）
+ * @param c 本地数据库的Cursor（包含本地新增数据）
+ * @throws NetworkFailureException 网络异常（GTaskClient创建节点失败）
+ * @throws ActionFailureException 业务异常（父节点不存在）
+ */
+ private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ SqlNote sqlNote = new SqlNote(mContext, c);
+ Node n;
+
+ // 区分节点类型：笔记（TYPE_NOTE）或文件夹（TYPE_FOLDER）
+ if (sqlNote.isNoteType()) {
+ // 处理笔记：创建远程Task
+ Task task = new Task();
+ task.setContentByLocalJSON(sqlNote.getContent());
+
+ // 获取父文件夹的远程GID（从NID→GID映射中获取）
+ String parentGid = mNidToGid.get(sqlNote.getParentId());
+ if (parentGid == null) {
+ Log.e(TAG, "cannot find task's parent tasklist");
+ throw new ActionFailureException("cannot add remote task");
+ }
+ // 添加到父TaskList
+ mGTaskListHashMap.get(parentGid).addChildTask(task);
+
+ // 远程创建Task
+ GTaskClient.getInstance().createTask(task);
+ n = (Node) task;
+
+ // 添加元数据
+ updateRemoteMeta(task.getGid(), sqlNote);
+ } else {
+ // 处理文件夹：创建远程TaskList（先检查是否已存在）
+ TaskList tasklist = null;
+
+ // 构建文件夹名称（MIUI_FOLDER_PREFFIX + 文件夹名称/固定标识）
+ String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX;
+ if (sqlNote.getId() == Notes.ID_ROOT_FOLDER) {
+ folderName += GTaskStringUtils.FOLDER_DEFAULT;
+ } else if (sqlNote.getId() == Notes.ID_CALL_RECORD_FOLDER) {
+ folderName += GTaskStringUtils.FOLDER_CALL_NOTE;
+ } else {
+ folderName += sqlNote.getSnippet();
+ }
+
+ // 检查远程是否已存在该文件夹（避免重复创建）
+ Iterator> iter = mGTaskListHashMap.entrySet().iterator();
+ while (iter.hasNext()) {
+ Map.Entry entry = iter.next();
+ String gid = entry.getKey();
+ TaskList list = entry.getValue();
+
+ if (list.getName().equals(folderName)) {
+ tasklist = list;
+ // 从缓存中移除，避免重复处理
+ if (mGTaskHashMap.containsKey(gid)) {
+ mGTaskHashMap.remove(gid);
+ }
+ break;
+ }
+ }
+
+ // 远程无该文件夹，创建并上传
+ if (tasklist == null) {
+ tasklist = new TaskList();
+ tasklist.setContentByLocalJSON(sqlNote.getContent());
+ GTaskClient.getInstance().createTaskList(tasklist);
+ mGTaskListHashMap.put(tasklist.getGid(), tasklist);
+ }
+ n = (Node) tasklist;
+ }
+
+ // 步骤1：更新本地笔记的GTask ID，提交到数据库
+ sqlNote.setGtaskId(n.getGid());
+ sqlNote.commit(false);
+ // 步骤2：重置本地修改标记（同步完成）
+ sqlNote.resetLocalModified();
+ sqlNote.commit(true);
+
+ // 步骤3：更新ID映射
+ mGidToNid.put(n.getGid(), sqlNote.getId());
+ mNidToGid.put(sqlNote.getId(), n.getGid());
+ }
+
+ /**
+ * 远程更新本地节点（本地更新，远程更新对应Task/TaskList）
+ * @param node 远程节点（Task/TaskList）
+ * @param c 本地数据库的Cursor（包含本地更新数据）
+ * @throws NetworkFailureException 网络异常（GTaskClient更新/移动节点失败）
+ * @throws ActionFailureException 业务异常（父节点不存在）
+ */
+ private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ SqlNote sqlNote = new SqlNote(mContext, c);
+
+ // 步骤1：更新远程节点内容（从本地JSON加载）
+ node.setContentByLocalJSON(sqlNote.getContent());
+ // 添加到批量更新数组
+ GTaskClient.getInstance().addUpdateNode(node);
+
+ // 步骤2：更新元数据
+ updateRemoteMeta(node.getGid(), sqlNote);
+
+ // 步骤3：处理笔记的移动（父文件夹变化时）
+ if (sqlNote.isNoteType()) {
+ Task task = (Task) node;
+ TaskList preParentList = task.getParent();
+
+ // 获取当前父文件夹的远程GID
+ String curParentGid = mNidToGid.get(sqlNote.getParentId());
+ if (curParentGid == null) {
+ Log.e(TAG, "cannot find task's parent tasklist");
+ throw new ActionFailureException("cannot update remote task");
+ }
+ TaskList curParentList = mGTaskListHashMap.get(curParentGid);
+
+ // 父文件夹变化，执行移动操作
+ if (preParentList != curParentList) {
+ preParentList.removeChildTask(task);
+ curParentList.addChildTask(task);
+ GTaskClient.getInstance().moveTask(task, preParentList, curParentList);
+ }
+ }
+
+ // 步骤4：重置本地修改标记（同步完成）
+ sqlNote.resetLocalModified();
+ sqlNote.commit(true);
+ }
+
+ /**
+ * 更新远程元数据（关联Task的MetaData，存储额外信息）
+ * @param gid 关联的Task GID
+ * @param sqlNote 本地笔记数据（包含元数据内容）
+ * @throws NetworkFailureException 网络异常（GTaskClient创建/更新元数据失败）
+ */
+ private void updateRemoteMeta(String gid, SqlNote sqlNote) throws NetworkFailureException {
+ // 仅处理笔记类型的元数据（文件夹无元数据）
+ if (sqlNote != null && sqlNote.isNoteType()) {
+ MetaData metaData = mMetaHashMap.get(gid);
+ if (metaData != null) {
+ // 元数据已存在，更新内容并添加到批量更新
+ metaData.setMeta(gid, sqlNote.getContent());
+ GTaskClient.getInstance().addUpdateNode(metaData);
+ } else {
+ // 元数据不存在，创建并上传到元数据列表
+ metaData = new MetaData();
+ metaData.setMeta(gid, sqlNote.getContent());
+ mMetaList.addChildTask(metaData);
+ mMetaHashMap.put(gid, metaData);
+ GTaskClient.getInstance().createTask(metaData);
+ }
+ }
+ }
+
+ /**
+ * 刷新本地同步ID（将远程节点的lastModified更新到本地笔记的SYNC_ID字段）
+ * 作用：用于后续同步时判断本地/远程的修改时间，确定同步动作类型
+ * @throws NetworkFailureException 网络异常（重新初始化GTask列表失败）
+ * @throws ActionFailureException 业务异常（本地笔记无对应GID）
+ */
+ private void refreshLocalSyncId() throws NetworkFailureException {
+ // 同步被取消则返回
+ if (mCancelled) {
+ return;
+ }
+
+ // 步骤1：重新初始化GTask列表，获取最新的远程数据
+ mGTaskHashMap.clear();
+ mGTaskListHashMap.clear();
+ mMetaHashMap.clear();
+ initGTaskList();
+
+ Cursor c = null;
+ try {
+ // 步骤2：查询本地非系统、非回收站的笔记/文件夹
+ c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
+ "(type<>? AND parent_id<>?)", new String[] {
+ String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER)
+ }, NoteColumns.TYPE + " DESC");
+ if (c != null) {
+ while (c.moveToNext()) {
+ String gid = c.getString(SqlNote.GTASK_ID_COLUMN);
+ Node node = mGTaskHashMap.get(gid);
+ if (node != null) {
+ // 从缓存中移除，更新本地SYNC_ID为远程的lastModified
+ mGTaskHashMap.remove(gid);
+ ContentValues values = new ContentValues();
+ values.put(NoteColumns.SYNC_ID, node.getLastModified());
+ mContentResolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
+ c.getLong(SqlNote.ID_COLUMN)), values, null, null);
+ } else {
+ // 本地笔记无对应远程GID，抛出异常
+ Log.e(TAG, "something is missed");
+ throw new ActionFailureException("some local items don't have gid after sync");
+ }
+ }
+ } else {
+ Log.w(TAG, "failed to query local note to refresh sync id");
+ }
+ } finally {
+ // 关闭Cursor，释放资源
+ if (c != null) {
+ c.close();
+ c = null;
+ }
+ }
+ }
+
+ /**
+ * 获取当前同步的Google账户名称
+ * @return Google账户名称（如xxx@gmail.com）
+ */
+ public String getSyncAccount() {
+ return GTaskClient.getInstance().getSyncAccount().name;
+ }
+
+ /**
+ * 取消当前的同步任务（设置mCancelled为true，同步流程会检测该标记并终止）
+ */
+ public void cancelSync() {
+ mCancelled = true;
+ }
+}
\ No newline at end of file
diff --git a/src/notes/gtask/remote/GTaskSyncService.java b/src/notes/gtask/remote/GTaskSyncService.java
new file mode 100644
index 0000000..5e376c7
--- /dev/null
+++ b/src/notes/gtask/remote/GTaskSyncService.java
@@ -0,0 +1,272 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Activity;
+import android.app.Service;
+import android.content.Context;
+import android.content.Intent;
+import android.os.Bundle;
+import android.os.IBinder;
+
+/**
+ * GTask同步服务类，继承自Android {@link Service}，是管理GTask异步同步任务的核心服务
+ * 主要职责：
+ * 1. 接收外部的同步指令（启动同步、取消同步），并分发处理；
+ * 2. 管理{@link GTaskASyncTask}异步任务的生命周期（创建、执行、取消）；
+ * 3. 通过广播向外部组件发送同步状态（是否正在同步）和进度信息；
+ * 4. 提供静态方法供外部组件（如Activity）便捷调用同步/取消同步功能，以及获取同步状态；
+ * 5. 处理Service的生命周期事件，在低内存时取消同步任务以释放资源。
+ *
+ * 通信机制：
+ * - 外部通过{@link Intent}传递指令（ACTION_START_SYNC/ACTION_CANCEL_SYNC）启动服务；
+ * - 服务通过广播（{@link #GTASK_SERVICE_BROADCAST_NAME}）向外部推送同步状态和进度。
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class GTaskSyncService extends Service {
+ // ====================== Intent指令参数常量 ======================
+ /**
+ * Intent中传递同步动作类型的键名，对应值为{@link #ACTION_START_SYNC}/{@link #ACTION_CANCEL_SYNC}/{@link #ACTION_INVALID}
+ */
+ public final static String ACTION_STRING_NAME = "sync_action_type";
+
+ /**
+ * 同步动作类型：启动GTask同步
+ */
+ public final static int ACTION_START_SYNC = 0;
+
+ /**
+ * 同步动作类型：取消GTask同步
+ */
+ public final static int ACTION_CANCEL_SYNC = 1;
+
+ /**
+ * 同步动作类型：无效动作（默认值，用于容错）
+ */
+ public final static int ACTION_INVALID = 2;
+
+ // ====================== 广播相关常量 ======================
+ /**
+ * GTask同步服务的广播名称，外部组件可注册该广播接收同步状态和进度更新
+ */
+ public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service";
+
+ /**
+ * 广播中传递“是否正在同步”的键名，对应值为boolean类型（true=同步中，false=未同步）
+ */
+ public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing";
+
+ /**
+ * 广播中传递同步进度信息的键名，对应值为String类型（如“正在初始化列表”“正在同步内容”）
+ */
+ public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg";
+
+ // ====================== 静态成员变量（全局共享同步状态） ======================
+ /**
+ * GTask异步同步任务实例，全局唯一，用于控制同步任务的执行和取消
+ */
+ private static GTaskASyncTask mSyncTask = null;
+
+ /**
+ * 同步进度信息字符串，全局共享，外部可通过{@link #getProgressString()}获取
+ */
+ private static String mSyncProgress = "";
+
+ /**
+ * 启动GTask同步任务的核心方法
+ * 逻辑：
+ * 1. 检查异步任务是否为null（避免重复执行同步任务）；
+ * 2. 若为null，创建新的{@link GTaskASyncTask}实例，设置任务完成监听器；
+ * 3. 发送初始广播（更新同步状态）；
+ * 4. 执行异步同步任务；
+ * 任务完成监听器逻辑：
+ * - 任务完成后，将mSyncTask置为null，发送空进度广播，停止服务自身。
+ */
+ private void startSync() {
+ if (mSyncTask == null) {
+ mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
+ /**
+ * 异步任务完成后的回调方法
+ */
+ public void onComplete() {
+ // 清空异步任务实例，标记同步完成
+ mSyncTask = null;
+ // 发送空进度广播，通知外部同步完成
+ sendBroadcast("");
+ // 停止服务自身，释放资源
+ stopSelf();
+ }
+ });
+ // 发送初始广播，通知外部同步开始
+ sendBroadcast("");
+ // 执行异步同步任务
+ mSyncTask.execute();
+ }
+ }
+
+ /**
+ * 取消当前正在执行的GTask同步任务
+ * 逻辑：若异步任务不为null，调用其{@link GTaskASyncTask#cancelSync()}方法取消同步
+ */
+ private void cancelSync() {
+ if (mSyncTask != null) {
+ mSyncTask.cancelSync();
+ }
+ }
+
+ /**
+ * Service创建时的生命周期方法
+ * 初始化：将异步任务实例置为null，确保服务启动时同步任务状态干净
+ */
+ @Override
+ public void onCreate() {
+ mSyncTask = null;
+ }
+
+ /**
+ * Service接收启动指令的核心生命周期方法（每次启动服务都会调用）
+ * 逻辑：
+ * 1. 获取Intent中的参数Bundle；
+ * 2. 若Bundle包含动作类型键，根据动作类型执行对应操作（启动/取消同步）；
+ * 3. 若处理了有效动作，返回{@link #START_STICKY}（服务被系统杀死后会重启）；
+ * 4. 否则，调用父类默认实现。
+ *
+ * @param intent 启动服务的Intent，包含同步动作类型参数
+ * @param flags 启动标志位
+ * @param startId 服务启动的唯一ID
+ * @return 服务的启动模式，{@link #START_STICKY}或父类默认值
+ */
+ @Override
+ public int onStartCommand(Intent intent, int flags, int startId) {
+ Bundle bundle = intent.getExtras();
+ if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
+ // 根据Intent中的动作类型执行对应操作
+ switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) {
+ case ACTION_START_SYNC:
+ // 执行启动同步逻辑
+ startSync();
+ break;
+ case ACTION_CANCEL_SYNC:
+ // 执行取消同步逻辑
+ cancelSync();
+ break;
+ default:
+ // 无效动作，不处理
+ break;
+ }
+ // 返回START_STICKY，确保服务被系统杀死后能重启（适用于同步任务的持续性需求）
+ return START_STICKY;
+ }
+ // 无有效参数，调用父类默认实现
+ return super.onStartCommand(intent, flags, startId);
+ }
+
+ /**
+ * 系统低内存时的回调方法
+ * 优化：若同步任务正在执行，取消任务以释放内存，避免影响系统性能
+ */
+ @Override
+ public void onLowMemory() {
+ if (mSyncTask != null) {
+ mSyncTask.cancelSync();
+ }
+ }
+
+ /**
+ * Service绑定的回调方法（该服务为启动型服务，不支持绑定，返回null）
+ * @param intent 绑定服务的Intent
+ * @return null（不支持绑定）
+ */
+ public IBinder onBind(Intent intent) {
+ return null;
+ }
+
+ /**
+ * 发送同步状态和进度的广播方法，供内部和异步任务调用
+ * 逻辑：
+ * 1. 更新全局进度信息；
+ * 2. 创建广播Intent，设置广播名称；
+ * 3. 向Intent中添加“是否正在同步”和“进度信息”参数；
+ * 4. 发送广播，通知所有注册的接收器。
+ *
+ * @param msg 同步进度信息字符串（如“正在初始化GTask列表”）
+ */
+ public void sendBroadcast(String msg) {
+ // 更新全局进度信息
+ mSyncProgress = msg;
+ // 创建广播Intent，指定广播名称
+ Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
+ // 添加“是否正在同步”参数：mSyncTask不为null表示同步中
+ intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null);
+ // 添加“进度信息”参数
+ intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg);
+ // 发送广播
+ sendBroadcast(intent);
+ }
+
+ /**
+ * 供外部组件（如Activity）调用的静态方法：启动GTask同步服务
+ * 逻辑：
+ * 1. 为GTaskManager设置Activity上下文（用于Google账户授权）；
+ * 2. 创建启动服务的Intent，设置动作类型为“启动同步”；
+ * 3. 启动服务。
+ *
+ * @param activity 调用方的Activity上下文（用于账户授权）
+ */
+ public static void startSync(Activity activity) {
+ // 为GTaskManager设置Activity上下文，用于后续Google账户登录授权
+ GTaskManager.getInstance().setActivityContext(activity);
+ // 创建启动GTaskSyncService的Intent
+ Intent intent = new Intent(activity, GTaskSyncService.class);
+ // 设置Intent参数：动作类型为启动同步
+ intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC);
+ // 启动服务
+ activity.startService(intent);
+ }
+
+ /**
+ * 供外部组件调用的静态方法：取消GTask同步服务
+ * 逻辑：
+ * 1. 创建启动服务的Intent，设置动作类型为“取消同步”；
+ * 2. 启动服务（服务会处理取消逻辑，即使已启动也会接收指令）。
+ *
+ * @param context 调用方的上下文（如Activity、Application）
+ */
+ public static void cancelSync(Context context) {
+ Intent intent = new Intent(context, GTaskSyncService.class);
+ intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC);
+ context.startService(intent);
+ }
+
+ /**
+ * 供外部组件调用的静态方法：获取当前是否正在同步的状态
+ * @return boolean：true表示同步中，false表示未同步
+ */
+ public static boolean isSyncing() {
+ return mSyncTask != null;
+ }
+
+ /**
+ * 供外部组件调用的静态方法：获取当前同步进度信息
+ * @return String：同步进度信息字符串
+ */
+ public static String getProgressString() {
+ return mSyncProgress;
+ }
+}
\ No newline at end of file
diff --git a/src/notes/model/Note.java b/src/notes/model/Note.java
new file mode 100644
index 0000000..1b32683
--- /dev/null
+++ b/src/notes/model/Note.java
@@ -0,0 +1,461 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.model;
+
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.OperationApplicationException;
+import android.net.Uri;
+import android.os.RemoteException;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.Notes.TextNote;
+
+import java.util.ArrayList;
+
+/**
+ * 笔记核心业务模型类
+ * 负责管理单条笔记的元数据（创建时间、修改时间、所属文件夹等）和具体数据（文本内容、通话记录内容）
+ * 提供笔记ID生成、数据更新、本地修改标记、数据同步到ContentProvider的核心功能
+ * 采用内部类NoteData封装文本/通话数据的处理逻辑，符合面向对象的封装原则
+ * 遵循Android ContentProvider数据交互规范，实现数据持久化
+ *
+ * @author MiCode Open Source Community
+ * @date 2010-2011
+ */
+public class Note {
+ /**
+ * 存储笔记元数据的变更键值对（如标题、修改时间、本地修改标记）
+ * ContentValues是Android中用于封装键值对的容器，专门用于ContentProvider的增删改操作
+ */
+ private ContentValues mNoteDiffValues;
+
+ /**
+ * 笔记的具体数据对象（包含文本数据和通话记录数据），由内部类NoteData实现
+ */
+ private NoteData mNoteData;
+
+ /**
+ * 日志标签，用于Logcat输出时标识当前类，方便调试定位问题
+ */
+ private static final String TAG = "Note";
+
+ /**
+ * 生成新的笔记ID，用于向数据库中添加新笔记
+ * 该方法为静态同步方法，保证多线程环境下生成的笔记ID唯一，避免并发冲突
+ *
+ * @param context 上下文对象，用于获取ContentResolver（访问ContentProvider的入口）
+ * @param folderId 笔记所属文件夹的ID，用于关联笔记与文件夹
+ * @return 新创建的笔记ID（大于0为有效ID，0表示失败）
+ * @throws IllegalStateException 当解析出的笔记ID为-1时抛出，标识数据插入异常
+ */
+ public static synchronized long getNewNoteId(Context context, long folderId) {
+ // 初始化ContentValues，存储新笔记的初始元数据
+ ContentValues values = new ContentValues();
+ // 获取当前系统时间，作为笔记的创建时间和初始修改时间
+ long createdTime = System.currentTimeMillis();
+ // 存储笔记创建时间（对应数据库note表的CREATED_DATE列）
+ values.put(NoteColumns.CREATED_DATE, createdTime);
+ // 存储笔记修改时间（对应数据库note表的MODIFIED_DATE列）
+ values.put(NoteColumns.MODIFIED_DATE, createdTime);
+ // 存储笔记类型：普通笔记（对应Notes类的TYPE_NOTE常量）
+ values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
+ // 标记笔记为本地已修改（1表示需要同步，对应LOCAL_MODIFIED列）
+ values.put(NoteColumns.LOCAL_MODIFIED, 1);
+ // 存储笔记所属文件夹ID（对应PARENT_ID列）
+ values.put(NoteColumns.PARENT_ID, folderId);
+
+ // 通过ContentResolver插入数据到note表，返回的Uri包含新笔记的ID（格式：content://xxx/note/123）
+ Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+
+ // 初始化笔记ID为0（默认失败值）
+ long noteId = 0;
+ try {
+ // 解析Uri的路径段获取笔记ID：Uri的getPathSegments()返回["note", "123"]，索引1的元素是ID
+ noteId = Long.valueOf(uri.getPathSegments().get(1));
+ } catch (NumberFormatException e) {
+ // 捕获数字格式异常，输出错误日志，保持noteId为0
+ Log.e(TAG, "Get note id error :" + e.toString());
+ noteId = 0;
+ }
+ // 校验笔记ID是否为-1（非法值，通常表示插入操作异常）
+ if (noteId == -1) {
+ throw new IllegalStateException("Wrong note id:" + noteId);
+ }
+ // 返回生成的笔记ID
+ return noteId;
+ }
+
+ /**
+ * 无参构造方法，初始化笔记的元数据容器和具体数据对象
+ */
+ public Note() {
+ // 初始化笔记元数据的变更容器
+ mNoteDiffValues = new ContentValues();
+ // 初始化笔记具体数据对象
+ mNoteData = new NoteData();
+ }
+
+ /**
+ * 设置笔记元数据的键值对，并自动更新本地修改标记和修改时间
+ * 每次修改元数据时，都会标记为本地已修改，并更新修改时间为当前系统时间
+ *
+ * @param key 元数据的键（对应NoteColumns中的列名，如标题、类型等）
+ * @param value 元数据的值（字符串类型）
+ */
+ public void setNoteValue(String key, String value) {
+ // 存储元数据键值对
+ mNoteDiffValues.put(key, value);
+ // 标记为本地已修改，需要同步
+ mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+ // 更新修改时间为当前系统时间
+ mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+ }
+
+ /**
+ * 设置笔记的文本数据键值对（如笔记内容）
+ * 委托给内部类NoteData的setTextData方法处理
+ *
+ * @param key 文本数据的键（对应TextNote中的列名）
+ * @param value 文本数据的值（如笔记的文本内容）
+ */
+ public void setTextData(String key, String value) {
+ mNoteData.setTextData(key, value);
+ }
+
+ /**
+ * 设置文本数据的ID（对应数据库data表的主键ID）
+ * 用于后续更新文本数据时，指定要更新的记录
+ *
+ * @param id 文本数据的ID（必须大于0）
+ */
+ public void setTextDataId(long id) {
+ mNoteData.setTextDataId(id);
+ }
+
+ /**
+ * 获取文本数据的ID
+ *
+ * @return 文本数据的ID（0表示未设置，大于0为有效ID）
+ */
+ public long getTextDataId() {
+ return mNoteData.mTextDataId;
+ }
+
+ /**
+ * 设置通话记录数据的ID（对应数据库data表的主键ID）
+ * 用于后续更新通话数据时，指定要更新的记录
+ *
+ * @param id 通话数据的ID（必须大于0）
+ */
+ public void setCallDataId(long id) {
+ mNoteData.setCallDataId(id);
+ }
+
+ /**
+ * 设置笔记的通话记录数据键值对（如电话号码、通话时间）
+ * 委托给内部类NoteData的setCallData方法处理
+ *
+ * @param key 通话数据的键（对应CallNote中的列名）
+ * @param value 通话数据的值（如电话号码）
+ */
+ public void setCallData(String key, String value) {
+ mNoteData.setCallData(key, value);
+ }
+
+ /**
+ * 判断笔记是否有本地修改（需要同步到数据库）
+ * 判定条件：元数据容器非空 或 文本/通话数据有修改
+ *
+ * @return true表示有本地修改，false表示无修改
+ */
+ public boolean isLocalModified() {
+ return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
+ }
+
+ /**
+ * 将笔记的本地修改同步到ContentProvider（数据库）
+ * 同步逻辑：先同步元数据，再同步具体数据，即使元数据同步失败，也尝试同步具体数据（保证数据安全）
+ *
+ * @param context 上下文对象，用于获取ContentResolver
+ * @param noteId 要同步的笔记ID（必须大于0）
+ * @return true表示同步成功（或无修改），false表示具体数据同步失败
+ * @throws IllegalArgumentException 当笔记ID小于等于0时抛出，参数不合法
+ */
+ public boolean syncNote(Context context, long noteId) {
+ // 校验笔记ID的合法性，小于等于0则抛出异常
+ if (noteId <= 0) {
+ throw new IllegalArgumentException("Wrong note id:" + noteId);
+ }
+
+ // 若没有本地修改，直接返回成功
+ if (!isLocalModified()) {
+ return true;
+ }
+
+ /**
+ * 理论上，数据变更后需要更新LOCAL_MODIFIED和MODIFIED_DATE
+ * 为了数据安全，即使元数据更新失败，也继续同步具体数据
+ */
+ // 构建笔记的Uri（content://xxx/note/[noteId]），更新元数据到数据库
+ if (context.getContentResolver().update(
+ ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
+ null) == 0) {
+ // 更新返回0表示无记录被更新，输出错误日志，但不中断流程
+ Log.e(TAG, "Update note error, should not happen");
+ // 继续执行后续的具体数据同步
+ }
+ // 清空元数据容器，标记为已同步
+ mNoteDiffValues.clear();
+
+ // 若具体数据有修改且同步失败，返回false；否则返回true
+ if (mNoteData.isLocalModified()
+ && (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * 内部嵌套类，封装笔记的具体数据（文本数据和通话记录数据）的处理逻辑
+ * 仅被外部类Note访问，符合封装原则，对外隐藏数据处理的细节
+ */
+ private class NoteData {
+ /**
+ * 文本数据的ID（对应数据库data表的主键ID）
+ * 0表示新数据（需要插入），大于0表示已有数据（需要更新）
+ */
+ private long mTextDataId;
+
+ /**
+ * 存储文本数据的键值对（如笔记内容、格式等）
+ */
+ private ContentValues mTextDataValues;
+
+ /**
+ * 通话记录数据的ID（对应数据库data表的主键ID）
+ * 0表示新数据（需要插入），大于0表示已有数据（需要更新）
+ */
+ private long mCallDataId;
+
+ /**
+ * 存储通话记录数据的键值对（如电话号码、通话时间等）
+ */
+ private ContentValues mCallDataValues;
+
+ /**
+ * 日志标签，用于标识当前内部类的日志输出
+ */
+ private static final String TAG = "NoteData";
+
+ /**
+ * 构造方法，初始化文本和通话数据的容器及ID
+ */
+ public NoteData() {
+ mTextDataValues = new ContentValues();
+ mCallDataValues = new ContentValues();
+ mTextDataId = 0;
+ mCallDataId = 0;
+ }
+
+ /**
+ * 判断文本/通话数据是否有本地修改
+ * 判定条件：文本数据容器非空 或 通话数据容器非空
+ *
+ * @return true表示有修改，false表示无修改
+ */
+ boolean isLocalModified() {
+ return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
+ }
+
+ /**
+ * 设置文本数据的ID，并校验ID的合法性
+ *
+ * @param id 文本数据的ID（必须大于0）
+ * @throws IllegalArgumentException 当ID小于等于0时抛出，参数不合法
+ */
+ void setTextDataId(long id) {
+ if (id <= 0) {
+ throw new IllegalArgumentException("Text data id should larger than 0");
+ }
+ mTextDataId = id;
+ }
+
+ /**
+ * 设置通话数据的ID，并校验ID的合法性
+ *
+ * @param id 通话数据的ID（必须大于0）
+ * @throws IllegalArgumentException 当ID小于等于0时抛出，参数不合法
+ */
+ void setCallDataId(long id) {
+ if (id <= 0) {
+ throw new IllegalArgumentException("Call data id should larger than 0");
+ }
+ mCallDataId = id;
+ }
+
+ /**
+ * 设置通话数据的键值对，并更新笔记的本地修改标记和修改时间
+ *
+ * @param key 通话数据的键（对应CallNote中的列名）
+ * @param value 通话数据的值（字符串类型）
+ */
+ void setCallData(String key, String value) {
+ // 存储通话数据键值对
+ mCallDataValues.put(key, value);
+ // 标记笔记为本地已修改
+ mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+ // 更新笔记的修改时间
+ mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+ }
+
+ /**
+ * 设置文本数据的键值对，并更新笔记的本地修改标记和修改时间
+ *
+ * @param key 文本数据的键（对应TextNote中的列名）
+ * @param value 文本数据的值（字符串类型）
+ */
+ void setTextData(String key, String value) {
+ // 存储文本数据键值对
+ mTextDataValues.put(key, value);
+ // 标记笔记为本地已修改
+ mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+ // 更新笔记的修改时间
+ mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+ }
+
+ /**
+ * 将文本/通话数据同步到ContentProvider（数据库）
+ * 处理逻辑：新数据（ID=0）执行插入操作，已有数据（ID>0）执行批量更新操作
+ *
+ * @param context 上下文对象，用于获取ContentResolver
+ * @param noteId 笔记ID，用于关联数据与笔记
+ * @return 同步后的笔记Uri（失败则返回null）
+ * @throws IllegalArgumentException 当笔记ID小于等于0时抛出，参数不合法
+ */
+ Uri pushIntoContentResolver(Context context, long noteId) {
+ /**
+ * 安全校验：笔记ID必须大于0
+ */
+ if (noteId <= 0) {
+ throw new IllegalArgumentException("Wrong note id:" + noteId);
+ }
+
+ /**
+ * 批量操作列表，用于存储ContentProviderOperation
+ * 批量操作可减少与ContentProvider的交互次数，提升性能，且支持事务特性
+ */
+ ArrayList operationList = new ArrayList();
+ // 用于构建ContentProviderOperation的构建器
+ ContentProviderOperation.Builder builder = null;
+
+ // 处理文本数据同步
+ if (mTextDataValues.size() > 0) {
+ // 添加笔记ID，关联数据与笔记（对应data表的NOTE_ID列）
+ mTextDataValues.put(DataColumns.NOTE_ID, noteId);
+ // 文本数据ID为0，表示新数据，执行插入操作
+ if (mTextDataId == 0) {
+ // 添加文本数据的MIME类型（标识数据类型为文本笔记）
+ mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
+ // 插入文本数据到data表，返回包含数据ID的Uri
+ Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+ mTextDataValues);
+ try {
+ // 解析Uri获取数据ID并设置
+ setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
+ } catch (NumberFormatException e) {
+ // 插入失败，输出错误日志，清空数据容器，返回null
+ Log.e(TAG, "Insert new text data fail with noteId" + noteId);
+ mTextDataValues.clear();
+ return null;
+ }
+ } else {
+ // 文本数据ID大于0，构建更新操作（更新指定ID的文本数据）
+ builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+ Notes.CONTENT_DATA_URI, mTextDataId));
+ // 设置更新的键值对
+ builder.withValues(mTextDataValues);
+ // 将更新操作加入批量列表
+ operationList.add(builder.build());
+ }
+ // 清空文本数据容器，标记为已同步
+ mTextDataValues.clear();
+ }
+
+ // 处理通话数据同步（逻辑与文本数据一致）
+ if (mCallDataValues.size() > 0) {
+ // 添加笔记ID，关联数据与笔记
+ mCallDataValues.put(DataColumns.NOTE_ID, noteId);
+ // 通话数据ID为0，表示新数据，执行插入操作
+ if (mCallDataId == 0) {
+ // 添加通话数据的MIME类型（标识数据类型为通话笔记）
+ mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
+ // 插入通话数据到data表
+ Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+ mCallDataValues);
+ try {
+ // 解析Uri获取数据ID并设置
+ setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
+ } catch (NumberFormatException e) {
+ // 插入失败，输出错误日志，清空数据容器，返回null
+ Log.e(TAG, "Insert new call data fail with noteId" + noteId);
+ mCallDataValues.clear();
+ return null;
+ }
+ } else {
+ // 通话数据ID大于0，构建更新操作
+ builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+ Notes.CONTENT_DATA_URI, mCallDataId));
+ builder.withValues(mCallDataValues);
+ operationList.add(builder.build());
+ }
+ // 清空通话数据容器
+ mCallDataValues.clear();
+ }
+
+ // 执行批量更新操作（若有）
+ if (operationList.size() > 0) {
+ try {
+ // 应用批量操作，返回操作结果
+ ContentProviderResult[] results = context.getContentResolver().applyBatch(
+ Notes.AUTHORITY, operationList);
+ // 校验结果，返回笔记的Uri（结果为空则返回null）
+ return (results == null || results.length == 0 || results[0] == null) ? null
+ : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
+ } catch (RemoteException e) {
+ // 捕获远程调用异常（ContentProvider可能在其他进程），输出日志，返回null
+ Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+ return null;
+ } catch (OperationApplicationException e) {
+ // 捕获操作应用异常，输出日志，返回null
+ Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+ return null;
+ }
+ }
+ // 无批量操作，返回null
+ return null;
+ }
+ }
+}
\ No newline at end of file
diff --git a/小米便签开源代码的泛读报告.docx b/小米便签开源代码的泛读报告.docx
deleted file mode 100644
index f68841d..0000000
Binary files a/小米便签开源代码的泛读报告.docx and /dev/null differ
diff --git a/新建 文本文档.txt b/新建 文本文档.txt
deleted file mode 100644
index e69de29..0000000