文档

src/data/Contact.java

@@ -1,17 +1,15 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, The MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 根据 Apache 许可证 2.0 版本授权
- * 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;
@@ -25,10 +23,21 @@ import android.util.Log;
 
 import java.util.HashMap;
 
+/**
+ * 联系人查询工具类，用于通过电话号码获取联系人信息
+ */
 public class Contact {
+    // 静态联系人缓存，使用HashMap存储电话号码到联系人姓名的映射
+    // 键：电话号码(String)，值：联系人姓名(String)
     private static HashMap<String, String> sContactCache;
+    
+    // 日志标签，用于调试和错误记录
     private static final String TAG = "Contact";
 
+    // 联系人查询的选择条件(WHERE子句)
+    // 1. 使用PHONE_NUMBERS_EQUAL函数比较电话号码
+    // 2. 限制MIME类型为电话类型
+    // 3. 通过phone_lookup表提高查询效率
     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 "
@@ -36,38 +45,65 @@ public class Contact {
             + " FROM phone_lookup"
             + " WHERE min_match = '+')";
 
+    /**
+     * 根据电话号码获取联系人姓名
+     * 
+     * @param context Android上下文对象，用于访问ContentResolver
+     * @param phoneNumber 要查询的电话号码
+     * @return 联系人姓名，如果未找到则返回null
+     */
     public static String getContact(Context context, String phoneNumber) {
+        // 初始化缓存(懒加载模式)
         if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();
         }
 
+        // 首先检查缓存中是否已有该号码的查询结果
         if(sContactCache.containsKey(phoneNumber)) {
-            return sContactCache.get(phoneNumber);
+            return sContactCache.get(phoneNumber); // 命中缓存直接返回
         }
 
+        // 准备查询条件：
+        // 1. 将选择语句中的"+"替换为电话号码的最小匹配长度
+        // 2. PhoneNumberUtils.toCallerIDMinMatch()方法会根据号码格式返回合适的匹配长度
         String selection = CALLER_ID_SELECTION.replace("+",
                 PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
+        
+        // 执行内容提供器查询：
+        // 1. 查询URI: Data.CONTENT_URI (联系人数据)
+        // 2. 只查询DISPLAY_NAME(显示名称)列
+        // 3. 使用上面构建的选择条件
+        // 4. 查询参数为phoneNumber
+        // 5. 不指定排序方式
         Cursor cursor = context.getContentResolver().query(
-                Data.CONTENT_URI,
+                Data.CONTENT_URI,                   // 联系人数据URI
-                new String [] { Phone.DISPLAY_NAME },
+                new String [] { Phone.DISPLAY_NAME }, // 要查询的列
-                selection,
+                selection,                          // WHERE条件
-                new String[] { phoneNumber },
+                new String[] { phoneNumber },       // WHERE参数
-                null);
+                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());
+                // 处理可能的数组越界异常
+                Log.e(TAG, "获取Cursor字符串时出错：" + e.toString());
                 return null;
             } finally {
+                // 确保关闭Cursor释放资源
                 cursor.close();
             }
         } else {
-            Log.d(TAG, "No contact matched with number:" + phoneNumber);
+            // 没有找到匹配的联系人记录
+            Log.d(TAG, "没有找到匹配号码的联系人：" + phoneNumber);
             return null;
         }
     }
-}
+}

src/data/Notes.java

@@ -1,279 +1,292 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, The MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 根据 Apache 许可证 2.0 版本授权
- * you may not use this file except in compliance with the License.
+ * 除非遵守许可证要求，否则不得使用此文件
- * You may obtain a copy of the License at
+ * 您可以在以下网址获取许可证副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
+ * 除非适用法律要求或书面同意，软件按"原样"分发
- * distributed under the License is distributed on an "AS IS" BASIS,
+ * 没有任何明示或暗示的担保或条件
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * 请参阅许可证了解具体权限和限制
- * See the License for the specific language governing permissions and
- * limitations under the License.
  */
 
 package net.micode.notes.data;
 
 import android.net.Uri;
