java

src/net/micode/notes/data/Contact.java

@@ -0,0 +1,79 @@
+
+
+// 定义一个Contact类，用于处理联系人相关信息
+package net.micode.notes.data;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.provider.ContactsContract.CommonDataKinds.Phone;
+import android.provider.ContactsContract.Data;
+import android.telephony.PhoneNumberUtils;
+import android.util.Log;
+
+import java.util.HashMap;
+
+public class Contact {
+    // 定义一个静态HashMap来缓存联系人信息，以提高查询效率
+    private static HashMap<String, String> sContactCache;
+    // 定义日志输出的标签
+    private static final String TAG = "Contact";
+
+    // 定义查询联系人的SQL语句模板
+    private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
+    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+    + " AND " + Data.RAW_CONTACT_ID + " IN "
+            + "(SELECT raw_contact_id "
+            + " FROM phone_lookup"
+            + " WHERE min_match = '+')";
+
+    /**
+     * 根据电话号码获取联系人名称
+     * 
+     * @param context 上下文对象，用于访问内容提供者
+     * @param phoneNumber 电话号码
+     * @return 如果找到匹配的联系人，则返回联系人名称；否则返回null
+     */
+    public static String getContact(Context context, String phoneNumber) {
+        // 检查缓存是否为空，如果为空则初始化
+        if(sContactCache == null) {
+            sContactCache = new HashMap<String, String>();
+        }
+
+        // 检查缓存中是否已经存在该电话号码对应的联系人名称
+        if(sContactCache.containsKey(phoneNumber)) {
+            return sContactCache.get(phoneNumber);
+        }
+
+        // 根据电话号码构建查询联系人的SQL语句
+        String selection = CALLER_ID_SELECTION.replace("+",
+                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+        // 执行查询
+        Cursor cursor = context.getContentResolver().query(
+                Data.CONTENT_URI,
+                new String [] { Phone.DISPLAY_NAME },
+                selection,
+                new String[] { phoneNumber },
+                null);
+
+        // 处理查询结果
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                // 获取联系人名称，并存入缓存中
+                String name = cursor.getString(0);
+                sContactCache.put(phoneNumber, name);
+                return name;
+            } catch (IndexOutOfBoundsException e) {
+                // 日志输出异常信息
+                Log.e(TAG, " Cursor get string error " + e.toString());
+                return null;
+            } finally {
+                // 关闭游标
+                cursor.close();
+            }
+        } else {
+            // 如果没有找到匹配的联系人，输出日志信息并返回null
+            Log.d(TAG, "No contact matched with number:" + phoneNumber);
+            return null;
+        }
+    }
+}

src/net/micode/notes/data/Notes.java

