注释代码

master

@@ -0,0 +1 @@
+undefined

src/任佳瑶-model/Note.java

@@ -0,0 +1,337 @@
+/*
+ * 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.model;
+
+import android.content.ContentProviderOperation;    // 用于批量操作内容提供者（插入、更新、删除）
+import android.content.ContentProviderResult;      // 批量操作的结果
+import android.content.ContentUris;                // 用于操作URI中的ID
+import android.content.ContentValues;              // 存储键值对数据
+import android.content.Context;                    // 应用上下文
+import android.content.OperationApplicationException; // 批量操作异常
+import android.net.Uri;                            // 统一资源标识符
+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.DataColumns;    // 数据列定义
+import net.micode.notes.data.Notes.NoteColumns;    // 便签列定义
+import net.micode.notes.data.Notes.TextNote;       // 文本便签类型
+
+import java.util.ArrayList;
+
+/**
+ * Note 类表示一个便签对象，负责便签的创建、修改和同步操作
+ */
+public class Note {
+    private ContentValues mNoteDiffValues;  // 存储便签属性的修改值
+    private NoteData mNoteData;            // 存储便签数据（文本或通话记录）
+    private static final String TAG = "Note"; // 日志标签
+
+    /**
+     * 创建新便签ID并插入数据库
+     * @param context 应用上下文
+     * @param folderId 父文件夹ID
+     * @return 新创建的便签ID
+     */
+    public static synchronized long getNewNoteId(Context context, long folderId) {
+        // 创建新便签并设置初始值
+        ContentValues values = new ContentValues();
+        long createdTime = System.currentTimeMillis();
+        values.put(NoteColumns.CREATED_DATE, createdTime);       // 创建时间
+        values.put(NoteColumns.MODIFIED_DATE, createdTime);     // 修改时间
+        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);          // 便签类型
+        values.put(NoteColumns.LOCAL_MODIFIED, 1);              // 标记为本地修改
+        values.put(NoteColumns.PARENT_ID, folderId);            // 父文件夹ID
+
+        // 插入数据库
+        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+
+        long noteId = 0;
+        try {
+            // 从URI中提取新创建的便签ID
+            noteId = Long.valueOf(uri.getPathSegments().get(1));
+        } catch (NumberFormatException e) {
+            Log.e(TAG, "Get note id error :" + e.toString());
+            noteId = 0;
+        }
+        if (noteId == -1) {
+            throw new IllegalStateException("Wrong note id:" + noteId);
+        }
+        return noteId;
+    }
+
+    /**
+     * 构造函数
+     */
+    public Note() {
+        mNoteDiffValues = new ContentValues();  // 初始化便签属性修改值
+        mNoteData = new NoteData();             // 初始化便签数据
+    }
+
+    /**
+     * 设置便签属性值
+     * @param key 属性键
+     * @param value 属性值
+     */
+    public void setNoteValue(String key, String value) {
+        mNoteDiffValues.put(key, value);
+        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);  // 标记为本地修改
+        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 更新修改时间
+    }
+
+    /**
+     * 设置文本数据
+     * @param key 数据键
+     * @param value 数据值
+     */
+    public void setTextData(String key, String value) {
+        mNoteData.setTextData(key, value);
+    }
+
+    /**
+     * 设置文本数据ID
+     * @param id 数据ID
+     */
+    public void setTextDataId(long id) {
+        mNoteData.setTextDataId(id);
+    }
+
+    /**
+     * 获取文本数据ID
+     * @return 文本数据ID
+     */
+    public long getTextDataId() {
+        return mNoteData.mTextDataId;
+    }
+
+    /**
+     * 设置通话数据ID
+     * @param id 数据ID
+     */
+    public void setCallDataId(long id) {
+        mNoteData.setCallDataId(id);
+    }
+
+    /**
+     * 设置通话数据
+     * @param key 数据键
+     * @param value 数据值
+     */
+    public void setCallData(String key, String value) {
+        mNoteData.setCallData(key, value);
+    }
+
+    /**
+     * 检查是否有本地修改
+     * @return 是否有修改
+     */
+    public boolean isLocalModified() {
+        return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
+    }
+
+    /**
+     * 同步便签到数据库
+     * @param context 应用上下文
+     * @param noteId 便签ID
+     * @return 是否同步成功
+     */
+    public boolean syncNote(Context context, long noteId) {
+        if (noteId <= 0) {
+            throw new IllegalArgumentException("Wrong note id:" + noteId);
+        }
+
+        // 如果没有本地修改，直接返回成功
+        if (!isLocalModified()) {
+            return true;
+        }
+
+        /**
+         * 更新便签基本信息到数据库
+         * 即使更新失败，也会继续更新便签数据（数据安全考虑）
+         */
+        if (context.getContentResolver().update(
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
+                null) == 0) {
+            Log.e(TAG, "Update note error, should not happen");
+            // 不返回，继续执行
+        }
+        mNoteDiffValues.clear();  // 清空修改值
+
+        // 更新便签数据到数据库
+        if (mNoteData.isLocalModified()
+                && (mNoteData.pushIntoContentResolver(context, noteId) == null)) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * NoteData 内部类，处理便签数据（文本或通话记录）
+     */
+    private class NoteData {
+        private long mTextDataId;          // 文本数据ID
+        private ContentValues mTextDataValues; // 文本数据值
+        private long mCallDataId;          // 通话数据ID
+        private ContentValues mCallDataValues; // 通话数据值
+        private static final String TAG = "NoteData"; // 日志标签
+
+        /**
+         * 构造函数
+         */
+        public NoteData() {
+            mTextDataValues = new ContentValues();
+            mCallDataValues = new ContentValues();
+            mTextDataId = 0;
+            mCallDataId = 0;
+        }
+
+        /**
+         * 检查是否有本地修改
+         * @return 是否有修改
+         */
+        boolean isLocalModified() {
+            return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
+        }
+
+        /**
+         * 设置文本数据ID
+         * @param id 数据ID
+         */
+        void setTextDataId(long id) {
+            if(id <= 0) {
+                throw new IllegalArgumentException("Text data id should larger than 0");
+            }
+            mTextDataId = id;
+        }
+
+        /**
+         * 设置通话数据ID
+         * @param id 数据ID
+         */
+        void setCallDataId(long id) {
+            if (id <= 0) {
+                throw new IllegalArgumentException("Call data id should larger than 0");
+            }
+            mCallDataId = id;
+        }
+
+        /**
+         * 设置通话数据
+         * @param key 数据键
+         * @param value 数据值
+         */
+        void setCallData(String key, String value) {
+            mCallDataValues.put(key, value);
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        /**
+         * 设置文本数据
+         * @param key 数据键
+         * @param value 数据值
+         */
+        void setTextData(String key, String value) {
+            mTextDataValues.put(key, value);
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        /**
+         * 将数据提交到内容提供者
+         * @param context 应用上下文
+         * @param noteId 便签ID
+         * @return 操作结果的URI
+         */
+        Uri pushIntoContentResolver(Context context, long noteId) {
+            // 检查便签ID有效性
+            if (noteId <= 0) {
+                throw new IllegalArgumentException("Wrong note id:" + noteId);
+            }
+
+            ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+            ContentProviderOperation.Builder builder = null;
+
+            // 处理文本数据
+            if(mTextDataValues.size() > 0) {
+                mTextDataValues.put(DataColumns.NOTE_ID, noteId);  // 设置便签ID
+                if (mTextDataId == 0) {  // 新数据
+                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE); // 设置MIME类型
+                    // 插入新数据
+                    Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+                            mTextDataValues);
+                    try {
+                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1))); // 从URI提取ID
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "Insert new text data fail with noteId" + noteId);
+                        mTextDataValues.clear();
+                        return null;
+                    }
+                } else {  // 更新现有数据
+                    builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+                            Notes.CONTENT_DATA_URI, mTextDataId));
+                    builder.withValues(mTextDataValues);
+                    operationList.add(builder.build());
+                }
+                mTextDataValues.clear();  // 清空数据
+            }
+
+            // 处理通话数据
+            if(mCallDataValues.size() > 0) {
+                mCallDataValues.put(DataColumns.NOTE_ID, noteId);  // 设置便签ID
+                if (mCallDataId == 0) {  // 新数据
+                    mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE); // 设置MIME类型
+                    // 插入新数据
+                    Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
+                            mCallDataValues);
+                    try {
+                        setCallDataId(Long.valueOf(uri.getPathSegments().get(1))); // 从URI提取ID
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "Insert new call data fail with noteId" + noteId);
+                        mCallDataValues.clear();
+                        return null;
+                    }
+                } else {  // 更新现有数据
+                    builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
+                            Notes.CONTENT_DATA_URI, mCallDataId));
+                    builder.withValues(mCallDataValues);
+                    operationList.add(builder.build());
+                }
+                mCallDataValues.clear();  // 清空数据
+            }
+
+            // 执行批量操作
+            if (operationList.size() > 0) {
+                try {
+                    ContentProviderResult[] results = context.getContentResolver().applyBatch(
+                            Notes.AUTHORITY, operationList);
+                    return (results == null || results.length == 0 || results[0] == null) ? null
+                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
+                } catch (RemoteException e) {
+                    Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+                    return null;
+                } catch (OperationApplicationException e) {
+                    Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+                    return null;
+                }
+            }
+            return null;
+        }
+    }
+}

