lz

src/data/Contact.java

@@ -0,0 +1,91 @@
+
+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 {
+    /**
+     * 联系人缓存：键为电话号码，值为联系人姓名
+     * 注意：该HashMap非线程安全，多线程环境下可能存在竞态条件
+     */
+    private static HashMap<String, String> sContactCache;
+    private static final String TAG = "Contact";
+
+    /**
+     * 联系人查询条件模板
+     * 包含三个关键条件：
+     * 1. PHONE_NUMBERS_EQUAL函数用于比较电话号码（处理格式差异）
+     * 2. MIME类型过滤确保只查询电话号码记录
+     * 3. 子查询过滤有效的联系人ID（通过phone_lookup表的min_match字段）
+     * 注意："+"符号会在运行时被替换为实际的min_match值
+     */
+    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 应用上下文，用于访问ContentResolver
+     * @param phoneNumber 待查询的电话号码
+     * @return 对应的联系人姓名，如果未找到则返回null
+     */
+    public static String getContact(Context context, String phoneNumber) {
+        // 初始化缓存（注意：非线程安全的懒汉式初始化）
+        if(sContactCache == null) {
+            sContactCache = new HashMap<String, String>();
+        }
+
+        // 优先从缓存中获取结果
+        if(sContactCache.containsKey(phoneNumber)) {
+            return sContactCache.get(phoneNumber);
+        }
+
+        // 构建实际查询条件：将模板中的"+"替换为规范化后的电话号码匹配模式
+        String selection = CALLER_ID_SELECTION.replace("+",
+                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+        
+        // 执行数据库查询
+        Cursor cursor = context.getContentResolver().query(
+                Data.CONTENT_URI,              // 查询联系人数据的URI
+                new String [] { Phone.DISPLAY_NAME }, // 只需要返回联系人姓名
+                selection,                     // 使用构建好的查询条件
+                new String[] { phoneNumber },  // 查询参数（对应selection中的?）
+                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资源被关闭，避免内存泄漏
+                cursor.close();
+            }
+        } else {
+            // 未找到匹配的联系人记录
+            Log.d(TAG, "No contact matched with number:" + phoneNumber);
+            return null;
+        }
+    }
+}

src/data/Notes.java

@@ -0,0 +1,219 @@
+/*
+ * 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;
+
+/**
+ * 笔记应用的核心数据模型类
+ * 定义了数据库表结构、内容提供者URI、常量值和数据列接口
+ * 用于在整个应用中统一数据访问和操作规范
+ */
+public class Notes {
+    /** ContentProvider的权限标识符 */
+    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;     // 系统文件夹
+
+    /**
+     * 系统文件夹的特殊标识符
+     * {@link Notes#ID_ROOT_FOLDER } 是默认根文件夹
+     * {@link Notes#ID_TEMPARAY_FOLDER } 用于存放未分类笔记
+     * {@link Notes#ID_CALL_RECORD_FOLDER} 用于存储通话记录笔记
+     * {@link Notes#ID_TRASH_FOLER} 是回收站文件夹
+     */
+    public static final int ID_ROOT_FOLDER = 0;
+    public static final int ID_TEMPARAY_FOLDER = -1;
+    public static final int ID_CALL_RECORD_FOLDER = -2;
+    public static final int ID_TRASH_FOLER = -3;
+
+    /**
+     * Intent传递的额外数据键名
+     * 用于在Activity/Fragment之间传递笔记相关参数
+     */
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+
+    /**
+     * 桌面小部件类型常量
+     * 用于标识不同尺寸和功能的笔记小部件
+     */
+    public static final int TYPE_WIDGET_INVALIDE      = -1;    // 无效类型
+    public static final int TYPE_WIDGET_2X            = 0;     // 2x尺寸小部件
+    public static final int TYPE_WIDGET_4X            = 1;     // 4x尺寸小部件
+
+    /**
+     * 数据类型常量
+     * 定义了不同类型笔记的MIME类型
+     */
+    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 */
+        public static final String ID = "_id";
+        
+        /** 父文件夹ID（用于组织笔记层级结构） */
+        public static final String PARENT_ID = "parent_id";
+        
+        /** 创建时间戳（毫秒） */
+        public static final String CREATED_DATE = "created_date";
+        
+        /** 修改时间戳（毫秒） */
+        public static final String MODIFIED_DATE = "modified_date";
+        
+        /** 提醒时间戳（毫秒） */
+        public static final String ALERTED_DATE = "alert_date";
+        
+        /** 摘要内容（文件夹名称或笔记摘要） */
+        public static final String SNIPPET = "snippet";
+        
+        /** 关联的桌面小部件ID */
+        public static final String WIDGET_ID = "widget_id";
+        
+        /** 桌面小部件类型 */
+        public static final String WIDGET_TYPE = "widget_type";
+        
+        /** 背景颜色ID */
+        public static final String BG_COLOR_ID = "bg_color_id";
+        
+        /** 是否有附件标志 */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+        
+        /** 文件夹包含的笔记数量（仅对文件夹有效） */
+        public static final String NOTES_COUNT = "notes_count";
+        
+        /** 类型字段（对应TYPE_NOTE、TYPE_FOLDER等值） */
+        public static final String TYPE = "type";
+        
+        /** 同步ID（用于与服务器同步） */
+        public static final String SYNC_ID = "sync_id";
+        
+        /** 本地修改标志（标记需要同步的数据） */
+        public static final String LOCAL_MODIFIED = "local_modified";
+        
+        /** 原始父文件夹ID（用于从回收站恢复时定位原位置） */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+        
+        /** Google Tasks集成ID */
+        public static final String GTASK_ID = "gtask_id";
+        
+        /** 版本号（用于数据版本控制） */
+        public static final String VERSION = "version";
+    }
+
+    /**
+     * 数据记录表的列定义接口
+     * 定义了笔记附件数据的通用字段结构
+     */
+    public interface DataColumns {
+        /** 主键ID */
+        public static final String ID = "_id";
+        
+        /** MIME类型（标识数据类型） */
+        public static final String MIME_TYPE = "mime_type";
+        
+        /** 关联的笔记ID */
+        public static final String NOTE_ID = "note_id";
+        
+        /** 创建时间戳 */
+        public static final String CREATED_DATE = "created_date";
+        
+        /** 修改时间戳 */
+        public static final String MODIFIED_DATE = "modified_date";
+        
+        /** 数据内容（具体含义取决于MIME类型） */
+        public static final String CONTENT = "content";
+        
+        /** 通用数据字段1（含义取决于MIME类型，通常为整数） */
+        public static final String DATA1 = "data1";
+        
+        /** 通用数据字段2（含义取决于MIME类型，通常为整数） */
+        public static final String DATA2 = "data2";
+        
+        /** 通用数据字段3（含义取决于MIME类型，通常为文本） */
+        public static final String DATA3 = "data3";
+        
+        /** 通用数据字段4（含义取决于MIME类型，通常为文本） */
+        public static final String DATA4 = "data4";
+        
+        /** 通用数据字段5（含义取决于MIME类型，通常为文本） */
+        public static final String DATA5 = "data5";
+    }
+
+    /**
+     * 文本笔记数据类型
+     * 继承自DataColumns并定义了文本笔记特有的字段和常量
+     */
+    public static final class TextNote implements DataColumns {
+        /** 文本模式字段（0表示普通文本，1表示待办列表） */
+        public static final String MODE = DATA1;
+        
+        /** 待办列表模式常量 */
+        public static final int MODE_CHECK_LIST = 1;
+        
+        /** 文本笔记集合的MIME类型 */
+        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";
+        
+        /** 文本笔记的内容URI */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
+    }
+
+    /**
+     * 通话记录笔记数据类型
+     * 继承自DataColumns并定义了通话记录特有的字段和常量
+     */
+    public static final class CallNote implements DataColumns {
+        /** 通话时间戳 */
+        public static final String CALL_DATE = DATA1;
+        
+        /** 电话号码 */
+        public static final String PHONE_NUMBER = DATA3;
+        
+        /** 通话记录集合的MIME类型 */
+        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";
+        
+        /** 通话记录的内容URI */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+    }
+}