+
+/**
+ * 便签应用的核心常量定义类
+ * 包含URI定义、类型常量、数据列定义等内容
+ */
 public class Notes {
+    // 内容提供器的授权标识
     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;
+    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
+     * 系统文件夹ID定义：
-     * {@link Notes#ID_ROOT_FOLDER } is default folder
+     * {@link Notes#ID_ROOT_FOLDER} 根文件夹（默认文件夹）
-     * {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
+     * {@link Notes#ID_TEMPARAY_FOLDER} 临时文件夹（存放未分类笔记）
-     * {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
+     * {@link Notes#ID_CALL_RECORD_FOLDER} 通话记录文件夹
      */
-    public static final int ID_ROOT_FOLDER = 0;
+    public static final int ID_ROOT_FOLDER = 0;           // 根文件夹ID
-    public static final int ID_TEMPARAY_FOLDER = -1;
+    public static final int ID_TEMPARAY_FOLDER = -1;      // 临时文件夹ID
-    public static final int ID_CALL_RECORD_FOLDER = -2;
+    public static final int ID_CALL_RECORD_FOLDER = -2;   // 通话记录文件夹ID
-    public static final int ID_TRASH_FOLER = -3;
+    public static final int ID_TRASH_FOLER = -3;          // 回收站文件夹ID
-
+
-    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    // Intent附加数据键名常量
-    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";          // 提醒日期
-    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id"; // 背景颜色ID
-    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";            // 桌面小部件ID
-    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";        // 小部件类型
-    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+    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;
+    // 桌面小部件类型常量
-    public static final int TYPE_WIDGET_4X            = 1;
+    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 NOTE = TextNote.CONTENT_ITEM_TYPE;      // 普通笔记类型
-        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE; // 通话笔记类型
     }
 
-    /**
+    // 内容URI定义
-     * Uri to query all notes and folders
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");  // 笔记查询URI
-     */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");  // 数据查询URI
-    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
 
     /**
-     * Uri to query data
+     * 笔记数据表列名定义接口
      */
-    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
-
     public interface NoteColumns {
         /**
-         * The unique ID for a row
+         * 行唯一ID
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String ID = "_id";
 
         /**
-         * The parent's id for note or folder
+         * 父项ID（用于笔记或文件夹的层级关系）
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String PARENT_ID = "parent_id";
 
         /**
-         * Created data for note or folder
+         * 创建日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String CREATED_DATE = "created_date";
 
         /**
-         * Latest modified date
+         * 最后修改日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String MODIFIED_DATE = "modified_date";
 
-
         /**
-         * Alert date
+         * 提醒日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String ALERTED_DATE = "alert_date";
 
         /**
-         * Folder's name or text content of note
+         * 文件夹名称或笔记内容摘要
-         * <P> Type: TEXT </P>
+         * <P> 类型: TEXT </P>
          */
         public static final String SNIPPET = "snippet";
 
         /**
-         * Note's widget id
+         * 关联的小部件ID
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String WIDGET_ID = "widget_id";
 
         /**
-         * Note's widget type
+         * 小部件类型
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String WIDGET_TYPE = "widget_type";
 
         /**
-         * Note's background color's id
+         * 背景颜色ID
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String BG_COLOR_ID = "bg_color_id";
 
         /**
-         * For text note, it doesn't has attachment, for multi-media
+         * 是否有附件（0-无，1-有）
-         * note, it has at least one attachment
+         * <P> 类型: INTEGER </P>
-         * <P> Type: INTEGER </P>
          */
         public static final String HAS_ATTACHMENT = "has_attachment";
 
         /**
-         * Folder's count of notes
+         * 文件夹中的笔记数量
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String NOTES_COUNT = "notes_count";
 
         /**
-         * The file type: folder or note
+         * 类型标识（笔记/文件夹/系统文件夹）
-         * <P> Type: INTEGER </P>
+         * <P> 类型: INTEGER </P>
          */
         public static final String TYPE = "type";
 
         /**
-         * The last sync id
+         * 同步ID（用于数据同步）
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String SYNC_ID = "sync_id";
 
         /**
-         * Sign to indicate local modified or not
+         * 本地修改标记（0-未修改，1-已修改）
-         * <P> Type: INTEGER </P>
+         * <P> 类型: INTEGER </P>
          */
         public static final String LOCAL_MODIFIED = "local_modified";
 
         /**
-         * Original parent id before moving into temporary folder
+         * 原始父ID（移动前的位置）
-         * <P> Type : INTEGER </P>
+         * <P> 类型: INTEGER </P>
          */
         public static final String ORIGIN_PARENT_ID = "origin_parent_id";
 
         /**
-         * The gtask id
+         * Google任务ID（用于与Google Tasks同步）
-         * <P> Type : TEXT </P>
+         * <P> 类型: TEXT </P>
          */
         public static final String GTASK_ID = "gtask_id";
 
         /**
-         * The version code
+         * 数据版本号
-         * <P> Type : INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String VERSION = "version";
     }
 
+    /**
+     * 数据表列名定义接口
+     */
     public interface DataColumns {
         /**
-         * The unique ID for a row
+         * 行唯一ID
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String ID = "_id";
 
         /**
-         * The MIME type of the item represented by this row.
+         * MIME类型标识
-         * <P> Type: Text </P>
+         * <P> 类型: TEXT </P>
          */
         public static final String MIME_TYPE = "mime_type";
 
         /**
-         * The reference id to note that this data belongs to
+         * 关联的笔记ID
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String NOTE_ID = "note_id";
 
         /**
-         * Created data for note or folder
+         * 创建日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String CREATED_DATE = "created_date";
 
         /**
-         * Latest modified date
+         * 最后修改日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String MODIFIED_DATE = "modified_date";
 
         /**
-         * Data's content
+         * 数据内容
-         * <P> Type: TEXT </P>
+         * <P> 类型: TEXT </P>
          */
         public static final String CONTENT = "content";
 
-
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * 通用数据列1，具体含义由MIME_TYPE决定（通常用于整数类型）
-         * integer data type
+         * <P> 类型: INTEGER </P>
-         * <P> Type: INTEGER </P>
          */
         public static final String DATA1 = "data1";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * 通用数据列2，具体含义由MIME_TYPE决定（通常用于整数类型）
-         * integer data type
+         * <P> 类型: INTEGER </P>
-         * <P> Type: INTEGER </P>
          */
         public static final String DATA2 = "data2";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * 通用数据列3，具体含义由MIME_TYPE决定（通常用于文本类型）
-         * TEXT data type
+         * <P> 类型: TEXT </P>
-         * <P> Type: TEXT </P>
          */
         public static final String DATA3 = "data3";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * 通用数据列4，具体含义由MIME_TYPE决定（通常用于文本类型）
-         * TEXT data type
+         * <P> 类型: TEXT </P>
-         * <P> Type: TEXT </P>
          */
         public static final String DATA4 = "data4";
 
         /**
-         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * 通用数据列5，具体含义由MIME_TYPE决定（通常用于文本类型）
-         * TEXT data type
+         * <P> 类型: TEXT </P>
-         * <P> Type: TEXT </P>
          */
         public static final String DATA5 = "data5";
     }
 
+    /**
+     * 文本笔记数据定义
+     */
     public static final class TextNote implements DataColumns {
         /**
-         * Mode to indicate the text in check list mode or not
+         * 模式标识（0-普通模式，1-清单模式）
-         * <P> Type: Integer 1:check list mode 0: normal mode </P>
+         * <P> 类型: INTEGER </P>
          */
         public static final String MODE = DATA1;
 
-        public static final int MODE_CHECK_LIST = 1;
+        public static final int MODE_CHECK_LIST = 1;  // 清单模式
 
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
+        // MIME类型定义
-
+        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 String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note"; // 单项目类型
 
+        // 内容URI
         public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
     }
 
+    /**
+     * 通话记录笔记数据定义
+     */
     public static final class CallNote implements DataColumns {
         /**
-         * Call date for this record
+         * 通话日期
-         * <P> Type: INTEGER (long) </P>
+         * <P> 类型: INTEGER (long) </P>
          */
         public static final String CALL_DATE = DATA1;
 
         /**
-         * Phone number for this record
+         * 电话号码
-         * <P> Type: TEXT </P>
+         * <P> 类型: TEXT </P>
          */
         public static final String PHONE_NUMBER = DATA3;
 
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+        // MIME类型定义
-
+        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 String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note"; // 单项目类型
 
+        // 内容URI
         public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
     }
-}
+}

src/data/NotesDatabaseHelper.java

@@ -1,17 +1,15 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, The MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 根据 Apache 许可证 2.0 版本授权
- * 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;
@@ -26,64 +24,74 @@ import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.DataConstants;
 import net.micode.notes.data.Notes.NoteColumns;
 
-
+/**
+ * 便签应用的数据库帮助类
+ * 负责数据库的创建、升级和管理工作
+ */
 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 NOTE = "note";  // 笔记表
-
+        public static final String DATA = "data";  // 数据表
-        public static final String DATA = "data";
     }
 
+    // 日志标签
     private static final String TAG = "NotesDatabaseHelper";
-
+    // 单例实例
     private static NotesDatabaseHelper mInstance;
 
+    // 创建笔记表的SQL语句
     private static final String CREATE_NOTE_TABLE_SQL =
         "CREATE TABLE " + TABLE.NOTE + "(" +
-            NoteColumns.ID + " INTEGER PRIMARY KEY," +
+            NoteColumns.ID + " INTEGER PRIMARY KEY," +               // 笔记ID
-            NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 父文件夹ID
-            NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," + // 提醒日期
-            NoteColumns.BG_COLOR_ID + " 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.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期
-            NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," + // 是否有附件
-            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 修改日期
-            NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," + // 包含笔记数(文件夹用)
-            NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +     // 内容摘要
-            NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +      // 类型(笔记/文件夹)
-            NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +  // 关联的小部件ID
-            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
+            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," + // 小部件类型
-            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +    // 同步ID
-            NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," + // 本地修改标记
-            NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 原始父ID
-            NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +     // Google任务ID
-            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
+            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +    // 版本号
         ")";
 
+    // 创建数据表的SQL语句
     private static final String CREATE_DATA_TABLE_SQL =
         "CREATE TABLE " + TABLE.DATA + "(" +
-            DataColumns.ID + " INTEGER PRIMARY KEY," +
+            DataColumns.ID + " INTEGER PRIMARY KEY," +               // 数据ID
-            DataColumns.MIME_TYPE + " TEXT NOT NULL," +
+            DataColumns.MIME_TYPE + " TEXT NOT NULL," +              // MIME类型
-            DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
+            DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +   // 关联的笔记ID
-            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期
-            NoteColumns.MODIFIED_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.CONTENT + " TEXT NOT NULL DEFAULT ''," +     // 内容
-            DataColumns.DATA1 + " INTEGER," +
+            DataColumns.DATA1 + " INTEGER," +                        // 通用数据列1
-            DataColumns.DATA2 + " INTEGER," +
+            DataColumns.DATA2 + " INTEGER," +                        // 通用数据列2
-            DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +       // 通用数据列3
-            DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +       // 通用数据列4
-            DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
+            DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +        // 通用数据列5
         ")";
 
+    // 创建数据表note_id索引的SQL语句
     private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
         "CREATE INDEX IF NOT EXISTS note_id_index ON " +
         TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
 
     /**
-     * Increase folder's note count when move note to the folder
+     * 触发器：当更新笔记的父文件夹时增加目标文件夹的笔记计数
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_update "+
@@ -95,7 +103,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Decrease folder's note count when move note from folder
+     * 触发器：当更新笔记的父文件夹时减少原文件夹的笔记计数
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_update " +
@@ -108,7 +116,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Increase folder's note count when insert new note to the folder
+     * 触发器：当插入新笔记时增加父文件夹的笔记计数
      */
     private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
         "CREATE TRIGGER increase_folder_count_on_insert " +
@@ -120,7 +128,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Decrease folder's note count when delete note from the folder
+     * 触发器：当删除笔记时减少父文件夹的笔记计数
      */
     private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
         "CREATE TRIGGER decrease_folder_count_on_delete " +
@@ -133,7 +141,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when insert data with type {@link DataConstants#NOTE}
+     * 触发器：当插入笔记数据时更新笔记内容摘要
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
         "CREATE TRIGGER update_note_content_on_insert " +
@@ -146,7 +154,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when data with {@link DataConstants#NOTE} type has changed
+     * 触发器：当更新笔记数据时更新笔记内容摘要
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
         "CREATE TRIGGER update_note_content_on_update " +
@@ -159,7 +167,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Update note's content when data with {@link DataConstants#NOTE} type has deleted
+     * 触发器：当删除笔记数据时清空笔记内容摘要
      */
     private static final String DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER =
         "CREATE TRIGGER update_note_content_on_delete " +
@@ -172,7 +180,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Delete datas belong to note which has been deleted
+     * 触发器：当删除笔记时删除关联的数据
      */
     private static final String NOTE_DELETE_DATA_ON_DELETE_TRIGGER =
         "CREATE TRIGGER delete_data_on_delete " +
@@ -183,7 +191,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Delete notes belong to folder which has been deleted
+     * 触发器：当删除文件夹时删除其中的所有笔记
      */
     private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
         "CREATE TRIGGER folder_delete_notes_on_delete " +
@@ -194,7 +202,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         " END";
 
     /**
-     * Move notes belong to folder which has been moved to trash folder
+     * 触发器：当文件夹被移到回收站时将其中的笔记也移到回收站
      */
     private static final String FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER =
         "CREATE TRIGGER folder_move_notes_on_trash " +
@@ -206,18 +214,31 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         "  WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
         " END";
 
+    /**
+     * 构造函数
+     * @param context 上下文对象
+     */
     public NotesDatabaseHelper(Context context) {
         super(context, DB_NAME, null, DB_VERSION);
     }
 
+    /**
+     * 创建笔记表
+     * @param db SQLite数据库对象
+     */
     public void createNoteTable(SQLiteDatabase db) {
-        db.execSQL(CREATE_NOTE_TABLE_SQL);
+        db.execSQL(CREATE_NOTE_TABLE_SQL);  // 执行建表SQL
-        reCreateNoteTableTriggers(db);
+        reCreateNoteTableTriggers(db);      // 重建触发器
-        createSystemFolder(db);
+        createSystemFolder(db);             // 创建系统文件夹
         Log.d(TAG, "note table has been created");
     }
 
+    /**
+     * 重建笔记表的所有触发器
+     * @param db SQLite数据库对象
+     */
     private void reCreateNoteTableTriggers(SQLiteDatabase db) {
+        // 删除所有现有触发器
         db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update");
         db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update");
         db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete");
@@ -226,6 +247,7 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         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);
@@ -235,58 +257,69 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
     }
 
+    /**
+     * 创建系统文件夹
+     * @param db SQLite数据库对象
+     */
     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);
     }
 
+    /**
+     * 创建数据表
+     * @param db SQLite数据库对象
+     */
     public void createDataTable(SQLiteDatabase db) {
-        db.execSQL(CREATE_DATA_TABLE_SQL);
+        db.execSQL(CREATE_DATA_TABLE_SQL);  // 执行建表SQL
-        reCreateDataTableTriggers(db);
+        reCreateDataTableTriggers(db);      // 重建触发器
-        db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL);
+        db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL); // 创建索引
         Log.d(TAG, "data table has been created");
     }
 
+    /**
+     * 重建数据表的所有触发器
+     * @param db SQLite数据库对象
+     */
     private void reCreateDataTableTriggers(SQLiteDatabase db) {
+        // 删除现有触发器
         db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
         db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update");
         db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete");
 
+        // 重新创建触发器
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
         db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
     }
 
+    /**
+     * 获取单例实例
+     * @param context 上下文对象
+     * @return NotesDatabaseHelper实例
+     */
     static synchronized NotesDatabaseHelper getInstance(Context context) {
         if (mInstance == null) {
             mInstance = new NotesDatabaseHelper(context);
@@ -294,69 +327,100 @@ public class NotesDatabaseHelper extends SQLiteOpenHelper {
         return mInstance;
     }
 
+    /**
+     * 数据库创建时调用
+     * @param db SQLite数据库对象
+     */
     @Override
     public void onCreate(SQLiteDatabase db) {
-        createNoteTable(db);
+        createNoteTable(db);  // 创建笔记表
-        createDataTable(db);
+        createDataTable(db); // 创建数据表
     }
 
+    /**
+     * 数据库升级时调用
+     * @param db SQLite数据库对象
+     * @param oldVersion 旧版本号
+     * @param newVersion 新版本号
+     */
     @Override
     public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
         boolean reCreateTriggers = false;
         boolean skipV2 = false;
 
+        // 从版本1升级到版本2
         if (oldVersion == 1) {
             upgradeToV2(db);
-            skipV2 = true; // this upgrade including the upgrade from v2 to v3
+            skipV2 = true; // 这个升级包含从v2到v3的升级
             oldVersion++;
         }
 
+        // 从版本2升级到版本3
         if (oldVersion == 2 && !skipV2) {
             upgradeToV3(db);
             reCreateTriggers = true;
             oldVersion++;
         }
 
+        // 从版本3升级到版本4
         if (oldVersion == 3) {
             upgradeToV4(db);
             oldVersion++;
         }
 
+        // 如果需要，重新创建触发器
         if (reCreateTriggers) {
             reCreateNoteTableTriggers(db);
             reCreateDataTableTriggers(db);
         }
 
+        // 检查版本号是否匹配
         if (oldVersion != newVersion) {
-            throw new IllegalStateException("Upgrade notes database to version " + newVersion
+            throw new IllegalStateException("升级笔记数据库到版本 " + newVersion + "失败");
-                    + "fails");
         }
     }
 
+    /**
+     * 升级到版本2
+     * @param db SQLite数据库对象
+     */
     private void upgradeToV2(SQLiteDatabase db) {
+        // 删除旧表
         db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
         db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
+        // 重新创建表
         createNoteTable(db);
         createDataTable(db);
     }
 
+    /**
+     * 升级到版本3
+     * @param db SQLite数据库对象
+     */
     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
+        
+        // 添加Google任务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);
     }
 
+    /**
+     * 升级到版本4
+     * @param db SQLite数据库对象
+     */
     private void upgradeToV4(SQLiteDatabase db) {
+        // 添加版本号列
         db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
                 + " INTEGER NOT NULL DEFAULT 0");
     }
