p3o5nagmu
/
note
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Compare commits

base: p3o5nagmu:main
Branches Tags
p3o5nagmu:main
p3o5nagmu:shenyifei
p3o5nagmu:徐睿嘉
p3o5nagmu:lxy
..
compare: p3o5nagmu:lxy
Branches Tags
p3o5nagmu:main
p3o5nagmu:shenyifei
p3o5nagmu:徐睿嘉
p3o5nagmu:lxy

No commits in common. 'main' and 'lxy' have entirely different histories.
main ... lxy

28 changed files with 0 additions and 6563 deletions
Show Stats

47
ActionFailureException.java
Unescape View File

@ -1,47 +0,0 @@
/*
* 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.
*/
// 包声明，表明该类位于net.micode.notes.gtask.exception包下，用于对特定业务逻辑中的异常情况进行统一管理和处理，这里主要和任务相关操作的异常有关（从包名推测）。
package net.micode.notes.gtask.exception;
// ActionFailureException类继承自RuntimeException，意味着它是一个运行时异常，不需要在编译时显式地被捕获或者声明抛出（当然也可以根据需要进行捕获处理）。
// 该类主要用于表示在任务相关操作（比如创建、更新任务等操作，从使用场景推测）中出现失败情况时抛出的异常，方便在业务逻辑中区分不同类型的异常情况并进行针对性处理。
public class ActionFailureException extends RuntimeException {
// 定义一个序列化版本号，用于在对象序列化和反序列化过程中保证版本兼容性，这个值是根据Java的序列化机制要求生成的一个固定的长整型数字，
// 当类的结构发生变化（如添加、删除成员变量等情况）时，可能需要相应地更新这个版本号，以避免反序列化出现问题，但如果类结构稳定，通常保持这个初始值即可。
private static final long serialVersionUID = 4425249765923293627L;
// 无参构造函数，调用父类（RuntimeException）的无参构造函数，用于创建一个默认的ActionFailureException实例，
// 当在业务逻辑中不需要指定具体的异常信息时，可以使用这个构造函数创建异常对象并抛出，不过通常这种情况较少，更多是希望传递一些描述失败原因的信息。
public ActionFailureException() {
super();
}
// 带有一个字符串参数的构造函数，接收一个表示异常详细信息的字符串（paramString），调用父类（RuntimeException）相应的构造函数，
// 将该字符串作为异常信息传递进去，用于创建一个带有具体描述信息的ActionFailureException实例，方便在抛出异常时告知调用者具体的失败原因，
// 比如在任务创建操作失败时，可以传递类似"创建任务时参数不合法"这样的信息，便于定位问题。
public ActionFailureException(String paramString) {
super(paramString);
}
// 带有一个字符串参数和一个Throwable参数的构造函数，接收一个表示异常详细信息的字符串（paramString）以及一个表示引起当前异常的根异常对象（paramThrowable），
// 调用父类（RuntimeException）相应的构造函数，将这两个参数传递进去，用于创建一个既包含具体描述信息又关联了引起当前异常的底层异常的ActionFailureException实例，
// 例如在任务更新操作因为数据库连接异常而失败时，可以传递类似"更新任务时数据库连接失败"作为paramString，同时将数据库连接相关的异常对象作为paramThrowable传入，
// 这样在排查问题时可以通过获取根异常信息更全面地了解导致操作失败的原因。
public ActionFailureException(String paramString, Throwable paramThrowable) {
super(paramString, paramThrowable);
}
}

376
BackupUtils.java
Unescape View File

@ -1,376 +0,0 @@
/*
* 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.tool;
// 导入必要的Android和Java类
import android.content.Context;
import android.database.Cursor; // 用于数据库查询的游标
import android.os.Environment; // 提供访问环境信息的类
import android.text.TextUtils; // 提供文本工具类
import android.text.format.DateFormat; // 提供日期和时间格式化的工具类
import android.util.Log; // 提供日志打印工具类
import net.micode.notes.R; // 导入应用的资源类
import net.micode.notes.data.Notes; // 导入Notes数据访问类
import net.micode.notes.data.Notes.DataColumns; // 导入Notes数据表的列定义
import net.micode.notes.data.Notes.DataConstants; // 导入Notes数据表的常量定义
import net.micode.notes.data.Notes.NoteColumns; // 导入Notes数据表的列定义
import java.io.File; // 提供文件和目录路径名的抽象表示形式
import java.io.FileNotFoundException; // 当试图打开文件失败时抛出的异常
import java.io.FileOutputStream; // 文件输出流，用于将数据写入文件
import java.io.IOException; // 当发生某种I/O异常时抛出的异常
import java.io.PrintStream; // 打印流，提供便利的打印方法
// 声明一个用于备份的工具类
public class BackupUtils {
// 定义日志标签
private static final String TAG = "BackupUtils";
// 单例模式相关变量
private static BackupUtils sInstance;
// 获取BackupUtils实例的静态方法，使用同步关键字确保线程安全
public static synchronized BackupUtils getInstance(Context context) {
if (sInstance == null) {
sInstance = new BackupUtils(context);
}
return sInstance;
}
// 定义表示备份或恢复状态的常量
public static final int STATE_SD_CARD_UNMOUONTED = 0; // SD卡未挂载
public static final int STATE_BACKUP_FILE_NOT_EXIST = 1; // 备份文件不存在
public static final int STATE_DATA_DESTROIED = 2; // 数据格式不正确，可能被其他程序修改
public static final int STATE_SYSTEM_ERROR = 3; // 系统错误导致备份或恢复失败
public static final int STATE_SUCCESS = 4; // 备份或恢复成功
// TextExport成员变量，用于文本导出
private TextExport mTextExport;
// 私有构造函数，用于单例模式
private BackupUtils(Context context) {
mTextExport = new TextExport(context);
}
// 检查外部存储是否可用的方法
private static boolean externalStorageAvailable() {
return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
}
// 导出数据到文本文件的方法
public int exportToText() {
return mTextExport.exportToText();
}
// 获取导出的文本文件名的方法
public String getExportedTextFileName() {
return mTextExport.mFileName;
}
// 获取导出的文本文件目录的方法
public String getExportedTextFileDir() {
return mTextExport.mFileDirectory;
}
// 定义一个内部类TextExport，用于处理文本导出逻辑
private static class TextExport {
// 定义查询笔记所需的列
private static final String[] NOTE_PROJECTION = {
NoteColumns.ID,
NoteColumns.MODIFIED_DATE,
NoteColumns.SNIPPET,
NoteColumns.TYPE
};
// 定义列索引
private static final int NOTE_COLUMN_ID = 0;
private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
private static final int NOTE_COLUMN_SNIPPET = 2;
// 定义查询笔记数据所需的列
private static final String[] DATA_PROJECTION = {
DataColumns.CONTENT,
DataColumns.MIME_TYPE,
DataColumns.DATA1,
DataColumns.DATA2,
DataColumns.DATA3,
DataColumns.DATA4,
};
// 定义列索引
private static final int DATA_COLUMN_CONTENT = 0;
private static final int DATA_COLUMN_MIME_TYPE = 1;
// 注意：DATA_COLUMN_CALL_DATE是错误的索引，应该是DATA_COLUMN_DATA1或其他
private static final int DATA_COLUMN_CALL_DATE = 2;
private static final int DATA_COLUMN_PHONE_NUMBER = 4; // 假设这里是为了示例，实际可能不对应电话号码
// 定义文本格式数组索引
private final String [] TEXT_FORMAT;
private static final int FORMAT_FOLDER_NAME = 0;
private static final int FORMAT_NOTE_DATE = 1;
private static final int FORMAT_NOTE_CONTENT = 2;
// 上下文、文件名和文件目录成员变量
private Context mContext;
private String mFileName;
private String mFileDirectory;
// 构造函数
public TextExport(Context context) {
// 从资源文件中获取文本格式数组
TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
mContext = context;
mFileName = "";
mFileDirectory = "";
}
// 根据索引获取文本格式的方法
private String getFormat(int id) {
return TEXT_FORMAT[id];
}
// 导出指定文件夹的笔记到文本的方法
private void exportFolderToText(String folderId, PrintStream ps) {
// 查询属于该文件夹的笔记
Cursor notesCursor = mContext.getContentResolver().query(Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION, NoteColumns.PARENT_ID + "=?", new String[] { folderId }, null);
if (notesCursor != null) {
if (notesCursor.moveToFirst()) {
do {
// 打印笔记的最后修改日期
ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// 查询属于该笔记的数据
String noteId = notesCursor.getString(NOTE_COLUMN_ID);
// 调用另一个方法导出笔记内容到文本，但该方法在提供的代码中被截断
// exportNoteToText(noteId, ps);
} while (notesCursor.moveToNext());
}
notesCursor.close();
}
}
// ... 省略了exportNoteToText方法的实现，该方法应该负责将指定笔记的内容导出到文本
}
}
//定义一个方法，用于将笔记内容导出为文本格式
private void exportNoteToText(String noteId, PrintStream ps) {
// 使用内容解析器查询特定笔记ID的笔记数据
Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] { noteId }, null);
// 检查游标是否非空
if (dataCursor != null) {
// 移动游标到第一行数据
if (dataCursor.moveToFirst()) {
// 遍历游标中的所有数据
do {
// 获取笔记的MIME类型
String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
// 如果是电话笔记
if (DataConstants.CALL_NOTE.equals(mimeType)) {
// 打印电话号码
String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
String location = dataCursor.getString(DATA_COLUMN_CONTENT);
// 如果电话号码非空，则打印电话号码
if (!TextUtils.isEmpty(phoneNumber)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), phoneNumber));
}
// 打印通话日期
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), DateFormat
.format(mContext.getString(R.string.format_datetime_mdhm), callDate)));
// 如果位置信息非空，则打印位置信息
if (!TextUtils.isEmpty(location)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), location));
}
} else if (DataConstants.NOTE.equals(mimeType)) { // 如果是普通笔记
String content = dataCursor.getString(DATA_COLUMN_CONTENT);
// 如果笔记内容非空，则打印笔记内容
if (!TextUtils.isEmpty(content)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), content));
}
}
} while (dataCursor.moveToNext());
}
// 关闭游标
dataCursor.close();
}
// 在笔记之间打印一个分隔符
try {
ps.write(new byte[] { Character.LINE_SEPARATOR, Character.LETTER_NUMBER });
} catch (IOException e) {
Log.e(TAG, e.toString());
}
}
//定义一个方法，用于将整个笔记系统导出为文本格式
public int exportToText() {
// 检查外部存储是否可用
if (!externalStorageAvailable()) {
Log.d(TAG, "Media was not mounted");
return STATE_SD_CARD_UNMOUONTED;
}
// 获取指向导出文件的打印流
PrintStream ps = getExportToTextPrintStream();
if (ps == null) {
Log.e(TAG, "get print stream error");
return STATE_SYSTEM_ERROR;
}
// 首先导出文件夹及其笔记
Cursor folderCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
"(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+ NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
+ NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);
// 检查文件夹游标是否非空
if (folderCursor != null) {
if (folderCursor.moveToFirst()) {
do {
// 打印文件夹名称
String folderName = "";
if (folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
folderName = mContext.getString(R.string.call_record_folder_name);
} else {
folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET);
}
if (!TextUtils.isEmpty(folderName)) {
ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
}
String folderId = folderCursor.getString(NOTE_COLUMN_ID);
// 导出文件夹下的笔记
exportFolderToText(folderId, ps);
} while (folderCursor.moveToNext());
}
folderCursor.close();
}
// 导出根文件夹下的笔记
Cursor noteCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
NoteColumns.TYPE + "=" + +Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID
+ "=0", null, null);
// 检查笔记游标是否非空
if (noteCursor != null) {
if (noteCursor.moveToFirst()) {
do {
// 打印笔记的修改日期
ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// 查询并导出该笔记的内容
String noteId = noteCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (noteCursor.moveToNext());
}
noteCursor.close();
}
ps.close();
return STATE_SUCCESS;
}
/**
* 获取一个指向导出文本文件的打印流。
* 注意：此方法的实现未在代码中给出，但基于上下文，该方法应该负责创建或打开一个文件，
* 并返回一个可以向该文件写入数据的PrintStream对象。
*/
//定义一个私有方法，用于获取一个指向导出文本文件的PrintStream对象
private PrintStream getExportToTextPrintStream() {
// 调用generateFileMountedOnSDcard方法生成文件，该方法需要上下文、文件路径资源ID和文件名格式资源ID
File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
R.string.file_name_txt_format);
// 如果文件创建失败（即file为null）
if (file == null) {
// 打印错误日志
Log.e(TAG, "create file to exported failed");
// 返回null，表示无法获取PrintStream
return null;
}
// 保存文件名
mFileName = file.getName();
// 保存文件目录路径
mFileDirectory = mContext.getString(R.string.file_path);
PrintStream ps = null;
try {
// 创建一个指向文件的FileOutputStream
FileOutputStream fos = new FileOutputStream(file);
// 使用FileOutputStream创建一个PrintStream对象
ps = new PrintStream(fos);
} catch (FileNotFoundException e) {
// 如果文件未找到，打印堆栈跟踪并返回null
e.printStackTrace();
return null;
} catch (NullPointerException e) {
// 如果发生空指针异常，打印堆栈跟踪并返回null
e.printStackTrace();
return null;
}
// 返回创建的PrintStream对象
return ps;
}
/**
* 生成一个位于SD卡上的文本文件，用于存储导入的数据
*/
private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
// 创建一个StringBuilder对象用于拼接文件路径
StringBuilder sb = new StringBuilder();
// 追加SD卡根目录路径
sb.append(Environment.getExternalStorageDirectory());
// 追加从资源文件中获取的文件路径
sb.append(context.getString(filePathResId));
// 创建文件目录的File对象
File filedir = new File(sb.toString());
// 追加从资源文件中获取的文件名格式，并格式化当前日期作为文件名的一部分
sb.append(context.getString(
fileNameFormatResId,
DateFormat.format(context.getString(R.string.format_date_ymd),
System.currentTimeMillis())));
// 创建文件的File对象
File file = new File(sb.toString());
try {
// 如果文件目录不存在，则创建它
if (!filedir.exists()) {
filedir.mkdir();
}
// 如果文件不存在，则创建它
if (!file.exists()) {
file.createNewFile();
}
// 返回创建的文件对象
return file;
} catch (SecurityException e) {
// 如果发生安全异常（如没有SD卡写入权限），打印堆栈跟踪
e.printStackTrace();
} catch (IOException e) {
// 如果发生IO异常，打印堆栈跟踪
e.printStackTrace();
}
// 如果发生异常，返回null
return null;
}

92
Contact1.java
Unescape View File

@ -1,92 +0,0 @@
/*
* 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.data;
import android.content.Context;
import android.database.Cursor;
import // 引入安卓联系人契约中关于电话号码相关的数据类型，用于后续查询等操作
android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.Data;
import android.telephony.PhoneNumberUtils;
import android.util.Log;
import java.util.HashMap;
// Contact类，主要用于根据电话号码获取对应的联系人姓名相关操作
public class Contact {
// 用于缓存联系人信息的哈希表，以电话号码为键，联系人姓名为值，目的是避免重复查询数据库获取相同联系人信息
private static HashMap<String, String> sContactCache;
// 用于日志记录的标签，方便在Logcat中识别该类输出的日志信息
private static final String TAG = "Contact";
// 构建查询联系人的条件语句字符串，用于在联系人数据库中筛选出符合条件的记录
// 这个条件语句主要是根据电话号码匹配联系人，并且限定了数据类型等条件
private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
+ ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+ " AND " + Data.RAW_CONTACT_ID + " IN "
+ "(SELECT raw_contact_id "
+ " FROM phone_lookup"
+ " WHERE min_match = '+')";
// 根据给定的上下文（通常是Activity等组件的上下文环境）和电话号码获取对应的联系人姓名
public static String getContact(Context context, String phoneNumber) {
// 如果联系人缓存为空，则创建一个新的HashMap用于缓存联系人信息
if (sContactCache == null) {
sContactCache = new HashMap<String, String>();
}
// 先检查缓存中是否已经存在该电话号码对应的联系人姓名，如果有则直接返回缓存中的姓名，避免重复查询数据库
if (sContactCache.containsKey(phoneNumber)) {
return sContactCache.get(phoneNumber);
}
// 根据传入的电话号码替换查询条件语句中的占位符（这里的'+'），将电话号码转换为适合查询的格式
String selection = CALLER_ID_SELECTION.replace("+",
PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
// 通过上下文的内容解析器（ContentResolver）发起一个数据库查询操作
// 查询的是联系人数据的通用URI，指定要获取的列（这里只获取联系人的显示姓名），传入构建好的查询条件以及对应的参数（电话号码），最后一个参数null表示按默认顺序排序
Cursor cursor = context.getContentResolver().query(
Data.CONTENT_URI,
new String[]{Phone.DISPLAY_NAME},
selection,
new String[]{phoneNumber},
null);
// 如果查询结果游标不为空且游标能移动到第一条记录（表示查询到了符合条件的数据）
if (cursor!= null && cursor.moveToFirst()) {
try {
// 从游标中获取第一列的数据，也就是联系人的姓名（因为前面查询只指定了获取显示姓名这一列）
String name = cursor.getString(0);
// 将获取到的联系人姓名存入缓存中，方便下次查询相同电话号码时直接使用
sContactCache.put(phoneNumber, name);
return name;
} catch (IndexOutOfBoundsException e) {
// 如果在获取游标数据时发生越界异常，记录错误日志并返回null
Log.e(TAG, " Cursor get string error " + e.toString());
return null;
} finally {
// 无论是否发生异常，都要关闭游标，释放相关资源
cursor.close();
}
} else {
// 如果没有查询到匹配的联系人，记录一条调试日志，并返回null
Log.d(TAG, "No contact matched with number:" + phoneNumber);
return null;
}
}
}

0
D:\taste1
Unescape View File

380
DataUtils.java
Unescape View File

@ -1,380 +0,0 @@
/*
* 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.tool;
// 导入所需的Android和内容提供者操作的类
import android.content.ContentProviderOperation;
import android.content.ContentProviderResult;
import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.OperationApplicationException;
import android.database.Cursor;
import android.os.RemoteException;
import android.util.Log;
// 导入Notes应用中的相关类
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.CallNote;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
// 导入Java工具类
import java.util.ArrayList;
import java.util.HashSet;
// 声明DataUtils工具类
public class DataUtils {
// 定义日志标签
public static final String TAG = "DataUtils";
/**
* 批量删除笔记
* @param resolver 内容解析器
* @param ids 要删除的笔记ID集合
* @return 操作是否成功
*/
public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
// 检查ID集合是否为空
if (ids == null) {
Log.d(TAG, "the ids is null");
return true; // 如果为空，则认为操作成功（可能是一个设计选择，但通常应返回false或抛出异常）
}
// 检查ID集合是否不包含任何元素
if (ids.size() == 0) {
Log.d(TAG, "no id is in the hashset");
return true; // 同上，通常应返回false
}
// 创建操作列表
ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
// 遍历ID集合
for (long id : ids) {
// 检查是否为系统根文件夹ID，不应删除
if(id == Notes.ID_ROOT_FOLDER) {
Log.e(TAG, "Don't delete system folder root");
continue; // 跳过系统根文件夹
}
// 创建删除操作并添加到操作列表
ContentProviderOperation.Builder builder = ContentProviderOperation
.newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
operationList.add(builder.build());
}
try {
// 批量执行操作
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
// 检查操作结果
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
return false; // 如果操作失败，则返回false
}
return true; // 操作成功
} catch (RemoteException e) {
// 捕获远程异常并记录
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
} catch (OperationApplicationException e) {
// 捕获操作应用异常并记录
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
}
return false; // 如果发生异常，则返回false
}
/**
* 将笔记移动到指定文件夹
* @param resolver 内容解析器
* @param id 笔记ID
* @param srcFolderId 源文件夹ID
* @param desFolderId 目标文件夹ID
*/
public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
// 创建要更新的内容值
ContentValues values = new ContentValues();
values.put(NoteColumns.PARENT_ID, desFolderId); // 设置目标文件夹ID
values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId); // 设置源文件夹ID（可能用于记录或恢复）
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记笔记为已修改
// 执行更新操作
resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
}
/**
* 批量将笔记移动到指定文件夹
* @param resolver 内容解析器
* @param ids 要移动的笔记ID集合
* @param folderId 目标文件夹ID
* @return 操作是否成功
*/
public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
long folderId) {
// 检查ID集合是否为空
if (ids == null) {
Log.d(TAG, "the ids is null");
return true; // 同上，通常应返回false
}
// 创建操作列表
ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
// 遍历ID集合
for (long id : ids) {
// 创建更新操作并添加到操作列表
ContentProviderOperation.Builder builder = ContentProviderOperation
.newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
builder.withValue(NoteColumns.PARENT_ID, folderId); // 设置目标文件夹ID
builder.withValue(NoteColumns.LOCAL_MODIFIED, 1); // 标记笔记为已修改
operationList.add(builder.build());
}
try {
// 批量执行操作
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
// 检查操作结果
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "move notes failed, ids:" + ids.toString());
return false; // 如果操作失败，则返回false
}
return true; // 操作成功
} catch (RemoteException e) {
// 捕获远程异常并记录
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
} catch (OperationApplicationException e) {
// 捕获操作应用异常并记录
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
}
return false; // 如果发生异常，则返回false
}
/**
* 获取用户文件夹数量（排除系统文件夹）
* @param resolver 内容解析器
* @return 用户文件夹数量
*/
public static int getUserFolderCount(ContentResolver resolver) {
// 执行查询操作，获取用户文件夹数量
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { "COUNT(*)" }, // 选择要返回的列（这里是计数）
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?", // 查询条件：类型为文件夹且不是垃圾箱文件夹
new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)}, // 查询参数
null); // 排序（此处不需要）
int count = 0;
if(cursor != null) {
if(cursor.moveToFirst()) {
try {
count = cursor.getInt(0); // 获取计数结果
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "get folder count failed:" + e.toString()); // 如果发生索引越界异常，则记录错误
} finally {
cursor.close(); // 关闭游标
}
}
}
return count; // 返回用户文件夹数量
}
}
//判断指定类型的笔记是否在笔记数据库中可见（不在回收站中）
public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
// 使用ContentResolver查询指定ID的笔记，过滤条件为类型匹配且父ID不等于回收站ID
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
null,
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
new String [] {String.valueOf(type)},
null);
boolean exist = false;
if (cursor != null) {
// 如果查询结果不为空，表示笔记存在
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close(); // 关闭Cursor
}
return exist; // 返回笔记是否存在的布尔值
}
//判断指定ID的笔记是否存在于笔记数据库中
public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
// 使用ContentResolver查询指定ID的笔记，没有过滤条件
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
null, null, null, null);
boolean exist = false;
if (cursor != null) {
// 如果查询结果不为空，表示笔记存在
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close(); // 关闭Cursor
}
return exist; // 返回笔记是否存在的布尔值
}
//判断指定ID的数据项是否存在于数据数据库中
public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
// 使用ContentResolver查询指定ID的数据项，没有过滤条件
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
null, null, null, null);
boolean exist = false;
if (cursor != null) {
// 如果查询结果不为空，表示数据项存在
if (cursor.getCount() > 0) {
exist = true;
}
cursor.close(); // 关闭Cursor
}
return exist; // 返回数据项是否存在的布尔值
}
//判断指定名称的文件夹是否存在于笔记数据库中且不在回收站中
public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
// 使用ContentResolver查询文件夹，过滤条件为类型为文件夹且父ID不等于回收站ID且摘要（名称）匹配
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
" AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
" AND " + NoteColumns.SNIPPET + "=?",
new String[] { name }, null);
boolean exist = false;
if(cursor != null) {
// 如果查询结果不为空，表示文件夹存在
if(cursor.getCount() > 0) {
exist = true;
}
cursor.close(); // 关闭Cursor
}
return exist; // 返回文件夹是否存在的布尔值
}
//获取指定文件夹ID下的所有笔记小部件属性
public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
// 使用ContentResolver查询指定文件夹ID下的笔记小部件信息
Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE },
NoteColumns.PARENT_ID + "=?",
new String[] { String.valueOf(folderId) },
null);
HashSet<AppWidgetAttribute> set = null;
if (c != null) {
if (c.moveToFirst()) { // 移动到Cursor的第一行
set = new HashSet<AppWidgetAttribute>(); // 初始化HashSet
do {
try {
AppWidgetAttribute widget = new AppWidgetAttribute(); // 创建小部件属性对象
widget.widgetId = c.getInt(0); // 获取小部件ID
widget.widgetType = c.getInt(1); // 获取小部件类型
set.add(widget); // 将小部件属性添加到HashSet中
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, e.toString()); // 捕获并打印索引越界异常
}
} while (c.moveToNext()); // 移动到Cursor的下一行
}
c.close(); // 关闭Cursor
}
return set; // 返回包含所有笔记小部件属性的HashSet
}
//根据笔记ID获取关联的电话号码
public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
// 使用ContentResolver查询指定笔记ID下的电话号码数据
Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
new String [] { CallNote.PHONE_NUMBER },
CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
null);
if (cursor != null && cursor.moveToFirst()) { // 如果Cursor不为空且移动到第一行
try {
return cursor.getString(0); // 返回电话号码
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call number fails " + e.toString()); // 捕获并打印索引越界异常
} finally {
cursor.close(); // 关闭Cursor
}
}
return ""; // 如果没有找到电话号码，返回空字符串
}
//根据电话号码和通话日期获取笔记ID
public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
// 使用ContentResolver查询指定电话号码和通话日期下的笔记ID
Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
new String [] { CallNote.NOTE_ID },
CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+ CallNote.PHONE_NUMBER + ",?)",
new String [] { String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber },
null);
if (cursor != null) {
if (cursor.moveToFirst()) { // 如果Cursor不为空且移动到第一行
try {
return cursor.getLong(0); // 返回笔记ID
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call note id fails " + e.toString()); // 捕获并打印索引越界异常
}
}
cursor.close(); // 关闭Cursor
}
return 0; // 如果没有找到笔记ID，返回0
}
//定义一个静态方法，用于通过笔记ID从内容提供者中获取笔记摘要
public static String getSnippetById(ContentResolver resolver, long noteId) {
// 使用ContentResolver查询特定URI下的数据
// Notes.CONTENT_NOTE_URI 是笔记内容的URI
// 查询的列只有 NoteColumns.SNIPPET，即笔记摘要
// 查询条件是 NoteColumns.ID 等于传入的 noteId
// 最后一个参数为null，表示不需要对结果进行排序
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String [] { NoteColumns.SNIPPET },
NoteColumns.ID + "=?",
new String [] { String.valueOf(noteId)},
null);
// 检查返回的Cursor是否不为null
if (cursor != null) {
String snippet = ""; // 初始化摘要字符串为空
// 如果Cursor移动到第一行（即存在查询结果）
if (cursor.moveToFirst()) {
// 从Cursor中获取第一列的数据（即SNIPPET列），并赋值给snippet变量
snippet = cursor.getString(0);
}
// 关闭Cursor以释放资源
cursor.close();
// 返回查询到的摘要字符串
return snippet;
}
// 如果Cursor为null，则抛出异常，表示未找到指定ID的笔记
throw new IllegalArgumentException("Note is not found with id: " + noteId);
}
//定义一个静态方法，用于格式化笔记摘要字符串
public static String getFormattedSnippet(String snippet) {
// 如果传入的摘要字符串不为null
if (snippet != null) {
// 去除字符串两端的空白字符
snippet = snippet.trim();
// 查找字符串中第一次出现换行符的位置
int index = snippet.indexOf('\n');
// 如果找到了换行符
if (index != -1) {
// 将字符串截取到换行符之前的位置，即只保留第一行
snippet = snippet.substring(0, index);
}
}
// 返回格式化后的摘要字符串
return snippet;
}