src/data/NotesDatabaseHelper.java

@@ -0,0 +1,450 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import android.util.Log;
+
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+/**
+ * 笔记应用的SQLite数据库辅助类
+ * 负责数据库创建、版本管理和表结构维护
+ * 使用单例模式确保全局只有一个数据库连接实例
+ */
+public class NotesDatabaseHelper extends SQLiteOpenHelper {
+    /** 数据库文件名 */
+    private static final String DB_NAME = "note.db";
+    
+    /** 当前数据库版本 */
+    private static final int DB_VERSION = 4;
+
+    /**
+     * 表名常量接口
+     */
+    public interface TABLE {
+        public static final String NOTE = "note";     // 笔记主表
+        public static final String DATA = "data";     // 笔记附件数据表
+    }
+
+    /** 日志标签 */
+    private static final String TAG = "NotesDatabaseHelper";
+    
+    /** 单例实例 */
+    private static NotesDatabaseHelper mInstance;
+
+    /**
+     * 创建笔记主表的SQL语句
+     * 包含笔记基本信息：标题、创建时间、修改时间、提醒时间等
+     */
+    private static final String CREATE_NOTE_TABLE_SQL =
+        "CREATE TABLE " + TABLE.NOTE + "(" +
+            NoteColumns.ID + " INTEGER PRIMARY KEY," +
+            NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
+            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
+        ")";
+
+    /**
+     * 创建数据附表的SQL语句
+     * 包含笔记的附件数据：文本内容、图片、音频等
+     */
+    private static final String CREATE_DATA_TABLE_SQL =
+        "CREATE TABLE " + TABLE.DATA + "(" +
+            DataColumns.ID + " INTEGER PRIMARY KEY," +
+            DataColumns.MIME_TYPE + " TEXT NOT NULL," +
+            DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA1 + " INTEGER," +
+            DataColumns.DATA2 + " INTEGER," +
+            DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
+        ")";
+
+    /**
+     * 创建数据附表的索引SQL语句
+     * 加速通过笔记ID查询附件数据的操作
+     */
+    private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
+        "CREATE INDEX IF NOT EXISTS note_id_index ON " +
+        TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
+
+    /**
+     * 当笔记被移动到新文件夹时，增加目标文件夹的笔记计数
+     */
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER increase_folder_count_on_update "+
+        " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+        "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+        " END";
+
+    /**
+     * 当笔记从文件夹移出时，减少原文件夹的笔记计数
+     */
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER decrease_folder_count_on_update " +
+        " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+        "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+        "  AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
+        " END";
+
+    /**
+     * 当新笔记插入到文件夹时，增加文件夹的笔记计数
+     */
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
+        "CREATE TRIGGER increase_folder_count_on_insert " +
+        " AFTER INSERT ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+        "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+        " END";
+
+    /**
+     * 当笔记被删除时，减少所属文件夹的笔记计数
+     */
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER decrease_folder_count_on_delete " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+        "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+        "  AND " + NoteColumns.NOTES_COUNT + ">0;" +
+        " END";
+
+    /**
+     * 当插入文本类型的数据时，更新笔记的摘要内容
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_insert " +
+        " AFTER INSERT ON " + TABLE.DATA +
+        " WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+        "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 当更新文本类型的数据时，更新笔记的摘要内容
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_update " +
+        " AFTER UPDATE ON " + TABLE.DATA +
+        " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+        "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 当删除文本类型的数据时，清空笔记的摘要内容
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_delete " +
+        " AFTER delete ON " + TABLE.DATA +
+        " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=''" +
+        "  WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 当删除笔记时，自动删除关联的所有数据
+     */
+    private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER delete_data_on_delete " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN" +
+        "  DELETE FROM " + TABLE.DATA +
+        "   WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
+
+    /**
+     * 当删除文件夹时，自动删除该文件夹下的所有笔记
+     */
+    private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER folder_delete_notes_on_delete " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN" +
+        "  DELETE FROM " + TABLE.NOTE +
+        "   WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
+
+    /**
+     * 当文件夹被移动到回收站时，自动将其下的所有笔记也移动到回收站
+     */
+    private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
+        "CREATE TRIGGER folder_move_notes_on_trash " +
+        " AFTER UPDATE ON " + TABLE.NOTE +
+        " WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+        "  WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
+
+    /**
+     * 构造函数
+     * @param context 应用上下文
+     */
+    public NotesDatabaseHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+
+    /**
+     * 创建笔记表
+     * @param db SQLite数据库实例
+     */
+    public void createNoteTable(SQLiteDatabase db) {
+        db.execSQL(CREATE_NOTE_TABLE_SQL);
+        reCreateNoteTableTriggers(db);
+        createSystemFolder(db);
+        Log.d(TAG, "note table has been created");
+    }
+
+    /**
+     * 重新创建笔记表的触发器
+     * @param db SQLite数据库实例
+     */
+    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);
+    }
+
+    /**
+     * 创建系统文件夹（根文件夹、临时文件夹、通话记录文件夹、回收站）
+     * @param db SQLite数据库实例
+     */
+    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);
+    }
+
+    /**
+     * 创建数据表
+     * @param db SQLite数据库实例
+     */
+    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");
+    }
+
+    /**
+     * 重新创建数据表的触发器
+     * @param db SQLite数据库实例
+     */
+    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);
+    }
+
+    /**
+     * 获取单例实例（线程安全）
+     * @param context 应用上下文
+     * @return NotesDatabaseHelper实例
+     */
+    static synchronized NotesDatabaseHelper getInstance(Context context) {
+        if (mInstance == null) {
+            mInstance = new NotesDatabaseHelper(context);
+        }
+        return mInstance;
+    }
+
+    /**
+     * 数据库首次创建时调用
+     * 创建所有表和系统文件夹
+     * @param db SQLite数据库实例
+     */
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    /**
+     * 数据库版本升级时调用
+     * 处理从旧版本到新版本的数据库结构变更
+     * @param db SQLite数据库实例
+     * @param oldVersion 旧版本号
+     * @param newVersion 新版本号
+     */
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        boolean reCreateTriggers = false;
+        boolean skipV2 = false;
+
+        // 处理从版本1升级到版本2
+        if (oldVersion == 1) {
+            upgradeToV2(db);
+            skipV2 = true; // 版本2升级包含了版本3的部分升级
+            oldVersion++;
+        }
+
+        // 处理从版本2升级到版本3
+        if (oldVersion == 2 && !skipV2) {
+            upgradeToV3(db);
+            reCreateTriggers = true;
+            oldVersion++;
+        }
+
+        // 处理从版本3升级到版本4
+        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");
+        }
+    }
+
+    /**
+     * 升级到版本2
+     * 重建所有表（破坏性升级，数据会丢失）
+     * @param db SQLite数据库实例
+     */
+    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);
+    }
+
+    /**
+     * 升级到版本3
+     * 1. 添加GTask集成所需的gtask_id列
+     * 2. 添加回收站文件夹
+     * @param db SQLite数据库实例
+     */
+    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);
+    }
+
+    /**
+     * 升级到版本4
+     * 添加版本控制列，用于数据同步
+     * @param db SQLite数据库实例
+     */
+    private void upgradeToV4(SQLiteDatabase db) {
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+                + " INTEGER NOT NULL DEFAULT 0");
+    }
+}