-}
+}

src/data/NotesProvider.java

@@ -1,22 +1,19 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, The MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
+ * 根据 Apache 许可证 2.0 版本授权
- * 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;
@@ -34,36 +31,45 @@ import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.NotesDatabaseHelper.TABLE;
 
-
+/**
+ * 便签应用的内容提供器(ContentProvider)
+ * 负责处理所有数据访问请求，包括增删改查操作
+ */
 public class NotesProvider extends ContentProvider {
+    // URI匹配器，用于识别不同类型的URI请求
     private static final UriMatcher mMatcher;
 
+    // 数据库帮助类实例
     private NotesDatabaseHelper mHelper;
 
+    // 日志标签
     private static final String TAG = "NotesProvider";
 
-    private static final int URI_NOTE            = 1;
+    // URI匹配类型常量
-    private static final int URI_NOTE_ITEM       = 2;
+    private static final int URI_NOTE            = 1;  // 笔记集合
-    private static final int URI_DATA            = 3;
+    private static final int URI_NOTE_ITEM       = 2;  // 单条笔记
-    private static final int URI_DATA_ITEM       = 4;
+    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          = 5;  // 搜索
-    private static final int URI_SEARCH_SUGGEST  = 6;
+    private static final int URI_SEARCH_SUGGEST  = 6;  // 搜索建议
 
+    // 静态初始化块，配置URI匹配器
     static {
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
-        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
+        // 添加URI匹配规则
-        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);                      // 匹配笔记集合
-        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);
+        mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);              // 匹配单条笔记
-        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);
+        mMatcher.addURI(Notes.AUTHORITY, "data", URI_DATA);                     // 匹配数据集合
-        mMatcher.addURI(Notes.AUTHORITY, "search", URI_SEARCH);
+        mMatcher.addURI(Notes.AUTHORITY, "data/#", URI_DATA_ITEM);              // 匹配单条数据
-        mMatcher.addURI(Notes.AUTHORITY, SearchManager.SUGGEST_URI_PATH_QUERY, URI_SEARCH_SUGGEST);
+        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); // 匹配搜索建议
+        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.
+     * x'0A'代表SQLite中的换行符'\n'
+     * 对于搜索结果中的标题和内容，我们会去除换行符和空格以显示更多信息
      */
     private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
         + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
@@ -73,50 +79,68 @@ public class NotesProvider extends ContentProvider {
         + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
         + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
 
+    // 笔记片段搜索查询SQL
     private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
         + " FROM " + TABLE.NOTE
-        + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
+        + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"  // 使用LIKE进行模糊匹配
-        + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
+        + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER  // 排除回收站中的笔记
-        + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
+        + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;  // 只搜索普通笔记(非文件夹)
 
+    /**
+     * 内容提供器创建时调用
+     * @return 是否成功创建
+     */
     @Override
     public boolean onCreate() {
+        // 获取数据库帮助类实例
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
 
+    /**
+     * 查询方法
+     * @param uri 请求的URI
+     * @param projection 要返回的列
+     * @param selection 选择条件
+     * @param selectionArgs 选择参数
+     * @param sortOrder 排序方式
+     * @return 查询结果的Cursor
+     */
     @Override
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
             String sortOrder) {
         Cursor c = null;
         SQLiteDatabase db = mHelper.getReadableDatabase();
         String id = null;
+        
+        // 根据URI类型执行不同的查询
         switch (mMatcher.match(uri)) {
-            case URI_NOTE:
+            case URI_NOTE:  // 查询笔记集合
                 c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
                         sortOrder);
                 break;
-            case URI_NOTE_ITEM:
+            case URI_NOTE_ITEM:  // 查询单条笔记
-                id = uri.getPathSegments().get(1);
+                id = uri.getPathSegments().get(1);  // 获取笔记ID
                 c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs, null, null, sortOrder);
                 break;
-            case URI_DATA:
+            case URI_DATA:  // 查询数据集合
                 c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
                         sortOrder);
                 break;