src/任佳瑶-model/WorkingNote.java

@@ -0,0 +1,496 @@
+/*
+ * 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.model;
+
+import android.appwidget.AppWidgetManager;
+import android.content.ContentUris;
+import android.content.Context;
+import android.database.Cursor;
+import android.text.TextUtils;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.data.Notes.TextNote;
+import net.micode.notes.tool.ResourceParser.NoteBgResources;
+
+/**
+ * WorkingNote 类表示一个正在处理的便签对象，封装了便签的创建、加载、保存和修改等操作。
+ * 它作为便签数据模型和业务逻辑的中间层，提供了对便签内容的统一管理。
+ */
+public class WorkingNote {
+    // 便签对象
+    private Note mNote;
+    // 便签ID
+    private long mNoteId;
+    // 便签内容
+    private String mContent;
+    // 便签模式（普通/待办清单）
+    private int mMode;
+    // 提醒日期
+    private long mAlertDate;
+    // 修改日期
+    private long mModifiedDate;
+    // 背景颜色资源ID
+    private int mBgColorId;
+    // 小部件ID
+    private int mWidgetId;
+    // 小部件类型
+    private int mWidgetType;
+    // 所属文件夹ID
+    private long mFolderId;
+    // 上下文对象
+    private Context mContext;
+    // 日志标签
+    private static final String TAG = "WorkingNote";
+    // 是否已删除标志
+    private boolean mIsDeleted;
+    // 便签设置变更监听器
+    private NoteSettingChangedListener mNoteSettingStatusListener;
+
+    // 数据投影列定义
+    public static final String[] DATA_PROJECTION = new String[] {
+            DataColumns.ID,
+            DataColumns.CONTENT,
+            DataColumns.MIME_TYPE,
+            DataColumns.DATA1,
+            DataColumns.DATA2,
+            DataColumns.DATA3,
+            DataColumns.DATA4,
+    };
+
+    // 便签投影列定义
+    public static final String[] NOTE_PROJECTION = new String[] {
+            NoteColumns.PARENT_ID,
+            NoteColumns.ALERTED_DATE,
+            NoteColumns.BG_COLOR_ID,
+            NoteColumns.WIDGET_ID,
+            NoteColumns.WIDGET_TYPE,
+            NoteColumns.MODIFIED_DATE
+    };
+
+    // 列索引常量
+    private static final int DATA_ID_COLUMN = 0;
+    private static final int DATA_CONTENT_COLUMN = 1;
+    private static final int DATA_MIME_TYPE_COLUMN = 2;
+    private static final int DATA_MODE_COLUMN = 3;
+    private static final int NOTE_PARENT_ID_COLUMN = 0;
+    private static final int NOTE_ALERTED_DATE_COLUMN = 1;
+    private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
+    private static final int NOTE_WIDGET_ID_COLUMN = 3;
+    private static final int NOTE_WIDGET_TYPE_COLUMN = 4;
+    private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
+
+    /**
+     * 构造函数 - 创建新便签
+     * @param context 上下文对象
+     * @param folderId 所属文件夹ID
+     */
+    private WorkingNote(Context context, long folderId) {
+        mContext = context;
+        mAlertDate = 0;
+        mModifiedDate = System.currentTimeMillis();
+        mFolderId = folderId;
+        mNote = new Note();
+        mNoteId = 0;
+        mIsDeleted = false;
+        mMode = 0;
+        mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
+    }
+
+    /**
+     * 构造函数 - 加载已有便签
+     * @param context 上下文对象
+     * @param noteId 便签ID
+     * @param folderId 文件夹ID
+     */
+    private WorkingNote(Context context, long noteId, long folderId) {
+        mContext = context;
+        mNoteId = noteId;
+        mFolderId = folderId;
+        mIsDeleted = false;
+        mNote = new Note();
+        loadNote();
+    }
+
+    /**
+     * 加载便签数据
+     */
+    private void loadNote() {
+        Cursor cursor = mContext.getContentResolver().query(
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
+                null, null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
+                mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
+                mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
+                mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
+                mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
+                mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
+            }
+            cursor.close();
+        } else {
+            Log.e(TAG, "No note with id:" + mNoteId);
+            throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
+        }
+        loadNoteData();
+    }
+
+    /**
+     * 加载便签内容数据
+     */
+    private void loadNoteData() {
+        Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
+                DataColumns.NOTE_ID + "=?", new String[] {
+                        String.valueOf(mNoteId)
+                }, null);
+
+        if (cursor != null) {
+            if (cursor.moveToFirst()) {
+                do {
+                    String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
+                    if (DataConstants.NOTE.equals(type)) {
+                        mContent = cursor.getString(DATA_CONTENT_COLUMN);
+                        mMode = cursor.getInt(DATA_MODE_COLUMN);
+                        mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
+                    } else if (DataConstants.CALL_NOTE.equals(type)) {
+                        mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
+                    } else {
+                        Log.d(TAG, "Wrong note type with type:" + type);
+                    }
+                } while (cursor.moveToNext());
+            }
+            cursor.close();
+        } else {
+            Log.e(TAG, "No data with id:" + mNoteId);
+            throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
+        }
+    }
+
+    /**
+     * 创建空便签
+     * @param context 上下文对象
+     * @param folderId 文件夹ID
+     * @param widgetId 小部件ID
+     * @param widgetType 小部件类型
+     * @param defaultBgColorId 默认背景颜色ID
+     * @return 新创建的WorkingNote对象
+     */
+    public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
+                                              int widgetType, int defaultBgColorId) {
+        WorkingNote note = new WorkingNote(context, folderId);
+        note.setBgColorId(defaultBgColorId);
+        note.setWidgetId(widgetId);
+        note.setWidgetType(widgetType);
+        return note;
+    }
+
+    /**
+     * 加载已有便签
+     * @param context 上下文对象
+     * @param id 便签ID
+     * @return 加载的WorkingNote对象
+     */
+    public static WorkingNote load(Context context, long id) {
+        return new WorkingNote(context, id, 0);
+    }
+
+    /**
+     * 保存便签
+     * @return 保存是否成功
+     */
+    public synchronized boolean saveNote() {
+        if (isWorthSaving()) {
+            if (!existInDatabase()) {
+                if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
+                    Log.e(TAG, "Create new note fail with id:" + mNoteId);
+                    return false;
+                }
+            }
+
+            mNote.syncNote(mContext, mNoteId);
+
+            // 更新小部件内容
+            if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                    && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
+                    && mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onWidgetChanged();
+            }
+            return true;
+        } else {
+            return false;
+        }
+    }
+
+    /**
+     * 检查便签是否存在于数据库中
+     * @return 是否存在
+     */
+    public boolean existInDatabase() {
+        return mNoteId > 0;
+    }
+
+    /**
+     * 检查便签是否值得保存
+     * @return 是否值得保存
+     */
+    private boolean isWorthSaving() {
+        if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
+                || (existInDatabase() && !mNote.isLocalModified())) {
+            return false;
+        } else {
+            return true;
+        }
+    }
+
+    /**
+     * 设置设置变更监听器
+     * @param l 监听器对象
+     */
+    public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
+        mNoteSettingStatusListener = l;
+    }
+
+    /**
+     * 设置提醒日期
+     * @param date 提醒日期
+     * @param set 是否设置
+     */
+    public void setAlertDate(long date, boolean set) {
+        if (date != mAlertDate) {
+            mAlertDate = date;
+            mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
+        }
+        if (mNoteSettingStatusListener != null) {
+            mNoteSettingStatusListener.onClockAlertChanged(date, set);
+        }
+    }
+
+    /**
+     * 标记便签为已删除
+     * @param mark 是否标记
+     */
+    public void markDeleted(boolean mark) {
+        mIsDeleted = mark;
+        if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                && mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
+            mNoteSettingStatusListener.onWidgetChanged();
+        }
+    }
+
+    /**
+     * 设置背景颜色ID
+     * @param id 背景颜色ID
+     */
+    public void setBgColorId(int id) {
+        if (id != mBgColorId) {
+            mBgColorId = id;
+            if (mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onBackgroundColorChanged();
+            }
+            mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
+        }
+    }
+
+    /**
+     * 设置待办清单模式
+     * @param mode 模式值
+     */
+    public void setCheckListMode(int mode) {
+        if (mMode != mode) {
+            if (mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
+            }
+            mMode = mode;
+            mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
+        }
+    }
+
+    /**
+     * 设置小部件类型
+     * @param type 小部件类型
+     */
+    public void setWidgetType(int type) {
+        if (type != mWidgetType) {
+            mWidgetType = type;
+            mNote.setNoteValue(NoteColumns.WIDGET_TYPE, String.valueOf(mWidgetType));
+        }
+    }
+
+    /**
+     * 设置小部件ID
+     * @param id 小部件ID
+     */
+    public void setWidgetId(int id) {
+        if (id != mWidgetId) {
+            mWidgetId = id;
+            mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
+        }
+    }
+
+    /**
+     * 设置便签文本内容
+     * @param text 文本内容
+     */
+    public void setWorkingText(String text) {
+        if (!TextUtils.equals(mContent, text)) {
+            mContent = text;
+            mNote.setTextData(DataColumns.CONTENT, mContent);
+        }
+    }
+
+    /**
+     * 转换为通话记录便签
+     * @param phoneNumber 电话号码
+     * @param callDate 通话日期
+     */
+    public void convertToCallNote(String phoneNumber, long callDate) {
+        mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
+        mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);
+        mNote.setNoteValue(NoteColumns.PARENT_ID, String.valueOf(Notes.ID_CALL_RECORD_FOLDER));
+    }
+
+    /**
+     * 检查是否有提醒
+     * @return 是否有提醒
+     */
+    public boolean hasClockAlert() {
+        return (mAlertDate > 0 ? true : false);
+    }
+
+    /**
+     * 获取便签内容
+     * @return 便签内容
+     */
+    public String getContent() {
+        return mContent;
+    }
+
+    /**
+     * 获取提醒日期
+     * @return 提醒日期
+     */
+    public long getAlertDate() {
+        return mAlertDate;
+    }
+
+    /**
+     * 获取修改日期
+     * @return 修改日期
+     */
+    public long getModifiedDate() {
+        return mModifiedDate;
+    }
+
+    /**
+     * 获取背景颜色资源ID
+     * @return 背景颜色资源ID
+     */
+    public int getBgColorResId() {
+        return NoteBgResources.getNoteBgResource(mBgColorId);
+    }
+
+    /**
+     * 获取背景颜色ID
+     * @return 背景颜色ID
+     */
+    public int getBgColorId() {
+        return mBgColorId;
+    }
+
+    /**
+     * 获取标题背景资源ID
+     * @return 标题背景资源ID
+     */
+    public int getTitleBgResId() {
+        return NoteBgResources.getNoteTitleBgResource(mBgColorId);
+    }
+
+    /**
+     * 获取待办清单模式
+     * @return 待办清单模式
+     */
+    public int getCheckListMode() {
+        return mMode;
+    }
+
+    /**
+     * 获取便签ID
+     * @return 便签ID
+     */
+    public long getNoteId() {
+        return mNoteId;
+    }
+
+    /**
+     * 获取文件夹ID
+     * @return 文件夹ID
+     */
+    public long getFolderId() {
+        return mFolderId;
+    }
+
+    /**
+     * 获取小部件ID
+     * @return 小部件ID
+     */
+    public int getWidgetId() {
+        return mWidgetId;
+    }
+
+    /**
+     * 获取小部件类型
+     * @return 小部件类型
+     */
+    public int getWidgetType() {
+        return mWidgetType;
+    }
+
+    /**
+     * 便签设置变更监听器接口
+     */
+    public interface NoteSettingChangedListener {
+        /**
+         * 背景颜色变更回调
+         */
+        void onBackgroundColorChanged();
+
+        /**
+         * 提醒设置变更回调
+         * @param date 提醒日期
+         * @param set 是否设置
+         */
+        void onClockAlertChanged(long date, boolean set);
+
+        /**
+         * 小部件变更回调
+         */
+        void onWidgetChanged();
+
+        /**
+         * 待办清单模式变更回调
+         * @param oldMode 旧模式
+         * @param newMode 新模式
+         */
+        void onCheckListModeChanged(int oldMode, int newMode);
+    }
+}