src/data/NotesProvider.java

@@ -0,0 +1,394 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.data;
+
+import android.app.SearchManager;
+import android.content.ContentProvider;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Intent;
+import android.content.UriMatcher;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import android.net.Uri;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.NotesDatabaseHelper.TABLE;
+
+/**
+ * 笔记应用的内容提供者
+ * 负责管理笔记数据的访问接口，实现了标准的CRUD操作和搜索功能
+ * 通过ContentProvider机制对外提供数据访问服务
+ */
+public class NotesProvider extends ContentProvider {
+    /** URI匹配器，用于识别不同的URI请求类型 */
+    private static final UriMatcher mMatcher;
+    
+    /** 数据库帮助类实例 */
+    private NotesDatabaseHelper mHelper;
+    
+    /** 日志标签 */
+    private static final String TAG = "NotesProvider";
+    
+    /** URI匹配码常量 */
+    private static final int URI_NOTE            = 1;     // 笔记集合
+    private static final int URI_NOTE_ITEM       = 2;     // 单个笔记
+    private static final int URI_DATA            = 3;     // 数据集合
+    private static final int URI_DATA_ITEM       = 4;     // 单个数据
+    private static final int URI_SEARCH          = 5;     // 搜索请求
+    private static final int URI_SEARCH_SUGGEST  = 6;     // 搜索建议请求
+
+    static {
+        // 初始化URI匹配器
+        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
+    }
+
+    /**
+     * 笔记搜索投影定义
+     * 将笔记数据映射到搜索建议所需的列
+     * 替换换行符并去除首尾空格，优化搜索结果显示
+     */
+    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+        + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+        + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+        + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+        + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
+
+    /**
+     * 笔记搜索查询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;
+
+    /**
+     * 初始化内容提供者
+     * @return 初始化成功返回true
+     */
+    @Override
+    public boolean onCreate() {
+        mHelper = NotesDatabaseHelper.getInstance(getContext());
+        return true;
+    }
+
+    /**
+     * 查询数据
+     * @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;
+                // 从不同的URI格式中提取搜索关键字
+                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;
+        
+        // 根据URI类型执行不同的插入操作
+        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);
+        }
+        
+        // 通知数据变化
+        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);
+    }
+
+    /**
+     * 删除数据
+     * @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;
+        
+        // 根据URI类型执行不同的删除操作
+        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);
+                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);
+        }
+        
+        // 通知数据变化
+        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;
+        
+        // 根据URI类型执行不同的更新操作
+        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);
+        }
+
+        // 通知数据变化
+        if (count > 0) {
+            if (updateData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+
+    /**
+     * 解析查询条件，处理额外的筛选条件
+     * @param selection 原始查询条件
+     * @return 解析后的查询条件
+     */
+    private String parseSelection(String selection) {
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
+    }
+
+    /**
+     * 增加笔记的版本号，用于数据同步
+     * @param id 笔记ID，如果为-1则根据条件更新
+     * @param selection 更新条件
+     * @param selectionArgs 更新参数
+     */
+    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 ");
+
+        // 构建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;
+            // 替换SQL中的?占位符为实际参数值
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+
+        mHelper.getWritableDatabase().execSQL(sql.toString());
+    }
+
+    /**
+     * 获取URI对应的MIME类型
+     * @param uri 请求的URI
+     * @return MIME类型字符串
+     */
+    @Override
+    public String getType(Uri uri) {
+        // TODO Auto-generated method stub
+        return null;
+    }
+}