-            case URI_DATA_ITEM:
+            case URI_DATA_ITEM:  // 查询单条数据
-                id = uri.getPathSegments().get(1);
+                id = uri.getPathSegments().get(1);  // 获取数据ID
                 c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs, null, null, sortOrder);
                 break;
-            case URI_SEARCH:
+            case URI_SEARCH:  // 搜索请求
-            case URI_SEARCH_SUGGEST:
+            case URI_SEARCH_SUGGEST:  // 搜索建议请求
                 if (sortOrder != null || projection != null) {
                     throw new IllegalArgumentException(
-                            "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
+                            "搜索查询不支持指定sortOrder、selection、selectionArgs或projection参数");
                 }
 
+                // 获取搜索关键字
                 String searchString = null;
                 if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
                     if (uri.getPathSegments().size() > 1) {
@@ -131,72 +155,92 @@ public class NotesProvider extends ContentProvider {
                 }
 
                 try {
+                    // 格式化搜索字符串(添加通配符)
                     searchString = String.format("%%%s%%", searchString);
+                    // 执行原始SQL查询
                     c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
                             new String[] { searchString });
                 } catch (IllegalStateException ex) {
-                    Log.e(TAG, "got exception: " + ex.toString());
+                    Log.e(TAG, "查询异常: " + ex.toString());
                 }
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("未知URI: " + uri);
         }
+        // 设置内容变化通知URI
         if (c != null) {
             c.setNotificationUri(getContext().getContentResolver(), uri);
         }
         return c;
     }
 
+    /**
+     * 插入数据
+     * @param uri 内容URI
+     * @param values 要插入的值
+     * @return 新插入数据的URI
+     */
     @Override
     public Uri insert(Uri uri, ContentValues values) {
         SQLiteDatabase db = mHelper.getWritableDatabase();
         long dataId = 0, noteId = 0, insertedId = 0;
+        
+        // 根据URI类型执行不同的插入操作
         switch (mMatcher.match(uri)) {
-            case URI_NOTE:
+            case URI_NOTE:  // 插入笔记
                 insertedId = noteId = db.insert(TABLE.NOTE, null, values);
                 break;
-            case URI_DATA:
+            case URI_DATA:  // 插入数据
                 if (values.containsKey(DataColumns.NOTE_ID)) {
                     noteId = values.getAsLong(DataColumns.NOTE_ID);
                 } else {
-                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
+                    Log.d(TAG, "数据格式错误，缺少note id:" + values.toString());
                 }
                 insertedId = dataId = db.insert(TABLE.DATA, null, values);
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("未知URI: " + uri);
         }
-        // Notify the note uri
+        
+        // 通知相关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);
         }
 
+        // 返回新插入数据的URI
         return ContentUris.withAppendedId(uri, insertedId);
     }
 
+    /**
+     * 删除数据
+     * @param uri 内容URI
+     * @param selection 选择条件
+     * @param selectionArgs 选择参数
+     * @return 删除的行数
+     */
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
         int count = 0;
         String id = null;
         SQLiteDatabase db = mHelper.getWritableDatabase();
         boolean deleteData = false;
