|
|
|
|
@ -1,31 +1,54 @@
|
|
|
|
|
/*
|
|
|
|
|
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
|
|
|
|
|
* 版权所有 (c) 2010-2011, MiCode 开源社区 (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
|
|
|
|
|
* 根据 Apache 许可证，第 2.0 版（“许可证”）许可；
|
|
|
|
|
* 除非遵循许可证，否则不得使用此文件。
|
|
|
|
|
* 可以在以下网址获取许可证副本：
|
|
|
|
|
*
|
|
|
|
|
* 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 android.app.Activity; // 用于活动管理的类
|
|
|
|
|
import android.content.ContentResolver; // 用于内容提供者的类
|
|
|
|
|
import android.content.ContentUris; // 处理内容 URI 的工具类
|
|
|
|
|
import android.content.ContentValues; // 包含 ContentProvider 插入或更新所需值的类
|
|
|
|
|
import android.content.Context; // 应用上下文类
|
|
|
|
|
import android.database.Cursor; // 数据库查询结果的类
|
|
|
|
|
import android.util.Log; // 记录日志的工具类
|
|
|
|
|
|
|
|
|
|
// 导入项目中的相关类
|
|
|
|
|
import net.micode.notes.R;
|
|
|
|
|
import net.micode.notes.data.Notes;
|
|
|
|
|
<<<<<<< HEAD
|
|
|
|
|
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; // SQL 笔记类
|
|
|
|
|
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; // GTask 字符串工具类
|
|
|
|
|
|
|
|
|
|
import org.json.JSONArray; // JSON 数组类
|
|
|
|
|
import org.json.JSONException; // JSON 异常类
|
|
|
|
|
import org.json.JSONObject; // JSON 对象类
|
|
|
|
|
|
|
|
|
|
import java.util.HashMap; // 哈希表实现
|
|
|
|
|
import java.util.HashSet; // 哈希集合实现
|
|
|
|
|
import java.util.Iterator; // 迭代器类
|
|
|
|
|
=======
|
|
|
|
|
import net.micode.notes.data.Notes.DataColumns;
|
|
|
|
|
import net.micode.notes.data.Notes.NoteColumns;
|
|
|
|
|
import net.micode.notes.gtask.data.MetaData;
|
|
|
|
|
@ -47,46 +70,49 @@ import java.util.HashSet;
|
|
|
|
|
import java.util.Iterator;
|
|
|
|
|
import java.util.Map;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// GTaskManager类用于管理与Google Tasks的同步操作，包括初始化任务列表、同步内容、处理各种同步类型的操作等功能
|
|
|
|
|
public class GTaskManager {
|
|
|
|
|
private static final String TAG = GTaskManager.class.getSimpleName();
|
|
|
|
|
|
|
|
|
|
// 同步成功状态码
|
|
|
|
|
public static final int STATE_SUCCESS = 0;
|
|
|
|
|
|
|
|
|
|
// 网络错误状态码
|
|
|
|
|
public static final int STATE_NETWORK_ERROR = 1;
|
|
|
|
|
|
|
|
|
|
// 内部错误状态码
|
|
|
|
|
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;
|
|
|
|
|
|
|
|
|
|
private static GTaskManager mInstance = null;
|
|
|
|
|
|
|
|
|
|
// 关联的Activity，用于获取授权令牌等操作
|
|
|
|
|
private Activity mActivity;
|
|
|
|
|
|
|
|
|
|
// 应用上下文
|
|
|
|
|
private Context mContext;
|
|
|
|
|
|
|
|
|
|
// 用于操作内容提供器，进行数据查询、更新等操作
|
|
|
|
|
private ContentResolver mContentResolver;
|
|
|
|
|
|
|
|
|
|
// 标记是否正在同步
|
|
|
|
|
private boolean mSyncing;
|
|
|
|
|
|
|
|
|
|
// 标记同步是否被取消
|
|
|
|
|
private boolean mCancelled;
|
|
|
|
|
|
|
|
|
|
// 存储Google Tasks任务列表的哈希表，以任务列表的全局唯一ID（GID）为键，任务列表对象为值
|
|
|
|
|
private HashMap<String, TaskList> mGTaskListHashMap;
|
|
|
|
|
|
|
|
|
|
// 存储Google Tasks节点（任务、任务列表等）的哈希表，以节点的全局唯一ID（GID）为键，节点对象为值
|
|
|
|
|
private HashMap<String, Node> mGTaskHashMap;
|
|
|
|
|
|
|
|
|
|
// 存储元数据的哈希表，以相关的全局唯一ID为键，元数据对象为值
|
|
|
|
|
private HashMap<String, MetaData> mMetaHashMap;
|
|
|
|
|
|
|
|
|
|
// 元数据对应的任务列表
|
|
|
|
|
private TaskList mMetaList;
|
|
|
|
|
|
|
|
|
|
// 存储本地已删除记录的ID集合，用于后续清理本地数据
|
|
|
|
|
private HashSet<Long> mLocalDeleteIdMap;
|
|
|
|
|
|
|
|
|
|
// 存储从Google Tasks的全局唯一ID（GID）到本地记录ID（NID）的映射关系
|
|
|
|
|
private HashMap<String, Long> mGidToNid;
|
|
|
|
|
|
|
|
|
|
// 存储从本地记录ID（NID）到Google Tasks的全局唯一ID（GID）的映射关系
|
|
|
|
|
private HashMap<Long, String> mNidToGid;
|
|
|
|
|
|
|
|
|
|
// 私有构造函数，初始化相关成员变量
|
|
|
|
|
private GTaskManager() {
|
|
|
|
|
mSyncing = false;
|
|
|
|
|
mCancelled = false;
|
|
|
|
|
@ -99,6 +125,7 @@ public class GTaskManager {
|
|
|
|
|
mNidToGid = new HashMap<Long, String>();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取GTaskManager的单例实例
|
|
|
|
|
public static synchronized GTaskManager getInstance() {
|
|
|
|
|
if (mInstance == null) {
|
|
|
|
|
mInstance = new GTaskManager();
|
|
|
|
|
@ -106,11 +133,13 @@ public class GTaskManager {
|
|
|
|
|
return mInstance;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 设置关联的Activity上下文，主要用于获取授权令牌等相关操作
|
|
|
|
|
public synchronized void setActivityContext(Activity activity) {
|
|
|
|
|
// used for getting authtoken
|
|
|
|
|
mActivity = activity;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 执行同步操作，与Google Tasks进行数据同步
|
|
|
|
|
public int sync(Context context, GTaskASyncTask asyncTask) {
|
|
|
|
|
if (mSyncing) {
|
|
|
|
|
Log.d(TAG, "Sync is in progress");
|
|
|
|
|
@ -120,6 +149,7 @@ public class GTaskManager {
|
|
|
|
|
mContentResolver = mContext.getContentResolver();
|
|
|
|
|
mSyncing = true;
|
|
|
|
|
mCancelled = false;
|
|
|
|
|
// 清除之前同步相关的数据缓存，如任务列表、节点、元数据等的哈希表以及ID映射关系等
|
|
|
|
|
mGTaskListHashMap.clear();
|
|
|
|
|
mGTaskHashMap.clear();
|
|
|
|
|
mMetaHashMap.clear();
|
|
|
|
|
@ -131,18 +161,18 @@ public class GTaskManager {
|
|
|
|
|
GTaskClient client = GTaskClient.getInstance();
|
|
|
|
|
client.resetUpdateArray();
|
|
|
|
|
|
|
|
|
|
// login google task
|
|
|
|
|
// 登录Google Tasks，如果取消同步则不再进行登录操作，如果登录失败则抛出网络异常
|
|
|
|
|
if (!mCancelled) {
|
|
|
|
|
if (!client.login(mActivity)) {
|
|
|
|
|
throw new NetworkFailureException("login google task failed");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// get the task list from google
|
|
|
|
|
// 发布同步进度信息，初始化任务列表阶段
|
|
|
|
|
asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
|
|
|
|
|
initGTaskList();
|
|
|
|
|
|
|
|
|
|
// do content sync work
|
|
|
|
|
// 发布同步进度信息，进行内容同步阶段
|
|
|
|
|
asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
|
|
|
|
|
syncContent();
|
|
|
|
|
} catch (NetworkFailureException e) {
|
|
|
|
|
@ -156,6 +186,7 @@ public class GTaskManager {
|
|
|
|
|
e.printStackTrace();
|
|
|
|
|
return STATE_INTERNAL_ERROR;
|
|
|
|
|
} finally {
|
|
|
|
|
// 无论同步是否成功，最终都清除同步相关的数据缓存
|
|
|
|
|
mGTaskListHashMap.clear();
|
|
|
|
|
mGTaskHashMap.clear();
|
|
|
|
|
mMetaHashMap.clear();
|
|
|
|
|
@ -168,14 +199,16 @@ public class GTaskManager {
|
|
|
|
|
return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 初始化Google Tasks任务列表相关信息，包括获取任务列表、元数据列表以及加载任务等操作
|
|
|
|
|
private void initGTaskList() throws NetworkFailureException {
|
|
|
|
|
if (mCancelled)
|
|
|
|
|
return;
|
|
|
|
|
GTaskClient client = GTaskClient.getInstance();
|
|
|
|
|
try {
|
|
|
|
|
// 从Google Tasks获取任务列表信息，返回JSON数组形式的数据
|
|
|
|
|
JSONArray jsTaskLists = client.getTaskLists();
|
|
|
|
|
|
|
|
|
|
// init meta list first
|
|
|
|
|
// 先初始化元数据列表，查找名为特定前缀加上"meta"的任务列表作为元数据列表
|
|
|
|
|
mMetaList = null;
|
|
|
|
|
for (int i = 0; i < jsTaskLists.length(); i++) {
|
|
|
|
|
JSONObject object = jsTaskLists.getJSONObject(i);
|
|
|
|
|
@ -187,7 +220,7 @@ public class GTaskManager {
|
|
|
|
|
mMetaList = new TaskList();
|
|
|
|
|
mMetaList.setContentByRemoteJSON(object);
|
|
|
|
|
|
|
|
|
|
// load meta data
|
|
|
|
|
// 加载元数据，获取元数据列表对应的任务列表中的具体元数据信息
|
|
|
|
|
JSONArray jsMetas = client.getTaskList(gid);
|
|
|
|
|
for (int j = 0; j < jsMetas.length(); j++) {
|
|
|
|
|
object = (JSONObject) jsMetas.getJSONObject(j);
|
|
|
|
|
@ -203,7 +236,7 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// create meta list if not existed
|
|
|
|
|
// 如果元数据列表不存在，则创建一个新的元数据列表，并发送到Google Tasks服务器创建对应的任务列表
|
|
|
|
|
if (mMetaList == null) {
|
|
|
|
|
mMetaList = new TaskList();
|
|
|
|
|
mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
|
|
|
|
|
@ -211,7 +244,7 @@ public class GTaskManager {
|
|
|
|
|
GTaskClient.getInstance().createTaskList(mMetaList);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// init task list
|
|
|
|
|
// 初始化普通任务列表，遍历获取到的任务列表信息，创建任务列表对象并加载对应的任务信息
|
|
|
|
|
for (int i = 0; i < jsTaskLists.length(); i++) {
|
|
|
|
|
JSONObject object = jsTaskLists.getJSONObject(i);
|
|
|
|
|
String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
|
|
|
|
|
@ -225,7 +258,7 @@ public class GTaskManager {
|
|
|
|
|
mGTaskListHashMap.put(gid, tasklist);
|
|
|
|
|
mGTaskHashMap.put(gid, tasklist);
|
|
|
|
|
|
|
|
|
|
// load tasks
|
|
|
|
|
// 加载任务，获取当前任务列表对应的任务信息
|
|
|
|
|
JSONArray jsTasks = client.getTaskList(gid);
|
|
|
|
|
for (int j = 0; j < jsTasks.length(); j++) {
|
|
|
|
|
object = (JSONObject) jsTasks.getJSONObject(j);
|
|
|
|
|
@ -247,6 +280,7 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 进行内容同步操作，处理本地与Google Tasks之间的数据同步，包括本地删除、文件夹同步、数据库中已有记录的同步等情况
|
|
|
|
|
private void syncContent() throws NetworkFailureException {
|
|
|
|
|
int syncType;
|
|
|
|
|
Cursor c = null;
|
|
|
|
|
@ -259,7 +293,7 @@ public class GTaskManager {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// for local deleted note
|
|
|
|
|
// 处理本地已删除的笔记（记录），查询本地回收站文件夹中的记录，对比Google Tasks中的对应节点进行相应的同步操作
|
|
|
|
|
try {
|
|
|
|
|
c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
|
|
|
|
|
"(type<>? AND parent_id=?)", new String[] {
|
|
|
|
|
@ -286,10 +320,10 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// sync folder first
|
|
|
|
|
// 同步文件夹相关信息
|
|
|
|
|
syncFolder();
|
|
|
|
|
|
|
|
|
|
// for note existing in database
|
|
|
|
|
// 处理数据库中已存在的笔记（记录），根据其在Google Tasks中的对应情况确定同步类型，然后进行相应的同步操作
|
|
|
|
|
try {
|
|
|
|
|
c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
|
|
|
|
|
"(type=? AND parent_id<>?)", new String[] {
|
|
|
|
|
@ -306,10 +340,10 @@ public class GTaskManager {
|
|
|
|
|
syncType = node.getSyncAction(c);
|
|
|
|
|
} else {
|
|
|
|
|
if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
|
|
|
|
|
// local add
|
|
|
|
|
// 本地新增情况
|
|
|
|
|
syncType = Node.SYNC_ACTION_ADD_REMOTE;
|
|
|
|
|
} else {
|
|
|
|
|
// remote delete
|
|
|
|
|
// 远程已删除情况
|
|
|
|
|
syncType = Node.SYNC_ACTION_DEL_LOCAL;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
@ -326,7 +360,7 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// go through remaining items
|
|
|
|
|
// 处理剩余的在Google Tasks中存在但本地未处理的节点，进行相应的同步操作（一般是添加到本地）
|
|
|
|
|
Iterator<Map.Entry<String, Node>> iter = mGTaskHashMap.entrySet().iterator();
|
|
|
|
|
while (iter.hasNext()) {
|
|
|
|
|
Map.Entry<String, Node> entry = iter.next();
|
|
|
|
|
@ -334,16 +368,14 @@ public class GTaskManager {
|
|
|
|
|
doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// mCancelled can be set by another thread, so we neet to check one by
|
|
|
|
|
// one
|
|
|
|
|
// clear local delete table
|
|
|
|
|
// mCancelled可能被其他线程设置，所以需要逐个检查，清除本地已删除记录的相关数据（如果同步未取消）
|
|
|
|
|
if (!mCancelled) {
|
|
|
|
|
if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) {
|
|
|
|
|
throw new ActionFailureException("failed to batch-delete local deleted notes");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// refresh local sync id
|
|
|
|
|
// 刷新本地同步ID（如果同步未取消），提交更新并进行相关操作来更新本地记录的同步ID
|
|
|
|
|
if (!mCancelled) {
|
|
|
|
|
GTaskClient.getInstance().commitUpdate();
|
|
|
|
|
refreshLocalSyncId();
|
|
|
|
|
@ -351,6 +383,7 @@ public class GTaskManager {
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 同步文件夹相关信息，包括根文件夹、通话记录文件夹、本地已存在的文件夹以及远程新增的文件夹等情况的处理
|
|
|
|
|
private void syncFolder() throws NetworkFailureException {
|
|
|
|
|
Cursor c = null;
|
|
|
|
|
String gid;
|
|
|
|
|
@ -361,7 +394,7 @@ public class GTaskManager {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// for root folder
|
|
|
|
|
// 处理根文件夹的同步情况，根据其在Google Tasks中的对应情况进行相应的同步操作（添加、更新等）
|
|
|
|
|
try {
|
|
|
|
|
c = mContentResolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
|
|
|
|
|
Notes.ID_ROOT_FOLDER), SqlNote.PROJECTION_NOTE, null, null, null);
|
|
|
|
|
@ -373,7 +406,7 @@ public class GTaskManager {
|
|
|
|
|
mGTaskHashMap.remove(gid);
|
|
|
|
|
mGidToNid.put(gid, (long) Notes.ID_ROOT_FOLDER);
|
|
|
|
|
mNidToGid.put((long) Notes.ID_ROOT_FOLDER, gid);
|
|
|
|
|
// for system folder, only update remote name if necessary
|
|
|
|
|
// 对于系统文件夹，仅在必要时更新远程名称
|
|
|
|
|
if (!node.getName().equals(
|
|
|
|
|
GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT))
|
|
|
|
|
doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
|
|
|
|
|
@ -390,77 +423,101 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// for call-note folder
|
|
|
|
|
// for call-note文件夹相关的同步操作处理
|
|
|
|
|
// 查询通话记录文件夹在本地数据库中的信息，根据其在Google Tasks中的对应情况进行相应的同步操作（添加、更新等）
|
|
|
|
|
// 如果查询到该文件夹信息存在（即游标c不为空且能移动到下一条记录），则进一步处理
|
|
|
|
|
try {
|
|
|
|
|
// 通过ContentResolver查询本地数据库中通话记录文件夹的记录信息，指定查询条件为_id等于通话记录文件夹的特定ID
|
|
|
|
|
c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, "(_id=?)",
|
|
|
|
|
new String[] {
|
|
|
|
|
String.valueOf(Notes.ID_CALL_RECORD_FOLDER)
|
|
|
|
|
String.valueOf(Notes.ID_CALL_RECORD_FOLDER)
|
|
|
|
|
}, null);
|
|
|
|
|
if (c != null) {
|
|
|
|
|
if (c.moveToNext()) {
|
|
|
|
|
// 获取该文件夹在Google Tasks中对应的全局唯一ID（GID）
|
|
|
|
|
gid = c.getString(SqlNote.GTASK_ID_COLUMN);
|
|
|
|
|
// 根据GID从存储Google Tasks节点的哈希表中获取对应的节点对象
|
|
|
|
|
node = mGTaskHashMap.get(gid);
|
|
|
|
|
if (node != null) {
|
|
|
|
|
// 如果节点存在，从哈希表中移除该节点（表示已处理）
|
|
|
|
|
mGTaskHashMap.remove(gid);
|
|
|
|
|
// 在本地ID到Google Tasks的GID映射表中记录该文件夹的映射关系，键为GID，值为通话记录文件夹的本地ID
|
|
|
|
|
mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER);
|
|
|
|
|
// 在Google Tasks的GID到本地ID映射表中记录映射关系，键为本地ID，值为GID
|
|
|
|
|
mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid);
|
|
|
|
|
// for system folder, only update remote name if
|
|
|
|
|
// necessary
|
|
|
|
|
// 对于系统文件夹，仅在其名称与预期的通话记录文件夹名称不一致时（即可能有更新情况），进行远程更新操作
|
|
|
|
|
if (!node.getName().equals(
|
|
|
|
|
GTaskStringUtils.MIUI_FOLDER_PREFFIX
|
|
|
|
|
+ GTaskStringUtils.FOLDER_CALL_NOTE))
|
|
|
|
|
doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
|
|
|
|
|
} else {
|
|
|
|
|
// 如果节点不存在，则执行添加远程节点的操作（意味着本地有该文件夹记录，但在Google Tasks中还未创建对应节点）
|
|
|
|
|
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;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// for local existing folders
|
|
|
|
|
// 处理本地已存在的文件夹的同步情况
|
|
|
|
|
// 查询本地除回收站外的文件夹记录信息，根据其在Google Tasks中的对应情况进行相应的同步操作
|
|
|
|
|
try {
|
|
|
|
|
// 通过ContentResolver查询本地数据库中符合条件的文件夹记录信息，条件为类型是文件夹且父ID不等于回收站文件夹的ID
|
|
|
|
|
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()) {
|
|
|
|
|
// 获取文件夹在Google Tasks中对应的全局唯一ID（GID）
|
|
|
|
|
gid = c.getString(SqlNote.GTASK_ID_COLUMN);
|
|
|
|
|
// 根据GID从存储Google Tasks节点的哈希表中获取对应的节点对象
|
|
|
|
|
node = mGTaskHashMap.get(gid);
|
|
|
|
|
if (node != null) {
|
|
|
|
|
// 如果节点存在，从哈希表中移除该节点（表示已处理）
|
|
|
|
|
mGTaskHashMap.remove(gid);
|
|
|
|
|
// 在本地ID到Google Tasks的GID映射表中记录该文件夹的映射关系，键为GID，值为文件夹的本地ID
|
|
|
|
|
mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
|
|
|
|
|
// 在Google Tasks的GID到本地ID映射表中记录映射关系，键为本地ID，值为GID
|
|
|
|
|
mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
|
|
|
|
|
// 获取该节点对应的同步操作类型（根据节点和游标信息判断是添加、更新、删除等哪种类型）
|
|
|
|
|
syncType = node.getSyncAction(c);
|
|
|
|
|
} else {
|
|
|
|
|
// 如果节点不存在，根据其GID是否为空字符串判断是本地新增还是远程删除情况，进而确定同步类型
|
|
|
|
|
if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
|
|
|
|
|
// local add
|
|
|
|
|
// 本地新增情况，同步类型设置为添加远程节点
|
|
|
|
|
syncType = Node.SYNC_ACTION_ADD_REMOTE;
|
|
|
|
|
} else {
|
|
|
|
|
// remote delete
|
|
|
|
|
// 远程删除情况，同步类型设置为删除本地节点
|
|
|
|
|
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;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// for remote add folders
|
|
|
|
|
// 处理远程新增文件夹的同步情况
|
|
|
|
|
// 遍历存储Google Tasks任务列表的哈希表，对于在Google
|
|
|
|
|
// Tasks中存在但本地未处理（还在mGTaskHashMap中）的文件夹，进行添加本地节点的同步操作
|
|
|
|
|
Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
|
|
|
|
|
while (iter.hasNext()) {
|
|
|
|
|
Map.Entry<String, TaskList> entry = iter.next();
|
|
|
|
|
@ -472,10 +529,12 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 如果同步未被取消，提交Google Tasks客户端的更新操作（将之前暂存的更新操作发送到服务器执行）
|
|
|
|
|
if (!mCancelled)
|
|
|
|
|
GTaskClient.getInstance().commitUpdate();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 根据给定的同步类型执行具体的内容同步操作
|
|
|
|
|
private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
@ -483,12 +542,16 @@ public class GTaskManager {
|
|
|
|
|
|
|
|
|
|
MetaData meta;
|
|
|
|
|
switch (syncType) {
|
|
|
|
|
// 同步类型为添加本地节点，调用相应方法进行本地节点添加操作
|
|
|
|
|
case Node.SYNC_ACTION_ADD_LOCAL:
|
|
|
|
|
addLocalNode(node);
|
|
|
|
|
break;
|
|
|
|
|
// 同步类型为添加远程节点，调用相应方法进行远程节点添加操作，并传入节点和游标信息
|
|
|
|
|
case Node.SYNC_ACTION_ADD_REMOTE:
|
|
|
|
|
addRemoteNode(node, c);
|
|
|
|
|
break;
|
|
|
|
|
// 同步类型为删除本地节点，先从元数据哈希表中获取对应的元数据，若存在则调用Google Tasks客户端删除该元数据节点，
|
|
|
|
|
// 同时将本地记录的ID添加到本地已删除记录集合中
|
|
|
|
|
case Node.SYNC_ACTION_DEL_LOCAL:
|
|
|
|
|
meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN));
|
|
|
|
|
if (meta != null) {
|
|
|
|
|
@ -496,6 +559,8 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN));
|
|
|
|
|
break;
|
|
|
|
|
// 同步类型为删除远程节点，先从元数据哈希表中获取对应节点的元数据，若存在则调用Google Tasks客户端删除该元数据节点，
|
|
|
|
|
// 然后再删除该节点本身
|
|
|
|
|
case Node.SYNC_ACTION_DEL_REMOTE:
|
|
|
|
|
meta = mMetaHashMap.get(node.getGid());
|
|
|
|
|
if (meta != null) {
|
|
|
|
|
@ -503,51 +568,66 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
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:
|
|
|
|
|
// merging both modifications maybe a good idea
|
|
|
|
|
// right now just use local update simply
|
|
|
|
|
updateRemoteNode(node, c);
|
|
|
|
|
break;
|
|
|
|
|
// 同步类型为无操作，直接跳过不做任何处理
|
|
|
|
|
case Node.SYNC_ACTION_NONE:
|
|
|
|
|
break;
|
|
|
|
|
// 同步类型为错误或其他未知类型，抛出操作失败异常，表示遇到了未知的同步操作类型
|
|
|
|
|
case Node.SYNC_ACTION_ERROR:
|
|
|
|
|
default:
|
|
|
|
|
throw new ActionFailureException("unkown sync action type");
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 添加本地节点的操作方法
|
|
|
|
|
private void addLocalNode(Node node) throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
SqlNote sqlNote;
|
|
|
|
|
// 如果节点是任务列表类型（TaskList）
|
|
|
|
|
if (node instanceof TaskList) {
|
|
|
|
|
// 如果节点名称是默认根文件夹的名称，创建一个对应根文件夹的SqlNote对象，传入上下文和根文件夹的本地ID
|
|
|
|
|
if (node.getName().equals(
|
|
|
|
|
GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) {
|
|
|
|
|
sqlNote = new SqlNote(mContext, Notes.ID_ROOT_FOLDER);
|
|
|
|
|
} else if (node.getName().equals(
|
|
|
|
|
GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) {
|
|
|
|
|
// 如果节点名称是通话记录文件夹的名称，创建一个对应通话记录文件夹的SqlNote对象，传入上下文和通话记录文件夹的本地ID
|
|
|
|
|
sqlNote = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER);
|
|
|
|
|
} else {
|
|
|
|
|
// 其他普通任务列表情况，创建一个新的SqlNote对象，传入上下文
|
|
|
|
|
sqlNote = new SqlNote(mContext);
|
|
|
|
|
// 设置SqlNote的内容为节点的本地JSON格式内容（从节点获取）
|
|
|
|
|
sqlNote.setContent(node.getLocalJSONFromContent());
|
|
|
|
|
// 设置父ID为根文件夹的本地ID
|
|
|
|
|
sqlNote.setParentId(Notes.ID_ROOT_FOLDER);
|
|
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
// 如果节点是普通任务（Task）类型，创建一个新的SqlNote对象，传入上下文
|
|
|
|
|
sqlNote = new SqlNote(mContext);
|
|
|
|
|
JSONObject js = node.getLocalJSONFromContent();
|
|
|
|
|
try {
|
|
|
|
|
// 如果节点的本地JSON数据中包含特定的笔记头部信息（META_HEAD_NOTE）
|
|
|
|
|
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);
|
|
|
|
|
// 检查该笔记ID在本地笔记数据库中是否已存在，如果存在则移除该ID（可能需要重新生成新的ID）
|
|
|
|
|
if (DataUtils.existInNoteDatabase(mContentResolver, id)) {
|
|
|
|
|
// the id is not available, have to create a new one
|
|
|
|
|
note.remove(NoteColumns.ID);
|
|
|
|
|
@ -555,12 +635,14 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 如果节点的本地JSON数据中包含特定的数据头部信息（META_HEAD_DATA）
|
|
|
|
|
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);
|
|
|
|
|
// 检查该数据ID在本地数据数据库中是否已存在，如果存在则移除该ID（可能需要重新生成新的ID）
|
|
|
|
|
if (DataUtils.existInDataDatabase(mContentResolver, dataId)) {
|
|
|
|
|
// the data id is not available, have to create
|
|
|
|
|
// a new one
|
|
|
|
|
@ -574,36 +656,43 @@ public class GTaskManager {
|
|
|
|
|
Log.w(TAG, e.toString());
|
|
|
|
|
e.printStackTrace();
|
|
|
|
|
}
|
|
|
|
|
// 设置SqlNote的内容为处理后的JSON数据
|
|
|
|
|
sqlNote.setContent(js);
|
|
|
|
|
|
|
|
|
|
// 获取任务节点的父节点在本地ID到Google Tasks的GID映射表中的对应父ID，如果不存在则抛出异常表示找不到本地父ID
|
|
|
|
|
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");
|
|
|
|
|
}
|
|
|
|
|
// 设置SqlNote的父ID为获取到的父节点的本地ID
|
|
|
|
|
sqlNote.setParentId(parentId.longValue());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// create the local node
|
|
|
|
|
// 设置SqlNote的Google Tasks全局唯一ID（GID）为节点的GID
|
|
|
|
|
sqlNote.setGtaskId(node.getGid());
|
|
|
|
|
// 将SqlNote对象提交保存到本地数据库（传入参数false可能表示不触发某些额外的相关操作）
|
|
|
|
|
sqlNote.commit(false);
|
|
|
|
|
|
|
|
|
|
// update gid-nid mapping
|
|
|
|
|
// 在本地ID到Google Tasks的GID映射表中记录该节点的映射关系，键为节点的GID，值为SqlNote的本地ID
|
|
|
|
|
mGidToNid.put(node.getGid(), sqlNote.getId());
|
|
|
|
|
// 在Google Tasks的GID到本地ID映射表中记录映射关系，键为SqlNote的本地ID，值为节点的GID
|
|
|
|
|
mNidToGid.put(sqlNote.getId(), node.getGid());
|
|
|
|
|
|
|
|
|
|
// update meta
|
|
|
|
|
// 更新远程元数据，传入节点的GID和对应的SqlNote对象
|
|
|
|
|
updateRemoteMeta(node.getGid(), sqlNote);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 更新本地节点的操作方法
|
|
|
|
|
private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
SqlNote sqlNote;
|
|
|
|
|
// update the note locally
|
|
|
|
|
// 根据传入的上下文和游标信息创建一个新的SqlNote对象，用于更新本地节点信息
|
|
|
|
|
sqlNote = new SqlNote(mContext, c);
|
|
|
|
|
// 设置SqlNote的内容为节点的本地JSON格式内容（从节点获取）
|
|
|
|
|
sqlNote.setContent(node.getLocalJSONFromContent());
|
|
|
|
|
|
|
|
|
|
Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
|
|
|
|
|
@ -612,13 +701,16 @@ public class GTaskManager {
|
|
|
|
|
Log.e(TAG, "cannot find task's parent id locally");
|
|
|
|
|
throw new ActionFailureException("cannot update local node");
|
|
|
|
|
}
|
|
|
|
|
// 设置SqlNote的父ID为获取到的父节点的本地ID
|
|
|
|
|
sqlNote.setParentId(parentId.longValue());
|
|
|
|
|
// 将更新后的SqlNote对象提交保存到本地数据库（传入参数true可能表示触发某些额外的相关操作）
|
|
|
|
|
sqlNote.commit(true);
|
|
|
|
|
|
|
|
|
|
// update meta info
|
|
|
|
|
// 更新远程元数据，传入节点的GID和对应的SqlNote对象
|
|
|
|
|
updateRemoteMeta(node.getGid(), sqlNote);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 添加远程节点的操作方法
|
|
|
|
|
private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
@ -627,9 +719,10 @@ public class GTaskManager {
|
|
|
|
|
SqlNote sqlNote = new SqlNote(mContext, c);
|
|
|
|
|
Node n;
|
|
|
|
|
|
|
|
|
|
// update remotely
|
|
|
|
|
// 如果SqlNote对应的是笔记类型（即普通任务）
|
|
|
|
|
if (sqlNote.isNoteType()) {
|
|
|
|
|
Task task = new Task();
|
|
|
|
|
// 设置任务的内容为从本地SqlNote获取的JSON格式内容
|
|
|
|
|
task.setContentByLocalJSON(sqlNote.getContent());
|
|
|
|
|
|
|
|
|
|
String parentGid = mNidToGid.get(sqlNote.getParentId());
|
|
|
|
|
@ -637,17 +730,20 @@ public class GTaskManager {
|
|
|
|
|
Log.e(TAG, "cannot find task's parent tasklist");
|
|
|
|
|
throw new ActionFailureException("cannot add remote task");
|
|
|
|
|
}
|
|
|
|
|
// 将任务添加到对应的父任务列表中（通过本地ID到Google Tasks的GID映射表找到父任务列表）
|
|
|
|
|
mGTaskListHashMap.get(parentGid).addChildTask(task);
|
|
|
|
|
|
|
|
|
|
// 通过Google Tasks客户端创建该任务（发送到服务器创建对应的任务节点）
|
|
|
|
|
GTaskClient.getInstance().createTask(task);
|
|
|
|
|
n = (Node) task;
|
|
|
|
|
|
|
|
|
|
// add meta
|
|
|
|
|
// 更新远程元数据，传入任务的GID和对应的SqlNote对象
|
|
|
|
|
updateRemoteMeta(task.getGid(), sqlNote);
|
|
|
|
|
} else {
|
|
|
|
|
TaskList tasklist = null;
|
|
|
|
|
|
|
|
|
|
// we need to skip folder if it has already existed
|
|
|
|
|
// 构建文件夹名称，先添加特定的前缀，然后根据SqlNote的本地ID判断是否是根文件夹或通话记录文件夹，添加相应的后缀名称，
|
|
|
|
|
// 否则添加SqlNote的摘要信息作为后缀
|
|
|
|
|
String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX;
|
|
|
|
|
if (sqlNote.getId() == Notes.ID_ROOT_FOLDER)
|
|
|
|
|
folderName += GTaskStringUtils.FOLDER_DEFAULT;
|
|
|
|
|
@ -656,121 +752,166 @@ public class GTaskManager {
|
|
|
|
|
else
|
|
|
|
|
folderName += sqlNote.getSnippet();
|
|
|
|
|
|
|
|
|
|
// 遍历存储Google Tasks任务列表的哈希表（mGTaskListHashMap）的迭代器
|
|
|
|
|
Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
|
|
|
|
|
while (iter.hasNext()) {
|
|
|
|
|
// 获取哈希表中的每一个键值对，键是任务列表的全局唯一ID（GID），值是对应的任务列表对象（TaskList）
|
|
|
|
|
Map.Entry<String, TaskList> entry = iter.next();
|
|
|
|
|
String gid = entry.getKey();
|
|
|
|
|
TaskList list = entry.getValue();
|
|
|
|
|
|
|
|
|
|
// 判断当前任务列表的名称是否与之前构建的文件夹名称（folderName）相等
|
|
|
|
|
if (list.getName().equals(folderName)) {
|
|
|
|
|
// 如果相等，说明找到了对应的任务列表，将其赋值给tasklist变量
|
|
|
|
|
tasklist = list;
|
|
|
|
|
// 如果在存储Google Tasks节点的哈希表（mGTaskHashMap）中包含该任务列表的GID，说明已经处理过，将其移除
|
|
|
|
|
if (mGTaskHashMap.containsKey(gid)) {
|
|
|
|
|
mGTaskHashMap.remove(gid);
|
|
|
|
|
}
|
|
|
|
|
// 找到匹配的任务列表后就可以结束循环了
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// no match we can add now
|
|
|
|
|
// 如果经过上述查找没有找到匹配的任务列表（tasklist仍为null），则创建一个新的任务列表对象
|
|
|
|
|
if (tasklist == null) {
|
|
|
|
|
tasklist = new TaskList();
|
|
|
|
|
// 设置新任务列表的内容为从本地SqlNote获取的JSON格式内容
|
|
|
|
|
tasklist.setContentByLocalJSON(sqlNote.getContent());
|
|
|
|
|
// 通过Google Tasks客户端创建该任务列表（发送到服务器创建对应的任务列表节点）
|
|
|
|
|
GTaskClient.getInstance().createTaskList(tasklist);
|
|
|
|
|
// 将新创建的任务列表添加到存储Google Tasks任务列表的哈希表中，键为任务列表的GID，值为任务列表对象
|
|
|
|
|
mGTaskListHashMap.put(tasklist.getGid(), tasklist);
|
|
|
|
|
}
|
|
|
|
|
// 将创建或找到的任务列表对象转换为Node类型并赋值给n（因为Node是更通用的节点类型，TaskList是一种特殊的Node）
|
|
|
|
|
n = (Node) tasklist;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// update local note
|
|
|
|
|
// 更新本地笔记相关信息
|
|
|
|
|
// 设置本地SqlNote的Google Tasks全局唯一ID（GID）为n的GID，即与远程任务列表或任务对应的GID保持一致
|
|
|
|
|
sqlNote.setGtaskId(n.getGid());
|
|
|
|
|
// 将SqlNote对象提交保存到本地数据库（传入参数false可能表示不触发某些额外的相关操作，此处用于保存基本的关联信息等）
|
|
|
|
|
sqlNote.commit(false);
|
|
|
|
|
// 重置本地修改标志（可能表示将本地记录标记为已与远程同步，不再是本地修改状态）
|
|
|
|
|
sqlNote.resetLocalModified();
|
|
|
|
|
// 再次提交保存SqlNote对象到本地数据库（传入参数true可能表示触发一些更新相关的额外操作，确保修改标志等信息更新成功）
|
|
|
|
|
sqlNote.commit(true);
|
|
|
|
|
|
|
|
|
|
// gid-id mapping
|
|
|
|
|
// gid-id映射更新
|
|
|
|
|
// 在本地ID到Google Tasks的GID映射表（mGidToNid）中记录该节点（n）的映射关系，键为节点的GID，值为SqlNote的本地ID
|
|
|
|
|
mGidToNid.put(n.getGid(), sqlNote.getId());
|
|
|
|
|
// 在Google Tasks的GID到本地ID映射表（mNidToGid）中记录映射关系，键为SqlNote的本地ID，值为节点的GID
|
|
|
|
|
mNidToGid.put(sqlNote.getId(), n.getGid());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 更新远程节点的操作方法
|
|
|
|
|
private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 根据传入的上下文和游标信息创建一个新的SqlNote对象，用于后续操作
|
|
|
|
|
SqlNote sqlNote = new SqlNote(mContext, c);
|
|
|
|
|
|
|
|
|
|
// update remotely
|
|
|
|
|
// 远程更新操作
|
|
|
|
|
// 设置远程节点（node）的内容为从本地SqlNote获取的JSON格式内容，即将本地修改同步到远程节点
|
|
|
|
|
node.setContentByLocalJSON(sqlNote.getContent());
|
|
|
|
|
// 通过Google Tasks客户端将更新后的节点添加到更新队列中（后续会批量提交更新到服务器）
|
|
|
|
|
GTaskClient.getInstance().addUpdateNode(node);
|
|
|
|
|
|
|
|
|
|
// update meta
|
|
|
|
|
// 更新远程元数据，传入节点的GID和对应的SqlNote对象
|
|
|
|
|
updateRemoteMeta(node.getGid(), sqlNote);
|
|
|
|
|
|
|
|
|
|
// move task if necessary
|
|
|
|
|
// 如果SqlNote对应的是笔记类型（即普通任务），则可能需要处理任务移动相关操作
|
|
|
|
|
if (sqlNote.isNoteType()) {
|
|
|
|
|
Task task = (Task) node;
|
|
|
|
|
// 获取任务当前的父任务列表
|
|
|
|
|
TaskList preParentList = task.getParent();
|
|
|
|
|
|
|
|
|
|
// 通过本地ID到Google Tasks的GID映射表，根据本地记录的父ID获取当前任务在远程对应的父任务列表的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");
|
|
|
|
|
}
|
|
|
|
|
// 根据获取到的GID从存储Google Tasks任务列表的哈希表中获取当前任务在远程对应的父任务列表对象
|
|
|
|
|
TaskList curParentList = mGTaskListHashMap.get(curParentGid);
|
|
|
|
|
|
|
|
|
|
// 如果当前任务的前后父任务列表不一致，说明任务需要在远程进行移动操作
|
|
|
|
|
if (preParentList != curParentList) {
|
|
|
|
|
// 先从原父任务列表中移除该任务
|
|
|
|
|
preParentList.removeChildTask(task);
|
|
|
|
|
// 将任务添加到新的父任务列表中
|
|
|
|
|
curParentList.addChildTask(task);
|
|
|
|
|
// 通过Google Tasks客户端执行任务移动操作，告知服务器任务在远程的位置变更
|
|
|
|
|
GTaskClient.getInstance().moveTask(task, preParentList, curParentList);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// clear local modified flag
|
|
|
|
|
// 清除本地修改标志，标记本地记录已同步到远程，不再处于本地修改状态
|
|
|
|
|
sqlNote.resetLocalModified();
|
|
|
|
|
// 将更新后的SqlNote对象提交保存到本地数据库（传入参数true可能表示触发一些更新相关的额外操作，确保修改标志等信息更新成功）
|
|
|
|
|
sqlNote.commit(true);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 更新远程元数据的操作方法
|
|
|
|
|
private void updateRemoteMeta(String gid, SqlNote sqlNote) throws NetworkFailureException {
|
|
|
|
|
if (sqlNote != null && sqlNote.isNoteType()) {
|
|
|
|
|
// 从存储元数据的哈希表（mMetaHashMap）中根据GID获取对应的元数据对象（MetaData）
|
|
|
|
|
MetaData metaData = mMetaHashMap.get(gid);
|
|
|
|
|
if (metaData != null) {
|
|
|
|
|
// 如果元数据对象存在，设置其元数据内容，传入GID和从本地SqlNote获取的JSON格式内容
|
|
|
|
|
metaData.setMeta(gid, sqlNote.getContent());
|
|
|
|
|
// 通过Google Tasks客户端将更新后的元数据添加到更新队列中（后续会批量提交更新到服务器）
|
|
|
|
|
GTaskClient.getInstance().addUpdateNode(metaData);
|
|
|
|
|
} else {
|
|
|
|
|
// 如果元数据对象不存在，则创建一个新的元数据对象
|
|
|
|
|
metaData = new MetaData();
|
|
|
|
|
// 设置新元数据对象的元数据内容，传入GID和从本地SqlNote获取的JSON格式内容
|
|
|
|
|
metaData.setMeta(gid, sqlNote.getContent());
|
|
|
|
|
// 将新创建的元数据对象添加到元数据列表（mMetaList）中作为子任务（从逻辑上关联起来）
|
|
|
|
|
mMetaList.addChildTask(metaData);
|
|
|
|
|
// 将新创建的元数据对象添加到存储元数据的哈希表中，键为GID，值为元数据对象
|
|
|
|
|
mMetaHashMap.put(gid, metaData);
|
|
|
|
|
// 通过Google Tasks客户端创建该元数据任务（发送到服务器创建对应的元数据节点）
|
|
|
|
|
GTaskClient.getInstance().createTask(metaData);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 刷新本地同步ID的操作方法
|
|
|
|
|
private void refreshLocalSyncId() throws NetworkFailureException {
|
|
|
|
|
if (mCancelled) {
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// get the latest gtask list
|
|
|
|
|
// 为了获取最新的Google Tasks列表信息，先清空之前存储相关信息的哈希表
|
|
|
|
|
mGTaskHashMap.clear();
|
|
|
|
|
mGTaskListHashMap.clear();
|
|
|
|
|
mMetaHashMap.clear();
|
|
|
|
|
// 重新初始化Google Tasks列表信息（重新获取任务列表、元数据等相关内容）
|
|
|
|
|
initGTaskList();
|
|
|
|
|
|
|
|
|
|
Cursor c = null;
|
|
|
|
|
try {
|
|
|
|
|
// 通过ContentResolver查询本地数据库中除系统类型且不在回收站的笔记记录信息，按照类型降序排列
|
|
|
|
|
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()) {
|
|
|
|
|
// 获取笔记在Google Tasks中对应的全局唯一ID（GID）
|
|
|
|
|
String gid = c.getString(SqlNote.GTASK_ID_COLUMN);
|
|
|
|
|
// 根据GID从存储Google Tasks节点的哈希表中获取对应的节点对象
|
|
|
|
|
Node node = mGTaskHashMap.get(gid);
|
|
|
|
|
if (node != null) {
|
|
|
|
|
// 如果节点存在，从哈希表中移除该节点（表示已处理）
|
|
|
|
|
mGTaskHashMap.remove(gid);
|
|
|
|
|
// 创建一个ContentValues对象用于存放要更新的数据，此处将同步ID设置为节点的最后修改时间
|
|
|
|
|
ContentValues values = new ContentValues();
|
|
|
|
|
values.put(NoteColumns.SYNC_ID, node.getLastModified());
|
|
|
|
|
// 通过ContentResolver更新本地数据库中对应笔记的记录，设置同步ID字段的值
|
|
|
|
|
mContentResolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
|
|
|
|
|
c.getLong(SqlNote.ID_COLUMN)), values, null, null);
|
|
|
|
|
} else {
|
|
|
|
|
@ -783,6 +924,7 @@ public class GTaskManager {
|
|
|
|
|
Log.w(TAG, "failed to query local note to refresh sync id");
|
|
|
|
|
}
|
|
|
|
|
} finally {
|
|
|
|
|
// 无论查询是否成功，最终都要关闭游标，释放资源，并将游标置空
|
|
|
|
|
if (c != null) {
|
|
|
|
|
c.close();
|
|
|
|
|
c = null;
|
|
|
|
|
@ -790,11 +932,14 @@ public class GTaskManager {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取同步账户名称的方法，通过Google Tasks客户端获取同步账户对象，并返回其名称
|
|
|
|
|
public String getSyncAccount() {
|
|
|
|
|
return GTaskClient.getInstance().getSyncAccount().name;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 取消同步的方法，将表示同步是否取消的标志（mCancelled）设置为true，其他相关操作可以根据该标志来判断是否停止执行
|
|
|
|
|
public void cancelSync() {
|
|
|
|
|
mCancelled = true;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
>>>>>>> a495b394fa4686564cc2bfe7d054eb66276713ae
|
|
|
|
|
|
pqfx375oj
jacky-qiao
zhangjinhan
张鹏展