src/tool/BackupUtils.java

@@ -0,0 +1,393 @@
+/*
+ * 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
+ */
+
+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;
+
+/**
+ * 笔记应用的内容提供者
+ * 负责管理笔记数据的访问接口，实现了标准的CRUD操作和搜索功能
+ * 通过ContentProvider机制对外提供数据访问服务
+ */
+public class NotesProvider extends ContentProvider {
+    /** URI匹配器，用于识别不同的URI请求类型 */
+    private static final UriMatcher mMatcher;
+    
+    /** 数据库帮助类实例 */
+    private NotesDatabaseHelper mHelper;
+    
+    /** 日志标签 */
+    private static final String TAG = "NotesProvider";
+    
+    /** URI匹配码常量 */
+    private static final int URI_NOTE            = 1;     // 笔记集合
+    private static final int URI_NOTE_ITEM       = 2;     // 单个笔记
+    private static final int URI_DATA            = 3;     // 数据集合
+    private static final int URI_DATA_ITEM       = 4;     // 单个数据
+    private static final int URI_SEARCH          = 5;     // 搜索请求
+    private static final int URI_SEARCH_SUGGEST  = 6;     // 搜索建议请求
+
+    static {
+        // 初始化URI匹配器
+        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
+    }
+
+    /**
+     * 笔记搜索投影定义
+     * 将笔记数据映射到搜索建议所需的列
+     * 替换换行符并去除首尾空格，优化搜索结果显示
+     */
+    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+        + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+        + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+        + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+        + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
+
+    /**
+     * 笔记搜索查询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;
+
+    /**
+     * 初始化内容提供者
+     * @return 初始化成功返回true
+     */
+    @Override
+    public boolean onCreate() {
+        mHelper = NotesDatabaseHelper.getInstance(getContext());
+        return true;
+    }
+
+    /**
+     * 查询数据
+     * @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;
+                // 从不同的URI格式中提取搜索关键字
+                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;
+        
+        // 根据URI类型执行不同的插入操作
+        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);
+        }
+        
+        // 通知数据变化
+        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);
+    }
+
+    /**
+     * 删除数据
+     * @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;
+        
+        // 根据URI类型执行不同的删除操作
+        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);
+                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);
+        }
+        
+        // 通知数据变化
+        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;
+        
+        // 根据URI类型执行不同的更新操作
+        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);
+        }
+
+        // 通知数据变化
+        if (count > 0) {
+            if (updateData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+
+    /**
+     * 解析查询条件，处理额外的筛选条件
+     * @param selection 原始查询条件
+     * @return 解析后的查询条件
+     */
+    private String parseSelection(String selection) {
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
+    }
+
+    /**
+     * 增加笔记的版本号，用于数据同步
+     * @param id 笔记ID，如果为-1则根据条件更新
+     * @param selection 更新条件
+     * @param selectionArgs 更新参数
+     */
+    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 ");
+
+        // 构建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;
+            // 替换SQL中的?占位符为实际参数值
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+
+        mHelper.getWritableDatabase().execSQL(sql.toString());
+    }
+
+    /**
+     * 获取URI对应的MIME类型
+     * @param uri 请求的URI
+     * @return MIME类型字符串
+     */
+    @Override
+    public String getType(Uri uri) {
+        // TODO Auto-generated method stub
+        return null;
+    }
+}