+        
+        // 根据URI类型执行不同的删除操作
         switch (mMatcher.match(uri)) {
-            case URI_NOTE:
+            case URI_NOTE:  // 删除笔记集合
                 selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
                 count = db.delete(TABLE.NOTE, selection, selectionArgs);
                 break;
-            case URI_NOTE_ITEM:
+            case URI_NOTE_ITEM:  // 删除单条笔记
                 id = uri.getPathSegments().get(1);
                 /**
-                 * ID that smaller than 0 is system folder which is not allowed to
+                 * ID小于0的是系统文件夹，不允许删除
-                 * trash
                  */
                 long noteId = Long.valueOf(id);
                 if (noteId <= 0) {
@@ -205,19 +249,21 @@ public class NotesProvider extends ContentProvider {
                 count = db.delete(TABLE.NOTE,
                         NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
                 break;
-            case URI_DATA:
+            case URI_DATA:  // 删除数据集合
                 count = db.delete(TABLE.DATA, selection, selectionArgs);
                 deleteData = true;
                 break;
-            case URI_DATA_ITEM:
+            case URI_DATA_ITEM:  // 删除单条数据
                 id = uri.getPathSegments().get(1);
                 count = db.delete(TABLE.DATA,
                         DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
                 deleteData = true;
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("未知URI: " + uri);
         }
+        
+        // 通知相关URI的数据变化
         if (count > 0) {
             if (deleteData) {
                 getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
@@ -227,37 +273,48 @@ public class NotesProvider extends ContentProvider {
         return count;
     }
 
+    /**
+     * 更新数据
+     * @param uri 内容URI
+     * @param values 新值
+     * @param selection 选择条件
+     * @param selectionArgs 选择参数
+     * @return 更新的行数
+     */
     @Override
     public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
         int count = 0;
         String id = null;
         SQLiteDatabase db = mHelper.getWritableDatabase();
         boolean updateData = false;
+        
+        // 根据URI类型执行不同的更新操作
         switch (mMatcher.match(uri)) {
-            case URI_NOTE:
+            case URI_NOTE:  // 更新笔记集合
-                increaseNoteVersion(-1, selection, selectionArgs);
+                increaseNoteVersion(-1, selection, selectionArgs);  // 增加版本号
                 count = db.update(TABLE.NOTE, values, selection, selectionArgs);
                 break;
-            case URI_NOTE_ITEM:
+            case URI_NOTE_ITEM:  // 更新单条笔记
                 id = uri.getPathSegments().get(1);
-                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);  // 增加版本号
                 count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs);
                 break;
-            case URI_DATA:
+            case URI_DATA:  // 更新数据集合
                 count = db.update(TABLE.DATA, values, selection, selectionArgs);
                 updateData = true;
                 break;
-            case URI_DATA_ITEM:
+            case URI_DATA_ITEM:  // 更新单条数据
                 id = uri.getPathSegments().get(1);
                 count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id
                         + parseSelection(selection), selectionArgs);
                 updateData = true;
                 break;
             default:
-                throw new IllegalArgumentException("Unknown URI " + uri);
+                throw new IllegalArgumentException("未知URI: " + uri);
         }
 
+        // 通知相关URI的数据变化
         if (count > 0) {
             if (updateData) {
                 getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
@@ -267,17 +324,28 @@ public class NotesProvider extends ContentProvider {
         return count;
     }
 
+    /**
+     * 解析选择条件，添加AND连接
+     * @param selection 原始选择条件
+     * @return 解析后的选择条件
+     */
     private String parseSelection(String selection) {
         return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
     }
 
+    /**
+     * 增加笔记版本号
+     * @param id 笔记ID
+     * @param selection 选择条件
+     * @param selectionArgs 选择参数
+     */
     private void increaseNoteVersion(long id, String selection, String[] selectionArgs) {
         StringBuilder sql = new StringBuilder(120);
         sql.append("UPDATE ");
         sql.append(TABLE.NOTE);
         sql.append(" SET ");
         sql.append(NoteColumns.VERSION);
-        sql.append("=" + NoteColumns.VERSION + "+1 ");
+        sql.append("=" + NoteColumns.VERSION + "+1 ");  // 版本号+1
 
         if (id > 0 || !TextUtils.isEmpty(selection)) {
             sql.append(" WHERE ");
@@ -293,13 +361,18 @@ public class NotesProvider extends ContentProvider {
             sql.append(selectString);
         }
 
+        // 执行SQL语句
         mHelper.getWritableDatabase().execSQL(sql.toString());
     }
 
+    /**
+     * 获取URI对应的MIME类型
+     * @param uri 内容URI
+     * @return MIME类型字符串
+     */
     @Override
     public String getType(Uri uri) {
-        // TODO Auto-generated method stub
+        // TODO 待实现
         return null;
     }
-
+}
-}

src/tool/BackupUtils.java

@@ -0,0 +1,427 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.Context;
+import android.database.Cursor;
+import android.os.Environment;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+
+/**
+ * 笔记备份工具类，提供将笔记数据导出为文本文件的功能
+ * 支持导出文件夹、普通笔记和通话记录笔记到SD卡指定路径
+ */
+public class BackupUtils {
+    private static final String TAG = "BackupUtils";
+    // 单例实例
+    private static BackupUtils sInstance;
+
+    /**
+     * 获取单例实例
+     * @param context 应用上下文
+     * @return BackupUtils实例
+     */
+    public static synchronized BackupUtils getInstance(Context context) {
+        if (sInstance == null) {
+            sInstance = new BackupUtils(context);
+        }
+        return sInstance;
+    }
+
+    /**
+     * 备份/恢复状态码定义
+     * STATE_SD_CARD_UNMOUONTED: SD卡未挂载
+     * STATE_BACKUP_FILE_NOT_EXIST: 备份文件不存在
+     * STATE_DATA_DESTROIED: 数据损坏
+     * STATE_SYSTEM_ERROR: 系统错误
+     * STATE_SUCCESS: 操作成功
+     */
+    public static final int STATE_SD_CARD_UNMOUONTED           = 0;
+    public static final int STATE_BACKUP_FILE_NOT_EXIST        = 1;
+    public static final int STATE_DATA_DESTROIED               = 2;
+    public static final int STATE_SYSTEM_ERROR                 = 3;
+    public static final int STATE_SUCCESS                      = 4;
+
+    private final TextExport mTextExport; // 文本导出模块
+
+    /**
+     * 构造方法，初始化文本导出模块
+     * @param context 应用上下文
+     */
+    private BackupUtils(Context context) {
+        mTextExport = new TextExport(context);
+    }
+
+    /**
+     * 检查外部存储是否可用（已挂载）
+     * @return true if SD卡可用
+     */
+    private static boolean externalStorageAvailable() {
+        return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
+    }
+
+    /**
+     * 执行笔记导出操作
+     * @return 状态码（参考STATE_*常量）
+     */
+    public int exportToText() {
+        return mTextExport.exportToText();
+    }
+
+    /**
+     * 获取导出的文本文件名
+     * @return 文件名（如"notes_20231001.txt"）
+     */
+    public String getExportedTextFileName() {
+        return mTextExport.mFileName;
+    }
+
+    /**
+     * 获取导出文件的存储目录
+     * @return 目录路径（如"/sdcard/notes_backup/"）
+     */
+    public String getExportedTextFileDir() {
+        return mTextExport.mFileDirectory;
+    }
+
+    /**
+     * 文本导出核心实现类
+     */
+    private static class TextExport {
+        // 笔记查询投影（仅获取必要字段）
+        private static final String[] NOTE_PROJECTION = {
+                NoteColumns.ID,          // 笔记ID
+                NoteColumns.MODIFIED_DATE, // 最后修改时间
+                NoteColumns.SNIPPET,     // 摘要（文件夹名称/笔记标题）
+                NoteColumns.TYPE         // 类型（文件夹/笔记）
+        };
+        // 投影字段索引
+        private static final int NOTE_COLUMN_ID = 0;
+        private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
+        private static final int NOTE_COLUMN_SNIPPET = 2;
+
+        // 笔记内容数据查询投影
+        private static final String[] DATA_PROJECTION = {
+                DataColumns.CONTENT,     // 内容（文本/位置信息）
+                DataColumns.MIME_TYPE,   // MIME类型（区分普通笔记/通话记录）
+                DataColumns.DATA1,       // 预留字段1（通话记录中为日期？）
+                DataColumns.DATA2,       // 预留字段2
+                DataColumns.DATA3,       // 预留字段3
+                DataColumns.DATA4,       // 电话号码（通话记录专用）
+        };
+        // 数据投影字段索引
+        private static final int DATA_COLUMN_CONTENT = 0;
+        private static final int DATA_COLUMN_MIME_TYPE = 1;
+        private static final int DATA_COLUMN_CALL_DATE = 2; // DATA1的别名（通话时间）
+        private static final int DATA_COLUMN_PHONE_NUMBER = 4; // DATA4的别名（电话号码）
+
+        // 导出格式模板（对应res/array/format_for_exported_note.xml）
+        private final String[] TEXT_FORMAT;
+        // 格式模板索引
+        private static final int FORMAT_FOLDER_NAME          = 0; // 文件夹名称格式
+        private static final int FORMAT_NOTE_DATE            = 1; // 笔记日期格式
+        private static final int FORMAT_NOTE_CONTENT         = 2; // 笔记内容格式
+
+        private final Context mContext;
+        private String mFileName;       // 导出文件名
+        private String mFileDirectory;  // 导出文件目录
+
+        /**
+         * 构造方法，加载格式模板
+         * @param context 应用上下文
+         */
+        public TextExport(Context context) {
+            // 从资源文件获取导出格式模板
+            TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
+            mContext = context;
+        }
+
+        /**
+         * 获取指定索引的格式模板
+         * @param id 格式索引（FORMAT_*常量）
+         * @return 格式字符串
+         */
+        private String getFormat(int id) {
+            return TEXT_FORMAT[id];
+        }
+
+        /**
+         * 将指定文件夹及其子笔记导出到文本流
+         * @param folderId 文件夹ID
+         * @param ps 输出流
+         */
+        private void exportFolderToText(String folderId, PrintStream ps) {
+            // 查询该文件夹下的所有笔记
+            Cursor notesCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION,
+                    NoteColumns.PARENT_ID + "=?", // 条件：父级ID为当前文件夹ID
+                    new String[]{folderId},
+                    null
+            );
+
+            if (notesCursor != null) {
+                try {
+                    if (notesCursor.moveToFirst()) {
+                        do {
+                            // 打印笔记最后修改时间
+                            String dateStr = DateFormat.format(
+                                    mContext.getString(R.string.format_datetime_mdhm), // 格式：MM月dd日 HH:mm
+                                    notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
+                            ).toString();
+                            ps.println(String.format(getFormat(FORMAT_NOTE_DATE), dateStr));
+
+                            // 导出笔记内容
+                            String noteId = notesCursor.getString(NOTE_COLUMN_ID);
+                            exportNoteToText(noteId, ps);
+                        } while (notesCursor.moveToNext());
+                    }
+                } finally {
+                    notesCursor.close(); // 释放游标资源
+                }
+            }
+        }
+
+        /**
+         * 将指定笔记内容导出到文本流
+         * @param noteId 笔记ID
+         * @param ps 输出流
+         */
+        private void exportNoteToText(String noteId, PrintStream ps) {
+            // 查询笔记对应的内容数据（如文本内容、通话记录）
+            Cursor dataCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_DATA_URI,
+                    DATA_PROJECTION,
+                    DataColumns.NOTE_ID + "=?", // 条件：属于该笔记ID
+                    new String[]{noteId},
+                    null
+            );
+
+            if (dataCursor != null) {
+                try {
+                    if (dataCursor.moveToFirst()) {
+                        do {
+                            String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
+                            if (DataConstants.CALL_NOTE.equals(mimeType)) {
+                                // 处理通话记录笔记
+                                String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
+                                long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
+                                String location = dataCursor.getString(DATA_COLUMN_CONTENT); // 通话位置或备注
+
+                                // 打印电话号码
+                                if (!TextUtils.isEmpty(phoneNumber)) {
+                                    ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), phoneNumber));
+                                }
+                                // 打印通话时间
+                                String callDateStr = DateFormat.format(
+                                        mContext.getString(R.string.format_datetime_mdhm),
+                                        callDate
+                                ).toString();
+                                ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), callDateStr));
+                                // 打印位置信息
+                                if (!TextUtils.isEmpty(location)) {
+                                    ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), location));
+                                }
+                            } else if (DataConstants.NOTE.equals(mimeType)) {
+                                // 处理普通文本笔记
+                                String content = dataCursor.getString(DATA_COLUMN_CONTENT);
+                                if (!TextUtils.isEmpty(content)) {
+                                    ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), content));
+                                }
+                            }
+                        } while (dataCursor.moveToNext());
+                    }
+                } finally {
+                    dataCursor.close(); // 释放游标资源
+                }
+            }
+            // 打印分隔符（换行符+特殊字符，可能用于区分笔记）
+            try {
+                ps.write(new byte[]{Character.LINE_SEPARATOR, Character.LETTER_NUMBER});
+            } catch (IOException e) {
+                Log.e(TAG, "写入分隔符失败：" + e.getMessage());
+            }
+        }
+
+        /**
+         * 执行完整的导出流程
+         * @return 导出状态码
+         */
+        public int exportToText() {
+            // 检查SD卡是否可用
+            if (!externalStorageAvailable()) {
+                Log.d(TAG, "SD卡未挂载，无法导出");
+                return STATE_SD_CARD_UNMOUONTED;
+            }
+
+            // 获取输出流
+            PrintStream ps = getExportToTextPrintStream();
+            if (ps == null) {
+                Log.e(TAG, "创建输出流失败");
+                return STATE_SYSTEM_ERROR;
+            }
+
+            // 导出文件夹及其笔记
+            String whereClause = "(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND " +
+                    NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR " +
+                    NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER; // 排除回收站，包含通话记录文件夹
+
+            Cursor folderCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION,
+                    whereClause,
+                    null,
+                    null
+            );
+
+            if (folderCursor != null) {
+                try {
+                    if (folderCursor.moveToFirst()) {
+                        do {
+                            String folderName;
+                            // 处理特殊文件夹：通话记录文件夹使用固定名称
+                            if (folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
+                                folderName = mContext.getString(R.string.call_record_folder_name);
+                            } else {
+                                folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET); // 使用文件夹摘要作为名称
+                            }
+                            // 打印文件夹名称
+                            if (!TextUtils.isEmpty(folderName)) {
+                                ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
+                            }
+                            String folderId = folderCursor.getString(NOTE_COLUMN_ID);
+                            exportFolderToText(folderId, ps); // 导出文件夹下的笔记
+                        } while (folderCursor.moveToNext());
+                    }
+                } finally {
+                    folderCursor.close();
+                }
+            }
+
+            // 导出根目录下的普通笔记（父级ID=0）
+            Cursor noteCursor = mContext.getContentResolver().query(
+                    Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION,
+                    NoteColumns.TYPE + "=" + Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID + "=0",
+                    null,
+                    null
+            );
+
+            if (noteCursor != null) {
+                try {
+                    if (noteCursor.moveToFirst()) {
+                        do {
+                            String dateStr = DateFormat.format(
+                                    mContext.getString(R.string.format_datetime_mdhm),
+                                    noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
+                            ).toString();
+                            ps.println(String.format(getFormat(FORMAT_NOTE_DATE), dateStr));
+                            String noteId = noteCursor.getString(NOTE_COLUMN_ID);
+                            exportNoteToText(noteId, ps); // 导出笔记内容
+                        } while (noteCursor.moveToNext());
+                    }
+                } finally {
+                    noteCursor.close();
+                }
+            }
+
+            ps.close(); // 关闭输出流
+            return STATE_SUCCESS;
+        }
+
+        /**
+         * 获取导出文件的打印流
+         * @return PrintStream实例，失败时返回null
+         */
+        private PrintStream getExportToTextPrintStream() {
+            // 生成文件路径（如/sdcard/notes_backup/notes_20231001.txt）
+            File file = generateFileMountedOnSDcard(
+                    mContext,
+                    R.string.file_path,       // 目录路径（如"/notes_backup/"）
+                    R.string.file_name_txt_format // 文件名格式（如"notes_%s.txt"）
+            );
+            if (file == null) {
+                return null;
+            }
+            mFileName = file.getName();
+            mFileDirectory = mContext.getString(R.string.file_path); // 存储目录路径
+
+            // 创建文件输出流
+            try {
+                FileOutputStream fos = new FileOutputStream(file);
+                return new PrintStream(fos);
+            } catch (FileNotFoundException e) {
+                Log.e(TAG, "文件未找到：" + e.getMessage());
+            } catch (NullPointerException e) {
+                Log.e(TAG, "空指针异常：" + e.getMessage());
+            }
+            return null;
+        }
+    }
+
+    /**
+     * 在SD卡生成备份文件
+     * @param context 应用上下文
+     * @param filePathResId 目录路径资源ID（如R.string.file_path）
+     * @param fileNameFormatResId 文件名格式资源ID（如R.string.file_name_txt_format）
+     * @return 生成的文件对象，失败时返回null
+     */
+    private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
+        // 构建文件路径：SD卡根目录 + 自定义目录 + 文件名
+        StringBuilder sb = new StringBuilder();
+        sb.append(Environment.getExternalStorageDirectory()); // SD卡根目录
+        sb.append(context.getString(filePathResId)); // 自定义目录（如"/notes_backup/"）
+        File filedir = new File(sb.toString()); // 目录对象
+
+        // 构建文件名：格式字符串 + 当前日期（如"notes_20231001.txt"）
+        sb.append(context.getString(
+                fileNameFormatResId,
+                DateFormat.format(context.getString(R.string.format_date_ymd), System.currentTimeMillis()) // 日期格式：yyyyMMdd
+        ));
+        File file = new File(sb.toString()); // 文件对象
+
+        // 创建目录和文件（若不存在）
+        try {
+            if (!filedir.exists() && !filedir.mkdirs()) {
+                Log.e(TAG, "创建目录失败：" + filedir.getPath());
+                return null;
+            }
+            if (!file.exists() && !file.createNewFile()) {
+                Log.e(TAG, "创建文件失败：" + file.getPath());
+                return null;
+            }
+            return file;
+        } catch (SecurityException | IOException e) {
+            Log.e(TAG, "文件操作失败：" + e.getMessage());
+            return null;
+        }
+    }
+}

