From a7857809eb8014ea65bfed5b447740b0f59de277 Mon Sep 17 00:00:00 2001 From: yhz <2678576348@qq.com> Date: Sun, 12 Jan 2025 22:11:43 +0800 Subject: [PATCH] yhz --- src/data/Contact.java | 80 -- src/data/Notes.java | 273 ---- src/data/NotesDatabaseHelper.java | 381 ----- src/data/NotesProvider.java | 358 ----- src/gtask/data/MetaData.java | 125 -- src/gtask/data/Node.java | 123 -- src/gtask/data/SqlData.java | 222 --- src/gtask/data/SqlNote.java | 513 ------- src/gtask/data/Task.java | 415 ------ src/gtask/data/TaskList.java | 463 ------- .../exception/ActionFailureException.java | 53 - .../exception/NetworkFailureException.java | 47 - src/gtask/remote/GTaskASyncTask.java | 152 -- src/gtask/remote/GTaskClient.java | 1234 ----------------- src/gtask/remote/GTaskManager.java | 948 ------------- src/gtask/remote/GTaskSyncService.java | 169 --- src/{ui => model}/NoteItemData.java | 0 src/{ui => model}/NoteWidgetProvider.java | 0 src/{ui => model}/Notes.java | 0 src/{ui => model}/NotesDatabaseHelper.java | 0 src/{ui => model}/NotesListActivity.java | 0 src/{ui => model}/NotesListAdapter.java | 0 src/{ui => model}/NotesListItem.java | 0 .../NotesPreferenceActivity.java | 0 src/tool/BackupUtils.java | 279 ---- src/tool/DataUtils.java | 406 ------ src/tool/GTaskStringUtils.java | 64 - src/tool/ResourceParser.java | 212 --- src/ui/AlarmAlertActivity.java | 196 --- src/ui/AlarmInitReceiver.java | 71 - src/ui/AlarmReceiver.java | 30 - src/ui/DateTimePicker.java | 583 -------- src/ui/DateTimePickerDialog.java | 121 -- src/ui/DropdownMenu.java | 73 - src/ui/FoldersListAdapter.java | 110 -- src/ui/NoteEditActivity.java | 1141 --------------- src/ui/NoteEditText.java | 267 ---- src/widget/NoteWidgetProvider.java | 159 --- src/widget/NoteWidgetProvider_2x.java | 76 - src/widget/NoteWidgetProvider_4x.java | 74 - 40 files changed, 9418 deletions(-) delete mode 100644 src/data/Contact.java delete mode 100644 src/data/Notes.java delete mode 100644 src/data/NotesDatabaseHelper.java delete mode 100644 src/data/NotesProvider.java delete mode 100644 src/gtask/data/MetaData.java delete mode 100644 src/gtask/data/Node.java delete mode 100644 src/gtask/data/SqlData.java delete mode 100644 src/gtask/data/SqlNote.java delete mode 100644 src/gtask/data/Task.java delete mode 100644 src/gtask/data/TaskList.java delete mode 100644 src/gtask/exception/ActionFailureException.java delete mode 100644 src/gtask/exception/NetworkFailureException.java delete mode 100644 src/gtask/remote/GTaskASyncTask.java delete mode 100644 src/gtask/remote/GTaskClient.java delete mode 100644 src/gtask/remote/GTaskManager.java delete mode 100644 src/gtask/remote/GTaskSyncService.java rename src/{ui => model}/NoteItemData.java (100%) rename src/{ui => model}/NoteWidgetProvider.java (100%) rename src/{ui => model}/Notes.java (100%) rename src/{ui => model}/NotesDatabaseHelper.java (100%) rename src/{ui => model}/NotesListActivity.java (100%) rename src/{ui => model}/NotesListAdapter.java (100%) rename src/{ui => model}/NotesListItem.java (100%) rename src/{ui => model}/NotesPreferenceActivity.java (100%) delete mode 100644 src/tool/BackupUtils.java delete mode 100644 src/tool/DataUtils.java delete mode 100644 src/tool/GTaskStringUtils.java delete mode 100644 src/tool/ResourceParser.java delete mode 100644 src/ui/AlarmAlertActivity.java delete mode 100644 src/ui/AlarmInitReceiver.java delete mode 100644 src/ui/AlarmReceiver.java delete mode 100644 src/ui/DateTimePicker.java delete mode 100644 src/ui/DateTimePickerDialog.java delete mode 100644 src/ui/DropdownMenu.java delete mode 100644 src/ui/FoldersListAdapter.java delete mode 100644 src/ui/NoteEditActivity.java delete mode 100644 src/ui/NoteEditText.java delete mode 100644 src/widget/NoteWidgetProvider.java delete mode 100644 src/widget/NoteWidgetProvider_2x.java delete mode 100644 src/widget/NoteWidgetProvider_4x.java diff --git a/src/data/Contact.java b/src/data/Contact.java deleted file mode 100644 index 19db60e..0000000 --- a/src/data/Contact.java +++ /dev/null @@ -1,80 +0,0 @@ -/* - * Contact 类用于通过电话号码查询联系人信息。 - * 该类实现了从联系人数据库中获取与特定电话号码相关联的显示名称 - */ - -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; - -public class Contact { - // 缓存已查询过的电话号码和对应的联系人名称，以减少数据库查询次数。 - private static HashMap sContactCache; - private static final String TAG = "Contact"; // 日志标签 - - // 用于查询具有完整国际号码格式的电话号码的selection字符串。 - 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 = '+')"; - - /** - * 根据电话号码获取联系人名称。 - * - * @param context 上下文对象，用于访问内容解析器。 - * @param phoneNumber 需要查询的电话号码。 - * @return 与电话号码相关联的联系人名称，如果找不到则返回null。 - */ - public static String getContact(Context context, String phoneNumber) { - // 初始化或获取联系人缓存 - if (sContactCache == null) { - sContactCache = new HashMap(); - } - - // 从缓存中直接获取联系人名称，如果存在。 - if (sContactCache.containsKey(phoneNumber)) { - return sContactCache.get(phoneNumber); - } - - // 使用PhoneNumberUtils将电话号码格式化为适合查询的形式 - String selection = CALLER_ID_SELECTION.replace("+", - PhoneNumberUtils.toCallerIDMinMatch(phoneNumber)); - - // 执行查询以获取与电话号码相关联的联系人名称 - 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) { - // 处理查询结果异常 - 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/data/Notes.java b/src/data/Notes.java deleted file mode 100644 index 226763b..0000000 --- a/src/data/Notes.java +++ /dev/null @@ -1,273 +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.net.Uri; - -// Notes类定义了与笔记和文件夹相关的常量和数据列接口 -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是系统文件夹的标识符 - * {@link Notes#ID_ROOT_FOLDER} 是默认文件夹 - * {@link Notes#ID_TEMPARAY_FOLDER} 是属于没有文件夹的笔记 - * {@link Notes#ID_CALL_RECORD_FOLDER} 是用于存储通话记录的 - */ - public static final int ID_ROOT_FOLDER = 0; // 根文件夹ID - public static final int ID_TEMPARAY_FOLDER = -1; // 临时文件夹ID，用于存放不属于任何文件夹的笔记 - public static final int ID_CALL_RECORD_FOLDER = -2; // 通话记录文件夹ID - public static final int ID_TRASH_FOLER = -3; // 垃圾箱文件夹ID - - public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date"; // 用于Intent的提醒日期额外数据 - public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id"; // 笔记背景色ID - public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id"; // 小部件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"; // 文件夹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; // 2x小部件类型 - public static final int TYPE_WIDGET_4X = 1; // 4x小部件类型 - - 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 { - /** - * 行的唯一ID - *

类型: INTEGER (long)

- */ - public static final String ID = "_id"; - - /** - * 笔记或文件夹的父ID - *

类型: INTEGER (long)

- */ - public static final String PARENT_ID = "parent_id"; - - /** - * 创建日期 - *

类型: INTEGER (long)

- */ - public static final String CREATED_DATE = "created_date"; - - /** - * 最后修改日期 - *

类型: INTEGER (long)

- */ - public static final String MODIFIED_DATE = "modified_date"; - - /** - * 提醒日期 - *

类型: INTEGER (long)

- */ - public static final String ALERTED_DATE = "alert_date"; - - /** - * 笔记或文件夹的摘要信息 - *

类型: TEXT

- */ - public static final String SNIPPET = "snippet"; - - /** - * 笔记的小部件ID - *

类型: INTEGER (long)

- */ - public static final String WIDGET_ID = "widget_id"; - - /** - * 笔记的小部件类型 - *

类型: INTEGER (long)

- */ - public static final String WIDGET_TYPE = "widget_type"; - - /** - * 笔记的背景色ID - *

类型: INTEGER (long)

- */ - public static final String BG_COLOR_ID = "bg_color_id"; - - /** - * 笔记是否有附件 - *

类型: INTEGER

- */ - public static final String HAS_ATTACHMENT = "has_attachment"; - - /** - * 笔记数量 - *

类型: INTEGER (long)

- */ - public static final String NOTES_COUNT = "notes_count"; - - /** - * 文件夹类型：0-笔记，1-文件夹 - *

类型: INTEGER

- */ - public static final String TYPE = "type"; - - /** - * 最后同步ID - *

类型: INTEGER (long)

- */ - public static final String SYNC_ID = "sync_id"; - - /** - * 标记本地是否已修改 - *

类型: INTEGER

- */ - public static final String LOCAL_MODIFIED = "local_modified"; - - /** - * 移入临时文件夹前的原始父ID - *

类型: INTEGER

- */ - public static final String ORIGIN_PARENT_ID = "origin_parent_id"; - - /** - * Google任务ID - *

类型: TEXT

- */ - public static final String GTASK_ID = "gtask_id"; - - /** - * 版本号 - *

类型: INTEGER (long)

- */ - public static final String VERSION = "version"; - } - - // 数据列接口 - public interface DataColumns { - /** - * 行的唯一ID - *

类型: INTEGER (long)

- */ - public static final String ID = "_id"; - - /** - * 该项的MIME类型。 - *

类型: TEXT

- */ - public static final String MIME_TYPE = "mime_type"; - - /** - * 属于的笔记的引用ID - *

类型: INTEGER (long)

- */ - public static final String NOTE_ID = "note_id"; - - /** - * 创建日期 - *

类型: INTEGER (long)

- */ - public static final String CREATED_DATE = "created_date"; - - /** - * 最后修改日期 - *

类型: INTEGER (long)

- */ - public static final String MODIFIED_DATE = "modified_date"; - - /** - * 数据内容 - *

类型: TEXT

- */ - public static final String CONTENT = "content"; - - /** - * 通用数据列，具体含义由{@link #MIME_TYPE}决定，用于存储整型数据 - *

类型: INTEGER

- */ - public static final String DATA1 = "data1"; - - /** - * 通用数据列，具体含义由{@link #MIME_TYPE}决定，用于存储整型数据 - *

类型: INTEGER

- */ - public static final String DATA2 = "data2"; - - /** - * 通用数据列，具体含义由{@link #MIME_TYPE}决定，用于存储文本数据 - *

类型: TEXT

- */ - public static final String DATA3 = "data3"; - - /** - * 通用数据列，具体含义由{@link #MIME_TYPE}决定，用于存储文本数据 - *

类型: TEXT

- */ - public static final String DATA4 = "data4"; - - /** - * 通用数据列，具体含义由{@link #MIME_TYPE}决定，用于存储文本数据 - *

类型: TEXT

- */ - public static final String DATA5 = "data5"; - } - - // 文本笔记类，实现了DataColumns接口 - public static final class TextNote implements DataColumns { - /** - * 模式，指示文本是否在检查列表模式中 - *

类型: INTEGER 1:检查列表模式 0: 正常模式

- */ - 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"; // MIME类型定义 - public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note"; // 单项MIME类型定义 - public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note"); // 内容URI定义 - } - - // 通话记录笔记类，实现了DataColumns接口 - public static final class CallNote implements DataColumns { - /** - * 通话日期 - *

类型: INTEGER (long)