@@ -0,0 +1,341 @@
+package net.micode.notes.data;
+
+以下是为 `Notes.java` 文件生成的中文注释：
+
+        ```java
+        /*
+         * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+         *
+         * 版权所有，遵循 Apache License 2.0 许可证。
+         * 您可以从 http://www.apache.org/licenses/LICENSE-2.0 获取许可证副本。
+         */
+
+        package net.micode.notes.data;
+
+import android.net.Uri;
+
+/**
+ * Notes 类用于定义笔记和文件夹的相关常量、Uri 和接口。
+ */
+public class Notes {
+    /**
+     * 内容提供者的权威名称。
+     */
+    public static final String AUTHORITY = "micode_notes";
+
+    /**
+     * 日志标签。
+     */
+    public static final String TAG = "Notes";
+
+    /**
+     * 笔记类型。
+     */
+    public static final int TYPE_NOTE = 0;
+
+    /**
+     * 文件夹类型。
+     */
+    public static final int TYPE_FOLDER = 1;
+
+    /**
+     * 系统类型。
+     */
+    public static final int TYPE_SYSTEM = 2;
+
+    /**
+     * 系统文件夹的 ID。
+     * {@link Notes#ID_ROOT_FOLDER } 是默认文件夹。
+     * {@link Notes#ID_TEMPARAY_FOLDER } 是未归属文件夹的笔记。
+     * {@link Notes#ID_CALL_RECORD_FOLDER} 是存储通话记录的文件夹。
+     */
+    public static final int ID_ROOT_FOLDER = 0;
+    public static final int ID_TEMPARAY_FOLDER = -1;
+    public static final int ID_CALL_RECORD_FOLDER = -2;
+    public static final int ID_TRASH_FOLER = -3;
+
+    /**
+     * Intent 额外数据键值对。
+     */
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+
+    /**
+     * 小部件类型。
+     */
+    public static final int TYPE_WIDGET_INVALIDE = -1;
+    public static final int TYPE_WIDGET_2X = 0;
+    public static final int TYPE_WIDGET_4X = 1;
+
+    /**
+     * 数据常量类，包含笔记和通话记录的内容类型。
+     */
+    public static class DataConstants {
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
+    }
+
+    /**
+     * 查询所有笔记和文件夹的 Uri。
+     */
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
+
+    /**
+     * 查询数据的 Uri。
+     */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+
+    /**
+     * 笔记或文件夹的列名接口。
+     */
+    public interface NoteColumns {
+        /**
+         * 行的唯一 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 笔记或文件夹的父级 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String PARENT_ID = "parent_id";
+
+        /**
+         * 创建日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最后修改日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * 提醒日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String ALERTED_DATE = "alert_date";
+
+        /**
+         * 文件夹名称或笔记文本内容。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String SNIPPET = "snippet";
+
+        /**
+         * 笔记的小部件 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String WIDGET_ID = "widget_id";
+
+        /**
+         * 笔记的小部件类型。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String WIDGET_TYPE = "widget_type";
+
+        /**
+         * 笔记的背景颜色 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id";
+
+        /**
+         * 是否有附件。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+
+        /**
+         * 文件夹中的笔记数量。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String NOTES_COUNT = "notes_count";
+
+        /**
+         * 文件类型：文件夹或笔记。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String TYPE = "type";
+
+        /**
+         * 最后同步 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String SYNC_ID = "sync_id";
+
+        /**
+         * 是否本地已修改。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";
+
+        /**
+         * 移动到临时文件夹之前的原始父级 ID。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+
+        /**
+         * Google 任务 ID。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String GTASK_ID = "gtask_id";
+
+        /**
+         * 版本代码。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String VERSION = "version";
+    }
+
+    /**
+     * 数据列名接口。
+     */
+    public interface DataColumns {
+        /**
+         * 行的唯一 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 该项的 MIME 类型。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String MIME_TYPE = "mime_type";
+
+        /**
+         * 所属笔记的引用 ID。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String NOTE_ID = "note_id";
+
+        /**
+         * 创建日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最后修改日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * 数据内容。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String CONTENT = "content";
+
+        /**
+         * 泛型数据列，用于整数类型。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String DATA1 = "data1";
+
+        /**
+         * 泛型数据列，用于整数类型。
+         * <P> 类型: INTEGER </P>
+         */
+        public static final String DATA2 = "data2";
+
+        /**
+         * 泛型数据列，用于文本类型。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String DATA3 = "data3";
+
+        /**
+         * 泛型数据列，用于文本类型。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String DATA4 = "data4";
+
+        /**
+         * 泛型数据列，用于文本类型。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String DATA5 = "data5";
+    }
+
+    /**
+     * 文本笔记类，实现 DataColumns 接口。
+     */
+    public static final class TextNote implements DataColumns {
+        /**
+         * 标识文本是否为检查列表模式。
+         * <P> 类型: Integer 1: 检查列表模式 0: 正常模式 </P>
+         */
+        public static final String MODE = DATA1;
+
+        /**
+         * 检查列表模式标识。
+         */
+        public static final int MODE_CHECK_LIST = 1;
+
+        /**
+         * 内容类型。
+         */
+        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
+
+        /**
+         * 内容项类型。
+         */
+        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
+
+        /**
+         * 内容 URI。
+         */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
+    }
+
+    /**
+     * 通话记录类，实现 DataColumns 接口。
+     */
+    public static final class CallNote implements DataColumns {
+        /**
+         * 通话日期。
+         * <P> 类型: INTEGER (long) </P>
+         */
+        public static final String CALL_DATE = DATA1;
+
+        /**
+         * 电话号码。
+         * <P> 类型: TEXT </P>
+         */
+        public static final String PHONE_NUMBER = DATA3;
+
+        /**
+         * 内容类型。
+         */
+        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+
+        /**
+         * 内容项类型。
+         */
+        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
+
+        /**
+         * 内容 URI。
+         */
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+    }
+}
+```
+
+
+        ### 主要改动：
+        1. **类和接口的注释**：为每个类和接口添加了简要说明。
+        2. **字段的注释**：为每个字段添加了详细的中文注释，解释其用途和数据类型。
+        3. **方法的注释**：为每个静态内部类的方法添加了注释。
+
+这样可以更好地理解代码的功能和结构。

src/net/micode/notes/data/NotesDatabaseHelper.java