134
GTaskASyncTask.java
Unescape View File

@ -1,134 +0,0 @@
/*
* 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;
// 导入所需的Android类和接口
import android.app.Notification; // 通知类
import android.app.NotificationManager; // 通知管理类
import android.app.PendingIntent; // 意图的延迟执行类
import android.content.Context; // 上下文类
import android.content.Intent; // 意图类
import android.os.AsyncTask; // 异步任务类
// 导入项目内部的其他类
import net.micode.notes.R; // 资源类
import net.micode.notes.ui.NotesListActivity; // 笔记列表活动
import net.micode.notes.ui.NotesPreferenceActivity; // 笔记偏好设置活动
// 定义一个继承自AsyncTask的类，用于执行后台任务
public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
// 定义通知ID
private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
// 定义一个接口，用于任务完成时的回调
public interface OnCompleteListener {
void onComplete();
}
// 声明成员变量
private Context mContext; // 上下文
private NotificationManager mNotifiManager; // 通知管理器
private GTaskManager mTaskManager; // 任务管理器
private OnCompleteListener mOnCompleteListener; // 任务完成监听器
// 构造函数，初始化成员变量
public GTaskASyncTask(Context context, OnCompleteListener listener) {
mContext = context;
mOnCompleteListener = listener;
mNotifiManager = (NotificationManager) mContext
.getSystemService(Context.NOTIFICATION_SERVICE);// 获取通知服务
mTaskManager = GTaskManager.getInstance();// 获取任务管理器实例
}
// 取消同步的方法
public void cancelSync() {
mTaskManager.cancelSync();
}
// 发布进度的方法，注意这里重写了publishProgress方法
public void publishProgess(String message) {
publishProgress(new String[] {
message
});
}
// 显示通知的方法
private void showNotification(int tickerId, String content) {
// 创建通知
Notification notification = new Notification(R.drawable.notification, mContext
.getString(tickerId), System.currentTimeMillis());
notification.defaults = Notification.DEFAULT_LIGHTS; // 设置默认灯光
notification.flags = Notification.FLAG_AUTO_CANCEL;// 设置自动取消
PendingIntent pendingIntent;// 延迟意图
// 根据tickerId判断点击通知后的跳转页面
if (tickerId != R.string.ticker_success) {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesPreferenceActivity.class), 0);
} else {
pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
NotesListActivity.class), 0);
}
// 设置通知的详细信息
notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content,
pendingIntent);
// 发送通知
mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
}
// 在后台线程中执行的任务
@Override
protected Integer doInBackground(Void... unused) {
// 发布登录进度的通知
publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity
.getSyncAccountName(mContext)));
// 执行同步任务，并返回结果
return mTaskManager.sync(mContext, this);
}
// 更新进度的方法
@Override
protected void onProgressUpdate(String... progress) {
// 显示同步中的通知
showNotification(R.string.ticker_syncing, progress[0]);
// 如果上下文是GTaskSyncService的实例，则发送广播
if (mContext instanceof GTaskSyncService) {
((GTaskSyncService) mContext).sendBroadcast(progress[0]);
}
}
// 任务执行完成后的方法
@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()));
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));
}
// 如果设置了任务完成监听器，则在新线程中调用其onComplete方法
if (mOnCompleteListener != null) {
new Thread(new Runnable() {
public void run() {
mOnCompleteListener.onComplete();
}
}).start();
}
}
}

665
GTaskClient.java
Unescape View File

@ -1,665 +0,0 @@
// 声明包名，这是Java项目中的一个约定，用于组织类
package net.micode.notes.gtask.remote;
// 导入所需的Android和其他Java库
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; // 设置界面的Activity
// 导入Apache HttpClient库中的类，用于发送HTTP请求
import org.apache.http.HttpEntity; // 表示HTTP消息的实体部分
import org.apache.http.HttpResponse; // 表示HTTP响应
import org.apache.http.client.ClientProtocolException; // 表示HTTP协议错误的异常
import org.apache.http.client.entity.UrlEncodedFormEntity; // 表示表单数据的实体
import org.apache.http.client.methods.HttpGet; // 表示HTTP GET请求的类
import org.apache.http.client.methods.HttpPost; // 表示HTTP POST请求的类
import org.apache.http.cookie.Cookie; // 表示HTTP cookie的类
import org.apache.http.impl.client.BasicCookieStore; // 用于存储HTTP cookies的类
import org.apache.http.impl.client.DefaultHttpClient; // 默认的HTTP客户端实现
import org.apache.http.message.BasicNameValuePair; // 表示表单中名称-值对的类
// 导入HTTP参数设置相关的类
import org.apache.http.params.BasicHttpParams; // 表示HTTP参数的类
import org.apache.http.params.HttpConnectionParams; // 用于设置HTTP连接参数的类
import org.apache.http.params.HttpParams; // HTTP参数的接口
import org.apache.http.params.HttpProtocolParams; // 用于设置HTTP协议参数的类
// 导入JSON处理相关的类
import org.json.JSONArray; // 表示JSON数组的类
import org.json.JSONException; // 表示JSON格式错误的异常
import org.json.JSONObject; // 表示JSON对象的类
// 导入Java标准库中的类
import java.io.BufferedReader; // 用于读取文本（字符）输入流并缓冲字符，以便提供字符、数组和行的高效读取
import java.io.IOException; // 表示I/O操作失败的异常
import java.io.InputStream; // 表示字节输入流的抽象类
import java.io.InputStreamReader; // 是桥接字节流和字符流的输入流
import java.util.LinkedList; // 实现了List接口的双向链表
import java.util.List; // List接口，是Collection接口的子接口
import java.util.zip.GZIPInputStream; // 用于读取GZIP格式压缩文件的输入流
import java.util.zip.Inflater; // 用于解压缩数据流的类
import java.util.zip.InflaterInputStream; // 使用Inflater解压缩输入流的类
// 声明GTaskClient类，这是一个用于与Google Tasks API交互的客户端类
public class GTaskClient {
// 定义日志标签，用于日志输出
private static final String TAG = GTaskClient.class.getSimpleName();
// 定义Google Tasks的URL
private static final String GTASK_URL = "https://mail.google.com/tasks/";
// 定义用于获取Google Tasks数据的URL
private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig";
// 定义用于向Google Tasks发送数据的URL
private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig";
// 定义单例模式的实例变量
private static GTaskClient mInstance = null;
// 定义HTTP客户端变量
private DefaultHttpClient mHttpClient;
// 定义GET请求的URL
private String mGetUrl;
// 定义POST请求的URL
private String mPostUrl;
// 定义客户端版本变量
private long mClientVersion;
// 定义登录状态变量
private boolean mLoggedin;
// 定义最后登录时间变量
private long mLastLoginTime;
// 定义操作ID变量
private int mActionId;
// 定义帐户变量
private Account mAccount;
// 定义更新数据的JSON数组变量
private JSONArray mUpdateArray;
// 私有构造函数，用于实现单例模式
private GTaskClient() {
// 初始化变量
mHttpClient = null;
mGetUrl = GTASK_GET_URL;
mPostUrl = GTASK_POST_URL;
mClientVersion = -1;
mLoggedin = false;
mLastLoginTime = 0;
mActionId = 1;
mAccount = null;
mUpdateArray = null;
}
// 提供获取GTaskClient实例的静态方法，实现单例模式
public static synchronized GTaskClient getInstance() {
if (mInstance == null) {
mInstance = new GTaskClient();
}
return mInstance;
}
public boolean login(Activity activity) {
// 假设cookie在5分钟后过期，然后需要重新登录
final long interval = 1000 * 60 * 5;
// 如果上次登录时间加上间隔时间小于当前系统时间，则标记为未登录
if (mLastLoginTime + interval < System.currentTimeMillis()) {
mLoggedin = false;
}
// 如果已经登录，但同步账户名称与设置中的账户名称不一致，则标记为未登录
if (mLoggedin
&& !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity
.getSyncAccountName(activity))) {
mLoggedin = false;
}
// 如果已经登录，则记录日志并返回true
if (mLoggedin) {
Log.d(TAG, "already logged in");
return true;
}
// 更新上次登录时间为当前系统时间
mLastLoginTime = System.currentTimeMillis();
// 尝试登录Google账户
String authToken = loginGoogleAccount(activity, false);
// 如果获取到的authToken为空，则记录错误日志并返回false
if (authToken == null) {
Log.e(TAG, "login google account failed");
return false;
}
// 如果账户不是gmail.com或googlemail.com，则使用自定义域名登录
if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase()
.endsWith("googlemail.com"))) {
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";
mPostUrl = url.toString() + "r/ig";
// 尝试使用自定义域名登录Google Tasks
if (tryToLoginGtask(activity, authToken)) {
mLoggedin = true;
}
}
// 如果还未登录，则尝试使用Google官方URL登录
if (!mLoggedin) {
mGetUrl = GTASK_GET_URL;
mPostUrl = GTASK_POST_URL;
// 如果登录失败，则返回false
if (!tryToLoginGtask(activity, authToken)) {
return false;
}
}
// 标记为已登录并返回true
mLoggedin = true;
return true;
}
private String loginGoogleAccount(Activity activity, boolean invalidateToken) {
String authToken;
// 获取AccountManager实例
AccountManager accountManager = AccountManager.get(activity);
// 获取所有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;
}
}
// 如果找到了匹配的账户，则更新mAccount
if (account != null) {
mAccount = account;
} else {
// 如果未找到匹配的账户，则记录错误日志并返回null
Log.e(TAG, "unable to get an account with the same name in the settings");
return null;
}
// 获取账户的认证令牌
AccountManagerFuture<Bundle> accountManagerFuture = accountManager.getAuthToken(account,
"goanna_mobile", null, activity, null, null);
try {
// 获取认证令牌的结果
Bundle authTokenBundle = accountManagerFuture.getResult();
authToken = authTokenBundle.getString(AccountManager.KEY_AUTHTOKEN);
// 如果需要使令牌失效，则使当前令牌失效并重新登录
if (invalidateToken) {
accountManager.invalidateAuthToken("com.google", authToken);
loginGoogleAccount(activity, false);
}
} catch (Exception e) {
// 如果获取令牌失败，则记录错误日志并将authToken设为null
Log.e(TAG, "get auth token failed");
authToken = null;
}
// 返回认证令牌
return authToken;
}
// 尝试使用提供的authToken登录Google Tasks，如果失败则尝试重新登录Google账户并再次尝试
private boolean tryToLoginGtask(Activity activity, String authToken) {
// 首先尝试使用提供的authToken登录Google Tasks
if (!loginGtask(authToken)) {
// 如果登录失败，可能是因为authToken已过期，现在我们尝试使登录Google账户来无效化旧令牌并获取新令牌
authToken = loginGoogleAccount(activity, true); // 尝试重新登录Google账户，true可能表示强制刷新令牌
if (authToken == null) {
// 如果重新登录失败，记录错误日志
Log.e(TAG, "login google account failed");
return false; // 返回登录失败
}
// 使用新获取的authToken再次尝试登录Google Tasks
if (!loginGtask(authToken)) {
// 如果仍然登录失败，记录错误日志
Log.e(TAG, "login gtask failed");
return false; // 返回登录失败
}
}
// 如果任何一次登录成功，返回登录成功
return true;
}
// 使用提供的authToken登录Google Tasks
private boolean loginGtask(String authToken) {
// 设置HTTP连接和套接字超时时间
int timeoutConnection = 10000; // 连接超时时间10秒
int timeoutSocket = 15000; // 套接字超时时间15秒
HttpParams httpParameters = new BasicHttpParams(); // 创建HTTP参数对象
HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection); // 设置连接超时
HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket); // 设置套接字超时
mHttpClient = new DefaultHttpClient(httpParameters); // 创建HTTP客户端实例
BasicCookieStore localBasicCookieStore = new BasicCookieStore(); // 创建Cookie存储实例
mHttpClient.setCookieStore(localBasicCookieStore); // 设置HTTP客户端的Cookie存储
HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false); // 禁用HTTP/1.1的Expect-Continue机制
// 尝试登录Google Tasks
try {
// 构建登录URL，将authToken作为查询参数附加
String loginUrl = mGetUrl + "?auth=" + authToken;
HttpGet httpGet = new HttpGet(loginUrl); // 创建HTTP GET请求
HttpResponse response = null; // 初始化HTTP响应对象
response = mHttpClient.execute(httpGet); // 执行HTTP GET请求
// 从响应中获取Cookie
List<Cookie> cookies = mHttpClient.getCookieStore().getCookies(); // 获取所有Cookie
boolean hasAuthCookie = false; // 初始化认证Cookie存在标志
for (Cookie cookie : cookies) { // 遍历所有Cookie
if (cookie.getName().contains("GTL")) { // 如果Cookie名称包含"GTL"，则认为是认证Cookie
hasAuthCookie = true; // 设置认证Cookie存在标志为true
}
}
if (!hasAuthCookie) { // 如果没有找到认证Cookie
Log.w(TAG, "it seems that there is no auth cookie"); // 记录警告日志
}
// 从响应中提取客户端版本信息
String resString = getResponseContent(response.getEntity()); // 获取响应内容
String jsBegin = "_setup("; // JavaScript响应开始的标记
String jsEnd = ")}</script>"; // JavaScript响应结束的标记
int begin = resString.indexOf(jsBegin); // 查找JavaScript开始的索引
int end = resString.lastIndexOf(jsEnd); // 查找JavaScript结束的索引
String jsString = null; // 初始化JavaScript字符串
if (begin != -1 && end != -1 && begin < end) { // 如果找到了JavaScript的开始和结束标记
jsString = resString.substring(begin + jsBegin.length(), end); // 提取JavaScript字符串
}
JSONObject js = new JSONObject(jsString); // 将JavaScript字符串转换为JSONObject
mClientVersion = js.getLong("v"); // 从JSONObject中获取客户端版本信息
} catch (JSONException e) { // 如果解析JSON时发生异常
Log.e(TAG, e.toString()); // 记录错误日志
e.printStackTrace(); // 打印异常堆栈信息
return false; // 返回登录失败
} catch (Exception e) { // 如果发生其他异常
// 简单地捕获所有异常
Log.e(TAG, "httpget gtask_url failed"); // 记录错误日志
return false; // 返回登录失败
}
// 如果没有发生异常，返回登录成功
return true;
}
// 生成一个唯一的动作ID，每次调用时ID递增
private int getActionId() {
return mActionId++; // 返回当前ID并递增ID
}
// 创建一个用于发送HTTP POST请求的HttpPost对象
private HttpPost createHttpPost() {
HttpPost httpPost = new HttpPost(mPostUrl); // 创建HttpPost对象，指向mPostUrl
httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8"); // 设置请求头，指定内容类型和字符集
httpPost.setHeader("AT", "1"); // 设置请求头，可能用于认证或其他目的
return httpPost; // 返回HttpPost对象
}
// 定义一个方法，用于从HttpEntity中获取响应内容
private String getResponseContent(HttpEntity entity) throws IOException {
String contentEncoding = null;
// 如果实体有内容编码，则获取该编码
if (entity.getContentEncoding() != null) {
contentEncoding = entity.getContentEncoding().getValue();
Log.d(TAG, "encoding: " + contentEncoding); // 打印编码信息
}
InputStream input = entity.getContent(); // 获取输入流
// 如果内容编码是gzip，则使用GZIPInputStream进行解压
if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) {
input = new GZIPInputStream(entity.getContent());
} else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) {
// 如果内容编码是deflate，则使用InflaterInputStream进行解压
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(); // 用于构建响应内容的字符串
while (true) {
String buff = br.readLine(); // 逐行读取内容
if (buff == null) {
return sb.toString(); // 如果读到空行，说明读取完毕，返回构建好的字符串
}
sb = sb.append(buff); // 将读取到的行追加到字符串构建器中
}
} finally {
input.close(); // 无论是否发生异常，都关闭输入流
}
}
// 定义一个方法，用于发送POST请求
private JSONObject postRequest(JSONObject js) throws NetworkFailureException {
if (!mLoggedin) {
Log.e(TAG, "please login first"); // 如果未登录，则打印错误日志
throw new ActionFailureException("not logged in"); // 抛出未登录异常
}
HttpPost httpPost = createHttpPost(); // 创建HttpPost对象（方法未在代码中给出）
try {
LinkedList<BasicNameValuePair> list = new LinkedList<BasicNameValuePair>(); // 创建键值对列表
list.add(new BasicNameValuePair("r", js.toString())); // 将JSON对象转换为字符串并添加到列表中
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8"); // 创建表单实体
httpPost.setEntity(entity); // 设置HttpPost的实体
// 执行POST请求
HttpResponse response = mHttpClient.execute(httpPost);
String jsString = getResponseContent(response.getEntity()); // 获取响应内容
return new JSONObject(jsString); // 将响应内容转换为JSONObject
} 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"); // 抛出操作失败异常
}
}
// 定义一个方法，用于创建任务
public void createTask(Task task) throws NetworkFailureException {
commitUpdate(); // 提交更新（方法未在代码中给出）
try {
JSONObject jsPost = new JSONObject(); // 创建JSON对象用于POST请求
JSONArray actionList = new JSONArray(); // 创建JSON数组用于存储动作列表
// 向动作列表中添加任务创建动作
actionList.put(task.getCreateAction(getActionId()));
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 将动作列表添加到JSON对象中
// 添加客户端版本信息
jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
// 发送POST请求
JSONObject jsResponse = postRequest(jsPost);
JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
GTaskStringUtils.GTASK_JSON_RESULTS).get(0); // 获取响应中的第一个结果
task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); // 设置任务的GID
} catch (JSONException e) {
Log.e(TAG, e.toString()); // 打印异常信息
e.printStackTrace(); // 打印堆栈跟踪
throw new ActionFailureException("create task: handing jsonobject failed"); // 抛出操作失败异常
}
}
// 创建一个任务列表，并可能抛出网络失败异常
public void createTaskList(TaskList tasklist) throws NetworkFailureException {
commitUpdate(); // 提交之前的更新
try {
JSONObject jsPost = new JSONObject(); // 创建一个JSON对象用于发送请求
JSONArray actionList = new JSONArray(); // 创建一个JSON数组用于存放动作列表
// 将创建任务的动作添加到动作列表中
actionList.put(tasklist.getCreateAction(getActionId()));
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 将动作列表添加到请求JSON中
// 添加客户端版本信息到请求JSON中
jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
// 发送请求并接收响应
JSONObject jsResponse = postRequest(jsPost);
JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
GTaskStringUtils.GTASK_JSON_RESULTS).get(0); // 从响应中提取结果
tasklist.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); // 设置任务列表的ID
} catch (JSONException e) {
Log.e(TAG, e.toString()); // 记录异常
e.printStackTrace(); // 打印异常堆栈
throw new ActionFailureException("create tasklist: handing jsonobject failed"); // 抛出动作失败异常
}
}
// 提交更新到服务器
public void commitUpdate() throws NetworkFailureException {
if (mUpdateArray != null) {
try {
JSONObject jsPost = new JSONObject(); // 创建一个JSON对象用于发送请求
// 将更新动作列表添加到请求JSON中
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray);
// 添加客户端版本信息到请求JSON中
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("commit update: handing jsonobject failed"); // 抛出动作失败异常
}
}
}
// 添加一个更新节点到更新数组中，如果更新数组已满则先提交更新
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())); // 添加更新动作到更新数组
}
}
// 移动一个任务到另一个任务列表或在该任务列表内移动
public void moveTask(Task task, TaskList preParent, TaskList curParent)
throws NetworkFailureException {
commitUpdate(); // 提交之前的更新
try {
JSONObject jsPost = new JSONObject(); // 创建一个JSON对象用于发送请求
JSONArray actionList = new JSONArray(); // 创建一个JSON数组用于存放动作列表
JSONObject action = new JSONObject(); // 创建一个JSON对象用于存放动作信息
// 设置动作类型为移动，并添加其他必要信息到动作JSON中
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());
if (preParent == curParent && task.getPriorSibling() != null) {
// 如果在同一个任务列表中移动且不是第一个任务，则添加前一个兄弟任务的ID
action.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, task.getPriorSibling());
}
action.put(GTaskStringUtils.GTASK_JSON_SOURCE_LIST, preParent.getGid()); // 添加来源任务列表ID
action.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT, curParent.getGid()); // 添加目标父任务列表ID
if (preParent != curParent) {
// 如果跨任务列表移动，则添加目标任务列表ID
action.put(GTaskStringUtils.GTASK_JSON_DEST_LIST, curParent.getGid());
}
actionList.put(action); // 将动作添加到动作列表中
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 将动作列表添加到请求JSON中
// 添加客户端版本信息到请求JSON中
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"); // 抛出动作失败异常
}
}
// 删除一个节点
public void deleteNode(Node node) throws NetworkFailureException {
commitUpdate(); // 提交之前的更新
try {
JSONObject jsPost = new JSONObject(); // 创建一个JSON对象用于发送请求
JSONArray actionList = new JSONArray(); // 创建一个JSON数组用于存放动作列表
// 标记节点为已删除，并将删除动作添加到动作列表中
node.setDeleted(true);
actionList.put(node.getUpdateAction(getActionId()));
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 将动作列表添加到请求JSON中
// 添加客户端版本信息到请求JSON中
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"); // 抛出动作失败异常
}
}
// 定义一个方法，用于获取任务列表，可能会抛出网络失败异常
public JSONArray getTaskLists() throws NetworkFailureException {
// 检查用户是否已登录
if (!mLoggedin) {
// 如果没有登录，记录错误日志
Log.e(TAG, "please login first");
// 抛出一个动作失败异常，提示未登录
throw new ActionFailureException("not logged in");
}
try {
// 创建一个HTTP GET请求
HttpGet httpGet = new HttpGet(mGetUrl);
// 初始化HTTP响应对象为null
HttpResponse response = null;
// 执行HTTP GET请求
response = mHttpClient.execute(httpGet);
// 从响应中获取任务列表的字符串内容
String resString = getResponseContent(response.getEntity());
// 定义JSON字符串的开始和结束标记
String jsBegin = "_setup(";
String jsEnd = ")}</script>";
// 在响应字符串中查找开始和结束标记的位置
int begin = resString.indexOf(jsBegin);
int end = resString.lastIndexOf(jsEnd);
// 初始化JSON字符串为null
String jsString = null;
// 如果找到了开始和结束标记，并且开始位置在结束位置之前
if (begin != -1 && end != -1 && begin < end) {
// 提取JSON字符串
jsString = resString.substring(begin + jsBegin.length(), end);
}
// 将提取的JSON字符串转换为JSONObject
JSONObject js = new JSONObject(jsString);
// 从JSONObject中获取名为"t"的对象，然后从中获取名为GTASK_JSON_LISTS的JSONArray
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) {
// 如果捕获到IO异常，记录错误日志并抛出网络失败异常
Log.e(TAG, e.toString());
e.printStackTrace();
throw new NetworkFailureException("gettasklists: httpget failed");
} catch (JSONException e) {
// 如果捕获到JSON解析异常，记录错误日志并抛出动作失败异常
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("get task lists: handing jasonobject failed");
}
}
// 定义一个方法，用于获取特定任务列表的内容，可能会抛出网络失败异常
public JSONArray getTaskList(String listGid) throws NetworkFailureException {
// 提交更新（可能用于同步或更新状态）
commitUpdate();
try {
// 创建用于POST请求的JSONObject
JSONObject jsPost = new JSONObject();
// 创建一个JSONArray用于存放动作列表
JSONArray actionList = new JSONArray();
// 创建一个JSONObject用于存放单个动作
JSONObject action = new JSONObject();
// 设置动作列表中的动作类型、动作ID、列表ID和是否获取已删除项
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);
action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false);
// 将动作添加到动作列表中
actionList.put(action);
// 将动作列表添加到POST请求的JSONObject中
jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
// 设置客户端版本
jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
// 发送POST请求并获取响应
JSONObject jsResponse = postRequest(jsPost);
// 从响应中获取任务列表的JSONArray
return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS);
} catch (JSONException e) {
// 如果捕获到JSON解析异常，记录错误日志并抛出动作失败异常
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("get task list: handing jsonobject failed");
}
}
// 定义一个方法，用于获取同步账户信息
public Account getSyncAccount() {
// 返回账户信息
return mAccount;
}
// 定义一个方法，用于重置更新数组
public void resetUpdateArray() {
// 将更新数组设置为null
mUpdateArray = null;
}
}

876
GTaskManager.java
Unescape View File

@ -1,876 +0,0 @@
/*
* 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;
// 导入必要的Android和Java类
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;
// 声明GTaskManager类
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;
private Activity mActivity;
private Context mContext;
private ContentResolver mContentResolver;
private boolean mSyncing;
private boolean mCancelled;
private HashMap<String, TaskList> mGTaskListHashMap;
private HashMap<String, Node> mGTaskHashMap;
private HashMap<String, MetaData> mMetaHashMap;
private TaskList mMetaList;
private HashSet<Long> mLocalDeleteIdMap;
private HashMap<String, Long> mGidToNid;
private HashMap<Long, String> mNidToGid;
// 私有构造函数，用于创建单例
private GTaskManager() {
// 初始化成员变量
mSyncing = false;
mCancelled = false;
mGTaskListHashMap = new HashMap<String, TaskList>();
mGTaskHashMap = new HashMap<String, Node>();
mMetaHashMap = new HashMap<String, MetaData>();
mMetaList = null;
mLocalDeleteIdMap = new HashSet<Long>();
mGidToNid = new HashMap<String, Long>();
mNidToGid = new HashMap<Long, String>();
}
// 获取GTaskManager单例实例
public static synchronized GTaskManager getInstance() {
if (mInstance == null) {
mInstance = new GTaskManager();
}
return mInstance;
}
// 设置Activity上下文（用于获取认证令牌）
public synchronized void setActivityContext(Activity activity) {
mActivity = activity;
}
// 执行同步操作
public int sync(Context context, GTaskASyncTask asyncTask) {
// 如果已经在同步，则返回同步进行中状态
if (mSyncing) {
Log.d(TAG, "Sync is in progress");
return STATE_SYNC_IN_PROGRESS;
}
// 初始化成员变量
mContext = context;
mContentResolver = mContext.getContentResolver();
mSyncing = true;
mCancelled = false;
// 清除所有哈希映射和集合
mGTaskListHashMap.clear();
mGTaskHashMap.clear();
mMetaHashMap.clear();
mLocalDeleteIdMap.clear();
mGidToNid.clear();
mNidToGid.clear();
try {
// 获取GTaskClient实例
GTaskClient client = GTaskClient.getInstance();
client.resetUpdateArray();
// 登录Google Tasks
if (!mCancelled) {
if (!client.login(mActivity)) {
throw new NetworkFailureException("login google task failed");
}
}
// 从Google获取任务列表
asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
initGTaskList();
// 执行内容同步
asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
syncContent();
} catch (NetworkFailureException e) {
Log.e(TAG, e.toString());
return STATE_NETWORK_ERROR;
} catch (ActionFailureException e) {
Log.e(TAG, e.toString());
return STATE_INTERNAL_ERROR;
} catch (Exception e) {
Log.e(TAG, e.toString());
e.printStackTrace();
return STATE_INTERNAL_ERROR;
} finally {
// 清除所有哈希映射和集合，重置同步状态
mGTaskListHashMap.clear();
mGTaskHashMap.clear();
mMetaHashMap.clear();
mLocalDeleteIdMap.clear();
mGidToNid.clear();
mNidToGid.clear();
mSyncing = false;
}
// 返回同步结果状态
return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
}
// 定义一个初始化任务列表的方法，该方法可能会抛出网络失败异常
private void initGTaskList() throws NetworkFailureException {
// 如果任务被取消，则直接返回，不执行后续操作
if (mCancelled)
return;
// 获取GTaskClient的实例
GTaskClient client = GTaskClient.getInstance();
try {
// 从客户端获取任务列表的JSON数组
JSONArray jsTaskLists = client.getTaskLists();
// 首先初始化元数据列表
mMetaList = null;
// 遍历所有的任务列表
for (int i = 0; i < jsTaskLists.length(); i++) {
// 获取当前任务列表的JSON对象
JSONObject object = jsTaskLists.getJSONObject(i);
// 获取任务列表的ID
String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
// 获取任务列表的名称
String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
// 如果任务列表名称以特定的前缀开始，并且等于特定的元数据文件夹名称
if (name
.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) {
// 初始化元数据列表
mMetaList = new TaskList();
// 使用JSON对象设置元数据列表的内容
mMetaList.setContentByRemoteJSON(object);
// 加载元数据
JSONArray jsMetas = client.getTaskList(gid);
// 遍历所有的元数据
for (int j = 0; j < jsMetas.length(); j++) {
object = (JSONObject) jsMetas.getJSONObject(j);
MetaData metaData = new MetaData();
// 使用JSON对象设置元数据的内容
metaData.setContentByRemoteJSON(object);
// 如果该元数据值得保存
if (metaData.isWorthSaving()) {
// 将元数据添加到元数据列表中
mMetaList.addChildTask(metaData);
// 如果元数据有GID，则将其添加到哈希映射中
if (metaData.getGid() != null) {
mMetaHashMap.put(metaData.getRelatedGid(), metaData);
}
}
}
}
}
// 如果元数据列表不存在，则创建它
if (mMetaList == null) {
mMetaList = new TaskList();
// 设置元数据列表的名称
mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+ GTaskStringUtils.FOLDER_META);
// 通过客户端创建元数据列表
GTaskClient.getInstance().createTaskList(mMetaList);
}
// 初始化任务列表
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);
// 如果任务列表名称以特定的前缀开始，并且不等于元数据文件夹名称
if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)
&& !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+ GTaskStringUtils.FOLDER_META)) {
TaskList tasklist = new TaskList();
// 使用JSON对象设置任务列表的内容
tasklist.setContentByRemoteJSON(object);
// 将任务列表添加到哈希映射中
mGTaskListHashMap.put(gid, tasklist);
mGTaskHashMap.put(gid, tasklist);
// 加载任务
JSONArray jsTasks = client.getTaskList(gid);
// 遍历所有的任务
for (int j = 0; j < jsTasks.length(); j++) {
object = (JSONObject) jsTasks.getJSONObject(j);
gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
Task task = new Task();
// 使用JSON对象设置任务的内容
task.setContentByRemoteJSON(object);
// 如果该任务值得保存
if (task.isWorthSaving()) {
// 设置任务的元数据
task.setMetaInfo(mMetaHashMap.get(gid));
// 将任务添加到任务列表中
tasklist.addChildTask(task);
// 更新任务在哈希映射中的引用
mGTaskHashMap.put(gid, task);
}
}
}
}
} catch (JSONException e) {
// 捕获JSON异常，记录错误日志
Log.e(TAG, e.toString());
e.printStackTrace();
// 抛出自定义的操作失败异常
throw new ActionFailureException("initGTaskList: handing JSONObject failed");
}
}
// 定义一个名为syncContent的私有方法，该方法可能会抛出NetworkFailureException异常
private void syncContent() throws NetworkFailureException {
// 定义一个变量syncType用于存储同步类型
int syncType;
// 定义一个Cursor对象c，初始化为null，用于查询数据库
Cursor c = null;
// 定义一个字符串变量gid，用于存储Google任务的ID
String gid;
// 定义一个Node对象node，用于表示Google任务节点
Node node;
// 清空本地删除ID的映射表
mLocalDeleteIdMap.clear();
// 如果同步操作被取消，则直接返回
if (mCancelled) {
return;
}
// 处理本地已删除的笔记
try {
// 查询本地数据库中非系统类型且不在回收站的笔记
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()) {
// 获取Google任务的ID
gid = c.getString(SqlNote.GTASK_ID_COLUMN);
// 从HashMap中获取对应的Node对象
node = mGTaskHashMap.get(gid);
if (node != null) {
// 从HashMap中移除该Node对象
mGTaskHashMap.remove(gid);
// 执行远程删除操作
doContentSync(Node.SYNC_ACTION_DEL_REMOTE, node, c);
}
// 将本地笔记ID添加到删除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;
}
}
// 首先同步文件夹
syncFolder();
// 处理数据库中存在的笔记
try {
// 查询本地数据库中类型为笔记且不在回收站的笔记
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()) {
// 获取Google任务的ID
gid = c.getString(SqlNote.GTASK_ID_COLUMN);
// 从HashMap中获取对应的Node对象
node = mGTaskHashMap.get(gid);
if (node != null) {
// 从HashMap中移除该Node对象
mGTaskHashMap.remove(gid);
// 更新gid到nid的映射以及nid到gid的映射
mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
// 获取同步类型
syncType = node.getSyncAction(c);
} else {
// 如果gid为空，表示是本地新增的笔记
if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
syncType = Node.SYNC_ACTION_ADD_REMOTE;
} else {
// 如果gid不为空但不在HashMap中，表示远程已删除
syncType = Node.SYNC_ACTION_DEL_LOCAL;
}
}
// 执行同步操作
doContentSync(syncType, node, c);
}
} else {
// 如果查询失败，记录警告日志
Log.w(TAG, "failed to query existing note in database");
}
} finally {
// 关闭Cursor对象，释放资源
if (c != null) {
c.close();
c = null;
}
}
// 遍历HashMap中剩余的项，执行本地添加操作
Iterator<Map.Entry<String, Node>> iter = mGTaskHashMap.entrySet().iterator();
while (iter.hasNext()) {
Map.Entry<String, Node> entry = iter.next();
node = entry.getValue();
doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
}
// 检查mCancelled标志，确保同步操作未被取消
// 清空本地删除表
if (!mCancelled) {
if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) {
// 如果批量删除失败，抛出ActionFailureException异常
throw new ActionFailureException("failed to batch-delete local deleted notes");
}
}
// 刷新本地同步ID
if (!mCancelled) {
// 提交更新并刷新本地同步ID
GTaskClient.getInstance().commitUpdate();
refreshLocalSyncId();
}
}
// 定义一个私有的同步文件夹方法，该方法可能会抛出网络失败异常
private void syncFolder() throws NetworkFailureException {
Cursor c = null; // 初始化一个游标对象，用于数据库查询
String gid; // 用于存储从数据库查询得到的Google任务ID
Node node; // 用于存储节点对象，代表一个文件夹或任务
int syncType; // 用于存储同步类型
// 如果同步操作被取消，则直接返回
if (mCancelled) {
return;
}
// 同步根文件夹的部分
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); // 获取Google任务ID
node = mGTaskHashMap.get(gid); // 从哈希表中获取节点对象
if (node != null) {
// 如果节点存在，则更新本地和远程的映射关系，并根据需要更新远程名称
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;
}
}
// 同步通话记录文件夹的部分（类似于根文件夹的处理逻辑）
// ...（代码省略，逻辑同上）
// 同步本地已存在的文件夹的部分
try {
// 从内容提供者查询所有非垃圾文件夹的信息
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) {
// 如果节点存在，则更新映射关系，并根据节点的同步动作进行同步
mGTaskHashMap.remove(gid);
mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
syncType = node.getSyncAction(c);
} else {
// 如果节点不存在，则根据Google任务ID是否为空决定是本地添加还是远程删除
if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
syncType = Node.SYNC_ACTION_ADD_REMOTE;
} else {
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;
}
}
// 同步远程添加的文件夹的部分
Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
while (iter.hasNext()) {
Map.Entry<String, TaskList> entry = iter.next();
gid = entry.getKey();
node = entry.getValue();
if (mGTaskHashMap.containsKey(gid)) {
// 如果本地已经存在该Google任务ID的节点，则更新本地映射并添加本地节点
mGTaskHashMap.remove(gid);
doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
}
}
// 如果同步操作没有被取消，则提交更新
if (!mCancelled)
GTaskClient.getInstance().commitUpdate();
}
// 定义一个方法用于内容同步，接收同步类型、节点和游标作为参数，可能抛出网络失败异常
private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
// 如果同步被取消，则直接返回
if (mCancelled) {
return;
}
MetaData meta; // 定义一个MetaData对象用于后续操作
// 根据不同的同步类型执行不同的操作
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: // 本地删除节点
meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN)); // 从哈希映射中获取MetaData对象
if (meta != null) {
GTaskClient.getInstance().deleteNode(meta); // 删除节点
}
mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN)); // 将本地删除节点的ID添加到映射中
break;
case Node.SYNC_ACTION_DEL_REMOTE: // 远程删除节点
meta = mMetaHashMap.get(node.getGid()); // 从哈希映射中获取MetaData对象
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: // 更新冲突，当前简单使用本地更新
// 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; // 定义一个SqlNote对象用于后续操作
// 判断节点类型，如果是任务列表，则进行特殊处理
if (node instanceof TaskList) {
// 根据任务列表的名称判断是否为特殊列表（如默认列表、通话记录列表）
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 = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER);
} else {
sqlNote = new SqlNote(mContext);
sqlNote.setContent(node.getLocalJSONFromContent()); // 设置节点内容
sqlNote.setParentId(Notes.ID_ROOT_FOLDER); // 设置父节点ID为根文件夹ID
}
} else { // 如果是任务节点，则进行通用处理
sqlNote = new SqlNote(mContext);
JSONObject js = node.getLocalJSONFromContent(); // 获取节点内容的JSON对象
try {
// 检查JSON对象中是否包含特定字段，并根据需要进行处理
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)) {
// 如果数据库中已存在该ID，则移除ID字段
note.remove(NoteColumns.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)) {
// 如果数据库中已存在该数据ID，则移除数据ID字段
data.remove(DataColumns.ID);
}
}
}
}
} catch (JSONException e) {
Log.w(TAG, e.toString());
e.printStackTrace();
}
sqlNote.setContent(js); // 设置节点内容的JSON对象
// 获取父节点的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.setParentId(parentId.longValue());
}
// 创建本地节点
sqlNote.setGtaskId(node.getGid()); // 设置节点的全局ID
sqlNote.commit(false); // 提交节点到数据库
// 更新全局ID到本地ID的映射
mGidToNid.put(node.getGid(), sqlNote.getId());
mNidToGid.put(sqlNote.getId(), node.getGid());
// 更新MetaData
updateRemoteMeta(node.getGid(), sqlNote);
}
// 定义一个私有方法，用于更新本地节点，参数包括节点和数据库游标
private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
// 如果操作被取消，则直接返回
if (mCancelled) {
return;
}
SqlNote sqlNote;
// 创建一个SqlNote实例，用于更新笔记
sqlNote = new SqlNote(mContext, c);
// 设置SqlNote的内容为节点的本地JSON内容
sqlNote.setContent(node.getLocalJSONFromContent());
// 根据节点类型获取父节点的ID，如果是任务则通过GID查找，否则使用根文件夹ID
Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
: new Long(Notes.ID_ROOT_FOLDER);
// 如果找不到父节点的ID，则记录错误并抛出异常
if (parentId == null) {
Log.e(TAG, "cannot find task's parent id locally");
throw new ActionFailureException("cannot update local node");
}
// 设置SqlNote的父节点ID
sqlNote.setParentId(parentId.longValue());
// 提交更改到数据库，true表示立即写入
sqlNote.commit(true);
// 更新远程元数据
updateRemoteMeta(node.getGid(), sqlNote);
}
// 定义一个私有方法，用于添加远程节点，参数包括节点和数据库游标
private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
// 如果操作被取消，则直接返回
if (mCancelled) {
return;
}
SqlNote sqlNote = new SqlNote(mContext, c);
Node n;
// 如果是笔记类型，则进行远程更新
if (sqlNote.isNoteType()) {
Task task = new Task();
// 设置任务的内容为SqlNote的内容
task.setContentByLocalJSON(sqlNote.getContent());
// 查找父任务的GID
String parentGid = mNidToGid.get(sqlNote.getParentId());
// 如果找不到父任务的GID，则记录错误并抛出异常
if (parentGid == null) {
Log.e(TAG, "cannot find task's parent tasklist");
throw new ActionFailureException("cannot add remote task");
}
// 将任务添加到父任务列表中
mGTaskListHashMap.get(parentGid).addChildTask(task);
// 创建远程任务
GTaskClient.getInstance().createTask(task);
n = (Node) task;
// 更新远程元数据
updateRemoteMeta(task.getGid(), sqlNote);
} else {
TaskList tasklist = null;
// 根据SqlNote的ID判断文件夹类型，并构建文件夹名称
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<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
while (iter.hasNext()) {
Map.Entry<String, TaskList> entry = iter.next();
String gid = entry.getKey();
TaskList list = entry.getValue();
if (list.getName().equals(folderName)) {
tasklist = list;
// 如果存在同名文件夹且已经在GTaskHashMap中，则移除
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;
}
// 更新本地SqlNote的GtaskID
sqlNote.setGtaskId(n.getGid());
// 提交更改到数据库，false表示延迟写入
sqlNote.commit(false);
// 重置本地修改标记
sqlNote.resetLocalModified();
// 再次提交更改到数据库，true表示立即写入
sqlNote.commit(true);
// 更新GID和ID的映射关系
mGidToNid.put(n.getGid(), sqlNote.getId());
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);
// 更新远程内容：将节点的内容设置为从SqlNote获取的本地JSON内容。
node.setContentByLocalJSON(sqlNote.getContent());
// 调用GTaskClient的实例来添加或更新这个节点。
GTaskClient.getInstance().addUpdateNode(node);
// 更新节点的元数据。
updateRemoteMeta(node.getGid(), sqlNote);
// 如果需要，移动任务。
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);
}
}
// 清除本地的修改标志，并提交更改。
sqlNote.resetLocalModified();
sqlNote.commit(true);
}
// 定义一个方法，用于更新远程元数据。
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。
private void refreshLocalSyncId() throws NetworkFailureException {
if (mCancelled) {
return;
}
// 清除现有的哈希映射，并初始化任务列表。
mGTaskHashMap.clear();
mGTaskListHashMap.clear();
mMetaHashMap.clear();
initGTaskList();
Cursor c = null;
try {
// 查询本地笔记，排除系统类型和垃圾文件夹。
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) {
// 如果找到了对应的节点，则更新其同步ID。
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 {
// 如果找不到对应的节点，则记录错误。
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 {
if (c != null) {
c.close();
c = null;
}
}
}
// 定义一个方法，用于获取同步账户的名称。
public String getSyncAccount() {
return GTaskClient.getInstance().getSyncAccount().name;
}
// 定义一个方法，用于取消同步。
public void cancelSync() {
mCancelled = true;
}

123
GTaskStringUtils.java
Unescape View File

@ -1,123 +0,0 @@
/*
* 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.
*/
// 定义包名，表示这个类属于net.micode.notes.tool包
package net.micode.notes.tool;
// 声明一个公共类GTaskStringUtils
public class GTaskStringUtils {
// 定义与GTasks JSON操作相关的常量
// action_id，用于标识操作的ID
public final static String GTASK_JSON_ACTION_ID = "action_id";
// action_list，用于标识操作涉及的任务列表
public final static String GTASK_JSON_ACTION_LIST = "action_list";
// action_type，用于标识操作类型
public final static String GTASK_JSON_ACTION_TYPE = "action_type";
// create，表示创建操作
public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
// get_all，表示获取所有操作
public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
// move，表示移动操作
public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
// update，表示更新操作
public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
// 定义与GTasks实体相关的常量
// creator_id，用于标识创建者的ID
public final static String GTASK_JSON_CREATOR_ID = "creator_id";
// child_entity，用于标识子实体
public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
// client_version，用于标识客户端版本
public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
// completed，用于标识任务是否完成
public final static String GTASK_JSON_COMPLETED = "completed";
// current_list_id，用于标识当前任务所在的列表ID
public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
// default_list_id，用于标识默认任务列表的ID
public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
// deleted，用于标识任务是否被删除
public final static String GTASK_JSON_DELETED = "deleted";
// dest_list，用于标识目标列表
public final static String GTASK_JSON_DEST_LIST = "dest_list";
// dest_parent，用于标识目标父级
public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
// dest_parent_type，用于标识目标父级类型
public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
// entity_delta，用于标识实体变化
public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
// entity_type，用于标识实体类型
public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
// get_deleted，用于标识是否获取已删除的任务
public final static String GTASK_JSON_GET_DELETED = "get_deleted";
// id，用于标识实体的ID
public final static String GTASK_JSON_ID = "id";
// index，用于标识索引
public final static String GTASK_JSON_INDEX = "index";
// last_modified，用于标识最后一次修改时间
public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
// latest_sync_point，用于标识最新的同步点
public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
// list_id，用于标识列表ID
public final static String GTASK_JSON_LIST_ID = "list_id";
// lists，用于标识列表集合
public final static String GTASK_JSON_LISTS = "lists";
// name，用于标识名称
public final static String GTASK_JSON_NAME = "name";
// new_id，用于标识新ID
public final static String GTASK_JSON_NEW_ID = "new_id";
// notes，用于标识笔记
public final static String GTASK_JSON_NOTES = "notes";
// parent_id，用于标识父级ID
public final static String GTASK_JSON_PARENT_ID = "parent_id";
// prior_sibling_id，用于标识前一个同级ID
public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
// results，用于标识结果集合
public final static String GTASK_JSON_RESULTS = "results";
// source_list，用于标识源列表
public final static String GTASK_JSON_SOURCE_LIST = "source_list";
// tasks，用于标识任务集合
public final static String GTASK_JSON_TASKS = "tasks";
// type，用于标识类型
public final static String GTASK_JSON_TYPE = "type";
// GROUP，表示组类型
public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
// TASK，表示任务类型
public final static String GTASK_JSON_TYPE_TASK = "TASK";
// user，用于标识用户
public final static String GTASK_JSON_USER = "user";
// 定义与文件夹相关的常量
// [MIUI_Notes]，表示MIUI笔记文件夹的前缀
public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]";
// Default，表示默认文件夹名
public final static String FOLDER_DEFAULT = "Default";
// Call_Note，表示通话记录文件夹名
public final static String FOLDER_CALL_NOTE = "Call_Note";
// METADATA，表示元数据文件夹名
public final static String FOLDER_META = "METADATA";
// 定义与元数据相关的常量
// meta_gid，用于标识元数据中的GTasks ID
public final static String META_HEAD_GTASK_ID = "meta_gid";
// meta_note，用于标识元数据中的笔记
public final static String META_HEAD_NOTE = "meta_note";
// meta_data，用于标识元数据中的数据
public final static String META_HEAD_DATA = "meta_data";
// [META INFO] DON'T UPDATE AND DELETE，表示元数据笔记的名称，提示用户不要更新和删除
public final static String META_NOTE_NAME = "[META INFO] DON'T UPDATE AND DELETE";
}