src/王军慧-widget/NoteWidgetProvider.java

@@ -0,0 +1,188 @@
+/*
+ * 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.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;
+
+/**
+ * 小米便签小部件的基类实现
+ * 继承自Android框架的 {@link AppWidgetProvider}
+ * 提供小部件的核心功能，包括数据更新、点击事件处理等
+ */
+public abstract class NoteWidgetProvider extends AppWidgetProvider {
+
+    // 数据库查询投影字段
+    public static final String[] PROJECTION = new String[] {
+            NoteColumns.ID,          // 便签ID
+            NoteColumns.BG_COLOR_ID, // 背景颜色ID
+            NoteColumns.SNIPPET      // 便签摘要
+    };
+
+    // 投影字段的索引常量
+    public static final int COLUMN_ID           = 0;
+    public static final int COLUMN_BG_COLOR_ID  = 1;
+    public static final int COLUMN_SNIPPET      = 2;
+
+    private static final String TAG = "NoteWidgetProvider"; // 日志标签
+
+    /**
+     * 当小部件被删除时调用
+     * @param context 上下文对象
+     * @param appWidgetIds 被删除的小部件ID数组
+     */
+    @Override
+    public void onDeleted(Context context, int[] appWidgetIds) {
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
+        // 更新数据库，将关联的便签的widget_id设为无效值
+        for (int i = 0; i < appWidgetIds.length; i++) {
+            context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
+                    values,
+                    NoteColumns.WIDGET_ID + "=?",
+                    new String[] { String.valueOf(appWidgetIds[i])});
+        }
+    }
+
+    /**
+     * 获取与小部件关联的便签信息
+     * @param context 上下文对象
+     * @param widgetId 小部件ID
+     * @return 返回查询到的游标对象
+     */
+    private Cursor getNoteWidgetInfo(Context context, int widgetId) {
+        return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
+                PROJECTION,
+                NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+                new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
+                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 i = 0; i < appWidgetIds.length; i++) {
+            if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
+                // 初始化默认背景ID和摘要内容
+                int bgId = ResourceParser.getDefaultBgId(context);
+                String snippet = "";
+
+                // 准备点击跳转的Intent
+                Intent intent = new Intent(context, NoteEditActivity.class);
+                intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
+                intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
+                intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
+
+                // 查询关联的便签数据
+                Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
+                if (c != null && c.moveToFirst()) {
+                    // 处理查询结果
+                    if (c.getCount() > 1) {
+                        Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
+                        c.close();
+                        return;
+                    }
+                    snippet = c.getString(COLUMN_SNIPPET);
+                    bgId = c.getInt(COLUMN_BG_COLOR_ID);
+                    intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_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();
+                }
+
+                // 创建远程视图并设置内容
+                RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
+                rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
+                intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
+
+                // 设置点击事件
+                PendingIntent pendingIntent = null;
+                if (privacyMode) {
+                    // 隐私模式下的显示和处理
+                    rv.setTextViewText(R.id.widget_text,
+                            context.getString(R.string.widget_under_visit_mode));
+                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent(
+                            context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
+                } else {
+                    // 正常模式下的显示和处理
+                    rv.setTextViewText(R.id.widget_text, snippet);
+                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
+                            PendingIntent.FLAG_UPDATE_CURRENT);
+                }
+
+                rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
+                // 更新小部件显示
+                appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
+            }
+        }
+    }
+
+    /**
+     * 获取背景资源ID（由子类实现）
+     * @param bgId 背景ID
+     * @return 返回对应的背景资源ID
+     */
+    protected abstract int getBgResourceId(int bgId);
+
+    /**
+     * 获取布局资源ID（由子类实现）
+     * @return 返回布局资源ID
+     */
+    protected abstract int getLayoutId();
+
+    /**
+     * 获取小部件类型（由子类实现）
+     * @return 返回小部件类型标识
+     */
+    protected abstract int getWidgetType();
+}