@@ -0,0 +1,230 @@
+package net.micode.notes.data;
+
+import javax.naming.Context;
+
+/**
+ * NotesDatabaseHelper 类用于管理笔记数据库的创建和升级。
+ * 它继承自 SQLiteOpenHelper 并实现了 onCreate 和 onUpgrade 方法。
+ */
+public class NotesDatabaseHelper extends SQLiteOpenHelper {
+
+    private static final String DB_NAME = "notes.db";
+    private static final int DB_VERSION = 4;
+    private static NotesDatabaseHelper mInstance;
+    private static final String TAG = "NotesDatabaseHelper";
+
+    /**
+     * 构造函数，初始化数据库助手。
+     *
+     * @param context 应用程序上下文
+     */
+    public NotesDatabaseHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+
+    /**
+     * 创建笔记表。
+     *
+     * @param db 数据库实例
+     */
+    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 数据库实例
+     */
+    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 数据库实例
+     */
+    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 数据库实例
+     */
+    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 数据库实例
+     */
+    private void reCreateDataTableTriggers(SQLiteDatabase db) {
+        // 删除旧的触发器
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete");
+
+        // 创建新的触发器
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
+    }
+
+    /**
+     * 获取 NotesDatabaseHelper 的单例实例。
+     *
+     * @param context 应用程序上下文
+     * @return NotesDatabaseHelper 实例
+     */
+    static synchronized NotesDatabaseHelper getInstance(Context context) {
+        if (mInstance == null) {
+            mInstance = new NotesDatabaseHelper(context);
+        }
+        return mInstance;
+    }
+
+    /**
+     * 在数据库首次创建时调用，创建必要的表和触发器。
+     *
+     * @param db 数据库实例
+     */
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    /**
+     * 在数据库版本升级时调用，根据旧版本号执行相应的升级操作。
+     *
+     * @param db         数据库实例
+     * @param oldVersion 旧版本号
+     * @param newVersion 新版本号
+     */
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        boolean reCreateTriggers = false;
+        boolean skipV2 = false;
+
+        if (oldVersion == 1) {
+            upgradeToV2(db);
+            skipV2 = true; // 此次升级包括从 v2 到 v3 的升级
+            oldVersion++;
+        }
+
+        if (oldVersion == 2 && !skipV2) {
+            upgradeToV3(db);
+            reCreateTriggers = true;
+            oldVersion++;
+        }
+
+        if (oldVersion == 3) {
+            upgradeToV4(db);
+            oldVersion++;
+        }
+
+        if (reCreateTriggers) {
+            reCreateNoteTableTriggers(db);
+            reCreateDataTableTriggers(db);
+        }
+
+        if (oldVersion != newVersion) {
+            throw new IllegalStateException("升级笔记数据库到版本 " + newVersion + " 失败");
+        }
+    }
+
+    /**
+     * 升级数据库到版本 2。
+     *
+     * @param db 数据库实例
+     */
+    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。
+     *
+     * @param db 数据库实例
+     */
+    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 数据库实例
+     */
+    private void upgradeToV4(SQLiteDatabase db) {
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+                + " INTEGER NOT NULL DEFAULT 0");
+    }
+}
+```

src/net/micode/notes/data/NotesProvider.java

@@ -0,0 +1,340 @@
+package net.micode.notes.data;
+
+import java.awt.*;
+
+/**
+ * NotesProvider 类用于管理笔记内容提供者，继承自 ContentProvider。
+ * 它负责处理来自其他应用程序的对笔记数据库的访问请求。
+ */
+public class NotesProvider extends ContentProvider {
+
+    /**
+     * UriMatcher 用于匹配传入的 URI，并根据不同的 URI 执行相应的操作。
+     */
+    private static final UriMatcher mMatcher;
+
+    /**
+     * NotesDatabaseHelper 实例，用于与数据库进行交互。
+     */
+    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;
+
+    /**
+     * 静态代码块中初始化 UriMatcher，添加各种 URI 匹配规则。
+     */
+    static {
+        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY + "/*", URI_SEARCH_SUGGEST);
+    }
+
+    /**
+     * 搜索结果投影，定义了搜索结果返回的列及其别名。
+     */
+    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+            + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
+            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
+            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + ","
+            + R.drawable.search_result + " AS " + SearchManager.SUGGEST_COLUMN_ICON_1 + ","
+            + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
+            + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
+
+    /**
+     * 搜索查询语句，用于从笔记表中检索包含特定关键字的笔记片段。
+     */
+    private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
+            + " FROM " + TABLE.NOTE
+            + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+            + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+            + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
+
+    /**
+     * 在 ContentProvider 创建时调用，初始化 NotesDatabaseHelper 实例。
+     *
+     * @return 返回 true 表示创建成功。
+     */
+    @Override
+    public boolean onCreate() {
+        mHelper = NotesDatabaseHelper.getInstance(getContext());
+        return true;
+    }
+
+    /**
+     * 处理查询请求，根据传入的 URI 返回相应的 Cursor。
+     *
+     * @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;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null, sortOrder);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id + parseSelection(selection),
+                        selectionArgs, null, null, sortOrder);
+                break;
+            case URI_DATA:
+                c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null, sortOrder);
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id + parseSelection(selection),
+                        selectionArgs, null, null, sortOrder);
+                break;
+            case URI_SEARCH:
+            case URI_SEARCH_SUGGEST:
+                if (sortOrder != null || projection != null) {
+                    throw new IllegalArgumentException(
+                            "do not specify sortOrder, selection, selectionArgs, or projection with this query");
+                }
+
+                String searchString = null;
+                if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
+                    if (uri.getPathSegments().size() > 1) {
+                        searchString = uri.getPathSegments().get(1);
+                    }
+                } else {
+                    searchString = uri.getQueryParameter("pattern");
+                }
+
+                if (TextUtils.isEmpty(searchString)) {
+                    return null;
+                }
+
+                try {
+                    searchString = String.format("%%%s%%", searchString);
+                    c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY, new String[]{searchString});
+                } catch (IllegalStateException ex) {
+                    Log.e(TAG, "got exception: " + ex.toString());
+                }
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (c != null) {
+            c.setNotificationUri(getContext().getContentResolver(), uri);
+        }
+        return c;
+    }
+
+    /**
+     * 插入新数据到指定 URI 对应的表中。
+     *
+     * @param uri    要插入的 URI。
+     * @param values 要插入的数据。
+     * @return 返回插入后的新 URI。
+     */
+    @Override
+    public Uri insert(Uri uri, ContentValues values) {
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        long dataId = 0, noteId = 0, insertedId = 0;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                insertedId = noteId = db.insert(TABLE.NOTE, null, values);
+                break;
+            case URI_DATA:
+                if (values.containsKey(DataColumns.NOTE_ID)) {
+                    noteId = values.getAsLong(DataColumns.NOTE_ID);
+                } else {
+                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
+                }
+                insertedId = dataId = db.insert(TABLE.DATA, null, values);
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        // Notify the note uri
+        if (noteId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
+        }
+
+        // Notify the data uri
+        if (dataId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
+        }
+
+        return ContentUris.withAppendedId(uri, insertedId);
+    }
+
+    /**
+     * 删除指定 URI 对应的数据。
+     *
+     * @param uri           要删除的 URI。
+     * @param selection     删除条件。
+     * @param selectionArgs 删除条件参数。
+     * @return 返回删除的行数。
+     */
+    @Override
+    public int delete(Uri uri, String selection, String[] selectionArgs) {
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean deleteData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
+                count = db.delete(TABLE.NOTE, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                /**
+                 * ID 小于等于 0 的是系统文件夹，不允许删除。
+                 */
+                long noteId = Long.valueOf(id);
+                if (noteId <= 0) {
+                    break;
+                }
+                count = db.delete(TABLE.NOTE, NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.delete(TABLE.DATA, selection, selectionArgs);
+                deleteData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.delete(TABLE.DATA, DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                deleteData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (count > 0) {
+            if (deleteData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+
+    /**
+     * 更新指定 URI 对应的数据。
+     *
+     * @param uri           要更新的 URI。
+     * @param values        更新的数据。
+     * @param selection     更新条件。
+     * @param selectionArgs 更新条件参数。
+     * @return 返回更新的行数。
+     */
+    @Override
+    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean updateData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                increaseNoteVersion(-1, selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.update(TABLE.DATA, values, selection, selectionArgs);
+                updateData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                updateData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+
+        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。
+     * @param selection      更新条件。
+     * @param selectionArgs  更新条件参数。
+     */
+    private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
+        StringBuilder sql = new StringBuilder(120);
+        sql.append("UPDATE ").append(TABLE.NOTE).append(" SET ").append(NoteColumns.VERSION)
+                .append("=" + NoteColumns.VERSION + "+1 ");
+
+        if (id > 0 || !TextUtils.isEmpty(selection)) {
+            sql.append(" WHERE ");
+        }
+        if (id > 0) {
+            sql.append(NoteColumns.ID + "=" + String.valueOf(id));
+        }
+        if (!TextUtils.isEmpty(selection)) {
+            String selectString = id > 0 ? parseSelection(selection) : selection;
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+
+        mHelper.getWritableDatabase().execSQL(sql.toString());
+    }
+
+    /**
+     * 获取 MIME 类型，目前未实现。
+     *
+     * @param uri 要获取 MIME 类型的 URI。
+     * @return 返回 MIME 类型。
+     */
+    @Override
+    public String getType(Uri uri) {
+        // TODO Auto-generated method stub
+        return null;
+    }
+}
+```