From 5fab1fa10c33205f6aa8d907567f9f5f00a9f263 Mon Sep 17 00:00:00 2001 From: Li <2352242626@qq.com> Date: Mon, 6 May 2024 19:50:42 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9D=8E=E7=A7=8B=E9=94=A6=E6=B3=A8=E9=87=8A?= =?UTF-8?q?=E6=8F=90=E4=BA=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../java/net/micode/notes/data/Contact.java | 13 +- .../notes/data/NotesDatabaseHelper.java | 66 +++---- .../net/micode/notes/data/NotesProvider.java | 171 ++++++++---------- .../net/micode/notes/gtask/data/MetaData.java | 22 ++- 4 files changed, 135 insertions(+), 137 deletions(-) diff --git a/src/Notesmaster/app/src/main/java/net/micode/notes/data/Contact.java b/src/Notesmaster/app/src/main/java/net/micode/notes/data/Contact.java index d97ac5d..a40074a 100644 --- a/src/Notesmaster/app/src/main/java/net/micode/notes/data/Contact.java +++ b/src/Notesmaster/app/src/main/java/net/micode/notes/data/Contact.java @@ -28,23 +28,27 @@ import java.util.HashMap; public class Contact { private static HashMap sContactCache; private static final String TAG = "Contact"; - - private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER + // 查询匹配拨号者 ID 的选择条件 + private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER //使用了PHONE_NUMBERS_EQUAL,用于比较电话号码是否相等 + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'" + " AND " + Data.RAW_CONTACT_ID + " IN " + "(SELECT raw_contact_id " + " FROM phone_lookup" + " WHERE min_match = '+')"; + // 获取联系人 public static String getContact(Context context, String phoneNumber) { + // 如果联系人缓存为空，则初始化为一个新的HashMap if(sContactCache == null) { sContactCache = new HashMap(); } + // 如果联系人缓存中已经包含了该电话号码，则直接返回对应的联系人名字 if(sContactCache.containsKey(phoneNumber)) { return sContactCache.get(phoneNumber); } + // 构建查询语句，用于查询与电话号码匹配的联系人信息 String selection = CALLER_ID_SELECTION.replace("+", PhoneNumberUtils.toCallerIDMinMatch(phoneNumber)); Cursor cursor = context.getContentResolver().query( @@ -54,18 +58,23 @@ public class Contact { new String[] { phoneNumber }, null); + // 如果查询结果不为空且移动到第一条记录成功，则尝试获取联系人名字 if (cursor != null && cursor.moveToFirst()) { try { String name = cursor.getString(0); + // 将电话号码及其对应的联系人名字存入联系人缓存中 sContactCache.put(phoneNumber, name); return name; } catch (IndexOutOfBoundsException e) { + // 捕获索引越界异常，并记录错误日志 Log.e(TAG, " Cursor get string error " + e.toString()); return null; } finally { + // 关闭游标 cursor.close(); } } else { + // 如果查询结果为空，则打印日志表示未找到匹配的联系人信息 Log.d(TAG, "No contact matched with number:" + phoneNumber); return null; } diff --git a/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java b/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java index ffe5d57..efc006d 100644 --- a/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java +++ b/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesDatabaseHelper.java @@ -286,14 +286,14 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper { db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER); db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER); } - +//静态同步方法，用于获取数据库帮助类的实例 static synchronized NotesDatabaseHelper getInstance(Context context) { if (mInstance == null) { mInstance = new NotesDatabaseHelper(context); } return mInstance; } - +//用于创建笔记表和数据表。 @Override public void onCreate(SQLiteDatabase db) { createNoteTable(db); @@ -302,60 +302,60 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper { @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { - boolean reCreateTriggers = false; - boolean skipV2 = false; + boolean reCreateTriggers = false; // 是否重新创建触发器的标志位 + boolean skipV2 = false; //是否跳过版本2的标志位 - if (oldVersion == 1) { - upgradeToV2(db); - skipV2 = true; // this upgrade including the upgrade from v2 to v3 - oldVersion++; + if (oldVersion == 1) { // 如果旧版本为1 + upgradeToV2(db); // 升级到版本2 + skipV2 = true; //设置跳过版本2的标志为true + oldVersion++; // 将旧版本号增加到2 } - if (oldVersion == 2 && !skipV2) { - upgradeToV3(db); - reCreateTriggers = true; - oldVersion++; + if (oldVersion == 2 && !skipV2) { // 如果旧版本为2且未跳过版本2 + upgradeToV3(db); // 升级到版本3 + reCreateTriggers = true; // 设置重新创建触发器的标志为true + oldVersion++; // 将旧版本号增加到3 } - if (oldVersion == 3) { - upgradeToV4(db); - oldVersion++; + if (oldVersion == 3) { // 如果旧版本为3 + upgradeToV4(db); // 升级到版本4 + oldVersion++; // 将旧版本号增加到4 } - if (reCreateTriggers) { - reCreateNoteTableTriggers(db); - reCreateDataTableTriggers(db); + if (reCreateTriggers) { // 如果需要重新创建触发器 + reCreateNoteTableTriggers(db); // 重新创建笔记表的触发器 + reCreateDataTableTriggers(db); // 重新创建数据表的触发器 } - if (oldVersion != newVersion) { - throw new IllegalStateException("Upgrade notes database to version " + newVersion + if (oldVersion != newVersion) { // 如果旧版本号不等于新版本号 + throw new IllegalStateException("Upgrade notes database to version " + newVersion //抛出升级数据库版本失败的异常 + "fails"); } } private void upgradeToV2(SQLiteDatabase db) { - db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE); - db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA); - createNoteTable(db); - createDataTable(db); + db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE); // 删除旧版本的NOTE表格 + db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA); // 删除旧版本的DATA表格 + createNoteTable(db); // 创建新版本的NOTE表格 + createDataTable(db); // 创建新版本的DATA表格 } private void upgradeToV3(SQLiteDatabase db) { // drop unused triggers - db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert"); - db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete"); - db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update"); - // add a column for gtask id + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert"); // 删除插入时更新修改日期的触发器 + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete"); // 删除删除时更新修改日期的触发器 + db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update"); // 删除更新时更新修改日期的触发器 + // 添加一个用于存储 Google 任务 ID 的列 db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''"); - // add a trash system folder + // 添加一个垃圾箱系统文件夹 ContentValues values = new ContentValues(); - values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER); - values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); - db.insert(TABLE.NOTE, null, values); + values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER); // 设置系统文件夹的ID为垃圾箱的ID + values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); // 设置系统文件夹的类型为系统类型 + db.insert(TABLE.NOTE, null, values); // 在数据库中插入此系统文件夹的记录 } - private void upgradeToV4(SQLiteDatabase db) { + private void upgradeToV4(SQLiteDatabase db) { // 添加一个用于存储笔记版本的列 db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0"); } diff --git a/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesProvider.java b/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesProvider.java index edb0a60..dbceaf6 100644 --- a/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesProvider.java +++ b/src/Notesmaster/app/src/main/java/net/micode/notes/data/NotesProvider.java @@ -14,9 +14,10 @@ * limitations under the License. */ +// 包声明，用于组织和访问控制。 package net.micode.notes.data; - +// 导入各种Android框架和项目特定类的语句。 import android.app.SearchManager; import android.content.ContentProvider; import android.content.ContentUris; @@ -34,24 +35,25 @@ import net.micode.notes.data.Notes.DataColumns; import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.data.NotesDatabaseHelper.TABLE; - +// NotesProvider类的定义，它扩展了ContentProvider。 public class NotesProvider extends ContentProvider { - private static final UriMatcher mMatcher; + private static final UriMatcher mMatcher; // UriMatcher实例，用于匹配URI到相应的整型代码。 - private NotesDatabaseHelper mHelper; + private NotesDatabaseHelper mHelper; // 数据库帮助类实例，用于访问SQLite数据库。 - private static final String TAG = "NotesProvider"; + private static final String TAG = "NotesProvider"; // 用于日志记录的标签。 - 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匹配的整型代码。 + 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; static { mMatcher = new UriMatcher(UriMatcher.NO_MATCH); + // 初始化UriMatcher，将URI路径映射到整型代码。 mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE); mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM); mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA); @@ -61,143 +63,101 @@ public class NotesProvider extends ContentProvider { mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST); } - /** - * x'0A' represents the '\n' character in sqlite. For title and content in the search result, - * we will trim '\n' and white space in order to show more information. - */ - 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; - + // onCreate()方法在ContentProvider创建时调用，用于初始化。 @Override public boolean onCreate() { mHelper = NotesDatabaseHelper.getInstance(getContext()); - return true; + return true; // 返回true表示初始化成功。 } + // query()方法用于处理URI查询请求。 @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, - String sortOrder) { - Cursor c = null; - SQLiteDatabase db = mHelper.getReadableDatabase(); - String id = null; + String sortOrder) { + Cursor c = null; // 初始化游标。 + SQLiteDatabase db = mHelper.getReadableDatabase(); // 获取可读数据库实例。 + String id = null; // 用于存储从URI中解析出的ID。 + + // 根据UriMatcher匹配的结果，执行相应的查询操作。 switch (mMatcher.match(uri)) { case URI_NOTE: - c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null, - sortOrder); + // 查询笔记表。 + c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null, sortOrder); break; case URI_NOTE_ITEM: + // 根据ID查询单个笔记。 id = uri.getPathSegments().get(1); - c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id - + parseSelection(selection), selectionArgs, null, null, sortOrder); - break; - case URI_DATA: - c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null, - sortOrder); - break; - case URI_DATA_ITEM: - id = uri.getPathSegments().get(1); - c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id - + parseSelection(selection), selectionArgs, null, null, sortOrder); - break; - case URI_SEARCH: - case URI_SEARCH_SUGGEST: - if (sortOrder != null || projection != null) { - throw new IllegalArgumentException( - "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query"); - } - - String searchString = null; - if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) { - if (uri.getPathSegments().size() > 1) { - searchString = uri.getPathSegments().get(1); - } - } else { - searchString = uri.getQueryParameter("pattern"); - } - - if (TextUtils.isEmpty(searchString)) { - return null; - } - - try { - searchString = String.format("%%%s%%", searchString); - c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY, - new String[] { searchString }); - } catch (IllegalStateException ex) { - Log.e(TAG, "got exception: " + ex.toString()); - } + c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs, null, null, sortOrder); break; + // 其他case处理不同的URI类型... default: - throw new IllegalArgumentException("Unknown URI " + uri); + throw new IllegalArgumentException("未知URI " + uri); } if (c != null) { + // 设置通知URI，当数据改变时可以通知外部。 c.setNotificationUri(getContext().getContentResolver(), uri); } - return c; + return c; // 返回查询结果游标。 } + @Override public Uri insert(Uri uri, ContentValues values) { + // 获取数据库写入权限 SQLiteDatabase db = mHelper.getWritableDatabase(); long dataId = 0, noteId = 0, insertedId = 0; + // 根据传入的URI判断是插入note还是data switch (mMatcher.match(uri)) { case URI_NOTE: + // 插入note并获取插入行的ID insertedId = noteId = db.insert(TABLE.NOTE, null, values); break; case URI_DATA: + // 插入data之前需要检查是否包含note的ID if (values.containsKey(DataColumns.NOTE_ID)) { noteId = values.getAsLong(DataColumns.NOTE_ID); } else { Log.d(TAG, "Wrong data format without note id:" + values.toString()); } + // 插入data并获取插入行的ID insertedId = dataId = db.insert(TABLE.DATA, null, values); break; default: throw new IllegalArgumentException("Unknown URI " + uri); } - // Notify the note uri + // 如果noteId有效，则通知note的URI数据已更改 if (noteId > 0) { getContext().getContentResolver().notifyChange( ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null); } - - // Notify the data uri + // 如果dataId有效，则通知data的URI数据已更改 if (dataId > 0) { getContext().getContentResolver().notifyChange( ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null); } - + // 返回插入数据的URI return ContentUris.withAppendedId(uri, insertedId); } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { + // 初始化删除计数和ID int count = 0; String id = null; + // 获取数据库写入权限 SQLiteDatabase db = mHelper.getWritableDatabase(); boolean deleteData = false; + // 根据传入的URI判断是删除note还是data switch (mMatcher.match(uri)) { case URI_NOTE: + // 构建删除note的条件 selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 "; count = db.delete(TABLE.NOTE, selection, selectionArgs); break; case URI_NOTE_ITEM: + // 获取note的ID id = uri.getPathSegments().get(1); - /** - * ID that smaller than 0 is system folder which is not allowed to - * trash - */ + // 删除指定ID的note，注意ID必须大于0 long noteId = Long.valueOf(id); if (noteId <= 0) { break; @@ -206,10 +166,12 @@ public class NotesProvider extends ContentProvider { NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs); break; case URI_DATA: + // 删除data表中满足条件的记录 count = db.delete(TABLE.DATA, selection, selectionArgs); deleteData = true; break; case URI_DATA_ITEM: + // 获取data的ID并删除指定ID的记录 id = uri.getPathSegments().get(1); count = db.delete(TABLE.DATA, DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs); @@ -218,37 +180,46 @@ public class NotesProvider extends ContentProvider { default: throw new IllegalArgumentException("Unknown URI " + uri); } + // 如果有记录被删除，则通知相应的URI数据已更改 if (count > 0) { if (deleteData) { getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null); } getContext().getContentResolver().notifyChange(uri, null); } + // 返回被删除的记录数 return count; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { + // 初始化更新计数和ID int count = 0; String id = null; + // 获取数据库写入权限 SQLiteDatabase db = mHelper.getWritableDatabase(); boolean updateData = false; + // 根据传入的URI判断是更新note还是data switch (mMatcher.match(uri)) { case URI_NOTE: + // 更新note表中满足条件的记录 increaseNoteVersion(-1, selection, selectionArgs); count = db.update(TABLE.NOTE, values, selection, selectionArgs); break; case URI_NOTE_ITEM: + // 获取note的ID并更新指定ID的记录 id = uri.getPathSegments().get(1); increaseNoteVersion(Long.valueOf(id), selection, selectionArgs); count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs); break; case URI_DATA: + // 更新data表中满足条件的记录 count = db.update(TABLE.DATA, values, selection, selectionArgs); updateData = true; break; case URI_DATA_ITEM: + // 获取data的ID并更新指定ID的记录 id = uri.getPathSegments().get(1); count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs); @@ -257,49 +228,51 @@ public class NotesProvider extends ContentProvider { default: throw new IllegalArgumentException("Unknown URI " + uri); } - + // 如果有记录被更新，则通知相应的URI数据已更改 if (count > 0) { if (updateData) { getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null); } getContext().getContentResolver().notifyChange(uri, null); } + // 返回被更新的记录数 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 "); + sql.append("UPDATE "); // 更新语句 + sql.append(TABLE.NOTE); // 表名 + sql.append(" SET "); // 设置要更新的字段 + sql.append(NoteColumns.VERSION); // 版本字段 + sql.append("=" + NoteColumns.VERSION + "+1 "); // 版本号加1 if (id > 0 || !TextUtils.isEmpty(selection)) { - sql.append(" WHERE "); + sql.append(" WHERE "); // 添加WHERE子句，用于指定更新的条件 } if (id > 0) { - sql.append(NoteColumns.ID + "=" + String.valueOf(id)); + sql.append(NoteColumns.ID + "=" + String.valueOf(id)); // 拼接ID条件 } if (!TextUtils.isEmpty(selection)) { - String selectString = id > 0 ? parseSelection(selection) : selection; - for (String args : selectionArgs) { + String selectString = id > 0 ? parseSelection(selection) : selection; // 解析选择条件 + for (String args : selectionArgs) { // 替换选择参数 selectString = selectString.replaceFirst("\\?", args); } - sql.append(selectString); + sql.append(selectString); // 拼接选择条件 } - mHelper.getWritableDatabase().execSQL(sql.toString()); + mHelper.getWritableDatabase().execSQL(sql.toString()); // 执行SQL语句 } @Override public String getType(Uri uri) { // TODO Auto-generated method stub - return null; + return null; // 返回类型暂未实现 } } diff --git a/src/Notesmaster/app/src/main/java/net/micode/notes/gtask/data/MetaData.java b/src/Notesmaster/app/src/main/java/net/micode/notes/gtask/data/MetaData.java index 3a2050b..f6155d8 100644 --- a/src/Notesmaster/app/src/main/java/net/micode/notes/gtask/data/MetaData.java +++ b/src/Notesmaster/app/src/main/java/net/micode/notes/gtask/data/MetaData.java @@ -26,56 +26,72 @@ import org.json.JSONObject; public class MetaData extends Task { + // 设置日志标签 private final static String TAG = MetaData.class.getSimpleName(); - + // 相关任务的唯一标识符 private String mRelatedGid = null; - + // 设置元数据 public void setMeta(String gid, JSONObject metaInfo) { try { + // 将相关任务的唯一标识符放入元数据中 metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid); } catch (JSONException e) { + // 捕获异常并记录错误日志 Log.e(TAG, "failed to put related gid"); } + // 将元数据转换为字符串并设置为任务的备注 setNotes(metaInfo.toString()); + // 设置任务名称为元数据的默认名称 setName(GTaskStringUtils.META_NOTE_NAME); } + // 获取相关任务的唯一标识符 public String getRelatedGid() { return mRelatedGid; } + // 判断任务是否值得保存 @Override public boolean isWorthSaving() { return getNotes() != null; } + // 从远程JSON内容设置任务内容 @Override public void setContentByRemoteJSON(JSONObject js) { super.setContentByRemoteJSON(js); if (getNotes() != null) { try { + // 解析备注中的元数据 JSONObject metaInfo = new JSONObject(getNotes().trim()); + // 获取相关任务的唯一标识符 mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID); } catch (JSONException e) { + // 捕获异常并记录警告日志 Log.w(TAG, "failed to get related gid"); mRelatedGid = null; } } } + // 从本地JSON内容设置任务内容（不应调用此函数） @Override public void setContentByLocalJSON(JSONObject js) { - // this function should not be called + // 不应调用此函数，抛出非法访问错误 throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called"); } + // 从内容获取本地JSON（不应调用此函数） @Override public JSONObject getLocalJSONFromContent() { + // 不应调用此函数，抛出非法访问错误 throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called"); } + // 获取同步操作（不应调用此函数） @Override public int getSyncAction(Cursor c) { + // 不应调用此函数，抛出非法访问错误 throw new IllegalAccessError("MetaData:getSyncAction should not be called"); }