Delete 'src/小米便签开源代码的泛读报告.docx'

泛读报告
14 changed files with 0 additions and 2529 deletions
--- a/doc/小米便签开源代码的泛读报告.docx
+++ b/doc/小米便签开源代码的泛读报告.docx
--- a/doc/运行图片-任佳瑶.zip
+++ b/doc/运行图片-任佳瑶.zip
--- a/doc/运行图片-王军慧.zip
+++ b/doc/运行图片-王军慧.zip
--- a/doc/运行图片-贺俊程.zip
+++ b/doc/运行图片-贺俊程.zip
--- a/1
+++ b/1
@ -1 +0,0 @@
 undefined
--- a/src/任佳瑶-model/Note.java
+++ b/src/任佳瑶-model/Note.java
@ -1,337 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.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;
        }
    }
 }
--- a/src/任佳瑶-model/WorkingNote.java
+++ b/src/任佳瑶-model/WorkingNote.java
@ -1,496 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.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);
    }
 }
--- a/src/王军慧-widget/NoteWidgetProvider.java
+++ b/src/王军慧-widget/NoteWidgetProvider.java
@ -1,188 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.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();
 }
--- a/src/王军慧-widget/NoteWidgetProvider_2x.java
+++ b/src/王军慧-widget/NoteWidgetProvider_2x.java
@ -1,71 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.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尺寸的小部件类型
    }
 }
--- a/src/王军慧-widget/NoteWidgetProvider_4x.java
+++ b/src/王军慧-widget/NoteWidgetProvider_4x.java
@ -1,70 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.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尺寸的小部件类型
    }
 }
--- a/src/贺俊程-data/Contact.java
+++ b/src/贺俊程-data/Contact.java
@ -1,97 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.data;
 import android.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;
        }
    }
 }
--- a/src/贺俊程-data/Notes.java
+++ b/src/贺俊程-data/Notes.java
@ -1,364 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.data;
 import android.net.Uri;
 /**
 * 笔记系统核心数据模型类，提供：
 * 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
    }
 }
--- a/src/贺俊程-data/NotesDatabaseHelper.java
+++ b/src/贺俊程-data/NotesDatabaseHelper.java
@ -1,488 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.data;
 import android.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");
    }
 }
--- a/src/贺俊程-data/NotesProvider.java
+++ b/src/贺俊程-data/NotesProvider.java
@ -1,417 +0,0 @@
 /*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 package net.micode.notes.data;
 import android.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;
    }
 }
Author	SHA1	Message	Date
pq2ex4sbi	444b4429e1	Delete 'src/小米便签开源代码的泛读报告.docx'	3 months ago
hjc	142e87f00a	泛读报告	3 months ago