src/王军慧-widget/NoteWidgetProvider_2x.java

@@ -0,0 +1,71 @@
+/*
+ * 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.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尺寸桌面小部件实现类
+ * 继承自基础小部件类 {@link NoteWidgetProvider}
+ * 提供2x尺寸小部件的特定布局和资源管理
+ */
+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; // 指向res/layout/widget_2x.xml布局文件
+    }
+
+    /**
+     * 根据背景ID获取对应的背景资源ID
+     * @param bgId 背景ID
+     * @return 返回2x尺寸小部件对应的背景资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); // 从资源解析器获取2x尺寸的背景资源
+    }
+
+    /**
+     * 获取小部件的类型标识
+     * @return 返回2x尺寸小部件的类型常量 {@link Notes#TYPE_WIDGET_2X}
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_2X; // 标识这是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");
+ * 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.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尺寸桌面小部件实现类
+ * 继承自基础小部件类 {@link 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
+     */
+    protected int getLayoutId() {
+        return R.layout.widget_4x; // 指向res/layout/widget_4x.xml布局文件
+    }
+
+    /**
+     * 根据背景ID获取对应的背景资源ID
+     * @param bgId 背景ID
+     * @return 返回4x尺寸小部件对应的背景资源ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId); // 从资源解析器获取4x尺寸的背景资源
+    }
+
+    /**
+     * 获取小部件的类型标识
+     * @return 返回4x尺寸小部件的类型常量 {@link Notes#TYPE_WIDGET_4X}
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_4X; // 标识这是4x尺寸的小部件类型
+    }
+}

src/贺俊程-data/Contact.java

@@ -0,0 +1,97 @@
+/*
+ * 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.Context;
+import android.database.Cursor;
+import android.provider.ContactsContract.CommonDataKinds.Phone;
+import android.provider.ContactsContract.Data;
+import android.telephony.PhoneNumberUtils;
+import android.util.Log;
+
+import java.util.HashMap;
+/**
+ * 联系人工具类，用于通过电话号码查询联系人姓名，并支持缓存机制
+ */
+public class Contact {
+    // 联系人缓存（电话号码 -> 联系人姓名）
+
+    private static HashMap<String, String> sContactCache;
+    private static final String TAG = "Contact"; // 日志标签
+
+    // 查询条件模板，用于匹配电话号码对应的联系人
+    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 "  // 原始联系人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);
+        }
+        // 动态构建查询条件（替换模板中的占位符）
+        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 },// 参数占位符值
+
+                null);   // 排序方式
+        // 处理查询结果
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                // 获取第一条结果的显示名称
+                String name = cursor.getString(0);
+                sContactCache.put(phoneNumber, name);// 存入缓存
+                return name;
+            } catch (IndexOutOfBoundsException e) {
+                // 异常处理（列索引越界）
+                Log.e(TAG, " Cursor get string error " + e.toString());
+                return null;
+            } finally {
+                // 确保关闭游标释放资源
+                cursor.close();
+            }
+        } else {
+            // 未找到匹配联系人
+            Log.d(TAG, "No contact matched with number:" + phoneNumber);
+            return null;
+        }
+    }
+}