src/tool/DataUtils.java

@@ -0,0 +1,392 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.OperationApplicationException;
+import android.database.Cursor;
+import android.os.RemoteException;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+
+/**
+ * 数据操作工具类，提供笔记数据的批量删除、移动、查询等功能
+ * 涉及内容提供者（ContentProvider）的操作，用于管理笔记数据库
+ */
+public class DataUtils {
+    public static final String TAG = "DataUtils";
+
+    /**
+     * 批量删除笔记
+     * @param resolver 内容解析器
+     * @param ids 待删除的笔记ID集合（跳过系统根文件夹）
+     * @return 删除是否成功
+     */
+    public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
+        if (ids == null) {
+            Log.d(TAG, "待删除的ID集合为空");
+            return true;
+        }
+        if (ids.size() == 0) {
+            Log.d(TAG, "ID集合中无有效数据");
+            return true;
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
+        for (long id : ids) {
+            // 跳过系统根文件夹（禁止删除）
+            if (id == Notes.ID_ROOT_FOLDER) {
+                Log.e(TAG, "尝试删除系统根文件夹，已忽略");
+                continue;
+            }
+            // 创建删除操作：根据ID构建删除URI
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            operationList.add(builder.build());
+        }
+        try {
+            // 执行批量操作
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            // 检查操作结果
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "删除失败，ID集合：" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException | OperationApplicationException e) {
+            Log.e(TAG, "批量删除异常：" + e.getMessage());
+            e.printStackTrace();
+        }
+        return false;
+    }
+
+    /**
+     * 将单个笔记移动到目标文件夹
+     * @param resolver 内容解析器
+     * @param id 待移动的笔记ID
+     * @param srcFolderId 源文件夹ID（记录原始位置）
+     * @param desFolderId 目标文件夹ID
+     */
+    public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
+        ContentValues values = new ContentValues();
+        // 更新父级ID为目标文件夹ID
+        values.put(NoteColumns.PARENT_ID, desFolderId);
+        // 记录原始父级ID（用于同步或回滚）
+        values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
+        // 标记本地修改（可能用于同步逻辑）
+        values.put(NoteColumns.LOCAL_MODIFIED, 1);
+        // 执行更新操作
+        resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
+    }
+
+    /**
+     * 批量移动笔记到目标文件夹
+     * @param resolver 内容解析器
+     * @param ids 待移动的笔记ID集合
+     * @param folderId 目标文件夹ID
+     * @return 移动是否成功
+     */
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids, long folderId) {
+        if (ids == null) {
+            Log.d(TAG, "待移动的ID集合为空");
+            return true;
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<>();
+        for (long id : ids) {
+            // 创建更新操作：设置父级ID并标记本地修改
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            builder.withValue(NoteColumns.PARENT_ID, folderId);
+            builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);
+            operationList.add(builder.build());
+        }
+
+        try {
+            // 执行批量操作
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            // 检查操作结果
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "移动失败，ID集合：" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException | OperationApplicationException e) {
+            Log.e(TAG, "批量移动异常：" + e.getMessage());
+            e.printStackTrace();
+        }
+        return false;
+    }
+
+    /**
+     * 获取用户创建的文件夹数量（排除系统文件夹和回收站）
+     * @param resolver 内容解析器
+     * @return 文件夹数量
+     */
+    public static int getUserFolderCount(ContentResolver resolver) {
+        // 查询条件：类型为文件夹，且父级ID不是回收站ID
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[]{"COUNT(*)"},
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+                new String[]{String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
+                null);
+
+        int count = 0;
+        if (cursor != null) {
+            try {
+                if (cursor.moveToFirst()) {
+                    count = cursor.getInt(0); // 获取计数结果
+                }
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "查询文件夹数量失败：" + e.getMessage());
+            } finally {
+                cursor.close(); // 关闭游标释放资源
+            }
+        }
+        return count;
+    }
+
+    /**
+     * 检查笔记是否在数据库中可见（非回收站）
+     * @param resolver 内容解析器
+     * @param noteId 笔记ID
+     * @param type 笔记类型（如Notes.TYPE_NOTE或Notes.TYPE_FOLDER）
+     * @return 是否可见（存在且不在回收站）
+     */
+    public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
+        // 查询条件：类型匹配且父级ID不是回收站ID
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+                null,
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
+                new String[]{String.valueOf(type)},
+                null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0; // 存在有效记录则可见
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查笔记是否存在于数据库中（不判断是否在回收站）
+     * @param resolver 内容解析器
+     * @param noteId 笔记ID
+     * @return 是否存在
+     */
+    public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
+        // 直接查询笔记ID是否存在
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查数据项是否存在于数据库中（如笔记内容数据）
+     * @param resolver 内容解析器
+     * @param dataId 数据项ID
+     * @return 是否存在
+     */
+    public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
+        // 查询数据项URI对应的记录
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
+                null, null, null, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 检查文件夹名称是否已存在（非回收站的可见文件夹）
+     * @param resolver 内容解析器
+     * @param name 文件夹名称
+     * @return 是否存在同名文件夹
+     */
+    public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
+        // 查询条件：类型为文件夹，不在回收站，且名称匹配
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
+                NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
+                        " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
+                        " AND " + NoteColumns.SNIPPET + "=?",
+                new String[]{name}, null);
+
+        boolean exist = false;
+        if (cursor != null) {
+            exist = cursor.getCount() > 0;
+            cursor.close();
+        }
+        return exist;
+    }
+
+    /**
+     * 获取文件夹关联的桌面小部件属性集合
+     * @param resolver 内容解析器
+     * @param folderId 文件夹ID
+     * @return 小部件属性集合（AppWidgetAttribute）
+     */
+    public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
+        // 查询该文件夹下所有笔记的小部件ID和类型
+        Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[]{NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE},
+                NoteColumns.PARENT_ID + "=?",
+                new String[]{String.valueOf(folderId)},
+                null);
+
+        HashSet<AppWidgetAttribute> set = null;
+        if (c != null) {
+            set = new HashSet<>();
+            try {
+                if (c.moveToFirst()) {
+                    do {
+                        AppWidgetAttribute widget = new AppWidgetAttribute();
+                        widget.widgetId = c.getInt(0);       // 小部件ID
+                        widget.widgetType = c.getInt(1);     // 小部件类型
+                        set.add(widget);
+                    } while (c.moveToNext());
+                }
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "解析小部件数据失败：" + e.getMessage());
+            } finally {
+                c.close();
+            }
+        }
+        return set;
+    }
+
+    /**
+     * 根据笔记ID获取通话记录中的电话号码
+     * @param resolver 内容解析器
+     * @param noteId 通话笔记ID
+     * @return 电话号码（空字符串表示未找到）
+     */
+    public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
+        // 查询通话笔记对应的电话号码（通过MIME类型过滤）
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String[]{CallNote.PHONE_NUMBER},
+                CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
+                new String[]{String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE},
+                null);
+
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                return cursor.getString(0); // 获取电话号码
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "获取电话号码失败：" + e.getMessage());
+            } finally {
+                cursor.close();
+            }
+        }
+        return "";
+    }
+
+    /**
+     * 根据电话号码和通话时间获取对应的笔记ID
+     * @param resolver 内容解析器
+     * @param phoneNumber 电话号码
+     * @param callDate 通话时间戳
+     * @return 笔记ID（0表示未找到）
+     */
+    public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
+        // 使用PHONE_NUMBERS_EQUAL函数进行模糊匹配（处理格式差异）
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String[]{CallNote.NOTE_ID},
+                CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+                        + CallNote.PHONE_NUMBER + ",?)",
+                new String[]{String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber},
+                null);
+
+        long noteId = 0;
+        if (cursor != null) {
+            try {
+                if (cursor.moveToFirst()) {
+                    noteId = cursor.getLong(0); // 获取笔记ID
+                }
+            } catch (IndexOutOfBoundsException e) {
+                Log.e(TAG, "获取通话笔记ID失败：" + e.getMessage());
+            } finally {
+                cursor.close();
+            }
+        }
+        return noteId;
+    }
+
+    /**
+     * 根据笔记ID获取摘要内容
+     * @param resolver 内容解析器
+     * @param noteId 笔记ID
+     * @return 摘要内容（若不存在则抛出异常）
+     */
+    public static String getSnippetById(ContentResolver resolver, long noteId) {
+        // 查询笔记的摘要字段
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[]{NoteColumns.SNIPPET},
+                NoteColumns.ID + "=?",
+                new String[]{String.valueOf(noteId)},
+                null);
+
+        if (cursor != null) {
+            String snippet = "";
+            try {
+                if (cursor.moveToFirst()) {
+                    snippet = cursor.getString(0); // 获取摘要
+                }
+            } finally {
+                cursor.close();
+            }
+            return snippet;
+        }
+        throw new IllegalArgumentException("未找到ID为 " + noteId + " 的笔记");
+    }
+
+    /**
+     * 格式化摘要内容：截断换行符前的内容并去首尾空格
+     * @param snippet 原始摘要
+     * @return 格式化后的摘要
+     */
+    public static String getFormattedSnippet(String snippet) {
+        if (snippet != null) {
+            snippet = snippet.trim(); // 去除首尾空格
+            int index = snippet.indexOf('\n');
+            if (index != -1) {
+                snippet = snippet.substring(0, index); // 截断到第一个换行符
+            }
+        }
+        return snippet;
+    }
+}