145
GTaskSyncService.java
Unescape View File

@ -1,145 +0,0 @@
/*
* 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;
// 导入必要的Android类
import android.app.Activity;
import android.app.Service;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.os.IBinder;
// 定义一个继承自Service的类，用于同步任务
public class GTaskSyncService extends Service {
// 定义同步动作名称的常量
public final static String ACTION_STRING_NAME = "sync_action_type";
// 定义同步动作类型的常量
public final static int ACTION_START_SYNC = 0; // 开始同步
public final static int ACTION_CANCEL_SYNC = 1; // 取消同步
public final static int ACTION_INVALID = 2; // 无效动作
// 定义广播名称的常量
public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service";
// 定义广播内容的键
public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing"; // 是否正在同步
public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg"; // 同步进度信息
// 定义一个静态的异步任务对象，用于执行同步操作
private static GTaskASyncTask mSyncTask = null;
// 定义一个静态的字符串，用于存储同步进度信息
private static String mSyncProgress = "";
// 开始同步的私有方法
private void startSync() {
if (mSyncTask == null) { // 如果当前没有正在执行的同步任务
mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
public void onComplete() {
mSyncTask = null; // 任务完成后，将任务对象置为null
sendBroadcast(""); // 发送广播，通知同步完成
stopSelf(); // 停止服务
}
});
sendBroadcast(""); // 发送广播，通知开始同步（这里可能需要发送具体信息）
mSyncTask.execute(); // 执行异步任务
}
}
// 取消同步的私有方法
private void cancelSync() {
if (mSyncTask != null) { // 如果当前有正在执行的同步任务
mSyncTask.cancelSync(); // 取消任务
}
}
// 当服务被创建时调用
@Override
public void onCreate() {
mSyncTask = null; // 初始化同步任务对象为null
}
// 当服务被命令启动时调用
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
Bundle bundle = intent.getExtras(); // 获取Intent中的附加数据
if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) { // 如果附加数据不为空且包含动作名称
switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) { // 根据动作名称执行相应操作
case ACTION_START_SYNC:
startSync(); // 开始同步
break;
case ACTION_CANCEL_SYNC:
cancelSync(); // 取消同步
break;
default:
break;
}
return START_STICKY; // 如果服务被杀死，系统会重新创建服务并调用onStartCommand方法
}
return super.onStartCommand(intent, flags, startId); // 如果没有指定动作，则调用父类方法
}
// 当设备内存不足时调用
@Override
public void onLowMemory() {
if (mSyncTask != null) { // 如果当前有正在执行的同步任务
mSyncTask.cancelSync(); // 取消任务以释放内存
}
}
// 返回null，因为此服务不绑定客户端
public IBinder onBind(Intent intent) {
return null;
}
// 发送广播的方法，用于通知同步进度等信息
public void sendBroadcast(String msg) {
mSyncProgress = msg; // 更新同步进度信息
Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME); // 创建广播Intent
intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null); // 是否正在同步
intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg); // 同步进度信息
sendBroadcast(intent); // 发送广播
}
// 提供一个静态方法，用于从Activity启动同步服务
public static void startSync(Activity activity) {
GTaskManager.getInstance().setActivityContext(activity); // 设置GTaskManager的Activity上下文
Intent intent = new Intent(activity, GTaskSyncService.class); // 创建Intent
intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC); // 添加动作类型
activity.startService(intent); // 启动服务
}
// 提供一个静态方法，用于从Context取消同步服务
public static void cancelSync(Context context) {
Intent intent = new Intent(context, GTaskSyncService.class); // 创建Intent
intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC); // 添加动作类型
context.startService(intent); // 启动服务以取消同步
}
// 提供一个静态方法，用于检查是否正在同步
public static boolean isSyncing() {
return mSyncTask != null; // 返回mSyncTask是否为null
}
// 提供一个静态方法，用于获取同步进度信息
public static String getProgressString() {
return mSyncProgress; // 返回mSyncProgress的值
}
}

97
MetaData.java
Unescape View File

@ -1,97 +0,0 @@
/*
* 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.tool.GTaskStringUtils;
import org.json.JSONException;
import org.json.JSONObject;
// MetaData类继承自Task类，从命名来看可能是用于处理与任务相关的元数据信息，比如关联的特定标识等
public class MetaData extends Task {
// 定义一个用于日志记录的标签，使用类的简单名称（即不包含包名的类名），方便在查看日志时识别该类相关的输出信息
private final static String TAG = MetaData.class.getSimpleName();
// 用于存储相关的GID（可能是某种全局唯一标识符，具体取决于业务逻辑），初始化为null
private String mRelatedGid = null;
// 设置元数据的方法，接收一个GID（可能用于关联其他对象或任务）和一个JSON对象（包含具体的元数据信息）作为参数
public void setMeta(String gid, JSONObject metaInfo) {
try {
// 尝试将给定的GID放入JSON对象中，对应的键由GTaskStringUtils.META_HEAD_GTASK_ID指定，可能用于标记该元数据关联的具体任务ID
metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
} catch (JSONException e) {
// 如果在向JSON对象中放入数据时出现异常，记录错误日志，提示设置相关GID失败
Log.e(TAG, "failed to put related gid");
}
// 将处理后的JSON对象转换为字符串，并设置为该对象的笔记内容（这里假设Task类中有对应的setNotes方法用于设置笔记相关内容）
setNotes(metaInfo.toString());
// 设置该对象的名称，名称由GTaskStringUtils.META_NOTE_NAME指定，可能是一个固定的用于标识元数据类型的名称
setName(GTaskStringUtils.META_NOTE_NAME);
}
// 获取关联的GID的方法，外部可以通过调用此方法获取之前设置的相关标识符
public String getRelatedGid() {
return mRelatedGid;
}
// 重写自Task类的方法，用于判断该元数据对象是否值得保存，这里的判断依据是看其笔记内容是否为null，若不为null则认为值得保存
@Override
public boolean isWorthSaving() {
return getNotes()!= null;
}
// 重写自Task类的方法，用于根据远程的JSON数据设置该对象的内容，并在这个过程中提取相关的GID信息
@Override
public void setContentByRemoteJSON(JSONObject js) {
super.setContentByRemoteJSON(js);
if (getNotes()!= null) {
try {
// 将获取到的笔记内容字符串转换为JSON对象，以便从中提取相关信息
JSONObject metaInfo = new JSONObject(getNotes().trim());
// 从JSON对象中获取关联的GID字符串，并赋值给成员变量mRelatedGid
mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
} catch (JSONException e) {
// 如果在解析JSON获取GID时出现异常，记录警告日志，并将mRelatedGid设置为null
Log.w(TAG, "failed to get related gid");
mRelatedGid = null;
}
}
}
// 重写自Task类的方法，这里明确抛出异常表示该方法不应该被调用，可能在业务逻辑中该类对于通过本地JSON设置内容的操作是不支持的
@Override
public void setContentByLocalJSON(JSONObject js) {
// this function should not be called
throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
}
// 重写自Task类的方法，同样抛出异常表示该方法不应该被调用，可能该类不需要从内容生成本地JSON这种操作，或者这种操作不符合其业务逻辑
@Override
public JSONObject getLocalJSONFromContent() {
throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
}
// 重写自Task类的方法，再次抛出异常表示该方法不应该被调用，可能在数据同步相关的操作中，该类不需要执行获取同步动作的这个逻辑，具体取决于整体的业务设计
@Override
public int getSyncAction(Cursor c) {
throw new IllegalAccessError("MetaData:getSyncAction should not be called");
}
}

50
NetworkFailureException.java
Unescape View File

@ -1,50 +0,0 @@
/*
* 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;
// 声明该类所在的包，此处表示该类属于某个特定的包结构下（具体功能相关的包，从类名推测和网络相关操作出现异常的处理有关）。
package net.micode.notes.gtask.exception;
// NetworkFailureException类继承自Exception类，这意味着它是一个受检异常，在使用的地方必须显式地进行捕获或者继续向上抛出，
// 该类主要用于表示在网络相关操作（比如网络请求、网络连接等操作，根据类名推测其用途）出现失败情况时抛出的异常，方便在业务逻辑中区分不同类型的异常情况并针对性处理。
public class NetworkFailureException extends Exception {
// 定义一个序列化版本号，用于在对象序列化和反序列化过程中保证版本兼容性。
// 这个值是一个固定的长整型数字，按照Java序列化机制的要求设置，当类的结构后续有变动（例如添加、删除成员变量等情况）时，
// 可能需要相应地更新这个版本号，不过若类结构保持稳定，通常维持这个初始给定的值即可。
private static final long serialVersionUID = 2107610287180234136L;
// 无参构造函数，调用父类（Exception）的无参构造函数，用于创建一个默认的NetworkFailureException实例，
// 当在业务逻辑中不需要明确指定具体的异常信息时，可以使用这个构造函数创建异常对象并抛出，不过实际应用中这种情况相对较少，更多时候希望传递一些具体描述失败原因的信息。
public NetworkFailureException() {
super();
}
// 带有一个字符串参数的构造函数，接收一个表示异常详细信息的字符串（paramString），调用父类（Exception）对应的构造函数，
// 将该字符串作为异常信息传递进去，用于创建一个带有具体描述内容的NetworkFailureException实例，方便在抛出异常时告知调用者具体的网络相关失败原因，
// 例如在网络请求超时的情况下，可以传递类似“网络请求超时，请检查网络连接”这样的信息，便于定位和排查问题。
public NetworkFailureException(String paramString) {
super(paramString);
}
// 带有一个字符串参数和一个Throwable参数的构造函数，接收一个表示异常详细信息的字符串（paramString）以及一个表示引起当前异常的根异常对象（paramThrowable），
// 调用父类（Exception）相应的构造函数，把这两个参数传递进去，用于创建一个既包含具体描述信息又关联了引起当前异常的底层异常的NetworkFailureException实例，
// 比如在网络连接因为底层Socket异常而失败时，可以传递如“网络连接出现Socket异常”作为paramString，同时将对应的Socket异常对象作为paramThrowable传入，
// 这样在排查问题时，能够通过获取根异常的详细信息更全面地了解导致网络操作失败的根源所在。
public NetworkFailureException(String paramString, Throwable paramThrowable) {
super(paramString, paramThrowable);
}
}

110
Node.java
Unescape View File

@ -1,110 +0,0 @@
/*
* 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 org.json.JSONObject;
// 抽象类Node，可能作为数据节点相关操作的基础类，定义了一些通用规范和抽象方法供子类实现
public abstract class Node {
// 同步操作相关的各种类型常量，用于标记不同的同步动作情况
public static final int SYNC_ACTION_NONE = 0;
public static final int SYNC_ACTION_ADD_REMOTE = 1;
public static final int SYNC_ACTION_ADD_LOCAL = 2;
public static final int SYNC_ACTION_DEL_REMOTE = 3;
public static final int SYNC_ACTION_DEL_LOCAL = 4;
public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
public static final int SYNC_ACTION_ERROR = 8;
// 存储全局唯一标识符（GID），初始值为null
private String mGid;
// 节点名称，初始为空字符串
private String mName;
// 最后修改时间戳，初始为0
private long mLastModified;
// 表示节点是否被删除的标志，初始为false
private boolean mDeleted;
// 构造函数，初始化各成员变量
public Node() {
mGid = null;
mName = "";
mLastModified = 0;
mDeleted = false;
}
// 抽象方法，获取创建操作对应的JSON对象，具体由子类实现
public abstract JSONObject getCreateAction(int actionId);
// 抽象方法，获取更新操作对应的JSON对象，子类按业务逻辑实现
public abstract JSONObject getUpdateAction(int actionId);
// 抽象方法，依据远程JSON数据设置节点内容，子类负责解析填充
public abstract void setContentByRemoteJSON(JSONObject js);
// 抽象方法，依据本地JSON数据设置节点内容，由子类实现具体逻辑
public abstract void setContentByLocalJSON(JSONObject js);
// 抽象方法，从节点内容生成本地JSON对象，子类确定JSON结构
public abstract JSONObject getLocalJSONFromContent();
// 抽象方法，根据游标获取节点的同步操作类型，子类判断逻辑
public abstract int getSyncAction(Cursor c);
// 设置GID的方法
public void setGid(String gid) {
this.mGid = gid;
}
// 设置名称的方法
public void setName(String name) {
this.mName = name;
}
// 设置最后修改时间的方法
public void setLastModified(long lastModified) {
this.mLastModified = lastModified;
}
// 设置是否删除状态的方法
public void setDeleted(boolean deleted) {
this.mDeleted = deleted;
}
// 获取GID的方法
public String getGid() {
return this.mGid;
}
// 获取名称的方法
public String getName() {
return this.mName;
}
// 获取最后修改时间的方法
public long getLastModified() {
return this.mLastModified;
}
// 获取是否删除状态的方法
public boolean getDeleted() {
return this.mDeleted;
}
}

313
Note.java
Unescape View File

@ -1,313 +0,0 @@
/*
* 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;
// 导入所需的Android和内容提供者操作的类
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;
// 导入Java的ArrayList类
import java.util.ArrayList;
// 声明Note类
public class Note {
// 用于存储笔记差异值的ContentValues对象
private ContentValues mNoteDiffValues;
// 用于存储笔记数据的NoteData对象
private NoteData mNoteData;
// 用于日志记录的标签
private static final String TAG = "Note";
/**
* 创建一个新的笔记ID，用于向数据库添加新笔记
*/
public static synchronized long getNewNoteId(Context context, long folderId) {
// 创建一个新的ContentValues对象，用于存储要插入数据库的数据
ContentValues values = new ContentValues();
// 获取当前时间作为创建和修改时间
long createdTime = System.currentTimeMillis();
values.put(NoteColumns.CREATED_DATE, createdTime);
values.put(NoteColumns.MODIFIED_DATE, createdTime);
values.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 设置笔记类型为普通笔记
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记为本地已修改
values.put(NoteColumns.PARENT_ID, folderId); // 设置父文件夹ID
// 向内容提供者插入数据，并获取返回的Uri
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
long noteId = 0;
try {
// 从返回的Uri中提取笔记ID
noteId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
// 如果提取ID时发生异常，则记录错误日志，并将noteId设置为0
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
}
// 如果noteId为-1，则抛出异常
if (noteId == -1) {
throw new IllegalStateException("Wrong note id:" + noteId);
}
return noteId; // 返回新创建的笔记ID
}
// Note类的构造函数
public Note() {
mNoteDiffValues = new ContentValues(); // 初始化差异值对象
mNoteData = new NoteData(); // 初始化笔记数据对象
}
// 设置笔记的某个键值对，并标记为已修改
public void setNoteValue(String key, String value) {
mNoteDiffValues.put(key, value); // 存储键值对
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记为已修改
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 更新修改时间
}
// 设置文本数据的某个键值对
public void setTextData(String key, String value) {
mNoteData.setTextData(key, value); // 调用NoteData对象的方法设置文本数据
}
// 设置文本数据的ID
public void setTextDataId(long id) {
mNoteData.setTextDataId(id); // 调用NoteData对象的方法设置文本数据ID
}
// 获取文本数据的ID
public long getTextDataId() {
return mNoteData.mTextDataId; // 返回NoteData对象中的文本数据ID
}
// 设置通话数据的ID
public void setCallDataId(long id) {
mNoteData.setCallDataId(id); // 调用NoteData对象的方法设置通话数据ID
}
// 设置通话数据的某个键值对
public void setCallData(String key, String value) {
mNoteData.setCallData(key, value); // 调用NoteData对象的方法设置通话数据
}
// 判断笔记是否已本地修改
public boolean isLocalModified() {
return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified(); // 判断差异值对象或NoteData对象是否标记为已修改
}
// 同步笔记到数据库
public boolean syncNote(Context context, long noteId) {
if (noteId <= 0) {
throw new IllegalArgumentException("Wrong note id:" + noteId); // 如果笔记ID非法，则抛出异常
}
if (!isLocalModified()) {
return true; // 如果笔记未修改，则直接返回true
}
/**
* 理论上，一旦数据改变，就应该更新笔记的LOCAL_MODIFIED和MODIFIED_DATE字段。
* 为了数据安全，即使更新笔记失败，也要更新笔记数据信息。
*/
if (context.getContentResolver().update(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
null) == 0) {
Log.e(TAG, "Update note error, should not happen"); // 如果更新失败，则记录错误日志
// 不返回，继续执行后续代码
}
mNoteDiffValues.clear(); // 清空差异值对象
// 如果NoteData对象标记为已修改，并且推送到内容提供者失败，则返回false
if (mNoteData.isLocalModified()
&& (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
return false;
}
return true; // 同步成功，返回true
}
// 定义一个私有的内部类NoteData，用于管理笔记数据的存储和操作
private class NoteData {
// 文本数据的ID
private long mTextDataId;
// 用于存储文本数据的ContentValues对象
private ContentValues mTextDataValues;
// 通话数据的ID
private long mCallDataId;
// 用于存储通话数据的ContentValues对象
private ContentValues mCallDataValues;
// 用于日志输出的标签
private static final String TAG = "NoteData";
// NoteData类的构造函数，初始化数据
public NoteData() {
// 初始化文本数据和通话数据的ContentValues对象
mTextDataValues = new ContentValues();
mCallDataValues = new ContentValues();
// 初始化数据ID为0，表示未设置
mTextDataId = 0;
mCallDataId = 0;
}
// 判断是否有本地数据被修改
boolean isLocalModified() {
// 如果文本数据或通话数据的ContentValues对象不为空，则表示有数据被修改
return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
}
// 设置文本数据的ID
void setTextDataId(long id) {
// 如果传入的ID小于等于0，则抛出异常
if(id <= 0) {
throw new IllegalArgumentException("Text data id should larger than 0");
}
// 设置文本数据的ID
mTextDataId = id;
}
// 设置通话数据的ID
void setCallDataId(long id) {
// 如果传入的ID小于等于0，则抛出异常
if (id <= 0) {
throw new IllegalArgumentException("Call data id should larger than 0");
}
// 设置通话数据的ID
mCallDataId = id;
}
// 设置通话数据，并标记为已修改
void setCallData(String key, String value) {
// 将数据存入mCallDataValues
mCallDataValues.put(key, value);
// 标记为已修改（注意：这里mNoteDiffValues没有在类中定义，可能是个错误或者遗漏）
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
// 更新修改日期
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
}
// 设置文本数据，并标记为已修改
void setTextData(String key, String value) {
// 将数据存入mTextDataValues
mTextDataValues.put(key, value);
// 标记为已修改（注意：同样mNoteDiffValues没有在类中定义）
mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
// 更新修改日期
mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
}
// 将数据推送到ContentResolver中
Uri pushIntoContentResolver(Context context, long noteId) {
// 检查noteId的有效性
if (noteId <= 0) {
throw new IllegalArgumentException("Wrong note id:" + noteId);
}
// 创建一个操作列表，用于批量操作
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
ContentProviderOperation.Builder builder = null;
// 处理文本数据
if(mTextDataValues.size() > 0) {
// 添加noteId到文本数据中
mTextDataValues.put(DataColumns.NOTE_ID, noteId);
// 如果是新数据，则插入到数据库中
if (mTextDataId == 0) {
mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mTextDataValues);
try {
// 设置新插入的数据的ID
setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
// 插入失败，记录错误并清理数据
Log.e(TAG, "Insert new text data fail with noteId" + noteId);
mTextDataValues.clear();
return null;
}
} else {
// 如果是已存在的数据，则更新
builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mTextDataId));
builder.withValues(mTextDataValues);
operationList.add(builder.build());
}
// 清理文本数据，为下一次操作做准备
mTextDataValues.clear();
}
// 处理通话数据，逻辑与文本数据处理相同
if(mCallDataValues.size() > 0) {
mCallDataValues.put(DataColumns.NOTE_ID, noteId);
if (mCallDataId == 0) {
mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mCallDataValues);
try {
setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
Log.e(TAG, "Insert new call data fail with noteId" + noteId);
mCallDataValues.clear();
return null;
}
} else {
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) {
// 记录远程异常并返回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;
}
}

