pq5n3hobs
/
xiaomi
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

gtask-data-4

Browse Source
zhonghaoyu
pq5n3hobs 8 months ago
parent adbbed468e
commit 53851e4e9b
1 changed files with 350 additions and 0 deletions
Show Stats Download Patch File Download Diff File

350
SqlNote.java
Unescape View File

@ -0,0 +1,350 @@
/*
* Copyright (c) 2010 - 2011, The MiCode Open Source Community (www.micode.net)
*
* 遵循 Apache 许可证 2.0 版（“许可证”）；
* 除非遵守许可证，否则不得使用此文件。
* 你可以在以下网址获取许可证副本：
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* 除非适用法律要求或书面同意，
* 根据许可证分发的软件按“原样”分发，
* 不附带任何明示或暗示的保证或条件。
* 请参阅许可证，了解具体的权限和限制。
*/
package net.micode.notes.gtask.data;
import android.appwidget.AppWidgetManager; // 用于管理应用小部件的类
import android.content.ContentResolver; // 用于与 ContentProvider 进行交互的类
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; // 导入与 GTask 字符串处理相关的工具类
import net.micode.notes.tool.ResourceParser; // 导入资源解析工具类
import org.json.JSONArray; // 用于处理 JSON 数组的类
import org.json.JSONException; // 用于处理 JSON 异常的类
import org.json.JSONObject; // 用于处理 JSON 对象的类
import java.util.ArrayList; // 用于处理动态数组的类
// SqlNote 类用于处理与 SQLite 数据库中笔记相关的操作
public class SqlNote {
// 用于日志记录的标签，使用类的简单名称
private static final String TAG = SqlNote.class.getSimpleName();
// 定义无效的 ID 值
private static final int INVALID_ID = -99999;
// 定义查询笔记时使用的投影列
public static final String[] PROJECTION_NOTE = new String[] {
NoteColumns.ID, // 笔记的唯一标识
NoteColumns.ALERTED_DATE, // 提醒日期
NoteColumns.BG_COLOR_ID, // 背景颜色 ID
NoteColumns.CREATED_DATE, // 创建日期
NoteColumns.HAS_ATTACHMENT, // 是否有附件
NoteColumns.MODIFIED_DATE, // 修改日期
NoteColumns.NOTES_COUNT, // 子笔记数量
NoteColumns.PARENT_ID, // 父笔记 ID
NoteColumns.SNIPPET, // 摘要
NoteColumns.TYPE, // 笔记类型
NoteColumns.WIDGET_ID, // 小部件 ID
NoteColumns.WIDGET_TYPE, // 小部件类型
NoteColumns.SYNC_ID, // 同步 ID
NoteColumns.LOCAL_MODIFIED, // 本地修改标识
NoteColumns.ORIGIN_PARENT_ID, // 原始父笔记 ID
NoteColumns.GTASK_ID, // GTask ID
NoteColumns.VERSION // 版本号
};
// 定义投影列中笔记 ID 所在的索引
public static final int ID_COLUMN = 0;
// 定义投影列中提醒日期所在的索引
public static final int ALERTED_DATE_COLUMN = 1;
// 定义投影列中背景颜色 ID 所在的索引
public static final int BG_COLOR_ID_COLUMN = 2;
// 定义投影列中创建日期所在的索引
public static final int CREATED_DATE_COLUMN = 3;
// 定义投影列中是否有附件所在的索引
public static final int HAS_ATTACHMENT_COLUMN = 4;
// 定义投影列中修改日期所在的索引
public static final int MODIFIED_DATE_COLUMN = 5;
// 定义投影列中子笔记数量所在的索引
public static final int NOTES_COUNT_COLUMN = 6;
// 定义投影列中父笔记 ID 所在的索引
public static final int PARENT_ID_COLUMN = 7;
// 定义投影列中摘要所在的索引
public static final int SNIPPET_COLUMN = 8;
// 定义投影列中笔记类型所在的索引
public static final int TYPE_COLUMN = 9;
// 定义投影列中小部件 ID 所在的索引
public static final int WIDGET_ID_COLUMN = 10;
// 定义投影列中小部件类型所在的索引
public static final int WIDGET_TYPE_COLUMN = 11;
// 定义投影列中同步 ID 所在的索引
public static final int SYNC_ID_COLUMN = 12;
// 定义投影列中本地修改标识所在的索引
public static final int LOCAL_MODIFIED_COLUMN = 13;
// 定义投影列中原始父笔记 ID 所在的索引
public static final int ORIGIN_PARENT_ID_COLUMN = 14;
// 定义投影列中 GTask ID 所在的索引
public static final int GTASK_ID_COLUMN = 15;
// 定义投影列中版本号所在的索引
public static final int VERSION_COLUMN = 16;
// 应用程序上下文
private Context mContext;
// 用于与 ContentProvider 进行交互的 ContentResolver 对象
private ContentResolver mContentResolver;
// 表示是否为创建操作的标志
private boolean mIsCreate;
// 笔记的 ID
private long mId;
// 提醒日期
private long mAlertDate;
// 背景颜色 ID
private int mBgColorId;
// 创建日期
private long mCreatedDate;
// 是否有附件
private int mHasAttachment;
// 修改日期
private long mModifiedDate;
// 父笔记 ID
private long mParentId;
// 摘要
private String mSnippet;
// 笔记类型
private int mType;
// 小部件 ID
private int mWidgetId;
// 小部件类型
private int mWidgetType;
// 原始父笔记 ID
private long mOriginParent;
// 版本号
private long mVersion;
// 用于存储笔记差异的 ContentValues 对象
private ContentValues mDiffNoteValues;
// 用于存储笔记关联数据的列表
private ArrayList<SqlData> mDataList;
// 构造函数，用于创建一个新的 SqlNote 对象，通常用于创建新的笔记记录
public SqlNote(Context context) {
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = true;
mId = INVALID_ID;
mAlertDate = 0;
mBgColorId = ResourceParser.getDefaultBgId(context); // 获取默认背景颜色 ID
mCreatedDate = System.currentTimeMillis(); // 设置当前时间为创建日期
mHasAttachment = 0;
mModifiedDate = System.currentTimeMillis(); // 设置当前时间为修改日期
mParentId = 0;
mSnippet = "";
mType = Notes.TYPE_NOTE; // 默认笔记类型为普通笔记
mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; // 无效的小部件 ID
mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 无效的小部件类型
mOriginParent = 0;
mVersion = 0;
mDiffNoteValues = new ContentValues();
mDataList = new ArrayList<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 从数据库加载数据
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 从数据库查询并加载数据的私有方法
private void loadFromCursor(long id) {
Cursor c = null;
try {
// 使用 ContentResolver 查询指定 ID 的笔记
c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",
new String[] {
String.valueOf(id)
}, null);
if (c!= null) {
c.moveToNext();
loadFromCursor(c); // 调用另一个 loadFromCursor 方法处理查询结果
} else {
Log.w(TAG, "loadFromCursor: cursor = null"); // 如果查询结果为空，记录警告日志
}
} finally {
if (c!= null)
c.close(); // 关闭 Cursor，释放资源
}
}
// 从 Cursor 中加载笔记数据的私有方法
private void loadFromCursor(Cursor c) {
mId = c.getLong(ID_COLUMN);
mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
mParentId = c.getLong(PARENT_ID_COLUMN);
mSnippet = c.getString(SNIPPET_COLUMN);
mType = c.getInt(TYPE_COLUMN);
mWidgetId = c.getInt(WIDGET_ID_COLUMN);
mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
mVersion = c.getLong(VERSION_COLUMN);
}
// 加载笔记关联数据的私有方法
private void loadDataContent() {
Cursor c = null;
mDataList.clear(); // 清空原有的数据列表
try {
// 使用 ContentResolver 查询与当前笔记关联的数据
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); // 根据查询结果创建 SqlData 对象
mDataList.add(data); // 将创建的 SqlData 对象添加到列表中
}
} else {
Log.w(TAG, "loadDataContent: cursor = null"); // 如果查询结果为空，记录警告日志
}
} finally {
if (c!= null)
c.close(); // 关闭 Cursor，释放资源
}
}
// 根据 JSON 对象设置笔记内容的方法
public boolean setContent(JSONObject js) {
try {
// 从 JSON 对象中获取笔记部分的内容
JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
Log.w(TAG, "cannot set system folder"); // 如果是系统文件夹，记录警告日志
} else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
// 对于文件夹，只能更新摘要和类型
String snippet = note.has(NoteColumns.SNIPPET)? note
.getString(NoteColumns.SNIPPET) : "";
if (mIsCreate ||!mSnippet.equals(snippet)) {
mDiffNoteValues.put(NoteColumns.SNIPPET, snippet); // 将摘要差异放入 ContentValues
}
mSnippet = snippet;
int type = note.has(NoteColumns.TYPE)? note.getInt(NoteColumns.TYPE)
: Notes.TYPE_NOTE;
if (mIsCreate || mType!= type) {
mDiffNoteValues.put(NoteColumns.TYPE, type); // 将类型差异放入 ContentValues
}
mType = type;
} else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
long id = note.has(NoteColumns.ID)? note.getLong(NoteColumns.ID) : INVALID_ID;
if (mIsCreate || mId!= id) {
mDiffNoteValues.put(NoteColumns.ID, id); // 将 ID 差异放入 ContentValues
}
mId = id;
long alertDate = note.has(NoteColumns.ALERTED_DATE)? note
.getLong(NoteColumns.ALERTED_DATE) : 0;
if (mIsCreate || mAlertDate!= alertDate) {
mDiffNoteValues.put(NoteColumns.ALERTED_DATE, alertDate); // 将提醒日期差异放入 ContentValues
}
mAlertDate = alertDate;
int bgColorId = note.has(NoteColumns.BG_COLOR_ID)? note
.getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
if (mIsCreate || mBgColorId!= bgColorId) {
mDiffNoteValues.put(NoteColumns.BG_COLOR_ID, bgColorId); // 将背景颜色 ID 差异放入 ContentValues
}
mBgColorId = bgColorId;
long createDate = note.has(NoteColumns.CREATED_DATE)? note
.getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
if (mIsCreate || mCreatedDate!= createDate) {
mDiffNoteValues.put(NoteColumns.CREATED_DATE, createDate); // 将创建日期差异放入 ContentValues
}
mCreatedDate = createDate;
int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT)? note
.getInt(NoteColumns.HAS_ATTACHMENT) : 0;
if (mIsCreate || mHasAttachment!= hasAttachment) {
mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT, hasAttachment); // 将是否有附件差异放入 ContentValues
}
mHasAttachment = hasAttachment;
long modifiedDate = note.has(NoteColumns.MODIFIED_DATE)? note
.getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
if (mIsCreate || mModifiedDate!= modifiedDate) {
mDiffNoteValues.put(NoteColumns.MODIFIED_DATE, modifiedDate); // 将修改日期差异放入 ContentValues
}
mModifiedDate = modifiedDate;
long parentId = note.has(NoteColumns.PARENT_ID)? note
.getLong(NoteColumns.PARENT_ID) : 0;
if (mIsCreate || mParentId!= parentId) {
mDiffNoteValues.put(NoteColumns.PARENT_ID, parentId); // 将父笔记 ID 差异放入 ContentValues
}
mParentId = parentId;
String snippet = note.has(NoteColumns.SNIPPET)? note
.getString(NoteColumns.SNIPPET) : "";
if (mIsCreate ||!mSnippet.equals(snippet)) {
mDiffNoteValues.put(NoteColumns.SNIPPET, snippet); // 将摘要差异放入 ContentValues
}
mSnippet = snippet;
int type = note.has(NoteColumns.TYPE)? note.getInt(NoteColumns.TYPE)
: Notes.TYPE_NOTE;
if (mIsCreate || mType!= type) {
mDiffNoteValues.put(NoteColumns.TYPE, type); // 将笔记类型差异放入 ContentValues
}
mType = type;
int widgetId = note.has(NoteColumns.WIDGET_ID)? note.getInt(NoteColumns.WIDGET_ID)
: AppWidgetManager.INVALID_APPWIDGET_ID;
if (mIsCreate || mWidgetId!= widgetId) {
mDiffNoteValues.put(NoteColumns.WIDGET_ID, widgetId); // 将小部件 ID 差异放入 ContentValues
}
mWidgetId = widgetId;
int widgetType = note.has(NoteColumns.WIDGET_TYPE)? note
.getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
if (mIsCreate || mWidgetType!= widgetType) {
mDiffNoteValues.put(NoteColumns.WIDGET_TYPE, widgetType); // 将小部件类型差异放入 ContentValues
}
mWidgetType = widgetType;
long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID
Write Preview
Loading…
Cancel
Save