README.md

@@ -1,2 +0,0 @@
-# Millet4531
-

src/model/Note.java

@@ -0,0 +1,256 @@
+
+
+package net.micode.notes.model;
+
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentUris;
+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）核心模型类，负责便签数据的创建、修改、同步等操作
+ * 通过ContentProvider与数据库交互，支持文本和通话记录两种数据类型
+ */
+public class Note {
+    private ContentValues mNoteDiffValues; // 记录便签基础属性的变更（如修改时间、本地标记等）
+    private NoteData mNoteData;           // 内部类，管理便签的具体数据（文本或通话记录）
+    private static final String TAG = "Note";
+
+    /**
+     * 生成新的便签ID，并在数据库中创建对应的基础记录
+     * @param context 上下文对象
+     * @param folderId 所属文件夹ID
+     * @return 新生成的便签ID（若失败返回0）
+     */
+    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);
+
+        // 插入数据库并解析返回的URI获取noteId
+        Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
+        long noteId = 0;
+        try {
+            noteId = Long.parseLong(uri.getPathSegments().get(1)); // 解析URI路径中的ID
+        } catch (NumberFormatException e) {
+            Log.e(TAG, "解析便签ID异常: " + e);
+            noteId = 0;
+        }
+        if (noteId == -1) {
+            throw new IllegalStateException("非法的便签ID: " + noteId);
+        }
+        return noteId;
+    }
+
+    public Note() {
+        mNoteDiffValues = new ContentValues();
+        mNoteData = new NoteData();
+    }
+
+    /**
+     * 设置便签基础属性值（如标题、父文件夹等）
+     * 自动标记本地修改状态和修改时间
+     */
+    public void setNoteValue(String key, String value) {
+        mNoteDiffValues.put(key, value);
+        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+    }
+
+    // 以下方法操作文本数据
+    public void setTextData(String key, String value) {
+        mNoteData.setTextData(key, value);
+    }
+    public void setTextDataId(long id) {
+        mNoteData.setTextDataId(id);
+    }
+    public long getTextDataId() {
+        return mNoteData.mTextDataId;
+    }
+
+    // 以下方法操作通话记录数据
+    public void setCallDataId(long id) {
+        mNoteData.setCallDataId(id);
+    }
+    public void setCallData(String key, String value) {
+        mNoteData.setCallData(key, value);
+    }
+
+    /**
+     * 检查是否有本地未同步的修改
+     * @return true表示存在未同步的修改
+     */
+    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("非法的便签ID: " + noteId);
+        }
+        if (!isLocalModified()) {
+            return true; // 无修改直接返回成功
+        }
+
+        // 1. 先更新便签基础属性
+        int updateCount = context.getContentResolver().update(
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), 
+                mNoteDiffValues, null, null);
+        if (updateCount == 0) {
+            Log.e(TAG, "便签基础属性更新失败");
+        }
+        mNoteDiffValues.clear();
+
+        // 2. 更新具体数据（文本/通话记录）
+        if (mNoteData.isLocalModified() && 
+            mNoteData.pushIntoContentResolver(context, noteId) == null) {
+            return false; // 数据更新失败
+        }
+        return true;
+    }
+
+    /**
+     * 内部类：管理便签的具体数据（文本/通话记录）
+     * 通过ContentProviderOperation实现批量数据库操作
+     */
+    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;
+        }
+
+        /**
+         * 检查是否有未同步的数据修改
+         */
+        boolean isLocalModified() {
+            return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
+        }
+
+        // 文本数据操作 ------
+        void setTextDataId(long id) {
+            if (id <= 0) throw new IllegalArgumentException("文本数据ID必须大于0");
+            mTextDataId = id;
+        }
+        void setTextData(String key, String value) {
+            mTextDataValues.put(key, value);
+            // 同步标记父便签为已修改
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        // 通话记录操作 ------
+        void setCallDataId(long id) {
+            if (id <= 0) throw new IllegalArgumentException("通话记录ID必须大于0");
+            mCallDataId = id;
+        }
+        void setCallData(String key, String value) {
+            mCallDataValues.put(key, value);
+            // 同步标记父便签为已修改
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        }
+
+        /**
+         * 将数据变更推送到数据库
+         * @return 操作结果的URI，失败返回null
+         */
+        Uri pushIntoContentResolver(Context context, long noteId) {
+            if (noteId <= 0) throw new IllegalArgumentException("非法的便签ID: " + noteId);
+
+            ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
+            ContentProviderOperation.Builder builder;
+
+            // 处理文本数据 ------
+            if (mTextDataValues.size() > 0) {
+                mTextDataValues.put(DataColumns.NOTE_ID, noteId); // 关联父便签
+                if (mTextDataId == 0) { // 新增文本数据项
+                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
+                    Uri uri = context.getContentResolver().insert(
+                        Notes.CONTENT_DATA_URI, mTextDataValues);
+                    try {
+                        setTextDataId(Long.parseLong(uri.getPathSegments().get(1)));
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "插入文本数据失败，便签ID: " + 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);
+                if (mCallDataId == 0) { // 新增通话记录数据项
+                    mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
+                    Uri uri = context.getContentResolver().insert(
+                        Notes.CONTENT_DATA_URI, mCallDataValues);
+                    try {
+                        setCallDataId(Long.parseLong(uri.getPathSegments().get(1)));
+                    } catch (NumberFormatException e) {
+                        Log.e(TAG, "插入通话记录数据失败，便签ID: " + 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.isEmpty()) {
+                try {
+                    ContentProviderResult[] results = context.getContentResolver()
+                        .applyBatch(Notes.AUTHORITY, operationList);
+                    return (results != null && results.length > 0 && results[0] != null) ?
+                        ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId) : null;
+                } catch (RemoteException | OperationApplicationException e) {
+                    Log.e(TAG, "批量操作异常: " + e.getMessage());
+                    return null;
+                }
+            }
+            return null;
+        }
+    }
+}

src/model/WorkingNote.java

@@ -0,0 +1,348 @@
+
+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;
+
+/**
+ * 当前活动便签的管理类，负责便签的创建、加载、属性设置和数据库同步
+ * 封装便签业务逻辑，并通过监听器实现与UI的交互
+ */
+public class WorkingNote {
+    // 核心数据对象
+    private Note mNote;                  // 便签数据模型
+    private long mNoteId;                // 当前便签的数据库ID（0表示未持久化）
+    private String mContent;             // 便签文本内容
+    private int mMode;                   // 模式（如普通模式/待办清单模式）
+
+    // 属性字段
+    private long mAlertDate;             // 提醒时间（毫秒时间戳，0表示未设置）
+    private long mModifiedDate;          // 最后修改时间
+    private int mBgColorId;              // 背景颜色ID（对应资源索引）
+    private int mWidgetId;               // 关联的小部件ID
+    private int mWidgetType;             // 小部件类型（如2x、4x）
+    private long mFolderId;              // 所属文件夹ID
+
+    // 上下文与状态
+    private Context mContext;            // 上下文对象
+    private static final String TAG = "WorkingNote";
+    private boolean mIsDeleted;          // 标记是否已删除
+
+    // 监听器接口
+    private NoteSettingChangedListener mNoteSettingStatusListener; // 属性变更监听器
+
+    // 数据库查询字段定义
+    /** 数据表（Data表）查询字段 */
+    public static final String[] DATA_PROJECTION = new String[] {
+            DataColumns.ID,             // 数据项ID
+            DataColumns.CONTENT,         // 内容（文本或通话记录）
+            DataColumns.MIME_TYPE,       // MIME类型（区分文本/通话记录）
+            DataColumns.DATA1,           // 扩展字段1（如模式）
+            DataColumns.DATA2,           // 扩展字段2
+            DataColumns.DATA3,           // 扩展字段3
+            DataColumns.DATA4,           // 扩展字段4
+    };
+
+    /** 便签表（Note表）查询字段 */
+    public static final String[] NOTE_PROJECTION = new String[] {
+            NoteColumns.PARENT_ID,       // 父文件夹ID
+            NoteColumns.ALERTED_DATE,   // 提醒时间
+            NoteColumns.BG_COLOR_ID,     // 背景色ID
+            NoteColumns.WIDGET_ID,       // 关联小部件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();                  // 初始化空Note对象
+        mNoteId = 0;                         // 新便签未持久化，ID为0
+        mIsDeleted = false;
+        mMode = 0;                           // 默认普通模式
+        mWidgetType = Notes.TYPE_WIDGET_INVALIDE; // 初始无小部件关联
+    }
+
+    /**
+     * 加载现有便签的私有构造方法
+     * @param context 上下文
+     * @param noteId 目标便签ID
+     * @param folderId 所属文件夹ID（可传入0，后续从数据库加载）
+     */
+    private WorkingNote(Context context, long noteId, long folderId) {
+        mContext = context;
+        mNoteId = noteId;
+        mFolderId = folderId;
+        mIsDeleted = false;
+        mNote = new Note();
+        loadNote(); // 从数据库加载数据
+    }
+
+    // 核心方法 ----------------------------------------
+    /**
+     * 从数据库加载便签基础属性（Note表）
+     */
+    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, "无法找到便签ID: " + mNoteId);
+            throw new IllegalArgumentException("无效的便签ID: " + mNoteId);
+        }
+        loadNoteData(); // 继续加载数据表内容
+    }
+
+    /**
+     * 从数据库加载便签具体数据（Data表）
+     */
+    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)); // 关联数据项ID
+                    } else if (DataConstants.CALL_NOTE.equals(type)) {
+                        // 加载通话记录数据
+                        mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
+                    } else {
+                        Log.d(TAG, "未知数据类型: " + type);
+                    }
+                } while (cursor.moveToNext());
+            }
+            cursor.close();
+        } else {
+            Log.e(TAG, "无法找到便签数据，ID: " + mNoteId);
+            throw new IllegalArgumentException("无效的便签数据ID: " + mNoteId);
+        }
+    }
+
+    /**
+     * 创建新的空便签（工厂方法）
+     * @param context 上下文
+     * @param folderId 文件夹ID
+     * @param widgetId 关联小部件ID
+     * @param widgetType 小部件类型
+     * @param defaultBgColorId 默认背景色ID
+     */
+    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
+     */
+    public static WorkingNote load(Context context, long id) {
+        return new WorkingNote(context, id, 0); // 文件夹ID后续从数据库加载
+    }
+
+    /**
+     * 保存便签到数据库（核心方法）
+     * @return 是否保存成功
+     */
+    public synchronized boolean saveNote() {
+        if (isWorthSaving()) { // 检查是否值得保存
+            // 若为新便签，生成数据库ID
+            if (!existInDatabase()) {
+                if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
+                    Log.e(TAG, "创建新便签失败，ID: " + mNoteId);
+                    return false;
+                }
+            }
+
+            // 同步数据到数据库
+            mNote.syncNote(mContext, mNoteId);
+
+            // 若关联小部件，通知UI更新
+            if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID &&
+                mWidgetType != Notes.TYPE_WIDGET_INVALIDE &&
+                mNoteSettingStatusListener != null) {
+                mNoteSettingStatusListener.onWidgetChanged();
+            }
+            return true;
+        } else {
+            return false; // 无需保存
+        }
+    }
+
+    // 辅助方法 ----------------------------------------
+    /**
+     * 检查便签是否已持久化到数据库
+     */
+    public boolean existInDatabase() {
+        return mNoteId > 0;
+    }
+
+    /**
+     * 判断便签是否值得保存（过滤无效操作）
+     * 规则：
+     * - 已标记删除
+     * - 新便签且内容为空
+     * - 已存在但无修改
+     */
+    private boolean isWorthSaving() {
+        return !(mIsDeleted || 
+                (!existInDatabase() && TextUtils.isEmpty(mContent)) || 
+                (existInDatabase() && !mNote.isLocalModified()));
+    }
+
+    // 属性设置方法 ------------------------------------
+    /**
+     * 设置提醒时间
+     * @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)); // 更新数据模型
+        }
+    }
+
+    // 其他属性设置方法（略，逻辑类似）-------------------
+    // ... setWidgetType(), setWidgetId(), setWorkingText(), convertToCallNote() ...
+
+    // 数据获取方法 ------------------------------------
+    public String getContent() {
+        return mContent;
+    }
+
+    public long getAlertDate() {
+        return mAlertDate;
+    }
+
+    public int getBgColorResId() {
+        return NoteBgResources.getNoteBgResource(mBgColorId);
+    }
+
+    // ... 其他getter方法 ...
+
+    // 监听器接口 --------------------------------------
+    /**
+     * 便签属性变更监听器接口
+     * 用于通知UI层更新（如小部件、背景色变化）
+     */
+    public interface NoteSettingChangedListener {
+        /** 背景色变更 */
+        void onBackgroundColorChanged();
+        /** 提醒时间设置/取消 */
+        void onClockAlertChanged(long date, boolean set);
+        /** 小部件内容需更新 */
+        void onWidgetChanged();
+        /** 待办清单模式切换 */
+        void onCheckListModeChanged(int oldMode, int newMode);
+    }
+}