src/tool/DataUtils.java

@@ -0,0 +1,377 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+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;
+
+/**
+ * 笔记数据操作工具类
+ * 提供笔记数据的批量操作、查询和验证等功能
+ */
+public class DataUtils {
+    public static final String TAG = "DataUtils";
+    
+    /**
+     * 批量删除笔记
+     * @param resolver ContentResolver实例
+     * @param ids 要删除的笔记ID集合
+     * @return 删除成功返回true，失败返回false
+     */
+    public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
+        if (ids == null) {
+            Log.d(TAG, "the ids is null");
+            return true;
+        }
+        if (ids.size() == 0) {
+            Log.d(TAG, "no id is in the hashset");
+            return true;
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        for (long id : ids) {
+            if(id == Notes.ID_ROOT_FOLDER) {
+                Log.e(TAG, "Don't delete system folder root");
+                continue;
+            }
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            operationList.add(builder.build());
+        }
+        try {
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "delete notes failed, ids:" + ids.toString());
+                return false;
+            }
+            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;
+    }
+
+    /**
+     * 将笔记移动到指定文件夹
+     * @param resolver ContentResolver实例
+     * @param id 要移动的笔记ID
+     * @param srcFolderId 源文件夹ID
+     * @param desFolderId 目标文件夹ID
+     */
+    public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.PARENT_ID, desFolderId);
+        values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
+        values.put(NoteColumns.LOCAL_MODIFIED, 1);
+        resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
+    }
+
+    /**
+     * 批量将笔记移动到指定文件夹
+     * @param resolver ContentResolver实例
+     * @param ids 要移动的笔记ID集合
+     * @param folderId 目标文件夹ID
+     * @return 移动成功返回true，失败返回false
+     */
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
+            long folderId) {
+        if (ids == null) {
+            Log.d(TAG, "the ids is null");
+            return true;
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        for (long id : ids) {
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            builder.withValue(NoteColumns.PARENT_ID, folderId);
+            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, "delete 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;
+    }
+
+    /**
+     * 获取用户创建的文件夹数量（不包含系统文件夹）
+     * @param resolver ContentResolver实例
+     * @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 ContentResolver实例
+     * @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),
+                null,
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
+                new String [] {String.valueOf(type)},
+                null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查笔记是否存在于数据库中
+     * @param resolver ContentResolver实例
+     * @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),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查数据项是否存在于数据库中
+     * @param resolver ContentResolver实例
+     * @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),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查可见文件夹中是否存在指定名称的文件夹
+     * @param resolver ContentResolver实例
+     * @param name 文件夹名称
+     * @return 存在返回true，否则返回false
+     */
+    public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
+                NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
+                " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
+                " AND " + NoteColumns.SNIPPET + "=?",
+                new String[] { name }, null);
+        boolean exist = false;
+        if(cursor != null) {
+            if(cursor.getCount() > 0) {
+                exist = true;
+            }
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 获取指定文件夹下的所有便签小部件信息
+     * @param resolver ContentResolver实例
+     * @param folderId 文件夹ID
+     * @return 小部件属性集合
+     */
+    public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
+        Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE },
+                NoteColumns.PARENT_ID + "=?",
+                new String[] { String.valueOf(folderId) },
+                null);
+
+        HashSet<AppWidgetAttribute> set = null;
+        if (c != null) {
+            if (c.moveToFirst()) {
+                set = new HashSet<AppWidgetAttribute>();
+                do {
+                    try {
+                        AppWidgetAttribute widget = new AppWidgetAttribute();
+                        widget.widgetId = c.getInt(0);
+                        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 ContentResolver实例
+     * @param noteId 笔记ID
+     * @return 电话号码，如果不存在则返回空字符串
+     */
+    public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String [] { CallNote.PHONE_NUMBER },
+                CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
+                new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
+                null);
+
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                return cursor.getString(0);
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "Get call number fails " + e.toString());
+            } finally {
+                cursor.close();
+            }
+        }
+        return "";
+    }
+
+    /**
+     * 根据电话号码和通话日期获取通话记录笔记ID
+     * @param resolver ContentResolver实例
+     * @param phoneNumber 电话号码
+     * @param callDate 通话日期
+     * @return 笔记ID，如果不存在则返回0
+     */
+    public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String [] { CallNote.NOTE_ID },
+                CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+                + CallNote.PHONE_NUMBER + ",?)",
+                new String [] { String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber },
+                null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                try {
+                    return cursor.getLong(0);
+                } catch (IndexOutOfBoundsException e) {
+                    Log.e(TAG, "Get call note id fails " + e.toString());
+                }
+            }
+            cursor.close();
+        }
+        return 0;
+    }
+
+    /**
+     * 根据笔记ID获取笔记摘要
+     * @param resolver ContentResolver实例
+     * @param noteId 笔记ID
+     * @return 笔记摘要内容
+     */
+    public static String getSnippetById(ContentResolver resolver, long noteId) {
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String [] { NoteColumns.SNIPPET },
+                NoteColumns.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;
+    }
+}
+ 

src/tool/GTaskStringUtils.java