src/tool/GTaskStringUtils.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+/**
+ * Google Tasks同步相关的字符串常量工具类
+ * 定义了与Google Tasks API交互时使用的JSON字段名、文件夹名称和元数据标识
+ */
+public class GTaskStringUtils {
+
+    // --------------- JSON请求/响应字段名常量 ---------------
+
+    // 操作相关字段
+    public final static String GTASK_JSON_ACTION_ID = "action_id";          // 操作ID
+    public final static String GTASK_JSON_ACTION_LIST = "action_list";      // 操作列表
+    public final static String GTASK_JSON_ACTION_TYPE = "action_type";      // 操作类型
+    public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";    // 创建操作
+    public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";   // 获取所有操作
+    public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";        // 移动操作
+    public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";    // 更新操作
+
+    // 实体相关字段
+    public final static String GTASK_JSON_CREATOR_ID = "creator_id";        // 创建者ID
+    public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";    // 子实体
+    public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";    // 实体变更
+    public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";      // 实体类型
+
+    // 任务/列表属性字段
+    public final static String GTASK_JSON_CLIENT_VERSION = "client_version";// 客户端版本
+    public final static String GTASK_JSON_COMPLETED = "completed";          // 完成状态
+    public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";// 当前列表ID
+    public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";// 默认列表ID
+    public final static String GTASK_JSON_DELETED = "deleted";              // 删除状态
+    public final static String GTASK_JSON_DEST_LIST = "dest_list";          // 目标列表
+    public final static String GTASK_JSON_DEST_PARENT = "dest_parent";      // 目标父级
+    public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";// 目标父级类型
+    public final static String GTASK_JSON_ID = "id";                          // ID
+    public final static String GTASK_JSON_INDEX = "index";                    // 索引位置
+    public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";  // 最后修改时间
+    public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";// 最新同步点
+    public final static String GTASK_JSON_LIST_ID = "list_id";                // 列表ID
+    public final static String GTASK_JSON_LISTS = "lists";                    // 列表集合
+    public final static String GTASK_JSON_NAME = "name";                      // 名称
+    public final static String GTASK_JSON_NEW_ID = "new_id";                  // 新ID
+    public final static String GTASK_JSON_NOTES = "notes";                    // 备注
+    public final static String GTASK_JSON_PARENT_ID = "parent_id";            // 父级ID
+    public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";// 前一个兄弟节点ID
+    public final static String GTASK_JSON_RESULTS = "results";                // 结果集
+    public final static String GTASK_JSON_SOURCE_LIST = "source_list";        // 源列表
+    public final static String GTASK_JSON_TASKS = "tasks";                    // 任务集合
+    public final static String GTASK_JSON_TYPE = "type";                      // 类型
+    public final static String GTASK_JSON_TYPE_GROUP = "GROUP";              // 组类型
+    public final static String GTASK_JSON_TYPE_TASK = "TASK";                // 任务类型
+    public final static String GTASK_JSON_USER = "user";                      // 用户
+
+    // --------------- 特殊文件夹和元数据相关常量 ---------------
+
+    // MIUI笔记文件夹前缀，用于标识由MIUI笔记创建的Google Tasks文件夹
+    public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]";
+
+    // 默认文件夹名称
+    public final static String FOLDER_DEFAULT = "Default";            // 默认任务列表
+    public final static String FOLDER_CALL_NOTE = "Call_Note";        // 通话记录笔记
+    public final static String FOLDER_META = "METADATA";              // 元数据文件夹
+
+    // 元数据头部标识
+    public final static String META_HEAD_GTASK_ID = "meta_gid";       // Google Tasks ID元数据
+    public final static String META_HEAD_NOTE = "meta_note";          // 笔记元数据
+    public final static String META_HEAD_DATA = "meta_data";          // 数据元数据
+
+    // 元数据笔记名称，提示用户不要更新或删除
+    public final static String META_NOTE_NAME = "[META INFO] DON'T UPDATE AND DELETE";
+}

src/tool/ResourceParser.java