src/widget/NoteWidgetProvider.java

@@ -0,0 +1,189 @@
+
+
+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;
+
+/**
+ * NoteWidgetProvider 是所有便签桌面小部件的抽象基类。
+ * 它提供了管理便签小部件的核心功能，包括数据查询、布局设置和点击事件处理。
+ * 子类需要实现特定尺寸小部件的布局、背景资源和类型标识。
+ */
+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";
+    
+    /**
+     * 当一个或多个小部件被删除时调用。
+     * 该方法会将被删除小部件对应的便签记录中的widget_id字段置为INVALID_APPWIDGET_ID。
+     * 
+     * @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);
+        
+        // 遍历所有被删除的小部件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])});
+        }
+    }
+    
+    /**
+     * 查询指定小部件ID对应的便签信息。
+     * 仅返回未被删除（不在回收站）的便签记录。
+     * 
+     * @param context 应用上下文
+     * @param widgetId 小部件ID
+     * @return 包含便签信息的Cursor，使用完后需要关闭
+     */
+    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) {
+                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()) {
+                    // 检查是否存在多个相同widget_id的便签（异常情况）
+                    if (c.getCount() > 1) {
+                        Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
+                        c.close();
+                        return;
+                    }
+                    
+                    // 从Cursor中获取便签内容和背景ID
+                    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);
+                }
+                
+                // 确保Cursor被关闭
+                if (c != null) {
+                    c.close();
+                }
+                
+                // 创建RemoteViews并设置背景和文本
+                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对应的背景资源ID。
+     * 由子类根据不同尺寸实现具体映射逻辑。
+     * 
+     * @param bgId 背景ID
+     * @return 对应的资源ID
+     */
+    protected abstract int getBgResourceId(int bgId);
+    
+    /**
+     * 获取小部件使用的布局资源ID。
+     * 由子类根据不同尺寸实现。
+     * 
+     * @return 布局资源ID
+     */
+    protected abstract int getLayoutId();
+    
+    /**
+     * 获取小部件类型。
+     * 用于标识不同尺寸的小部件，如2x、4x等。
+     * 
+     * @return 小部件类型常量
+     */
+    protected abstract int getWidgetType();
+}