@@ -0,0 +1,80 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+/**
+ * 该类定义了与Google Tasks服务交互时用到的JSON键名常量和特殊字符串。
+ * 主要用于在MiCode Notes应用和Google Tasks之间进行数据同步。
+ */
+public class GTaskStringUtils {
+
+    // 通用操作相关的JSON字段
+    public final static String GTASK_JSON_ACTION_ID = "action_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";     // 更新操作
+
+    // 用户和客户端相关的JSON字段
+    public final static String GTASK_JSON_CREATOR_ID = "creator_id";         // 创建者ID
+    public final static String GTASK_JSON_CLIENT_VERSION = "client_version"; // 客户端版本
+
+    // 任务和列表相关的JSON字段
+    public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";     // 子实体
+    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";               // Google Tasks 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"; // 元数据笔记名称
+}

src/tool/ResourceParser.java

@@ -0,0 +1,277 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.Context;
+import android.preference.PreferenceManager;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+/**
+ * 资源解析工具类，用于管理和获取笔记应用中各种资源的引用
+ * 包括背景颜色、文本大小、布局样式等资源的映射和获取方法
+ */
+public class ResourceParser {
+
+    // 笔记背景颜色常量定义，对应不同的颜色主题
+    public static final int YELLOW           = 0;
+    public static final int BLUE             = 1;
+    public static final int WHITE            = 2;
+    public static final int GREEN            = 3;
+    public static final int RED              = 4;
+
+    // 默认背景颜色为黄色
+    public static final int BG_DEFAULT_COLOR = YELLOW;
+
+    // 文本大小级别常量定义
+    public static final int TEXT_SMALL       = 0;
+    public static final int TEXT_MEDIUM      = 1;
+    public static final int TEXT_LARGE       = 2;
+    public static final int TEXT_SUPER       = 3;
+
+    // 默认文本大小为中等
+    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;
+
+    /**
+     * 笔记编辑界面背景资源管理类
+     * 提供获取笔记编辑界面不同颜色主题的背景和标题栏资源
+     */
+    public static class NoteBgResources {
+        // 笔记编辑界面背景资源数组，按颜色索引对应
+        private final static int [] BG_EDIT_RESOURCES = new int [] {
+            R.drawable.edit_yellow,
+            R.drawable.edit_blue,
+            R.drawable.edit_white,
+            R.drawable.edit_green,
+            R.drawable.edit_red
+        };
+
+        // 笔记编辑界面标题栏背景资源数组，按颜色索引对应
+        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
+            R.drawable.edit_title_yellow,
+            R.drawable.edit_title_blue,
+            R.drawable.edit_title_white,
+            R.drawable.edit_title_green,
+            R.drawable.edit_title_red
+        };
+
+        /**
+         * 根据颜色ID获取笔记编辑界面背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgResource(int id) {
+            return BG_EDIT_RESOURCES[id];
+        }
+
+        /**
+         * 根据颜色ID获取笔记编辑界面标题栏背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的标题栏背景资源ID
+         */
+        public static int getNoteTitleBgResource(int id) {
+            return BG_EDIT_TITLE_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 获取默认背景颜色ID
+     * 根据用户设置决定是返回随机颜色还是默认颜色
+     * @param context 应用上下文
+     * @return 背景颜色ID
+     */
+    public static int getDefaultBgId(Context context) {
+        // 检查用户是否开启了"随机背景颜色"设置
+        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
+                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
+            // 随机选择一种背景颜色
+            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
+        } else {
+            // 返回默认背景颜色
+            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
+        };
+
+        /**
+         * 获取列表中首项笔记的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgFirstRes(int id) {
+            return BG_FIRST_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表中末项笔记的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgLastRes(int id) {
+            return BG_LAST_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表中单独项笔记的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgSingleRes(int id) {
+            return BG_SINGLE_RESOURCES[id];
+        }
+
+        /**
+         * 获取列表中中间项笔记的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgNormalRes(int id) {
+            return BG_NORMAL_RESOURCES[id];
+        }
+
+        /**
+         * 获取文件夹项的背景资源
+         * @return 文件夹背景资源ID
+         */
+        public static int getFolderBgRes() {
+            return R.drawable.list_folder;
+        }
+    }
+
+    /**
+     * 桌面小部件背景资源管理类
+     * 提供获取不同尺寸(2x和4x)小部件的背景资源
+     */
+    public static class WidgetBgResources {
+        // 2x尺寸小部件的背景资源数组，按颜色索引对应
+        private final static int [] BG_2X_RESOURCES = new int [] {
+            R.drawable.widget_2x_yellow,
+            R.drawable.widget_2x_blue,
+            R.drawable.widget_2x_white,
+            R.drawable.widget_2x_green,
+            R.drawable.widget_2x_red,
+        };
+
+        /**
+         * 获取2x尺寸小部件的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getWidget2xBgResource(int id) {
+            return BG_2X_RESOURCES[id];
+        }
+
+        // 4x尺寸小部件的背景资源数组，按颜色索引对应
+        private final static int [] BG_4X_RESOURCES = new int [] {
+            R.drawable.widget_4x_yellow,
+            R.drawable.widget_4x_blue,
+            R.drawable.widget_4x_white,
+            R.drawable.widget_4x_green,
+            R.drawable.widget_4x_red
+        };
+
+        /**
+         * 获取4x尺寸小部件的背景资源
+         * @param id 颜色ID，使用ResourceParser中定义的颜色常量
+         * @return 对应的背景资源ID
+         */
+        public static int getWidget4xBgResource(int id) {
+            return BG_4X_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 文本外观资源管理类
+     * 提供获取不同文本大小级别的文本样式资源
+     */
+    public static class TextAppearanceResources {
+        // 文本外观样式资源数组，按文本大小级别索引对应
+        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
+            R.style.TextAppearanceNormal,
+            R.style.TextAppearanceMedium,
+            R.style.TextAppearanceLarge,
+            R.style.TextAppearanceSuper
+        };
+
+        /**
+         * 根据文本大小ID获取对应的文本外观样式资源
+         * 包含一个安全检查，防止因错误存储的ID导致数组越界
+         * @param id 文本大小ID，使用ResourceParser中定义的文本大小常量
+         * @return 对应的文本外观样式资源ID
+         */
+        public static int getTexAppearanceResource(int id) {
+            /**
+             * HACKME: Fix bug of store the resource id in shared preference.
+             * The id may larger than the length of resources, in this case,
+             * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
+             */
+            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
+                return BG_DEFAULT_FONT_SIZE;
+            }
+            return TEXTAPPEARANCE_RESOURCES[id];
+        }
+
+        /**
+         * 获取文本外观资源数组的大小
+         * @return 资源数组的长度
+         */
+        public static int getResourcesSize() {
+            return TEXTAPPEARANCE_RESOURCES.length;
+        }
+    }
+}