src/贺俊程-data/Notes.java

@@ -0,0 +1,364 @@
+/*
+ * 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;
+
+
+/**
+ * 笔记系统核心数据模型类，提供：
+ * 1. 内容提供者URI定义
+ * 2. 数据表结构常量
+ * 3. 笔记类型常量
+ * 4. 系统文件夹ID定义
+ * 5. Intent传输常量
+ */
+
+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;// 系统笔记
+
+    /**
+     * Following IDs are system folders' identifiers
+     * {@link Notes#ID_ROOT_FOLDER } is default folder
+     * {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
+     * {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
+     */
+
+
+    /**
+     * 系统文件夹ID定义：
+     * {@link #ID_ROOT_FOLDER} 根文件夹（默认）
+     * {@link #ID_TEMPARAY_FOLDER} 临时文件夹（未分类笔记）
+     * {@link #ID_CALL_RECORD_FOLDER} 通话记录文件夹
+     * {@link #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传输数据常量
+    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";// 背景颜色ID
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";// 小部件ID
+
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";// 小部件类型
+
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id"; // 文件夹ID
+
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date"; // 通话日期
+
+
+    public static final int TYPE_WIDGET_INVALIDE      = -1;// 无效类型
+
+    public static final int TYPE_WIDGET_2X            = 0; // 2x尺寸
+    public static final int TYPE_WIDGET_4X            = 1;// 4x尺寸
+
+    /**
+     * 数据类型常量映射（用于内容提供者查询）
+     */
+
+    public static class DataConstants {
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;// 文本笔记类型
+
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE; // 通话记录类型
+
+    }
+
+    /**
+     * Uri to query all notes and folders
+     */
+
+    // 内容URI定义
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note"); // 笔记主数据URI
+
+
+    /**
+     * Uri to query data
+     */
+
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data"); // 详细数据URI
+    /**
+     * 笔记表结构接口（主表）
+     */
+
+    public interface NoteColumns {
+        /**
+         * The unique ID for a row
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";  // 唯一ID
+
+
+        /**
+         * The parent's id for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String PARENT_ID = "parent_id"; // 父级ID（用于文件夹层级）
+
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";// 创建时间戳
+
+
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date"; // 修改时间戳
+
+
+
+        /**
+         * Alert date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ALERTED_DATE = "alert_date"; // 提醒时间戳
+
+
+        /**
+         * Folder's name or text content of note
+         * <P> Type: TEXT </P>
+         */
+        public static final String SNIPPET = "snippet";// 摘要内容（文件夹名/笔记预览）
+
+        /**
+         * Note's widget id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String WIDGET_ID = "widget_id"; // 关联的小部件ID
+
+
+        /**
+         * Note's widget type
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String WIDGET_TYPE = "widget_type"; // 小部件类型
+
+
+        /**
+         * Note's background color's id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id"; // 背景颜色ID
+
+
+        /**
+         * For text note, it doesn't has attachment, for multi-media
+         * note, it has at least one attachment
+         * <P> Type: INTEGER </P>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment"; // 是否有附件标记
+
+
+        /**
+         * Folder's count of notes
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String NOTES_COUNT = "notes_count";// 文件夹内笔记数量
+
+
+        /**
+         * The file type: folder or note
+         * <P> Type: INTEGER </P>
+         */
+        public static final String TYPE = "type";// 文件类型（笔记/文件夹）
+
+
+        /**
+         * The last sync id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String SYNC_ID = "sync_id";// 同步ID
+
+
+        /**
+         * Sign to indicate local modified or not
+         * <P> Type: INTEGER </P>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";  // 本地修改标记
+
+
+        /**
+         * Original parent id before moving into temporary folder
+         * <P> Type : INTEGER </P>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";// 原始父级ID（用于移动恢复）
+
+
+        /**
+         * The gtask id
+         * <P> Type : TEXT </P>
+         */
+        public static final String GTASK_ID = "gtask_id";// Google任务ID
+
+
+        /**
+         * The version code
+         * <P> Type : INTEGER (long) </P>
+         */
+        public static final String VERSION = "version";// 数据版本
+    }
+
+
+    /**
+     * 详细数据表结构接口（子表）
+     */
+    public interface DataColumns {
+        /**
+         * The unique ID for a row
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";  // 唯一ID
+
+
+        /**
+         * The MIME type of the item represented by this row.
+         * <P> Type: Text </P>
+         */
+        public static final String MIME_TYPE = "mime_type";// MIME类型（区分数据类型）
+
+        /**
+         * The reference id to note that this data belongs to
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String NOTE_ID = "note_id";  // 关联的笔记ID
+
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date"; // 创建时间戳
+
+
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";// 修改时间戳
+
+
+        /**
+         * Data's content
+         * <P> Type: TEXT </P>
+         */
+        public static final String CONTENT = "content";  // 详细内容
+
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * integer data type
+         * <P> Type: INTEGER </P>
+         */
+        public static final String DATA1 = "data1";  // 通用数据字段1（整数类型）
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * integer data type
+         * <P> Type: INTEGER </P>
+         */
+        public static final String DATA2 = "data2";// 通用数据字段2（整数类型）
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA3 = "data3"; // 通用数据字段3（文本类型）
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA4 = "data4"; // 通用数据字段4（文本类型）
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA5 = "data5";// 通用数据字段5（文本类型）
+
+    }
+    /**
+     * 文本笔记数据模型
+     */
+
+    public static final class TextNote implements DataColumns {
+        /**
+         * Mode to indicate the text in check list mode or not
+         * <P> Type: Integer 1:check list mode 0: normal mode </P>
+         */
+        public static final String MODE = DATA1;  // 模式标识（1=复选列表模式）
+
+
+        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";// 内容类型（单项）
+
+
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");// 内容URI
+
+    }
+
+    /**
+     * 通话记录数据模型
+     */
+
+    public static final class CallNote implements DataColumns {
+        /**
+         * Call date for this record
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String CALL_DATE = DATA1; // 通话日期（时间戳）
+
+
+        /**
+         * Phone number for this record
+         * <P> Type: 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";// 内容类型（单项）
+
+
+        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note"); // 内容URI
+
+    }
+}

src/贺俊程-data/NotesDatabaseHelper.java

@@ -0,0 +1,488 @@
+/*
+ * 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;
+
+/**
+ * 笔记系统数据库管理类，负责：
+ * 1. 数据库创建与升级
+ * 2. 表结构定义
+ * 3. 触发器管理
+ * 4. 系统文件夹初始化
+ *
+ * 采用单例模式保证数据库连接唯一性
+ */
+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;
+    // 核心表结构定义
+
+    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," +// 父级ID（文件夹层级）
+
+                NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +// 提醒时间
+
+                NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +  // 背景色ID
+
+                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," +// 小部件ID
+            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +// 小部件类型
+            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +// 同步ID
+
+                NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +// 本地修改标记
+
+                NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +// 原始父级ID
+
+                NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," + // Google任务ID
+
+                NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +  // 数据版本
+
+                ")";
+
+    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," + // 关联笔记ID
+
+                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," + // 通用数据字段1
+
+                DataColumns.DATA2 + " INTEGER," + // 通用数据字段2
+
+                DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," + // 通用数据字段3
+
+                DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," + // 通用数据字段4
+
+                DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +  // 通用数据字段5
+
+                ")";
+    // 数据库触发器定义（用于维护数据一致性
+    private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
+        "CREATE INDEX IF NOT EXISTS note_id_index ON " +
+        TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";// 笔记ID索引
+
+
+    /**
+     * Increase folder's note count when move note to the folder
+     */
+
+    /**
+     * 文件夹计数维护触发器组：
+     * 1. 更新时增加目标文件夹计数
+     * 2. 更新时减少原文件夹计数
+     * 3. 插入时增加目标文件夹计数
+     * 4. 删除时减少原文件夹计数
+     */
+
+
+    /**
+     * 数据库触发器定义模块，实现复杂业务逻辑的自动化维护：
+     *
+     * 一、文件夹计数维护触发器组（Folder Counter Triggers）
+     * 目标：自动维护文件夹的笔记数量统计（NOTES_COUNT字段）
+     *
+     * 1. 更新时增加目标文件夹计数
+     * 触发场景：将笔记移动到新文件夹（UPDATE操作）
+     * 逻辑：当PARENT_ID变更时，新父文件夹的计数+1
+     * 特点：使用new.PARENT_ID获取变更后的目标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";
+
+    /**
+     * 2. 更新时减少原文件夹计数
+     * 触发场景：将笔记移出原文件夹（UPDATE操作）
+     * 逻辑：当PARENT_ID变更时，原父文件夹的计数-1（需>0时才执行）
+     * 特点：使用old.PARENT_ID获取变更前的原ID，防止计数负值
+     */
+    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";
+
+    /**
+     * 3. 插入时增加目标文件夹计数
+     * 触发场景：新建笔记到文件夹（INSERT操作）
+     * 逻辑：根据新笔记的PARENT_ID增加对应文件夹计数
+     * 特点：使用new.PARENT_ID直接获取目标ID
+     */
+    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";
+
+    /**
+     * 4. 删除时减少原文件夹计数
+     * 触发场景：从文件夹删除笔记（DELETE操作）
+     * 逻辑：根据被删笔记的原PARENT_ID减少对应文件夹计数
+     * 特点：使用old.PARENT_ID获取原ID，自动级联处理
+     */
+    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";
+
+    /**
+     * 二、笔记内容同步触发器组（Content Sync Triggers）
+     * 目标：保持DATA表与NOTE表的SNIPPET字段同步
+     *
+     * 1. 插入时更新笔记内容
+     * 触发场景：新增NOTE类型数据（如文本内容）
+     * 逻辑：将DATA.CONTENT同步到关联笔记的SNIPPET
+     * 特点：使用WHEN子句过滤MIME_TYPE，通过new.NOTE_ID关联
+     */
+    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";
+
+    /**
+     * 2. 更新时同步内容变更
+     * 触发场景：修改NOTE类型数据内容
+     * 逻辑：实时更新关联笔记的SNIPPET
+     * 特点：使用old.MIME_TYPE确保只处理NOTE类型数据
+     */
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_update " +
+        " AFTER UPDATE ON " + TABLE.DATA +
+        " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+        "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 3. 删除时清空笔记内容
+     * 触发场景：删除NOTE类型数据
+     * 逻辑：将关联笔记的SNIPPET置为空字符串
+     * 特点：使用old前缀访问被删除数据的内容
+     */
+    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";
+
+    /**
+     * 三、级联操作触发器组（Cascade Operations Triggers）
+     *
+     * 1. 笔记删除时级联删除关联数据
+     * 触发场景：删除笔记记录
+     * 逻辑：自动删除该笔记在DATA表中的所有关联数据
+     * 特点：通过old.ID匹配DATA.NOTE_ID实现级联删除
+     */
+    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";
+    /**
+     * 2. 文件夹删除时级联删除子笔记
+     * 触发场景：删除文件夹记录
+     * 逻辑：自动删除该文件夹下的所有笔记（包括子文件夹）
+     * 特点：通过old.ID匹配NOTE.PARENT_ID实现递归删除
+     */
+    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";
+
+    /**
+     * 3. 文件夹移入回收站时级联移动子笔记
+     * 触发场景：文件夹被移动到回收站（PARENT_ID更新）
+     * 逻辑：自动将该文件夹下的所有笔记移入回收站
+     * 特点：通过new.PARENT_ID判断目标位置，使用old.ID匹配原父级
+     */
+    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";
+/**
+ * 触发器设计特点：
+ * 1. 事务安全：所有操作在数据库事务中自动完成
+ * 2. 数据一致性：通过计数维护保证统计准确率
+ * 3. 级联处理：自动处理关联数据的增删改
+ * 4. 性能优化：避免在应用层维护复杂状态
+ * 5. 防御性编程：通过WHERE条件防止无效操作（如计数<0）
+ */
+
+
+
+
+    /**
+     * 构造函数（私有化保证单例）
+     * @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);
+    }
+    /**
+     * 创建系统预置文件夹：
+     * 1. 通话记录文件夹
+     * 2. 根文件夹
+     * 3. 临时文件夹
+     * 4. 回收站文件夹
+     */
+    private void createSystemFolder(SQLiteDatabase db) {
+        ContentValues values = new ContentValues();
+
+        /**
+         * call record foler for call notes
+         */
+        values.put(NoteColumns.ID, Notes.ID_CALL_RECORD_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * root folder which is default folder
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_ROOT_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * temporary folder which is used for moving note
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_TEMPARAY_FOLDER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+
+        /**
+         * create trash folder
+         */
+        values.clear();
+        values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+    }
+    // 使用ContentValues插入系统文件夹记录...
+    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");
+    }
+
+    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 数据库帮助类实例
+     */
+    static synchronized NotesDatabaseHelper getInstance(Context context) {
+        if (mInstance == null) {
+            mInstance = new NotesDatabaseHelper(context);
+        }
+        return mInstance;
+    }
+
+    @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) {   // 1.0 → 2.0（重建表结构）
+            upgradeToV2(db);
+            skipV2 = true; // this upgrade including the upgrade from v2 to v3
+            oldVersion++;
+        }
+
+        if (oldVersion == 2 && !skipV2) {  // 2.0 → 3.0（添加GTASK_ID字段和回收站）
+            upgradeToV3(db);
+            reCreateTriggers = true;
+            oldVersion++;
+        }
+
+        if (oldVersion == 3) { // 3.0 → 4.0（添加版本字段）
+            upgradeToV4(db);
+            oldVersion++;
+        }
+
+        if (reCreateTriggers) {
+            reCreateNoteTableTriggers(db);
+            reCreateDataTableTriggers(db);
+        }
+
+        if (oldVersion != newVersion) {
+            throw new IllegalStateException("Upgrade notes database to version " + newVersion
+                    + "fails");
+        }
+    }
+
+    private void upgradeToV2(SQLiteDatabase db) {
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    private void upgradeToV3(SQLiteDatabase db) {
+        // drop unused triggers
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update");
+        // add a column for gtask id
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID
+                + " TEXT NOT NULL DEFAULT ''");
+        // add a trash system folder
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+    }
+
+    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,417 @@
+/*
+ * 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;
+
+/**
+ * 笔记系统内容提供者，实现：
+ * 1. 统一数据访问接口（CRUD操作）
+ * 2. URI路由分发
+ * 3. 搜索建议支持
+ * 4. 数据变更通知
+ * 5. 版本控制机制
+ */
+public class NotesProvider extends ContentProvider {
+
+    private static final UriMatcher mMatcher;// URI匹配器（单例模式）
+
+    private NotesDatabaseHelper mHelper;// 数据库帮助类
+
+    // URI类型常量定义
+    private static final String TAG = "NotesProvider";
+
+    private static final int URI_NOTE            = 1;// 笔记集合
+
+    private static final int URI_NOTE_ITEM       = 2;// 单个笔记
+
+    private static final int URI_DATA            = 3;// 数据集合
+
+    private static final int URI_DATA_ITEM       = 4; // 单条数据
+
+
+    private static final int URI_SEARCH          = 5; // 搜索接口
+
+    private static final int URI_SEARCH_SUGGEST  = 6;// 搜索建议接口
+
+
+    // 静态初始化URI匹配规则
+    static {
+        mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
+        // 笔记相关URI
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        // 数据相关URI
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        // 搜索相关URI
+        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);
+    }
+
+    /**
+     * x'0A' represents the '\n' character in sqlite. For title and content in the search result,
+     * we will trim '\n' and white space in order to show more information.
+     */
+
+    /**
+     * 搜索结果投影定义：
+     * 1. 基础字段映射
+     * 2. 文本处理（去除换行符和空格）
+     * 3. 搜索建议专用字段（图标、意图动作等）
+     */
+    private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + "," // 笔记ID
+
+            + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","// 附加数据
+
+            + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " // 清理后的摘要
+            + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","// 建议文本1
+        + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_2 + "," // 建议文本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模板：
+     * 1. 排除回收站文件夹
+     * 2. 限制笔记类型
+     * 3. 使用LIKE进行模糊匹配
+     */
+    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;
+
+    @Override
+    public boolean onCreate() {
+        mHelper = NotesDatabaseHelper.getInstance(getContext());// 获取数据库实例
+
+        return true;
+    }
+    /**
+     * 统一数据查询入口，支持多种URI类型的查询操作：
+     * 1. 笔记集合查询（URI_NOTE）
+     * 2. 单条笔记查询（URI_NOTE_ITEM）
+     * 3. 数据集合查询（URI_DATA）
+     * 4. 单条数据查询（URI_DATA_ITEM）
+     * 5. 全局搜索（URI_SEARCH）
+     * 6. 搜索建议（URI_SEARCH_SUGGEST）
+     */
+
+    @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:// 查询单条笔记（优先使用URI中的ID）
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                break;
+            case URI_DATA:  // 查询数据集合（支持复杂条件）
+
+                c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
+                        sortOrder);
+                break;
+            case URI_DATA_ITEM: // 查询单条数据（优先使用URI中的ID）
+
+                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;
+    }
+    /**
+     * 数据插入中心：
+     * 1. 笔记/数据表智能路由
+     * 2. 自动关联note_id处理
+     * 3. 数据变更通知
+     */
+    @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: // 插入笔记到主表（自动生成ID）
+
+                insertedId = noteId = db.insert(TABLE.NOTE, null, values);// 插入笔记
+
+                break;
+            case URI_DATA: // 插入数据到子表（强制要求关联note_id）
+
+
+                if (values.containsKey(DataColumns.NOTE_ID)) {
+                    noteId = values.getAsLong(DataColumns.NOTE_ID);
+                } else {// 安全校验：数据必须关联有效笔记
+
+                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
+                }
+                insertedId = dataId = db.insert(TABLE.DATA, null, values);
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        // Notify the note uri
+        // 数据变更通知机制：
+        // 1. 当插入笔记时，通知对应笔记URI的观察者
+        // 2. 当插入数据时，通知对应数据URI的观察者
+        // 3. 使用ContentUris构建标准返回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);
+    }
+    /**
+     * 数据删除中心：
+     * 1. 系统文件夹保护（ID<=0禁止删除）
+     * 2. 级联删除处理（通过触发器实现）
+     * 3. 安全删除条件构建
+     */
+    @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: // 删除笔记集合（自动追加ID>0条件，防止系统文件夹误删）
+
+                selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
+                count = db.delete(TABLE.NOTE, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:// 删除单条笔记（URI中的ID优先）
+
+                id = uri.getPathSegments().get(1);
+                /**
+                 * ID that smaller than 0 is system folder which is not allowed to
+                 * trash
+                 */
+                long noteId = Long.valueOf(id);
+                if (noteId <= 0) {// 系统文件夹保护（ID≤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: // 删除单条数据（URI中的ID优先）
+                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);
+        }
+        // 数据变更通知机制：
+        // 1. 精准通知当前操作的URI
+        // 2. 当删除数据时，级联通知笔记URI（数据删除可能影响笔记内容）
+
+        if (count > 0) {
+            if (deleteData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+    /**
+     * 数据更新中心：
+     * 1. 自动版本递增机制
+     * 2. 精准更新条件构建
+     * 3. 变更通知机制
+     */
+    @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: // 更新笔记集合（自动版本递增，基于selection条件）
+
+                increaseNoteVersion(-1, selection, selectionArgs); // 版本递增
+
+                count = db.update(TABLE.NOTE, values, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:   // 更新单条笔记（优先使用URI中的ID）
+
+                id = uri.getPathSegments().get(1);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:// 更新数据集合（标记数据变更）
+                count = db.update(TABLE.DATA, values, selection, selectionArgs);
+                updateData = true;
+                break;
+            case URI_DATA_ITEM: // 更新单条数据（优先使用URI中的ID）
+
+                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);
+        }
+        // 数据变更通知机制：
+        // 1. 精准通知当前操作的URI
+        // 2. 当更新数据表时，级联通知笔记URI（数据变更可能影响笔记内容）
+
+        if (count > 0) {
+            if (updateData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
+    }
+    /**
+     * 辅助方法：
+     * 1. 条件解析（处理SQL注入防护）
+     * 2. 版本递增实现（用于数据同步）
+     * 3. 变更通知封装
+     */
+    private String parseSelection(String selection) {
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
+    }
+
+    private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
+        // 构建基础UPDATE语句
+        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条件（ID优先）
+        if (id > 0 || !TextUtils.isEmpty(selection)) {
+            sql.append(" WHERE ");
+        }
+        if (id > 0) {
+            sql.append(NoteColumns.ID + "=" + String.valueOf(id)); // 优先使用ID条件
+
+        }
+        // 处理复合条件（当同时存在ID和selection时自动添加AND）
+
+        if (!TextUtils.isEmpty(selection)) {
+            String selectString = id > 0 ? parseSelection(selection) : selection;// 复用参数解析方法
+
+            // 手动参数替换（因涉及动态条件组合，故采用字符串替换）
+
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+        // 执行原生SQL（需确保调用方已做好权限校验）
+        mHelper.getWritableDatabase().execSQL(sql.toString());
+    }
+
+    @Override
+    public String getType(Uri uri) {
+        // TODO Auto-generated method stub
+        return null;
+    }
+
+}