@@ -0,0 +1,273 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.tool;
+
+import android.content.Context;
+import android.preference.PreferenceManager;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+/**
+ * 资源解析工具类，用于管理和获取笔记应用中的各种资源
+ * 包括背景色、字体大小、各种视图的背景资源等
+ */
+public class ResourceParser {
+
+    // 笔记背景颜色常量定义
+    public static final int YELLOW           = 0;  // 黄色背景
+    public static final int BLUE             = 1;  // 蓝色背景
+    public static final int WHITE            = 2;  // 白色背景
+    public static final int GREEN            = 3;  // 绿色背景
+    public static final int RED              = 4;  // 红色背景
+
+    public static final int BG_DEFAULT_COLOR = YELLOW;  // 默认背景颜色为黄色
+
+    // 字体大小常量定义
+    public static final int TEXT_SMALL       = 0;  // 小号字体
+    public static final int TEXT_MEDIUM      = 1;  // 中号字体(默认)
+    public static final int TEXT_LARGE       = 2;  // 大号字体
+    public static final int TEXT_SUPER       = 3;  // 超大号字体
+
+    public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM;  // 默认字体大小为中号
+
+    /**
+     * 笔记编辑界面背景资源管理类
+     * 提供获取不同颜色笔记编辑界面背景和标题栏背景资源的方法
+     */
+    public static class NoteBgResources {
+        // 笔记编辑界面背景资源数组，按颜色索引
+        private final static int [] BG_EDIT_RESOURCES = new int [] {
+                R.drawable.edit_yellow,    // 黄色背景
+                R.drawable.edit_blue,      // 蓝色背景
+                R.drawable.edit_white,     // 白色背景
+                R.drawable.edit_green,     // 绿色背景
+                R.drawable.edit_red        // 红色背景
+        };
+
+        // 笔记编辑界面标题栏背景资源数组，按颜色索引
+        private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
+                R.drawable.edit_title_yellow,  // 黄色标题栏
+                R.drawable.edit_title_blue,    // 蓝色标题栏
+                R.drawable.edit_title_white,   // 白色标题栏
+                R.drawable.edit_title_green,   // 绿色标题栏
+                R.drawable.edit_title_red      // 红色标题栏
+        };
+
+        /**
+         * 根据颜色ID获取笔记编辑界面背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的背景资源ID
+         */
+        public static int getNoteBgResource(int id) {
+            return BG_EDIT_RESOURCES[id];
+        }
+
+        /**
+         * 根据颜色ID获取笔记编辑界面标题栏背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的标题栏背景资源ID
+         */
+        public static int getNoteTitleBgResource(int id) {
+            return BG_EDIT_TITLE_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 获取默认笔记背景颜色ID
+     * 根据用户设置决定是返回随机颜色还是默认颜色
+     * @param context 应用上下文
+     * @return 背景颜色ID
+     */
+    public static int getDefaultBgId(Context context) {
+        // 检查用户是否开启了"随机背景色"设置
+        if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
+                NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
+            // 随机生成一个颜色ID
+            return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
+        } else {
+            // 返回默认颜色ID
+            return BG_DEFAULT_COLOR;
+        }
+    }
+
+    /**
+     * 笔记列表项背景资源管理类
+     * 提供获取不同位置(首项、中间项、末项、单项)和不同颜色的笔记列表项背景资源
+     */
+    public static class NoteItemBgResources {
+        // 列表首项背景资源数组，按颜色索引
+        private final static int [] BG_FIRST_RESOURCES = new int [] {
+                R.drawable.list_yellow_up,    // 黄色首项背景
+                R.drawable.list_blue_up,      // 蓝色首项背景
+                R.drawable.list_white_up,     // 白色首项背景
+                R.drawable.list_green_up,     // 绿色首项背景
+                R.drawable.list_red_up        // 红色首项背景
+        };
+
+        // 列表中间项背景资源数组，按颜色索引
+        private final static int [] BG_NORMAL_RESOURCES = new int [] {
+                R.drawable.list_yellow_middle,  // 黄色中间项背景
+                R.drawable.list_blue_middle,    // 蓝色中间项背景
+                R.drawable.list_white_middle,   // 白色中间项背景
+                R.drawable.list_green_middle,   // 绿色中间项背景
+                R.drawable.list_red_middle      // 红色中间项背景
+        };
+
+        // 列表末项背景资源数组，按颜色索引
+        private final static int [] BG_LAST_RESOURCES = new int [] {
+                R.drawable.list_yellow_down,    // 黄色末项背景
+                R.drawable.list_blue_down,      // 蓝色末项背景
+                R.drawable.list_white_down,     // 白色末项背景
+                R.drawable.list_green_down,     // 绿色末项背景
+                R.drawable.list_red_down,       // 红色末项背景
+        };
+
+        // 列表单项(只有一项)背景资源数组，按颜色索引
+        private final static int [] BG_SINGLE_RESOURCES = new int [] {
+                R.drawable.list_yellow_single,  // 黄色单项背景
+                R.drawable.list_blue_single,    // 蓝色单项背景
+                R.drawable.list_white_single,   // 白色单项背景
+                R.drawable.list_green_single,   // 绿色单项背景
+                R.drawable.list_red_single      // 红色单项背景
+        };
+
+        /**
+         * 根据颜色ID获取列表首项背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的首项背景资源ID
+         */
+        public static int getNoteBgFirstRes(int id) {
+            return BG_FIRST_RESOURCES[id];
+        }
+
+        /**
+         * 根据颜色ID获取列表末项背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的末项背景资源ID
+         */
+        public static int getNoteBgLastRes(int id) {
+            return BG_LAST_RESOURCES[id];
+        }
+
+        /**
+         * 根据颜色ID获取列表单项背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的单项背景资源ID
+         */
+        public static int getNoteBgSingleRes(int id) {
+            return BG_SINGLE_RESOURCES[id];
+        }
+
+        /**
+         * 根据颜色ID获取列表中间项背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的中间项背景资源ID
+         */
+        public static int getNoteBgNormalRes(int id) {
+            return BG_NORMAL_RESOURCES[id];
+        }
+
+        /**
+         * 获取文件夹背景资源
+         * @return 文件夹背景资源ID
+         */
+        public static int getFolderBgRes() {
+            return R.drawable.list_folder;
+        }
+    }
+
+    /**
+     * 桌面小部件背景资源管理类
+     * 提供获取不同尺寸(2x和4x)和不同颜色的小部件背景资源
+     */
+    public static class WidgetBgResources {
+        // 2x尺寸小部件背景资源数组，按颜色索引
+        private final static int [] BG_2X_RESOURCES = new int [] {
+                R.drawable.widget_2x_yellow,  // 黄色2x小部件背景
+                R.drawable.widget_2x_blue,    // 蓝色2x小部件背景
+                R.drawable.widget_2x_white,   // 白色2x小部件背景
+                R.drawable.widget_2x_green,   // 绿色2x小部件背景
+                R.drawable.widget_2x_red,     // 红色2x小部件背景
+        };
+
+        /**
+         * 根据颜色ID获取2x尺寸小部件背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的2x小部件背景资源ID
+         */
+        public static int getWidget2xBgResource(int id) {
+            return BG_2X_RESOURCES[id];
+        }
+
+        // 4x尺寸小部件背景资源数组，按颜色索引
+        private final static int [] BG_4X_RESOURCES = new int [] {
+                R.drawable.widget_4x_yellow,  // 黄色4x小部件背景
+                R.drawable.widget_4x_blue,    // 蓝色4x小部件背景
+                R.drawable.widget_4x_white,   // 白色4x小部件背景
+                R.drawable.widget_4x_green,   // 绿色4x小部件背景
+                R.drawable.widget_4x_red      // 红色4x小部件背景
+        };
+
+        /**
+         * 根据颜色ID获取4x尺寸小部件背景资源
+         * @param id 颜色ID (0-4)
+         * @return 对应的4x小部件背景资源ID
+         */
+        public static int getWidget4xBgResource(int id) {
+            return BG_4X_RESOURCES[id];
+        }
+    }
+
+    /**
+     * 文本样式资源管理类
+     * 提供获取不同字体大小的文本样式资源
+     */
+    public static class TextAppearanceResources {
+        // 文本样式资源数组，按字体大小索引
+        private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
+                R.style.TextAppearanceNormal,   // 小号字体样式
+                R.style.TextAppearanceMedium,   // 中号字体样式
+                R.style.TextAppearanceLarge,    // 大号字体样式
+                R.style.TextAppearanceSuper     // 超大号字体样式
+        };
+
+        /**
+         * 根据字体大小ID获取文本样式资源
+         * @param id 字体大小ID (0-3)
+         * @return 对应的文本样式资源ID
+         */
+        public static int getTexAppearanceResource(int id) {
+            /**
+             * HACKME: 修复在共享偏好中存储资源ID的问题
+             * 如果ID大于资源数组长度，返回默认字体大小对应的资源ID
+             */
+            if (id >= TEXTAPPEARANCE_RESOURCES.length) {
+                return BG_DEFAULT_FONT_SIZE;
+            }
+            return TEXTAPPEARANCE_RESOURCES[id];
+        }
+
+        /**
+         * 获取文本样式资源数组的长度
+         * @return 资源数组长度
+         */
+        public static int getResourcesSize() {
+            return TEXTAPPEARANCE_RESOURCES.length;
+        }
+    }
+}