src/widget/NoteWidgetProvider.java

@@ -0,0 +1,209 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 除非符合许可协议，否则不得使用本文件。
+ * 您可以在以下地址获取许可证副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 软件按"原样"分发，不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解具体的权限和限制。
+ */
+
+package net.micode.notes.widget;
+
+import android.app.PendingIntent;
+import android.appwidget.AppWidgetManager;
+import android.appwidget.AppWidgetProvider;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.Intent;
+import android.database.Cursor;
+import android.util.Log;
+import android.widget.RemoteViews;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.tool.ResourceParser;
+import net.micode.notes.ui.NoteEditActivity;
+import net.micode.notes.ui.NotesListActivity;
+
+/**
+ * 笔记桌面小部件基类（抽象类）
+ * 提供所有尺寸小部件的通用逻辑，具体尺寸实现由子类继承扩展
+ * 负责小部件的数据绑定、布局更新、点击事件处理等核心功能
+ */
+public abstract class NoteWidgetProvider extends AppWidgetProvider {
+
+    // 数据库查询投影（指定需要查询的字段）
+    public static final String[] PROJECTION = new String[]{
+        NoteColumns.ID,          // 笔记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"; // 日志标签
+
+    /**
+     * 当小部件被删除时回调
+     * 功能：清除数据库中与被删除小部件关联的记录
+     * @param context 应用上下文
+     * @param appWidgetIds 被删除的小部件ID数组
+     */
+    @Override
+    public void onDeleted(Context context, int[] appWidgetIds) {
+        ContentValues values = new ContentValues();
+        // 将关联的笔记记录的widget_id标记为无效（-1）
+        values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
+        for (int appWidgetId : appWidgetIds) {
+            // 更新数据库：删除与widget_id关联的笔记记录
+            context.getContentResolver().update(
+                Notes.CONTENT_NOTE_URI,    // 笔记内容URI
+                values,                    // 更新的值（设置widget_id为无效）
+                NoteColumns.WIDGET_ID + "=?",  // 条件：widget_id等于当前ID
+                new String[]{String.valueOf(appWidgetId)}  // 参数值
+            );
+        }
+    }
+
+    /**
+     * 获取与小部件关联的笔记信息
+     * @param context 应用上下文
+     * @param widgetId 小部件ID
+     * @return 包含笔记信息的Cursor（字段：ID、背景色ID、摘要）
+     */
+    private Cursor getNoteWidgetInfo(Context context, int widgetId) {
+        return context.getContentResolver().query(
+            Notes.CONTENT_NOTE_URI,        // 笔记内容URI
+            PROJECTION,                    // 查询字段
+            // 条件：widget_id匹配且不属于废纸篓（parent_id != 废纸篓ID）
+            NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+            new String[]{
+                String.valueOf(widgetId),          // widget_id参数
+                String.valueOf(Notes.ID_TRASH_FOLER) // 排除废纸篓的parent_id
+            },
+            null                             // 排序方式（默认）
+        );
+    }
+
+    /**
+     * 更新小部件（公共入口）
+     * @param context 应用上下文
+     * @param appWidgetManager 小部件管理器
+     * @param appWidgetIds 需要更新的小部件ID数组
+     */
+    protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        update(context, appWidgetManager, appWidgetIds, false); // 调用私有更新方法（非隐私模式）
+    }
+
+    /**
+     * 核心更新逻辑（支持隐私模式）
+     * @param context 应用上下文
+     * @param appWidgetManager 小部件管理器
+     * @param appWidgetIds 小部件ID数组
+     * @param privacyMode 是否为隐私模式（控制显示内容）
+     */
+    private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
+                        boolean privacyMode) {
+        for (int appWidgetId : appWidgetIds) {
+            if (appWidgetId == AppWidgetManager.INVALID_APPWIDGET_ID) {
+                continue; // 跳过无效ID
+            }
+
+            int bgId = ResourceParser.getDefaultBgId(context); // 获取默认背景色ID
+            String snippet = ""; // 笔记摘要
+
+            // 创建点击小部件时的跳转Intent
+            Intent intent = new Intent(context, NoteEditActivity.class);
+            intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP); // 确保单例启动
+            intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetId); // 传递小部件ID
+            intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType()); // 传递小部件类型（由子类实现）
+
+            // 查询与小部件关联的笔记信息
+            Cursor c = getNoteWidgetInfo(context, appWidgetId);
+            if (c != null && c.moveToFirst()) {
+                if (c.getCount() > 1) {
+                    // 异常处理：同一widget_id关联多条记录（日志警告）
+                    Log.e(TAG, "Multiple message with same widget id:" + appWidgetId);
+                    c.close();
+                    return;
+                }
+
+                // 解析查询结果
+                snippet = c.getString(COLUMN_SNIPPET); // 摘要
+                bgId = c.getInt(COLUMN_BG_COLOR_ID); // 背景色ID
+                intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID)); // 笔记ID
+                intent.setAction(Intent.ACTION_VIEW); // 操作类型：查看笔记
+            } else {
+                // 无关联笔记时的默认显示
+                snippet = context.getResources().getString(R.string.widget_havenot_content);
+                intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 操作类型：新建笔记
+            }
+
+            if (c != null) {
+                c.close(); // 关闭Cursor释放资源
+            }
+
+            // 创建小部件视图（布局由子类实现）
+            RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
+            // 设置背景资源（由子类实现不同尺寸的资源获取）
+            rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
+            intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId); // 传递背景色ID到编辑页面
+
+            // 创建点击事件的PendingIntent
+            PendingIntent pendingIntent;
+            if (privacyMode) {
+                // 隐私模式：显示提示文本，点击跳转到笔记列表
+                rv.setTextViewText(R.id.widget_text, context.getString(R.string.widget_under_visit_mode));
+                pendingIntent = PendingIntent.getActivity(
+                    context,
+                    appWidgetId,
+                    new Intent(context, NotesListActivity.class),
+                    PendingIntent.FLAG_UPDATE_CURRENT
+                );
+            } else {
+                // 正常模式：显示笔记摘要，点击跳转到编辑页面
+                rv.setTextViewText(R.id.widget_text, snippet);
+                pendingIntent = PendingIntent.getActivity(
+                    context,
+                    appWidgetId,
+                    intent,
+                    PendingIntent.FLAG_UPDATE_CURRENT
+                );
+            }
+
+            // 绑定点击事件
+            rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
+            // 更新小部件视图
+            appWidgetManager.updateAppWidget(appWidgetId, rv);
+        }
+    }
+
+    // --------------------- 抽象方法（由子类实现） --------------------- //
+
+    /**
+     * 获取背景资源ID（由子类实现不同尺寸的资源映射）
+     * @param bgId 背景色ID（来自ResourceParser的常量）
+     * @return 对应的背景Drawable资源ID
+     */
+    protected abstract int getBgResourceId(int bgId);
+
+    /**
+     * 获取小部件布局资源ID（由子类指定具体布局文件）
+     * @return 布局资源ID（如R.layout.widget_2x）
+     */
+    protected abstract int getLayoutId();
+
+    /**
+     * 获取小部件类型标识（由子类指定类型常量）
+     * @return 类型常量（如Notes.TYPE_WIDGET_2X）
+     */
+    protected abstract int getWidgetType();
+}