- */ - public static final String CALL_DATE = DATA1; - - /** - * 电话号码 - *

类型: TEXT

- */ - public static final String PHONE_NUMBER = DATA3; - - public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note"; // MIME类型定义 - public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note"; // 单项MIME类型定义 - public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note"); // 内容URI定义 - } -} diff --git a/src/data/NotesDatabaseHelper.java b/src/data/NotesDatabaseHelper.java deleted file mode 100644 index 36973ec..0000000 --- a/src/data/NotesDatabaseHelper.java +++ /dev/null @@ -1,381 +0,0 @@ -/* - * 该类为Notes数据库的辅助类，负责管理数据库的创建和版本管理。 - */ -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; - - // 创建NOTE表的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" + - ")"; - - // 创建DATA表的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 ''" + - ")"; - - // 创建DATA表的NOTE_ID索引的SQL语句 - private static final String CREATE_DATA_NOTE_ID_INDEX_SQL = - "CREATE INDEX IF NOT EXISTS note_id_index ON " + - TABLE.DATA + "(" + DataColumns.NOTE_ID + ");"; - - // 当更新NOTE表中的PARENT_ID字段时，增加目标文件夹的NOTE_COUNT - 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"; - - // 当从文件夹移动NOTE时，减少源文件夹的NOTE_COUNT - 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"; - - // 当插入新NOTE时，增加目标文件夹的NOTE_COUNT - 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"; - - // 当删除NOTE时，减少文件夹的NOTE_COUNT - 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"; - - // 当插入DATA时，如果类型为NOTE，则更新关联NOTE的内容 - 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"; - - // 当更新DATA时，如果类型为NOTE，则更新关联NOTE的内容 - 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"; - - // 当删除DATA时，如果类型为NOTE，则更新关联NOTE的内容为空 - 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"; - - // 当删除NOTE时，删除关联的DATA - 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"; - - // 当删除NOTE时，删除属于该NOTE的子NOTE - 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"; - - // 当NOTE移动到回收站文件夹时，将所有子NOTE也移动到回收站 - 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 + ";" + - " END"; - - /** - * 构造函数，私有化以防止外部实例化 - * context 上下文对象，用于访问应用的资源和其他组件 - */ - public NotesDatabaseHelper(Context context) { - super(context, DB_NAME, null, DB_VERSION); - } - - /** - * 创建NOTE表，并重新创建NOTE表的触发器，然后创建系统文件夹 - *db SQLiteDatabase对象，用于执行SQL创建语句 - */ - public void createNoteTable(SQLiteDatabase db) { - db.execSQL(CREATE_NOTE_TABLE_SQL); - reCreateNoteTableTriggers(db); - createSystemFolder(db); - Log.d(TAG, "note table has been created"); - } - - /** - * 重新创建笔记表的触发器 - * db SQLiteDatabase 类型，数据库对象 - */ - private void reCreateNoteTableTriggers(SQLiteDatabase db) { - // 删除旧的触发器 - db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update"); - db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update"); - db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete"); - db.execSQL("DROP TRIGGER IF EXISTS delete_data_on_delete"); - db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_insert"); - db.execSQL("DROP TRIGGER IF EXISTS folder_delete_notes_on_delete"); - db.execSQL("DROP TRIGGER IF EXISTS folder_move_notes_on_trash"); - // 创建新的触发器 - db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER); - db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER); - db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER); - db.execSQL(NOTE_DELETE_DATA_ON_DELETE_TRIGGER); - db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER); - db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER); - db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER); - } - - /** - * 创建系统文件夹 - * db SQLiteDatabase 类型，数据库对象 - */ - private void createSystemFolder(SQLiteDatabase db) { - ContentValues values = new ContentValues(); - // 创建通话记录文件夹 - values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER); - values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); - db.insert(TABLE.NOTE, null, values); - // 创建根文件夹（默认文件夹） - values.clear(); - values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER); - values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); - db.insert(TABLE.NOTE, null, values); - // 创建临时文件夹，用于移动笔记 - values.clear(); - values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER); - values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); - db.insert(TABLE.NOTE, null, values); - // 创建回收站文件夹 - values.clear(); - values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER); - values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); - db.insert(TABLE.NOTE, null, values); - } - - /** - * 创建数据表 - * db SQLiteDatabase 类型，数据库对象 - */ - public void createDataTable(SQLiteDatabase db) { - db.execSQL(CREATE_DATA_TABLE_SQL); - reCreateDataTableTriggers(db); - db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL); - Log.d(TAG, "data table has been created"); - } - - /** - * 重新创建数据表的触发器 - *db SQLiteDatabase 类型，数据库对象 - */ - private void reCreateDataTableTriggers(SQLiteDatabase db) { - // 删除旧的触发器 - db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert"); - db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update"); - db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete"); - // 创建新的触发器 - db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER); - db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER); - db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER); - } - - /** - * 获取 NotesDatabaseHelper 的单例对象 - *context Context 类型，应用上下文 - *NotesDatabaseHelper 类型，单例对象 - */ - static synchronized NotesDatabaseHelper getInstance(Context context) { - if (mInstance == null) { - mInstance = new NotesDatabaseHelper(context); - } - return mInstance; - } - - /** - * 创建数据库表 - * - * @param db SQLiteDatabase 类型，数据库对象 - */ - @Override - public void onCreate(SQLiteDatabase db) { - createNoteTable(db); - createDataTable(db); - } - - /** - * 升级数据库 - * - * @param db SQLiteDatabase 类型，数据库对象 - * @param oldVersion int 类型，旧版本号 - * @param newVersion int 类型，新版本号 - */ - @Override - public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { - boolean reCreateTriggers = false; - boolean skipV2 = false; - // 根据旧版本号逐步升级 - if (oldVersion == 1) { - upgradeToV2(db); - skipV2 = true; // 这次升级包括从 v2 到 v3 的升级 - oldVersion++; - } - if (oldVersion == 2 && !skipV2) { - upgradeToV3(db); - reCreateTriggers = true; - oldVersion++; - } - if (oldVersion == 3) { - upgradeToV4(db); - oldVersion++; - } - if (reCreateTriggers) { - reCreateNoteTableTriggers(db); - reCreateDataTableTriggers(db); - } - if (oldVersion != newVersion) { - throw new IllegalStateException("Upgrade notes database to version " + newVersion - + "fails"); - } - } - - /** - * 从版本1升级到版本2 - * - * @param db SQLiteDatabase 类型，数据库对象 - */ - 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); - } - - /** - * 从版本2升级到版本3 - * - * @param db SQLiteDatabase 类型，数据库对象 - */ - private void upgradeToV3(SQLiteDatabase db) { - // 删除未使用的触发器 - 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"); - // 添加一个用于 gtask id 的列 - db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID - + " TEXT NOT NULL DEFAULT ''"); - // 添加一个回收站系统文件夹 - 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); - } - - /** - * 从版本3升级到版本4 - * - * @param db SQLiteDatabase 类型，数据库对象 - */ - private void upgradeToV4(SQLiteDatabase db) { - // 添加版本号列 - db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION - + " INTEGER NOT NULL DEFAULT 0"); - } -} \ No newline at end of file diff --git a/src/data/NotesProvider.java b/src/data/NotesProvider.java deleted file mode 100644 index c38d7b3..0000000 --- a/src/data/NotesProvider.java +++ /dev/null @@ -1,358 +0,0 @@ -/* - * 该类是Notes应用的内容提供者，负责管理Notes的数据，包括查询、插入、更新和删除操作。 - * 它与数据库交互，将操作转换为对数据库的相应操作。 - */ -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 { - private static final UriMatcher mMatcher; - - private NotesDatabaseHelper mHelper; - - 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; - - // 初始化UriMatcher，用于匹配不同的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); - } - - /** - * 在搜索结果中，为了显示更多信息，我们会去除标题和内容中的'\n'和空白字符。 - */ - 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; - - // 用于搜索查询的SQL语句 - 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; - - /** - * 当ContentProvider被创建时调用，用于初始化数据库帮助类。 - * - * @return 总是返回true。 - */ - @Override - public boolean onCreate() { - mHelper = NotesDatabaseHelper.getInstance(getContext()); - return true; - } - - /** - * 根据URI查询数据。 - * - * @param uri 要查询的数据的URI。 - * @param projection 要返回的列。 - * @param selection 查询条件。 - * @param selectionArgs 用于查询条件的参数。 - * @param sortOrder 排序顺序。 - * @return 返回匹配的Cursor对象。 - */ - @Override - public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, - String sortOrder) { - Cursor c = null; - SQLiteDatabase db = mHelper.getReadableDatabase(); - String id = null; - // 根据URI匹配查询类型 - switch (mMatcher.match(uri)) { - case URI_NOTE: - c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null, - sortOrder); - break; - case URI_NOTE_ITEM: - 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()); - } - break; - default: - throw new IllegalArgumentException("Unknown URI " + uri); - } - // 设置通知URI，以便数据改变时可以通知 - if (c != null) { - c.setNotificationUri(getContext().getContentResolver(), uri); - } - return c; - } - - /** - * 在数据库中插入新数据。 - * - * @param uri 插入数据的URI。 - * @param values 要插入的数据。 - * @return 返回插入数据的URI。 - */ - @Override - public Uri insert(Uri uri, ContentValues values) { - SQLiteDatabase db = mHelper.getWritableDatabase(); - long dataId = 0, noteId = 0, insertedId = 0; - switch (mMatcher.match(uri)) { - case URI_NOTE: - insertedId = noteId = db.insert(TABLE.NOTE, null, values); - break; - case URI_DATA: - if (values.containsKey(DataColumns.NOTE_ID)) { - noteId = values.getAsLong(DataColumns.NOTE_ID); - } else { - Log.d(TAG, "Wrong data format without note id:" + values.toString()); - } - insertedId = dataId = db.insert(TABLE.DATA, null, values); - break; - default: - throw new IllegalArgumentException("Unknown URI " + uri); - } - // 通知URI改变 - if (noteId > 0) { - getContext().getContentResolver().notifyChange( - ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null); - } - - if (dataId > 0) { - getContext().getContentResolver().notifyChange( - ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null); - } - - return ContentUris.withAppendedId(uri, insertedId); - } - - /** - * 根据URI删除数据。 - * - * @param uri 要删除数据的URI。 - * @param selection 删除条件。 - * @param selectionArgs 用于删除条件的参数。 - * @return 返回被删除的行数。 - */ - @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)) { - case URI_NOTE: - selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 "; - count = db.delete(TABLE.NOTE, selection, selectionArgs); - break; - case URI_NOTE_ITEM: - id = uri.getPathSegments().get(1); - /** - * ID小于等于0的笔记是系统文件夹，不允许删除 - */ - long noteId = Long.valueOf(id); - if (noteId <= 0) { - break; - } - count = db.delete(TABLE.NOTE, - NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs); - break; - case URI_DATA: - count = db.delete(TABLE.DATA, selection, selectionArgs); - deleteData = true; - break; - case URI_DATA_ITEM: - id = uri.getPathSegments().get(1); - count = db.delete(TABLE.DATA, - DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs); - deleteData = true; - break; - 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; - } - - /** - * 更新数据库中的数据。 - * - * @param uri 要更新数据的URI。 - * @param values 要更新到的数据。 - * @param selection 更新条件。 - * @param selectionArgs 用于更新条件的参数。 - * @return 返回被更新的行数。 - */ - @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)) { - case URI_NOTE: - increaseNoteVersion(-1, selection, selectionArgs); - count = db.update(TABLE.NOTE, values, selection, selectionArgs); - break; - case URI_NOTE_ITEM: - 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: - count = db.update(TABLE.DATA, values, selection, selectionArgs); - updateData = true; - break; - case URI_DATA_ITEM: - id = uri.getPathSegments().get(1); - count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id - + parseSelection(selection), selectionArgs); - updateData = true; - break; - 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; - } - - - /** - * 解析选择条件，如果存在选择条件，则在条件前后添加" AND (" 和 ')'。 - * - * @param selection 用户提供的选择条件。 - * @return 如果有选择条件，则返回添加了定界符的选择条件字符串；否则返回空字符串。 - */ - private String parseSelection(String selection) { - return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : ""); - } - - /** - * 增加指定笔记的版本号。 - * - * @param id 笔记的ID，如果为正数，则根据ID更新版本号；如果为0或负数，则根据selection参数更新版本号。 - * @param selection 用于选择需要更新的笔记的条件字符串，可以为空。 - * @param selectionArgs 与selection参数配合使用的参数数组，用于替换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 "); - - // 根据ID或选择条件构建SQL的WHERE子句 - 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; - // 替换selection中的"?"为selectionArgs中的对应参数 - for (String args : selectionArgs) { - selectString = selectString.replaceFirst("\\?", args); - } - sql.append(selectString); - } - - mHelper.getWritableDatabase().execSQL(sql.toString()); - } - - /** - * 根据URI获取对应的MIME类型。 - * 本方法是个待实现的方法，当前仅返回null。 - * - * @param uri 请求的URI。 - * @return 返回null，表示该方法尚未实现。 - */ - @Override - public String getType(Uri uri) { - // TODO Auto-generated method stub - return null; - } - -} diff --git a/src/gtask/data/MetaData.java b/src/gtask/data/MetaData.java deleted file mode 100644 index 1a9f7f6..0000000 --- a/src/gtask/data/MetaData.java +++ /dev/null @@ -1,125 +0,0 @@ -/** - * MetaData类，继承自Task类，用于处理与任务相关的元数据。 - * 这个类主要用于存储和管理与任务相关的元信息，包括全局ID和元数据内容处理。 - */ -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; - -public class MetaData extends Task { - private final static String TAG = MetaData.class.getSimpleName(); // 日志标签，用于调试和错误管理 - - private String mRelatedGid = null; // 与任务相关的全局ID - - /** - * 设置元数据。 - * - * @param gid 任务的全局ID。此ID用于在系统中唯一标识任务。 - * @param metaInfo 元信息的JSON对象，包含与当前任务相关的其他信息。 - */ - public void setMeta(String gid, JSONObject metaInfo) { - try { - // 将任务的全局ID添加到元信息中 - metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid); - } catch (JSONException e) { - // 记录错误日志，表示在将ID添加到元信息时失败 - Log.e(TAG, "failed to put related gid"); - } - - // 将元信息设置为任务的笔记，以JSON字符串的形式存储在笔记字段中 - setNotes(metaInfo.toString()); - // 设置任务的名称为特定的元数据标志名称 - setName(GTaskStringUtils.META_NOTE_NAME); - } - - /** - * 获取与任务相关的全局ID。 - * - * @return 相关的全局ID字符串。如果没有设置，则返回null。 - */ - public String getRelatedGid() { - return mRelatedGid; - } - - /** - * 判断任务是否值得保存。 - * - * @return 如果任务的笔记字段不为空，则返回true，表示任务值得保存。 - * 否则返回false，表示任务不需要保存。 - */ - @Override - public boolean isWorthSaving() { - // 检查笔记是否为null，以决定是否值得保存 - return getNotes() != null; - } - - /** - * 通过远程JSON对象设置内容。 - * - * @param js JSON对象，包含远程任务的内容。 - * 客户端可通过此方法将任务的内容与远程数据同步。 - */ - @Override - public void setContentByRemoteJSON(JSONObject js) { - // 调用父类的方法设置标准内容 - super.setContentByRemoteJSON(js); - - if (getNotes() != null) { - try { - // 从笔记中提取元信息的JSON对象 - JSONObject metaInfo = new JSONObject(getNotes().trim()); - // 提取相关的全局ID - mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID); - } catch (JSONException e) { - // 记录警告，表示从笔记中无法获取相关ID - Log.w(TAG, "failed to get related gid"); - // 提取失败时，设置相关ID为null - mRelatedGid = null; - } - } - } - - /** - * 通过本地JSON对象设置内容。此方法不应被调用。 - * - * @param js 本地JSON对象，将本地的任务内容赋值给任务属性。 - * @throws IllegalAccessError 本方法不应该被调用，调用时抛出该异常。 - */ - @Override - public void setContentByLocalJSON(JSONObject js) { - // 本方法不应被调用，调用时抛出异常 - throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called"); - } - - /** - * 从内容生成本地JSON对象。此方法不应被调用。 - * - * @return 生成的JSON对象，此方法生成的JSON对象用以在本地保存或传输。 - * @throws IllegalAccessError 本方法不应该被调用，调用时抛出该异常。 - */ - @Override - public JSONObject getLocalJSONFromContent() { - // 本方法不应被调用，调用时抛出异常 - throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called"); - } - - /** - * 获取同步操作类型。此方法不应被调用。 - * - * @param c 数据库游标，指向当前任务，用以获取任务的同步状态。 - * @return 同步操作的类型，例如新增、更新或删除等。 - * @throws IllegalAccessError 本方法不应该被调用，调用时抛出该异常。 - */ - @Override - public int getSyncAction(Cursor c) { - // 本方法不应被调用，调用时抛出异常 - throw new IllegalAccessError("MetaData:getSyncAction should not be called"); - } -} - diff --git a/src/gtask/data/Node.java b/src/gtask/data/Node.java deleted file mode 100644 index a95fe42..0000000 --- a/src/gtask/data/Node.java +++ /dev/null @@ -1,123 +0,0 @@ -/* - * Node类定义了一个节点的基本属性和操作，用于数据同步时的表现和转换。 - * 它是用于表示通用数据节点的抽象类，具体的数据操作和格式转换由其子类实现。 - */ - -package net.micode.notes.gtask.data; - -import android.database.Cursor; - -import org.json.JSONObject; - -// 定义节点同步动作的常量 -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; // 同步错误 - - private String mGid; // 节点的全局唯一标识符 - private String mName; // 节点名称 - private long mLastModified; // 最后修改时间戳 - private boolean mDeleted; // 节点是否已经被标记为删除 - - // 构造函数，初始化节点的属性 - public Node() { - mGid = null; // 初始时GID为空 - mName = ""; // 节点名称初始化为空字符串 - mLastModified = 0; // 最后修改时间初始化为0（未设置） - mDeleted = false; // 节点初始状态为未删除 - } - - /** - * 生成创建节点的JSON动作。 - * - * @param actionId 同步操作的标识符，表示当前的操作类型。 - * @return 包含创建节点信息的JSON对象。 - */ - public abstract JSONObject getCreateAction(int actionId); - - /** - * 生成更新节点的JSON动作。 - * - * @param actionId 同步操作的标识符，表示当前的操作类型。 - * @return 包含更新节点信息的JSON对象。 - */ - public abstract JSONObject getUpdateAction(int actionId); - - /** - * 根据远程JSON内容设置节点内容。 - * - * @param js JSON对象，包含远程节点的内容。 - */ - public abstract void setContentByRemoteJSON(JSONObject js); - - /** - * 根据本地JSON内容设置节点内容。 - * - * @param js JSON对象，包含本地节点的内容。 - */ - public abstract void setContentByLocalJSON(JSONObject js); - - /** - * 从内容生成本地JSON表示。 - * - * @return 生成的JSON对象，用于本地存储或传输。 - */ - public abstract JSONObject getLocalJSONFromContent(); - - /** - * 根据Cursor获取同步动作。 - * - * @param c 数据库游标，当前指向节点记录。 - * @return 返回对应同步操作的类型。 - */ - public abstract int getSyncAction(Cursor c); - - // 设置节点的全局唯一标识符 - 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; - } - - // 获取节点的全局唯一标识符 - public String getGid() { - return this.mGid; - } - - // 获取节点名称 - public String getName() { - return this.mName; - } - - // 获取节点最后修改时间 - public long getLastModified() { - return this.mLastModified; - } - - // 获取节点是否被删除的标志 - public boolean getDeleted() { - return this.mDeleted; - } - -} diff --git a/src/gtask/data/SqlData.java b/src/gtask/data/SqlData.java deleted file mode 100644 index 0143954..0000000 --- a/src/gtask/data/SqlData.java +++ /dev/null @@ -1,222 +0,0 @@ -/* - * SqlData 类用于操作和管理数据库中的数据项。 - * 提供了从 JSON 对象设置内容，从数据库 Cursor 加载数据，以及提交数据更新到数据库的功能。 - */ - -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; - -public class SqlData { - // 日志标签 - private static final String TAG = SqlData.class.getSimpleName(); - - // 无效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 - }; - - // 字段在Cursor中的索引 - public static final int DATA_ID_COLUMN = 0; - public static final int DATA_MIME_TYPE_COLUMN = 1; - public static final int DATA_CONTENT_COLUMN = 2; - public static final int DATA_CONTENT_DATA_1_COLUMN = 3; - public static final int DATA_CONTENT_DATA_3_COLUMN = 4; - - // ContentResolver用于操作内容提供者 - private ContentResolver mContentResolver; - - // 标记当前对象是创建状态还是更新状态 - private boolean mIsCreate; - - // 数据项ID - private long mDataId; - - // 数据项的MIME类型 - private String mDataMimeType; - - // 数据项的内容 - private String mDataContent; - - // 数据项的附加数据1 - private long mDataContentData1; - - // 数据项的附加数据3 - private String mDataContentData3; - - // 存储与数据库不同步的数据变化 - private ContentValues mDiffDataValues; - - /* - * SqlData 构造函数，用于创建新的数据项。 - * @param context 上下文对象，用于获取ContentResolver。 - */ - public SqlData(Context context) { - mContentResolver = context.getContentResolver(); - mIsCreate = true; // 设置为创建状态 - mDataId = INVALID_ID; // 初始化为无效ID - mDataMimeType = DataConstants.NOTE; // 默认MIME类型为笔记 - mDataContent = ""; // 内容初始化为空 - mDataContentData1 = 0; // 附加数据1初始化为0 - mDataContentData3 = ""; // 附加数据3初始化为空 - mDiffDataValues = new ContentValues(); // 初始化差异数据值 - } - - /* - * SqlData 构造函数，用于加载现有数据项。 - * @param context 上下文对象，用于获取ContentResolver。 - * @param c 数据项的Cursor对象，用于加载数据。 - */ - public SqlData(Context context, Cursor c) { - mContentResolver = context.getContentResolver(); - mIsCreate = false; // 设置为更新状态 - loadFromCursor(c); // 从Cursor中加载数据 - mDiffDataValues = new ContentValues(); // 初始化差异数据值 - } - - /* - * 从Cursor中加载数据。 - * @param c 数据项的Cursor对象。 - */ - private void loadFromCursor(Cursor c) { - mDataId = c.getLong(DATA_ID_COLUMN); // 获取数据项ID - mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN); // 获取MIME类型 - mDataContent = c.getString(DATA_CONTENT_COLUMN); // 获取内容 - mDataContentData1 = c.getLong(DATA_CONTENT_DATA_1_COLUMN); // 获取附加数据1 - mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN); // 获取附加数据3 - } - - /* - * 根据JSON对象设置数据项内容。 - * @param js JSON对象，包含数据项的内容。 - * @throws JSONException 如果解析JSON时出错。 - */ - public void setContent(JSONObject js) throws JSONException { - long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID; // 获取ID - if (mIsCreate || mDataId != dataId) { - mDiffDataValues.put(DataColumns.ID, dataId); // 保存ID变化 - } - mDataId = dataId; // 设置ID - - String dataMimeType = js.has(DataColumns.MIME_TYPE) ? js.getString(DataColumns.MIME_TYPE) - : DataConstants.NOTE; // 获取MIME类型 - if (mIsCreate || !mDataMimeType.equals(dataMimeType)) { - mDiffDataValues.put(DataColumns.MIME_TYPE, dataMimeType); // 保存MIME类型变化 - } - mDataMimeType = dataMimeType; // 设置MIME类型 - - 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; // 获取附加数据1 - if (mIsCreate || mDataContentData1 != dataContentData1) { - mDiffDataValues.put(DataColumns.DATA1, dataContentData1); // 保存附加数据1变化 - } - mDataContentData1 = dataContentData1; // 设置附加数据1 - - String dataContentData3 = js.has(DataColumns.DATA3) ? js.getString(DataColumns.DATA3) : ""; // 获取附加数据3 - if (mIsCreate || !mDataContentData3.equals(dataContentData3)) { - mDiffDataValues.put(DataColumns.DATA3, dataContentData3); // 保存附加数据3变化 - } - mDataContentData3 = dataContentData3; // 设置附加数据3 - } - - /* - * 获取数据项的内容，转换为JSON对象。 - * @return JSON对象，包含数据项的内容。 - * @throws JSONException 如果构建JSON对象时出错。 - */ - public JSONObject getContent() throws JSONException { - if (mIsCreate) { - Log.e(TAG, "it seems that we haven't created this in database yet"); // 输出错误信息 - return null; // 如果未创建则返回null - } - JSONObject js = new JSONObject(); // 创建JSON对象 - js.put(DataColumns.ID, mDataId); // 加入ID - js.put(DataColumns.MIME_TYPE, mDataMimeType); // 加入MIME类型 - js.put(DataColumns.CONTENT, mDataContent); // 加入内容 - js.put(DataColumns.DATA1, mDataContentData1); // 加入附加数据1 - js.put(DataColumns.DATA3, mDataContentData3); // 加入附加数据3 - return js; // 返回JSON对象 - } - - /* - * 将数据项提交到数据库，如果是新数据项则插入，否则更新。 - * @param noteId 符合此数据项的笔记ID。 - * @param validateVersion 是否验证版本号。 - * @param version 数据项的版本号。 - */ - public void commit(long noteId, boolean validateVersion, long version) { - if (mIsCreate) { - // 处理新数据项的插入 - if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) { - mDiffDataValues.remove(DataColumns.ID); // 从差异中移除ID - } - - mDiffDataValues.put(DataColumns.NOTE_ID, noteId); // 设置笔记ID - Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues); // 插入数据项 - try { - mDataId = Long.valueOf(uri.getPathSegments().get(1)); // 从URI中获取新数据项的ID - } 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。 - * @return 数据项的ID。 - */ - public long getId() { - return mDataId; // 返回数据项ID - } -} diff --git a/src/gtask/data/SqlNote.java b/src/gtask/data/SqlNote.java deleted file mode 100644 index 23ce7fb..0000000 --- a/src/gtask/data/SqlNote.java +++ /dev/null @@ -1,513 +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; - -/** - * SqlNote 类用于管理和操作数据库中的笔记数据。 - * 它提供了创建、加载和更新笔记内容的接口。 - */ -public class SqlNote { - // 日志标签，便于调试和输出日志 - private static final String TAG = SqlNote.class.getSimpleName(); - - // 无效的ID值，用于标识未定义或错误的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, - 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 - }; - - // 各查询列的索引 - public static final int ID_COLUMN = 0; - public static final int ALERTED_DATE_COLUMN = 1; - 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; - public static final int PARENT_ID_COLUMN = 7; - public static final int SNIPPET_COLUMN = 8; - public static final int TYPE_COLUMN = 9; - public static final int WIDGET_ID_COLUMN = 10; - public static final int WIDGET_TYPE_COLUMN = 11; - public static final int SYNC_ID_COLUMN = 12; - public static final int LOCAL_MODIFIED_COLUMN = 13; - public static final int ORIGIN_PARENT_ID_COLUMN = 14; - public static final int GTASK_ID_COLUMN = 15; - public static final int VERSION_COLUMN = 16; - - // 上下文和内容解析器，用于访问数据库 - private Context mContext; - private ContentResolver mContentResolver; - - // 标记是否创建新笔记 - private boolean mIsCreate; - - // 笔记的各种属性 - private long mId; // 笔记ID - private long mAlertDate; // 提醒日期 - private int mBgColorId; // 背景颜色ID - private long mCreatedDate; // 创建日期 - private int mHasAttachment; // 是否有附件标志 - private long mModifiedDate; // 最后修改日期 - private long mParentId; // 父笔记ID - private String mSnippet; // 笔记摘录 - private int mType; // 笔记类型 - private int mWidgetId; // 相关的小部件ID - private int mWidgetType; // 小部件类型 - private long mOriginParent; // 原父笔记ID - private long mVersion; // 笔记版本号 - - // 用于存储两次更新之间差异的数据值 - private ContentValues mDiffNoteValues; - - // 存储与笔记相关数据的列表 - private ArrayList mDataList; - - /** - * 构造函数，初始化一个新的SqlNote实例。 - * - * @param context 上下文，通常是指Activity或Application对象。 - */ - public SqlNote(Context context) { - mContext = context; // 获取上下文 - mContentResolver = context.getContentResolver(); // 获取内容解析器 - mIsCreate = true; // 设为创建状态 - // 初始化笔记属性为默认值 - mId = INVALID_ID; // 初始化ID为无效ID - mAlertDate = 0; // 提醒日期初始化为0 - mBgColorId = ResourceParser.getDefaultBgId(context); // 获取默认背景颜色ID - mCreatedDate = System.currentTimeMillis(); // 设置创建日期为当前时间 - mHasAttachment = 0; // 初始化附件标志为0（无附件） - mModifiedDate = System.currentTimeMillis(); // 同样设置最后修改日期为当前时间 - mParentId = 0; // 父ID初始化为0 - mSnippet = ""; // 笔记摘录初始化为空字符串 - mType = Notes.TYPE_NOTE; // 默认类型设置为普通笔记 - mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID; // 小部件ID初始化为无效ID - mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 小部件类型初始化为无效类型 - mOriginParent = 0; // 原父ID初始化为0 - mVersion = 0; // 版本号初始化为0 - mDiffNoteValues = new ContentValues(); // 初始化差异数据字典 - mDataList = new ArrayList(); // 初始化与笔记相关的数据列表 - } - - /** - * 构造函数，从数据库中加载指定ID的笔记。 - * - * @param context 上下文，通常是指Activity或Application对象。 - * @param c 数据库查询结果的Cursor对象。 - */ - public SqlNote(Context context, Cursor c) { - mContext = context; // 获取上下文 - mContentResolver = context.getContentResolver(); // 获取内容解析器 - mIsCreate = false; // 设为更新状态 - loadFromCursor(c); // 从Cursor中加载笔记数据 - mDataList = new ArrayList(); // 初始化与笔记相关的数据列表 - if (mType == Notes.TYPE_NOTE) - loadDataContent(); // 如果是笔记类型，则加载数据内容 - mDiffNoteValues = new ContentValues(); // 初始化差异数据字典 - } - - /** - * 构造函数，从数据库中加载指定ID的笔记。 - * - * @param context 上下文，通常是指Activity或Application对象。 - * @param id 要加载的笔记的ID。 - */ - public SqlNote(Context context, long id) { - mContext = context; // 获取上下文 - mContentResolver = context.getContentResolver(); // 获取内容解析器 - mIsCreate = false; // 设为更新状态 - loadFromCursor(id); // 根据ID从数据库加载数据 - mDataList = new ArrayList(); // 初始化与笔记相关的数据列表 - if (mType == Notes.TYPE_NOTE) - loadDataContent(); // 如果是笔记类型，则加载数据内容 - mDiffNoteValues = new ContentValues(); // 初始化差异数据字典 - } - - // 从数据库中加载笔记数据 - private void loadFromCursor(long id) { - Cursor c = null; - try { - // 根据ID查询笔记数据 - c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)", - new String[]{ String.valueOf(id) }, null); - if (c != null) { - if (c.moveToNext()) { - loadFromCursor(c); // 如果Cursor非空，加载数据 - } else { - Log.w(TAG, "loadFromCursor: cursor = null"); // 查询结果为空时输出警告 - } - } - } finally { - if (c != null) // 释放Cursor资源 - c.close(); - } - } - - // 从Cursor中加载笔记数据到实例属性 - private void loadFromCursor(Cursor c) { - mId = c.getLong(ID_COLUMN); // 获取笔记ID - mAlertDate = c.getLong(ALERTED_DATE_COLUMN); // 获取提醒日期 - mBgColorId = c.getInt(BG_COLOR_ID_COLUMN); // 获取背景颜色ID - mCreatedDate = c.getLong(CREATED_DATE_COLUMN); // 获取创建日期 - mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN); // 获取附件标志 - mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN); // 获取最后修改日期 - mParentId = c.getLong(PARENT_ID_COLUMN); // 获取父笔记ID - mSnippet = c.getString(SNIPPET_COLUMN); // 获取笔记摘录 - mType = c.getInt(TYPE_COLUMN); // 获取笔记类型 - mWidgetId = c.getInt(WIDGET_ID_COLUMN); // 获取小部件ID - mWidgetType = c.getInt(WIDGET_TYPE_COLUMN); // 获取小部件类型 - mVersion = c.getLong(VERSION_COLUMN); // 获取笔记版本号 - } - - /** - * 加载数据内容。 - * 从数据库中查询特定note_id的数据，并将其加载到mDataList中。 - */ - private void loadDataContent() { - Cursor c = null; - mDataList.clear(); // 清空数据列表 - try { - // 查询指定note_id的数据 - c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA, - "(note_id=?)", new String[]{ String.valueOf(mId) }, null); - if (c != null) { - // 如果查询结果为空，打印警告信息并返回 - if (c.getCount() == 0) { - Log.w(TAG, "it seems that the note has not data"); - return; - } - // 遍历查询结果，并加载到mDataList中 - while (c.moveToNext()) { - SqlData data = new SqlData(mContext, c); // 创建SqlData对象 - mDataList.add(data); // 添加到数据列表 - } - } else { - // 如果查询结果为null，打印警告信息 - Log.w(TAG, "loadDataContent: cursor = null"); - } - } finally { - // 释放资源 - if (c != null) - c.close(); - } - } - - /** - * 设置内容。 - * 根据传入的JSONObject，更新或创建笔记的相关内容。 - * - * @param js 包含笔记信息的JSONObject。 - * @return 成功返回true，失败返回false。 - */ - public boolean setContent(JSONObject js) { - try { - // 从js中获取note信息 - 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) { - // 文件夹类型笔记，仅更新snippet和类型 - String snippet = note.has(NoteColumns.SNIPPET) ? note - .getString(NoteColumns.SNIPPET) : ""; - if (mIsCreate || !mSnippet.equals(snippet)) { - mDiffNoteValues.put(NoteColumns.SNIPPET, snippet); // 保存snippet的差异 - } - mSnippet = snippet; - - int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE) - : Notes.TYPE_NOTE; - if (mIsCreate || mType != type) { - mDiffNoteValues.put(NoteColumns.TYPE, type); // 保存类型的差异 - } - mType = type; - } 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差异 - } - mId = id; - - // 更新或设置提醒日期、背景色id、创建日期、附件标志、修改日期、父id、snippet、类型、小部件id和类型等信息 - // 该部分通过条件判断，确定是否需要更新数据库字段 - - // 处理数据项数组，每个数据项会被更新或创建 - for (int i = 0; i < dataArray.length(); i++) { - JSONObject data = dataArray.getJSONObject(i); - SqlData sqlData = null; - if (data.has(DataColumns.ID)) { - long dataId = data.getLong(DataColumns.ID); - for (SqlData temp : mDataList) { - if (dataId == temp.getId()) { - sqlData = temp; // 复用现有数据 - } - } - } - - if (sqlData == null) { - sqlData = new SqlData(mContext); // 创建新数据项 - mDataList.add(sqlData); // 添加到列表 - } - - sqlData.setContent(data); // 设置数据项内容 - } - } - } catch (JSONException e) { - // 处理JSON解析异常 - Log.e(TAG, e.toString()); - e.printStackTrace(); - return false; // 解析失败 - } - return true; // 解析成功 - } - - /** - * 获取内容。 - * 将当前笔记的内容转换为JSONObject格式。 - * - * @return 笔记内容的JSONObject，如果无法转换成功则返回null。 - */ - public JSONObject getContent() { - try { - JSONObject js = new JSONObject(); - - if (mIsCreate) { - // 如果笔记尚未在数据库中创建，返回null - Log.e(TAG, "it seems that we haven't created this in database yet"); - return null; - } - - JSONObject note = new JSONObject(); - // 根据笔记类型，填充不同的信息到note JSONObject中 - // 该部分通过条件判断，根据mType选择需要填充的信息 - - // 将note和data信息添加到js中 - js.put(GTaskStringUtils.META_HEAD_NOTE, note); // 添加笔记信息 - // 处理数据项数组，将其添加到js中 - JSONArray dataArray = new JSONArray(); - for (SqlData data : mDataList) { - dataArray.put(data.getContent()); // 获取每个数据项的内容 - } - js.put(GTaskStringUtils.META_HEAD_DATA, dataArray); // 添加数据项信息 - - return js; // 返回完整内容 - } catch (JSONException e) { - // 处理JSON构建异常 - Log.e(TAG, e.toString()); - e.printStackTrace(); - } - return null; // 转换失败时返回null - } - - /** - * 设置父id。 - * - * @param id 父笔记的id。 - */ - public void setParentId(long id) { - mParentId = id; - mDiffNoteValues.put(NoteColumns.PARENT_ID, id); // 保存父ID的差异 - } - - /** - * 设置Gtask id。 - * - * @param gid Gtask的id。 - */ - public void setGtaskId(String gid) { - mDiffNoteValues.put(NoteColumns.GTASK_ID, gid); // 保存Gtask ID的差异 - } - - /** - * 设置同步id。 - * - * @param syncId 同步的id。 - */ - public void setSyncId(long syncId) { - mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId); // 保存同步ID的差异 - } - - /** - * 重置本地修改标志。 - */ - public void resetLocalModified() { - mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0); // 重置本地修改标志 - } - - /** - * 获取笔记id。 - * - * @return 笔记的id。 - */ - public long getId() { - return mId; // 返回笔记ID - } - - /** - * 获取父id。 - * - * @return 父笔记的id。 - */ - public long getParentId() { - return mParentId; // 返回父ID - } - - /** - * 获取snippet。 - * - * @return 笔记的snippet。 - */ - public String getSnippet() { - return mSnippet; // 返回笔记摘录 - } - - /** - * 判断是否为笔记类型。 - * - * @return 是笔记类型返回true，否则返回false。 - */ - public boolean isNoteType() { - return mType == Notes.TYPE_NOTE; // 检查当前类型 - } - - /** - * 提交对笔记的更改或创建新的笔记。 - * - * @param validateVersion 是否验证版本号。如果为 true，则在更新笔记时会检查版本号以避免并发更新的问题。 - * 如果为 false，则不进行版本号检查。 - * 这个参数主要用于处理客户端在同步过程中可能同时更新同一笔记的情况。 - */ -/** - * 提交对笔记的更改或创建新的笔记。 - * - * @param validateVersion 是否验证版本号。如果为 true，则在更新笔记时会检查版本号以避免并发更新的问题。 - * 如果为 false，则不进行版本号检查。 - * 这个参数主要用于处理客户端在同步过程中可能同时更新同一笔记的情况。 - */ -public void commit(boolean validateVersion) { - // 判断当前是否为创建新笔记的状态 - if (mIsCreate) { // 处理创建新笔记的逻辑 - // 在创建新笔记时，如果ID是无效的（即未指定），且包含了ID字段，则移除该字段 - if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) { - mDiffNoteValues.remove(NoteColumns.ID); // 移除无效ID字段 - } - - // 使用ContentResolver插入新的笔记数据到数据库 - Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI, mDiffNoteValues); - - try { - // 从插入返回的URI中解析出新笔记的ID - mId = Long.valueOf(uri.getPathSegments().get(1)); - } catch (NumberFormatException e) { - Log.e(TAG, "Get note id error :" + e.toString()); // 记录错误日志 - // 如果无法解析出ID，抛出异常，表示创建失败 - throw new ActionFailureException("create note failed"); - } - // 检查解析出的ID是否有效 - if (mId == 0) { - throw new IllegalStateException("Create thread id failed"); // 如果ID无效，抛出异常 - } - - // 如果是创建笔记类型，提交关联数据 - if (mType == Notes.TYPE_NOTE) { - // 遍历与当前笔记关联的数据项，提交每一个数据项 - for (SqlData sqlData : mDataList) { - sqlData.commit(mId, false, -1); // 提交关联数据 - } - } - } else { // 处理更新现有笔记的逻辑 - // 如果指定的笔记ID无效或不存在，抛出异常 - if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) { - Log.e(TAG, "No such note"); // 记录错误日志 - throw new IllegalStateException("Try to update note with invalid id"); // 抛出异常 - } - - // 如果有差异的数据需要更新，则进行更新 - if (mDiffNoteValues.size() > 0) { - mVersion++; // 更新版本号 - int result = 0; // 存储更新结果 - // 根据是否验证版本号，执行不同的更新逻辑 - if (!validateVersion) { - // 不验证版本号时，直接更新 - result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "(" - + NoteColumns.ID + "=?)", new String[]{ - String.valueOf(mId) // 使用当前笔记ID - }); - } else { - // 验证版本号时，进行条件更新 - result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "(" - + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)", - new String[]{ - String.valueOf(mId), String.valueOf(mVersion) // 检查当前版本号 - }); - } - - // 如果更新结果为0，说明没有进行任何更新，可能是由于同步时用户同时更新了笔记 - if (result == 0) { - Log.w(TAG, "there is no update. maybe user updates note when syncing"); // 记录警告日志 - } - } - - // 如果是笔记类型，提交关联数据 - 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; // 设置当前状态为非创建状态 -} - diff --git a/src/gtask/data/Task.java b/src/gtask/data/Task.java deleted file mode 100644 index ada2d4b..0000000 --- a/src/gtask/data/Task.java +++ /dev/null @@ -1,415 +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; - -/** - * 任务类，表示一个待办事项。 - * 用于管理和同步任务数据。 - */ -public class Task extends Node { - // 日志标签 - private static final String TAG = Task.class.getSimpleName(); - - // 任务完成状态 - private boolean mCompleted; - - // 任务备注 - private String mNotes; - - // 任务元信息，包含额外的JSON格式信息 - private JSONObject mMetaInfo; - - // 前一个兄弟任务 - private Task mPriorSibling; - - // 任务所属的任务列表 - private TaskList mParent; - - /** - * 构造函数，初始化任务状态。 - */ - public Task() { - super(); // 调用父类Node的构造函数 - mCompleted = false; // 初始化任务为未完成状态 - mNotes = null; // 初始化备注为null - mPriorSibling = null; // 初始前一个兄弟任务为null - mParent = null; // 初始化父任务列表为null - mMetaInfo = null; // 初始化元信息为null - } - - /** - * 生成创建任务的JSON动作对象。 - * - * @param actionId 动作ID - * @return 包含创建任务动作的JSON对象 - * @throws ActionFailureException 如果生成JSON对象失败 - */ - public JSONObject getCreateAction(int actionId) { - JSONObject js = new JSONObject(); - - try { - // 设置动作类型为创建 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE); - - // 设置动作ID - js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - - // 设置任务在父列表中的索引 - js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this)); - - // 设置任务实体信息 - JSONObject entity = new JSONObject(); - entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); - entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null"); - entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE, - GTaskStringUtils.GTASK_JSON_TYPE_TASK); - if (getNotes() != null) { - entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes()); - } - js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity); // 将任务实体信息添加到JSON - - // 设置父任务ID - js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid()); - - // 设置目标父类型为任务列表 - js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE, - GTaskStringUtils.GTASK_JSON_TYPE_GROUP); - - // 设置任务列表ID - js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid()); - - // 如果存在前一个兄弟任务，设置其ID - if (mPriorSibling != null) { - js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid()); - } - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to generate task-create jsonobject"); // 抛出异常，表示JSON生成失败 - } - - return js; // 返回生成的JSON对象 - } - - /** - * 生成更新任务的JSON动作对象。 - * - * @param actionId 动作ID - * @return 包含更新任务动作的JSON对象 - * @throws ActionFailureException 如果生成JSON对象失败 - */ - public JSONObject getUpdateAction(int actionId) { - JSONObject js = new JSONObject(); - - try { - // 设置动作类型为更新 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE); - - // 设置动作ID - js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - - // 设置任务ID - js.put(GTaskStringUtils.GTASK_JSON_ID, getGid()); - - // 设置任务实体信息 - JSONObject entity = new JSONObject(); - entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); - if (getNotes() != null) { - entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes()); - } - entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted()); // 设置删除状态 - js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity); // 将实体信息添加到JSON - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to generate task-update jsonobject"); // 抛出异常，表示JSON生成失败 - } - - return js; // 返回生成的JSON对象 - } - - /** - * 根据远程JSON对象设置任务内容。 - * - * @param js 远程获取的JSON对象 - * @throws ActionFailureException 如果从JSON对象中获取内容失败 - */ - public void setContentByRemoteJSON(JSONObject js) { - if (js != null) { - try { - // 从JSON中解析任务信息 - if (js.has(GTaskStringUtils.GTASK_JSON_ID)) { - setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID)); // 设置任务ID - } - - if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) { - setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)); // 设置最后修改时间 - } - - if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) { - setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME)); // 设置任务名称 - } - - if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) { - setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES)); // 设置任务备注 - } - - if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) { - setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED)); // 设置任务删除状态 - } - - if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) { - setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED)); // 设置任务完成状态 - } - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to get task content from jsonobject"); // 抛出异常，表示获取内容失败 - } - } - } - - /** - * 根据本地JSON对象设置任务内容。 - * - * @param js 本地获取的JSON对象 - * @throws ActionFailureException 如果从JSON对象中获取内容失败 - */ - public void setContentByLocalJSON(JSONObject js) { - if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE) - || !js.has(GTaskStringUtils.META_HEAD_DATA)) { - Log.w(TAG, "setContentByLocalJSON: nothing is available"); // 记录警告，无内容可设置 - return; - } - - try { - JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); // 获取笔记信息 - JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA); // 获取数据数组 - - // 验证笔记类型 - if (note.getInt(NoteColumns.TYPE) != Notes.TYPE_NOTE) { - Log.e(TAG, "invalid type"); // 记录错误，类型无效 - return; - } - - // 遍历数据数组，设置任务名称 - for (int i = 0; i < dataArray.length(); i++) { - JSONObject data = dataArray.getJSONObject(i); - if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) { - setName(data.getString(DataColumns.CONTENT)); // 设置任务名称 - break; // 找到名称后退出循环 - } - } - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - } - } - - /** - * 根据任务内容生成本地JSON对象。 - * - * @return 本地JSON对象，用于数据同步 - */ - public JSONObject getLocalJSONFromContent() { - String name = getName(); // 获取任务名称 - try { - if (mMetaInfo == null) { - // 新创建的任务 - if (name == null) { - Log.w(TAG, "the note seems to be an empty one"); // 记录警告，任务为空 - return null; // 返回null - } - - JSONObject js = new JSONObject(); // 创建新的JSON对象 - JSONObject note = new JSONObject(); - JSONArray dataArray = new JSONArray(); - JSONObject data = new JSONObject(); - data.put(DataColumns.CONTENT, name); // 设置任务内容 - dataArray.put(data); // 将内容添加到数据数组 - js.put(GTaskStringUtils.META_HEAD_DATA, dataArray); // 添加数据数组到JSON - note.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 设置笔记类型 - js.put(GTaskStringUtils.META_HEAD_NOTE, note); // 添加笔记信息到JSON - return js; // 返回生成的JSON对象 - } else { - // 已同步的任务 - JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); - JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA); - - // 更新已同步的任务内容 - for (int i = 0; i < dataArray.length(); i++) { - JSONObject data = dataArray.getJSONObject(i); - if (TextUtils.equals(data.getString(DataColumns.MIME_TYPE), DataConstants.NOTE)) { - data.put(DataColumns.CONTENT, getName()); // 更新任务内容 - break; // 找到后退出循环 - } - } - - note.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 确保笔记信息的类型为任务 - return mMetaInfo; // 返回元信息 - } - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - return null; // 返回null，表示生成失败 - } - } - - /** - * 设置任务的元信息。 - * - * @param metaData 元数据对象，包含任务的额外信息 - */ - public void setMetaInfo(MetaData metaData) { - if (metaData != null && metaData.getNotes() != null) { - try { - mMetaInfo = new JSONObject(metaData.getNotes()); // 创建元信息的JSON对象 - } catch (JSONException e) { - Log.w(TAG, e.toString()); // 记录警告 - mMetaInfo = null; // 设置为null - } - } - } - - /** - * 根据数据库游标获取同步动作类型。 - * - * @param c 数据库游标，指向当前任务的数据行 - * @return 同步动作类型，定义了任务数据的同步方向 - */ - public int getSyncAction(Cursor c) { - try { - JSONObject noteInfo = null; - // 获取任务的元信息 - if (mMetaInfo != null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) { - noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); - } - - // 检查元信息是否存在 - if (noteInfo == null) { - Log.w(TAG, "it seems that note meta has been deleted"); - return SYNC_ACTION_UPDATE_REMOTE; // 如果元信息已删除，返回更新远程标识 - } - - // 检查远程任务ID是否存在 - if (!noteInfo.has(NoteColumns.ID)) { - Log.w(TAG, "remote note id seems to be deleted"); - return SYNC_ACTION_UPDATE_LOCAL; // 返回更新本地标识 - } - - // 验证本地和远程任务ID是否匹配 - if (c.getLong(SqlNote.ID_COLUMN) != noteInfo.getLong(NoteColumns.ID)) { - Log.w(TAG, "note id doesn't match"); // 记录事件，ID不匹配 - return SYNC_ACTION_UPDATE_LOCAL; - } - - // 检查本地修改状态 - if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) { - // 本地未修改 - if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) { - // 本地和远程都未修改 - return SYNC_ACTION_NONE; // 返回无动作标识 - } else { - // 应用远程修改到本地 - return SYNC_ACTION_UPDATE_LOCAL; - } - } else { - // 本地已修改 - if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) { - Log.e(TAG, "gtask id doesn't match"); - return SYNC_ACTION_ERROR; // 返回错误标识 - } - if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) { - // 仅本地修改 - return SYNC_ACTION_UPDATE_REMOTE; - } else { - return SYNC_ACTION_UPDATE_CONFLICT; // 返回更新冲突标识 - } - } - } catch (Exception e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - } - - return SYNC_ACTION_ERROR; // 默认返回错误标识 - } - - /** - * 判断任务是否值得保存。 - * - * @return 如果任务有名称或备注，或者有元信息则返回true，否则返回false。 - */ - public boolean isWorthSaving() { - // 任务值得保存的条件是：有元信息，或任务名称不为空，或任务备注不为空 - return mMetaInfo != null || (getName() != null && getName().trim().length() > 0) - || (getNotes() != null && getNotes().trim().length() > 0); - } - - // 以下为任务状态的设置和获取方法 - - 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; // 获取任务列表父对象 - } -} diff --git a/src/gtask/data/TaskList.java b/src/gtask/data/TaskList.java deleted file mode 100644 index 015f659..0000000 --- a/src/gtask/data/TaskList.java +++ /dev/null @@ -1,463 +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; - -/** - * 任务列表类，继承自Node类。用于管理一组任务（Task）对象。 - */ -public class TaskList extends Node { - // 日志标签 - private static final String TAG = TaskList.class.getSimpleName(); - - // 列表中的任务索引 - private int mIndex; - - // 存储子任务的列表 - private ArrayList mChildren; - - /** - * 构造函数，初始化任务列表。 - */ - public TaskList() { - super(); // 调用父类Node构造函数 - mChildren = new ArrayList(); // 初始化子任务列表 - mIndex = 1; // 默认索引设置为1 - } - - /** - * 生成创建任务列表的动作JSON对象。 - * - * @param actionId 动作标识符 - * @return 包含创建任务列表动作的JSON对象 - * @throws ActionFailureException 如果生成JSON对象失败，则抛出异常 - */ - public JSONObject getCreateAction(int actionId) throws ActionFailureException { - JSONObject js = new JSONObject(); - - try { - // 设置动作类型为创建 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE); - - // 设置动作标识符 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - - // 设置索引 - js.put(GTaskStringUtils.GTASK_JSON_INDEX, mIndex); - - // 设置实体变化信息 - JSONObject entity = new JSONObject(); - entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); - entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null"); - entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE, - GTaskStringUtils.GTASK_JSON_TYPE_GROUP); - js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity); // 将任务列表实体信息加入JSON - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to generate tasklist-create jsonobject"); // 抛出异常，表示JSON生成失败 - } - - return js; // 返回生成的JSON对象 - } - - /** - * 生成更新任务列表的动作JSON对象。 - * - * @param actionId 动作标识符 - * @return 包含更新任务列表动作的JSON对象 - * @throws ActionFailureException 如果生成JSON对象失败，则抛出异常 - */ - public JSONObject getUpdateAction(int actionId) throws ActionFailureException { - JSONObject js = new JSONObject(); - - try { - // 设置动作类型为更新 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE); - - // 设置动作标识符 - js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId); - - // 设置任务列表ID - js.put(GTaskStringUtils.GTASK_JSON_ID, getGid()); - - // 设置实体变化信息 - JSONObject entity = new JSONObject(); - entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName()); - entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted()); // 设置删除状态 - js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity); // 将实体信息加入JSON - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to generate tasklist-update jsonobject"); // 抛出异常，表示JSON生成失败 - } - - return js; // 返回生成的JSON对象 - } - - /** - * 根据远程JSON对象设置任务列表的内容。 - * - * @param js 远程获取的JSON对象 - * @throws ActionFailureException 如果从JSON对象中获取内容失败，则抛出异常 - */ - public void setContentByRemoteJSON(JSONObject js) throws ActionFailureException { - if (js != null) { - try { - // 设置ID - if (js.has(GTaskStringUtils.GTASK_JSON_ID)) { - setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID)); // 设置任务列表ID - } - - // 设置最后修改时间 - if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) { - setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)); - } - - // 设置名称 - if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) { - setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME)); // 设置任务列表名称 - } - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to get tasklist content from jsonobject"); // 抛出异常，表示获取内容失败 - } - } - } - - /** - * 根据本地JSON对象设置任务列表的内容。 - * - * @param js 本地获取的JSON对象 - * @throws ActionFailureException 如果从JSON对象中获取内容失败，则抛出异常 - */ - public void setContentByLocalJSON(JSONObject js) throws ActionFailureException { - if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) { - Log.w(TAG, "setContentByLocalJSON: nothing is available"); // 记录警告，无有效内容 - return; - } - - try { - JSONObject folder = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); // 获取任务列表信息 - - // 根据类型设置任务列表名称 - 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) { - if (folder.getLong(NoteColumns.ID) == Notes.ID_ROOT_FOLDER) - setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT); // 默认根文件夹名称 - else if (folder.getLong(NoteColumns.ID) == Notes.ID_CALL_RECORD_FOLDER) - setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX - + GTaskStringUtils.FOLDER_CALL_NOTE); // 通话记录文件夹名称 - else - Log.e(TAG, "invalid system folder"); // 记录错误，系统文件夹无效 - } else { - Log.e(TAG, "error type"); // 记录错误，类型错误 - } - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - throw new ActionFailureException("fail to set tasklist content from local json object"); // 抛出异常，表示设置内容失败 - } - } - - /** - * 从任务列表内容生成本地JSON对象。 - * - * @return 本地JSON对象代表的任务列表内容 - */ - public JSONObject getLocalJSONFromContent() { - try { - JSONObject js = new JSONObject(); // 创建新的JSON对象 - JSONObject folder = new JSONObject(); // 创建任务列表信息对象 - - // 设置任务列表名称 - String folderName = getName(); - if (getName().startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)) - folderName = folderName.substring(GTaskStringUtils.MIUI_FOLDER_PREFFIX.length(), - folderName.length()); - folder.put(NoteColumns.SNIPPET, folderName); // 设置简要描述 - // 根据名称判断类型 - if (folderName.equals(GTaskStringUtils.FOLDER_DEFAULT) - || folderName.equals(GTaskStringUtils.FOLDER_CALL_NOTE)) { - folder.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM); // 系统类型 - } else { - folder.put(NoteColumns.TYPE, Notes.TYPE_FOLDER); // 普通文件夹类型 - } - - js.put(GTaskStringUtils.META_HEAD_NOTE, folder); // 添加任务列表信息到JSON - - return js; // 返回生成的JSON对象 - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - return null; // 生成失败，返回null - } - } - - /** - * 根据本地数据库游标确定同步动作。 - * - * @param c 数据库游标，指向当前任务列表的行 - * @return 同步动作的类型 - */ - public int getSyncAction(Cursor c) { - try { - if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) { - // 无本地更新 - if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) { - // 双方均无更新 - return SYNC_ACTION_NONE; // 返回无更新状态 - } else { - // 应用远程更新到本地 - return SYNC_ACTION_UPDATE_LOCAL; - } - } else { - // 验证GTask ID是否匹配 - if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) { - Log.e(TAG, "gtask id doesn't match"); // 记录错误，ID不匹配 - return SYNC_ACTION_ERROR; // 返回错误状态 - } - // 对于文件夹情况，应该的返回逻辑 - return SYNC_ACTION_UPDATE_REMOTE; // 仅本地有修改 - } - } catch (Exception e) { - Log.e(TAG, e.toString()); // 记录错误日志 - e.printStackTrace(); - } - - return SYNC_ACTION_ERROR; // 默认返回错误状态 - } - - /** - * 获取子任务数量。 - * - * @return 子任务数量 - */ - public int getChildTaskCount() { - return mChildren.size(); // 返回当前子任务的数量 - } - - /** - * 添加一个子任务到列表中。 - * - * @param task 要添加的子任务 - * @return 如果添加成功返回true，否则返回false - */ - public boolean addChildTask(Task task) { - boolean ret = false; - if (task != null && !mChildren.contains(task)) { - ret = mChildren.add(task); // 添加任务 - if (ret) { - // 设置前置兄弟节点和父节点 - task.setPriorSibling(mChildren.isEmpty() ? null : mChildren - .get(mChildren.size() - 1)); // 设置前置兄弟任务为最后一个子任务 - task.setParent(this); // 设置父任务列表为当前任务列表 - } - } - return ret; // 返回添加结果 - } - - /** - * 在指定索引位置添加一个子任务。 - * - * @param task 要添加的子任务 - * @param index 子任务要插入的索引位置 - * @return 如果添加成功返回true，否则返回false - */ - public boolean addChildTask(Task task, int index) { - if (index < 0 || index > mChildren.size()) { - Log.e(TAG, "add child task: invalid index"); // 记录错误，索引无效 - return false; - } - - int pos = mChildren.indexOf(task); - if (task != null && pos == -1) { - mChildren.add(index, task); // 插入子任务 - - // 更新任务列表 - Task preTask = null; - Task afterTask = null; - if (index != 0) - preTask = mChildren.get(index - 1); // 获取前一个子任务 - if (index != mChildren.size() - 1) - afterTask = mChildren.get(index + 1); // 获取后一个子任务 - - task.setPriorSibling(preTask); // 设置前置兄弟 - if (afterTask != null) - afterTask.setPriorSibling(task); // 设置后置兄弟 - } - - return true; // 添加成功 - } - - /** - * 从列表中移除一个子任务。 - * - * @param task 要移除的子任务 - * @return 如果移除成功返回true，否则返回false - */ - public boolean removeChildTask(Task task) { - boolean ret = false; - int index = mChildren.indexOf(task); // 查找任务在子任务列表中的索引 - if (index != -1) { - ret = mChildren.remove(task); // 移除任务 - - if (ret) { - // 重置前置兄弟节点和父节点 - task.setPriorSibling(null); - task.setParent(null); - - // 更新任务列表 - if (index != mChildren.size()) { - mChildren.get(index).setPriorSibling( - index == 0 ? null : mChildren.get(index - 1)); // 更新后面任务的前置兄弟 - } - } - } - return ret; // 返回移除结果 - } - - /** - * 移动子任务到指定索引位置。 - * - * @param task 要移动的子任务 - * @param index 子任务要移动到的索引位置 - * @return 如果移动成功返回true，否则返回false - */ - public boolean moveChildTask(Task task, int index) { - if (index < 0 || index >= mChildren.size()) { - Log.e(TAG, "move child task: invalid index"); // 记录错误，索引无效 - return false; - } - - int pos = mChildren.indexOf(task); - if (pos == -1) { - Log.e(TAG, "move child task: the task should in the list"); // 记录错误，任务不在列表中 - return false; - } - - if (pos == index) - return true; // 位置未变，返回成功 - return (removeChildTask(task) && addChildTask(task, index)); // 移除后再添加 - } - - /** - * 根据全局标识符(gid)查找子任务。 - * - * @param gid 要查找的子任务的全局标识符 - * @return 如果找到匹配的子任务，则返回该任务对象；否则返回null。 - */ - public Task findChildTaskByGid(String gid) { - // 遍历子任务列表，查找gid匹配的子任务 - for (int i = 0; i < mChildren.size(); i++) { - Task t = mChildren.get(i); - if (t.getGid().equals(gid)) { - return t; // 返回找到的任务 - } - } - return null; // 未找到则返回null - } - - /** - * 获取指定子任务在列表中的索引位置。 - * - * @param task 要查找索引的子任务对象 - * @return 子任务在列表中的索引位置；如果未找到该任务，则返回-1。 - */ - public int getChildTaskIndex(Task task) { - // 返回任务在子任务列表中的索引 - return mChildren.indexOf(task); - } - - /** - * 根据索引获取子任务。 - * - * @param index 子任务的索引位置 - * @return 如果索引有效，则返回对应位置的子任务对象；否则返回null。 - */ - public Task getChildTaskByIndex(int index) { - // 检查索引是否有效，然后返回对应位置的子任务 - if (index < 0 || index >= mChildren.size()) { - Log.e(TAG, "getTaskByIndex: invalid index"); // 记录错误，索引无效 - return null; - } - return mChildren.get(index); // 返回子任务 - } - - /** - * 通过遍历子任务列表，查找并返回匹配指定gid的子任务。 - * - * @param gid 要查找的子任务的全局标识符 - * @return 如果找到匹配的子任务，则返回该任务对象；否则返回null。 - */ - public Task getChildTaskByGid(String gid) { - // 遍历子任务列表，查找gid匹配的子任务 - for (Task task : mChildren) { - if (task.getGid().equals(gid)) - return task; // 返回找到的任务 - } - return null; // 未找到则返回null - } - - /** - * 获取所有子任务的列表。 - * - * @return 子任务列表，作为一个ArrayList返回。 - */ - public ArrayList getChildTaskList() { - // 返回存储子任务的列表 - return this.mChildren; - } - - /** - * 设置当前任务的索引。 - * - * @param index 要设置的索引值。 - */ - public void setIndex(int index) { - this.mIndex = index; // 设置任务列表索引 - } - - /** - * 获取当前任务的索引。 - * - * @return 当前任务的索引值。 - */ - public int getIndex() { - return this.mIndex; // 返回当前任务索引 - } -} diff --git a/src/gtask/exception/ActionFailureException.java b/src/gtask/exception/ActionFailureException.java deleted file mode 100644 index 3737065..0000000 --- a/src/gtask/exception/ActionFailureException.java +++ /dev/null @@ -1,53 +0,0 @@ -/* - * ActionFailureException 类的注释 - * - * 该异常类是运行时异常的子类，用于表示操作失败的异常情况。 - * 它可以包含一个错误消息和导致异常的 Throwable 对象。 - * 这个类主要是为了处理任务或动作执行失败的情况， - * 提供了一个通用的方式来报告和处理这类错误。 - * - * 许可证信息: 见类文件头部的版权声明 - */ - -package net.micode.notes.gtask.exception; - -// 引入 Java 运行时异常类 -import java.lang.RuntimeException; - -/** - * ActionFailureException 类定义了一个操作失败时抛出的异常。 - * - * 这个异常类可以用来表示在执行某个操作过程中出现的故障， - * 比如在任务创建、更新或删除时发生错误。 - */ -public class ActionFailureException extends RuntimeException { - private static final long serialVersionUID = 4425249765923293627L; // 序列化 ID - - /** - * 无参构造函数，创建一个不带详细消息的动作失败异常实例。 - */ - public ActionFailureException() { - super(); // 调用父类RuntimeException的无参构造函数 - } - - /** - * 带有详细信息的构造函数，创建一个带有详细错误消息的动作失败异常实例。 - * - * @param paramString 错误信息字符串，用于描述异常的详细情况。 - */ - public ActionFailureException(String paramString) { - super(paramString); // 调用父类RuntimeException的构造函数，将错误消息传递给它 - } - - /** - * 带有详细信息和导致异常的原因的构造函数，创建一个带有详细错误消息 - * 和导致异常的 Throwable 对象的动作失败异常实例。 - * - * @param paramString 错误信息字符串，用于描述异常的详细情况。 - * @param paramThrowable 导致异常的 Throwable 对象。 - */ - public ActionFailureException(String paramString, Throwable paramThrowable) { - super(paramString, paramThrowable); // 调用父类RuntimeException的构造函数 - // 将错误信息和抛出的异常传递给父类 - } -} diff --git a/src/gtask/exception/NetworkFailureException.java b/src/gtask/exception/NetworkFailureException.java deleted file mode 100644 index 0a488c0..0000000 --- a/src/gtask/exception/NetworkFailureException.java +++ /dev/null @@ -1,47 +0,0 @@ -/* - * NetworkFailureException 类的注释 - * - * 该异常类用于表示网络操作失败的异常。它是 Exception 的子类， - * 可用来捕获和处理应用程序中发生的网络错误。 - * 可以通过不同的构造函数来创建包含详细信息或不包含详细信息的 - * NetworkFailureException 实例。 - */ - -package net.micode.notes.gtask.exception; - -/** - * NetworkFailureException 类表示在网络操作中发生的错误。 - * - * 该异常可以用于捕获与网络相关的错误，例如连接失败， - * 超时或数据传输过程中的错误等。 - */ -public class NetworkFailureException extends Exception { - private static final long serialVersionUID = 2107610287180234136L; // 序列化 ID - - /** - * 无参构造函数，用于创建一个不带详细信息的 NetworkFailureException 实例。 - */ - public NetworkFailureException() { - super(); // 调用父类 Exception 的无参构造函数 - } - - /** - * 带有详细信息的构造函数，用于创建一个包含错误信息的 NetworkFailureException 实例。 - * - * @param paramString 错误信息字符串，用于描述异常的详细情况。 - */ - public NetworkFailureException(String paramString) { - super(paramString); // 调用父类的构造函数，将错误信息传递 - } - - /** - * 带有详细信息和导致异常的 Throwable 对象的构造函数， - * 用于创建包含错误信息和原因的 NetworkFailureException 实例。 - * - * @param paramString 错误信息字符串，用于描述异常的详细情况。 - * @param paramThrowable 导致异常的 Throwable 对象。 - */ - public NetworkFailureException(String paramString, Throwable paramThrowable) { - super(paramString, paramThrowable); // 调用父类构造函数，将错误信息和原因传递 - } -} diff --git a/src/gtask/remote/GTaskASyncTask.java b/src/gtask/remote/GTaskASyncTask.java deleted file mode 100644 index 54d3cc2..0000000 --- a/src/gtask/remote/GTaskASyncTask.java +++ /dev/null @@ -1,152 +0,0 @@ -/* - * GTaskASyncTask 类说明: - * 这是一个继承自AsyncTask的类，用于在后台执行Google任务同步操作。 - * 它可以在一个独立的线程中执行同步任务，并通过通知栏通知用户同步的状态（成功、失败、取消等）。 - * 同时，它提供了接口供调用者监听同步任务的完成。 - */ - -package net.micode.notes.gtask.remote; - -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; - -/** - * GTaskASyncTask 类负责执行 Google 任务的同步操作。 - * 它是一个 AsyncTask，它在后台线程中处理同步任务并更新UI。 - */ -public class GTaskASyncTask extends AsyncTask { - - // 同步通知的唯一ID - private static int GTASK_SYNC_NOTIFICATION_ID = 5234235; - - // 定义完成监听器接口 - public interface OnCompleteListener { - void onComplete(); // 同步完成时调用的方法 - } - - private Context mContext; // 上下文对象，用于访问应用资源和通知管理器 - private NotificationManager mNotifiManager; // 通知管理器，用于管理和显示通知 - private GTaskManager mTaskManager; // Google任务管理器，用于执行实际的同步操作 - private OnCompleteListener mOnCompleteListener; // 同步完成的监听器 - - /* - * 构造函数 - * @param context 应用的上下文环境 - * @param listener 同步完成时的监听器 - */ - public GTaskASyncTask(Context context, OnCompleteListener listener) { - mContext = context; // 保存上下文 - mOnCompleteListener = listener; // 设置监听器 - mNotifiManager = (NotificationManager) mContext - .getSystemService(Context.NOTIFICATION_SERVICE); // 获取通知管理器 - mTaskManager = GTaskManager.getInstance(); // 获取 Google 任务管理器实例 - } - - // 取消同步操作的方法 - public void cancelSync() { - mTaskManager.cancelSync(); // 调用 Google 任务管理器的取消同步方法 - } - - // 发布进度更新的方法 - public void publishProgess(String message) { - publishProgress(new String[]{ message }); // 调用AsyncTask的publishProgress方法 - } - - /* - * 显示通知的方法 - * @param tickerId 通知的Ticker文本资源ID - * @param content 通知的内容文本 - */ - private void showNotification(int tickerId, String content) { - PendingIntent pendingIntent; - - // 根据不同的通知状态设置不同的Intent - 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.Builder builder = new Notification.Builder(mContext) - .setAutoCancel(true) // 点击后自动消失 - .setContentTitle(mContext.getString(R.string.app_name)) // 通知标题 - .setContentText(content) // 通知内容 - .setContentIntent(pendingIntent) // 点击按钮处理 - .setWhen(System.currentTimeMillis()) // 通知时间 - .setOngoing(true); // 设定为进行中的通知 - Notification notification = builder.getNotification(); // 构建通知对象 - mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification); // 显示通知 - } - - /* - * 在后台执行同步操作的方法 - * @return 同步操作的状态码 - */ - @Override - protected Integer doInBackground(Void... unused) { - // 开始同步时的进度更新 - publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity - .getSyncAccountName(mContext))); // 发布同步中的消息 - return mTaskManager.sync(mContext, this); // 执行同步操作，并返回状态码 - } - - /* - * 更新进度的方法，会在调用publishProgress后被调用 - * @param progress 进度更新的内容 - */ - @Override - protected void onProgressUpdate(String... progress) { - // 显示当前同步进度 - showNotification(R.string.ticker_syncing, progress[0]); // 显示同步进度的通知 - // 如果上下文是一个GTaskSyncService实例，发送广播更新进度 - if (mContext instanceof GTaskSyncService) { - ((GTaskSyncService) mContext).sendBroadcast(progress[0]); // 发送进度广播 - } - } - - /* - * 同步任务完成后的处理方法 - * @param result 同步操作的状态码 - */ - @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(); - } - } -} diff --git a/src/gtask/remote/GTaskClient.java b/src/gtask/remote/GTaskClient.java deleted file mode 100644 index e83cbfc..0000000 --- a/src/gtask/remote/GTaskClient.java +++ /dev/null @@ -1,1234 +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; - -import android.accounts.Account; -import android.accounts.AccountManager; -import android.accounts.AccountManagerFuture; -import android.app.Activity; -import android.os.Bundle; -import android.text.TextUtils; -import android.util.Log; - -import net.micode.notes.gtask.data.Node; -import net.micode.notes.gtask.data.Task; -import net.micode.notes.gtask.data.TaskList; -import net.micode.notes.gtask.exception.ActionFailureException; -import net.micode.notes.gtask.exception.NetworkFailureException; -import net.micode.notes.tool.GTaskStringUtils; -import net.micode.notes.ui.NotesPreferenceActivity; - -import org.apache.http.HttpEntity; -import org.apache.http.HttpResponse; -import org.apache.http.client.ClientProtocolException; -import org.apache.http.client.entity.UrlEncodedFormEntity; -import org.apache.http.client.methods.HttpGet; -import org.apache.http.client.methods.HttpPost; -import org.apache.http.cookie.Cookie; -import org.apache.http.impl.client.BasicCookieStore; -import org.apache.http.impl.client.DefaultHttpClient; -import org.apache.http.message.BasicNameValuePair; -import org.apache.http.params.BasicHttpParams; -import org.apache.http.params.HttpConnectionParams; -import org.apache.http.params.HttpParams; -import org.apache.http.params.HttpProtocolParams; -import org.json.JSONArray; -import org.json.JSONException; -import org.json.JSONObject; - -import java.io.BufferedReader; -import java.io.IOException; -import java.io.InputStream; -import java.io.InputStreamReader; -import java.util.LinkedList; -import java.util.List; -import java.util.zip.GZIPInputStream; -import java.util.zip.Inflater; -import java.util.zip.InflaterInputStream; - - -/** - * GTaskClient类用于与Google任务服务进行远程交互。 - * 提供了登录、获取任务列表、添加任务等操作的方法。 - */ -public class GTaskClient { - // 日志标签 - private static final String TAG = GTaskClient.class.getSimpleName(); - - // Google任务服务的基础URL - private static final String GTASK_URL = "https://mail.google.com/tasks/"; - - // 用于获取任务信息的URL - private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig"; - - // 用于提交任务信息的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; - - /** - * GTaskClient的私有构造方法，初始化各种属性。 - */ - 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的单例实例。 - * - * @return GTaskClient的单例实例。 - */ - public static synchronized GTaskClient getInstance() { - // 确保仅创建一个实例 - if (mInstance == null) { - mInstance = new GTaskClient(); - } - return mInstance; - } - - /** - * 用户登录函数。 - * - * @param activity 当前活动，用于获取账户信息和上下文。 - * @return 登录成功返回true，失败返回false。 - */ - public boolean login(Activity activity) { - // 检查登录是否过期 - final long interval = 1000 * 60 * 5; // 5分钟 - if (mLastLoginTime + interval < System.currentTimeMillis()) { - mLoggedin = false; - } - - // 检查账户是否切换，需要重新登录 - if (mLoggedin - && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity - .getSyncAccountName(activity))) { - mLoggedin = false; - } - - // 如果已经登录，则直接返回成功 - if (mLoggedin) { - Log.d(TAG, "already logged in"); - return true; - } - - // 记录当前登录时间 - mLastLoginTime = System.currentTimeMillis(); - // 尝试登录Google账户 - String authToken = loginGoogleAccount(activity, false); - if (authToken == null) { - Log.e(TAG, "login google account failed"); - return false; - } - - // 如果是自定义域名邮箱，则尝试使用自定义域名登录 - if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase() - .endsWith("googlemail.com"))) { - // 构造自定义域名的登录URL - StringBuilder url = new StringBuilder(GTASK_URL).append("a/"); - int index = mAccount.name.indexOf('@') + 1; - String suffix = mAccount.name.substring(index); - url.append(suffix + "/"); - mGetUrl = url.toString() + "ig"; - mPostUrl = url.toString() + "r/ig"; - - // 尝试使用自定义域名登录 - if (tryToLoginGtask(activity, authToken)) { - mLoggedin = true; - } - } - - // 如果使用自定义域名登录失败，则尝试使用官方URL登录 - if (!mLoggedin) { - mGetUrl = GTASK_GET_URL; - mPostUrl = GTASK_POST_URL; - if (!tryToLoginGtask(activity, authToken)) { - return false; - } - } - - // 登录成功 - mLoggedin = true; - return true; - } - - - /** - * 使用Google账户登录，获取授权令牌。 - * - * @param activity 当前活动，用于获取账户管理器。 - * @param invalidateToken 是否吊销之前的令牌并重新获取。 - * @return 返回获取到的授权令牌，如果失败或没有可用账户返回null。 - */ - private String loginGoogleAccount(Activity activity, boolean invalidateToken) { - String authToken; - // 获取账户管理器和所有Google账户 - AccountManager accountManager = AccountManager.get(activity); - Account[] accounts = accountManager.getAccountsByType("com.google"); - - // 检查是否有可用的Google账户 - if (accounts.length == 0) { - Log.e(TAG, "there is no available google account"); - return null; - } - - // 根据设置中的账户名选择账户 - String accountName = NotesPreferenceActivity.getSyncAccountName(activity); - Account account = null; - for (Account a : accounts) { - if (a.name.equals(accountName)) { - account = a; - break; - } - } - // 检查是否找到设置中对应的账户 - if (account != null) { - mAccount = account; - } else { - Log.e(TAG, "unable to get an account with the same name in the settings"); - return null; - } - - // 获取授权令牌 - AccountManagerFuture 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) { - Log.e(TAG, "get auth token failed"); - authToken = null; - } - - return authToken; - } - - /** - * 尝试使用授权令牌登录Gtask。 - * - * @param activity 当前活动，用于登录过程中的UI交互。 - * @param authToken 授权令牌。 - * @return 如果登录成功返回true，否则返回false。 - */ - private boolean tryToLoginGtask(Activity activity, String authToken) { - // 首次尝试登录Gtask - if (!loginGtask(authToken)) { - // 如果失败，尝试吊销令牌并重新获取后再次登录 - authToken = loginGoogleAccount(activity, true); - if (authToken == null) { - Log.e(TAG, "login google account failed"); - return false; - } - - // 使用新令牌再次尝试登录Gtask - if (!loginGtask(authToken)) { - Log.e(TAG, "login gtask failed"); - return false; - } - } - return true; - } - - /** - * 执行Gtask登录操作。 - * - * @param authToken 授权令牌。 - * @return 登录成功返回true，失败返回false。 - */ - private boolean loginGtask(String authToken) { - // 设置HTTP连接参数 - int timeoutConnection = 10000; - int timeoutSocket = 15000; - HttpParams httpParameters = new BasicHttpParams(); - HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection); - HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket); - mHttpClient = new DefaultHttpClient(httpParameters); - BasicCookieStore localBasicCookieStore = new BasicCookieStore(); - mHttpClient.setCookieStore(localBasicCookieStore); - HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false); - - // 使用授权令牌登录Gtask - try { - String loginUrl = mGetUrl + "?auth=" + authToken; - HttpGet httpGet = new HttpGet(loginUrl); - HttpResponse response = null; - response = mHttpClient.execute(httpGet); - - // 检查是否获取到授权Cookie - List cookies = mHttpClient.getCookieStore().getCookies(); - boolean hasAuthCookie = false; - for (Cookie cookie : cookies) { - if (cookie.getName().contains("GTL")) { - hasAuthCookie = true; - } - } - if (!hasAuthCookie) { - Log.w(TAG, "it seems that there is no auth cookie"); - } - - // 解析响应，获取客户端版本 - String resString = getResponseContent(response.getEntity()); - String jsBegin = "_setup("; - String jsEnd = ")}"; - int begin = resString.indexOf(jsBegin); - int end = resString.lastIndexOf(jsEnd); - String jsString = null; - if (begin != -1 && end != -1 && begin < end) { - jsString = resString.substring(begin + jsBegin.length(), end); - } - JSONObject js = new JSONObject(jsString); - mClientVersion = js.getLong("v"); - } catch (JSONException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - return false; - } catch (Exception e) { - Log.e(TAG, "httpget gtask_url failed"); - return false; - } - - return true; - } - - - /** - * 获取一个唯一的动作ID - * - * @return 返回当前动作的ID，每次调用自增 - */ - private int getActionId() { - return mActionId++; - } - - /** - * 创建一个HttpPost请求 - * - * @return 配置好的HttpPost对象 - */ - private HttpPost createHttpPost() { - HttpPost httpPost = new HttpPost(mPostUrl); - httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8"); - httpPost.setHeader("AT", "1"); - return httpPost; - } - - /** - * 从HttpEntity中获取响应内容 - * - * @param entity Http响应实体 - * @return 响应内容的字符串 - * @throws IOException 当读取响应内容失败时抛出 - */ - 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(); - // 根据内容编码类型，对输入流进行解压 - if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) { - input = new GZIPInputStream(entity.getContent()); - } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) { - 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请求，并返回解析后的JSONObject - * - * @param js 要发送的JSON对象 - * @return 请求响应的JSONObject - * @throws NetworkFailureException 当网络请求或处理失败时抛出 - */ - private JSONObject postRequest(JSONObject js) throws NetworkFailureException { - if (!mLoggedin) { - Log.e(TAG, "please login first"); - throw new ActionFailureException("not logged in"); - } - - HttpPost httpPost = createHttpPost(); - try { - LinkedList list = new LinkedList(); - list.add(new BasicNameValuePair("r", js.toString())); - UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8"); - httpPost.setEntity(entity); - - // 执行POST请求 - HttpResponse response = mHttpClient.execute(httpPost); - String jsString = getResponseContent(response.getEntity()); - return new JSONObject(jsString); - - } catch (ClientProtocolException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new NetworkFailureException("postRequest failed"); - } catch (IOException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new NetworkFailureException("postRequest failed"); - } catch (JSONException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new ActionFailureException("unable to convert response content to jsonobject"); - } catch (Exception e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new ActionFailureException("error occurs when posting request"); - } - } - - /** - * 创建一个任务 - * - * @param task 要创建的任务对象 - * @throws NetworkFailureException 当网络操作失败时抛出 - */ - public void createTask(Task task) throws NetworkFailureException { - commitUpdate(); - try { - JSONObject jsPost = new JSONObject(); - JSONArray actionList = new JSONArray(); - - // 构建动作列表 - actionList.put(task.getCreateAction(getActionId())); - jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); - - // 添加客户端版本信息 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); - - // 发送请求并处理响应 - JSONObject jsResponse = postRequest(jsPost); - JSONObject jsResult = (JSONObject) jsResponse.getJSONArray( - GTaskStringUtils.GTASK_JSON_RESULTS).get(0); - task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); - - } catch (JSONException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new ActionFailureException("create task: handling jsonobject failed"); - } - } - - - /** - * 创建任务列表。 - * - * @param tasklist 任务列表对象，包含创建任务所需的信息。 - * @throws NetworkFailureException 网络请求失败时抛出。 - */ - /* - * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package net.micode.notes.gtask.remote; - -import android.accounts.Account; -import android.accounts.AccountManager; -import android.accounts.AccountManagerFuture; -import android.app.Activity; -import android.os.Bundle; -import android.text.TextUtils; -import android.util.Log; - -import net.micode.notes.gtask.data.Node; -import net.micode.notes.gtask.data.Task; -import net.micode.notes.gtask.data.TaskList; -import net.micode.notes.gtask.exception.ActionFailureException; -import net.micode.notes.gtask.exception.NetworkFailureException; -import net.micode.notes.tool.GTaskStringUtils; -import net.micode.notes.ui.NotesPreferenceActivity; - -import org.apache.http.HttpEntity; -import org.apache.http.HttpResponse; -import org.apache.http.client.ClientProtocolException; -import org.apache.http.client.entity.UrlEncodedFormEntity; -import org.apache.http.client.methods.HttpGet; -import org.apache.http.client.methods.HttpPost; -import org.apache.http.cookie.Cookie; -import org.apache.http.impl.client.BasicCookieStore; -import org.apache.http.impl.client.DefaultHttpClient; -import org.apache.http.message.BasicNameValuePair; -import org.apache.http.params.BasicHttpParams; -import org.apache.http.params.HttpConnectionParams; -import org.apache.http.params.HttpParams; -import org.apache.http.params.HttpProtocolParams; -import org.json.JSONArray; -import org.json.JSONException; -import org.json.JSONObject; - -import java.io.BufferedReader; -import java.io.IOException; -import java.io.InputStream; -import java.io.InputStreamReader; -import java.util.LinkedList; -import java.util.List; -import java.util.zip.GZIPInputStream; -import java.util.zip.Inflater; -import java.util.zip.InflaterInputStream; - -/** - * GTaskClient 类用于与 Google 任务服务进行远程交互。 - * 提供了登录、获取任务列表、添加任务等操作的方法。 - */ -public class GTaskClient { - // 日志标签 - private static final String TAG = GTaskClient.class.getSimpleName(); - - // Google 任务服务的基础 URL - private static final String GTASK_URL = "https://mail.google.com/tasks/"; - - // 获取任务信息的 URL - private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig"; - - // 提交任务信息的 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; - - /** - * GTaskClient 的私有构造方法，初始化各种属性。 - */ - 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 的单例实例。 - * - * @return GTaskClient 的单例实例。 - */ - public static synchronized GTaskClient getInstance() { - // 确保仅创建一个实例 - if (mInstance == null) { - mInstance = new GTaskClient(); - } - return mInstance; - } - - /** - * 用户登录函数。 - * - * @param activity 当前活动，用于获取账户信息和上下文。 - * @return 登录成功返回 true，失败返回 false。 - */ - public boolean login(Activity activity) { - // 检查登录是否过期 - final long interval = 1000 * 60 * 5; // 5分钟 - if (mLastLoginTime + interval < System.currentTimeMillis()) { - mLoggedin = false; // 登录超时 - } - - // 检查账户是否切换，需要重新登录 - if (mLoggedin && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity.getSyncAccountName(activity))) { - mLoggedin = false; // 切换账户，重新登录 - } - - // 如果已经登录，则直接返回成功 - if (mLoggedin) { - Log.d(TAG, "already logged in"); - return true; - } - - // 记录当前登录时间 - mLastLoginTime = System.currentTimeMillis(); - - // 尝试登录 Google 账户 - String authToken = loginGoogleAccount(activity, false); - if (authToken == null) { - Log.e(TAG, "login google account failed"); - return false; - } - - // 如果是自定义域名邮箱，则尝试使用自定义域名登录 - if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase().endsWith("googlemail.com"))) { - // 构造自定义域名的登录 URL - StringBuilder url = new StringBuilder(GTASK_URL).append("a/"); - int index = mAccount.name.indexOf('@') + 1; - String suffix = mAccount.name.substring(index); - url.append(suffix + "/"); - mGetUrl = url.toString() + "ig"; - mPostUrl = url.toString() + "r/ig"; - - // 尝试使用自定义域名登录 - if (tryToLoginGtask(activity, authToken)) { - mLoggedin = true; // 登录成功 - } - } - - // 如果使用自定义域名登录失败，则尝试使用官方 URL 登录 - if (!mLoggedin) { - mGetUrl = GTASK_GET_URL; - mPostUrl = GTASK_POST_URL; - if (!tryToLoginGtask(activity, authToken)) { - return false; // 登录失败 - } - } - - // 登录成功 - mLoggedin = true; - return true; - } - - /** - * 使用 Google 账户登录，获取授权令牌。 - * - * @param activity 当前活动，用于获取账户管理器。 - * @param invalidateToken 是否吊销之前的令牌并重新获取。 - * @return 返回获取到的授权令牌，如果失败或没有可用账户返回null。 - */ - private String loginGoogleAccount(Activity activity, boolean invalidateToken) { - String authToken; - // 获取账户管理器和所有 Google 账户 - AccountManager accountManager = AccountManager.get(activity); - Account[] accounts = accountManager.getAccountsByType("com.google"); - - // 检查是否有可用的 Google 账户 - if (accounts.length == 0) { - Log.e(TAG, "there is no available google account"); - return null; // 无可用账户 - } - - // 根据设置中的账户名选择账户 - String accountName = NotesPreferenceActivity.getSyncAccountName(activity); - Account account = null; - for (Account a : accounts) { - if (a.name.equals(accountName)) { - account = a; // 找到账户 - break; - } - } - // 检查是否找到设置中对应的账户 - if (account != null) { - mAccount = account; // 保存账户信息 - } else { - Log.e(TAG, "unable to get an account with the same name in the settings"); - return null; // 找不到账户 - } - - // 获取授权令牌 - AccountManagerFuture 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) { - Log.e(TAG, "get auth token failed"); - authToken = null; // 获取令牌失败 - } - - return authToken; // 返回授权令牌 - } - - /** - * 尝试使用授权令牌登录 Gtask。 - * - * @param activity 当前活动，用于登录过程中的 UI 交互。 - * @param authToken 授权令牌。 - * @return 如果登录成功返回 true，否则返回 false。 - */ - private boolean tryToLoginGtask(Activity activity, String authToken) { - // 首次尝试登录 Gtask - if (!loginGtask(authToken)) { - // 如果失败，尝试吊销令牌并重新获取后再次登录 - authToken = loginGoogleAccount(activity, true); - if (authToken == null) { - Log.e(TAG, "login google account failed"); - return false; // 登录失败 - } - - // 使用新令牌再次尝试登录 Gtask - if (!loginGtask(authToken)) { - Log.e(TAG, "login gtask failed"); - return false; // 登录失败 - } - } - return true; // 登录成功 - } - - /** - * 执行 Gtask 登录操作。 - * - * @param authToken 授权令牌。 - * @return 登录成功返回 true，失败返回 false。 - */ - private boolean loginGtask(String authToken) { - // 设置 HTTP 连接参数 - int timeoutConnection = 10000; // 连接超时 - int timeoutSocket = 15000; // 套接字超时 - HttpParams httpParameters = new BasicHttpParams(); - HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection); - HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket); - mHttpClient = new DefaultHttpClient(httpParameters); // 初始化 HTTP 客户端 - BasicCookieStore localBasicCookieStore = new BasicCookieStore(); - mHttpClient.setCookieStore(localBasicCookieStore); - HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false); - - // 使用授权令牌登录 Gtask - try { - String loginUrl = mGetUrl + "?auth=" + authToken; // 构造登录 URL - HttpGet httpGet = new HttpGet(loginUrl); - HttpResponse response = mHttpClient.execute(httpGet); // 执行 GET 请求 - - // 检查是否获取到授权 Cookie - List cookies = mHttpClient.getCookieStore().getCookies(); - boolean hasAuthCookie = false; - for (Cookie cookie : cookies) { - if (cookie.getName().contains("GTL")) { - hasAuthCookie = true; // 找到授权 Cookie - } - } - if (!hasAuthCookie) { - Log.w(TAG, "it seems that there is no auth cookie"); // 没有找到授权 cookie - } - - // 解析响应，获取客户端版本 - String resString = getResponseContent(response.getEntity()); - String jsBegin = "_setup("; - String jsEnd = ")}"; - int begin = resString.indexOf(jsBegin); - int end = resString.lastIndexOf(jsEnd); - String jsString = null; - if (begin != -1 && end != -1 && begin < end) { - jsString = resString.substring(begin + jsBegin.length(), end); - } - JSONObject js = new JSONObject(jsString); - mClientVersion = js.getLong("v"); // 获取客户端版本 - } catch (JSONException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - return false; // 解析 JSON 失败 - } catch (Exception e) { - Log.e(TAG, "httpget gtask_url failed"); - return false; // HTTP 请求失败 - } - - return true; // 登录成功 - } - - /** - * 获取一个唯一的动作 ID - * - * @return 返回当前动作的 ID，每次调用自增 - */ - private int getActionId() { - return mActionId++; - } - - /** - * 创建一个 HttpPost 请求 - * - * @return 配置好的 HttpPost 对象 - */ - private HttpPost createHttpPost() { - HttpPost httpPost = new HttpPost(mPostUrl); // 创建 POST 请求 - httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8"); // 设置请求头 - httpPost.setHeader("AT", "1"); // 设置其他请求头 - return httpPost; - } - - /** - * 从 HttpEntity 中获取响应内容 - * - * @param entity Http 响应实体 - * @return 响应内容的字符串 - * @throws IOException 当读取响应内容失败时抛出 - */ - private String getResponseContent(HttpEntity entity) throws IOException { - String contentEncoding = null; // 内容编码 - if (entity.getContentEncoding() != null) { - contentEncoding = entity.getContentEncoding().getValue(); // 获取 encoding - Log.d(TAG, "encoding: " + contentEncoding); - } - - InputStream input = entity.getContent(); // 获取输入流 - // 根据内容编码类型，对输入流进行解压 - if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) { - input = new GZIPInputStream(entity.getContent()); - } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) { - 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.append(buff); // 添加每一行 - } - } finally { - input.close(); // 关闭输入流 - } - } - - /** - * 发送 POST 请求，并返回解析后的 JSONObject - * - * @param js 要发送的 JSON 对象 - * @return 请求响应的 JSONObject - * @throws NetworkFailureException 当网络请求或处理失败时抛出 - */ - private JSONObject postRequest(JSONObject js) throws NetworkFailureException { - if (!mLoggedin) { - Log.e(TAG, "please login first"); - throw new ActionFailureException("not logged in"); // 确保已登录 - } - - HttpPost httpPost = createHttpPost(); // 创建 POST 请求 - try { - LinkedList list = new LinkedList(); - list.add(new BasicNameValuePair("r", js.toString())); // 添加请求参数 - UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8"); // 设置请求实体 - httpPost.setEntity(entity); // 将实体添加到请求中 - - // 执行 POST 请求 - HttpResponse response = mHttpClient.execute(httpPost); - String jsString = getResponseContent(response.getEntity()); // 读取响应内容 - return new JSONObject(jsString); // 返回 JSON 对象回复 - - } 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"); // JSON 解析失败 - } catch (Exception e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new ActionFailureException("error occurs when posting request"); // 其他错误 - } - } - - /** - * 创建一个任务 - * - * @param task 要创建的任务对象 - * @throws NetworkFailureException 当网络操作失败时抛出 - */ - public void createTask(Task task) throws NetworkFailureException { - commitUpdate(); // 提交更新 - try { - JSONObject jsPost = new JSONObject(); // 创建 POST 请求的 JSON 对象 - JSONArray actionList = new JSONArray(); // 动作列表 - - // 构建动作列表 - actionList.put(task.getCreateAction(getActionId())); // 添加创建任务的动作 - jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); - - // 添加客户端版本信息 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); - - // 发送请求并处理响应 - JSONObject jsResponse = postRequest(jsPost); - JSONObject jsResult = (JSONObject) jsResponse.getJSONArray( - GTaskStringUtils.GTASK_JSON_RESULTS).get(0); - task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID)); // 设置新任务的 ID - - } catch (JSONException e) { - Log.e(TAG, e.toString()); - e.printStackTrace(); - throw new ActionFailureException("create task: handling jsonobject failed"); // JSON 处理失败 - } - } - - /** - * 创建任务列表。 - * - * @param tasklist 任务列表对象，包含创建任务所需的信息。 - * @throws NetworkFailureException 网络请求失败时抛出。 - */ -public void createTaskList(TaskList tasklist) throws NetworkFailureException { - commitUpdate(); // 提交更新，确保当前更新已处理 - - try { - JSONObject jsPost = new JSONObject(); // 创建POST请求的JSON对象 - JSONArray actionList = new JSONArray(); // 动作列表 - - // 添加创建任务的动作到动作列表 - actionList.put(tasklist.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); // 获取响应结果的第一个元素 - 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: handling JSON object failed"); // 处理JSON时失败 - } -} - -/** - * 提交待更新的任务信息。 - * - * 将存储在更新数组中的所有待处理变更发送到服务器。 - * - * @throws NetworkFailureException 网络请求失败时抛出。 - */ -public void commitUpdate() throws NetworkFailureException { - if (mUpdateArray != null) { // 检查更新数组是否为空 - try { - JSONObject jsPost = new JSONObject(); // 创建POST请求的JSON对象 - - // 添加更新的动作列表 - jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray); - - // 添加客户端版本信息 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); - - postRequest(jsPost); // 发送POST请求 - mUpdateArray = null; // 清空更新数组 - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new ActionFailureException("commit update: handling JSON object failed"); // 处理JSON时失败 - } - } -} - -/** - * 添加一个待更新的任务节点。 - * - * 将提供的任务节点信息添加到待更新的任务列表中。 - * - * @param node 待添加的节点信息。 - * @throws NetworkFailureException 网络请求失败时抛出。 - */ -public void addUpdateNode(Node node) throws NetworkFailureException { - if (node != null) { // 检查节点是否为空 - // 若更新节点过多，则提交当前更新 - if (mUpdateArray != null && mUpdateArray.length() > 10) { - commitUpdate(); // 提交当前更新，避免更新过多 - } - - if (mUpdateArray == null) - mUpdateArray = new JSONArray(); // 创建更新节点的数组 - mUpdateArray.put(node.getUpdateAction(getActionId())); // 添加节点更新动作 - } -} - -/** - * 移动任务到不同的任务列表或在同一任务列表内移动位置。 - * - * @param task 要移动的任务。 - * @param preParent 任务的原父任务列表。 - * @param curParent 任务的新父任务列表。 - * @throws NetworkFailureException 网络请求失败时抛出。 - */ -public void moveTask(Task task, TaskList preParent, TaskList curParent) throws NetworkFailureException { - commitUpdate(); // 提交当前更新 - - try { - JSONObject jsPost = new JSONObject(); // 创建POST请求的JSON对象 - JSONArray actionList = new JSONArray(); // 动作列表 - JSONObject action = new JSONObject(); // 单个动作 - - // 添加移动任务的动作 - action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_MOVE); // 设置移动类型 - action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId()); // 设置动作ID - action.put(GTaskStringUtils.GTASK_JSON_ID, task.getGid()); // 设置要移动任务的ID - - 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对象 - - // 添加客户端版本信息 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); - - postRequest(jsPost); // 发送POST请求 - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new ActionFailureException("move task: handling JSON object failed"); // 处理JSON时失败 - } -} - -/** - * 删除指定的任务节点。 - * - * @param node 要删除的节点。 - * @throws NetworkFailureException 网络请求失败时抛出。 - */ -public void deleteNode(Node node) throws NetworkFailureException { - commitUpdate(); // 提交当前更新 - - try { - JSONObject jsPost = new JSONObject(); // 创建POST请求的JSON对象 - JSONArray actionList = new JSONArray(); // 动作列表 - - // 添加删除节点的动作 - node.setDeleted(true); // 设置节点为删除状态 - actionList.put(node.getUpdateAction(getActionId())); // 获取更新动作并添加 - jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 添加动作列表 - - // 添加客户端版本信息 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); - - postRequest(jsPost); // 发送POST请求 - mUpdateArray = null; // 清空更新数组 - - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new ActionFailureException("delete node: handling JSON object failed"); // 处理JSON时失败 - } -} - -/** - * 获取任务列表的网络请求。 - * 注意：调用此方法前需要确保用户已经登录。 - * - * @return JSONArray 返回一个包含任务列表的JSON数组。 - * @throws NetworkFailureException 如果网络请求失败则抛出此异常。 - */ -public JSONArray getTaskLists() throws NetworkFailureException { - if (!mLoggedin) { - Log.e(TAG, "please login first"); // 登录前的检查 - throw new ActionFailureException("not logged in"); // 确保已登录 - } - - try { - HttpGet httpGet = new HttpGet(mGetUrl); // 创建GET请求 - HttpResponse response = mHttpClient.execute(httpGet); // 执行请求 - - // 从响应中提取任务列表 - String resString = getResponseContent(response.getEntity()); // 获取响应内容 - String jsBegin = "_setup("; - String jsEnd = ")}"; - int begin = resString.indexOf(jsBegin); - int end = resString.lastIndexOf(jsEnd); - String jsString = null; - if (begin != -1 && end != -1 && begin < end) { - jsString = resString.substring(begin + jsBegin.length(), end); // 提取JSON字符串 - } - JSONObject js = new JSONObject(jsString); - return js.getJSONObject("t").getJSONArray(GTaskStringUtils.GTASK_JSON_LISTS); // 返回任务列表的JSON数组 - } catch (ClientProtocolException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new NetworkFailureException("gettasklists: httpget failed"); // 网络请求失败 - } catch (IOException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new NetworkFailureException("gettasklists: httpget failed"); // 网络请求失败 - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new ActionFailureException("get task lists: handling JSON object failed"); // JSON处理失败 - } -} - -/** - * 根据列表ID获取特定任务列表的网络请求。 - * - * @param listGid 列表的全局唯一标识符。 - * @return JSONArray 返回一个包含特定任务列表的JSON数组。 - * @throws NetworkFailureException 如果网络请求失败则抛出此异常。 - */ -public JSONArray getTaskList(String listGid) throws NetworkFailureException { - commitUpdate(); // 提交当前更新 - try { - JSONObject jsPost = new JSONObject(); // 创建POST请求的JSON对象 - JSONArray actionList = new JSONArray(); // 动作列表 - JSONObject action = new JSONObject(); // 单个动作 - - // 构建请求参数 - action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE, - GTaskStringUtils.GTASK_JSON_ACTION_TYPE_GETALL); // 设置获取所有动作类型 - action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId()); // 设置动作ID - action.put(GTaskStringUtils.GTASK_JSON_LIST_ID, listGid); // 设置列表ID - action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false); // 不获取已删除任务 - actionList.put(action); // 将动作添加到列表 - jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList); // 添加动作列表到JSON对象 - - // 发送请求并处理响应 - jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion); // 添加客户端版本信息 - JSONObject jsResponse = postRequest(jsPost); // 发送POST请求 - return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS); // 返回任务的JSON数组 - } catch (JSONException e) { - Log.e(TAG, e.toString()); // 记录异常 - e.printStackTrace(); - throw new ActionFailureException("get task list: handling JSON object failed"); // JSON处理失败 - } -} - -/** - * 获取同步账户信息。 - * - * @return Account 返回当前的同步账户。 - */ -public Account getSyncAccount() { - return mAccount; // 返回同步账户信息 -} - -/** - * 重置更新数组。 - * 用于在进行新的同步之前清空或重置更新的数据数组。 - */ -public void resetUpdateArray() { - mUpdateArray = null; // 清空更新数组 -} - - diff --git a/src/gtask/remote/GTaskManager.java b/src/gtask/remote/GTaskManager.java deleted file mode 100644 index 82b7992..0000000 --- a/src/gtask/remote/GTaskManager.java +++ /dev/null @@ -1,948 +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; - -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; - - -public class GTaskManager { - // 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; - - // GTaskManager的单例实例。 - private static GTaskManager mInstance = null; - - // 关联的Activity对象。 - private Activity mActivity; - - // 上下文对象。 - private Context mContext; - - // 内容解析器。 - private ContentResolver mContentResolver; - - // 标记是否正在同步。 - private boolean mSyncing; - - // 标记是否已取消同步。 - private boolean mCancelled; - - // 保存任务列表的HashMap，键为列表ID，值为任务列表对象。 - private HashMap mGTaskListHashMap; - - // 保存任务的HashMap，键为任务ID，值为任务对象。 - private HashMap mGTaskHashMap; - - // 保存元数据的HashMap，键为元数据ID，值为元数据对象。 - private HashMap mMetaHashMap; - - // 元数据列表。 - private TaskList mMetaList; - - // 本地删除任务ID的集合。 - private HashSet mLocalDeleteIdMap; - - // 保存任务全局ID到本地ID的映射的HashMap。 - private HashMap mGidToNid; - - // 保存本地ID到任务全局ID的映射的HashMap。 - private HashMap mNidToGid; - - // GTaskManager的私有构造函数，初始化各种状态和映射。 - private GTaskManager() { - mSyncing = false; - mCancelled = false; - mGTaskListHashMap = new HashMap(); - mGTaskHashMap = new HashMap(); - mMetaHashMap = new HashMap(); - mMetaList = null; - mLocalDeleteIdMap = new HashSet(); - mGidToNid = new HashMap(); - mNidToGid = new HashMap(); - } - - - /** - * 获取 GTaskManager 的单例对象。 - * 采用单例模式确保全局仅有一个 GTaskManager 实例。 - * - * @return GTaskManager 的单例对象。 - */ - public static synchronized GTaskManager getInstance() { - if (mInstance == null) { - mInstance = new GTaskManager(); - } - return mInstance; - } - - /** - * 设置活动上下文。 - * 用于获取授权令牌。 - * - * @param activity 当前活动对象。 - */ - public synchronized void setActivityContext(Activity activity) { - mActivity = activity; - } - - /** - * 同步任务数据。 - * 会尝试与Google任务进行登录和数据同步，如果过程中发生错误或取消，则返回对应的状态码。 - * - * @param context 上下文对象，用于执行同步操作。 - * @param asyncTask 异步任务对象，用于在同步过程中更新进度。 - * @return 同步操作的状态码，可以是正在同步、网络错误、内部错误或同步取消。 - */ - 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 client = GTaskClient.getInstance(); - client.resetUpdateArray(); - - // 尝试登录 Google 任务服务 - 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; - } - - /** - * 初始化 GTask 列表。 - * 该方法首先检查操作是否已被取消，然后从 GTaskClient 获取任务列表信息，并初始化元数据列表和任务列表。 - * 如果过程中发生网络错误，可能会抛出 NetworkFailureException 异常。 - * - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常。 - */ - private void initGTaskList() throws NetworkFailureException { - if (mCancelled) // 检查是否取消了操作 - return; - - GTaskClient client = GTaskClient.getInstance(); // 获取 GTask 客户端实例 - - try { - JSONArray jsTaskLists = client.getTaskLists(); // 从客户端获取任务列表数组 - - // 初始化元数据列表 - mMetaList = null; - for (int i = 0; i < jsTaskLists.length(); i++) { - JSONObject object = jsTaskLists.getJSONObject(i); - String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID); - String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME); - - // 寻找并初始化元数据列表 - if (name - .equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) { - mMetaList = new TaskList(); - 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(); - metaData.setContentByRemoteJSON(object); - if (metaData.isWorthSaving()) { - mMetaList.addChildTask(metaData); - 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(); - 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(); - 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: handling JSONObject failed"); - } - } - - - /** - * 同步内容数据。 - * 该方法首先处理本地已删除的笔记，然后同步文件夹信息，接着处理数据库中存在的笔记， - * 最后处理剩余的项目，并更新本地同步ID。如果在过程中检测到网络失败，则抛出网络失败异常。 - * - * @throws NetworkFailureException 如果在网络通信过程中发生失败 - */ - private void syncContent() throws NetworkFailureException { - int syncType; - Cursor c = null; - String gid; - Node node; - - 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()) { - gid = c.getString(SqlNote.GTASK_ID_COLUMN); - node = mGTaskHashMap.get(gid); - if (node != null) { - mGTaskHashMap.remove(gid); // 从映射表中移除 - doContentSync(Node.SYNC_ACTION_DEL_REMOTE, node, c); // 执行内容同步 - } - - mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN)); // 添加到本地删除映射表 - } - } else { - Log.w(TAG, "failed to query trash folder"); - } - } finally { - 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()) { - 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)); // 更新ID映射 - mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid); - syncType = node.getSyncAction(c); // 获取同步动作 - } else { - if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) { - // 如果没有GTask ID，则视为本地新增 - syncType = Node.SYNC_ACTION_ADD_REMOTE; - } else { - // 如果有GTask ID但本地不存在，则视为远程删除 - syncType = Node.SYNC_ACTION_DEL_LOCAL; - } - } - doContentSync(syncType, node, c); // 执行内容同步 - } - } else { - Log.w(TAG, "failed to query existing note in database"); - } - - } finally { - if (c != null) { - c.close(); // 关闭游标 - c = null; - } - } - - // 处理剩余项目 - Iterator> iter = mGTaskHashMap.entrySet().iterator(); - while (iter.hasNext()) { - Map.Entry entry = iter.next(); - node = entry.getValue(); - doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null); // 将剩余项目作为本地新增处理 - } - - // 检查是否取消操作，清理本地删除表，并更新本地同步ID - if (!mCancelled) { - // 批量删除本地已删除的笔记，如果失败则抛出异常 - if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) { - throw new ActionFailureException("failed to batch-delete local deleted notes"); - } - } - - // 刷新本地同步ID - if (!mCancelled) { - GTaskClient.getInstance().commitUpdate(); // 提交更新 - refreshLocalSyncId(); // 刷新本地同步ID - } - - } - - /** - * 同步文件夹数据。 - * 该方法负责同步根文件夹、通话记录文件夹以及本地和远程存在的文件夹。 - * 它会根据文件夹的当前状态（是否存在、是否已同步）采取相应的同步操作，如添加、更新或删除。 - * - * @throws NetworkFailureException 如果网络操作失败 - */ - private void syncFolder() throws NetworkFailureException { - Cursor c = null; - String gid; - 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); - 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, "(_id=?)", - new String[]{ - String.valueOf(Notes.ID_CALL_RECORD_FOLDER) - }, null); - if (c != null) { - if (c.moveToNext()) { - gid = c.getString(SqlNote.GTASK_ID_COLUMN); - node = mGTaskHashMap.get(gid); - // 判断节点是否为空，不为空则更新，为空则添加 - if (node != null) { - mGTaskHashMap.remove(gid); - mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER); - mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid); - // 仅当系统文件夹的名称需要更新时执行内容同步 - if (!node.getName().equals( - GTaskStringUtils.MIUI_FOLDER_PREFFIX - + GTaskStringUtils.FOLDER_CALL_NOTE)) - doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c); - } else { - doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c); - } - } - } else { - Log.w(TAG, "failed to query call note folder"); - } - } finally { - if (c != null) { - c.close(); - c = null; - } - } - - // 同步本地已存在的文件夹 - 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 { - 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> iter = mGTaskListHashMap.entrySet().iterator(); - while (iter.hasNext()) { - Map.Entry entry = iter.next(); - gid = entry.getKey(); - node = entry.getValue(); - if (mGTaskHashMap.containsKey(gid)) { - mGTaskHashMap.remove(gid); - doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null); - } - } - - if (!mCancelled) - GTaskClient.getInstance().commitUpdate(); - } - - /** - * 根据指定的同步类型，对节点内容进行同步操作。 - * - * @param syncType 同步操作的类型，决定是添加、删除、还是更新节点。 - * @param node 要进行同步操作的节点。 - * @param c 游标，用于在本地数据库操作时获取额外信息（在删除操作中使用）。 - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常。 - */ - private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException { - if (mCancelled) { // 检查是否已取消同步操作 - return; - } - - MetaData meta; - switch (syncType) { - case Node.SYNC_ACTION_ADD_LOCAL: // 添加本地节点 - addLocalNode(node); - break; - case Node.SYNC_ACTION_ADD_REMOTE: // 添加远程节点 - addRemoteNode(node, c); - break; - case Node.SYNC_ACTION_DEL_LOCAL: // 删除本地节点 - meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN)); - 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()); - if (meta != null) { - GTaskClient.getInstance().deleteNode(meta); // 从服务器删除节点 - } - GTaskClient.getInstance().deleteNode(node); // 直接从本地数据库删除节点 - break; - case Node.SYNC_ACTION_UPDATE_LOCAL: // 更新本地节点 - updateLocalNode(node, c); - break; - case Node.SYNC_ACTION_UPDATE_REMOTE: // 更新远程节点 - updateRemoteNode(node, c); - break; - case Node.SYNC_ACTION_UPDATE_CONFLICT: // 处理更新冲突 - // 目前简单地采用本地更新，未来可能需要合并双方修改 - updateRemoteNode(node, c); - break; - case Node.SYNC_ACTION_NONE: // 无操作 - break; - case Node.SYNC_ACTION_ERROR: // 默认错误处理 - default: - throw new ActionFailureException("unkown sync action type"); // 抛出未知同步操作类型的异常 - } - } - - - /** - * 将本地节点添加到数据库中。 - * 该方法首先检查操作是否已被取消，然后根据节点类型（任务列表或任务）创建相应的 SqlNote 对象。 - * 对于任务列表节点，会根据节点名称（默认文件夹或通话记录文件夹）设置特殊的 SqlNote 属性； - * 对于任务节点，会从节点内容中创建 JSON 对象，并根据需要调整其中的 ID 字段（如果这些 ID 在数据库中已存在）。 - * 最后，该方法会将 SqlNote 对象提交到数据库，并更新相关的 ID 映射关系。 - * - * @param node 要添加的本地节点，不应为 null。 - * @throws NetworkFailureException 如果添加节点过程中检测到网络失败。 - */ - private void addLocalNode(Node node) throws NetworkFailureException { - if (mCancelled) { - return; // 如果操作已取消，则直接返回，不执行添加操作 - } - - SqlNote sqlNote; - if (node instanceof TaskList) { - // 处理任务列表节点，根据节点名称设置特殊的 SqlNote 属性 - 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); - } - } else { - // 处理任务节点，从节点内容创建 JSON 对象，并根据需要调整 ID 字段 - sqlNote = new SqlNote(mContext); - JSONObject js = node.getLocalJSONFromContent(); - try { - // 检查并处理 JSON 对象中的 Note 和 Data ID 字段 - if (js.has(GTaskStringUtils.META_HEAD_NOTE)) { - JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE); - if (note.has(NoteColumns.ID)) { - long id = note.getLong(NoteColumns.ID); - if (DataUtils.existInNoteDatabase(mContentResolver, id)) { - // 如果笔记 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); - - // 设置节点的父 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 到数据库，并更新 ID 映射关系 - sqlNote.setGtaskId(node.getGid()); - sqlNote.commit(false); - - mGidToNid.put(node.getGid(), sqlNote.getId()); - mNidToGid.put(sqlNote.getId(), node.getGid()); - - // 更新远程元数据 - updateRemoteMeta(node.getGid(), sqlNote); - } - - - /** - * 更新本地节点信息 - * - * @param node 需要更新的节点 - * @param c 数据库游标，用于操作数据库 - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常 - */ - private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException { - if (mCancelled) { - return; - } - - SqlNote sqlNote; - // 根据节点内容更新本地数据库中的笔记 - sqlNote = new SqlNote(mContext, c); - sqlNote.setContent(node.getLocalJSONFromContent()); - - // 确定父节点ID，任务则查找父任务ID，否则默认为根文件夹ID - Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid()) - : new Long(Notes.ID_ROOT_FOLDER); - if (parentId == null) { - Log.e(TAG, "cannot find task's parent id locally"); - throw new ActionFailureException("cannot update local node"); - } - sqlNote.setParentId(parentId.longValue()); - sqlNote.commit(true); - - // 更新远程元数据 - updateRemoteMeta(node.getGid(), sqlNote); - } - - /** - * 在远程添加节点信息 - * - * @param node 需要添加的节点 - * @param c 数据库游标，用于操作数据库 - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常 - */ - 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(); - task.setContentByLocalJSON(sqlNote.getContent()); - - // 查找任务所属的任务列表ID - String parentGid = mNidToGid.get(sqlNote.getParentId()); - if (parentGid == null) { - Log.e(TAG, "cannot find task's parent tasklist"); - throw new ActionFailureException("cannot add remote task"); - } - mGTaskListHashMap.get(parentGid).addChildTask(task); - - GTaskClient.getInstance().createTask(task); - n = (Node) task; - - // 更新远程元数据 - updateRemoteMeta(task.getGid(), sqlNote); - } else { - TaskList tasklist = null; - - // 判断是否需要创建新的任务列表 - String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX; - if (sqlNote.getId() == Notes.ID_ROOT_FOLDER) - folderName += GTaskStringUtils.FOLDER_DEFAULT; - else if (sqlNote.getId() == Notes.ID_CALL_RECORD_FOLDER) - folderName += GTaskStringUtils.FOLDER_CALL_NOTE; - else - folderName += sqlNote.getSnippet(); - - // 在已有的任务列表中查找匹配的条目 - Iterator> iter = mGTaskListHashMap.entrySet().iterator(); - while (iter.hasNext()) { - Map.Entry entry = iter.next(); - String gid = entry.getKey(); - TaskList list = entry.getValue(); - - if (list.getName().equals(folderName)) { - tasklist = list; - if (mGTaskHashMap.containsKey(gid)) { - mGTaskHashMap.remove(gid); - } - break; - } - } - - // 如果没有找到匹配的任务列表，则创建新的任务列表 - if (tasklist == null) { - tasklist = new TaskList(); - tasklist.setContentByLocalJSON(sqlNote.getContent()); - GTaskClient.getInstance().createTaskList(tasklist); - mGTaskListHashMap.put(tasklist.getGid(), tasklist); - } - n = (Node) tasklist; - } - - // 更新本地数据库中的笔记信息 - sqlNote.setGtaskId(n.getGid()); - sqlNote.commit(false); - sqlNote.resetLocalModified(); - sqlNote.commit(true); - - // 更新GID和ID的映射关系 - mGidToNid.put(n.getGid(), sqlNote.getId()); - mNidToGid.put(sqlNote.getId(), n.getGid()); - } - - - /** - * 更新远程节点信息。 - * - * @param node 需要更新的节点 - * @param c 数据库游标，用于获取节点的详细信息 - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常 - */ - private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException { - if (mCancelled) { // 检查是否已取消操作 - return; - } - - SqlNote sqlNote = new SqlNote(mContext, c); // 从数据库游标中创建 SqlNote 对象 - - // 使用本地 JSON 格式更新远程节点内容 - node.setContentByLocalJSON(sqlNote.getContent()); - GTaskClient.getInstance().addUpdateNode(node); // 将节点添加到更新队列 - - // 更新元数据 - updateRemoteMeta(node.getGid(), sqlNote); - - // 如果是笔记类型，检查并移动任务 - if (sqlNote.isNoteType()) { - Task task = (Task) node; - TaskList preParentList = task.getParent(); // 获取任务的当前父任务列表 - - String curParentGid = mNidToGid.get(sqlNote.getParentId()); // 获取当前父任务列表的 GID - 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); - } - - /** - * 更新远程元数据。 - * - * @param gid 元数据的全局标识符 - * @param sqlNote 包含元数据内容的 SqlNote 对象 - * @throws NetworkFailureException 如果网络操作失败，则抛出此异常 - */ - 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。 - * 该方法首先获取最新的gtask列表，然后通过查询本地笔记内容来更新这些笔记的同步ID。 - * 如果在查询过程中发现有本地项目在同步后没有对应的gtask ID，则抛出ActionFailureException异常。 - * - * @throws NetworkFailureException 如果网络操作失败。 - * @throws ActionFailureException 如果在同步后发现有本地项目没有对应的gtask ID。 - */ - private void refreshLocalSyncId() throws NetworkFailureException { - if (mCancelled) { - return; - } - - // 清空现有的gtask列表和元数据，准备获取最新的数据 - mGTaskHashMap.clear(); - mGTaskListHashMap.clear(); - mMetaHashMap.clear(); - initGTaskList(); - - Cursor c = null; - try { - // 查询本地笔记内容，准备更新同步ID - 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) { - 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 { - // 如果查询到的笔记没有对应的gtask ID，则抛出异常 - Log.e(TAG, "something is missed"); - throw new ActionFailureException( - "some local items don't have gid after sync"); - } - } - } else { - // 如果查询操作失败，记录警告信息 - Log.w(TAG, "failed to query local note to refresh sync id"); - } - } finally { - // 释放Cursor资源 - if (c != null) { - c.close(); - c = null; - } - } - } - - /** - * 获取同步账户的名称。 - * - * @return 同步账户的名称。 - */ - public String getSyncAccount() { - return GTaskClient.getInstance().getSyncAccount().name; - } - - /** - * 取消同步操作。 - * 设置取消标志，终止正在进行的同步操作。 - */ - public void cancelSync() { - mCancelled = true; - } - -} diff --git a/src/gtask/remote/GTaskSyncService.java b/src/gtask/remote/GTaskSyncService.java deleted file mode 100644 index 388b08e..0000000 --- a/src/gtask/remote/GTaskSyncService.java +++ /dev/null @@ -1,169 +0,0 @@ -/* - * GTaskSyncService类用于处理与Google任务同步相关的服务操作。 - */ -package net.micode.notes.gtask.remote; - -import android.app.Activity; -import android.app.Service; -import android.content.Context; -import android.content.Intent; -import android.os.Bundle; -import android.os.IBinder; - -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; // 清理同步任务引用 - sendBroadcast(""); // 发送空消息，表示同步完成 - stopSelf(); // 停止服务 - } - }); - sendBroadcast(""); // 发送初始同步状态 - mSyncTask.execute(); // 执行同步任务 - } - } - - /* - * 取消当前的同步任务。 - */ - private void cancelSync() { - // 如果有正在执行的同步任务，调用取消方法 - if (mSyncTask != null) { - mSyncTask.cancelSync(); - } - } - - /* - * 服务创建时的初始化操作。 - * 重置同步任务为null，准备服务的生命周期。 - */ - @Override - public void onCreate() { - mSyncTask = null; // 确保没有正在执行的任务 - } - - /* - * 处理服务启动时的命令。 - * 根据传入的意图参数决定是启动同步还是取消同步。 - */ - @Override - public int onStartCommand(Intent intent, int flags, int startId) { - Bundle bundle = intent.getExtras(); // 获取传入的附加数据 - 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; // 服务将在系统资源不足时重启 - } - return super.onStartCommand(intent, flags, startId); // 默认处理 - } - - /* - * 低内存时调用，取消同步任务。 - */ - @Override - public void onLowMemory() { - // 如果有正在执行的同步任务，则取消 - if (mSyncTask != null) { - mSyncTask.cancelSync(); - } - } - - // 服务绑定时返回null，此服务不提供绑定功能 - public IBinder onBind(Intent intent) { - return null; // 不支持绑定，返回null - } - - /* - * 发送同步状态的广播。 - * 更新同步进度，并通过广播发送当前的同步状态和进度消息。 - */ - public void sendBroadcast(String msg) { - mSyncProgress = msg; // 更新进度消息 - Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME); // 创建广播意图 - 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); // 记录活动上下文 - Intent intent = new Intent(activity, GTaskSyncService.class); // 创建意图 - 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.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC); // 添加入参 - context.startService(intent); // 启动服务以取消同步 - } - - /* - * 检查是否正在同步。 - * 返回当前是否有一个同步任务在执行。 - */ - public static boolean isSyncing() { - return mSyncTask != null; // 返回同步任务是否在进行 - } - - /* - * 获取同步进度的字符串。 - * 返回当前同步任务的进度消息。 - */ - public static String getProgressString() { - return mSyncProgress; // 返回进度消息 - } -} diff --git a/src/ui/NoteItemData.java b/src/model/NoteItemData.java similarity index 100% rename from src/ui/NoteItemData.java rename to src/model/NoteItemData.java diff --git a/src/ui/NoteWidgetProvider.java b/src/model/NoteWidgetProvider.java similarity index 100% rename from src/ui/NoteWidgetProvider.java rename to src/model/NoteWidgetProvider.java diff --git a/src/ui/Notes.java b/src/model/Notes.java similarity index 100% rename from src/ui/Notes.java rename to src/model/Notes.java diff --git a/src/ui/NotesDatabaseHelper.java b/src/model/NotesDatabaseHelper.java similarity index 100% rename from src/ui/NotesDatabaseHelper.java rename to src/model/NotesDatabaseHelper.java diff --git a/src/ui/NotesListActivity.java b/src/model/NotesListActivity.java similarity index 100% rename from src/ui/NotesListActivity.java rename to src/model/NotesListActivity.java diff --git a/src/ui/NotesListAdapter.java b/src/model/NotesListAdapter.java similarity index 100% rename from src/ui/NotesListAdapter.java rename to src/model/NotesListAdapter.java diff --git a/src/ui/NotesListItem.java b/src/model/NotesListItem.java similarity index 100% rename from src/ui/NotesListItem.java rename to src/model/NotesListItem.java diff --git a/src/ui/NotesPreferenceActivity.java b/src/model/NotesPreferenceActivity.java similarity index 100% rename from src/ui/NotesPreferenceActivity.java rename to src/model/NotesPreferenceActivity.java diff --git a/src/tool/BackupUtils.java b/src/tool/BackupUtils.java deleted file mode 100644 index 5c21f2e..0000000 --- a/src/tool/BackupUtils.java +++ /dev/null @@ -1,279 +0,0 @@ - -/* - * BackupUtils 工具类 - * 提供了笔记备份到文本文件的功能。 - */ - -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; -import net.micode.notes.data.Notes.DataColumns; -import net.micode.notes.data.Notes.DataConstants; -import net.micode.notes.data.Notes.NoteColumns; - -import java.io.File; -import java.io.FileNotFoundException; -import java.io.FileOutputStream; -import java.io.IOException; -import java.io.PrintStream; - -/** - * BackupUtils 是一个工具类，用于实现笔记的备份功能。 - */ -public class BackupUtils { - - // 日志标志，用于记录类中的日志 - private static final String TAG = "BackupUtils"; - - // 单例模式：存储唯一实例 - private static BackupUtils sInstance; - - /** - * 获取 BackupUtils 类的单例实例。 - * - * @param context 上下文对象，用于初始化内部组件。 - * @return 返回 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; // 备份成功 - - // 用于文本导出的工具类 - private TextExport mTextExport; - - /** - * 私有化构造函数，防止直接实例化。 - * - * @param context 上下文对象，用于初始化导出工具类。 - */ - private BackupUtils(Context context) { - mTextExport = new TextExport(context); // 初始化文本导出工具 - } - - /** - * 检查 SD 卡是否可用。 - * - * @return 如果 SD 卡已挂载，则返回 true，否则返回 false。 - */ - private static boolean externalStorageAvailable() { - return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState()); - } - - /** - * 导出笔记到文本文件。 - * - * @return 返回导出操作的状态码。 - */ - public int exportToText() { - return mTextExport.exportToText(); // 调用 TextExport 类中的导出方法 - } - - /** - * 获取导出文本的文件名。 - * - * @return 返回文件名字符串。 - */ - public String getExportedTextFileName() { - return mTextExport.mFileName; // 返回文件名 - } - - /** - * 获取导出文件的目录。 - * - * @return 返回目录路径字符串。 - */ - public String getExportedTextFileDir() { - return mTextExport.mFileDirectory; // 返回文件目录路径 - } - - /** - * 内部类，用于执行文本导出功能。 - */ - private static class TextExport { - - // 定义查询笔记的列名 - private static final String[] NOTE_PROJECTION = { - NoteColumns.ID, // 笔记 ID - NoteColumns.MODIFIED_DATE, // 修改时间 - NoteColumns.SNIPPET, // 摘要 - NoteColumns.TYPE // 类型 - }; - - // 定义笔记列的索引 - private static final int NOTE_COLUMN_ID = 0; // ID 列索引 - 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, // MIME 类型 - DataColumns.DATA1, // 数据 1 - DataColumns.DATA2, // 数据 2 - DataColumns.DATA3, // 数据 3 - DataColumns.DATA4, // 数据 4 - }; - - // 定义数据列的索引 - private static final int DATA_COLUMN_CONTENT = 0; // 内容列索引 - private static final int DATA_COLUMN_MIME_TYPE = 1; // MIME 类型列索引 - - // 上下文对象，用于访问系统资源 - private Context mContext; - private String mFileName; // 文件名 - private String mFileDirectory; // 文件目录 - - // 初始化文本导出格式 - private final String[] TEXT_FORMAT; - - public TextExport(Context context) { - TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note); // 导出格式 - mContext = context; - mFileName = ""; - mFileDirectory = ""; - } - - /** - * 根据文件夹 ID 将笔记导出为文本。 - * - * @param folderId 文件夹 ID。 - * @param ps 打印流，用于写入文本内容。 - */ - 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(); - } - } - - /** - * 导出指定笔记 ID 的内容到文本。 - * - * @param noteId 笔记 ID。 - * @param ps 打印流。 - */ - private void exportNoteToText(String noteId, PrintStream ps) { - 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 { - String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE); - if (DataConstants.CALL_NOTE.equals(mimeType)) { - // 导出通话笔记 - } else if (DataConstants.NOTE.equals(mimeType)) { - // 导出普通笔记 - } - } while (dataCursor.moveToNext()); - } - dataCursor.close(); - } - } - - /** - * 获取指向文件的打印流，用于导出笔记内容。 - * - * @return 返回指向生成的文本文件的打印流对象，如果失败则返回 null。 - */ - private PrintStream getExportToTextPrintStream() { - // 调用辅助方法，生成导出文件 - File file = generateFileMountedOnSDcard(mContext, R.string.file_path, R.string.file_name_txt_format); - if (file == null) { // 如果文件生成失败 - Log.e(TAG, "create file to exported failed"); // 输出错误日志 - return null; // 返回 null，表示打印流创建失败 - } - // 更新文件名和目录信息 - mFileName = file.getName(); // 设置文件名 - mFileDirectory = mContext.getString(R.string.file_path); // 设置文件目录 - - PrintStream ps = null; // 初始化打印流为 null - try { - // 创建文件输出流并包装为打印流 - FileOutputStream fos = new FileOutputStream(file); - ps = new PrintStream(fos); - } catch (FileNotFoundException e) { // 捕获文件未找到异常 - e.printStackTrace(); - return null; // 返回 null，表示打印流创建失败 - } catch (NullPointerException e) { // 捕获空指针异常 - e.printStackTrace(); - return null; // 返回 null - } - return ps; // 返回成功创建的打印流对象 - } - - /** - * 在 SD 卡上生成用于存储导出数据的文件。 - * - * @param context 上下文对象，用于访问应用资源。 - * @param filePathResId 文件路径的资源 ID。 - * @param fileNameFormatResId 文件名格式的资源 ID，用于生成包含日期的文件名。 - * @return 返回生成的文件对象，如果失败则返回 null。 - */ - private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) { - StringBuilder sb = new StringBuilder(); // 使用 StringBuilder 拼接路径和文件名 - - // 获取 SD 卡的根目录并拼接路径 - sb.append(Environment.getExternalStorageDirectory()); - sb.append(context.getString(filePathResId)); // 从资源中获取路径字符串 - - // 创建文件目录对象 - File filedir = new File(sb.toString()); - // 生成文件名并拼接到路径中，文件名包含日期信息 - sb.append(context.getString(fileNameFormatResId, - DateFormat.format(context.getString(R.string.format_date_ymd), System.currentTimeMillis()))); - File file = new File(sb.toString()); // 创建文件对象 - - try { - if (!filedir.exists()) { // 如果目录不存在 - filedir.mkdir(); // 创建目录 - } - if (!file.exists()) { // 如果文件不存在 - file.createNewFile(); // 创建文件 - } - return file; // 返回成功生成的文件对象 - } catch (SecurityException e) { // 捕获安全异常 - e.printStackTrace(); - } catch (IOException e) { // 捕获 I/O 异常 - e.printStackTrace(); - } - return null; // 如果发生异常，返回 null - } - } -} - - diff --git a/src/tool/DataUtils.java b/src/tool/DataUtils.java deleted file mode 100644 index 977ad28..0000000 --- a/src/tool/DataUtils.java +++ /dev/null @@ -1,406 +0,0 @@ -/* - * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) - * Licensed under the Apache License, Version 2.0 - * 该文件定义了用于管理和操作笔记数据的实用工具类 DataUtils。 - */ - -package net.micode.notes.tool; // 声明该类所属的包路径 - -// 导入需要的类，用于操作内容提供器、数据库、日志和其他功能 -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; - -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; // 导入笔记小部件属性定义 - -import java.util.ArrayList; // 用于创建动态数组 -import java.util.HashSet; // 用于存储无重复的集合 - -// 定义 DataUtils 工具类 -public class DataUtils { - public static final String TAG = "DataUtils"; // 定义日志标记常量 - - /** - * 批量删除笔记 - * - * @param resolver 内容解析器 - * @param ids 要删除的笔记ID集合 - * @return 如果删除成功或集合为空或为null，则返回true，否则返回false - */ - public static boolean batchDeleteNotes(ContentResolver resolver, HashSet ids) { - if (ids == null) { // 如果传入的ID集合为null - Log.d(TAG, "the ids is null"); // 输出调试日志 - return true; // 返回true，表示没有需要删除的内容 - } - if (ids.size() == 0) { // 如果ID集合为空 - Log.d(TAG, "no id is in the hashset"); // 输出调试日志 - return true; // 返回true - } - - // 创建一个操作列表，用于批量删除操作 - ArrayList operationList = new ArrayList(); - for (long id : ids) { // 遍历需要删除的ID集合 - if (id == Notes.ID_ROOT_FOLDER) { // 如果ID是系统根文件夹 - Log.e(TAG, "Don't delete system folder root"); // 输出错误日志 - continue; // 跳过此ID - } - // 创建删除操作 - 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; // 删除成功，返回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(); // 创建一个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 如果移动成功或集合为空或为null，则返回true，否则返回false - */ - public static boolean batchMoveToFolder(ContentResolver resolver, HashSet ids, long folderId) { - if (ids == null) { // 如果ID集合为null - Log.d(TAG, "the ids is null"); // 输出调试日志 - return true; // 返回true - } - - // 构建更新操作的列表 - ArrayList operationList = new ArrayList(); - for (long id : ids) { // 遍历ID集合 - // 创建更新操作 - 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; // 操作失败 - } - 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; // 返回文件夹数量 - } -} - /** - * 检查指定类型的笔记在数据库中是否可见 - * - * @param resolver 内容解析器 - * @param noteId 笔记ID - * @param type 笔记类型 - * @return 如果可见，则返回true，否则返回false - */ - public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) { - // 查询数据库，检查指定类型的笔记是否存在且不在垃圾箱中 - Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), // 查询的URI - null, // 查询的列，null表示查询所有列 - NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER, // 条件 - new String[]{String.valueOf(type)}, // 条件值 - null); // 排序：无 - - boolean exist = false; // 初始化结果为false - if (cursor != null) { // 如果查询结果不为空 - if (cursor.getCount() > 0) { // 如果查询结果有记录 - exist = true; // 设置结果为true - } - cursor.close(); // 关闭游标 - } - return exist; // 返回结果 - } - - /** - * 检查指定的笔记ID在数据库中是否存在 - * - * @param resolver 内容解析器 - * @param noteId 笔记ID - * @return 如果存在，则返回true，否则返回false - */ - public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) { - // 查询数据库，检查笔记是否存在 - Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), // 查询的URI - null, // 查询所有列 - null, // 无条件 - null, // 无条件值 - null); // 无排序 - - boolean exist = false; // 初始化结果为false - if (cursor != null) { // 如果查询结果不为空 - if (cursor.getCount() > 0) { // 如果查询结果有记录 - exist = true; // 设置结果为true - } - cursor.close(); // 关闭游标 - } - return exist; // 返回结果 - } - - /** - * 检查指定的数据ID在数据库中是否存在 - * - * @param resolver 内容解析器 - * @param dataId 数据ID - * @return 如果存在，则返回true，否则返回false - */ - public static boolean existInDataDatabase(ContentResolver resolver, long dataId) { - // 查询数据库，检查数据是否存在 - Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), // 查询的URI - null, // 查询所有列 - null, // 无条件 - null, // 无条件值 - null); // 无排序 - - boolean exist = false; // 初始化结果为false - if (cursor != null) { // 如果查询结果不为空 - if (cursor.getCount() > 0) { // 如果查询结果有记录 - exist = true; // 设置结果为true - } - cursor.close(); // 关闭游标 - } - return exist; // 返回结果 - } - - /** - * 检查文件夹名称是否在数据库中已存在（不包括系统文件夹） - * - * @param resolver 内容解析器 - * @param name 文件夹名称 - * @return 如果已存在，则返回true，否则返回false - */ - public static boolean checkVisibleFolderName(ContentResolver resolver, String name) { - // 查询数据库，检查文件夹名称是否存在且不在垃圾箱中 - Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, // 查询的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; // 初始化结果为false - if (cursor != null) { // 如果查询结果不为空 - if (cursor.getCount() > 0) { // 如果查询结果有记录 - exist = true; // 设置结果为true - } - cursor.close(); // 关闭游标 - } - return exist; // 返回结果 - } - - /** - * 获取指定文件夹中的笔记小部件信息集合 - * - * @param resolver 内容解析器 - * @param folderId 文件夹ID - * @return 笔记小部件信息集合 - */ - public static HashSet getFolderNoteWidget(ContentResolver resolver, long folderId) { - // 查询数据库，获取文件夹中的小部件信息 - Cursor c = resolver.query(Notes.CONTENT_NOTE_URI, // 查询的URI - new String[]{NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE}, // 查询的列 - NoteColumns.PARENT_ID + "=?", // 条件：父ID为指定文件夹 - new String[]{String.valueOf(folderId)}, // 条件值 - null); // 无排序 - - HashSet set = null; // 初始化小部件集合为null - if (c != null) { // 如果查询结果不为空 - if (c.moveToFirst()) { // 移动到第一条记录 - set = new HashSet(); // 初始化小部件集合 - do { // 遍历查询结果 - try { - AppWidgetAttribute widget = new AppWidgetAttribute(); // 创建小部件属性对象 - widget.widgetId = c.getInt(0); // 获取小部件ID - widget.widgetType = c.getInt(1); // 获取小部件类型 - set.add(widget); // 将小部件添加到集合 - } catch (IndexOutOfBoundsException e) { // 捕获索引越界异常 - Log.e(TAG, e.toString()); // 输出错误日志 - } - } while (c.moveToNext()); // 移动到下一条记录 - } - c.close(); // 关闭游标 - } - return set; // 返回小部件集合 - } - - - /** - * 通过笔记ID获取关联的通话号码 - * - * @param resolver 内容解析器 - * @param noteId 笔记ID - * @return 通话号码，如果未找到则返回空字符串 - */ - public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) { - // 查询数据库，获取与笔记ID关联的通话号码 - Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, // 查询的URI - new String[]{CallNote.PHONE_NUMBER}, // 查询的列：电话号码 - CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?", // 条件：匹配笔记ID和MIME类型 - new String[]{String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE}, // 条件值 - null); // 无排序 - - if (cursor != null && cursor.moveToFirst()) { // 如果查询结果不为空且有记录 - try { - return cursor.getString(0); // 返回查询结果中的电话号码 - } catch (IndexOutOfBoundsException e) { // 捕获索引越界异常 - Log.e(TAG, "Get call number fails " + e.toString()); // 输出错误日志 - } finally { - cursor.close(); // 关闭游标 - } - } - return ""; // 未找到记录时返回空字符串 - } - - /** - * 根据电话号码和通话日期获取对应的笔记ID - * - * @param resolver 内容解析器 - * @param phoneNumber 电话号码 - * @param callDate 通话日期 - * @return 笔记ID，未找到则返回0 - */ - public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) { - // 查询数据库，根据电话号码和通话日期获取笔记ID - Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, // 查询的URI - new String[]{CallNote.NOTE_ID}, // 查询的列：笔记ID - CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL(" - + CallNote.PHONE_NUMBER + ",?)", // 条件：匹配通话日期、MIME类型和电话号码 - new String[]{String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber}, // 条件值 - null); // 无排序 - - if (cursor != null) { // 如果查询结果不为空 - if (cursor.moveToFirst()) { // 如果有记录 - try { - return cursor.getLong(0); // 返回笔记ID - } catch (IndexOutOfBoundsException e) { // 捕获索引越界异常 - Log.e(TAG, "Get call note id fails " + e.toString()); // 输出错误日志 - } - } - cursor.close(); // 关闭游标 - } - return 0; // 未找到记录时返回0 - } - - /** - * 根据笔记ID从数据库中获取笔记的摘要 - * - * @param resolver 内容解析器 - * @param noteId 笔记的ID - * @return 笔记的摘要字符串。如果找不到对应的笔记，将抛出IllegalArgumentException。 - */ - public static String getSnippetById(ContentResolver resolver, long noteId) { - // 查询数据库，获取指定ID笔记的摘要 - Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, // 查询的URI - new String[]{NoteColumns.SNIPPET}, // 查询的列：摘要 - NoteColumns.ID + "=?", // 条件：匹配笔记ID - new String[]{String.valueOf(noteId)}, // 条件值 - null); // 无排序 - - if (cursor != null) { // 如果查询结果不为空 - String snippet = ""; // 初始化摘要为空字符串 - if (cursor.moveToFirst()) { // 如果有记录 - snippet = cursor.getString(0); // 获取摘要字符串 - } - cursor.close(); // 关闭游标 - return snippet; // 返回摘要 - } - // 如果未找到记录，抛出异常 - throw new IllegalArgumentException("Note is not found with id: " + noteId); - } - - /** - * 格式化摘要字符串 - * 主要用于去除字符串两端的空白字符，以及截取至第一个换行符之前的内容。 - * - * @param snippet 需要格式化的摘要字符串 - * @return 格式化后的摘要字符串 - */ - public static String getFormattedSnippet(String snippet) { - // 如果摘要字符串不为空，进行格式化处理 - if (snippet != null) { - snippet = snippet.trim(); // 去除两端的空白字符 - int index = snippet.indexOf('\n'); // 查找第一个换行符的位置 - if (index != -1) { // 如果存在换行符 - snippet = snippet.substring(0, index); // 截取至第一个换行符之前的内容 - } - } - return snippet; // 返回格式化后的摘要字符串 - } -} - diff --git a/src/tool/GTaskStringUtils.java b/src/tool/GTaskStringUtils.java deleted file mode 100644 index aeaa30d..0000000 --- a/src/tool/GTaskStringUtils.java +++ /dev/null @@ -1,64 +0,0 @@ -/* - * GTaskStringUtils 类定义 - * 该类提供了一系列与 GTask 相关的字符串常量，用于在操作 GTask 数据时标识各种 JSON 属性。 - */ -package net.micode.notes.tool; // 定义该类所在的包路径 - - -// 定义 GTaskStringUtils 类 -public class GTaskStringUtils { - - // GTask JSON 对象中各种属性的键名 - public final static String GTASK_JSON_ACTION_ID = "action_id"; // 动作 ID - public final static String GTASK_JSON_ACTION_LIST = "action_list"; // 动作列表 - public final static String GTASK_JSON_ACTION_TYPE = "action_type"; // 动作类型 - public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create"; // 创建动作类型 - public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all"; // 获取所有动作类型 - public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move"; // 移动动作类型 - public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update"; // 更新动作类型 - public final static String GTASK_JSON_CREATOR_ID = "creator_id"; // 创建者 ID - public final static String GTASK_JSON_CHILD_ENTITY = "child_entity"; // 子实体 - public final static String GTASK_JSON_CLIENT_VERSION = "client_version"; // 客户端版本 - public final static String GTASK_JSON_COMPLETED = "completed"; // 完成状态 - public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id"; // 当前列表 ID - public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id"; // 默认列表 ID - public final static String GTASK_JSON_DELETED = "deleted"; // 删除状态 - public final static String GTASK_JSON_DEST_LIST = "dest_list"; // 目标列表 - public final static String GTASK_JSON_DEST_PARENT = "dest_parent"; // 目标父实体 - public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type"; // 目标父实体类型 - public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta"; // 实体增量 - public final static String GTASK_JSON_ENTITY_TYPE = "entity_type"; // 实体类型 - public final static String GTASK_JSON_GET_DELETED = "get_deleted"; // 获取已删除项 - public final static String GTASK_JSON_ID = "id"; // ID - public final static String GTASK_JSON_INDEX = "index"; // 索引 - public final static String GTASK_JSON_LAST_MODIFIED = "last_modified"; // 最后修改时间 - public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point"; // 最新同步点 - public final static String GTASK_JSON_LIST_ID = "list_id"; // 列表 ID - public final static String GTASK_JSON_LISTS = "lists"; // 列表集合 - public final static String GTASK_JSON_NAME = "name"; // 名称 - public final static String GTASK_JSON_NEW_ID = "new_id"; // 新 ID - public final static String GTASK_JSON_NOTES = "notes"; // 备注 - public final static String GTASK_JSON_PARENT_ID = "parent_id"; // 父 ID - public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id"; // 前一个兄弟 ID - public final static String GTASK_JSON_RESULTS = "results"; // 结果 - public final static String GTASK_JSON_SOURCE_LIST = "source_list"; // 源列表 - public final static String GTASK_JSON_TASKS = "tasks"; // 任务集合 - public final static String GTASK_JSON_TYPE = "type"; // 类型 - public final static String GTASK_JSON_TYPE_GROUP = "GROUP"; // 类型：组 - public final static String GTASK_JSON_TYPE_TASK = "TASK"; // 类型：任务 - public final static String GTASK_JSON_USER = "user"; // 用户 - - // MIUI 笔记相关的文件夹前缀和元数据键名 - public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]"; // MIUI 笔记文件夹前缀 - public final static String FOLDER_DEFAULT = "Default"; // 默认文件夹名 - public final static String FOLDER_CALL_NOTE = "Call_Note"; // 通话笔记文件夹名 - public final static String FOLDER_META = "METADATA"; // 元数据文件夹名 - - // 元数据头部键名 - public final static String META_HEAD_GTASK_ID = "meta_gid"; // 元数据头部：GTask ID - public final static String META_HEAD_NOTE = "meta_note"; // 元数据头部：笔记内容 - public final static String META_HEAD_DATA = "meta_data"; // 元数据头部：元数据 - - // 元数据笔记名称，不可更新和删除 - public final static String META_NOTE_NAME = "[META INFO] DON'T UPDATE AND DELETE"; // 不可更新和删除的元数据名称 -} diff --git a/src/tool/ResourceParser.java b/src/tool/ResourceParser.java deleted file mode 100644 index 7a62486..0000000 --- a/src/tool/ResourceParser.java +++ /dev/null @@ -1,212 +0,0 @@ -/* - * ResourceParser 类用于管理与应用资源相关的各种静态方法和常量。 - */ -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; - -// 定义 ResourceParser 类 -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。 - * - * @param context 上下文对象，用于访问SharedPreferences。 - * @return 如果用户设置了背景颜色，则返回一个随机背景颜色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 // 红色单项背景 - }; - - // 获取第一个列表项的背景资源 - public static int getNoteBgFirstRes(int id) { - return BG_FIRST_RESOURCES[id]; - } - - // 获取最后一个列表项的背景资源 - public static int getNoteBgLastRes(int id) { - return BG_LAST_RESOURCES[id]; - } - - // 获取单个列表项的背景资源 - public static int getNoteBgSingleRes(int id) { - return BG_SINGLE_RESOURCES[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, // 黄色2x小部件背景 - R.drawable.widget_2x_blue, // 蓝色2x小部件背景 - R.drawable.widget_2x_white, // 白色2x小部件背景 - R.drawable.widget_2x_green, // 绿色2x小部件背景 - R.drawable.widget_2x_red // 红色2x小部件背景 - }; - - // 根据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, // 黄色4x小部件背景 - R.drawable.widget_4x_blue, // 蓝色4x小部件背景 - R.drawable.widget_4x_white, // 白色4x小部件背景 - R.drawable.widget_4x_green, // 绿色4x小部件背景 - R.drawable.widget_4x_red // 红色4x小部件背景 - }; - - // 根据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获取文本外观资源 - public static int getTexAppearanceResource(int id) { - // 如果id超出资源数组范围，返回默认字体大小 - if (id >= TEXTAPPEARANCE_RESOURCES.length) { - return BG_DEFAULT_FONT_SIZE; - } - return TEXTAPPEARANCE_RESOURCES[id]; - } - - // 获取文本外观资源的数量 - public static int getResourcesSize() { - return TEXTAPPEARANCE_RESOURCES.length; - } - } -} diff --git a/src/ui/AlarmAlertActivity.java b/src/ui/AlarmAlertActivity.java deleted file mode 100644 index 3c77e81..0000000 --- a/src/ui/AlarmAlertActivity.java +++ /dev/null @@ -1,196 +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.ui; - -import android.app.Activity; -import android.app.AlertDialog; -import android.content.Context; -import android.content.DialogInterface; -import android.content.DialogInterface.OnClickListener; -import android.content.DialogInterface.OnDismissListener; -import android.content.Intent; -import android.media.AudioManager; -import android.media.MediaPlayer; -import android.media.RingtoneManager; -import android.net.Uri; -import android.os.Bundle; -import android.os.PowerManager; -import android.provider.Settings; -import android.view.Window; -import android.view.WindowManager; - -import net.micode.notes.R; -import net.micode.notes.data.Notes; -import net.micode.notes.tool.DataUtils; - -import java.io.IOException; - - -/* - * AlarmAlertActivity 类用于处理提醒通知的界面和声音播放。 - * 当一个笔记的提醒时间到达时，这个活动会被启动，显示提醒信息并播放提醒声音。 - */ -public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener { - // 笔记的ID - private long mNoteId; - // 笔记内容的简短预览 - private String mSnippet; - // 预览文本的最大长度 - private static final int SNIPPET_PREW_MAX_LEN = 60; - // 用于播放提醒声音的MediaPlayer对象 - MediaPlayer mPlayer; - - /* - * onCreate 方法初始化活动，设置窗口特性，根据传入的Intent获取笔记ID和简短内容， - * 并根据情况显示对话框和播放声音。 - */ - @Override - protected void onCreate(Bundle savedInstanceState) { - super.onCreate(savedInstanceState); - // 请求无标题的窗口 - requestWindowFeature(Window.FEATURE_NO_TITLE); - - // 设置窗口在锁屏时也显示，并根据屏幕状态决定是否保持唤醒 - final Window win = getWindow(); - win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); - if (!isScreenOn()) { - win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON - | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON - | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON - | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); - } - - // 从Intent中获取笔记ID和简短内容 - Intent intent = getIntent(); - try { - mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); - mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); - mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, - SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) - : mSnippet; - } catch (IllegalArgumentException e) { - e.printStackTrace(); - return; - } - - // 如果笔记在数据库中可见，则显示动作对话框并播放声音，否则结束活动 - mPlayer = new MediaPlayer(); - if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { - showActionDialog(); - playAlarmSound(); - } else { - finish(); - } - } - - /* - * 检查屏幕是否处于打开状态。 - * - * @return 如果屏幕已打开则返回true，否则返回false。 - */ - private boolean isScreenOn() { - PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); - return pm.isScreenOn(); - } - - /* - * 播放提醒声音。 - * 根据系统设置选择合适的音频流类型，并尝试播放选定的报警声音。 - */ - private void playAlarmSound() { - Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); - - // 检查是否在静音模式下影响报警声音 - int silentModeStreams = Settings.System.getInt(getContentResolver(), - Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0); - - if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) { - mPlayer.setAudioStreamType(silentModeStreams); - } else { - mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM); - } - try { - mPlayer.setDataSource(this, url); - mPlayer.prepare(); - mPlayer.setLooping(true); - mPlayer.start(); - } catch (IllegalArgumentException e) { - e.printStackTrace(); - } catch (SecurityException e) { - e.printStackTrace(); - } catch (IllegalStateException e) { - e.printStackTrace(); - } catch (IOException e) { - e.printStackTrace(); - } - } - - /* - * 显示动作对话框。 - * 根据屏幕是否打开，设置对话框的按钮，并显示应用名称和笔记的简短内容。 - */ - private void showActionDialog() { - AlertDialog.Builder dialog = new AlertDialog.Builder(this); - dialog.setTitle(R.string.app_name); - dialog.setMessage(mSnippet); - dialog.setPositiveButton(R.string.notealert_ok, this); - if (isScreenOn()) { - dialog.setNegativeButton(R.string.notealert_enter, this); - } - dialog.show().setOnDismissListener(this); - } - - /* - * 点击对话框按钮的响应处理。 - * 根据点击的按钮启动编辑笔记的活动或结束当前活动。 - */ - public void onClick(DialogInterface dialog, int which) { - switch (which) { - case DialogInterface.BUTTON_NEGATIVE: - // 如果点击的是“进入”按钮，则启动笔记编辑活动 - Intent intent = new Intent(this, NoteEditActivity.class); - intent.setAction(Intent.ACTION_VIEW); - intent.putExtra(Intent.EXTRA_UID, mNoteId); - startActivity(intent); - break; - default: - // 关闭活动 - break; - } - } - - /* - * 对话框关闭时的处理。 - * 停止播放提醒声音，结束当前活动。 - */ - public void onDismiss(DialogInterface dialog) { - stopAlarmSound(); - finish(); - } - - /* - * 停止播放提醒声音。 - * 如果MediaPlayer对象不为空，则停止播放并释放资源。 - */ - private void stopAlarmSound() { - if (mPlayer != null) { - mPlayer.stop(); - mPlayer.release(); - mPlayer = null; - } - } -} diff --git a/src/ui/AlarmInitReceiver.java b/src/ui/AlarmInitReceiver.java deleted file mode 100644 index 8da4ef8..0000000 --- a/src/ui/AlarmInitReceiver.java +++ /dev/null @@ -1,71 +0,0 @@ -/* - * 该类是广播接收器，用于在应用启动时初始化提醒设置。 - * 当系统启动时，它会检查数据库中所有设置了提醒的笔记，并为每个笔记设置相应的提醒。 - */ -package net.micode.notes.ui; - -import android.app.AlarmManager; -import android.app.PendingIntent; -import android.content.BroadcastReceiver; -import android.content.ContentUris; -import android.content.Context; -import android.content.Intent; -import android.database.Cursor; - -import net.micode.notes.data.Notes; -import net.micode.notes.data.Notes.NoteColumns; - - -public class AlarmInitReceiver extends BroadcastReceiver { - - // 查询笔记时需要的列 - private static final String[] PROJECTION = new String[]{ - NoteColumns.ID, - NoteColumns.ALERTED_DATE - }; - - // 列的索引 - private static final int COLUMN_ID = 0; - private static final int COLUMN_ALERTED_DATE = 1; - - /** - * 当接收到广播时执行的操作。主要用于设置所有已记录的提醒时间。 - * - * @param context 上下文，提供访问应用全局功能的入口。 - * @param intent 携带了触发该接收器的广播信息。 - */ - @Override - public void onReceive(Context context, Intent intent) { - // 获取当前日期和时间 - long currentDate = System.currentTimeMillis(); - // 查询数据库中所有需要提醒的笔记 - Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI, - PROJECTION, - NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, - new String[]{String.valueOf(currentDate)}, - null); - - if (c != null) { - // 遍历查询结果，为每个需要提醒的笔记设置提醒 - if (c.moveToFirst()) { - do { - // 获取提醒日期 - long alertDate = c.getLong(COLUMN_ALERTED_DATE); - // 创建Intent，用于在提醒时间触发AlarmReceiver - Intent sender = new Intent(context, AlarmReceiver.class); - sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); - // 创建PendingIntent，它是一个延迟的意图，可以在特定时间由系统触发 - PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); - // 获取AlarmManager服务，用于设置提醒 - AlarmManager alermManager = (AlarmManager) context - .getSystemService(Context.ALARM_SERVICE); - // 设置提醒 - alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); - } while (c.moveToNext()); - } - // 关闭Cursor，释放资源 - c.close(); - } - } -} - diff --git a/src/ui/AlarmReceiver.java b/src/ui/AlarmReceiver.java deleted file mode 100644 index 42d7313..0000000 --- a/src/ui/AlarmReceiver.java +++ /dev/null @@ -1,30 +0,0 @@ -/* - * AlarmReceiver类 - 用于处理闹钟广播接收 - * 当接收到闹钟相关的广播时，该类会启动一个指定的Activity - * - * extends BroadcastReceiver: 继承自Android的BroadcastReceiver类 - */ -package net.micode.notes.ui; - -import android.content.BroadcastReceiver; -import android.content.Context; -import android.content.Intent; - -public class AlarmReceiver extends BroadcastReceiver { - /* - * onReceive方法 - 系统调用的接收广播的方法 - * 当接收到广播时，该方法会被调用，然后启动AlarmAlertActivity - * - * @param context 上下文对象，提供了调用环境的信息 - * @param intent 包含广播的内容 - */ - @Override - public void onReceive(Context context, Intent intent) { - // 设置Intent的类，以便启动AlarmAlertActivity - intent.setClass(context, AlarmAlertActivity.class); - // 添加标志，表示在一个新的任务中启动Activity - intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); - // 根据设置的Intent启动Activity - context.startActivity(intent); - } -} diff --git a/src/ui/DateTimePicker.java b/src/ui/DateTimePicker.java deleted file mode 100644 index aea9538..0000000 --- a/src/ui/DateTimePicker.java +++ /dev/null @@ -1,583 +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.ui; - -import java.text.DateFormatSymbols; -import java.util.Calendar; - -import net.micode.notes.R; - - -import android.content.Context; -import android.text.format.DateFormat; -import android.view.View; -import android.widget.FrameLayout; -import android.widget.NumberPicker; - -public class DateTimePicker extends FrameLayout { - - // 默认启用状态 - private static final boolean DEFAULT_ENABLE_STATE = true; - - // 半天的小时数 - private static final int HOURS_IN_HALF_DAY = 12; - // 一整天的小时数 - private static final int HOURS_IN_ALL_DAY = 24; - // 一周的天数 - private static final int DAYS_IN_ALL_WEEK = 7; - // 日期选择器的最小值 - private static final int DATE_SPINNER_MIN_VAL = 0; - // 日期选择器的最大值 - private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; - // 24小时制小时选择器的最小值 - private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; - // 24小时制小时选择器的最大值 - private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; - // 12小时制小时选择器的最小值 - private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; - // 12小时制小时选择器的最大值 - private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12; - // 分钟选择器的最小值 - private static final int MINUT_SPINNER_MIN_VAL = 0; - // 分钟选择器的最大值 - private static final int MINUT_SPINNER_MAX_VAL = 59; - // 上下午选择器的最小值 - private static final int AMPM_SPINNER_MIN_VAL = 0; - // 上下午选择器的最大值 - private static final int AMPM_SPINNER_MAX_VAL = 1; - - // 日期选择器 - private final NumberPicker mDateSpinner; - // 小时选择器 - private final NumberPicker mHourSpinner; - // 分钟选择器 - private final NumberPicker mMinuteSpinner; - // 上下午选择器 - private final NumberPicker mAmPmSpinner; - // 当前日期 - private Calendar mDate; - - // 用于显示日期的字符串数组 - private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; - - // 当前是否为上午 - private boolean mIsAm; - - // 当前是否为24小时制视图 - private boolean mIs24HourView; - - // 控件是否启用 - private boolean mIsEnabled = DEFAULT_ENABLE_STATE; - - // 是否正在初始化 - private boolean mInitialising; - - // 日期时间改变监听器 - private OnDateTimeChangedListener mOnDateTimeChangedListener; - - // 日期选择器的值改变监听器 - private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() { - @Override - public void onValueChange(NumberPicker picker, int oldVal, int newVal) { - // 根据新旧值的差异更新日期 - mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal); - updateDateControl(); - onDateTimeChanged(); - } - }; - - // 小时选择器的值改变监听器 - private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { - @Override - public void onValueChange(NumberPicker picker, int oldVal, int newVal) { - // 根据小时的变化更新日期和上下午状态 - boolean isDateChanged = false; - Calendar cal = Calendar.getInstance(); - if (!mIs24HourView) { - // 处理12小时制下的日期变化和上下午切换 - if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { - cal.setTimeInMillis(mDate.getTimeInMillis()); - cal.add(Calendar.DAY_OF_YEAR, 1); - isDateChanged = true; - } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { - cal.setTimeInMillis(mDate.getTimeInMillis()); - cal.add(Calendar.DAY_OF_YEAR, -1); - isDateChanged = true; - } - if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || - oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { - mIsAm = !mIsAm; - updateAmPmControl(); - } - } else { - // 处理24小时制下的日期变化 - if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { - cal.setTimeInMillis(mDate.getTimeInMillis()); - cal.add(Calendar.DAY_OF_YEAR, 1); - isDateChanged = true; - } else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) { - cal.setTimeInMillis(mDate.getTimeInMillis()); - cal.add(Calendar.DAY_OF_YEAR, -1); - isDateChanged = true; - } - } - // 更新小时并触发日期时间改变事件 - int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY); - mDate.set(Calendar.HOUR_OF_DAY, newHour); - onDateTimeChanged(); - // 如果日期有变化，则更新年月日 - if (isDateChanged) { - setCurrentYear(cal.get(Calendar.YEAR)); - setCurrentMonth(cal.get(Calendar.MONTH)); - setCurrentDay(cal.get(Calendar.DAY_OF_MONTH)); - } - } - }; - - - // 分别为分钟和AM/PM选择器监听器设置匿名内部类，实现数值变化时的处理逻辑。 - private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { - @Override - public void onValueChange(NumberPicker picker, int oldVal, int newVal) { - // 计算小时的偏移量，当从最大值变为最小值或从最小值变为最大值时调整 - int minValue = mMinuteSpinner.getMinValue(); - int maxValue = mMinuteSpinner.getMaxValue(); - int offset = 0; - if (oldVal == maxValue && newVal == minValue) { - offset += 1; - } else if (oldVal == minValue && newVal == maxValue) { - offset -= 1; - } - // 根据偏移量更新日期和小时选择器，并检查是否需要切换AM/PM - if (offset != 0) { - mDate.add(Calendar.HOUR_OF_DAY, offset); - mHourSpinner.setValue(getCurrentHour()); - updateDateControl(); - int newHour = getCurrentHourOfDay(); - if (newHour >= HOURS_IN_HALF_DAY) { - mIsAm = false; - updateAmPmControl(); - } else { - mIsAm = true; - updateAmPmControl(); - } - } - // 更新分钟值并触发日期变化的回调 - mDate.set(Calendar.MINUTE, newVal); - onDateTimeChanged(); - } - }; - - private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() { - @Override - public void onValueChange(NumberPicker picker, int oldVal, int newVal) { - // 切换AM/PM状态，并更新日期和AM/PM选择器 - mIsAm = !mIsAm; - if (mIsAm) { - mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY); - } else { - mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY); - } - updateAmPmControl(); - onDateTimeChanged(); - } - }; - - // 定义日期时间变化的回调接口 - public interface OnDateTimeChangedListener { - void onDateTimeChanged(DateTimePicker view, int year, int month, - int dayOfMonth, int hourOfDay, int minute); - } - - // 构造函数：初始化日期时间选择器 - public DateTimePicker(Context context) { - this(context, System.currentTimeMillis()); - } - - // 构造函数：指定初始日期时间 - public DateTimePicker(Context context, long date) { - this(context, date, DateFormat.is24HourFormat(context)); - } - - // 构造函数：指定是否使用24小时制视图 - public DateTimePicker(Context context, long date, boolean is24HourView) { - super(context); - mDate = Calendar.getInstance(); - mInitialising = true; - mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; - inflate(context, R.layout.datetime_picker, this); - - // 初始化日期、小时、分钟和AM/PM选择器，并设置相应的监听器 - mDateSpinner = (NumberPicker) findViewById(R.id.date); - mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL); - mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL); - mDateSpinner.setOnValueChangedListener(mOnDateChangedListener); - - mHourSpinner = (NumberPicker) findViewById(R.id.hour); - mHourSpinner.setOnValueChangedListener(mOnHourChangedListener); - mMinuteSpinner = (NumberPicker) findViewById(R.id.minute); - mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL); - mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL); - mMinuteSpinner.setOnLongPressUpdateInterval(100); - mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener); - - String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings(); - mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); - mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); - mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); - mAmPmSpinner.setDisplayedValues(stringsForAmPm); - mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener); - - // 更新控件至初始状态 - updateDateControl(); - updateHourControl(); - updateAmPmControl(); - - set24HourView(is24HourView); - - // 设置为当前时间 - setCurrentDate(date); - - setEnabled(isEnabled()); - - // 设置内容描述 - mInitialising = false; - } - - - /** - * 设置控件的启用状态。 - * 如果当前状态与传入状态相同，则不进行任何操作。 - * 启用或禁用日期和时间选择器，并更新内部启用状态。 - * - * @param enabled 控件是否启用 - */ - @Override - public void setEnabled(boolean enabled) { - if (mIsEnabled == enabled) { - return; - } - super.setEnabled(enabled); - // 同时启用或禁用日期和时间选择器 - mDateSpinner.setEnabled(enabled); - mMinuteSpinner.setEnabled(enabled); - mHourSpinner.setEnabled(enabled); - mAmPmSpinner.setEnabled(enabled); - mIsEnabled = enabled; - } - - /** - * 获取控件的启用状态。 - * - * @return 控件是否启用 - */ - @Override - public boolean isEnabled() { - return mIsEnabled; - } - - /** - * 获取当前日期的时间戳（毫秒）。 - * - * @return 当前日期的毫秒时间戳 - */ - public long getCurrentDateInTimeMillis() { - return mDate.getTimeInMillis(); - } - - /** - * 设置当前日期。 - * 根据传入的毫秒时间戳更新日期选择器的值。 - * - * @param date The current date in millis - */ - public void setCurrentDate(long date) { - Calendar cal = Calendar.getInstance(); - cal.setTimeInMillis(date); - // 通过日历实例的详细字段设置当前日期和时间 - setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH), - cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE)); - } - - /** - * 设置当前日期和时间。 - * 分别设置年、月、日、时和分。 - * - * @param year 当前年份 - * @param month 当前月份 - * @param dayOfMonth 当前日 - * @param hourOfDay 当前小时 - * @param minute 当前分钟 - */ - public void setCurrentDate(int year, int month, - int dayOfMonth, int hourOfDay, int minute) { - // 分别设置年、月、日、时和分 - setCurrentYear(year); - setCurrentMonth(month); - setCurrentDay(dayOfMonth); - setCurrentHour(hourOfDay); - setCurrentMinute(minute); - } - - - /** - * 获取当前年份 - * - * @return 当前的年份 - */ - public int getCurrentYear() { - return mDate.get(Calendar.YEAR); - } - - /** - * 设置当前年份 - * - * @param year 当前的年份 - */ - public void setCurrentYear(int year) { - // 如果不是初始化状态并且设置的年份与当前年份相同，则直接返回 - if (!mInitialising && year == getCurrentYear()) { - return; - } - mDate.set(Calendar.YEAR, year); - updateDateControl(); // 更新日期控件 - onDateTimeChanged(); // 触发日期时间改变事件 - } - - /** - * 获取当前月份 - * - * @return 当前的月份（从0开始） - */ - public int getCurrentMonth() { - return mDate.get(Calendar.MONTH); - } - - /** - * 设置当前月份 - * - * @param month 当前的月份（从0开始） - */ - public void setCurrentMonth(int month) { - // 如果不是初始化状态并且设置的月份与当前月份相同，则直接返回 - if (!mInitialising && month == getCurrentMonth()) { - return; - } - mDate.set(Calendar.MONTH, month); - updateDateControl(); // 更新日期控件 - onDateTimeChanged(); // 触发日期时间改变事件 - } - - /** - * 获取当前日期（月中的天数） - * - * @return 当前的日期（月中的天数） - */ - public int getCurrentDay() { - return mDate.get(Calendar.DAY_OF_MONTH); - } - - /** - * 设置当前日期（月中的天数） - * - * @param dayOfMonth 当前的日期（月中的天数） - */ - public void setCurrentDay(int dayOfMonth) { - // 如果不是初始化状态并且设置的日期与当前日期相同，则直接返回 - if (!mInitialising && dayOfMonth == getCurrentDay()) { - return; - } - mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); - updateDateControl(); // 更新日期控件 - onDateTimeChanged(); // 触发日期时间改变事件 - } - - /** - * 获取当前小时（24小时制），范围为(0~23) - * - * @return 当前的小时（24小时制） - */ - public int getCurrentHourOfDay() { - return mDate.get(Calendar.HOUR_OF_DAY); - } - - /** - * 获取当前小时，根据是否为24小时制返回不同的值。 - * 如果是24小时制，与{@link #getCurrentHourOfDay()}返回相同结果； - * 否则，将小时转换为12小时制，并考虑上午/下午。 - * - * @return 当前的小时（根据视图模式可能是12小时制） - */ - private int getCurrentHour() { - if (mIs24HourView) { - return getCurrentHourOfDay(); - } else { - int hour = getCurrentHourOfDay(); - // 转换为12小时制 - if (hour > HOURS_IN_HALF_DAY) { - return hour - HOURS_IN_HALF_DAY; - } else { - return hour == 0 ? HOURS_IN_HALF_DAY : hour; - } - } - } - - - /** - * 设置当前小时（24小时制），范围为(0~23) - * - * @param hourOfDay 当前小时数 - */ - public void setCurrentHour(int hourOfDay) { - // 如果在初始化中或者小时未改变，则直接返回 - if (!mInitialising && hourOfDay == getCurrentHourOfDay()) { - return; - } - mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); - // 如果不是24小时视图，则调整小时数并更新AM/PM控制 - if (!mIs24HourView) { - if (hourOfDay >= HOURS_IN_HALF_DAY) { - mIsAm = false; - if (hourOfDay > HOURS_IN_HALF_DAY) { - hourOfDay -= HOURS_IN_HALF_DAY; - } - } else { - mIsAm = true; - if (hourOfDay == 0) { - hourOfDay = HOURS_IN_HALF_DAY; - } - } - updateAmPmControl(); - } - mHourSpinner.setValue(hourOfDay); - onDateTimeChanged(); - } - - /** - * 获取当前分钟数 - * - * @return 当前分钟数 - */ - public int getCurrentMinute() { - return mDate.get(Calendar.MINUTE); - } - - /** - * 设置当前分钟数 - * - * @param minute 当前分钟数值 - */ - public void setCurrentMinute(int minute) { - // 如果在初始化中或者分钟数未改变，则直接返回 - if (!mInitialising && minute == getCurrentMinute()) { - return; - } - mMinuteSpinner.setValue(minute); - mDate.set(Calendar.MINUTE, minute); - onDateTimeChanged(); - } - - /** - * 获取当前是否为24小时视图 - * - * @return 如果是24小时视图返回true，否则返回false - */ - public boolean is24HourView() { - return mIs24HourView; - } - - /** - * 设置当前视图为24小时制还是AM/PM制 - * - * @param is24HourView 如果为true表示24小时制，false表示AM/PM制 - */ - public void set24HourView(boolean is24HourView) { - // 如果视图模式未改变，则直接返回 - if (mIs24HourView == is24HourView) { - return; - } - mIs24HourView = is24HourView; - mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE); - int hour = getCurrentHourOfDay(); - updateHourControl(); - setCurrentHour(hour); - updateAmPmControl(); - } - - /** - * 更新日期控制组件，显示正确的日期选项 - */ - private void updateDateControl() { - Calendar cal = Calendar.getInstance(); - cal.setTimeInMillis(mDate.getTimeInMillis()); - cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1); - mDateSpinner.setDisplayedValues(null); - // 循环设置一周内每一天的显示文本 - for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) { - cal.add(Calendar.DAY_OF_YEAR, 1); - mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal); - } - mDateSpinner.setDisplayedValues(mDateDisplayValues); - mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); - mDateSpinner.invalidate(); - } - - /** - * 根据当前是否为24小时视图来更新AM/PM控制组件的显示和值 - */ - private void updateAmPmControl() { - if (mIs24HourView) { - mAmPmSpinner.setVisibility(View.GONE); - } else { - int index = mIsAm ? Calendar.AM : Calendar.PM; - mAmPmSpinner.setValue(index); - mAmPmSpinner.setVisibility(View.VISIBLE); - } - } - - /** - * 根据当前是否为24小时视图来更新小时控制组件的最小值和最大值 - */ - private void updateHourControl() { - if (mIs24HourView) { - mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW); - mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW); - } else { - mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW); - mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW); - } - } - - /** - * 设置点击“设置”按钮时的回调接口 - * - * @param callback 回调接口实例，如果为null则不执行任何操作 - */ - public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) { - mOnDateTimeChangedListener = callback; - } - - /** - * 当日期时间被改变时调用此方法，如果设置了日期时间改变监听器，则触发监听器的回调方法 - */ - private void onDateTimeChanged() { - if (mOnDateTimeChangedListener != null) { - mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(), - getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute()); - } - } -} diff --git a/src/ui/DateTimePickerDialog.java b/src/ui/DateTimePickerDialog.java deleted file mode 100644 index 2f9f8a9..0000000 --- a/src/ui/DateTimePickerDialog.java +++ /dev/null @@ -1,121 +0,0 @@ -/* - * DateTimePickerDialog类提供了一个日期和时间选择器对话框。 - * 用户可以选择一个日期和时间，然后通过监听器回调返回选择的值。 - */ -package net.micode.notes.ui; - -import java.util.Calendar; - -import net.micode.notes.R; -import net.micode.notes.ui.DateTimePicker; -import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener; - -import android.app.AlertDialog; -import android.content.Context; -import android.content.DialogInterface; -import android.content.DialogInterface.OnClickListener; -import android.text.format.DateFormat; -import android.text.format.DateUtils; - -public class DateTimePickerDialog extends AlertDialog implements OnClickListener { - - // 当前选择的日期和时间 - private Calendar mDate = Calendar.getInstance(); - // 用于指示日期时间选择器是否使用24小时制 - private boolean mIs24HourView; - // 日期时间设置监听器，用于处理日期时间选择后的回调 - private OnDateTimeSetListener mOnDateTimeSetListener; - // 日期时间选择器视图 - private DateTimePicker mDateTimePicker; - - /** - * 日期时间设置监听器接口。 - * 实现此接口的类需要提供OnDateTimeSet方法来处理日期时间被设置的事件。 - */ - public interface OnDateTimeSetListener { - void OnDateTimeSet(AlertDialog dialog, long date); - } - - /** - * 构造函数初始化日期时间选择器对话框。 - * - * @param context 上下文对象，通常是指Activity。 - * @param date 初始显示的日期时间值。 - */ - public DateTimePickerDialog(Context context, long date) { - super(context); - mDateTimePicker = new DateTimePicker(context); - setView(mDateTimePicker); - // 设置日期时间改变的监听器 - mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() { - public void onDateTimeChanged(DateTimePicker view, int year, int month, - int dayOfMonth, int hourOfDay, int minute) { - // 更新内部日期时间值 - mDate.set(Calendar.YEAR, year); - mDate.set(Calendar.MONTH, month); - mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth); - mDate.set(Calendar.HOUR_OF_DAY, hourOfDay); - mDate.set(Calendar.MINUTE, minute); - // 更新对话框的标题显示 - updateTitle(mDate.getTimeInMillis()); - } - }); - mDate.setTimeInMillis(date); - mDate.set(Calendar.SECOND, 0); - mDateTimePicker.setCurrentDate(mDate.getTimeInMillis()); - // 设置对话框的确认和取消按钮 - setButton(context.getString(R.string.datetime_dialog_ok), this); - setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener) null); - // 根据系统设置决定是否使用24小时制 - set24HourView(DateFormat.is24HourFormat(this.getContext())); - // 更新标题以显示当前选择的日期和时间 - updateTitle(mDate.getTimeInMillis()); - } - - /** - * 设置日期时间选择器是否使用24小时制。 - * - * @param is24HourView 是否使用24小时制。 - */ - public void set24HourView(boolean is24HourView) { - mIs24HourView = is24HourView; - } - - /** - * 设置日期时间被设置时的监听器。 - * - * @param callBack 日期时间设置监听器对象。 - */ - public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { - mOnDateTimeSetListener = callBack; - } - - /** - * 更新对话框标题以显示当前选择的日期和时间。 - * - * @param date 当前选择的日期时间值。 - */ - private void updateTitle(long date) { - // 根据是否使用24小时制来格式化日期时间显示 - int flag = - DateUtils.FORMAT_SHOW_YEAR | - DateUtils.FORMAT_SHOW_DATE | - DateUtils.FORMAT_SHOW_TIME; - flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR; - setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); - } - - /** - * 点击按钮时的处理逻辑。 - * 如果设置了日期时间设置监听器，则调用其OnDateTimeSet方法，传入当前选择的日期时间值。 - * - * @param arg0 对话框对象。 - * @param arg1 按钮标识。 - */ - public void onClick(DialogInterface arg0, int arg1) { - if (mOnDateTimeSetListener != null) { - mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); - } - } - -} diff --git a/src/ui/DropdownMenu.java b/src/ui/DropdownMenu.java deleted file mode 100644 index 8330499..0000000 --- a/src/ui/DropdownMenu.java +++ /dev/null @@ -1,73 +0,0 @@ -/* - * DropdownMenu类用于创建和管理一个下拉菜单。 - * 该类封装了一个Button和一个PopupMenu，通过点击Button来显示下拉菜单。 - */ -package net.micode.notes.ui; - -import android.content.Context; -import android.view.Menu; -import android.view.MenuItem; -import android.view.View; -import android.view.View.OnClickListener; -import android.widget.Button; -import android.widget.PopupMenu; -import android.widget.PopupMenu.OnMenuItemClickListener; - -import net.micode.notes.R; - -public class DropdownMenu { - private Button mButton; // 弹出下拉菜单的按钮 - private PopupMenu mPopupMenu; // 弹出的下拉菜单 - private Menu mMenu; // 下拉菜单的项目集合 - - /** - * DropdownMenu的构造函数。 - * - * @param context 上下文对象，通常是指Activity。 - * @param button 用于触发下拉菜单显示的按钮。 - * @param menuId 菜单资源ID，用于加载下拉菜单的项目。 - */ - public DropdownMenu(Context context, Button button, int menuId) { - mButton = button; - mButton.setBackgroundResource(R.drawable.dropdown_icon); // 设置按钮背景为下拉图标 - mPopupMenu = new PopupMenu(context, mButton); // 创建PopupMenu实例 - mMenu = mPopupMenu.getMenu(); // 获取菜单项的集合 - mPopupMenu.getMenuInflater().inflate(menuId, mMenu); // 加载菜单项 - // 设置按钮点击事件，点击后显示下拉菜单 - mButton.setOnClickListener(new OnClickListener() { - public void onClick(View v) { - mPopupMenu.show(); - } - }); - } - - /** - * 设置下拉菜单项的点击事件监听器。 - * - * @param listener PopupMenu的OnMenuItemClickListener，用于监听菜单项的点击事件。 - */ - public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) { - if (mPopupMenu != null) { - mPopupMenu.setOnMenuItemClickListener(listener); - } - } - - /** - * 根据ID查找菜单项。 - * - * @param id 菜单项的ID。 - * @return 返回找到的MenuItem对象，如果未找到则返回null。 - */ - public MenuItem findItem(int id) { - return mMenu.findItem(id); - } - - /** - * 设置按钮的标题。 - * - * @param title 按钮要显示的标题。 - */ - public void setTitle(CharSequence title) { - mButton.setText(title); - } -} diff --git a/src/ui/FoldersListAdapter.java b/src/ui/FoldersListAdapter.java deleted file mode 100644 index 2f461ca..0000000 --- a/src/ui/FoldersListAdapter.java +++ /dev/null @@ -1,110 +0,0 @@ -/* - * FoldersListAdapter 类 - * 用于管理和适配文件夹列表的适配器，继承自 CursorAdapter。 - */ - -package net.micode.notes.ui; - -// 导入相关类 - -import android.content.Context; -import android.database.Cursor; -import android.view.View; -import android.view.ViewGroup; -import android.widget.CursorAdapter; -import android.widget.LinearLayout; -import android.widget.TextView; - -import net.micode.notes.R; -import net.micode.notes.data.Notes; -import net.micode.notes.data.Notes.NoteColumns; - - -public class FoldersListAdapter extends CursorAdapter { - // 查询时使用的列名数组 - public static final String[] PROJECTION = { - NoteColumns.ID, - NoteColumns.SNIPPET - }; - - // 列名数组中的索引常量 - public static final int ID_COLUMN = 0; - public static final int NAME_COLUMN = 1; - - /* - * 构造函数 - * @param context 上下文对象，通常指Activity或Application对象。 - * @param c 数据源游标Cursor。 - */ - public FoldersListAdapter(Context context, Cursor c) { - super(context, c); - } - - /* - * 创建新的列表项View - * @param context 上下文对象。 - * @param cursor 当前数据项的游标。 - * @param parent 视图的父容器。 - * @return 返回新创建的列表项View。 - */ - @Override - public View newView(Context context, Cursor cursor, ViewGroup parent) { - return new FolderListItem(context); - } - - /* - * 绑定数据到已有的View上 - * @param view 要绑定数据的视图。 - * @param context 上下文对象。 - * @param cursor 当前数据项的游标。 - */ - @Override - public void bindView(View view, Context context, Cursor cursor) { - if (view instanceof FolderListItem) { - // 根据文件夹ID判断是根文件夹还是普通文件夹，并设置文件夹名称 - String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context - .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); - ((FolderListItem) view).bind(folderName); - } - } - - /* - * 根据位置获取文件夹名称 - * @param context 上下文对象。 - * @param position 列表中的位置。 - * @return 返回该位置上文件夹的名称。 - */ - public String getFolderName(Context context, int position) { - Cursor cursor = (Cursor) getItem(position); - return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context - .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); - } - - /* - * FolderListItem 内部类 - * 用于表示文件夹列表中的一个项的视图类。 - */ - private class FolderListItem extends LinearLayout { - private TextView mName; // 文件夹名称的文本视图 - - /* - * 构造函数 - * @param context 上下文对象。 - */ - public FolderListItem(Context context) { - super(context); - // 加载布局文件，并将自己作为根视图 - inflate(context, R.layout.folder_list_item, this); - mName = (TextView) findViewById(R.id.tv_folder_name); // 获取文件夹名称的视图 - } - - /* - * 绑定数据到视图上 - * @param name 要显示的文件夹名称。 - */ - public void bind(String name) { - mName.setText(name); - } - } - -} diff --git a/src/ui/NoteEditActivity.java b/src/ui/NoteEditActivity.java deleted file mode 100644 index 76c4c22..0000000 --- a/src/ui/NoteEditActivity.java +++ /dev/null @@ -1,1141 +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.ui; - -import android.app.Activity; -import android.app.AlarmManager; -import android.app.AlertDialog; -import android.app.PendingIntent; -import android.app.SearchManager; -import android.appwidget.AppWidgetManager; -import android.content.ContentUris; -import android.content.Context; -import android.content.DialogInterface; -import android.content.Intent; -import android.content.SharedPreferences; -import android.graphics.Paint; -import android.os.Bundle; -import android.preference.PreferenceManager; -import android.text.Spannable; -import android.text.SpannableString; -import android.text.TextUtils; -import android.text.format.DateUtils; -import android.text.style.BackgroundColorSpan; -import android.util.Log; -import android.view.LayoutInflater; -import android.view.Menu; -import android.view.MenuItem; -import android.view.MotionEvent; -import android.view.View; -import android.view.View.OnClickListener; -import android.view.WindowManager; -import android.widget.CheckBox; -import android.widget.CompoundButton; -import android.widget.CompoundButton.OnCheckedChangeListener; -import android.widget.EditText; -import android.widget.ImageView; -import android.widget.LinearLayout; -import android.widget.TextView; -import android.widget.Toast; - -import net.micode.notes.R; -import net.micode.notes.data.Notes; -import net.micode.notes.data.Notes.TextNote; -import net.micode.notes.model.WorkingNote; -import net.micode.notes.model.WorkingNote.NoteSettingChangedListener; -import net.micode.notes.tool.DataUtils; -import net.micode.notes.tool.ResourceParser; -import net.micode.notes.tool.ResourceParser.TextAppearanceResources; -import net.micode.notes.ui.DateTimePickerDialog.OnDateTimeSetListener; -import net.micode.notes.ui.NoteEditText.OnTextViewChangeListener; -import net.micode.notes.widget.NoteWidgetProvider_2x; -import net.micode.notes.widget.NoteWidgetProvider_4x; - -import java.util.HashMap; -import java.util.HashSet; -import java.util.Map; -import java.util.regex.Matcher; -import java.util.regex.Pattern; - - -public class NoteEditActivity extends Activity implements OnClickListener, - NoteSettingChangedListener, OnTextViewChangeListener { - /** - * 头部视图的ViewHolder类，用于存储头部视图中的UI组件引用。 - */ - private class HeadViewHolder { - public TextView tvModified; // 显示修改日期的文本视图 - public ImageView ivAlertIcon; // 提示图标图像视图 - public TextView tvAlertDate; // 显示提醒日期的文本视图 - public ImageView ibSetBgColor; // 设置背景颜色的图像视图 - } - - /** - * 背景选择按钮与其对应选中状态图标的映射。 - */ - private static final Map sBgSelectorBtnsMap = new HashMap(); - - static { - // 初始化背景选择按钮映射 - sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); - sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED); - sBgSelectorBtnsMap.put(R.id.iv_bg_blue, ResourceParser.BLUE); - sBgSelectorBtnsMap.put(R.id.iv_bg_green, ResourceParser.GREEN); - sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE); - } - - /** - * 背景选择按钮选中状态与其对应图标的映射。 - */ - private static final Map sBgSelectorSelectionMap = new HashMap(); - - static { - // 初始化背景选择按钮选中状态映射 - sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select); - sBgSelectorSelectionMap.put(ResourceParser.RED, R.id.iv_bg_red_select); - sBgSelectorSelectionMap.put(ResourceParser.BLUE, R.id.iv_bg_blue_select); - sBgSelectorSelectionMap.put(ResourceParser.GREEN, R.id.iv_bg_green_select); - sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); - } - - /** - * 字号选择按钮与其对应字体大小的映射。 - */ - private static final Map sFontSizeBtnsMap = new HashMap(); - - static { - // 初始化字号选择按钮映射 - sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE); - sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL); - sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); - sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER); - } - - /** - * 字号选择按钮选中状态与其对应图标的映射。 - */ - private static final Map sFontSelectorSelectionMap = new HashMap(); - - static { - // 初始化字号选择按钮选中状态映射 - sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select); - sFontSelectorSelectionMap.put(ResourceParser.TEXT_SMALL, R.id.iv_small_select); - sFontSelectorSelectionMap.put(ResourceParser.TEXT_MEDIUM, R.id.iv_medium_select); - sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select); - } - - private static final String TAG = "NoteEditActivity"; // 日志标签 - - private HeadViewHolder mNoteHeaderHolder; // 头部视图的ViewHolder - - private View mHeadViewPanel; // 头部视图面板 - - private View mNoteBgColorSelector; // 笔记背景颜色选择器 - - private View mFontSizeSelector; // 字号选择器 - - private EditText mNoteEditor; // 笔记编辑器 - - private View mNoteEditorPanel; // 笔记编辑器面板 - - private WorkingNote mWorkingNote; // 当前正在编辑的笔记 - - private SharedPreferences mSharedPrefs; // 共享偏好设置 - private int mFontSizeId; // 当前选中的字体大小资源ID - - private static final String PREFERENCE_FONT_SIZE = "pref_font_size"; // 字体大小偏好设置键 - - private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10; // 快捷图标标题的最大长度 - - public static final String TAG_CHECKED = String.valueOf('\u221A'); // 标记为已检查的字符串 - public static final String TAG_UNCHECKED = String.valueOf('\u25A1'); // 标记为未检查的字符串 - - private LinearLayout mEditTextList; // 编辑文本列表 - - private String mUserQuery; // 用户查询字符串 - private Pattern mPattern; // 正则表达式模式 - - - @Override - protected void onCreate(Bundle savedInstanceState) { - super.onCreate(savedInstanceState); - this.setContentView(R.layout.note_edit); // 设置活动的视图布局 - - // 检查实例状态是否被保存，如果未保存且初始化活动状态失败，则结束该活动 - if (savedInstanceState == null && !initActivityState(getIntent())) { - finish(); - return; - } - initResources(); // 初始化资源 - } - - /** - * 当活动被系统销毁后，为了恢复之前的状态，此方法会被调用。 - * 主要用于处理活动重新创建时的数据恢复。 - * - * @param savedInstanceState 包含之前保存状态的Bundle，如果活动之前保存了状态，这里会传入非空的Bundle。 - */ - @Override - protected void onRestoreInstanceState(Bundle savedInstanceState) { - super.onRestoreInstanceState(savedInstanceState); - // 检查是否有保存的状态并且包含必要的UID信息，用于恢复活动状态 - if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) { - Intent intent = new Intent(Intent.ACTION_VIEW); - intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID)); - // 使用intent尝试恢复活动状态，如果失败则结束该活动 - if (!initActivityState(intent)) { - finish(); - return; - } - Log.d(TAG, "Restoring from killed activity"); // 日志记录，表示活动状态正在从被杀死的状态恢复 - } - } - - - /** - * 初始化活动状态，根据传入的Intent确定是查看笔记、新建笔记还是编辑笔记。 - * - * @param intent 传入的Intent，包含了动作类型和相关数据。 - * @return boolean 返回true表示成功初始化活动状态，false表示初始化失败。 - */ - private boolean initActivityState(Intent intent) { - // 如果用户指定的是查看笔记的动作但未提供笔记ID，则跳转到笔记列表活动 - mWorkingNote = null; - if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) { - long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0); - mUserQuery = ""; - - // 从搜索结果开始 - if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { - noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); - mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY); - } - - // 检查指定的笔记在数据库中是否可见 - if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) { - Intent jump = new Intent(this, NotesListActivity.class); - startActivity(jump); - showToast(R.string.error_note_not_exist); - finish(); - return false; - } else { - // 加载指定ID的笔记 - mWorkingNote = WorkingNote.load(this, noteId); - if (mWorkingNote == null) { - Log.e(TAG, "load note failed with note id" + noteId); - finish(); - return false; - } - } - // 隐藏软键盘 - getWindow().setSoftInputMode( - WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN - | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE); - } else if (TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) { - // 处理新建或编辑笔记的情况 - long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); - int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, - AppWidgetManager.INVALID_APPWIDGET_ID); - int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, - Notes.TYPE_WIDGET_INVALIDE); - int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, - ResourceParser.getDefaultBgId(this)); - - // 解析通话记录笔记 - String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER); - long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0); - if (callDate != 0 && phoneNumber != null) { - // 根据电话号码和通话日期尝试获取已有笔记ID - if (TextUtils.isEmpty(phoneNumber)) { - Log.w(TAG, "The call record number is null"); - } - long noteId = 0; - if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(), - phoneNumber, callDate)) > 0) { - // 加载该笔记 - mWorkingNote = WorkingNote.load(this, noteId); - if (mWorkingNote == null) { - Log.e(TAG, "load call note failed with note id" + noteId); - finish(); - return false; - } - } else { - // 创建新的通话记录笔记 - mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, - widgetType, bgResId); - mWorkingNote.convertToCallNote(phoneNumber, callDate); - } - } else { - // 创建普通空笔记 - mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, - bgResId); - } - - // 显示软键盘 - getWindow().setSoftInputMode( - WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE - | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE); - } else { - // 不支持的Intent动作 - Log.e(TAG, "Intent not specified action, should not support"); - finish(); - return false; - } - // 设置笔记状态改变的监听器 - mWorkingNote.setOnSettingStatusChangedListener(this); - return true; - } - - - /** - * 当Activity恢复到前台时调用。 - * 主要负责初始化笔记界面。 - */ - @Override - protected void onResume() { - super.onResume(); - initNoteScreen(); - } - - /** - * 初始化笔记界面的函数。 - * 该函数设置笔记编辑器的外观，根据笔记类型切换到相应的模式，设置背景和头部信息， - * 以及处理提醒头部的显示。 - */ - private void initNoteScreen() { - // 设置编辑器的文本外观 - mNoteEditor.setTextAppearance(this, TextAppearanceResources - .getTexAppearanceResource(mFontSizeId)); - // 根据当前笔记的类型，切换到列表模式或高亮查询结果模式 - if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - switchToListMode(mWorkingNote.getContent()); - } else { - mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery)); - mNoteEditor.setSelection(mNoteEditor.getText().length()); - } - // 隐藏所有背景选择器 - for (Integer id : sBgSelectorSelectionMap.keySet()) { - findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE); - } - // 设置标题和编辑区域的背景 - mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); - mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); - - // 设置修改时间 - mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this, - mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE - | DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME - | DateUtils.FORMAT_SHOW_YEAR)); - - // 显示提醒头部信息（当前禁用，因DateTimePicker未准备好） - showAlertHeader(); - } - - /** - * 显示提醒头部信息的方法。 - * 如果当前笔记设置了提醒，该方法将根据提醒时间显示相对的时间或者过期信息。 - */ - private void showAlertHeader() { - // 处理提醒显示 - if (mWorkingNote.hasClockAlert()) { - long time = System.currentTimeMillis(); - // 如果提醒时间已过，显示提醒已过期的信息 - if (time > mWorkingNote.getAlertDate()) { - mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); - } else { - // 否则，显示相对时间 - mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString( - mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS)); - } - // 设置提醒视图可见 - mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE); - mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE); - } else { - // 如果没有设置提醒，隐藏提醒视图 - mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE); - mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE); - } - } - - /** - * 当Activity接收到新的Intent时调用。 - * 用于根据新的Intent重新初始化Activity状态。 - * - * @param intent 新的Intent - */ - @Override - protected void onNewIntent(Intent intent) { - super.onNewIntent(intent); - initActivityState(intent); - } - - /** - * 保存Activity状态时调用。 - * 用于保存当前编辑的笔记，如果该笔记还未保存到数据库，则首先保存它。 - * 并且保存当前笔记的ID到Bundle中。 - * - * @param outState 用于保存Activity状态的Bundle - */ - @Override - protected void onSaveInstanceState(Bundle outState) { - super.onSaveInstanceState(outState); - // 如果当前编辑的笔记不存在于数据库中，即还未保存，先保存它 - if (!mWorkingNote.existInDatabase()) { - saveNote(); - } - // 保存笔记ID - outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId()); - Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState"); - } - - - /** - * 分发触摸事件。如果触摸事件不在指定视图范围内，则隐藏该视图。 - * - * @param ev 触摸事件 - * @return 如果事件被消费则返回true，否则返回false - */ - @Override - public boolean dispatchTouchEvent(MotionEvent ev) { - // 如果背景颜色选择器可见且不在触摸范围内，则隐藏它并消费事件 - if (mNoteBgColorSelector.getVisibility() == View.VISIBLE - && !inRangeOfView(mNoteBgColorSelector, ev)) { - mNoteBgColorSelector.setVisibility(View.GONE); - return true; - } - - // 如果字体大小选择器可见且不在触摸范围内，则隐藏它并消费事件 - if (mFontSizeSelector.getVisibility() == View.VISIBLE - && !inRangeOfView(mFontSizeSelector, ev)) { - mFontSizeSelector.setVisibility(View.GONE); - return true; - } - // 如果上述条件都不满足，则将事件传递给父类处理 - return super.dispatchTouchEvent(ev); - } - - /** - * 判断触摸点是否在指定视图范围内。 - * - * @param view 视图 - * @param ev 触摸事件 - * @return 如果触摸点在视图范围内则返回true，否则返回false - */ - private boolean inRangeOfView(View view, MotionEvent ev) { - int[] location = new int[2]; - view.getLocationOnScreen(location); - int x = location[0]; - int y = location[1]; - // 判断触摸点是否在视图外 - if (ev.getX() < x - || ev.getX() > (x + view.getWidth()) - || ev.getY() < y - || ev.getY() > (y + view.getHeight())) { - return false; - } - return true; - } - - /** - * 初始化资源，包括视图和偏好设置。 - */ - private void initResources() { - // 初始化头部视图和相关组件 - mHeadViewPanel = findViewById(R.id.note_title); - mNoteHeaderHolder = new HeadViewHolder(); - mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date); - mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon); - mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date); - mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color); - mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this); - // 初始化编辑器和相关组件 - mNoteEditor = (EditText) findViewById(R.id.note_edit_view); - mNoteEditorPanel = findViewById(R.id.sv_note_edit); - mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector); - // 设置背景选择器按钮点击监听器 - for (int id : sBgSelectorBtnsMap.keySet()) { - ImageView iv = (ImageView) findViewById(id); - iv.setOnClickListener(this); - } - - mFontSizeSelector = findViewById(R.id.font_size_selector); - // 设置字体大小选择器按钮点击监听器 - for (int id : sFontSizeBtnsMap.keySet()) { - View view = findViewById(id); - view.setOnClickListener(this); - } - ; - // 从偏好设置中读取字体大小 - mSharedPrefs = PreferenceManager.getDefaultSharedPreferences(this); - mFontSizeId = mSharedPrefs.getInt(PREFERENCE_FONT_SIZE, ResourceParser.BG_DEFAULT_FONT_SIZE); - // 修复存储在偏好设置中的字体大小资源ID的错误 - if (mFontSizeId >= TextAppearanceResources.getResourcesSize()) { - mFontSizeId = ResourceParser.BG_DEFAULT_FONT_SIZE; - } - // 初始化编辑列表 - mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list); - } - - /** - * 暂停时保存笔记数据并清除设置状态。 - */ - @Override - protected void onPause() { - super.onPause(); - // 保存笔记数据 - if (saveNote()) { - Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length()); - } - // 清除设置状态 - clearSettingState(); - } - - /** - * 更新小部件显示。 - */ - private void updateWidget() { - Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); - // 根据小部件类型设置对应的类 - if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { - intent.setClass(this, NoteWidgetProvider_2x.class); - } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) { - intent.setClass(this, NoteWidgetProvider_4x.class); - } else { - Log.e(TAG, "Unspported widget type"); - return; - } - - // 设置小部件ID - intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[]{ - mWorkingNote.getWidgetId() - }); - - // 发送广播更新小部件 - sendBroadcast(intent); - // 设置结果为OK - setResult(RESULT_OK, intent); - } - - - /** - * 点击事件的处理函数。 - * - * @param v 被点击的视图对象。 - */ - public void onClick(View v) { - int id = v.getId(); - // 如果点击的是设置背景颜色的按钮 - if (id == R.id.btn_set_bg_color) { - mNoteBgColorSelector.setVisibility(View.VISIBLE); - // 根据当前笔记的背景颜色，设置对应的色板按钮可见 - findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( - View.VISIBLE); - } else if (sBgSelectorBtnsMap.containsKey(id)) { - // 如果点击的是背景色板上的颜色 - findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( - View.GONE); // 隐藏当前选择的背景颜色 - mWorkingNote.setBgColorId(sBgSelectorBtnsMap.get(id)); // 更新笔记的背景颜色 - mNoteBgColorSelector.setVisibility(View.GONE); // 隐藏背景颜色选择器 - } else if (sFontSizeBtnsMap.containsKey(id)) { - // 如果点击的是字体大小按钮 - findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.GONE); // 隐藏当前选择的字体大小 - mFontSizeId = sFontSizeBtnsMap.get(id); // 更新选择的字体大小 - mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit(); // 保存选择的字体大小到SharedPreferences - findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); // 设置新选择的字体大小按钮为可见 - // 根据当前笔记是否为清单模式，进行相应的文本更新 - if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - getWorkingText(); - switchToListMode(mWorkingNote.getContent()); - } else { - mNoteEditor.setTextAppearance(this, - TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); - } - mFontSizeSelector.setVisibility(View.GONE); // 隐藏字体大小选择器 - } - } - - /** - * 按下返回键时的处理函数。 - */ - @Override - public void onBackPressed() { - // 尝试清除设置状态，如果成功，则不执行保存笔记操作 - if (clearSettingState()) { - return; - } - // 保存笔记并执行父类的onBackPressed()方法（结束当前Activity） - saveNote(); - super.onBackPressed(); - } - - /** - * 尝试清除设置状态（背景颜色选择或字体大小选择）。 - * - * @return 如果成功清除设置状态，返回true；否则返回false。 - */ - private boolean clearSettingState() { - // 如果背景颜色选择器可见，则隐藏它并返回true - if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) { - mNoteBgColorSelector.setVisibility(View.GONE); - return true; - } else if (mFontSizeSelector.getVisibility() == View.VISIBLE) { // 如果字体大小选择器可见，则隐藏它并返回true - mFontSizeSelector.setVisibility(View.GONE); - return true; - } - return false; // 没有可见的设置状态需要清除，返回false - } - - /** - * 当背景颜色发生变化时的处理函数。 - */ - public void onBackgroundColorChanged() { - // 根据当前笔记的背景颜色，设置对应的色板按钮可见，并更新编辑器及标题栏的背景颜色 - findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( - View.VISIBLE); - mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); - mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); - } - - /** - * 准备选项菜单的函数。 - * - * @param menu 选项菜单对象。 - * @return 总是返回true。 - */ - @Override - public boolean onPrepareOptionsMenu(Menu menu) { - // 如果Activity正在结束，则不进行任何操作 - if (isFinishing()) { - return true; - } - // 尝试清除设置状态 - clearSettingState(); - menu.clear(); // 清除菜单项 - // 根据笔记所属的文件夹，加载不同的菜单资源 - if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) { - getMenuInflater().inflate(R.menu.call_note_edit, menu); - } else { - getMenuInflater().inflate(R.menu.note_edit, menu); - } - // 根据当前笔记的清单模式，更新“清单模式”菜单项的标题 - if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode); - } else { - menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode); - } - // 根据笔记是否有提醒，更新“删除提醒”菜单项的可见性 - if (mWorkingNote.hasClockAlert()) { - menu.findItem(R.id.menu_alert).setVisible(false); - } else { - menu.findItem(R.id.menu_delete_remind).setVisible(false); - } - return true; - } - - - /** - * 处理选项菜单项的选择事件。 - * - * @param item 选中的菜单项 - * @return 总是返回true，表示事件已处理。 - */ - @Override - public boolean onOptionsItemSelected(MenuItem item) { - switch (item.getItemId()) { - case R.id.menu_new_note: - // 创建新笔记 - createNewNote(); - break; - case R.id.menu_delete: - // 显示删除笔记的确认对话框 - AlertDialog.Builder builder = new AlertDialog.Builder(this); - builder.setTitle(getString(R.string.alert_title_delete)); - builder.setIcon(android.R.drawable.ic_dialog_alert); - builder.setMessage(getString(R.string.alert_message_delete_note)); - builder.setPositiveButton(android.R.string.ok, - new DialogInterface.OnClickListener() { - public void onClick(DialogInterface dialog, int which) { - // 确认删除当前笔记并结束当前活动 - deleteCurrentNote(); - finish(); - } - }); - builder.setNegativeButton(android.R.string.cancel, null); - builder.show(); - break; - case R.id.menu_font_size: - // 显示字体大小选择器 - mFontSizeSelector.setVisibility(View.VISIBLE); - findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); - break; - case R.id.menu_list_mode: - // 切换笔记的列表模式 - mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ? - TextNote.MODE_CHECK_LIST : 0); - break; - case R.id.menu_share: - // 获取当前编辑的笔记内容并分享 - getWorkingText(); - sendTo(this, mWorkingNote.getContent()); - break; - case R.id.menu_send_to_desktop: - // 将笔记发送到桌面 - sendToDesktop(); - break; - case R.id.menu_alert: - // 设置提醒 - setReminder(); - break; - case R.id.menu_delete_remind: - // 删除提醒设置 - mWorkingNote.setAlertDate(0, false); - break; - default: - break; - } - return true; - } - - /** - * 弹出日期时间选择器，用于设置提醒时间。 - */ - private void setReminder() { - DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis()); - d.setOnDateTimeSetListener(new OnDateTimeSetListener() { - public void OnDateTimeSet(AlertDialog dialog, long date) { - // 用户设定时间后，设置提醒 - mWorkingNote.setAlertDate(date, true); - } - }); - d.show(); - } - - /** - * 分享笔记到支持 {@link Intent#ACTION_SEND} 操作和 {@text/plain} 类型的应用。 - * - * @param context 上下文 - * @param info 要分享的信息 - */ - private void sendTo(Context context, String info) { - Intent intent = new Intent(Intent.ACTION_SEND); - intent.putExtra(Intent.EXTRA_TEXT, info); - intent.setType("text/plain"); - context.startActivity(intent); - } - - /** - * 首先保存当前正在编辑的笔记，然后启动一个新的NoteEditActivity用于创建新笔记。 - */ - private void createNewNote() { - // 首先保存当前笔记 - saveNote(); - - // 安全地开始一个新的NoteEditActivity - finish(); - Intent intent = new Intent(this, NoteEditActivity.class); - intent.setAction(Intent.ACTION_INSERT_OR_EDIT); - intent.putExtra(Notes.INTENT_EXTRA_FOLDER_ID, mWorkingNote.getFolderId()); - startActivity(intent); - } - - - /** - * 删除当前正在编辑的笔记。 - * 如果笔记存在于数据库中，并且当前不是同步模式，将直接删除该笔记； - * 如果处于同步模式，则将笔记移动到回收站文件夹。 - */ - private void deleteCurrentNote() { - if (mWorkingNote.existInDatabase()) { - HashSet ids = new HashSet(); - long id = mWorkingNote.getNoteId(); - if (id != Notes.ID_ROOT_FOLDER) { - ids.add(id); - } else { - Log.d(TAG, "Wrong note id, should not happen"); - } - if (!isSyncMode()) { - // 非同步模式下直接删除笔记 - if (!DataUtils.batchDeleteNotes(getContentResolver(), ids)) { - Log.e(TAG, "Delete Note error"); - } - } else { - // 同步模式下将笔记移动到回收站 - if (!DataUtils.batchMoveToFolder(getContentResolver(), ids, Notes.ID_TRASH_FOLER)) { - Log.e(TAG, "Move notes to trash folder error, should not happens"); - } - } - } - mWorkingNote.markDeleted(true); - } - - /** - * 判断当前是否为同步模式。 - * 同步模式是指在设置中配置了同步账户名。 - * - * @return 如果配置了同步账户名返回true，否则返回false。 - */ - private boolean isSyncMode() { - return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0; - } - - /** - * 处理时钟提醒变更事件。 - * 首先检查当前笔记是否已保存，未保存则先保存。 - * 如果笔记存在，根据set参数设置或取消提醒。 - * 如果笔记不存在（即无有效ID），记录错误并提示用户输入内容。 - * - * @param date 提醒的日期时间戳 - * @param set 是否设置提醒 - */ - public void onClockAlertChanged(long date, boolean set) { - if (!mWorkingNote.existInDatabase()) { - saveNote(); - } - if (mWorkingNote.getNoteId() > 0) { - Intent intent = new Intent(this, AlarmReceiver.class); - intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mWorkingNote.getNoteId())); - PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, 0); - AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE)); - showAlertHeader(); - if (!set) { - alarmManager.cancel(pendingIntent); - } else { - alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent); - } - } else { - Log.e(TAG, "Clock alert setting error"); - showToast(R.string.error_note_empty_for_clock); - } - } - - /** - * 更新小部件显示。 - */ - public void onWidgetChanged() { - updateWidget(); - } - - /** - * 当删除某个编辑框中的文本时的处理逻辑。 - * 重新设置后续编辑框的索引，并将删除的文本添加到前一个或当前编辑框中。 - * - * @param index 被删除文本的编辑框索引 - * @param text 被删除的文本内容 - */ - public void onEditTextDelete(int index, String text) { - int childCount = mEditTextList.getChildCount(); - if (childCount == 1) { - return; - } - - for (int i = index + 1; i < childCount; i++) { - ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) - .setIndex(i - 1); - } - - mEditTextList.removeViewAt(index); - NoteEditText edit = null; - if (index == 0) { - edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById( - R.id.et_edit_text); - } else { - edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById( - R.id.et_edit_text); - } - int length = edit.length(); - edit.append(text); - edit.requestFocus(); - edit.setSelection(length); - } - - /** - * 当在编辑框中按下“Enter”键时的处理逻辑。 - * 在列表中添加一个新的编辑框，并重新设置后续编辑框的索引。 - * - * @param index 当前编辑框的索引 - * @param text 当前编辑框中的文本内容 - */ - public void onEditTextEnter(int index, String text) { - if (index > mEditTextList.getChildCount()) { - Log.e(TAG, "Index out of mEditTextList boundrary, should not happen"); - } - - View view = getListItem(text, index); - mEditTextList.addView(view, index); - NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); - edit.requestFocus(); - edit.setSelection(0); - for (int i = index + 1; i < mEditTextList.getChildCount(); i++) { - ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) - .setIndex(i); - } - } - - - /** - * 切换到列表模式。 - * 将文本分割成多行，并为每行创建一个列表项，展示在编辑文本列表中。 - * - * @param text 要转换成列表模式的文本，每行代表一个列表项。 - */ - private void switchToListMode(String text) { - // 清空当前的视图 - mEditTextList.removeAllViews(); - // 使用换行符分割文本，创建列表项 - String[] items = text.split("\n"); - int index = 0; - for (String item : items) { - // 忽略空行 - if (!TextUtils.isEmpty(item)) { - mEditTextList.addView(getListItem(item, index)); - index++; - } - } - // 添加一个空的列表项作为占位符 - mEditTextList.addView(getListItem("", index)); - // 请求焦点以便于编辑 - mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus(); - - // 隐藏编辑器，显示列表 - mNoteEditor.setVisibility(View.GONE); - mEditTextList.setVisibility(View.VISIBLE); - } - - /** - * 高亮显示查询结果。 - * 在给定的文本中，根据用户查询字符串高亮显示匹配的部分。 - * - * @param fullText 完整的文本。 - * @param userQuery 用户的查询字符串。 - * @return 包含高亮显示的文本的Spannable对象。 - */ - private Spannable getHighlightQueryResult(String fullText, String userQuery) { - SpannableString spannable = new SpannableString(fullText == null ? "" : fullText); - // 如果有查询字符串，则进行高亮处理 - if (!TextUtils.isEmpty(userQuery)) { - mPattern = Pattern.compile(userQuery); - Matcher m = mPattern.matcher(fullText); - int start = 0; - while (m.find(start)) { - // 设置高亮背景 - spannable.setSpan( - new BackgroundColorSpan(this.getResources().getColor( - R.color.user_query_highlight)), m.start(), m.end(), - Spannable.SPAN_INCLUSIVE_EXCLUSIVE); - start = m.end(); - } - } - return spannable; - } - - /** - * 创建列表项视图。 - * 为列表模式创建并配置一个包含文本编辑框和复选框的视图。 - * - * @param item 列表项的文本内容。 - * @param index 列表项的索引。 - * @return 配置好的列表项视图。 - */ - private View getListItem(String item, int index) { - // 加载列表项布局 - View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null); - final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); - // 设置文本样式 - edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); - CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); - // 复选框的监听器，用于切换文本的划线状态 - cb.setOnCheckedChangeListener(new OnCheckedChangeListener() { - public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { - if (isChecked) { - edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); - } else { - edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); - } - } - }); - - // 根据文本前缀设置复选框状态和文本内容 - if (item.startsWith(TAG_CHECKED)) { - cb.setChecked(true); - edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); - item = item.substring(TAG_CHECKED.length(), item.length()).trim(); - } else if (item.startsWith(TAG_UNCHECKED)) { - cb.setChecked(false); - edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); - item = item.substring(TAG_UNCHECKED.length(), item.length()).trim(); - } - - // 设置文本变化监听和索引 - edit.setOnTextViewChangeListener(this); - edit.setIndex(index); - // 设置带有查询结果高亮的文本 - edit.setText(getHighlightQueryResult(item, mUserQuery)); - return view; - } - - /** - * 根据文本内容是否为空，切换复选框的可见性。 - * - * @param index 列表项索引。 - * @param hasText 列表项是否包含文本。 - */ - public void onTextChange(int index, boolean hasText) { - if (index >= mEditTextList.getChildCount()) { - Log.e(TAG, "Wrong index, should not happen"); - return; - } - // 根据文本内容决定复选框的可见性 - if (hasText) { - mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE); - } else { - mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE); - } - } - - /** - * 在切换编辑模式和列表模式时更新UI。 - * - * @param oldMode 旧的编辑模式。 - * @param newMode 新的编辑模式。 - */ - public void onCheckListModeChanged(int oldMode, int newMode) { - // 切换到列表模式 - if (newMode == TextNote.MODE_CHECK_LIST) { - switchToListMode(mNoteEditor.getText().toString()); - } else { - // 切换回编辑模式 - if (!getWorkingText()) { - mWorkingNote.setWorkingText(mWorkingNote.getContent().replace(TAG_UNCHECKED + " ", - "")); - } - mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery)); - mEditTextList.setVisibility(View.GONE); - mNoteEditor.setVisibility(View.VISIBLE); - } - } - - /** - * 根据当前列表项的选中状态，构建并返回工作文本。 - * - * @return 是否有已选中的列表项。 - */ - private boolean getWorkingText() { - boolean hasChecked = false; - if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - StringBuilder sb = new StringBuilder(); - for (int i = 0; i < mEditTextList.getChildCount(); i++) { - View view = mEditTextList.getChildAt(i); - NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); - // 构建带有选中状态前缀的文本 - if (!TextUtils.isEmpty(edit.getText())) { - if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { - sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); - hasChecked = true; - } else { - sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n"); - } - } - } - mWorkingNote.setWorkingText(sb.toString()); - } else { - mWorkingNote.setWorkingText(mNoteEditor.getText().toString()); - } - return hasChecked; - } - - /** - * 保存笔记。 - * 更新笔记内容并保存。 - * - * @return 是否成功保存笔记。 - */ - private boolean saveNote() { - getWorkingText(); - boolean saved = mWorkingNote.saveNote(); - if (saved) { - // 设置结果为成功，以便外部调用者知道保存操作的状态 - setResult(RESULT_OK); - } - return saved; - } - - - /** - * 将当前编辑的笔记发送到桌面。首先会检查当前编辑的笔记是否已存在于数据库中， - * 如果不存在，则先保存。如果存在，会创建一个快捷方式放在桌面。 - */ - private void sendToDesktop() { - // 检查当前编辑的笔记是否存在于数据库，若不存在则先保存 - if (!mWorkingNote.existInDatabase()) { - saveNote(); - } - - // 如果笔记存在于数据库（有noteId），则创建快捷方式 - if (mWorkingNote.getNoteId() > 0) { - Intent sender = new Intent(); - Intent shortcutIntent = new Intent(this, NoteEditActivity.class); - shortcutIntent.setAction(Intent.ACTION_VIEW); - shortcutIntent.putExtra(Intent.EXTRA_UID, mWorkingNote.getNoteId()); - sender.putExtra(Intent.EXTRA_SHORTCUT_INTENT, shortcutIntent); - sender.putExtra(Intent.EXTRA_SHORTCUT_NAME, - makeShortcutIconTitle(mWorkingNote.getContent())); - sender.putExtra(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, - Intent.ShortcutIconResource.fromContext(this, R.drawable.icon_app)); - sender.putExtra("duplicate", true); - sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT"); - showToast(R.string.info_note_enter_desktop); - sendBroadcast(sender); - } else { - // 如果用户未输入任何内容，无法创建快捷方式，提醒用户输入内容 - Log.e(TAG, "Send to desktop error"); - showToast(R.string.error_note_empty_for_send_to_desktop); - } - } - - /** - * 根据笔记内容生成快捷方式的标题。移除内容中的已选和未选标签，并确保标题长度不超过上限。 - * - * @param content 符合快捷方式图标标题要求的笔记内容 - * @return 标题字符串 - */ - private String makeShortcutIconTitle(String content) { - content = content.replace(TAG_CHECKED, ""); - content = content.replace(TAG_UNCHECKED, ""); - return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0, - SHORTCUT_ICON_TITLE_MAX_LEN) : content; - } - - /** - * 显示一个Toast消息。 - * - * @param resId 资源ID，指向要显示的字符串 - */ - private void showToast(int resId) { - showToast(resId, Toast.LENGTH_SHORT); - } - - /** - * 显示一个指定时长的Toast消息。 - * - * @param resId 资源ID，指向要显示的字符串 - * @param duration 显示时长，可以是Toast.LENGTH_SHORT或Toast.LENGTH_LONG - */ - private void showToast(int resId, int duration) { - Toast.makeText(this, resId, duration).show(); - } - -} diff --git a/src/ui/NoteEditText.java b/src/ui/NoteEditText.java deleted file mode 100644 index 8e3e59f..0000000 --- a/src/ui/NoteEditText.java +++ /dev/null @@ -1,267 +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.ui; - -import android.content.Context; -import android.graphics.Rect; -import android.text.Layout; -import android.text.Selection; -import android.text.Spanned; -import android.text.TextUtils; -import android.text.style.URLSpan; -import android.util.AttributeSet; -import android.util.Log; -import android.view.ContextMenu; -import android.view.KeyEvent; -import android.view.MenuItem; -import android.view.MenuItem.OnMenuItemClickListener; -import android.view.MotionEvent; -import android.widget.EditText; - -import net.micode.notes.R; - -import java.util.HashMap; -import java.util.Map; - -/** - * 自定义的可编辑文本视图，支持文本变化监听、删除和新增文本事件。 - */ -public class NoteEditText extends EditText { - private static final String TAG = "NoteEditText"; - private int mIndex; // 当前文本视图的索引 - private int mSelectionStartBeforeDelete; // 删除操作前的选择起始位置 - - private static final String SCHEME_TEL = "tel:"; - private static final String SCHEME_HTTP = "http:"; - private static final String SCHEME_EMAIL = "mailto:"; - - // URL方案与对应操作资源ID的映射 - private static final Map sSchemaActionResMap = new HashMap(); - - static { - sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel); - sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web); - sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email); - } - - /** - * 文本视图变化监听接口。 - */ - public interface OnTextViewChangeListener { - /** - * 当按下删除键且文本为空时，删除当前文本视图。 - */ - void onEditTextDelete(int index, String text); - - /** - * 当按下回车键时，新增一个文本视图。 - */ - void onEditTextEnter(int index, String text); - - /** - * 当文本变化时，隐藏或显示项目选项。 - */ - void onTextChange(int index, boolean hasText); - } - - private OnTextViewChangeListener mOnTextViewChangeListener; - - /** - * 构造函数，初始化编辑文本视图。 - * - * @param context 上下文对象 - */ - public NoteEditText(Context context) { - super(context, null); - mIndex = 0; - } - - /** - * 设置当前文本视图的索引。 - * - * @param index 当前文本视图的索引 - */ - public void setIndex(int index) { - mIndex = index; - } - - /** - * 设置文本视图变化监听器。 - * - * @param listener 文本视图变化监听器 - */ - public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { - mOnTextViewChangeListener = listener; - } - - /** - * 构造函数，初始化编辑文本视图。 - * - * @param context 上下文对象 - * @param attrs 属性集 - */ - public NoteEditText(Context context, AttributeSet attrs) { - super(context, attrs, android.R.attr.editTextStyle); - } - - /** - * 构造函数，初始化编辑文本视图。 - * - * @param context 上下文对象 - * @param attrs 属性集 - * @param defStyle 样式 - */ - public NoteEditText(Context context, AttributeSet attrs, int defStyle) { - super(context, attrs, defStyle); - } - - /** - * 处理触摸事件，调整光标位置。 - */ - @Override - public boolean onTouchEvent(MotionEvent event) { - switch (event.getAction()) { - case MotionEvent.ACTION_DOWN: - // 计算触摸位置相对于文本的偏移量，并调整光标位置 - int x = (int) event.getX(); - int y = (int) event.getY(); - x -= getTotalPaddingLeft(); - y -= getTotalPaddingTop(); - x += getScrollX(); - y += getScrollY(); - - Layout layout = getLayout(); - int line = layout.getLineForVertical(y); - int off = layout.getOffsetForHorizontal(line, x); - Selection.setSelection(getText(), off); - break; - } - - return super.onTouchEvent(event); - } - - /** - * 处理键盘按下事件。 - */ - @Override - public boolean onKeyDown(int keyCode, KeyEvent event) { - switch (keyCode) { - case KeyEvent.KEYCODE_ENTER: - // 处理回车键事件，准备新增文本视图 - if (mOnTextViewChangeListener != null) { - return false; - } - break; - case KeyEvent.KEYCODE_DEL: - // 记录删除操作前的选择位置 - mSelectionStartBeforeDelete = getSelectionStart(); - break; - default: - break; - } - return super.onKeyDown(keyCode, event); - } - - /** - * 处理键盘弹起事件。 - */ - @Override - public boolean onKeyUp(int keyCode, KeyEvent event) { - switch (keyCode) { - case KeyEvent.KEYCODE_DEL: - // 处理删除键事件，若为首个文本且非空，则删除当前文本 - if (mOnTextViewChangeListener != null) { - if (0 == mSelectionStartBeforeDelete && mIndex != 0) { - mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString()); - return true; - } - } else { - Log.d(TAG, "OnTextViewChangeListener was not seted"); - } - break; - case KeyEvent.KEYCODE_ENTER: - // 处理回车键事件，新增文本视图 - if (mOnTextViewChangeListener != null) { - int selectionStart = getSelectionStart(); - String text = getText().subSequence(selectionStart, length()).toString(); - setText(getText().subSequence(0, selectionStart)); - mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); - } else { - Log.d(TAG, "OnTextViewChangeListener was not seted"); - } - break; - default: - break; - } - return super.onKeyUp(keyCode, event); - } - - /** - * 当焦点变化时，通知文本变化情况。 - */ - @Override - protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) { - if (mOnTextViewChangeListener != null) { - if (!focused && TextUtils.isEmpty(getText())) { - mOnTextViewChangeListener.onTextChange(mIndex, false); - } else { - mOnTextViewChangeListener.onTextChange(mIndex, true); - } - } - super.onFocusChanged(focused, direction, previouslyFocusedRect); - } - - /** - * 创建上下文菜单，支持点击URL跳转。 - */ - @Override - protected void onCreateContextMenu(ContextMenu menu) { - if (getText() instanceof Spanned) { - int selStart = getSelectionStart(); - int selEnd = getSelectionEnd(); - - int min = Math.min(selStart, selEnd); - int max = Math.max(selStart, selEnd); - - final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); - if (urls.length == 1) { - int defaultResId = 0; - for (String schema : sSchemaActionResMap.keySet()) { - if (urls[0].getURL().indexOf(schema) >= 0) { - defaultResId = sSchemaActionResMap.get(schema); - break; - } - } - - if (defaultResId == 0) { - defaultResId = R.string.note_link_other; - } - - menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener( - new OnMenuItemClickListener() { - public boolean onMenuItemClick(MenuItem item) { - // 跳转到URL指向的页面 - urls[0].onClick(NoteEditText.this); - return true; - } - }); - } - } - super.onCreateContextMenu(menu); - } -} - diff --git a/src/widget/NoteWidgetProvider.java b/src/widget/NoteWidgetProvider.java deleted file mode 100644 index c746e27..0000000 --- a/src/widget/NoteWidgetProvider.java +++ /dev/null @@ -1,159 +0,0 @@ -package net.micode.notes.widget; - -// 导入必要的 Android 和应用相关的类和包 -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; - -// 抽象类 NoteWidgetProvider，继承自 AppWidgetProvider，用于定义笔记小部件的逻辑 -public abstract class NoteWidgetProvider extends AppWidgetProvider { - - // 定义数据库查询时所需的列名数组 - public static final String[] PROJECTION = new String[]{ - NoteColumns.ID, // 笔记的唯一 ID - NoteColumns.BG_COLOR_ID, // 笔记的背景颜色 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"; - - // 覆写 onDeleted 方法，当小部件被用户移除时调用 - @Override - public void onDeleted(Context context, int[] appWidgetIds) { - // 创建一个 ContentValues 对象，用于更新数据库 - ContentValues values = new ContentValues(); - // 将小部件 ID 设置为无效 ID，以便从数据库中移除相关关联 - values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID); - // 遍历被删除的小部件 ID 数组 - for (int i = 0; i < appWidgetIds.length; i++) { - // 更新数据库中与该小部件关联的记录 - context.getContentResolver().update(Notes.CONTENT_NOTE_URI, - values, - NoteColumns.WIDGET_ID + "=?", // WHERE 子句：匹配指定小部件 ID - new String[]{String.valueOf(appWidgetIds[i])}); // WHERE 参数 - } - } - - // 私有方法：根据小部件 ID 查询对应的笔记信息 - private Cursor getNoteWidgetInfo(Context context, int widgetId) { - // 执行数据库查询，返回与指定小部件 ID 相关的笔记 - return context.getContentResolver().query(Notes.CONTENT_NOTE_URI, - PROJECTION, // 查询的列 - NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?", // 条件：小部件 ID 匹配且不在垃圾箱中 - new String[]{String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER)}, // 参数值 - null); // 排序方式（此处为 null，即不排序） - } - - // 受保护方法：更新小部件显示内容的公共接口 - protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { - // 默认调用私有方法，并将隐私模式设置为 false - update(context, appWidgetManager, appWidgetIds, false); - } - - // 私有方法：根据隐私模式，更新小部件显示内容 - private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds, - boolean privacyMode) { - // 遍历所有小部件 ID - for (int i = 0; i < appWidgetIds.length; i++) { - // 如果小部件 ID 无效，则跳过 - if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) { - // 获取默认的背景颜色 ID - int bgId = ResourceParser.getDefaultBgId(context); - // 初始化笔记摘要为空字符串 - String snippet = ""; - // 创建一个 Intent，指定跳转到 NoteEditActivity - Intent intent = new Intent(context, NoteEditActivity.class); - // 设置 Intent 的标志，确保活动以单一实例模式启动 - intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP); - // 将小部件 ID 和类型作为额外数据加入 Intent - intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]); - intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType()); - - // 查询数据库，获取与当前小部件 ID 关联的笔记信息 - 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; - } - // 从查询结果中获取笔记摘要和背景颜色 ID - snippet = c.getString(COLUMN_SNIPPET); - bgId = c.getInt(COLUMN_BG_COLOR_ID); - // 将笔记 ID 添加到 Intent 的额外数据中 - intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID)); - // 设置 Intent 的操作类型为查看 - intent.setAction(Intent.ACTION_VIEW); - } else { - // 如果查询结果为空，则设置默认的内容和操作类型 - snippet = context.getResources().getString(R.string.widget_havenot_content); - intent.setAction(Intent.ACTION_INSERT_OR_EDIT); - } - - // 如果 Cursor 对象不为空，则关闭以释放资源 - if (c != null) { - c.close(); - } - - // 创建 RemoteViews 对象，用于更新小部件的布局 - RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId()); - // 设置小部件的背景图片资源 - rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId)); - // 将背景颜色 ID 添加到 Intent 的额外数据中 - intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId); - - // 声明 PendingIntent 对象，用于处理小部件的点击事件 - PendingIntent pendingIntent = null; - if (privacyMode) { - // 如果处于隐私模式，则显示隐私模式文本 - rv.setTextViewText(R.id.widget_text, - context.getString(R.string.widget_under_visit_mode)); - // 设置 PendingIntent，点击时跳转到 NotesListActivity - 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 = PendingIntent.getActivity(context, appWidgetIds[i], intent, - PendingIntent.FLAG_UPDATE_CURRENT); - } - - // 为小部件的文本区域设置点击事件 - rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent); - // 更新小部件显示内容 - appWidgetManager.updateAppWidget(appWidgetIds[i], rv); - } - } - } - - // 抽象方法：获取背景资源的 ID，具体实现由子类提供 - protected abstract int getBgResourceId(int bgId); - - // 抽象方法：获取小部件布局的资源 ID，具体实现由子类提供 - protected abstract int getLayoutId(); - - // 抽象方法：获取小部件的类型，具体实现由子类提供 - protected abstract int getWidgetType(); -} diff --git a/src/widget/NoteWidgetProvider_2x.java b/src/widget/NoteWidgetProvider_2x.java deleted file mode 100644 index 9a547d2..0000000 --- a/src/widget/NoteWidgetProvider_2x.java +++ /dev/null @@ -1,76 +0,0 @@ -/* - * 版权声明：MiCode开源社区（www.micode.net） - * - * 本代码遵循Apache 2.0开源协议 - * 如需获取完整的授权条款，请访问：http://www.apache.org/licenses/LICENSE-2.0.html - * - * 代码开始 - */ - -// 定义包名，组织代码模块化管理 -package net.micode.notes.widget; - -// 导入Android小部件相关类和应用的资源类 -import android.appwidget.AppWidgetManager; -import android.content.Context; - -import net.micode.notes.R; // 导入资源文件R类，用于访问布局和其他资源 -import net.micode.notes.data.Notes; // 导入笔记相关的数据类 -import net.micode.notes.tool.ResourceParser; // 导入资源解析工具类 - -/** - * 2x版本的小部件提供者类。 - * 该类继承自 NoteWidgetProvider，专门处理 2x2 尺寸的笔记小部件。 - */ -public class NoteWidgetProvider_2x extends NoteWidgetProvider { - /** - * 当系统需要更新小部件时，会调用此方法。 - * 此方法通过调用父类的 `update` 方法来处理小部件更新的逻辑。 - * - * @param context 上下文环境，用于获取应用程序资源和操作。 - * @param appWidgetManager 管理当前应用中所有小部件的 AppWidgetManager 实例。 - * @param appWidgetIds 当前需要更新的小部件 ID 数组。 - */ - @Override - public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { - // 调用父类的 update 方法，完成小部件的更新逻辑 - super.update(context, appWidgetManager, appWidgetIds); - } - - /** - * 获取小部件布局的资源 ID。 - * 此方法返回当前小部件所使用的布局文件的资源 ID。 - * 该布局文件定义了小部件在屏幕上的外观。 - * - * @return 布局资源的 ID，对应 `res/layout/widget_2x.xml` 文件。 - */ - @Override - protected int getLayoutId() { - return R.layout.widget_2x; // 返回 2x 小部件的布局资源 ID - } - - /** - * 根据背景 ID 获取对应的背景资源 ID。 - * 小部件有不同的背景样式（如不同颜色或主题），通过背景 ID 选择对应的资源。 - * - * @param bgId 背景资源的索引 ID，表示选择哪一种背景样式。 - * @return 背景资源的 ID，用于设置小部件的背景。 - */ - @Override - protected int getBgResourceId(int bgId) { - // 使用 ResourceParser 工具类，根据背景 ID 获取 2x 小部件的背景资源 ID - return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); - } - - /** - * 获取当前小部件的类型。 - * 该方法返回一个常量，用于标识当前小部件的类型。 - * 不同尺寸的小部件有不同的类型常量，例如 2x 和 4x 小部件。 - * - * @return 小部件类型的常量值，表示当前为 2x 尺寸的小部件。 - */ - @Override - protected int getWidgetType() { - return Notes.TYPE_WIDGET_2X; // 返回表示 2x 小部件类型的常量 - } -} diff --git a/src/widget/NoteWidgetProvider_4x.java b/src/widget/NoteWidgetProvider_4x.java deleted file mode 100644 index 29c55e0..0000000 --- a/src/widget/NoteWidgetProvider_4x.java +++ /dev/null @@ -1,74 +0,0 @@ -/* - * 版权声明：MiCode开源社区（www.micode.net） - * - * 本代码遵循Apache 2.0开源协议 - * 详细授权信息请访问：http://www.apache.org/licenses/LICENSE-2.0 - */ - -// 定义代码所在的包，用于组织代码模块化 -package net.micode.notes.widget; - -// 导入小部件和应用程序相关的类 -import android.appwidget.AppWidgetManager; -import android.content.Context; - -import net.micode.notes.R; // 导入应用资源文件 R，访问布局和其他资源 -import net.micode.notes.data.Notes; // 导入笔记相关的常量和数据类 -import net.micode.notes.tool.ResourceParser; // 导入工具类，用于解析小部件资源 - -/** - * 4x大小的便签小部件提供者类，继承自 NoteWidgetProvider。 - * 专门用于处理 4x 大小的便签小部件的更新和相关操作。 - */ -public class NoteWidgetProvider_4x extends NoteWidgetProvider { - - /** - * 当系统请求更新小部件时，会调用此方法。 - * 该方法通过调用父类的 `update` 方法来处理小部件的更新逻辑。 - * - * @param context 上下文环境，提供应用程序的全局信息和操作能力。 - * @param appWidgetManager 小部件管理器，用于管理当前应用中所有的小部件。 - * @param appWidgetIds 需要更新的小部件 ID 数组，包含多个小部件的唯一标识符。 - */ - @Override - public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) { - // 调用父类的 update 方法，完成通用的更新逻辑 - super.update(context, appWidgetManager, appWidgetIds); - } - - /** - * 获取小部件的布局资源 ID。 - * 布局资源定义了小部件的界面结构，例如显示的文本和背景图片等。 - * - * @return 返回 4x 小部件的布局资源 ID，对应 `res/layout/widget_4x.xml` 文件。 - */ - @Override - protected int getLayoutId() { - return R.layout.widget_4x; // 指定用于 4x 小部件的布局资源 - } - - /** - * 根据背景 ID 获取对应的背景资源 ID。 - * 小部件可以有不同的背景样式，例如不同的颜色或主题，通过背景 ID 来选择。 - * - * @param bgId 背景的索引 ID，表示不同的背景样式。 - * @return 返回与背景 ID 对应的背景资源 ID，用于设置小部件的背景。 - */ - @Override - protected int getBgResourceId(int bgId) { - // 使用 ResourceParser 工具类，根据背景 ID 获取 4x 小部件的背景资源 ID - return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId); - } - - /** - * 获取当前小部件的类型标识。 - * 该方法返回一个整型常量，用于标识当前小部件的类型。 - * 在应用中可以通过该标识区分不同的小部件类型，例如 4x 和 2x 小部件。 - * - * @return 返回小部件类型的整型标识，表示这是一个 4x 大小的小部件。 - */ - @Override - protected int getWidgetType() { - return Notes.TYPE_WIDGET_4X; // 返回 4x 小部件类型的常量 - } -}