132
NoteWidgetProvider.java
Unescape View File

@ -1,132 +0,0 @@
/*
* 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.widget;
import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.ContentValues;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.util.Log;
import android.widget.RemoteViews;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NoteEditActivity;
import net.micode.notes.ui.NotesListActivity;
public abstract class NoteWidgetProvider extends AppWidgetProvider {
public static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.BG_COLOR_ID,
NoteColumns.SNIPPET
};
public static final int COLUMN_ID = 0;
public static final int COLUMN_BG_COLOR_ID = 1;
public static final int COLUMN_SNIPPET = 2;
private static final String TAG = "NoteWidgetProvider";
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
ContentValues values = new ContentValues();
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
for (int i = 0; i < appWidgetIds.length; i++) {
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
NoteColumns.WIDGET_ID + "=?",
new String[] { String.valueOf(appWidgetIds[i])});
}
}
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
null);
}
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
for (int i = 0; i < appWidgetIds.length; i++) {
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
int bgId = ResourceParser.getDefaultBgId(context);
String snippet = "";
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
if (c != null && c.moveToFirst()) {
if (c.getCount() > 1) {
Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
c.close();
return;
}
snippet = c.getString(COLUMN_SNIPPET);
bgId = c.getInt(COLUMN_BG_COLOR_ID);
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
intent.setAction(Intent.ACTION_VIEW);
} else {
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
}
if (c != null) {
c.close();
}
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
/**
* Generate the pending intent to start host for the widget
*/
PendingIntent pendingIntent = null;
if (privacyMode) {
rv.setTextViewText(R.id.widget_text,
context.getString(R.string.widget_under_visit_mode));
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent(
context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
} else {
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}
rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
}
}
protected abstract int getBgResourceId(int bgId);
protected abstract int getLayoutId();
protected abstract int getWidgetType();
}

47
NoteWidgetProvider_2x.java
Unescape View File

@ -1,47 +0,0 @@
/*
* 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.widget;
import android.appwidget.AppWidgetManager;
import android.content.Context;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.update(context, appWidgetManager, appWidgetIds);
}
@Override
protected int getLayoutId() {
return R.layout.widget_2x;
}
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;
}
}

46
NoteWidgetProvider_4x.java
Unescape View File

@ -1,46 +0,0 @@
/*
* 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.widget;
import android.appwidget.AppWidgetManager;
import android.content.Context;
import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.update(context, appWidgetManager, appWidgetIds);
}
protected int getLayoutId() {
return R.layout.widget_4x;
}
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;
}
}

114
Notes.java
Unescape View File

@ -1,114 +0,0 @@
/*
* Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
* 版权声明，说明本代码是由MiCode开源社区提供并遵循Apache 2.0许可证。
*/
package net.micode.notes.data; // 包声明，表示该类属于net.micode.notes.data包
import android.net.Uri; // 导入Uri类，用于处理URI
public class Notes {
// 定义常量，用于表示笔记、文件夹和系统类型
public static final String AUTHORITY = "micode_notes";
public static final String TAG = "Notes";
public static final int TYPE_NOTE = 0; // 笔记类型
public static final int TYPE_FOLDER = 1; // 文件夹类型
public static final int TYPE_SYSTEM = 2; // 系统类型
/**
* 以下是系统文件夹的标识符
* ID_ROOT_FOLDER 是默认文件夹
* ID_TEMPARAY_FOLDER 用于存储没有归类的笔记
* ID_CALL_RECORD_FOLDER 用于存储通话记录
*/
public static final int ID_ROOT_FOLDER = 0;
public static final int ID_TEMPARAY_FOLDER = -1;
public static final int ID_CALL_RECORD_FOLDER = -2;
public static final int ID_TRASH_FOLER = -3; // 回收站文件夹
// Intent中传递的数据常量
public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
// 小部件类型
public static final int TYPE_WIDGET_INVALIDE = -1;
public static final int TYPE_WIDGET_2X = 0;
public static final int TYPE_WIDGET_4X = 1;
// 数据常量，指示笔记和通话记录的数据类型
public static class DataConstants {
public static final String NOTE = TextNote.CONTENT_ITEM_TYPE; // 文本笔记类型
public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE; // 通话记录类型
}
// 查询所有笔记和文件夹的URI
public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
// 查询数据的URI
public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
public interface NoteColumns {
/**
* 定义笔记和文件夹的数据库列
* 每个字段后面有说明其数据类型
*/
public static final String ID = "_id"; // 唯一ID
public static final String PARENT_ID = "parent_id"; // 父级ID
public static final String CREATED_DATE = "created_date"; // 创建日期
public static final String MODIFIED_DATE = "modified_date"; // 修改日期
public static final String ALERTED_DATE = "alert_date"; // 提醒日期
public static final String SNIPPET = "snippet"; // 文件夹名或笔记内容
public static final String WIDGET_ID = "widget_id"; // 小部件ID
public static final String WIDGET_TYPE = "widget_type"; // 小部件类型
public static final String BG_COLOR_ID = "bg_color_id"; // 背景颜色ID
public static final String HAS_ATTACHMENT = "has_attachment"; // 是否有附件
public static final String NOTES_COUNT = "notes_count"; // 文件夹内笔记数量
public static final String TYPE = "type"; // 类型：笔记或文件夹
public static final String SYNC_ID = "sync_id"; // 同步ID
public static final String LOCAL_MODIFIED = "local_modified"; // 本地修改标志
public static final String ORIGIN_PARENT_ID = "origin_parent_id"; // 原始父级ID
public static final String GTASK_ID = "gtask_id"; // GTask ID
public static final String VERSION = "version"; // 版本
}
public interface DataColumns {
/**
* 定义数据表的列，主要用于存储附件或其他类型的数据
*/
public static final String ID = "_id"; // 唯一ID
public static final String MIME_TYPE = "mime_type"; // 数据的MIME类型
public static final String NOTE_ID = "note_id"; // 对应笔记的ID
public static final String CREATED_DATE = "created_date"; // 创建日期
public static final String MODIFIED_DATE = "modified_date"; // 修改日期
public static final String CONTENT = "content"; // 数据内容
public static final String DATA1 = "data1";
public static final String DATA2 = "data2";
public static final String DATA3 = "data3";
public static final String DATA4 = "data4";
public static final String DATA5 = "data5"; }
// 文本笔记的实现
public static final class TextNote implements DataColumns {
public static final String MODE = DATA1; // 标记是否为待办事项
public static final int MODE_CHECK_LIST = 1; // 待办事项模式
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note"; // 文本笔记内容类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note"; // 单项文本笔记内容类型
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note"); // 文本笔记的URI
}
// 通话记录笔记的实现
public static final class CallNote implements DataColumns {
public static final String CALL_DATE = DATA1; // 通话日期
public static final String PHONE_NUMBER = DATA3; // 电话号码
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note"; // 通话记录内容类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note"; // 单项通话记录内容类型
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note"); // 通话记录的URI
}
}

187
NotesDatabaseHelper.java
Unescape View File