src/widget/NoteWidgetProvider_2x.java

@@ -0,0 +1,81 @@
+/*
+ * 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;
+
+/**
+ * NoteWidgetProvider_2x 是一个为 2x 尺寸桌面小部件设计的实现类。
+ * 它继承自 NoteWidgetProvider，负责管理特定尺寸便签小部件的外观和行为。
+ * 小部件尺寸通常指 2 列 x 2 行的网格大小，具体取决于设备的桌面网格系统。
+ */
+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 R.layout.widget_2x 对应的布局资源ID
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_2x;
+    }
+
+    /**
+     * 根据背景ID获取对应的背景资源ID。
+     * 背景ID映射到具体的背景图片或颜色资源，用于自定义小部件外观。
+     * 
+     * @param bgId 背景ID，定义在 Notes 类中
+     * @return 对应背景资源的ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        // 使用 ResourceParser 工具类获取2x小部件的背景资源
+        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
+    }
+
+    /**
+     * 获取此小部件的类型。
+     * 类型用于数据库存储和区分不同尺寸的小部件。
+     * 
+     * @return Notes.TYPE_WIDGET_2X，表示这是一个2x尺寸的小部件
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_2X;
+    }
+}

src/widget/NoteWidgetProvider_4x.java

@@ -0,0 +1,67 @@
+
+
+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;
+
+/**
+ * NoteWidgetProvider_4x 是用于 4x 尺寸桌面便签小部件的提供者类。
+ * 该类继承自 NoteWidgetProvider，负责管理 4x 便签小部件的更新、布局和样式。
+ * 4x 通常表示小部件在桌面网格中占据 4 列 x N 行的空间（具体行数取决于布局实现）。
+ */
+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。
+     * 该布局定义了 4x 小部件的UI结构，通常包含更多内容展示空间。
+     * 
+     * @return R.layout.widget_4x 对应的布局资源ID
+     */
+    @Override // 此处应添加@Override注解以确保方法重写正确性
+    protected int getLayoutId() {
+        return R.layout.widget_4x;
+    }
+
+    /**
+     * 根据背景ID获取对应的背景资源ID。
+     * 不同尺寸的小部件可能使用不同的背景资源以确保视觉比例协调。
+     * 
+     * @param bgId 背景ID（定义在 Notes 类中）
+     * @return 对应背景资源的ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        // 使用工具类获取4x小部件的背景资源
+        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
+    }
+
+    /**
+     * 获取此小部件的类型标识。
+     * 类型标识用于数据库存储和区分不同尺寸的小部件。
+     * 
+     * @return Notes.TYPE_WIDGET_4X，表示这是一个4x尺寸的便签小部件
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_4X;
+    }
+}