src/widget/NoteWidgetProvider_2x.java

@@ -0,0 +1,59 @@
+
+
+package net.micode.notes.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.content.Context;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+/**
+ * 2x尺寸笔记桌面小部件提供者
+ * 负责管理和更新2x大小的笔记小部件，继承自NoteWidgetProvider基类
+ */
+public class NoteWidgetProvider_2x extends NoteWidgetProvider {
+
+    /**
+     * 小部件更新回调方法
+     * 当小部件需要更新时调用，如首次添加到桌面或定期更新时
+     * @param context 应用上下文
+     * @param appWidgetManager 小部件管理器
+     * @param appWidgetIds 需要更新的小部件ID数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        // 调用父类的更新方法处理小部件更新逻辑
+        super.update(context, appWidgetManager, appWidgetIds);
+    }
+
+    /**
+     * 获取小部件布局资源ID
+     * @return 2x小部件的布局资源ID
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_2x;
+    }
+
+    /**
+     * 根据背景颜色ID获取对应的背景资源ID
+     * @param bgId 背景颜色ID，定义在ResourceParser中
+     * @return 对应的背景资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        // 从资源解析器获取2x小部件的背景资源
+        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
+    }
+
+    /**
+     * 获取小部件类型
+     * @return 小部件类型常量，用于标识2x尺寸的小部件
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_2X;
+    }
+}

src/widget/NoteWidgetProvider_4x.java

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * 除非符合许可协议，否则不得使用本文件。
+ * 您可以在以下地址获取许可证副本：
+ *
+ *        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;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+/**
+ * 4x尺寸笔记桌面小部件提供者
+ * 继承自NoteWidgetProvider基类，负责管理4x大小的笔记小部件
+ */
+public class NoteWidgetProvider_4x extends NoteWidgetProvider {
+
+    /**
+     * 小部件更新回调方法
+     * 当小部件需要更新时触发（如添加到桌面、定时更新等）
+     * @param context 应用上下文
+     * @param appWidgetManager 小部件管理器
+     * @param appWidgetIds 需要更新的小部件ID数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        // 调用父类更新逻辑处理通用操作（如数据加载、布局更新）
+        super.update(context, appWidgetManager, appWidgetIds);
+    }
+
+    /**
+     * 获取小部件对应的布局资源ID
+     * @return 4x尺寸小部件的布局文件资源ID（R.layout.widget_4x）
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_4x;
+    }
+
+    /**
+     * 根据背景颜色ID获取对应的背景资源
+     * @param bgId 背景颜色ID（来自ResourceParser定义的常量）
+     * @return 4x小部件对应的背景Drawable资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        // 通过资源解析器获取4x尺寸专用的背景资源
+        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
+    }
+
+    /**
+     * 获取小部件类型标识
+     * @return 小部件类型常量（对应Notes.TYPE_WIDGET_4X，表示4x尺寸）
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_4X;
+    }
+}