@ -1,187 +0,0 @@
/*
* 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.data;
import android.content.ContentValues;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.util.Log;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.DataConstants;
import net.micode.notes.data.Notes.NoteColumns;
public class NotesDatabaseHelper extends SQLiteOpenHelper {
private static final String DB_NAME = "note.db"; // 数据库名称
private static final int DB_VERSION = 4; // 数据库版本
public interface TABLE {
public static final String NOTE = "note"; // 笔记表
public static final String DATA = "data"; // 数据表
}
private static final String TAG = "NotesDatabaseHelper"; // 日志标签
private static NotesDatabaseHelper mInstance; // 单例实例
// 创建笔记表的 SQL 语句
private static final String CREATE_NOTE_TABLE_SQL =
"CREATE TABLE " + TABLE.NOTE + "(" +
NoteColumns.ID + " INTEGER PRIMARY KEY," +
NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
")";
// 创建数据表的 SQL 语句
private static final String CREATE_DATA_TABLE_SQL =
"CREATE TABLE " + TABLE.DATA + "(" +
DataColumns.ID + " INTEGER PRIMARY KEY," +
DataColumns.MIME_TYPE + " TEXT NOT NULL," +
DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA1 + " INTEGER," +
DataColumns.DATA2 + " INTEGER," +
DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
")";
// 为数据表创建索引
private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
"CREATE INDEX IF NOT EXISTS note_id_index ON " +
TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
// 触发器：更新文件夹中的笔记数（更新操作时）
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER increase_folder_count_on_update "+
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
" END";
// 触发器：更新文件夹中的笔记数（更新操作时）
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER decrease_folder_count_on_update " +
" AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
" AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
" END";
// 触发器：更新文件夹中的笔记数（插入操作时）
private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
"CREATE TRIGGER increase_folder_count_on_insert " +
" AFTER INSERT ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
" WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
" END";
// 触发器：更新文件夹中的笔记数（删除操作时）
private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
"CREATE TRIGGER decrease_folder_count_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN " +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
" WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
" AND " + NoteColumns.NOTES_COUNT + ">0;" +
" END";
// 触发器：在插入数据时更新笔记内容
private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
"CREATE TRIGGER update_note_content_on_insert " +
" AFTER INSERT ON " + TABLE.DATA +
" WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
" END";
// 触发器：在更新数据时更新笔记内容
private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
"CREATE TRIGGER update_note_content_on_update " +
" AFTER UPDATE ON " + TABLE.DATA +
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
" WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
" END";
// 触发器：在删除数据时更新笔记内容
private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
"CREATE TRIGGER update_note_content_on_delete " +
" AFTER delete ON " + TABLE.DATA +
" WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.SNIPPET + "=''" +
" WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
" END";
// 触发器：在删除笔记时删除关联数据
private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
"CREATE TRIGGER delete_data_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN" +
" DELETE FROM " + TABLE.DATA +
" WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
" END";
// 触发器：删除文件夹时删除文件夹中的笔记
private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
"CREATE TRIGGER folder_delete_notes_on_delete " +
" AFTER DELETE ON " + TABLE.NOTE +
" BEGIN" +
" DELETE FROM " + TABLE.NOTE +
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
" END";
// 触发器：将文件夹中的笔记移动到垃圾桶
private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
"CREATE TRIGGER folder_move_notes_on_trash " +
" AFTER UPDATE ON " + TABLE.NOTE +
" WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
" BEGIN" +
" UPDATE " + TABLE.NOTE +
" SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
" WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";"

186
NotesProvider.java
Unescape View File

@ -1,186 +0,0 @@
/*
* 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.data;
import android.app.SearchManager;
import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Intent;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;
import android.text.TextUtils;
import android.util.Log;
import net.micode.notes.R;
import net.micode.notes.data.Notes.DataColumns;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.NotesDatabaseHelper.TABLE;
public class NotesProvider extends ContentProvider {
// URI匹配器，用于匹配不同的URI路径
private static final UriMatcher mMatcher;
// 数据库帮助类实例
private NotesDatabaseHelper mHelper;
// 调试标签
private static final String TAG = "NotesProvider";
// 定义URI匹配码
private static final int URI_NOTE = 1;
private static final int URI_NOTE_ITEM = 2;
private static final int URI_DATA = 3;
private static final int URI_DATA_ITEM = 4;
private static final int URI_SEARCH = 5;
private static final int URI_SEARCH_SUGGEST = 6;
// 初始化URI匹配器
static {
mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
}
// 搜索结果投影
private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+ NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+ "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+ "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+ R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+ "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+ "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
// 搜索查询
private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
+ " FROM " + TABLE.NOTE
+ " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+ " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+ " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
@Override
public boolean onCreate() {
// 获取数据库帮助类实例
mHelper = NotesDatabaseHelper.getInstance(getContext());
return true;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
String sortOrder) {
// 处理查询请求
Cursor c = null;
SQLiteDatabase db = mHelper.getReadableDatabase();
String id = null;
switch (mMatcher.match(uri)) {
// 根据不同的URI匹配码执行不同的查询操作
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
if (c != null) {
c.setNotificationUri(getContext().getContentResolver(), uri);
}
return c;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
// 处理插入操作
SQLiteDatabase db = mHelper.getWritableDatabase();
long dataId = 0, noteId = 0, insertedId = 0;
switch (mMatcher.match(uri)) {
// 根据不同的URI匹配码执行不同的插入操作
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
return ContentUris.withAppendedId(uri, insertedId);
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
// 处理删除操作
int count = 0;
String id = null;
SQLiteDatabase db = mHelper.getWritableDatabase();
boolean deleteData = false;
switch (mMatcher.match(uri)) {
// 根据不同的URI匹配码执行不同的删除操作
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
return count;
}
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
// 处理更新操作
int count = 0;
String id = null;
SQLiteDatabase db = mHelper.getWritableDatabase();
boolean updateData = false;
switch (mMatcher.match(uri)) {
// 根据不同的URI匹配码执行不同的更新操作
default:
throw new IllegalArgumentException("Unknown URI " + uri);
}
return count;
}
private String parseSelection(String selection) {
// 解析选择条件
return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
}
private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
// 更新笔记版本
StringBuilder sql = new StringBuilder(120);
sql.append("UPDATE ");
sql.append(TABLE.NOTE);
sql.append(" SET ");
sql.append(NoteColumns.VERSION);
sql.append("=" + NoteColumns.VERSION + "+1 ");
if (id > 0 || !TextUtils.isEmpty(selection)) {
sql.append(" WHERE ");
}
if (id > 0) {
sql.append(NoteColumns.ID + "=" + String.valueOf(id));
}
if (!TextUtils.isEmpty(selection)) {
String selectString = id > 0 ? parseSelection(selection) : selection;
for (String args : selectionArgs) {
selectString = selectString.replaceFirst("\\?", args);
}
sql.append(selectString);
}
mHelper.getWritableDatabase().execSQL(sql.toString());
}
@Override
public String getType(Uri uri) {
// 获取内容类型
return null;
}
}

213
ResourceParser.java
Unescape View File

@ -1,213 +0,0 @@
/*
* 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.tool;
// 导入Android框架中的Context类和PreferenceManager类
import android.content.Context;
import android.preference.PreferenceManager;
// 导入项目中的资源类和偏好设置活动类
import net.micode.notes.R;
import net.micode.notes.ui.NotesPreferenceActivity;
// 声明一个工具类，用于解析和管理资源
public class ResourceParser {
// 定义一些常量来表示不同的颜色
public static final int YELLOW = 0; // 黄色
public static final int BLUE = 1; // 蓝色
public static final int WHITE = 2; // 白色
public static final int GREEN = 3; // 绿色
public static final int RED = 4; // 红色
// 默认背景颜色设置为黄色
public static final int BG_DEFAULT_COLOR = YELLOW;
// 定义一些常量来表示不同的字体大小
public static final int TEXT_SMALL = 0; // 小号字体
public static final int TEXT_MEDIUM = 1; // 中号字体
public static final int TEXT_LARGE = 2; // 大号字体
public static final int TEXT_SUPER = 3; // 特大字体
// 默认字体大小设置为中号
public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
// 内部类，用于管理笔记背景资源
public static class NoteBgResources {
// 定义不同颜色背景的编辑界面资源数组
private final static int [] BG_EDIT_RESOURCES = new int [] {
R.drawable.edit_yellow,
R.drawable.edit_blue,
R.drawable.edit_white,
R.drawable.edit_green,
R.drawable.edit_red
};
// 定义不同颜色背景的编辑界面标题资源数组
private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
R.drawable.edit_title_yellow,
R.drawable.edit_title_blue,
R.drawable.edit_title_white,
R.drawable.edit_title_green,
R.drawable.edit_title_red
};
// 根据颜色ID获取对应的编辑界面背景资源
public static int getNoteBgResource(int id) {
return BG_EDIT_RESOURCES[id];
}
// 根据颜色ID获取对应的编辑界面标题背景资源
public static int getNoteTitleBgResource(int id) {
return BG_EDIT_TITLE_RESOURCES[id];
}
}
// 根据用户偏好设置或默认颜色返回笔记背景颜色ID
public static int getDefaultBgId(Context context) {
// 检查用户是否设置了背景颜色偏好
if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
// 如果设置了，则随机返回一个颜色ID
return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
} else {
// 否则返回默认颜色ID
return BG_DEFAULT_COLOR;
}
}
// 内部类，用于管理笔记条目背景资源
public static class NoteItemBgResources {
// 定义不同颜色背景的列表第一项资源数组
private final static int [] BG_FIRST_RESOURCES = new int [] {
R.drawable.list_yellow_up,
R.drawable.list_blue_up,
R.drawable.list_white_up,
R.drawable.list_green_up,
R.drawable.list_red_up
};
// 定义不同颜色背景的列表正常项资源数组
private final static int [] BG_NORMAL_RESOURCES = new int [] {
R.drawable.list_yellow_middle,
R.drawable.list_blue_middle,
R.drawable.list_white_middle,
R.drawable.list_green_middle,
R.drawable.list_red_middle
};
// 定义不同颜色背景的列表最后一项资源数组
private final static int [] BG_LAST_RESOURCES = new int [] {
R.drawable.list_yellow_down,
R.drawable.list_blue_down,
R.drawable.list_white_down,
R.drawable.list_green_down,
R.drawable.list_red_down,
};
// 定义不同颜色背景的列表单项资源数组（用于只有一个条目时）
private final static int [] BG_SINGLE_RESOURCES = new int [] {
R.drawable.list_yellow_single,
R.drawable.list_blue_single,
R.drawable.list_white_single,
R.drawable.list_green_single,
R.drawable.list_red_single
};
// 根据颜色ID获取对应的列表第一项背景资源
public static int getNoteBgFirstRes(int id) {
return BG_FIRST_RESOURCES[id];
}
// 根据颜色ID获取对应的列表最后一项背景资源
public static int getNoteBgLastRes(int id) {
return BG_LAST_RESOURCES[id];
}
// 根据颜色ID获取对应的列表单项背景资源
public static int getNoteBgSingleRes(int id) {
return BG_SINGLE_RESOURCES[id];
}
// 根据颜色ID获取对应的列表正常项背景资源
public static int getNoteBgNormalRes(int id) {
return BG_NORMAL_RESOURCES[id];
}
// 获取文件夹背景资源
public static int getFolderBgRes() {
return R.drawable.list_folder;
}
}
// 内部类，用于管理小部件背景资源
public static class WidgetBgResources {
// 定义不同颜色背景的小部件2x大小资源数组
private final static int [] BG_2X_RESOURCES = new int [] {
R.drawable.widget_2x_yellow,
R.drawable.widget_2x_blue,
R.drawable.widget_2x_white,
R.drawable.widget_2x_green,
R.drawable.widget_2x_red,
};
// 根据颜色ID获取对应的小部件2x大小背景资源
public static int getWidget2xBgResource(int id) {
return BG_2X_RESOURCES[id];
}
// 定义不同颜色背景的小部件4x大小资源数组
private final static int [] BG_4X_RESOURCES = new int [] {
R.drawable.widget_4x_yellow,
R.drawable.widget_4x_blue,
R.drawable.widget_4x_white,
R.drawable.widget_4x_green,
R.drawable.widget_4x_red
};
// 根据颜色ID获取对应的小部件4x大小背景资源
public static int getWidget4xBgResource(int id) {
return BG_4X_RESOURCES[id];
}
}
// 内部类，用于管理文本外观资源
public static class TextAppearanceResources {
// 定义不同字体大小的文本外观资源数组
private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
R.style.TextAppearanceNormal,
R.style.TextAppearanceMedium,
R.style.TextAppearanceLarge,
R.style.TextAppearanceSuper
};
// 根据字体大小ID获取对应的文本外观资源
// 注意：这里有一个检查，如果ID超出资源数组长度，则返回默认字体大小ID
public static int getTexAppearanceResource(int id) {
if (id >= TEXTAPPEARANCE_RESOURCES.length) {
return BG_DEFAULT_FONT_SIZE;
}
return TEXTAPPEARANCE_RESOURCES[id];
}
// 获取文本外观资源数组的大小
public static int getResourcesSize() {
return TEXTAPPEARANCE_RESOURCES.length;
}
}
}

199
SqlData.java
Unescape View File

@ -1,199 +0,0 @@
/*
* 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.content.ContentResolver;
import android.content.ContentUris;
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.DataConstants;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.NotesDatabaseHelper.TABLE;
import net.micode.notes.gtask.exception.ActionFailureException;
import org.json.JSONException;
import org.json.JSONObject;
// SqlData类，可能用于处理与数据库相关的数据操作，比如从数据库读取数据、将数据更新到数据库以及和JSON数据的相互转换等
public class SqlData {
// 用于日志记录的标签，使用类的简单名称，方便在日志中识别该类相关的输出信息
private static final String TAG = SqlData.class.getSimpleName();
// 定义一个表示无效ID的值，可能用于初始化或者标记不符合要求的ID情况
private static final int INVALID_ID = -99999;
// 定义查询数据时要获取的列名数组，用于指定从数据库获取哪些字段的数据
public static final String[] PROJECTION_DATA = new String[] {
DataColumns.ID, DataColumns.MIME_TYPE, DataColumns.CONTENT, DataColumns.DATA1,
DataColumns.DATA3
};
// 表示在查询结果游标中数据ID列的索引位置，方便从游标中获取对应的数据
public static final int DATA_ID_COLUMN = 0;
// 表示在查询结果游标中数据MIME类型列的索引位置
public static final int DATA_MIME_TYPE_COLUMN = 1;
// 表示在查询结果游标中数据内容列的索引位置
public static final int DATA_CONTENT_COLUMN = 2;
// 表示在查询结果游标中数据特定内容字段DATA1列的索引位置
public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
// 表示在查询结果游标中数据特定内容字段DATA3列的索引位置
public static final int DATA_CONTENT_DATA_3_COLUMN = 4;
// 用于操作内容提供器，实现和数据库的数据交互，比如查询、插入、更新等操作
private ContentResolver mContentResolver;
// 标记是否是创建操作的标志位，true表示正在创建新数据，初始化为true
private boolean mIsCreate;
// 存储数据的ID，初始化为无效ID值
private long mDataId;
// 存储数据的MIME类型，初始化为默认的笔记类型（从DataConstants.NOTE获取）
private String mDataMimeType;
// 存储数据的内容，初始化为空字符串
private String mDataContent;
// 存储数据内容中特定的长整型数据（对应DATA1字段），初始化为0
private long mDataContentData1;
// 存储数据内容中特定的字符串数据（对应DATA3字段），初始化为空字符串
private String mDataContentData3;
// 用于存放要更新到数据库的数据值，类似一个键值对集合，方便批量更新操作
private ContentValues mDiffDataValues;
// 构造函数，传入上下文用于获取内容提供器，初始化相关成员变量，通常用于创建新数据的情况
public SqlData(Context context) {
mContentResolver = context.getContentResolver();
mIsCreate = true;
mDataId = INVALID_ID;
mDataMimeType = DataConstants.NOTE;
mDataContent = "";
mDataContentData1 = 0;
mDataContentData3 = "";
mDiffDataValues = new ContentValues();
}
// 另一个构造函数，传入上下文和游标，用于从已有的游标数据中加载信息初始化成员变量，通常用于读取现有数据的情况
public SqlData(Context context, Cursor c) {
mContentResolver = context.getContentResolver();
mIsCreate = false;
loadFromCursor(c);
mDiffDataValues = new ContentValues();
}
// 从游标中加载数据到成员变量的私有方法，按照定义好的列索引位置获取对应的数据赋值给成员变量
private void loadFromCursor(Cursor c) {
mDataId = c.getLong(DATA_ID_COLUMN);
mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
mDataContent = c.getString(DATA_CONTENT_COLUMN);
mDataContentData1 = c.getLong(DATA_CONTENT_DATA_1_COLUMN);
mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
}
// 根据传入的JSON对象设置相关数据成员变量，并将有变化的数据放入mDiffDataValues中，用于后续更新数据库操作
public void setContent(JSONObject js) throws JSONException {
long dataId = js.has(DataColumns.ID)? js.getLong(DataColumns.ID) : INVALID_ID;
if (mIsCreate || mDataId!= dataId) {
mDiffDataValues.put(DataColumns.ID, dataId);
}
mDataId = dataId;
String dataMimeType = js.has(DataColumns.MIME_TYPE)? js.getString(DataColumns.MIME_TYPE)
: DataConstants.NOTE;
if (mIsCreate ||!mDataMimeType.equals(dataMimeType)) {
mDiffDataValues.put(DataColumns.MIME_TYPE, dataMimeType);
}
mDataMimeType = dataMimeType;
String dataContent = js.has(DataColumns.CONTENT)? js.getString(DataColumns.CONTENT) : "";
if (mIsCreate ||!mDataContent.equals(dataContent)) {
mDiffDataValues.put(DataColumns.CONTENT, dataContent);
}
mDataContent = dataContent;
long dataContentData1 = js.has(DataColumns.DATA1)? js.getLong(DataColumns.DATA1) : 0;
if (mIsCreate || mDataContentData1!= dataContentData1) {
mDiffDataValues.put(DataColumns.DATA1, dataContentData1);
}
mDataContentData1 = dataContentData1;
String dataContentData3 = js.has(DataColumns.DATA3)? js.getString(DataColumns.DATA3) : "";
if (mIsCreate ||!mDataContentData3.equals(dataContentData3)) {
mDiffDataValues.put(DataColumns.DATA3, dataContentData3);
}
mDataContentData3 = dataContentData3;
}
// 根据当前成员变量的数据生成对应的JSON对象，若处于创建状态则记录错误日志并返回null
public JSONObject getContent() throws JSONException {
if (mIsCreate) {
Log.e(TAG, "it seems that we haven't created this in database yet");
return null;
}
JSONObject js = new JSONObject();
js.put(DataColumns.ID, mDataId);
js.put(DataColumns.MIME_TYPE, mDataMimeType);
js.put(DataColumns.CONTENT, mDataContent);
js.put(DataColumns.DATA1, mDataContentData1);
js.put(DataColumns.DATA3, mDataContentData3);
return js;
}
// 将数据提交到数据库的方法，根据是否是创建操作执行不同的逻辑，创建则插入数据，否则根据条件更新数据
public void commit(long noteId, boolean validateVersion, long version) {
if (mIsCreate) {
if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
mDiffDataValues.remove(DataColumns.ID);
}
mDiffDataValues.put(DataColumns.NOTE_ID, noteId);
Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues);
try {
mDataId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
Log.e(TAG, "Get note id error :" + e.toString());
throw new ActionFailureException("create note failed");
}
} else {
if (mDiffDataValues.size() > 0) {
int result = 0;
if (!validateVersion) {
result = mContentResolver.update(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues, null, null);
} else {
result = mContentResolver.update(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues,
"? in (SELECT " + NoteColumns.ID + " FROM " + TABLE.NOTE
+ " WHERE " + NoteColumns.VERSION + "=?)", new String[] {
String.valueOf(noteId), String.valueOf(version)
});
}
if (result == 0) {
Log.w(TAG, "there is no update. maybe user updates note when syncing");
}
}
}
mDiffDataValues.clear();
mIsCreate = false;
}
// 获取数据ID的方法，外部可调用此方法获取当前对象关联的数据ID
public long getId() {
return mDataId;
}
}

670
SqlNote.java
Unescape View File

@ -1,670 +0,0 @@
/*
* 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;
public class SqlNote {
// 定义一个用于日志记录的标签，其值为类的简单名称（不含包名部分），方便在查看日志时能快速识别与该类相关的输出信息
private static final String TAG = SqlNote.class.getSimpleName();
// 定义一个表示无效的ID值，通常用于初始化成员变量或者在某些逻辑判断中表示不符合要求、尚未正确赋值的ID情况，这里设定为 -99999
private static final int INVALID_ID = -99999;
// 定义一个字符串数组，用于指定查询笔记信息时从数据库中要获取的列名列表，涵盖了笔记的各种属性字段，如ID、提醒日期、背景颜色ID等
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
};
// 定义一个常量，表示在查询结果游标（Cursor）中笔记ID列对应的索引位置，方便后续从游标中准确获取该列数据，值为0，对应上述PROJECTION_NOTE数组中的顺序
public static final int ID_COLUMN = 0;
// 定义一个常量，表示在查询结果游标中提醒日期列对应的索引位置，用于从游标获取对应数据，值为1
public static final int ALERTED_DATE_COLUMN = 1;
// 定义一个常量，表示在查询结果游标中背景颜色ID列对应的索引位置，便于提取相应数据，值为2
public static final int BG_COLOR_ID_COLUMN = 2;
// 定义一个常量，表示在查询结果游标中创建日期列对应的索引位置，用于获取创建时间相关数据，值为3
public static final int CREATED_DATE_COLUMN = 3;
// 定义一个常量，表示在查询结果游标中是否有附件列对应的索引位置，用于判断笔记是否包含附件，值为4
public static final int HAS_ATTACHMENT_COLUMN = 4;
// 定义一个常量，表示在查询结果游标中修改日期列对应的索引位置，用于获取笔记最后修改时间信息，值为5
public static final int MODIFIED_DATE_COLUMN = 5;
// 定义一个常量，表示在查询结果游标中笔记数量列对应的索引位置（可能用于表示文件夹下包含笔记的数量等情况），值为6
public static final int NOTES_COUNT_COLUMN = 6;
// 定义一个常量，表示在查询结果游标中父级ID列对应的索引位置，用于确定笔记在层级结构中的位置，即父级的标识，值为7
public static final int PARENT_ID_COLUMN = 7;
// 定义一个常量，表示在查询结果游标中摘要（或文本内容片段）列对应的索引位置，用于获取笔记相关的文本摘要信息，值为8
public static final int SNIPPET_COLUMN = 8;
// 定义一个常量，表示在查询结果游标中笔记类型列对应的索引位置，用于区分不同类型的笔记（比如普通笔记、文件夹类型等），值为9
public static final int TYPE_COLUMN = 9;
// 定义一个常量，表示在查询结果游标中小部件ID列对应的索引位置，可能用于关联笔记与桌面小部件相关的操作，值为10
public static final int WIDGET_ID_COLUMN = 10;
// 定义一个常量，表示在查询结果游标中小部件类型列对应的索引位置，用于区分不同样式、功能的小部件，值为11
public static final int WIDGET_TYPE_COLUMN = 11;
// 定义一个常量，表示在查询结果游标中同步ID列对应的索引位置，通常在数据同步相关操作中用于标识，值为12
public static final int SYNC_ID_COLUMN = 12;
// 定义一个常量，表示在查询结果游标中本地是否修改列对应的索引位置，用于判断本地对笔记数据是否有修改，值为13
public static final int LOCAL_MODIFIED_COLUMN = 13;
// 定义一个常量，表示在查询结果游标中原始父级ID列对应的索引位置，可能用于记录笔记在某些操作之前的原始归属情况，值为14
public static final int ORIGIN_PARENT_ID_COLUMN = 14;
// 定义一个常量，表示在查询结果游标中Google Tasks相关ID列对应的索引位置，可能用于和Google Tasks服务进行关联操作，值为15
public static final int GTASK_ID_COLUMN = 15;
// 定义一个常量，表示在查询结果游标中版本列对应的索引位置，用于跟踪笔记数据的版本变化情况，值为16
public static final int VERSION_COLUMN = 16;
// 保存传入的上下文对象（Context），通过它可以访问系统资源、服务等，例如获取内容提供器（ContentResolver）来操作数据库
private Context mContext;
// 用于与安卓的内容提供器进行交互，实现对数据库的查询、插入、更新等操作，比如获取笔记数据或者将笔记数据保存到数据库中
private ContentResolver mContentResolver;
// 一个布尔类型的标志位，用于标记当前操作是创建新笔记（true）还是对已有笔记进行操作（false），初始化为true，表示创建情况
private boolean mIsCreate;
// 用于存储笔记的唯一标识符（ID），初始化为无效ID值（INVALID_ID），后续会根据实际情况进行赋值或者更新
private long mId;
// 用于存储笔记的提醒日期，以时间戳的形式表示（通常是从某个特定时间点开始到提醒时间所经过的毫秒数），初始化为0
private long mAlertDate;
// 用于存储笔记的背景颜色ID，初始值通过ResourceParser获取默认背景色ID来赋值，可能用于设置笔记的显示外观相关功能
private int mBgColorId;
// 用于存储笔记的创建日期，以时间戳形式记录创建时刻，初始化为当前系统时间（调用System.currentTimeMillis()获取）
private long mCreatedDate;
// 用于存储表示笔记是否有附件的标志，0表示没有附件，初始化为0，根据实际情况后续可能会被修改
private int mHasAttachment;
// 用于存储笔记的最后修改日期，同样以时间戳形式表示，初始化为当前系统时间，方便跟踪笔记内容的更新情况
private long mModifiedDate;
// 用于存储笔记的父级ID，用于构建笔记的层级结构，比如笔记属于哪个文件夹等情况，初始化为0
private long mParentId;
// 用于存储笔记的摘要（或文本内容片段），初始化为空字符串，可能是笔记内容的简短描述等，后续可根据实际情况更新
private String mSnippet;
// 用于存储笔记的类型，通过Notes.TYPE_NOTE等常量来区分不同类型（如普通笔记、文件夹等），初始化为普通笔记类型（Notes.TYPE_NOTE）
private int mType;
// 用于存储笔记关联的小部件ID，初始化为AppWidgetManager.INVALID_APPWIDGET_ID，表示无效的小部件ID，在有实际关联小部件时会被更新
private int mWidgetId;
// 用于存储笔记关联的小部件类型，初始化为Notes.TYPE_WIDGET_INVALIDE，表示无效的小部件类型，根据实际使用情况会改变
private int mWidgetType;
// 用于存储笔记的原始父级ID，可能用于记录笔记在某些操作之前的归属情况，初始化为0，在特定业务场景下会被更新
private long mOriginParent;
// 用于存储笔记的版本号，初始化为0，用于跟踪笔记数据的版本变化，例如每次更新后版本号可能会递增
private long mVersion;
// 用于存放要更新到数据库的笔记相关数据值，是一种键值对形式的集合（类似Map），可以批量设置要更新的字段和对应的值，方便数据库更新操作
private ContentValues mDiffNoteValues;
// 定义一个ArrayList，用于存储与该笔记相关的具体数据列表，每个元素是SqlData类型的对象，可能一条笔记对应多条相关的数据记录
private ArrayList<SqlData> mDataList;
// 构造函数，用于创建新笔记时的初始化操作，设置各种成员变量的初始值，例如默认的创建日期、初始的标志位等，为后续创建笔记流程做准备
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;
mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
mOriginParent = 0;
mVersion = 0;
mDiffNoteValues = new ContentValues();
mDataList = new ArrayList<SqlData>();
}
// 构造函数，用于从已有的游标（Cursor）数据中加载笔记信息，通常是在查询数据库获取笔记记录后进行初始化操作，设置相关成员变量，并根据笔记类型决定是否加载具体数据内容
public SqlNote(Context context, Cursor c) {
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = false;
loadFromCursor(c);
mDataList = new ArrayList<SqlData>();
if (mType == Notes.TYPE_NOTE)
loadDataContent();
mDiffNoteValues = new ContentValues();
}
// 构造函数，根据给定的笔记ID从数据库加载笔记信息，先通过查询获取游标，再调用loadFromCursor方法来加载具体数据到成员变量中，同样根据笔记类型决定是否加载相关数据内容
public SqlNote(Context context, long id) {
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = false;
loadFromCursor(id);
mDataList = new ArrayList<SqlData>();
if (mType == Notes.TYPE_NOTE)
loadDataContent();
mDiffNoteValues = new ContentValues();
}
// 根据给定的笔记ID从数据库查询并加载笔记信息到成员变量的私有方法，先发起数据库查询获取游标对象，若游标不为空则移动到第一条记录并继续调用loadFromCursor(Cursor c)方法进行具体数据加载，同时处理游标为空的情况并记录日志
private void loadFromCursor(long id) {
Cursor c = null;
try {
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 {
if (c!= null)
c.close();
}
}
// 从给定的游标（Cursor）中加载笔记各字段数据到对应的成员变量的私有方法，按照之前定义好的列索引位置（如ID_COLUMN等常量），从游标中获取相应数据并赋值给成员变量，实现数据的提取和初始化
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);
}
// 加载与该笔记相关的数据内容的私有方法，通过向数据库发起查询，获取与该笔记ID关联的数据记录（通过note_id字段关联），若查询到记录则循环创建SqlData对象并添加到mDataList列表中，同时处理查询结果为空以及游标关闭等情况并记录日志
private void loadDataContent() {
Cursor c = null;
mDataList.clear();
try {
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;
}
while (c.moveToNext()) {
SqlData data = new SqlData(mContext, c);
mDataList.add(data);
}
} else {
Log.w(TAG, "loadDataContent: cursor = null");
}
} finally {
if (c!= null)
c.close();
}
}
// setContent方法用于根据传入的JSONObject对象来设置当前SqlNote对象的各项属性值。
// 它会根据笔记的不同类型（系统、文件夹、普通笔记）进行相应的属性更新操作，若解析JSON出现异常则返回false。
public boolean setContent(JSONObject js) {
try {
// 从传入的JSON对象（js）中获取名为GTaskStringUtils.META_HEAD_NOTE的子JSON对象，
// 这个子对象预期包含了笔记主体相关的属性信息，比如类型、ID、摘要等关键内容。
JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
// 判断笔记类型是否为系统类型（Notes.TYPE_SYSTEM），如果是，则记录一条警告日志，表示不能设置系统文件夹类型的笔记内容，然后直接返回，不进行后续操作。
if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
Log.w(TAG, "cannot set system folder");
} else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
// 如果笔记类型是文件夹类型（Notes.TYPE_FOLDER），在此分支下，只允许更新笔记的摘要（snippet）和类型（type）这两个属性。
// 尝试获取笔记摘要字段（NoteColumns.SNIPPET）的值，如果该字段在JSON对象中存在，则获取对应的值，否则将其设为空字符串。
String snippet = note.has(NoteColumns.SNIPPET)? note.getString(NoteColumns.SNIPPET) : "";
// 判断当前操作是否为创建操作（mIsCreate为true），或者当前笔记的摘要与传入的摘要不一致。
// 如果满足条件，则将新的摘要值放入mDiffNoteValues中，这个mDiffNoteValues是用于后续更新数据库操作的键值对集合，
// 键为NoteColumns.SNIPPET，值为新的摘要内容，以此来标记该字段有更新变动，需要同步到数据库中。
if (mIsCreate ||!mSnippet.equals(snippet)) {
mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
}
// 更新当前SqlNote对象的摘要字段值，使其与传入的摘要内容保持一致，便于后续使用该对象时获取到最新的摘要信息。
mSnippet = snippet;
// 尝试获取笔记类型字段（NoteColumns.TYPE）的值，如果该字段在JSON对象中存在，则获取对应的值，否则将其设为默认的普通笔记类型（Notes.TYPE_NOTE）。
int type = note.has(NoteColumns.TYPE)? note.getInt(NoteColumns.TYPE) : Notes.TYPE_NOTE;
// 判断当前操作是否为创建操作或者当前笔记的类型与传入的类型不一致。
// 如果满足条件，则将新的类型值放入mDiffNoteValues中，键为NoteColumns.TYPE，用于后续数据库更新操作，标记类型字段有变化。
if (mIsCreate || mType!= type) {
mDiffNoteValues.put(NoteColumns.TYPE, type);
}
// 更新当前SqlNote对象的类型字段值，使其与传入的类型保持一致，确保对象状态反映最新的类型设定。
mType = type;
} else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
// 如果笔记类型是普通笔记类型（Notes.TYPE_NOTE），则进行一系列详细的属性更新操作。
// 从传入的JSON对象（js）中获取名为GTaskStringUtils.META_HEAD_DATA的JSON数组，
// 该数组预期包含了与该普通笔记相关的多条具体数据内容，比如可能是笔记正文的不同部分等具体信息。
JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
// 尝试获取笔记ID字段（NoteColumns.ID）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为无效ID（INVALID_ID）。
long id = note.has(NoteColumns.ID)? note.getLong(NoteColumns.ID) : INVALID_ID;
// 判断当前操作是否为创建操作或者当前笔记的ID与传入的ID不一致。
// 如果满足条件，则将新的ID值放入mDiffNoteValues中，键为NoteColumns.ID，以便后续在更新数据库时，能将新ID同步过去，标记ID字段有变化。
if (mIsCreate || mId!= id) {
mDiffNoteValues.put(NoteColumns.ID, id);
}
// 更新当前SqlNote对象的ID字段值，使其与传入的ID保持一致，保证对象内记录的笔记ID是最新的。
mId = id;
// 尝试获取笔记提醒日期字段（NoteColumns.ALERTED_DATE）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为0。
long alertDate = note.has(NoteColumns.ALERTED_DATE)? note.getLong(NoteColumns.ALERTED_DATE) : 0;
// 判断当前操作是否为创建操作或者当前笔记的提醒日期与传入的提醒日期不一致。
// 如果满足条件，则将新的提醒日期值放入mDiffNoteValues中，键为NoteColumns.ALERTED_DATE，用于后续数据库更新，标记提醒日期字段有变化。
if (mIsCreate || mAlertDate!= alertDate) {
mDiffNoteValues.put(NoteColumns.ALERTED_DATE, alertDate);
}
// 更新当前SqlNote对象的提醒日期字段值，使其与传入的提醒日期保持一致，确保对象内记录的提醒日期是最新的。
mAlertDate = alertDate;
// 尝试获取笔记背景颜色ID字段（NoteColumns.BG_COLOR_ID）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，
// 否则通过ResourceParser获取默认背景色ID作为该字段的值，这意味着如果JSON中未指定背景色，会使用默认设定。
int bgColorId = note.has(NoteColumns.BG_COLOR_ID)? note.getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
// 判断当前操作是否为创建操作或者当前笔记的背景颜色ID与传入的背景颜色ID不一致。
// 如果满足条件，则将新的背景颜色ID值放入mDiffNoteValues中，键为NoteColumns.BG_COLOR_ID，用于后续数据库更新，标记背景色字段有变化。
if (mIsCreate || mBgColorId!= bgColorId) {
mDiffNoteValues.put(NoteColumns.BG_COLOR_ID, bgColorId);
}
// 更新当前SqlNote对象的背景颜色ID字段值，使其与传入的背景颜色ID保持一致，保证对象内记录的背景色信息是最新的。
mBgColorId = bgColorId;
// 尝试获取笔记创建日期字段（NoteColumns.CREATED_DATE）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，
// 否则将其设为当前系统时间（通过System.currentTimeMillis()获取），这表示如果JSON中未指定创建日期，就使用当前时间作为默认值。
long createDate = note.has(NoteColumns.CREATED_DATE)? note.getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
// 判断当前操作是否为创建操作或者当前笔记的创建日期与传入的创建日期不一致。
// 如果满足条件，则将新的创建日期值放入mDiffNoteValues中，键为NoteColumns.CREATED_DATE，用于后续数据库更新，标记创建日期字段有变化。
if (mIsCreate || mCreatedDate!= createDate) {
mDiffNoteValues.put(NoteColumns.CREATED_DATE, createDate);
}
// 更新当前SqlNote对象的创建日期字段值，使其与传入的创建日期保持一致，确保对象内记录的创建时间是最新的。
mCreatedDate = createDate;
// 尝试获取笔记是否有附件字段（NoteColumns.HAS_ATTACHMENT）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为0（表示无附件）。
int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT)? note.getInt(NoteColumns.HAS_ATTACHMENT) : 0;
// 判断当前操作是否为创建操作或者当前笔记的是否有附件标识与传入的标识不一致。
// 如果满足条件，则将新的是否有附件值放入mDiffNoteValues中，键为NoteColumns.HAS_ATTACHMENT，用于后续数据库更新，标记附件标识字段有变化。
if (mIsCreate || mHasAttachment!= hasAttachment) {
mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT, hasAttachment);
}
// 更新当前SqlNote对象的是否有附件字段值，使其与传入的附件标识保持一致，保证对象内记录的附件情况是最新的。
mHasAttachment = hasAttachment;
// 尝试获取笔记修改日期字段（NoteColumns.MODIFIED_DATE）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，
// 否则将其设为当前系统时间，意味着如果JSON中未指定修改日期，就使用当前时间作为默认值，方便记录最后修改时间。
long modifiedDate = note.has(NoteColumns.MODIFIED_DATE)? note.getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
// 判断当前操作是否为创建操作或者当前笔记的修改日期与传入的修改日期不一致。
// 如果满足条件，则将新的修改日期值放入mDiffNoteValues中，键为NoteColumns.MODIFIED_DATE，用于后续数据库更新，标记修改日期字段有变化。
if (mIsCreate || mModifiedDate!= modifiedDate) {
mDiffNoteValues.put(NoteColumns.MODIFIED_DATE, modifiedDate);
}
// 更新当前SqlNote对象的修改日期字段值，使其与传入的修改日期保持一致，确保对象内记录的最后修改时间是最新的。
mModifiedDate = modifiedDate;
// 尝试获取笔记父级ID字段（NoteColumns.PARENT_ID）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为0。
long parentId = note.has(NoteColumns.PARENT_ID)? note.getLong(NoteColumns.PARENT_ID) : 0;
// 判断当前操作是否为创建操作或者当前笔记的父级ID与传入的父级ID不一致。
// 如果满足条件，则将新的父级ID值放入mDiffNoteValues中，键为NoteColumns.PARENT_ID，用于后续数据库更新，标记父级ID字段有变化。
if (mIsCreate || mParentId!= parentId) {
mDiffNoteValues.put(NoteColumns.PARENT_ID, parentId);
}
// 更新当前SqlNote对象的父级ID字段值，使其与传入的父级ID保持一致，保证对象内记录的笔记层级关系是准确的。
mParentId = parentId;
// 再次尝试获取笔记摘要字段（NoteColumns.SNIPPET）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为空字符串。
String snippet = note.has(NoteColumns.SNIPPET)? note.getString(NoteColumns.SNIPPET) : "";
// 判断当前操作是否为创建操作或者当前笔记的摘要与传入的摘要不一致。
// 如果满足条件，则将新的摘要值放入mDiffNoteValues中，键为NoteColumns.SNIPPET，用于后续数据库更新，标记摘要字段有变化。
if (mIsCreate ||!mSnippet.equals(snippet)) {
mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
}
// 更新当前SqlNote对象的摘要字段值，使其与传入的摘要内容保持一致，便于后续使用该对象时获取到最新的摘要信息。
mSnippet = snippet;
// 再次尝试获取笔记类型字段（NoteColumns.TYPE）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为默认的普通笔记类型（Notes.TYPE_NOTE）。
int type = note.has(NoteColumns.TYPE)? note.getInt(NoteColumns.TYPE) : Notes.TYPE_NOTE;
// 判断当前操作是否为创建操作或者当前笔记的类型与传入的类型不一致。
// 如果满足条件，则将新的类型值放入mDiffNoteValues中，键为NoteColumns.TYPE，用于后续数据库更新，标记类型字段有变化。
if (mIsCreate || mType!= type) {
mDiffNoteValues.put(NoteColumns.TYPE, type);
}
// 更新当前SqlNote对象的类型字段值，使其与传入的类型保持一致，确保对象状态反映最新的类型设定。
mType = type;
// 尝试获取笔记小部件ID字段（NoteColumns.WIDGET_ID）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，
// 否则将其设为无效的小部件ID（AppWidgetManager.INVALID_APPWIDGET_ID），这表示如果JSON中未指定小部件ID，就使用默认的无效标识。
int widgetId = note.has(NoteColumns.WIDGET_ID)? note.getInt(NoteColumns.WIDGET_ID) : AppWidgetManager.INVALID_APPWIDGET_ID;
// 判断当前操作是否为创建操作或者当前笔记的小部件ID与传入的小部件ID不一致。
// 如果满足条件，则将新的小部件ID值放入mDiffNoteValues中，键为NoteColumns.WIDGET_ID，用于后续数据库更新，标记小部件ID字段有变化。
if (mIsCreate || mWidgetId!= widgetId) {
mDiffNoteValues.put(NoteColumns.WIDGET_ID, widgetId);
}
// 更新当前SqlNote对象的小部件ID字段值，使其与传入的小部件ID保持一致，保证对象内记录的小部件关联信息是最新的。
mWidgetId = widgetId;
// 尝试获取笔记小部件类型字段（NoteColumns.WIDGET_TYPE）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，
// 否则将其设为无效的小部件类型（Notes.TYPE_WIDGET_INVALIDE），即如果JSON中未指定小部件类型，就使用默认的无效类型标识。
int widgetType = note.has(NoteColumns.WIDGET_TYPE)? note.getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
// 判断当前操作是否为创建操作或者当前笔记的小部件类型与传入的小部件类型不一致。
// 如果满足条件，则将新的小部件类型值放入mDiffNoteValues中，键为NoteColumns.WIDGET_TYPE，用于后续数据库更新，标记小部件类型字段有变化。
if (mIsCreate || mWidgetType!= widgetType) {
mDiffNoteValues.put(NoteColumns.WIDGET_TYPE, widgetType);
}
// 更新当前SqlNote对象的小部件类型字段值，使其与传入的小部件类型保持一致，确保对象内记录的小部件类型信息是最新的。
mWidgetType = widgetType;
// 尝试获取笔记原始父级ID字段（NoteColumns.ORIGIN_PARENT_ID）的值，如果该字段在JSON对象（note）中存在，则获取对应的值，否则将其设为0。
long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID)? note.getLong(NoteColumns.ORIGIN_PACTER_ID) : 0;
// 判断当前操作是否为创建操作或者当前笔记的原始父级ID与传入的原始父级ID不一致。
// 如果满足条件，则将新的原始父级ID值放入mDiffNoteValues中，键为NoteColumns.ORIGIN_PARENT_ID，用于后续数据库更新，标记原始父级ID字段有变化。
if (mIsCreate || mOriginParent!= originParent) {
mDiffNoteValues.put(NoteColumns.ORIGIN_PARENT_ID, originParent);
}
// 更新当前SqlNote对象的原始父级ID字段值，使其与传入的原始父级ID保持一致，保证对象内记录的原始层级关系信息是准确的。
mOriginParent = originParent;
// 遍历GTaskStringUtils.META_HEAD_DATA数组中的每一个JSON对象（即遍历与该普通笔记相关的每一条具体数据内容）。
for (int i = 0; i < dataArray.length(); i++) {
JSONObject data = dataArray.getJSONObject(i);
SqlData sqlData = null;
// 如果当前具体数据对象（data）中包含DataColumns.ID字段，说明该数据有对应的唯一标识。
if (data.has(DataColumns.ID)) {
long dataId = data.getLong(DataColumns.ID);
// 在当前SqlNote对象关联的mDataList列表中查找是否已存在具有相同ID的SqlData对象，
// mDataList可能存储了与该笔记相关的多条具体数据记录对应的SqlData对象实例。
for (SqlData temp : mDataList) {
if (dataId == temp.getId()) {
sqlData = temp;
}
}
}
// 如果在mDataList中未找到对应的SqlData对象（即当前遍历的数据是新的，之前不存在关联的SqlData实例），
// 则创建一个新的SqlData对象，传入当前上下文（mContext），用于后续操作该数据相关内容。
if (sqlData == null) {
sqlData = new SqlData(mContext);
mDataList.add(sqlData);
}
// 调用找到或新创建的SqlData对象的setContent方法，将当前遍历到的具体数据内容（data）传递进去，
sqlData.setContent(data);
}
}
} catch (JSONException e) {
Log.e(TAG, e.toString());
e.printStackTrace();
return false;
}
return true;
}
// getContent方法用于将当前SqlNote对象的相关属性及数据内容转换为JSONObject格式返回，
// 如果当前对象处于创建状态（尚未在数据库中创建完成），则记录错误日志并返回null，若在构建JSON过程中出现异常也返回null。
public JSONObject getContent() {
try {
// 创建一个新的JSONObject对象，用于组装并最终返回包含笔记相关信息的JSON数据结构。
JSONObject js = new JSONObject();
// 判断当前笔记是否处于创建状态（mIsCreate为true表示正在创建，还未真正在数据库中创建好），
// 如果是创建状态，则记录一条错误日志，表示还未在数据库中创建该笔记，然后直接返回null，因为此时还没有完整有效的数据可供返回。
if (mIsCreate) {
Log.e(TAG, "it seems that we haven't created this in database yet");
return null;
}
// 创建一个新的JSONObject对象，用于存放笔记主体相关的属性信息，后续会根据笔记类型往里面添加不同的字段数据。
JSONObject note = new JSONObject();
// 判断当前笔记类型是否为普通笔记类型（Notes.TYPE_NOTE），如果是，则将笔记的多个属性字段及其对应的值添加到note对象中。
if (mType == Notes.TYPE_NOTE) {
// 将笔记的ID字段（NoteColumns.ID）及其对应的值（mId）添加到note对象中，这样在生成的JSON数据中就包含了笔记的唯一标识符信息。
note.put(NoteColumns.ID, mId);
// 将笔记的提醒日期字段（NoteColumns.ALERTED_DATE）及其对应的值（mAlertDate）添加到note对象中，用于表示笔记是否有提醒以及提醒的时间信息（以时间戳形式等）。
note.put(NoteColumns.ALERTED_DATE, mAlertDate);
// 将笔记的背景颜色ID字段（NoteColumns.BG_COLOR_ID）及其对应的值（mBgColorId）添加到note对象中，方便后续在展示等场景中设置笔记的背景颜色。
note.put(NoteColumns.BG_COLOR_ID, mBgColorId);
// 将笔记的创建日期字段（NoteColumns.CREATED_DATE）及其对应的值（mCreatedDate）添加到note对象中，记录笔记最初创建的时间信息（以时间戳形式）。
note.put(NoteColumns.CREATED_DATE, mCreatedDate);
// 将笔记是否有附件字段（NoteColumns.HAS_ATTACHMENT）及其对应的值（mHasAttachment）添加到note对象中，用于标识该笔记是否关联了附件（比如文件等）。
note.put(NoteColumns.HAS_ATTACHMENT, mHasAttachment);
// 将笔记的修改日期字段（NoteColumns.MODIFIED_DATE）及其对应的值（mModifiedDate）添加到note对象中，方便追踪笔记最后一次被修改的时间情况（以时间戳形式）。
note.put(NoteColumns.MODIFIED_DATE, mModifiedDate);
// 将笔记的父级ID字段（NoteColumns.PARENT_ID）及其对应的值（mParentId）添加到note对象中，用于构建笔记的层级结构关系，比如属于哪个文件夹等情况。
note.put(NoteColumns.PARENT_ID, mParentId);
// 将笔记的摘要字段（NoteColumns.SNIPPET）及其对应的值（mSnippet）添加到note对象中，摘要可能是笔记内容的简短描述等，方便快速预览笔记大致内容。
note.put(NoteColumns.SNIPPET, mSnippet);
// 将笔记的类型字段（NoteColumns.TYPE）及其对应的值（mType）添加到note对象中，再次明确笔记的类型，虽然前面已经通过条件判断知道是普通笔记类型，但这里是完整的数据组装。
note.put(NoteColumns.TYPE, mType);
// 将笔记的小部件ID字段（NoteColumns.WIDGET_ID）及其对应的值（mWidgetId）添加到note对象中，可能用于关联笔记与桌面小部件等相关的操作和展示情况。
note.put(NoteColumns.WIDGET_ID, mWidgetId);
// 将笔记的小部件类型字段（NoteColumns.WIDGET_TYPE）及其对应的值（mWidgetType）添加到note对象中，用于区分不同样式、功能的小部件与笔记的关联情况。
note.put(NoteColumns.WIDGET_TYPE, mWidgetType);
// 将笔记的原始父级ID字段（NoteColumns.ORIGIN_PARENT_ID）及其对应的值（mOriginParent）添加到note对象中，可能用于记录笔记在某些操作之前的原始归属情况等。
note.put(NoteColumns.ORIGIN_PARENT_ID, mOriginParent);
// 将包含笔记主体属性信息的note对象，以GTaskStringUtils.META_HEAD_NOTE为键，添加到外层的js对象中，这样最终生成的JSON数据结构就符合特定的格式要求，方便后续解析使用。
js.put(GTaskStringUtils.META_HEAD_NOTE, note);
// 创建一个新的JSONArray对象，用于存放与该笔记相关的具体数据内容对应的JSON对象，这些具体数据可能是笔记正文的不同部分等详细信息。
JSONArray dataArray = new JSONArray();
// 遍历当前SqlNote对象关联的mDataList列表，mDataList中存放的是与该笔记相关的SqlData类型对象，每个对象代表一部分具体数据内容。
for (SqlData sqlData : mDataList) {
// 调用每个SqlData对象的getContent方法，获取其对应的JSON表示形式（返回一个JSONObject对象），该方法内部会根据SqlData对象自身的属性组装成相应的JSON数据结构。
JSONObject data = sqlData.getContent();
// 判断获取到的JSON对象是否为null，如果不为null，则表示该SqlData对象成功转换为有效的JSON数据，将其添加到dataArray数组中。
if (data!= null) {
dataArray.put(data);
}
}
// 将包含所有具体数据内容JSON对象的dataArray数组，以GTaskStringUtils.META_HEAD_DATA为键，添加到外层的js对象中，完善整个笔记的JSON数据结构，使其包含了主体属性和具体数据两部分内容。
js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
} else if (mType == Notes.TYPE_FOLDER || mType == Notes.TYPE_SYSTEM) {
// 如果笔记类型是文件夹类型（Notes.TYPE_FOLDER）或者系统类型（Notes.TYPE_SYSTEM），则只将笔记的部分关键属性添加到note对象中。
// 将笔记的ID字段（NoteColumns.ID）及其对应的值（mId）添加到note对象中，确保有唯一标识符信息用于区分不同的文件夹或系统对象（如果是系统类型可能有特定用途等）。
note.put(NoteColumns.ID, mId);
// 将笔记的类型字段（NoteColumns.TYPE）及其对应的值（mType）添加到note对象中，明确其是文件夹还是系统类型，方便后续处理逻辑识别。
note.put(NoteColumns.TYPE, mType);
// 将笔记的摘要字段（NoteColumns.SNIPPET）及其对应的值（mSnippet）添加到note对象中，对于文件夹类型可能摘要就是文件夹名称等，方便展示和识别。
note.put(NoteColumns.SNIPPET, mSnippet);
// 将包含关键属性信息的note对象，以GTaskStringUtils.META_HEAD_NOTE为键，添加到外层的js对象中，形成符合特定格式要求的JSON数据结构，虽然相较于普通笔记类型数据内容会少一些，但满足对应类型的需求。
js.put(GTaskStringUtils.META_HEAD_NOTE, note);
}
// 如果整个JSON数据结构组装成功，没有出现异常情况，则返回最终组装好的js对象，该对象包含了符合要求的笔记相关信息的JSON表示形式。
return js;
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject或JSONArray中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题。
Log.e(TAG, e.toString());
e.printStackTrace();
}
// 如果出现异常情况，最终返回null，表示无法成功获取笔记的JSON内容表示形式。
return null;
}
public void setParentId(long id) {
// 设置笔记的父ID，并将其添加到待更新的值中
mParentId = id;
mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
}
public void setGtaskId(String gid) {
// 设置与Google任务同步的ID，并将其添加到待更新的值中
mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
}
public void setSyncId(long syncId) {
// 设置同步ID，并将其添加到待更新的值中
mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId);
}
public void resetLocalModified() {
// 重置本地修改标志
mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0);
}
public long getId() {
// 获取笔记的ID
return mId;
}
public long getParentId() {
// 获取笔记的父ID
return mParentId;
}
public String getSnippet() {
// 获取笔记的摘要
return mSnippet;
}
public boolean isNoteType() {
// 检查笔记是否为普通笔记类型
return mType == Notes.TYPE_NOTE;
}
public void commit(boolean validateVersion) {
// 提交笔记的更改
if (mIsCreate) {
// 如果是创建笔记
if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) {
// 如果ID无效且待更新值中包含ID，则移除它
mDiffNoteValues.remove(NoteColumns.ID);
}
// 插入笔记并获取新插入的笔记ID
Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI, mDiffNoteValues);
try {
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");
}
if (mId == 0) {
// 如果ID为0，则创建失败
throw new IllegalStateException("Create thread id failed");
}
// 如果是普通笔记类型，则提交相关联的数据
if (mType == Notes.TYPE_NOTE) {
for (SqlData sqlData : mDataList) {
sqlData.commit(mId, false, -1);
}
}
} else {
// 如果是更新笔记
if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
// 如果ID无效，则抛出异常
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) {
// 不验证版本号的更新
result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+ NoteColumns.ID + "=?)", new String[] {
String.valueOf(mId)
});
} else {
// 验证版本号的更新
result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
+ NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
new String[] {
String.valueOf(mId), String.valueOf(mVersion)
});
}
if (result == 0) {
// 如果更新结果为0，可能是在同步时用户更新了笔记
Log.w(TAG, "there is no update. maybe user updates note when syncing");
}
}
// 如果是普通笔记类型，则提交相关联的数据
if (mType == Notes.TYPE_NOTE) {
for (SqlData sqlData : mDataList) {
sqlData.commit(mId, validateVersion, mVersion);
}
}
}
// 刷新本地信息
loadFromCursor(mId);
if (mType == Notes.TYPE_NOTE)
loadDataContent();
// 清除待更新的值，并标记为非创建状态
mDiffNoteValues.clear();
mIsCreate = false;
}

496
Task.java
Unescape View File

@ -1,496 +0,0 @@
/*
* 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;
// Task类继承自Node类，用于表示一个任务相关的对象，可能在任务管理等业务场景中使用，包含了任务的一些属性以及操作方法。
public class Task extends Node {
// 定义一个用于日志记录的标签，其值为类的简单名称（不含包名部分），方便在查看日志时能快速识别与该类相关的输出信息。
private static final String TAG = Task.class.getSimpleName();
// 用于标记任务是否已完成的布尔变量，初始值为false，表示任务初始状态是未完成的。
private boolean mCompleted;
// 用于存储任务相关的备注信息（可能是文字描述等内容），初始值为null，后续可以根据实际情况进行赋值。
private String mNotes;
// 用于存储任务的元信息，以JSONObject的形式表示，可能包含一些额外的自定义属性等内容，初始值为null，会按需填充数据。
private JSONObject mMetaInfo;
// 用于指向该任务的前一个兄弟任务（在同一层级的任务列表中，排在当前任务之前的任务对象），初始值为null，若不存在前序兄弟任务则保持为null。
private Task mPriorSibling;
// 用于指向该任务所属的父任务列表（可以理解为包含该任务的集合或者分组），初始值为null，后续会进行相应的赋值关联操作。
private TaskList mParent;
// 无参构造函数，用于创建Task对象时进行默认的初始化操作，调用父类（Node类）的无参构造函数，并对本类的一些成员变量赋初始值。
public Task() {
super();
mCompleted = false;
mNotes = null;
mPriorSibling = null;
mParent = null;
mMetaInfo = null;
}
// getCreateAction方法用于生成一个表示创建任务操作的JSONObject对象，该JSON对象包含了创建任务所需的各种相关信息，
// 例如操作类型、任务的基本属性、在父任务列表中的位置等信息，若在构建JSON过程中出现异常，则抛出ActionFailureException异常。
public JSONObject getCreateAction(int actionId) {
// 创建一个新的JSONObject对象，用于组装并最终返回包含创建任务操作相关信息的JSON数据结构。
JSONObject js = new JSONObject();
try {
// 设置JSON对象中的"action_type"字段，表示操作类型，将其值设为GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE，
// 意味着这个JSON数据代表的是创建任务的操作，方便后续解析该JSON数据的模块能识别操作意图。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
// 设置JSON对象中的"action_id"字段，将传入的actionId参数值赋给该字段，actionId可能是用于唯一标识这个创建任务操作的序号等，
// 在整个任务管理系统中便于区分不同的操作实例。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
// 设置JSON对象中的"index"字段，通过调用mParent（所属的父任务列表对象）的getChildTaskIndex方法，传入当前任务对象（this），
// 获取当前任务在父任务列表中的索引位置，并将其赋给该字段，用于表示任务在所属分组中的顺序等情况。
js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this));
// 创建一个新的JSONObject对象，用于组装任务实体相关的详细信息，后续会将其作为整体放入外层的js对象中，代表要创建的任务主体内容。
JSONObject entity = new JSONObject();
// 设置entity JSON对象中的"name"字段，通过调用getName方法（该方法应该是在父类Node或者本类中定义的用于获取任务名称的方法）获取任务名称，
// 并将其赋给该字段，这样在创建任务的JSON数据中包含了任务的名称信息，方便识别任务。
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置entity JSON对象中的"creator_id"字段，暂时将其值设为"null"，可能后续需要根据实际的创建者标识来进行准确赋值，
// 这里先占位表示创建者信息暂未明确或者还未填充。
entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
// 设置entity JSON对象中的"entity_type"字段，将其值设为GTaskStringUtils.GTASK_JSON_TYPE_TASK，
// 明确表示这个实体是任务类型，便于系统区分不同类型的实体（比如可能还有分组类型等其他实体）。
entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_TASK);
// 判断任务的备注信息（mNotes）是否不为null，如果有备注内容，则将其添加到entity JSON对象的"notes"字段中，
// 使得创建任务的JSON数据可以包含任务相关的备注描述信息，方便查看任务详情时有更多参考内容。
if (getNotes()!= null) {
entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
}
// 将包含任务实体详细信息的entity对象，以GTaskStringUtils.GTASK_JSON_ENTITY_DELTA为键，添加到外层的js对象中，
// 这样整个JSON数据结构就完整地包含了创建任务操作以及要创建的任务具体内容等信息。
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
// 设置JSON对象中的"parent_id"字段，通过调用mParent（所属的父任务列表对象）的getGid方法获取父任务列表的唯一标识符（Gid），
// 并将其赋给该字段，表示要创建的任务所属的父任务分组，建立任务的层级关系。
js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
// 设置JSON对象中的"dest_parent_type"字段，将其值设为GTaskStringUtils.GTASK_JSON_TYPE_GROUP，
// 表示目标父级的类型是分组，用于明确创建任务时其所属的父级实体在整个系统中的类型定位。
js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
// 设置JSON对象中的"list_id"字段，同样通过调用mParent（所属的父任务列表对象）的getGid方法获取父任务列表的唯一标识符（Gid），
// 并将其赋给该字段，可能用于在列表相关操作中进一步标识任务所属的列表情况，与"parent_id"字段作用类似但可能在不同场景下使用。
js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
// 判断前序兄弟任务（mPriorSibling）是否不为null，如果存在前序兄弟任务，则调用其getGid方法获取前序兄弟任务的唯一标识符（Gid），
// 并将其赋给JSON对象的"prior_sibling_id"字段，用于表示任务在兄弟任务序列中的先后顺序关系，方便在插入任务等操作时确定位置。
if (mPriorSibling!= null) {
js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
}
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，
// 方便排查问题，同时抛出ActionFailureException异常，表示生成创建任务的JSON对象失败，以便上层调用者能捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate task-create jsonobject");
}
// 如果成功构建了包含创建任务操作相关信息的JSON对象，没有出现异常情况，则返回该js对象，供后续操作（比如发送给服务器等场景）使用。
return js;
}
}
// getUpdateAction方法用于生成一个表示更新任务操作的JSONObject对象，该JSON对象包含了更新任务所需的各种关键信息，
// 例如操作类型、任务的唯一标识符以及要更新的任务具体属性等内容，若在构建JSON过程中出现异常，则抛出ActionFailureException异常。
public JSONObject getUpdateAction(int actionId) {
// 创建一个新的JSONObject对象，用于组装并最终返回包含更新任务操作相关信息的JSON数据结构。
JSONObject js = new JSONObject();
try {
// 设置JSON对象中的"action_type"字段，表示操作类型，将其值设为GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE，
// 意味着这个JSON数据代表的是更新任务的操作，方便后续解析该JSON数据的模块能识别操作意图。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
// 设置JSON对象中的"action_id"字段，将传入的actionId参数值赋给该字段，actionId可能是用于唯一标识这个更新任务操作的序号等，
// 在整个任务管理系统中便于区分不同的操作实例。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
// 设置JSON对象中的"id"字段，通过调用getGid方法（该方法应该是在当前类或者父类中定义的用于获取任务唯一标识符的方法）获取任务的唯一标识符（Gid），
// 并将其赋给该字段，用于明确要更新的是哪个具体任务，建立与具体任务实体的关联。
js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
// 创建一个新的JSONObject对象，用于组装任务实体相关的详细信息，这些信息就是此次更新操作中涉及要改变的任务属性内容，
// 后续会将其作为整体放入外层的js对象中，代表更新任务时具体的变更内容。
JSONObject entity = new JSONObject();
// 设置entity JSON对象中的"name"字段，通过调用getName方法（用于获取任务名称的方法）获取任务名称，
// 并将其赋给该字段，这样在更新任务的JSON数据中包含了可能要更新的任务名称信息，方便根据实际需求修改任务的显示名称等情况。
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 判断任务的备注信息（getNotes方法获取）是否不为null，如果有备注内容，则将其添加到entity JSON对象的"notes"字段中，
// 意味着更新任务操作可以包含对任务备注信息的修改，使得任务的相关描述内容能按需更新。
if (getNotes()!= null) {
entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
}
// 设置entity JSON对象中的"deleted"字段，通过调用getDeleted方法（用于获取任务是否已删除状态的方法）获取任务的删除状态，
// 并将其赋给该字段，表明更新任务操作也可以涉及任务删除状态的变更，比如将未删除的任务标记为已删除等情况。
entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
// 将包含任务实体详细信息（要更新的具体属性内容）的entity对象，以GTaskStringUtils.GTASK_JSON_ENTITY_DELTA为键，添加到外层的js对象中，
// 这样整个JSON数据结构就完整地包含了更新任务操作以及具体要更新的任务内容等信息。
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，
// 方便排查问题，同时抛出ActionFailureException异常，表示生成更新任务的JSON对象失败，以便上层调用者能捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate task-update jsonobject");
}
// 如果成功构建了包含更新任务操作相关信息的JSON对象，没有出现异常情况，则返回该js对象，供后续操作（比如发送给服务器等场景）使用。
return js;
}
// setContentByRemoteJSON方法用于根据传入的JSONObject对象（通常是从远程获取的包含任务相关信息的JSON数据）来设置当前Task对象的各项属性值，
// 若传入的JSON对象为null或者在解析JSON过程中出现异常，则抛出ActionFailureException异常。
public void setContentByRemoteJSON(JSONObject js) {
if (js!= null) {
try {
// 判断传入的JSON对象（js）中是否包含"id"字段，如果包含，则调用setGid方法（用于设置任务唯一标识符的方法），
// 并将该字段对应的字符串值（通过getString方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的唯一标识符属性。
if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
}
// 判断传入的JSON对象（js）中是否包含"last_modified"字段，如果包含，则调用setLastModified方法（用于设置任务最后修改时间的方法），
// 并将该字段对应的长整型值（通过getLong方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的最后修改时间属性，用于记录任务最新的修改情况。
if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
}
// 判断传入的JSON对象（js）中是否包含"name"字段，如果包含，则调用setName方法（用于设置任务名称的方法），
// 并将该字段对应的字符串值（通过getString方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的任务名称属性，以便任务显示正确的名称。
if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
}
// 判断传入的JSON对象（js）中是否包含"notes"字段，如果包含，则调用setNotes方法（用于设置任务备注信息的方法），
// 并将该字段对应的字符串值（通过getString方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的备注信息属性，使备注内容与远程数据保持一致。
if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
}
// 判断传入的JSON对象（js）中是否包含"deleted"字段，如果包含，则调用setDeleted方法（用于设置任务是否已删除状态的方法），
// 并将该字段对应的布尔值（通过getBoolean方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的删除状态属性，比如标记任务是否已被删除。
if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
}
// 判断传入的JSON对象（js）中是否包含"completed"字段，如果包含，则调用setCompleted方法（用于设置任务是否已完成状态的方法），
// 并将该字段对应的布尔值（通过getBoolean方法获取）传递进去，实现根据远程JSON数据更新当前任务对象的完成状态属性，准确反映任务的完成情况。
if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
}
} catch (JSONException e) {
// 如果在解析JSON对象（如获取对应字段的值等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，
// 方便排查问题，同时抛出ActionFailureException异常，表示从JSON对象中获取任务内容并设置到当前对象失败，以便上层调用者能捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to get task content from jsonobject");
}
}
}
// setContentByLocalJSON方法用于根据本地的JSONObject对象来设置当前Task对象的相关内容，
// 如果传入的JSON对象不符合要求（为null或者缺少关键的节点信息），则记录警告日志；若解析JSON出现异常也会记录错误日志。
public void setContentByLocalJSON(JSONObject js) {
// 判断传入的JSON对象是否为null，或者是否不包含名为GTaskStringUtils.META_HEAD_NOTE的节点，
// 又或者是否不包含名为GTaskStringUtils.META_HEAD_DATA的节点，如果满足这些情况之一，则表示该JSON对象不符合处理要求。
if (js == null ||!js.has(GTaskStringUtils.META_HEAD_NOTE)
||!js.has(GTaskStringUtils.META_HEAD_DATA)) {
Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
}
try {
// 从传入的JSON对象中获取名为GTaskStringUtils.META_HEAD_NOTE的子JSON对象，该对象预期包含了笔记主体相关的属性信息，比如类型等关键内容。
JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
// 从传入的JSON对象中获取名为GTaskStringUtils.META_HEAD_DATA的JSON数组，该数组预期包含了与该任务相关的多条具体数据内容。
JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
// 判断笔记类型是否不等于普通笔记类型（Notes.TYPE_NOTE），如果不是普通笔记类型，则记录错误日志表示类型无效，然后直接返回，不进行后续操作。
if (note.getInt(NoteColumns.TYPE)!= Notes.TYPE_NOTE) {
Log.e(TAG, "invalid type");
return;
}
// 遍历GTaskStringUtils.META_HEAD_DATA数组中的每一个JSON对象（即遍历与该任务相关的每一条具体数据内容）。
for (int i = 0; i < dataArray.length(); i++) {
JSONObject data = dataArray.getJSONObject(i);
// 判断当前具体数据对象（data）中的DataColumns.MIME_TYPE字段对应的字符串值是否等于DataConstants.NOTE，
// 如果相等，表示找到了与任务名称相关的数据内容（这里根据特定的类型标识来判断是否是任务名称相关的数据）。
if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
// 调用setName方法（用于设置任务名称的方法），将该数据对象中DataColumns.CONTENT字段对应的字符串值作为任务名称传递进去，实现根据本地JSON数据更新任务名称，
// 找到符合要求的数据后就通过break跳出循环，因为只需要找到任务名称对应的那部分数据进行处理即可。
setName(data.getString(DataColumns.CONTENT));
break;
}
}
} catch (JSONException e) {
// 如果在解析JSON对象（如获取子对象、获取数组元素、获取字段值等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题。
Log.e(TAG, e.toString());
e.printStackTrace();
}
}
// getLocalJSONFromContent方法用于根据当前Task对象的内容生成对应的本地JSONObject表示形式，
// 如果在构建JSON过程中出现异常，则记录错误日志并返回null；会根据不同情况（新创建任务或已同步任务）进行不同的JSON组装逻辑。
public JSONObject getLocalJSONFromContent() {
// 获取当前任务对象的名称，后续会根据名称以及其他相关属性来组装JSON数据。
String name = getName();
try {
// 判断当前任务对象的元信息（mMetaInfo，以JSONObject形式存储，可能包含了更丰富的任务相关信息）是否为null。
if (mMetaInfo == null) {
// 如果mMetaInfo为null，表示这可能是一个从网页端新创建的任务（根据注释推测的情况）。
// 进一步判断任务名称是否为null，如果名称也为null，则记录警告日志表示这个笔记似乎是空的，然后直接返回null，因为没有足够信息构建JSON。
if (name == null) {
Log.w(TAG, "the note seems to be an empty one");
return null;
}
// 创建一个新的JSONObject对象，用于组装并最终返回包含任务相关信息的本地JSON数据结构。
JSONObject js = new JSONObject();
// 创建一个新的JSONObject对象，用于存放笔记主体相关的属性信息，后续会往里面添加相应字段数据。
JSONObject note = new JSONObject();
// 创建一个新的JSONArray对象，用于存放与该任务相关的具体数据内容对应的JSON对象，这些具体数据可能是任务正文等详细信息。
JSONArray dataArray = new JSONArray();
// 创建一个新的JSONObject对象，用于表示一条具体的数据内容，这里先准备组装任务名称相关的数据。
JSONObject data = new JSONObject();
// 将任务名称（name）添加到data对象的DataColumns.CONTENT字段中，这样就在数据对象中记录了任务名称相关信息。
data.put(DataColumns.CONTENT, name);
// 将包含任务名称数据的data对象添加到dataArray数组中，使得dataArray包含了任务相关的具体数据内容（目前只有名称相关的这一条数据）。
dataArray.put(data);
// 将包含具体数据内容的dataArray数组，以GTaskStringUtils.META_HEAD_DATA为键，添加到外层的js对象中，完善整个任务的JSON数据结构的一部分。
js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
// 将笔记类型字段（NoteColumns.TYPE）的值设为普通笔记类型（Notes.TYPE_NOTE），并添加到note对象中，明确任务的类型属性。
note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
// 将包含笔记主体属性信息的note对象，以GTaskStringUtils.META_HEAD_NOTE为键，添加到外层的js对象中，形成完整的符合要求的本地JSON数据结构，代表新创建任务的情况。
js.put(GTaskStringUtils.META_HEAD_NOTE, note);
// 返回组装好的js对象，即包含了新创建任务相关信息的本地JSON表示形式。
return js;
} else {
// 如果mMetaInfo不为null，表示这是一个已同步过的任务，已有完整的元信息，基于这些元信息来生成要返回的本地JSON数据。
// 从mMetaInfo中获取名为GTaskStringUtils.META_HEAD_NOTE的子JSON对象，该对象包含了笔记主体相关属性信息。
JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
// 从mMetaInfo中获取名为GTaskStringUtils.META_HEAD_DATA的JSON数组，该数组包含了与任务相关的多条具体数据内容。
JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
// 遍历GTaskStringUtils.META_HEAD_DATA数组中的每一个JSON对象（即遍历与该任务相关的每一条具体数据内容），查找与任务名称相关的数据部分。
for (int i = 0; i < dataArray.length(); i++) {
JSONObject data = dataArray.getJSONObject(i);
// 判断当前具体数据对象（data）中的DataColumns.MIME_TYPE字段对应的字符串值是否等于DataConstants.NOTE，
// 如果相等，表示找到了与任务名称相关的数据内容（这里根据特定的类型标识来判断是否是任务名称相关的数据）。
if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) {
// 将任务名称（通过getName方法获取当前任务对象的名称）更新到该数据对象的DataColumns.CONTENT字段中，实现将最新的任务名称同步到JSON数据里，
// 找到符合要求的数据后就通过break跳出循环，因为只需要更新任务名称对应的那部分数据即可。
data.put(DataColumns.CONTENT, getName());
break;
}
}
// 将笔记类型字段（NoteColumns.TYPE）的值设为普通笔记类型（Notes.TYPE_NOTE），并更新到note对象中，再次明确任务的类型属性，确保JSON数据中类型正确。
note.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
// 返回mMetaInfo对象，此时mMetaInfo已经更新了任务名称相关数据以及明确了任务类型，它代表了已同步任务的本地JSON数据结构，可供外部使用。
return mMetaInfo;
}
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject或JSONArray中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题。
Log.e(TAG, e.toString());
e.printStackTrace();
// 如果出现异常情况，最终返回null，表示无法成功获取任务对应的本地JSON内容表示形式。
return null;
}
}
// setMetaInfo方法用于设置当前Task对象的元信息（mMetaInfo），它会尝试将传入的MetaData对象中的笔记信息（以字符串形式）转换为JSONObject格式并赋值给mMetaInfo，
// 如果在转换过程中出现JSONException异常，则记录警告日志，并将mMetaInfo设为null，表示设置元信息失败。
public void setMetaInfo(MetaData metaData) {
// 首先判断传入的metaData对象不为null，并且其getNotes方法返回的笔记信息也不为null，才进行后续操作，
// 即只有当有有效元数据且其中的笔记信息存在时才尝试处理。
if (metaData!= null && metaData.getNotes()!= null) {
try {
// 使用传入的MetaData对象中获取到的笔记信息字符串创建一个新的JSONObject对象，
// 这一步是将字符串形式的笔记信息转换为便于操作的JSON对象格式，方便后续根据JSON结构获取具体的属性等内容，然后将其赋值给mMetaInfo，完成元信息的设置。
mMetaInfo = new JSONObject(metaData.getNotes());
} catch (JSONException e) {
// 如果在创建JSONObject对象的过程中（也就是解析字符串为JSON格式时）出现了JSONException异常，记录警告日志（因为这只是一个可能不影响整体流程继续的错误情况），
// 并将mMetaInfo设为null，表示此次设置元信息操作失败，后续使用mMetaInfo时需要考虑其为null的情况。
Log.w(TAG, e.toString());
mMetaInfo = null;
}
}
}
// getSyncAction方法用于根据传入的Cursor对象（通常用于从数据库查询结果中获取数据）以及当前Task对象的相关状态，
// 来确定在数据同步操作中应该执行的具体动作，返回对应的同步动作标识（SYNC_ACTION_* 系列常量之一），若出现异常则返回SYNC_ACTION_ERROR。
public int getSyncAction(Cursor c) {
try {
JSONObject noteInfo = null;
// 判断当前Task对象的元信息（mMetaInfo）不为null，并且其中包含名为GTaskStringUtils.META_HEAD_NOTE的节点，
// 如果满足条件，则尝试获取该节点对应的JSONObject对象，这个对象预期包含了笔记主体相关的关键属性信息，后续用于各种判断和比较。
if (mMetaInfo!= null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) {
noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
}
// 如果noteInfo为null，意味着可能笔记的元信息已经被删除了（根据逻辑推测），记录警告日志，并返回SYNC_ACTION_UPDATE_REMOTE，
// 表示在同步操作中需要将远程数据更新到本地，可能本地的相关数据已经不完整或缺失了。
if (noteInfo == null) {
Log.w(TAG, "it seems that note meta has been deleted");
return SYNC_ACTION_UPDATE_REMOTE;
}
// 判断noteInfo中是否不包含名为NoteColumns.ID的字段，如果不包含，说明远程笔记的ID似乎被删除了（根据逻辑推测），
// 记录警告日志，并返回SYNC_ACTION_UPDATE_LOCAL，表示在同步操作中需要用本地数据去更新远程数据，可能远程数据出现了关键信息缺失的情况。
if (!noteInfo.has(NoteColumns.ID)) {
Log.w(TAG, "remote note id seems to be deleted");
return SYNC_ACTION_UPDATE_LOCAL;
}
// 验证笔记的ID是否匹配，通过比较从Cursor对象（数据库查询结果）中获取的笔记ID（通过SqlNote.ID_COLUMN指定的列获取长整型ID值），
// 和从noteInfo中获取的笔记ID（通过NoteColumns.ID字段获取长整型ID值）是否相等，如果不相等，记录警告日志，
// 并返回SYNC_ACTION_UPDATE_LOCAL，表示需要以本地数据为准进行更新，可能存在两边数据不一致的情况。
if (c.getLong(SqlNote.ID_COLUMN)!= noteInfo.getLong(NoteColumns.ID)) {
Log.w(TAG, "note id doesn't match");
return SYNC_ACTION_UPDATE_LOCAL;
}
// 判断本地是否没有更新，通过检查Cursor对象中代表本地修改状态的列（SqlNote.LOCAL_MODIFIED_COLUMN指定的列）的值是否为0来确定，
// 如果为0，表示本地没有进行过更新操作。
if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
// 进一步判断远程和本地是否都没有更新，通过比较Cursor对象中代表同步ID的列（SqlNote.SYNC_ID_COLUMN指定的列）的值，
// 和当前Task对象的最后修改时间（通过getLastModified方法获取）是否相等来确定，如果相等，说明两边数据都没有更新，
// 则返回SYNC_ACTION_NONE，表示不需要进行任何同步操作，两边数据是一致的。
if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
return SYNC_ACTION_NONE;
} else {
// 如果同步ID不相等，说明远程有更新，需要将远程数据应用到本地，返回SYNC_ACTION_UPDATE_LOCAL，表示以远程数据更新本地数据。
return SYNC_ACTION_UPDATE_LOCAL;
}
} else {
// 如果本地有更新（即本地修改状态列的值不为0），则需要进一步验证任务的Gtask ID是否匹配，
// 通过比较Cursor对象中代表Gtask ID的列（SqlNote.GTASK_ID_COLUMN指定的列）获取的字符串值，
// 和当前Task对象通过getGid方法获取的Gtask ID是否相等来确定，如果不相等，记录错误日志（因为这可能是比较严重的不一致情况），
// 并返回SYNC_ACTION_ERROR，表示出现了同步错误，两边的关键标识不一致了。
if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
Log.e(TAG, "gtask id doesn't match");
return SYNC_ACTION_ERROR;
}
// 再次判断远程和本地的更新情况，通过比较Cursor对象中代表同步ID的列（SqlNote.SYNC_ID_COLUMN指定的列）的值，
// 和当前Task对象的最后修改时间（通过getLastModified方法获取）是否相等来确定，如果相等，说明只有本地进行了修改，
// 则返回SYNC_ACTION_UPDATE_REMOTE，表示需要将本地的修改同步到远程，让远程数据也更新为本地修改后的状态。
if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
return SYNC_ACTION_UPDATE_REMOTE;
} else {
// 如果同步ID不相等，说明远程和本地都有不同的修改，出现了数据冲突情况，返回SYNC_ACTION_UPDATE_CONFLICT，表示需要处理同步冲突，
// 例如可能需要人工介入或者按照特定的冲突解决策略来决定以哪边数据为准等操作。
return SYNC_ACTION_UPDATE_CONFLICT;
}
}
} catch (Exception e) {
// 如果在整个方法执行过程中出现了任何异常（捕获了Exception类型，涵盖了各种可能的运行时异常等情况），记录错误日志，打印异常堆栈信息，方便排查问题，
// 并返回SYNC_ACTION_ERROR，表示出现了同步相关的错误情况，无法准确判断同步动作。
Log.e(TAG, e.toString());
e.printStackTrace();
}
// 如果前面执行过程中出现了未处理的情况或者最终正常流程执行完毕但没有返回合适的同步动作标识，默认返回SYNC_ACTION_ERROR，表示出现错误。
return SYNC_ACTION_ERROR;
}
public boolean isWorthSaving() {
return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
|| (getNotes() != null && getNotes().trim().length() > 0);
}
public void setCompleted(boolean completed) {
this.mCompleted = completed;
}
public void setNotes(String notes) {
this.mNotes = notes;
}
public void setPriorSibling(Task priorSibling) {
this.mPriorSibling = priorSibling;
}
public void setParent(TaskList parent) {
this.mParent = parent;
}
public boolean getCompleted() {
return this.mCompleted;
}
public String getNotes() {
return this.mNotes;
}
public Task getPriorSibling() {
return this.mPriorSibling;
}
public TaskList getParent() {
return this.mParent;
}
}

504
TaskList.java
Unescape View File

@ -1,504 +0,0 @@
/*
* 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;
// TaskList类继承自Node类，可理解为用于表示任务列表相关的对象，包含了任务列表自身的一些属性以及操作方法。
public class TaskList extends Node {
// 定义一个用于日志记录的标签，其值为类的简单名称（不含包名部分），便于在日志中清晰识别与该类相关的输出信息。
private static final String TAG = TaskList.class.getSimpleName();
// 用于记录任务列表的索引位置（可能在某个更大的分组或者排序体系中的序号等），初始值为1，后续可根据实际情况改变。
private int mIndex;
// 用于存储该任务列表包含的多个任务对象，以ArrayList形式进行管理，方便进行任务的添加、删除、遍历等操作，初始化为一个空的ArrayList。
private ArrayList<Task> mChildren;
// 无参构造函数，用于创建TaskList对象时进行默认的初始化操作，先调用父类（Node类）的无参构造函数，然后初始化mChildren为一个新的空ArrayList，并将mIndex设为1。
public TaskList() {
super();
mChildren = new ArrayList<Task>();
mIndex = 1;
}
// getCreateAction方法用于生成一个表示创建任务列表操作的JSONObject对象，该JSON对象包含了创建任务列表所需的关键信息，
// 例如操作类型、任务列表的基本属性等内容，若在构建JSON过程中出现异常，则抛出ActionFailureException异常。
public JSONObject getCreateAction(int actionId) {
// 创建一个新的JSONObject对象，用于组装并最终返回包含创建任务列表操作相关信息的JSON数据结构。
JSONObject js = new JSONObject();
try {
// 设置JSON对象中的"action_type"字段，表示操作类型，将其值设为GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE，
// 明确该JSON数据代表的是创建任务列表的操作，方便后续解析此JSON的模块知晓操作意图。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
// 设置JSON对象中的"action_id"字段，把传入的actionId参数值赋给该字段，actionId可能用于唯一标识这个创建任务列表操作的序号等，便于区分不同操作实例。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
// 设置JSON对象中的"index"字段，将当前任务列表对象的索引位置（mIndex）赋给该字段，用于表示任务列表在所属体系中的顺序等相关情况。
js.put(GTaskStringUtils.GTASK_JSON_INDEX, mIndex);
// 创建一个新的JSONObject对象，用于组装任务列表实体相关的详细信息，后续会将其整体放入外层的js对象中，代表要创建的任务列表主体内容。
JSONObject entity = new JSONObject();
// 设置entity JSON对象中的"name"字段，通过调用getName方法（应是在父类Node或者本类中定义的获取名称的方法）获取任务列表名称，并赋给该字段，使创建操作的JSON数据包含名称信息，便于识别。
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置entity JSON对象中的"creator_id"字段，暂时将其值设为"null"，可能后续需根据实际创建者标识准确赋值，这里先占位表示创建者信息暂未明确。
entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
// 设置entity JSON对象中的"entity_type"字段，将其值设为GTaskStringUtils.GTASK_JSON_TYPE_GROUP，
// 表明这个实体是任务列表类型（分组类型），方便系统区分不同类型的实体。
entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
// 将包含任务列表实体详细信息的entity对象，以GTaskStringUtils.GTASK_JSON_ENTITY_DELTA为键，添加到外层的js对象中，
// 这样整个JSON数据结构就完整包含了创建任务列表操作以及要创建的任务列表具体内容等信息。
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject添加元素等操作）过程中出现JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题，
// 同时抛出ActionFailureException异常，表示生成创建任务列表的JSON对象失败，以便上层调用者捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate tasklist-create jsonobject");
}
// 如果成功构建了包含创建任务列表操作相关信息的JSON对象，无异常情况，则返回该js对象，供后续操作（如发送给服务器等场景）使用。
return js;
}
}
// getUpdateAction方法用于生成一个表示更新任务列表操作的JSONObject对象，该JSON对象包含了更新任务列表所需的关键信息，
// 例如操作类型、任务列表的唯一标识符以及要更新的任务列表具体属性等内容，若在构建JSON过程中出现异常，则抛出ActionFailureException异常。
public JSONObject getUpdateAction(int actionId) {
// 创建一个新的JSONObject对象，用于组装并最终返回包含更新任务列表操作相关信息的JSON数据结构。
JSONObject js = new JSONObject();
try {
// 设置JSON对象中的"action_type"字段，表示操作类型，将其值设为GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE，
// 意味着这个JSON数据代表的是更新任务列表的操作，方便后续解析该JSON数据的模块能识别操作意图。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
// 设置JSON对象中的"action_id"字段，将传入的actionId参数值赋给该字段，actionId可能是用于唯一标识这个更新任务列表操作的序号等，
// 在整个任务管理系统中便于区分不同的操作实例。
js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
// 设置JSON对象中的"id"字段，通过调用getGid方法（该方法应该是在当前类或者父类中定义的用于获取任务列表唯一标识符的方法）获取任务列表的唯一标识符（Gid），
// 并将其赋给该字段，用于明确要更新的是哪个具体任务列表，建立与具体任务列表实体的关联。
js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
// 创建一个新的JSONObject对象，用于组装任务列表实体相关的详细信息，这些信息就是此次更新操作中涉及要改变的任务列表属性内容，
// 后续会将其作为整体放入外层的js对象中，代表更新任务列表时具体的变更内容。
JSONObject entity = new JSONObject();
// 设置entity JSON对象中的"name"字段，通过调用getName方法（用于获取任务列表名称的方法）获取任务列表名称，
// 并将其赋给该字段，这样在更新任务列表的JSON数据中包含了可能要更新的任务列表名称信息，方便根据实际需求修改任务列表的显示名称等情况。
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置entity JSON对象中的"deleted"字段，通过调用getDeleted方法（用于获取任务列表是否已删除状态的方法）获取任务列表的删除状态，
// 并将其赋给该字段，表明更新任务列表操作也可以涉及任务列表删除状态的变更，比如将未删除的任务列表标记为已删除等情况。
entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
// 将包含任务列表实体详细信息（要更新的具体属性内容）的entity对象，以GTaskStringUtils.GTASK_JSON_ENTITY_DELTA为键，添加到外层的js对象中，
// 这样整个JSON数据结构就完整地包含了更新任务列表操作以及具体要更新的任务列表内容等信息。
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，
// 方便排查问题，同时抛出ActionFailureException异常，表示生成更新任务列表的JSON对象失败，以便上层调用者能捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate tasklist-update jsonobject");
}
// 如果成功构建了包含更新任务列表操作相关信息的JSON对象，没有出现异常情况，则返回该js对象，供后续操作（比如发送给服务器等场景）使用。
return js;
}
// setContentByRemoteJSON方法用于根据传入的JSONObject对象（通常是从远程获取的包含任务列表相关信息的JSON数据）来设置当前TaskList对象的各项属性值，
// 若传入的JSON对象为null或者在解析JSON过程中出现异常，则抛出ActionFailureException异常。
public void setContentByRemoteJSON(JSONObject js) {
if (js!= null) {
try {
// 判断传入的JSON对象（js）中是否包含"id"字段，如果包含，则调用setGid方法（用于设置任务列表唯一标识符的方法），
// 并将该字段对应的字符串值（通过getString方法获取）传递进去，实现根据远程JSON数据更新当前任务列表对象的唯一标识符属性。
if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
}
// 判断传入的JSON对象（js）中是否包含"last_modified"字段，如果包含，则调用setLastModified方法（用于设置任务列表最后修改时间的方法），
// 并将该字段对应的长整型值（通过getLong方法获取）传递进去，实现根据远程JSON数据更新当前任务列表对象的最后修改时间属性，用于记录任务列表最新的修改情况。
if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
}
// 判断传入的JSON对象（js）中是否包含"name"字段，如果包含，则调用setName方法（用于设置任务列表名称的方法），
// 并将该字段对应的字符串值（通过getString方法获取）传递进去，实现根据远程JSON数据更新当前任务列表对象的任务列表名称属性，以便任务列表显示正确的名称。
if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
}
} catch (JSONException e) {
// 如果在解析JSON对象（如获取对应字段的值等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，
// 方便排查问题，同时抛出ActionFailureException异常，表示从JSON对象中获取任务列表内容并设置到当前对象失败，以便上层调用者能捕获并处理该异常情况。
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to get tasklist content from jsonobject");
}
}
}
// setContentByLocalJSON方法用于根据本地的JSONObject对象来设置当前TaskList对象的相关内容，
// 如果传入的JSON对象不符合要求（为null或者缺少关键的节点信息），则记录警告日志；若解析JSON出现异常也会记录错误日志。
public void setContentByLocalJSON(JSONObject js) {
// 判断传入的JSON对象是否为null，或者是否不包含名为GTaskStringUtils.META_HEAD_NOTE的节点，
// 如果满足这些情况之一，则表示该JSON对象不符合处理要求，记录警告日志提示没有可用信息。
if (js == null ||!js.has(GTaskStringUtils.META_HEAD_NOTE)) {
Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
}
try {
// 从传入的JSON对象中获取名为GTaskStringUtils.META_HEAD_NOTE的子JSON对象，该对象预期包含了与文件夹或系统相关的属性信息，比如类型、名称等关键内容。
JSONObject folder = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
// 判断获取到的folder对象中表示类型的字段（NoteColumns.TYPE）的值是否等于文件夹类型（Notes.TYPE_FOLDER），
// 如果是文件夹类型，则从folder对象中获取表示摘要（在这里可理解为文件夹名称）的字段（NoteColumns.SNIPPET）对应的字符串值，
// 然后调用setName方法（用于设置任务列表名称的方法），将其设置为特定格式（加上前缀GTaskStringUtils.MIUI_FOLDER_PREFFIX）的名称，完成根据本地JSON数据对任务列表名称的更新。
if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
String name = folder.getString(NoteColumns.SNIPPET);
setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + name);
} else if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
// 如果类型是系统类型（Notes.TYPE_SYSTEM），则进一步根据系统文件夹的ID来设置不同的默认名称。
// 判断folder对象中表示ID的字段（NoteColumns.ID）的值是否等于根文件夹的ID（Notes.ID_ROOT_FOLDER），
// 如果是，则调用setName方法，将任务列表名称设置为特定格式（加上前缀GTaskStringUtils.MIUI_FOLDER_PREFFIX和默认文件夹名称GTaskStringUtils.FOLDER_DEFAULT）的名称。
if (folder.getLong(NoteColumns.ID) == Notes.ID_ROOT_FOLDER)
setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT);
// 判断folder对象中表示ID的字段（NoteColumns.ID）的值是否等于通话记录文件夹的ID（Notes.ID_CALL_RECORD_FOLDER），
// 如果是，则调用setName方法，将任务列表名称设置为特定格式（加上前缀GTaskStringUtils.MIUI_FOLDER_PREFFIX和通话记录文件夹对应的名称GTaskStringUtils.FOLDER_CALL_NOTE）的名称。
else if (folder.getLong(NoteColumns.ID) == Notes.ID_CALL_RECORD_FOLDER)
setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+ GTaskStringUtils.FOLDER_CALL_NOTE);
else
// 如果不是上述已知的系统文件夹ID，则记录错误日志，表示是无效的系统文件夹，因为无法确定如何正确设置名称了。
Log.e(TAG, "invalid system folder");
} else {
// 如果类型既不是文件夹类型也不是系统类型，则记录错误日志，表示出现了错误的类型，不符合预期的处理逻辑。
Log.e(TAG, "error type");
}
} catch (JSONException e) {
// 如果在解析JSON对象（如获取子对象、获取字段值等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题。
Log.e(TAG, e.toString());
e.printStackTrace();
}
}
// getLocalJSONFromContent方法用于根据当前TaskList对象的内容生成对应的本地JSONObject表示形式，
// 如果在构建JSON过程中出现异常，则记录错误日志并返回null，主要是按照特定格式组装包含任务列表相关信息的JSON数据。
public JSONObject getLocalJSONFromContent() {
try {
// 创建一个新的JSONObject对象，用于组装并最终返回包含任务列表相关信息的本地JSON数据结构。
JSONObject js = new JSONObject();
// 创建一个新的JSONObject对象，用于存放与任务列表相关的属性信息（这里主要是类型和名称相关内容），后续会将其作为整体放入外层的js对象中。
JSONObject folder = new JSONObject();
// 获取当前任务列表对象的名称，后续会根据名称来判断和设置相应的属性信息到folder对象中。
String folderName = getName();
// 判断任务列表名称是否以特定前缀（GTaskStringUtils.MIUI_FOLDER_PREFFIX）开头，如果是，则截取去掉前缀后的部分作为实际的文件夹名称，
// 这样处理可能是为了在生成JSON数据时只保留关键的名称内容，去除特定格式相关的前缀部分。
if (getName().startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX))
folderName = folderName.substring(GTaskStringUtils.MIUI_FOLDER_PREFFIX.length(),
folderName.length());
// 将处理后的文件夹名称（folderName）添加到folder对象的NoteColumns.SNIPPET字段中，相当于在JSON数据中记录了任务列表对应的名称信息。
folder.put(NoteColumns.SNIPPET, folderName);
// 判断处理后的文件夹名称是否等于默认文件夹名称（GTaskStringUtils.FOLDER_DEFAULT）或者通话记录文件夹对应的名称（GTaskStringUtils.FOLDER_CALL_NOTE），
// 如果是，则将folder对象中表示类型的字段（NoteColumns.TYPE）的值设为系统类型（Notes.TYPE_SYSTEM），表明这是系统相关的文件夹；
// 否则将类型字段设为文件夹类型（Notes.TYPE_FOLDER），以此来明确任务列表对应的类型属性并添加到folder对象中。
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);
// 将包含任务列表相关属性信息的folder对象，以GTaskStringUtils.META_HEAD_NOTE为键，添加到外层的js对象中，形成完整的符合要求的本地JSON数据结构。
js.put(GTaskStringUtils.META_HEAD_NOTE, folder);
// 返回组装好的js对象，即包含了当前任务列表相关信息的本地JSON表示形式，可供在本地存储、传输或者与其他本地模块交互时使用。
return js;
} catch (JSONException e) {
// 如果在构建JSON对象（如往JSONObject中添加元素等操作）过程中出现了JSONException异常，记录错误日志，打印异常堆栈信息，方便排查问题。
Log.e(TAG, e.toString());
e.printStackTrace();
// 如果出现异常情况，最终返回null，表示无法成功获取任务列表对应的本地JSON内容表示形式。
return null;
}
}
// getSyncAction方法用于根据传入的Cursor对象（通常用于从数据库查询结果中获取数据）以及当前TaskList对象的相关状态，
// 来确定在数据同步操作中应该执行的具体动作，返回对应的同步动作标识（SYNC_ACTION_* 系列常量之一），若出现异常则返回SYNC_ACTION_ERROR。
public int getSyncAction(Cursor c) {
try {
// 判断本地是否没有更新，通过检查Cursor对象中代表本地修改状态的列（SqlNote.LOCAL_MODIFIED_COLUMN指定的列）的值是否为0来确定，
// 如果为0，表示本地没有进行过更新操作。
if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
// 进一步判断远程和本地是否都没有更新，通过比较Cursor对象中代表同步ID的列（SqlNote.SYNC_ID_COLUMN指定的列）的值，
// 和当前TaskList对象的最后修改时间（通过getLastModified方法获取）是否相等来确定，如果相等，说明两边数据都没有更新，
// 则返回SYNC_ACTION_NONE，表示不需要进行任何同步操作，两边数据是一致的。
if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
return SYNC_ACTION_NONE;
} else {
// 如果同步ID不相等，说明远程有更新，需要将远程数据应用到本地，返回SYNC_ACTION_UPDATE_LOCAL，表示以远程数据更新本地数据。
return SYNC_ACTION_UPDATE_LOCAL;
}
} else {
// 如果本地有更新（即本地修改状态列的值不为0），则需要进一步验证任务列表的Gtask ID是否匹配，
// 通过比较Cursor对象中代表Gtask ID的列（SqlNote.GTASK_ID_COLUMN指定的列）获取的字符串值，
// 和当前TaskList对象通过getGid方法获取的Gtask ID是否相等来确定，如果不相等，记录错误日志（因为这可能是比较严重的不一致情况），
// 并返回SYNC_ACTION_ERROR，表示出现了同步错误，两边的关键标识不一致了。
if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
Log.e(TAG, "gtask id doesn't match");
return SYNC_ACTION_ERROR;
}
// 再次判断远程和本地的更新情况，通过比较Cursor对象中代表同步ID的列（SqlNote.SYNC_ID_COLUMN指定的列）的值，
// 和当前TaskList对象的最后修改时间（通过getLastModified方法获取）是否相等来确定，如果相等，说明只有本地进行了修改，
// 则返回SYNC_ACTION_UPDATE_REMOTE，表示需要将本地的修改同步到远程，让远程数据也更新为本地修改后的状态。
if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
return SYNC_ACTION_UPDATE_REMOTE;
} else {
// 对于文件夹类型的冲突情况（根据注释这里针对文件夹做了特殊处理），直接采用本地修改进行同步，
// 也就是返回SYNC_ACTION_UPDATE_REMOTE，表示将本地的修改应用到远程数据上，以本地为准进行同步，可能是基于特定业务逻辑考虑文件夹的同步策略。
return SYNC_ACTION_UPDATE_REMOTE;
}
}
} catch (Exception e) {
// 如果在整个方法执行过程中出现了任何异常（捕获了Exception类型，涵盖了各种可能的运行时异常等情况），记录错误日志，打印异常堆栈信息，方便排查问题，
// 并返回SYNC_ACTION_ERROR，表示出现了同步相关的错误情况，无法准确判断同步动作。
Log.e(TAG, "gtask id doesn't match");
e.printStackTrace();
}
// 如果前面执行过程中出现了未处理的情况或者最终正常流程执行完毕但没有返回合适的同步动作标识，默认返回SYNC_ACTION_ERROR，表示出现错误。
return SYNC_ACTION_ERROR;
}
// getChildTaskCount方法用于获取当前TaskList对象中包含的子任务（Task类型）的数量，
// 它直接返回存储子任务的ArrayList（mChildren）的大小，即其中包含的元素个数，也就是子任务的数量。
public int getChildTaskCount() {
return mChildren.size();
}
// addChildTask方法（单个参数版本）用于向当前TaskList对象的子任务列表（mChildren）中添加一个Task类型的子任务，
// 如果添加成功，还会设置该子任务的前序兄弟任务（priorSibling）和父任务（parent）属性，返回添加操作是否成功的布尔值。
public boolean addChildTask(Task task) {
// 初始化一个布尔变量ret，用于记录最终添加子任务操作是否成功，初始值设为false。
boolean ret = false;
// 首先判断传入的任务对象（task）不为null，并且当前子任务列表（mChildren）中不包含该任务对象（避免重复添加），才进行后续添加操作。
if (task!= null &&!mChildren.contains(task)) {
// 调用ArrayList的add方法尝试将任务对象添加到子任务列表（mChildren）中，add方法会返回添加操作是否成功的布尔值，将其赋值给ret变量。
ret = mChildren.add(task);
// 如果添加操作成功（ret为true），则需要设置该子任务的前序兄弟任务（priorSibling）和父任务（parent）属性。
if (ret) {
// 判断子任务列表是否为空，如果为空，则将该子任务的前序兄弟任务设为null，因为没有其他任务在它之前；
// 如果不为空，则将该子任务的前序兄弟任务设为子任务列表中的最后一个任务（即当前刚添加任务之前的那个任务），通过获取子任务列表最后一个元素的方式来设置。
task.setPriorSibling(mChildren.isEmpty()? null : mChildren
.get(mChildren.size() - 1));
// 设置该子任务的父任务为当前TaskList对象，表明该任务属于这个任务列表，建立正确的层级关系。
task.setParent(this);
}
}
// 返回添加操作是否成功的结果（ret的值），供外部调用者知晓添加子任务的情况。
return ret;
}
// addChildTask方法（两个参数版本）用于向当前TaskList对象的子任务列表（mChildren）中指定索引位置添加一个Task类型的子任务，
// 如果索引位置不合法会记录错误日志并返回false，添加成功会更新相关任务的前序兄弟任务关系，返回添加操作是否成功的布尔值（按逻辑这里始终返回true，但可以根据实际情况调整返回值来更准确反馈操作结果）。
public boolean addChildTask(Task task, int index) {
// 判断传入的索引值（index）是否小于0或者大于子任务列表的当前大小（mChildren.size()），如果是，则表示索引位置不合法，记录错误日志并返回false，表示添加操作失败。
if (index < 0 || index > mChildren.size()) {
Log.e(TAG, "add child task: invalid index");
return false;
}
// 查找传入的任务对象（task）在子任务列表（mChildren）中的位置索引，如果不存在则返回 -1，这里获取其位置索引用于后续判断是否重复添加等情况。
int pos = mChildren.indexOf(task);
// 再次判断任务对象（task）不为null，并且在子任务列表中的位置索引为 -1（即不存在于列表中，避免重复添加），才进行后续添加操作。
if (task!= null && pos == -1) {
// 使用ArrayList的add方法，在指定的索引位置（index）添加任务对象，将任务插入到子任务列表中相应位置。
mChildren.add(index, task);
// 更新任务列表中相关任务的前序兄弟任务关系，以下操作是为了维护任务之间正确的顺序关系。
// 初始化前序任务（preTask）和后续任务（afterTask）变量，分别用于存储插入位置之前和之后的任务对象，初始值设为null，后续根据实际情况赋值。
Task preTask = null;
Task afterTask = null;
// 如果插入的索引位置不是0（即不是在列表开头插入），则获取插入位置前一个位置的任务对象，赋值给preTask，作为新插入任务的前序兄弟任务。
if (index!= 0)
preTask = mChildren.get(index - 1);
// 如果插入的索引位置不是子任务列表的最后一个位置（即不是在列表末尾插入），则获取插入位置后一个位置的任务对象，赋值给afterTask，后续用于更新其前序兄弟任务关系。
if (index!= mChildren.size() - 1)
afterTask = mChildren.get(index + 1);
// 设置新插入任务（task）的前序兄弟任务为preTask，建立正确的顺序关系。
task.setPriorSibling(preTask);
// 如果afterTask不为null（即存在后续任务），则设置该后续任务（afterTask）的前序兄弟任务为新插入的任务（task），更新顺序关系，确保任务之间的先后顺序正确。
if (afterTask!= null)
afterTask.setPriorSibling(task);
}
// 按当前逻辑，只要执行到这里就认为添加操作是进行了的（即使可能有一些逻辑上的异常情况未完全考虑周全），所以返回true，表示添加子任务操作成功，
// 也可以根据更严格的业务逻辑需求，进一步完善这里的返回值判断，使其更准确地反馈添加操作的实际结果。
return true;
}
// removeChildTask方法用于从当前TaskList对象的子任务列表（mChildren）中移除指定的Task类型子任务，
// 如果移除成功，会重置该子任务的前序兄弟任务和父任务属性，同时更新子任务列表中相关任务的前序兄弟任务关系，返回移除操作是否成功的布尔值。
public boolean removeChildTask(Task task) {
// 初始化一个布尔变量ret，用于记录最终移除子任务操作是否成功，初始值设为false。
boolean ret = false;
// 获取要移除的任务对象（task）在子任务列表（mChildren）中的索引位置，如果不存在则返回 -1，后续根据该索引进行相关操作判断。
int index = mChildren.indexOf(task);
// 如果任务对象在子任务列表中的索引位置不为 -1（即存在于列表中），则进行移除操作。
if (index!= -1) {
// 调用ArrayList的remove方法尝试移除任务对象，remove方法会返回移除操作是否成功的布尔值，将其赋值给ret变量。
ret = mChildren.remove(task);
// 如果移除操作成功（ret为true），则需要重置该子任务的前序兄弟任务和父任务属性，以及更新子任务列表中相关任务的前序兄弟任务关系。
if (ret) {
// 将该子任务的前序兄弟任务设为null，因为它已经从任务列表中移除了，不再有前序兄弟任务的关联。
task.setPriorSibling(null);
// 将该子任务的父任务设为null，表明它不再属于当前的任务列表，解除层级关系。
task.setParent(null);
// 更新子任务列表中相关任务的前序兄弟任务关系，以下操作是为了维护剩余任务之间正确的顺序关系。
// 判断移除的任务所在索引位置（index）是否不等于子任务列表的当前大小（即不是移除的最后一个任务），如果是，则需要更新后续任务的前序兄弟任务关系。
if (index!= mChildren.size()) {
// 获取移除任务所在索引位置对应的任务对象（即后续任务），并设置其前序兄弟任务为移除任务之前的那个任务（如果移除的是第一个任务则设为null），
// 通过获取相应索引位置的任务对象来更新其前序兄弟任务属性，确保任务之间的先后顺序正确。
mChildren.get(index).setPriorSibling(
index == 0? null : mChildren.get(index - 1));
}
}
}
// 返回移除操作是否成功的结果（ret的值），供外部调用者知晓移除子任务的情况。
return ret;
}
// moveChildTask方法用于在当前TaskList对象的子任务列表（mChildren）中移动指定的Task类型子任务到新的索引位置，
// 如果索引位置不合法或者任务不在列表中会记录错误日志并返回false，移动成功则返回true，内部通过先移除再添加的方式实现移动操作。
public boolean moveChildTask(Task task, int index) {
// 判断传入的新索引位置（index）是否小于0或者大于等于子任务列表的当前大小（mChildren.size()），如果是，则表示索引位置不合法，记录错误日志并返回false，表示移动操作失败。
if (index < 0 || index >= mChildren.size()) {
Log.e(TAG, "move child task: invalid index");
return false;
}
// 获取要移动的任务对象（task）在子任务列表（mChildren）中的当前索引位置，如果不存在则返回 -1，后续根据该索引进行相关操作判断。
int pos = mChildren.indexOf(task);
// 如果任务对象在子任务列表中的索引位置为 -1（即任务不在列表中），记录错误日志并返回false，表示移动操作失败，因为无法移动一个不存在于列表中的任务。
if (pos == -1) {
Log.e(TAG, "move child task: the task should in the list");
return false;
}
// 判断任务对象当前的索引位置（pos）是否与传入的新索引位置（index）相等，如果相等，说明任务已经在目标位置了，不需要进行移动操作，直接返回true，表示移动操作成功（其实就是无需操作的情况）。
if (pos == index)
return true;
// 通过先调用removeChildTask方法移除任务对象，再调用addChildTask方法（两个参数版本）将任务对象添加到新的索引位置的方式，来实现移动任务的操作，
// 如果移除和添加操作都成功，则整体移动操作成功，返回true；如果有任何一个操作失败，则返回false，表示移动操作失败。
return (removeChildTask(task) && addChildTask(task, index));
}
// findChildTaskByGid方法用于在当前TaskList对象的子任务列表（mChildren）中根据任务的唯一标识符（Gid）查找对应的Task类型子任务，
// 如果找到则返回该任务对象，没找到则返回null，通过遍历子任务列表进行查找匹配。
public Task findChildTaskByGid(String gid) {
// 遍历子任务列表（mChildren），从索引0开始，到列表大小结束（不包含列表大小对应的索引，即遍历所有元素）。
for (int i = 0; i < mChildren.size(); i++) {
// 获取当前遍历到的任务对象。
Task t = mChildren.get(i);
// 判断当前任务对象的唯一标识符（通过getGid方法获取）是否与传入的Gid参数相等，如果相等，则找到了对应的任务对象，返回该任务对象。
if (t.getGid().equals(gid)) {
return t;
}
}
// 如果遍历完整个子任务列表都没有找到匹配的任务对象，则返回null，表示未找到。
return null;
}
// getChildTaskIndex方法用于获取指定Task类型子任务在当前TaskList对象的子任务列表（mChildren）中的索引位置，
// 通过调用ArrayList的indexOf方法来查找并返回对应的索引值，如果任务不在列表中则返回 -1。
public int getChildTaskIndex(Task task) {
return mChildren.indexOf(task);
}
// getChildTaskByIndex方法用于根据索引位置从当前TaskList对象的子任务列表（mChildren）中获取对应的Task类型子任务，
// 如果索引位置不合法会记录错误日志并返回null，合法则返回对应索引位置的任务对象，通过直接从列表中获取元素的方式来获取任务对象。
public Task getChildTaskByIndex(int index) {
// 判断传入的索引值（index）是否小于0或者大于等于子任务列表的当前大小（mChildren.size()），如果是，则表示索引位置不合法，记录错误日志并返回null，表示无法获取任务对象。
if (index < 0 || index >= mChildren.size()) {
Log.e(TAG, "getTaskByIndex: invalid index");
return null;
}
// 如果索引位置合法，则直接从子任务列表中获取对应索引位置的任务对象，并返回该任务对象。
return mChildren.get(index);
}
// getChilTaskByGid方法同样用于在当前TaskList对象的子任务列表（mChildren）中根据任务的唯一标识符（Gid）查找对应的Task类型子任务，
// 不过这里是通过增强for循环来遍历列表进行查找匹配，找到则返回任务对象，没找到则返回null，功能和findChildTaskByGid方法类似，但遍历方式不同。
public Task getChilTaskByGid(String gid) {
// 使用增强for循环遍历子任务列表（mChildren），依次获取每个任务对象进行判断。
for (Task task : mChildren) {
// 判断当前遍历到的任务对象的唯一标识符（通过getGid方法获取）是否与传入的Gid参数相等，如果相等，则找到了对应的任务对象，返回该任务对象。
if (task.getGid().equals(gid))
return task;
}
// 如果遍历完整个子任务列表都没有找到匹配的任务对象，则返回null，表示未找到。
return null;
}
// getChildTaskList方法用于获取当前TaskList对象的子任务列表（mChildren），直接返回存储子任务的ArrayList对象，
// 外部调用者可以通过获取到的列表进行进一步的操作，比如遍历、修改等（但需遵循相应的规则和逻辑）。
public ArrayList<Task> getChildTaskList() {
return this.mChildren;
}
// setIndex方法用于设置当前TaskList对象的索引属性（mIndex），将传入的索引值赋给该属性，方便更新任务列表在所属体系中的顺序等相关情况。
public void setIndex(int index) {
this.mIndex = index;
}
// getIndex方法用于获取当前TaskList对象的索引属性（mIndex）的值，直接返回该属性的值，外部调用者可以获取该索引值来了解任务列表的相关顺序信息等。
public int getIndex() {
return this.mIndex;
}

361
WorkingNote.java
Unescape View File

@ -1,361 +0,0 @@
/*
* 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.appwidget.AppWidgetManager; // 导入Android的小部件管理器类
// 定义一个名为WorkingNote的公共类
public class WorkingNote {
// 定义一个Note类型的私有成员变量mNote，用于存储笔记信息
private Note mNote;
// 定义一个长整型私有成员变量mNoteId，用于存储笔记的ID
private long mNoteId;
// 定义一个字符串类型的私有成员变量mContent，用于存储笔记的内容
private String mContent;
// 定义一个整型私有成员变量mMode，用于存储笔记的模式
private int mMode;
// 定义一个长整型私有成员变量mAlertDate，用于存储笔记的提醒日期
private long mAlertDate;
// 定义一个长整型私有成员变量mModifiedDate，用于存储笔记的最后修改日期
private long mModifiedDate;
// 定义一个整型私有成员变量mBgColorId，用于存储笔记的背景颜色ID
private int mBgColorId;
// 定义一个整型私有成员变量mWidgetId，用于存储笔记关联的小部件ID
private int mWidgetId;
// 定义一个整型私有成员变量mWidgetType，用于存储笔记关联的小部件类型
private int mWidgetType;
// 定义一个长整型私有成员变量mFolderId，用于存储笔记所属的文件夹ID
private long mFolderId;
// 定义一个Context类型的私有成员变量mContext，用于获取应用程序的上下文
private Context mContext;
// 定义一个静态的字符串常量TAG，用于日志输出
private static final String TAG = "WorkingNote";
// 定义一个布尔型的私有成员变量mIsDeleted，用于标记笔记是否被删除
private boolean mIsDeleted;
// 定义一个NoteSettingChangedListener类型的私有成员变量mNoteSettingStatusListener，用于监听笔记设置变化
private NoteSettingChangedListener mNoteSettingStatusListener;
// 定义一个静态的字符串数组DATA_PROJECTION，用于指定查询数据库时返回的列
public static final String[] DATA_PROJECTION = new String[] {
DataColumns.ID,
DataColumns.CONTENT,
DataColumns.MIME_TYPE,
DataColumns.DATA1,
DataColumns.DATA2,
DataColumns.DATA3,
DataColumns.DATA4,
};
// 定义一个静态的字符串数组NOTE_PROJECTION，用于指定查询笔记数据库时返回的列
public static final String[] NOTE_PROJECTION = new String[] {
NoteColumns.PARENT_ID,
NoteColumns.ALERTED_DATE,
NoteColumns.BG_COLOR_ID,
NoteColumns.WIDGET_ID,
NoteColumns.WIDGET_TYPE,
NoteColumns.MODIFIED_DATE
};
// 定义一些常量，用于索引查询结果中的列
private static final int DATA_ID_COLUMN = 0;
private static final int DATA_CONTENT_COLUMN = 1;
private static final int DATA_MIME_TYPE_COLUMN = 2;
private static final int DATA_MODE_COLUMN = 3;
private static final int NOTE_PARENT_ID_COLUMN = 0;
private static final int NOTE_ALERTED_DATE_COLUMN = 1;
private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
private static final int NOTE_WIDGET_ID_COLUMN = 3;
private static final int NOTE_WIDGET_TYPE_COLUMN = 4;
private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
// 私有构造函数，用于创建新的笔记对象
private WorkingNote(Context context, long folderId) {
mContext = context;
mAlertDate = 0;
mModifiedDate = System.currentTimeMillis(); // 设置当前时间为最后修改时间
mFolderId = folderId;
mNote = new Note(); // 初始化Note对象
mNoteId = 0;
mIsDeleted = false;
mMode = 0;
mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 设置默认的小部件类型为无效
}
// 私有构造函数，用于加载已存在的笔记对象
private WorkingNote(Context context, long noteId, long folderId) {
mContext = context;
mNoteId = noteId;
mFolderId = folderId;
mIsDeleted = false;
mNote = new Note();
loadNote(); // 加载笔记信息
}
// 私有方法，用于从数据库中加载笔记信息
private void loadNote() {
// 使用ContentResolver查询数据库，获取指定ID的笔记信息
Cursor cursor = mContext.getContentResolver().query(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
null, null);
if (cursor != null) {
if (cursor.moveToFirst()) {
// 从查询结果中读取笔记的详细信息
mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
}
cursor.close(); // 关闭Cursor
} else {
// 如果查询失败，则记录日志并抛出异常
Log.e(TAG, "No note with id:" + mNoteId);
throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
}
loadNoteData(); // 加载笔记的附加数据
}
// 定义一个私有方法，用于加载笔记数据
private void loadNoteData() {
// 使用内容解析器查询笔记数据
Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
DataColumns.NOTE_ID + "=?", new String[] {
String.valueOf(mNoteId)
}, null);
// 检查查询结果是否非空
if (cursor != null) {
// 移动到查询结果的第一行
if (cursor.moveToFirst()) {
do {
// 获取笔记的类型
String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
// 如果是普通笔记类型
if (DataConstants.NOTE.equals(type)) {
// 获取笔记内容
mContent = cursor.getString(DATA_CONTENT_COLUMN);
// 获取笔记的模式（如检查列表模式）
mMode = cursor.getInt(DATA_MODE_COLUMN);
// 设置笔记的ID
mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
}
// 如果是电话笔记类型
else if (DataConstants.CALL_NOTE.equals(type)) {
// 设置电话笔记的ID
mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
} else {
// 如果类型不匹配，记录日志
Log.d(TAG, "Wrong note type with type:" + type);
}
} while (cursor.moveToNext()); // 继续移动到下一行，直到遍历完所有结果
}
// 关闭游标
cursor.close();
} else {
// 如果查询结果为空，记录错误日志并抛出异常
Log.e(TAG, "No data with id:" + mNoteId);
throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
}
}
// 定义一个静态方法，用于创建一个空的笔记对象
public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
int widgetType, int defaultBgColorId) {
// 初始化笔记对象并设置属性
WorkingNote note = new WorkingNote(context, folderId);
note.setBgColorId(defaultBgColorId);
note.setWidgetId(widgetId);
note.setWidgetType(widgetType);
return note;
}
// 定义一个静态方法，用于根据ID加载笔记对象
public static WorkingNote load(Context context, long id) {
return new WorkingNote(context, id, 0);
}
// 定义一个同步方法，用于保存笔记
public synchronized boolean saveNote() {
// 检查笔记是否值得保存
if (isWorthSaving()) {
// 如果笔记在数据库中不存在
if (!existInDatabase()) {
// 获取一个新的笔记ID
if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
// 如果获取ID失败，记录错误日志并返回false
Log.e(TAG, "Create new note fail with id:" + mNoteId);
return false;
}
}
// 同步笔记数据到数据库
mNote.syncNote(mContext, mNoteId);
// 如果笔记关联了小部件，并且小部件有效，通知小部件内容已更改
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE
&& mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
}
return true; // 保存成功
} else {
return false; // 不值得保存
}
}
// 检查笔记是否存在于数据库中
public boolean existInDatabase() {
return mNoteId > 0;
}
// 检查笔记是否值得保存
private boolean isWorthSaving() {
// 如果笔记被标记为删除，或者不存在于数据库中且内容为空，或者存在于数据库中但未被本地修改，则不值得保存
if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
|| (existInDatabase() && !mNote.isLocalModified())) {
return false;
} else {
return true;
}
}
// 设置笔记设置状态改变的监听器
public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
mNoteSettingStatusListener = l;
}
// 设置提醒日期
public void setAlertDate(long date, boolean set) {
// 如果设置的日期与当前日期不同，更新日期并通知监听器
if (date != mAlertDate) {
mAlertDate = date;
mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
}
// 如果设置了监听器，通知监听器提醒日期已更改
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onClockAlertChanged(date, set);
}
}
// 标记笔记为已删除或未删除
public void markDeleted(boolean mark) {
mIsDeleted = mark;
// 如果笔记关联了小部件，并且小部件有效，通知小部件内容已更改
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
&& mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onWidgetChanged();
}
}
// 设置笔记背景颜色ID
public void setBgColorId(int id) {
// 如果设置的ID与当前ID不同，更新ID并通知监听器
if (id != mBgColorId) {
mBgColorId = id;
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onBackgroundColorChanged();
}
mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
}
}
// 设置检查列表模式
public void setCheckListMode(int mode) {
// 如果设置的模式与当前模式不同，更新模式并通知监听器
if (mMode != mode) {
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
}
mMode = mode;
mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
}
}
// 设置小部件类型
public void setWidgetType(int type) {
// 如果设置的小部件类型与当前类型不同，更新类型
if (type != mWidgetType) {
mWidgetType = type;
mNote.setNoteValue(NoteColumns.WIDGET_TYPE, String.valueOf(mWidgetType));
}
}
// 设置小部件ID
public void setWidgetId(int id) {
// 如果设置的小部件ID与当前ID不同，更新ID
if (id != mWidgetId) {
mWidgetId = id;
mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
}
}
// 设置笔记内容
public void setWorkingText(String text) {
// 如果设置的内容与当前内容不同，更新内容
if (!TextUtils.equals(mContent, text)) {
mContent = text;
mNote.setTextData(DataColumns.CONTENT, mContent);
}
}
// 将笔记转换为电话笔记
public void convertToCallNote(String phoneNumber, long callDate) {
// 设置电话笔记的日期和电话号码
mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);
// 设置电话笔记所属的文件夹ID为电话记录文件夹
mNote.setNoteValue(NoteColumns.PARENT_ID, String.valueOf(Notes.ID_CALL_RECORD_FOLDER));
}
// 检查笔记是否有提醒日期
public boolean hasClockAlert() {
return (mAlertDate > 0 ? true : false);
}
// 获取笔记内容
public String getContent() {
return mContent;
}
// 获取笔记的提醒日期
public long getAlertDate() {
return mAlertDate;
}
// 获取笔记的最后修改日期
public long getModifiedDate() {
return mModifiedDate;
}
// 获取笔记背景颜色的资源ID
public int getBgColorResId() {
return NoteBgResources.getNoteBgResource(mBgColorId);
}
// 获取笔记背景颜色的ID
public int getBgColorId

BIN
泛读报告.docx
View File

Binary file not shown.

BIN
质量分析徐睿嘉.docx
View File

Binary file not shown.
Write Preview
Loading…
Cancel
Save