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

@@ -25,17 +25,10 @@ import android.util.Log;
 
 import java.util.HashMap;
 
-/**
- * 联系人工具类 - 提供手机号到联系人姓名的映射查询功能
- * 包含内存缓存机制以提高重复查询效率
- */
 public class Contact {
-    // 联系人缓存：手机号 -> 联系人姓名
     private static HashMap<String, String> sContactCache;
     private static final String TAG = "Contact";
 
-    // 联系人查询SQL模板
-    // 使用PHONE_NUMBERS_EQUAL函数进行模糊匹配，并限定数据类型为电话号码
     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 "
@@ -43,55 +36,38 @@ public class Contact {
             + " FROM phone_lookup"
             + " WHERE min_match = '+')";
 
-    /**
-     * 根据手机号查询联系人姓名（带缓存）
-     * 
-     * @param context 上下文对象
-     * @param phoneNumber 待查询的手机号
-     * @return 匹配的联系人姓名，未找到时返回null
-     */
     public static String getContact(Context context, String phoneNumber) {
-        // 初始化缓存
         if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();
         }
 
-        // 优先从缓存获取
         if(sContactCache.containsKey(phoneNumber)) {
             return sContactCache.get(phoneNumber);
         }
 
-        // 构建动态查询条件
         String selection = CALLER_ID_SELECTION.replace("+",
                 PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
-        
-        // 执行联系人数据库查询
         Cursor cursor = context.getContentResolver().query(
-                Data.CONTENT_URI,                  // 查询联系人数据URI
-                new String [] { Phone.DISPLAY_NAME }, // 只需要显示名称字段
-                selection,                         // 动态查询条件
-                new String[] { phoneNumber },      // 查询参数
-                null);                             // 默认排序
+                Data.CONTENT_URI,
+                new String [] { Phone.DISPLAY_NAME },
+                selection,
+                new String[] { phoneNumber },
+                null);
 
-        // 处理查询结果
         if (cursor != null && cursor.moveToFirst()) {
             try {
-                // 获取联系人姓名并加入缓存
                 String name = cursor.getString(0);
                 sContactCache.put(phoneNumber, name);
                 return name;
             } catch (IndexOutOfBoundsException e) {
-                // 防御性编程：处理可能的索引越界异常
                 Log.e(TAG, " Cursor get string error " + e.toString());
                 return null;
             } finally {
-                // 确保资源释放
                 cursor.close();
             }
         } else {
-            // 未找到匹配联系人
             Log.d(TAG, "No contact matched with number:" + phoneNumber);
             return null;
         }
     }
-}
+}

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

@@ -17,172 +17,263 @@
 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;
 
     /**
-     * 系统文件夹ID常量
-     * {@link Notes#ID_ROOT_FOLDER } 是默认文件夹
-     * {@link Notes#ID_TEMPARAY_FOLDER } 用于无归属的临时便签
-     * {@link Notes#ID_CALL_RECORD_FOLDER} 存储通话记录便签
-     * {@link Notes#ID_TRASH_FOLER} 回收站文件夹
+     * Following IDs are system folders' identifiers
+     * {@link Notes#ID_ROOT_FOLDER } is default folder
+     * {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
+     * {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
      */
     public static final int ID_ROOT_FOLDER = 0;
     public static final int ID_TEMPARAY_FOLDER = -1;
     public static final int ID_CALL_RECORD_FOLDER = -2;
     public static final int ID_TRASH_FOLER = -3;
 
-    // 意图传递的额外数据键名
-    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date"; // 提醒日期
-    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id"; // 便签背景色ID
-    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id"; // 桌面小部件ID
-    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type"; // 桌面小部件类型
-    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id"; // 文件夹ID
-    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date"; // 通话日期
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
 
-    // 桌面小部件类型常量
-    public static final int TYPE_WIDGET_INVALIDE      = -1; // 无效类型
-    public static final int TYPE_WIDGET_2X            = 0; // 2x大小的小部件
-    public static final int TYPE_WIDGET_4X            = 1; // 4x大小的小部件
+    public static final int TYPE_WIDGET_INVALIDE      = -1;
+    public static final int TYPE_WIDGET_2X            = 0;
+    public static final int TYPE_WIDGET_4X            = 1;
 
-    /**
-     * 数据类型常量
-     */
     public static class DataConstants {
-        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE; // 文本便签类型
-        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE; // 通话记录便签类型
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
     }
 
     /**
-     * 内容提供者查询URI
-     * CONTENT_NOTE_URI - 查询所有便签和文件夹
-     * CONTENT_DATA_URI - 查询便签关联的数据
+     * Uri to query all notes and folders
      */
     public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
-    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
 
     /**
-     * 便签表结构接口
-     * 定义了便签和文件夹的数据库字段
+     * Uri to query data
      */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+
     public interface NoteColumns {
         /**
-         * 数据库表字段定义
-         * 包含字段名和数据类型说明
-         */
-        public static final String ID = "_id"; // 主键ID
-        
-        public static final String PARENT_ID = "parent_id"; // 父文件夹ID
-        
-        public static final String CREATED_DATE = "created_date"; // 创建日期
-        
-        public static final String MODIFIED_DATE = "modified_date"; // 修改日期
-        
-        public static final String ALERTED_DATE = "alert_date"; // 提醒日期
-        
-        public static final String SNIPPET = "snippet"; // 摘要或便签内容
-        
-        public static final String WIDGET_ID = "widget_id"; // 关联的桌面小部件ID
-        
-        public static final String WIDGET_TYPE = "widget_type"; // 桌面小部件类型
-        
-        public static final String BG_COLOR_ID = "bg_color_id"; // 便签背景色ID
-        
-        public static final String HAS_ATTACHMENT = "has_attachment"; // 是否有附件
-        
-        public static final String NOTES_COUNT = "notes_count"; // 文件夹便签数量统计
-        
-        public static final String TYPE = "type"; // 类型(便签/文件夹)
-        
-        public static final String SYNC_ID = "sync_id"; // 同步ID
-        
-        public static final String LOCAL_MODIFIED = "local_modified"; // 本地修改标记
-        
-        public static final String ORIGIN_PARENT_ID = "origin_parent_id"; // 原始父文件夹ID(用于回收站)
-        
-        public static final String GTASK_ID = "gtask_id"; // Google任务ID
-        
-        public static final String VERSION = "version"; // 版本号
+         * The unique ID for a row
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * The parent's id for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String PARENT_ID = "parent_id";
+
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+
+        /**
+         * Alert date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ALERTED_DATE = "alert_date";
+
+        /**
+         * Folder's name or text content of note
+         * <P> Type: TEXT </P>
+         */
+        public static final String SNIPPET = "snippet";
+
+        /**
+         * Note's widget id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String WIDGET_ID = "widget_id";
+
+        /**
+         * Note's widget type
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String WIDGET_TYPE = "widget_type";
+
+        /**
+         * Note's background color's id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id";
+
+        /**
+         * For text note, it doesn't has attachment, for multi-media
+         * note, it has at least one attachment
+         * <P> Type: INTEGER </P>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+
+        /**
+         * Folder's count of notes
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String NOTES_COUNT = "notes_count";
+
+        /**
+         * The file type: folder or note
+         * <P> Type: INTEGER </P>
+         */
+        public static final String TYPE = "type";
+
+        /**
+         * The last sync id
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String SYNC_ID = "sync_id";
+
+        /**
+         * Sign to indicate local modified or not
+         * <P> Type: INTEGER </P>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";
+
+        /**
+         * Original parent id before moving into temporary folder
+         * <P> Type : INTEGER </P>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+
+        /**
+         * The gtask id
+         * <P> Type : TEXT </P>
+         */
+        public static final String GTASK_ID = "gtask_id";
+
+        /**
+         * The version code
+         * <P> Type : INTEGER (long) </P>
+         */
+        public static final String VERSION = "version";
     }
 
-    /**
-     * 便签数据表结构接口
-     * 定义了便签关联数据的数据库字段
-     */
     public interface DataColumns {
         /**
-         * 数据库表字段定义
-         * 包含字段名和数据类型说明
-         */
-        public static final String ID = "_id"; // 主键ID
-        
-        public static final String MIME_TYPE = "mime_type"; // 数据MIME类型
-        
-        public static final String NOTE_ID = "note_id"; // 关联的便签ID
-        
-        public static final String CREATED_DATE = "created_date"; // 创建日期
-        
-        public static final String MODIFIED_DATE = "modified_date"; // 修改日期
-        
-        public static final String CONTENT = "content"; // 数据内容
-        
-        // 通用数据字段，具体含义取决于MIME类型
-        public static final String DATA1 = "data1"; // 通常用于整数值
-        public static final String DATA2 = "data2"; // 通常用于整数值
-        public static final String DATA3 = "data3"; // 通常用于文本值
-        public static final String DATA4 = "data4"; // 通常用于文本值
-        public static final String DATA5 = "data5"; // 通常用于文本值
+         * The unique ID for a row
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * The MIME type of the item represented by this row.
+         * <P> Type: Text </P>
+         */
+        public static final String MIME_TYPE = "mime_type";
+
+        /**
+         * The reference id to note that this data belongs to
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String NOTE_ID = "note_id";
+
+        /**
+         * Created data for note or folder
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * Latest modified date
+         * <P> Type: INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * Data's content
+         * <P> Type: TEXT </P>
+         */
+        public static final String CONTENT = "content";
+
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * integer data type
+         * <P> Type: INTEGER </P>
+         */
+        public static final String DATA1 = "data1";
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * integer data type
+         * <P> Type: INTEGER </P>
+         */
+        public static final String DATA2 = "data2";
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA3 = "data3";
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA4 = "data4";
+
+        /**
+         * Generic data column, the meaning is {@link #MIMETYPE} specific, used for
+         * TEXT data type
+         * <P> Type: TEXT </P>
+         */
+        public static final String DATA5 = "data5";
     }
 
-    /**
-     * 文本便签数据模型
-     * 继承自DataColumns并扩展特定字段
-     */
     public static final class TextNote implements DataColumns {
         /**
-         * 文本便签特定字段
+         * Mode to indicate the text in check list mode or not
+         * <P> Type: Integer 1:check list mode 0: normal mode </P>
          */
-        // 便签模式(普通文本或复选框列表)
         public static final String MODE = DATA1;
-        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";
+
         public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
-        
-        // 内容提供者URI
+
         public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
     }
 
-    /**
-     * 通话记录便签数据模型
-     * 继承自DataColumns并扩展特定字段
-     */
     public static final class CallNote implements DataColumns {
         /**
-         * 通话记录便签特定字段
+         * Call date for this record
+         * <P> Type: INTEGER (long) </P>
          */
-        public static final String CALL_DATE = DATA1; // 通话日期
-        
-        public static final String PHONE_NUMBER = DATA3; // 电话号码
-        
-        // 内容类型定义
+        public static final String CALL_DATE = DATA1;
+
+        /**
+         * Phone number for this record
+         * <P> Type: TEXT </P>
+         */
+        public static final String PHONE_NUMBER = DATA3;
+
         public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
+
         public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
-        
-        // 内容提供者URI
+
         public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
     }
-}
+}

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

@@ -16,173 +16,347 @@
 
 package net.micode.notes.data;
 
-import android.net.Uri;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import android.util.Log;
 
-/**
- * 便签应用的核心数据模型类
- * 定义了便签应用的基础数据结构、常量和内容提供者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; // 系统文件夹
+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 DATA = "data";
+    }
+
+    private static final String TAG = "NotesDatabaseHelper";
+
+    private static NotesDatabaseHelper mInstance;
+
+    private static final String CREATE_NOTE_TABLE_SQL =
+        "CREATE TABLE " + TABLE.NOTE + "(" +
+            NoteColumns.ID + " INTEGER PRIMARY KEY," +
+            NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," +
+            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," +
+            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" +
+        ")";
+
+    private static final String CREATE_DATA_TABLE_SQL =
+        "CREATE TABLE " + TABLE.DATA + "(" +
+            DataColumns.ID + " INTEGER PRIMARY KEY," +
+            DataColumns.MIME_TYPE + " TEXT NOT NULL," +
+            DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," +
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," +
+            DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA1 + " INTEGER," +
+            DataColumns.DATA2 + " INTEGER," +
+            DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," +
+            DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" +
+        ")";
+
+    private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
+        "CREATE INDEX IF NOT EXISTS note_id_index ON " +
+        TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
 
     /**
-     * 系统文件夹ID常量
-     * {@link Notes#ID_ROOT_FOLDER } 是默认文件夹
-     * {@link Notes#ID_TEMPARAY_FOLDER } 用于无归属的临时便签
-     * {@link Notes#ID_CALL_RECORD_FOLDER} 存储通话记录便签
-     * {@link Notes#ID_TRASH_FOLER} 回收站文件夹
+     * Increase folder's note count when move note to the folder
      */
-    public static final int ID_ROOT_FOLDER = 0;
-    public static final int ID_TEMPARAY_FOLDER = -1;
-    public static final int ID_CALL_RECORD_FOLDER = -2;
-    public static final int ID_TRASH_FOLER = -3;
-
-    // 意图传递的额外数据键名
-    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date"; // 提醒日期
-    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id"; // 便签背景色ID
-    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id"; // 桌面小部件ID
-    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type"; // 桌面小部件类型
-    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id"; // 文件夹ID
-    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date"; // 通话日期
-
-    // 桌面小部件类型常量
-    public static final int TYPE_WIDGET_INVALIDE      = -1; // 无效类型
-    public static final int TYPE_WIDGET_2X            = 0; // 2x大小的小部件
-    public static final int TYPE_WIDGET_4X            = 1; // 4x大小的小部件
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER increase_folder_count_on_update "+
+        " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+        "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+        " END";
 
     /**
-     * 数据类型常量
+     * Decrease folder's note count when move note from folder
      */
-    public static class DataConstants {
-        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE; // 文本便签类型
-        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE; // 通话记录便签类型
-    }
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER decrease_folder_count_on_update " +
+        " AFTER UPDATE OF " + NoteColumns.PARENT_ID + " ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+        "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+        "  AND " + NoteColumns.NOTES_COUNT + ">0" + ";" +
+        " END";
 
     /**
-     * 内容提供者查询URI
-     * CONTENT_NOTE_URI - 查询所有便签和文件夹
-     * CONTENT_DATA_URI - 查询便签关联的数据
+     * Increase folder's note count when insert new note to the folder
      */
-    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
-    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
+        "CREATE TRIGGER increase_folder_count_on_insert " +
+        " AFTER INSERT ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + " + 1" +
+        "  WHERE " + NoteColumns.ID + "=new." + NoteColumns.PARENT_ID + ";" +
+        " END";
 
     /**
-     * 便签表结构接口
-     * 定义了便签和文件夹的数据库字段
+     * Decrease folder's note count when delete note from the folder
      */
-    public interface NoteColumns {
-        /**
-         * 数据库表字段定义
-         * 包含字段名和数据类型说明
-         */
-        public static final String ID = "_id"; // 主键ID
-        
-        public static final String PARENT_ID = "parent_id"; // 父文件夹ID
-        
-        public static final String CREATED_DATE = "created_date"; // 创建日期
-        
-        public static final String MODIFIED_DATE = "modified_date"; // 修改日期
-        
-        public static final String ALERTED_DATE = "alert_date"; // 提醒日期
-        
-        public static final String SNIPPET = "snippet"; // 摘要或便签内容
-        
-        public static final String WIDGET_ID = "widget_id"; // 关联的桌面小部件ID
-        
-        public static final String WIDGET_TYPE = "widget_type"; // 桌面小部件类型
-        
-        public static final String BG_COLOR_ID = "bg_color_id"; // 便签背景色ID
-        
-        public static final String HAS_ATTACHMENT = "has_attachment"; // 是否有附件
-        
-        public static final String NOTES_COUNT = "notes_count"; // 文件夹便签数量统计
-        
-        public static final String TYPE = "type"; // 类型(便签/文件夹)
-        
-        public static final String SYNC_ID = "sync_id"; // 同步ID
-        
-        public static final String LOCAL_MODIFIED = "local_modified"; // 本地修改标记
-        
-        public static final String ORIGIN_PARENT_ID = "origin_parent_id"; // 原始父文件夹ID(用于回收站)
-        
-        public static final String GTASK_ID = "gtask_id"; // Google任务ID
-        
-        public static final String VERSION = "version"; // 版本号
-    }
+    private static final String NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER decrease_folder_count_on_delete " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN " +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.NOTES_COUNT + "=" + NoteColumns.NOTES_COUNT + "-1" +
+        "  WHERE " + NoteColumns.ID + "=old." + NoteColumns.PARENT_ID +
+        "  AND " + NoteColumns.NOTES_COUNT + ">0;" +
+        " END";
 
     /**
-     * 便签数据表结构接口
-     * 定义了便签关联数据的数据库字段
+     * Update note's content when insert data with type {@link DataConstants#NOTE}
      */
-    public interface DataColumns {
-        /**
-         * 数据库表字段定义
-         * 包含字段名和数据类型说明
-         */
-        public static final String ID = "_id"; // 主键ID
-        
-        public static final String MIME_TYPE = "mime_type"; // 数据MIME类型
-        
-        public static final String NOTE_ID = "note_id"; // 关联的便签ID
-        
-        public static final String CREATED_DATE = "created_date"; // 创建日期
-        
-        public static final String MODIFIED_DATE = "modified_date"; // 修改日期
-        
-        public static final String CONTENT = "content"; // 数据内容
-        
-        // 通用数据字段，具体含义取决于MIME类型
-        public static final String DATA1 = "data1"; // 通常用于整数值
-        public static final String DATA2 = "data2"; // 通常用于整数值
-        public static final String DATA3 = "data3"; // 通常用于文本值
-        public static final String DATA4 = "data4"; // 通常用于文本值
-        public static final String DATA5 = "data5"; // 通常用于文本值
-    }
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_insert " +
+        " AFTER INSERT ON " + TABLE.DATA +
+        " WHEN new." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+        "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+        " END";
 
     /**
-     * 文本便签数据模型
-     * 继承自DataColumns并扩展特定字段
+     * Update note's content when data with {@link DataConstants#NOTE} type has changed
      */
-    public static final class TextNote implements DataColumns {
-        /**
-         * 文本便签特定字段
-         */
-        // 便签模式(普通文本或复选框列表)
-        public static final String MODE = DATA1;
-        public static final int MODE_CHECK_LIST = 1; // 复选框列表模式
-        
-        // 内容类型定义
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
-        
-        // 内容提供者URI
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
-    }
+    private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
+        "CREATE TRIGGER update_note_content_on_update " +
+        " AFTER UPDATE ON " + TABLE.DATA +
+        " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=new." + DataColumns.CONTENT +
+        "  WHERE " + NoteColumns.ID + "=new." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 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 " +
+        " AFTER delete ON " + TABLE.DATA +
+        " WHEN old." + DataColumns.MIME_TYPE + "='" + DataConstants.NOTE + "'" +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.SNIPPET + "=''" +
+        "  WHERE " + NoteColumns.ID + "=old." + DataColumns.NOTE_ID + ";" +
+        " END";
+
+    /**
+     * 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 " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN" +
+        "  DELETE FROM " + TABLE.DATA +
+        "   WHERE " + DataColumns.NOTE_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
 
     /**
-     * 通话记录便签数据模型
-     * 继承自DataColumns并扩展特定字段
+     * Delete notes belong to folder which has been deleted
      */
-    public static final class CallNote implements DataColumns {
+    private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
+        "CREATE TRIGGER folder_delete_notes_on_delete " +
+        " AFTER DELETE ON " + TABLE.NOTE +
+        " BEGIN" +
+        "  DELETE FROM " + TABLE.NOTE +
+        "   WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
+
+    /**
+     * 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 " +
+        " AFTER UPDATE ON " + TABLE.NOTE +
+        " WHEN new." + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+        " BEGIN" +
+        "  UPDATE " + TABLE.NOTE +
+        "   SET " + NoteColumns.PARENT_ID + "=" + Notes.ID_TRASH_FOLER +
+        "  WHERE " + NoteColumns.PARENT_ID + "=old." + NoteColumns.ID + ";" +
+        " END";
+
+    public NotesDatabaseHelper(Context context) {
+        super(context, DB_NAME, null, DB_VERSION);
+    }
+
+    public void createNoteTable(SQLiteDatabase db) {
+        db.execSQL(CREATE_NOTE_TABLE_SQL);
+        reCreateNoteTableTriggers(db);
+        createSystemFolder(db);
+        Log.d(TAG, "note table has been created");
+    }
+
+    private void reCreateNoteTableTriggers(SQLiteDatabase db) {
+        db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS decrease_folder_count_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS delete_data_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS increase_folder_count_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS folder_delete_notes_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS folder_move_notes_on_trash");
+
+        db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
+        db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER);
+        db.execSQL(NOTE_DECREASE_FOLDER_COUNT_ON_DELETE_TRIGGER);
+        db.execSQL(NOTE_DELETE_DATA_ON_DELETE_TRIGGER);
+        db.execSQL(NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER);
+        db.execSQL(FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER);
+        db.execSQL(FOLDER_MOVE_NOTES_ON_TRASH_TRIGGER);
+    }
+
+    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
          */
-        public static final String CALL_DATE = DATA1; // 通话日期
-        
-        public static final String PHONE_NUMBER = DATA3; // 电话号码
-        
-        // 内容类型定义
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
-        
-        // 内容提供者URI
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
+        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);
+    }
+
+    public void createDataTable(SQLiteDatabase db) {
+        db.execSQL(CREATE_DATA_TABLE_SQL);
+        reCreateDataTableTriggers(db);
+        db.execSQL(CREATE_DATA_NOTE_ID_INDEX_SQL);
+        Log.d(TAG, "data table has been created");
+    }
+
+    private void reCreateDataTableTriggers(SQLiteDatabase db) {
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_update");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_content_on_delete");
+
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_INSERT_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER);
+        db.execSQL(DATA_UPDATE_NOTE_CONTENT_ON_DELETE_TRIGGER);
+    }
+
+    static synchronized NotesDatabaseHelper getInstance(Context context) {
+        if (mInstance == null) {
+            mInstance = new NotesDatabaseHelper(context);
+        }
+        return mInstance;
+    }
+
+    @Override
+    public void onCreate(SQLiteDatabase db) {
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    @Override
+    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
+        boolean reCreateTriggers = false;
+        boolean skipV2 = false;
+
+        if (oldVersion == 1) {
+            upgradeToV2(db);
+            skipV2 = true; // this upgrade including the upgrade from v2 to v3
+            oldVersion++;
+        }
+
+        if (oldVersion == 2 && !skipV2) {
+            upgradeToV3(db);
+            reCreateTriggers = true;
+            oldVersion++;
+        }
+
+        if (oldVersion == 3) {
+            upgradeToV4(db);
+            oldVersion++;
+        }
+
+        if (reCreateTriggers) {
+            reCreateNoteTableTriggers(db);
+            reCreateDataTableTriggers(db);
+        }
+
+        if (oldVersion != newVersion) {
+            throw new IllegalStateException("Upgrade notes database to version " + newVersion
+                    + "fails");
+        }
+    }
+
+    private void upgradeToV2(SQLiteDatabase db) {
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.NOTE);
+        db.execSQL("DROP TABLE IF EXISTS " + TABLE.DATA);
+        createNoteTable(db);
+        createDataTable(db);
+    }
+
+    private void upgradeToV3(SQLiteDatabase db) {
+        // drop unused triggers
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_insert");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_delete");
+        db.execSQL("DROP TRIGGER IF EXISTS update_note_modified_date_on_update");
+        // add a column for gtask id
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.GTASK_ID
+                + " TEXT NOT NULL DEFAULT ''");
+        // add a trash system folder
+        ContentValues values = new ContentValues();
+        values.put(NoteColumns.ID, Notes.ID_TRASH_FOLER);
+        values.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+        db.insert(TABLE.NOTE, null, values);
+    }
+
+    private void upgradeToV4(SQLiteDatabase db) {
+        db.execSQL("ALTER TABLE " + TABLE.NOTE + " ADD COLUMN " + NoteColumns.VERSION
+                + " INTEGER NOT NULL DEFAULT 0");
     }
-}
+}

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

@@ -16,6 +16,7 @@
 
 package net.micode.notes.data;
 
+
 import android.app.SearchManager;
 import android.content.ContentProvider;
 import android.content.ContentUris;
@@ -33,25 +34,22 @@ 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匹配器和相关常量定义
     private static final UriMatcher mMatcher;
+
     private NotesDatabaseHelper mHelper;
+
     private static final String TAG = "NotesProvider";
-    
-    // URI匹配码
+
     private static final int URI_NOTE            = 1;
     private static final int URI_NOTE_ITEM       = 2;
     private static final int URI_DATA            = 3;
     private static final int URI_DATA_ITEM       = 4;
+
     private static final int URI_SEARCH          = 5;
     private static final int URI_SEARCH_SUGGEST  = 6;
 
-    // 静态初始化块 - 配置URI匹配规则
     static {
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
         mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
@@ -63,7 +61,10 @@ public class NotesProvider extends ContentProvider {
         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.
+     */
     private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
         + NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
         + "TRIM(REPLACE(" + NoteColumns.SNIPPET + ", x'0A','')) AS " + SearchManager.SUGGEST_COLUMN_TEXT_1 + ","
@@ -78,75 +79,227 @@ public class NotesProvider extends ContentProvider {
         + " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER
         + " AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE;
 
-    /**
-     * 初始化内容提供者
-     * 创建数据库帮助类实例
-     */
     @Override
     public boolean onCreate() {
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
 
-    /**
-     * 查询接口 - 处理不同类型的URI查询请求
-     * 支持便签查询、数据查询和搜索功能
-     */
     @Override
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
             String sortOrder) {
-        // 实现逻辑
+        Cursor c = null;
+        SQLiteDatabase db = mHelper.getReadableDatabase();
+        String id = null;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                c = db.query(TABLE.NOTE, projection, selection, selectionArgs, null, null,
+                        sortOrder);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.NOTE, projection, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                break;
+            case URI_DATA:
+                c = db.query(TABLE.DATA, projection, selection, selectionArgs, null, null,
+                        sortOrder);
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                c = db.query(TABLE.DATA, projection, DataColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs, null, null, sortOrder);
+                break;
+            case URI_SEARCH:
+            case URI_SEARCH_SUGGEST:
+                if (sortOrder != null || projection != null) {
+                    throw new IllegalArgumentException(
+                            "do not specify sortOrder, selection, selectionArgs, or projection" + "with this query");
+                }
+
+                String searchString = null;
+                if (mMatcher.match(uri) == URI_SEARCH_SUGGEST) {
+                    if (uri.getPathSegments().size() > 1) {
+                        searchString = uri.getPathSegments().get(1);
+                    }
+                } else {
+                    searchString = uri.getQueryParameter("pattern");
+                }
+
+                if (TextUtils.isEmpty(searchString)) {
+                    return null;
+                }
+
+                try {
+                    searchString = String.format("%%%s%%", searchString);
+                    c = db.rawQuery(NOTES_SNIPPET_SEARCH_QUERY,
+                            new String[] { searchString });
+                } catch (IllegalStateException ex) {
+                    Log.e(TAG, "got exception: " + ex.toString());
+                }
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (c != null) {
+            c.setNotificationUri(getContext().getContentResolver(), uri);
+        }
+        return c;
     }
 
-    /**
-     * 插入接口 - 处理不同类型的URI插入请求
-     * 支持插入便签和便签关联数据
-     */
     @Override
     public Uri insert(Uri uri, ContentValues values) {
-        // 实现逻辑
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        long dataId = 0, noteId = 0, insertedId = 0;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                insertedId = noteId = db.insert(TABLE.NOTE, null, values);
+                break;
+            case URI_DATA:
+                if (values.containsKey(DataColumns.NOTE_ID)) {
+                    noteId = values.getAsLong(DataColumns.NOTE_ID);
+                } else {
+                    Log.d(TAG, "Wrong data format without note id:" + values.toString());
+                }
+                insertedId = dataId = db.insert(TABLE.DATA, null, values);
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        // Notify the note uri
+        if (noteId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
+        }
+
+        // Notify the data uri
+        if (dataId > 0) {
+            getContext().getContentResolver().notifyChange(
+                    ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
+        }
+
+        return ContentUris.withAppendedId(uri, insertedId);
     }
 
-    /**
-     * 删除接口 - 处理不同类型的URI删除请求
-     * 支持删除便签和便签关联数据
-     */
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
-        // 实现逻辑
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean deleteData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                selection = "(" + selection + ") AND " + NoteColumns.ID + ">0 ";
+                count = db.delete(TABLE.NOTE, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                /**
+                 * ID that smaller than 0 is system folder which is not allowed to
+                 * trash
+                 */
+                long noteId = Long.valueOf(id);
+                if (noteId <= 0) {
+                    break;
+                }
+                count = db.delete(TABLE.NOTE,
+                        NoteColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.delete(TABLE.DATA, selection, selectionArgs);
+                deleteData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.delete(TABLE.DATA,
+                        DataColumns.ID + "=" + id + parseSelection(selection), selectionArgs);
+                deleteData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+        if (count > 0) {
+            if (deleteData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
     }
 
-    /**
-     * 更新接口 - 处理不同类型的URI更新请求
-     * 支持更新便签和便签关联数据
-     */
     @Override
     public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
-        // 实现逻辑
+        int count = 0;
+        String id = null;
+        SQLiteDatabase db = mHelper.getWritableDatabase();
+        boolean updateData = false;
+        switch (mMatcher.match(uri)) {
+            case URI_NOTE:
+                increaseNoteVersion(-1, selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, selection, selectionArgs);
+                break;
+            case URI_NOTE_ITEM:
+                id = uri.getPathSegments().get(1);
+                increaseNoteVersion(Long.valueOf(id), selection, selectionArgs);
+                count = db.update(TABLE.NOTE, values, NoteColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs);
+                break;
+            case URI_DATA:
+                count = db.update(TABLE.DATA, values, selection, selectionArgs);
+                updateData = true;
+                break;
+            case URI_DATA_ITEM:
+                id = uri.getPathSegments().get(1);
+                count = db.update(TABLE.DATA, values, DataColumns.ID + "=" + id
+                        + parseSelection(selection), selectionArgs);
+                updateData = true;
+                break;
+            default:
+                throw new IllegalArgumentException("Unknown URI " + uri);
+        }
+
+        if (count > 0) {
+            if (updateData) {
+                getContext().getContentResolver().notifyChange(Notes.CONTENT_NOTE_URI, null);
+            }
+            getContext().getContentResolver().notifyChange(uri, null);
+        }
+        return count;
     }
 
-    /**
-     * 辅助方法 - 解析查询条件
-     * 用于构建SQL WHERE子句
-     */
     private String parseSelection(String selection) {
-        // 实现逻辑
+        return (!TextUtils.isEmpty(selection) ? " AND (" + selection + ')' : "");
     }
 
-    /**
-     * 辅助方法 - 增加便签版本号
-     * 在便签更新时调用，用于版本控制
-     */
     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 ");
+
+        if (id > 0 || !TextUtils.isEmpty(selection)) {
+            sql.append(" WHERE ");
+        }
+        if (id > 0) {
+            sql.append(NoteColumns.ID + "=" + String.valueOf(id));
+        }
+        if (!TextUtils.isEmpty(selection)) {
+            String selectString = id > 0 ? parseSelection(selection) : selection;
+            for (String args : selectionArgs) {
+                selectString = selectString.replaceFirst("\\?", args);
+            }
+            sql.append(selectString);
+        }
+
+        mHelper.getWritableDatabase().execSQL(sql.toString());
     }
 
-    /**
-     * 获取内容类型接口
-     * 目前未实现
-     */
     @Override
     public String getType(Uri uri) {
+        // TODO Auto-generated method stub
         return null;
     }
-}
+
+}

src/net/micode/notes/gtask/data/TaskList.java

@@ -29,109 +29,315 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 
-/**
- * Google Tasks任务列表类
- * 实现Node接口，管理一组相关任务，并处理与Google Tasks的同步操作
- */
+
 public class TaskList extends Node {
     private static final String TAG = TaskList.class.getSimpleName();
-    
-    private int mIndex;                  // 任务列表在父容器中的排序索引
-    private ArrayList<Task> mChildren;   // 子任务集合
 
-    /**
-     * 构造函数 - 初始化任务列表基本属性
-     */
+    private int mIndex;
+
+    private ArrayList<Task> mChildren;
+
     public TaskList() {
         super();
         mChildren = new ArrayList<Task>();
         mIndex = 1;
     }
 
-    /**
-     * 生成创建任务列表的JSON操作
-     * @param actionId 操作ID
-     * @return 创建任务列表的JSON对象
-     */
     public JSONObject getCreateAction(int actionId) {
-        // 构建创建任务列表的JSON请求
-        // 包含列表名称、类型、位置索引等信息
+        JSONObject js = new JSONObject();
+
+        try {
+            // action_type
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
+
+            // action_id
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // index
+            js.put(GTaskStringUtils.GTASK_JSON_INDEX, mIndex);
+
+            // entity_delta
+            JSONObject entity = new JSONObject();
+            entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
+            entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
+            entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
+                    GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate tasklist-create jsonobject");
+        }
+
+        return js;
     }
 
-    /**
-     * 生成更新任务列表的JSON操作
-     * @param actionId 操作ID
-     * @return 更新任务列表的JSON对象
-     */
     public JSONObject getUpdateAction(int actionId) {
-        // 构建更新任务列表的JSON请求
-        // 包含列表名称、删除状态等信息
+        JSONObject js = new JSONObject();
+
+        try {
+            // action_type
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
+                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
+
+            // action_id
+            js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
+
+            // id
+            js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
+
+            // entity_delta
+            JSONObject entity = new JSONObject();
+            entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
+            entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
+            js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
+
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("fail to generate tasklist-update jsonobject");
+        }
+
+        return js;
     }
 
-    /**
-     * 从远程JSON数据设置任务列表内容
-     * @param js 远程JSON数据
-     */
     public void setContentByRemoteJSON(JSONObject js) {
-        // 解析远程JSON数据，提取列表ID、名称、修改时间等信息
-        // 设置任务列表属性值
+        if (js != null) {
+            try {
+                // id
+                if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
+                    setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
+                }
+
+                // last_modified
+                if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
+                    setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
+                }
+
+                // name
+                if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
+                    setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
+                }
+
+            } catch (JSONException e) {
+                Log.e(TAG, e.toString());
+                e.printStackTrace();
+                throw new ActionFailureException("fail to get tasklist content from jsonobject");
+            }
+        }
     }
 
-    /**
-     * 从本地JSON数据设置任务列表内容
-     * @param js 本地JSON数据
-     */
     public void setContentByLocalJSON(JSONObject js) {
-        // 解析本地JSON数据，提取文件夹/系统文件夹信息
-        // 根据不同类型设置任务列表名称
+        if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
+            Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
+        }
+
+        try {
+            JSONObject folder = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+
+            if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
+                String name = folder.getString(NoteColumns.SNIPPET);
+                setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + name);
+            } else if (folder.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
+                if (folder.getLong(NoteColumns.ID) == Notes.ID_ROOT_FOLDER)
+                    setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT);
+                else if (folder.getLong(NoteColumns.ID) == Notes.ID_CALL_RECORD_FOLDER)
+                    setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+                            + GTaskStringUtils.FOLDER_CALL_NOTE);
+                else
+                    Log.e(TAG, "invalid system folder");
+            } else {
+                Log.e(TAG, "error type");
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
     }
 
-    /**
-     * 从任务列表内容生成本地JSON数据
-     * @return 本地JSON对象
-     */
     public JSONObject getLocalJSONFromContent() {
-        // 将任务列表信息转换为本地JSON格式
-        // 处理文件夹名称前缀、类型转换等
+        try {
+            JSONObject js = new JSONObject();
+            JSONObject folder = new JSONObject();
+
+            String folderName = getName();
+            if (getName().startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX))
+                folderName = folderName.substring(GTaskStringUtils.MIUI_FOLDER_PREFFIX.length(),
+                        folderName.length());
+            folder.put(NoteColumns.SNIPPET, folderName);
+            if (folderName.equals(GTaskStringUtils.FOLDER_DEFAULT)
+                    || folderName.equals(GTaskStringUtils.FOLDER_CALL_NOTE))
+                folder.put(NoteColumns.TYPE, Notes.TYPE_SYSTEM);
+            else
+                folder.put(NoteColumns.TYPE, Notes.TYPE_FOLDER);
+
+            js.put(GTaskStringUtils.META_HEAD_NOTE, folder);
+
+            return js;
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return null;
+        }
     }
 
-    /**
-     * 根据数据库游标确定同步动作
-     * @param c 数据库游标
-     * @return 同步动作类型（新增、更新、冲突等）
-     */
     public int getSyncAction(Cursor c) {
-        // 比较本地和远程任务列表状态
-        // 判断需要执行的同步操作类型
-        // 特别处理文件夹冲突（默认应用本地修改）
+        try {
+            if (c.getInt(SqlNote.LOCAL_MODIFIED_COLUMN) == 0) {
+                // there is no local update
+                if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+                    // no update both side
+                    return SYNC_ACTION_NONE;
+                } else {
+                    // apply remote to local
+                    return SYNC_ACTION_UPDATE_LOCAL;
+                }
+            } else {
+                // validate gtask id
+                if (!c.getString(SqlNote.GTASK_ID_COLUMN).equals(getGid())) {
+                    Log.e(TAG, "gtask id doesn't match");
+                    return SYNC_ACTION_ERROR;
+                }
+                if (c.getLong(SqlNote.SYNC_ID_COLUMN) == getLastModified()) {
+                    // local modification only
+                    return SYNC_ACTION_UPDATE_REMOTE;
+                } else {
+                    // for folder conflicts, just apply local modification
+                    return SYNC_ACTION_UPDATE_REMOTE;
+                }
+            }
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+        }
+
+        return SYNC_ACTION_ERROR;
+    }
+
+    public int getChildTaskCount() {
+        return mChildren.size();
     }
 
-    // 子任务管理方法
-    public int getChildTaskCount() { return mChildren.size(); }
-    
     public boolean addChildTask(Task task) {
-        // 添加任务到列表末尾，并设置父子关系和兄弟顺序
+        boolean ret = false;
+        if (task != null && !mChildren.contains(task)) {
+            ret = mChildren.add(task);
+            if (ret) {
+                // need to set prior sibling and parent
+                task.setPriorSibling(mChildren.isEmpty() ? null : mChildren
+                        .get(mChildren.size() - 1));
+                task.setParent(this);
+            }
+        }
+        return ret;
     }
-    
+
     public boolean addChildTask(Task task, int index) {
-        // 在指定位置插入任务，并调整兄弟顺序关系
+        if (index < 0 || index > mChildren.size()) {
+            Log.e(TAG, "add child task: invalid index");
+            return false;
+        }
+
+        int pos = mChildren.indexOf(task);
+        if (task != null && pos == -1) {
+            mChildren.add(index, task);
+
+            // update the task list
+            Task preTask = null;
+            Task afterTask = null;
+            if (index != 0)
+                preTask = mChildren.get(index - 1);
+            if (index != mChildren.size() - 1)
+                afterTask = mChildren.get(index + 1);
+
+            task.setPriorSibling(preTask);
+            if (afterTask != null)
+                afterTask.setPriorSibling(task);
+        }
+
+        return true;
     }
-    
+
     public boolean removeChildTask(Task task) {
-        // 从列表中移除任务，并调整兄弟顺序关系
+        boolean ret = false;
+        int index = mChildren.indexOf(task);
+        if (index != -1) {
+            ret = mChildren.remove(task);
+
+            if (ret) {
+                // reset prior sibling and parent
+                task.setPriorSibling(null);
+                task.setParent(null);
+
+                // update the task list
+                if (index != mChildren.size()) {
+                    mChildren.get(index).setPriorSibling(
+                            index == 0 ? null : mChildren.get(index - 1));
+                }
+            }
+        }
+        return ret;
     }
-    
+
     public boolean moveChildTask(Task task, int index) {
-        // 移动任务到新位置，并更新兄弟顺序关系
-    }
-    
-    // 任务查找与访问方法
-    public Task findChildTaskByGid(String gid) { /* 根据GID查找任务 */ }
-    public int getChildTaskIndex(Task task) { /* 获取任务在列表中的索引 */ }
-    public Task getChildTaskByIndex(int index) { /* 根据索引获取任务 */ }
-    public ArrayList<Task> getChildTaskList() { /* 获取所有子任务 */ }
-
-    // 列表索引管理
-    public void setIndex(int index) { this.mIndex = index; }
-    public int getIndex() { return this.mIndex; }
-}
+
+        if (index < 0 || index >= mChildren.size()) {
+            Log.e(TAG, "move child task: invalid index");
+            return false;
+        }
+
+        int pos = mChildren.indexOf(task);
+        if (pos == -1) {
+            Log.e(TAG, "move child task: the task should in the list");
+            return false;
+        }
+
+        if (pos == index)
+            return true;
+        return (removeChildTask(task) && addChildTask(task, index));
+    }
+
+    public Task findChildTaskByGid(String gid) {
+        for (int i = 0; i < mChildren.size(); i++) {
+            Task t = mChildren.get(i);
+            if (t.getGid().equals(gid)) {
+                return t;
+            }
+        }
+        return null;
+    }
+
+    public int getChildTaskIndex(Task task) {
+        return mChildren.indexOf(task);
+    }
+
+    public Task getChildTaskByIndex(int index) {
+        if (index < 0 || index >= mChildren.size()) {
+            Log.e(TAG, "getTaskByIndex: invalid index");
+            return null;
+        }
+        return mChildren.get(index);
+    }
+
+    public Task getChilTaskByGid(String gid) {
+        for (Task task : mChildren) {
+            if (task.getGid().equals(gid))
+                return task;
+        }
+        return null;
+    }
+
+    public ArrayList<Task> getChildTaskList() {
+        return this.mChildren;
+    }
+
+    public void setIndex(int index) {
+        this.mIndex = index;
+    }
+
+    public int getIndex() {
+        return this.mIndex;
+    }
+}

src/net/micode/notes/gtask/exception/ActionFailureException.java

@@ -16,25 +16,18 @@
 
 package net.micode.notes.gtask.exception;
 
-/**
- * 操作失败异常类
- * 继承自RuntimeException，用于标识Google Tasks同步操作中的失败场景
- */
 public class ActionFailureException extends RuntimeException {
     private static final long serialVersionUID = 4425249765923293627L;
 
-    // 无参构造函数
     public ActionFailureException() {
         super();
     }
 
-    // 带错误消息的构造函数
     public ActionFailureException(String paramString) {
         super(paramString);
     }
 
-    // 带错误消息和异常原因的构造函数
     public ActionFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }
-}
+}

src/net/micode/notes/gtask/exception/NetworkFailureException.java

@@ -16,25 +16,18 @@
 
 package net.micode.notes.gtask.exception;
 
-/**
- * 网络失败异常类
- * 继承自Exception，用于标识网络相关操作失败的场景
- */
 public class NetworkFailureException extends Exception {
     private static final long serialVersionUID = 2107610287180234136L;
 
-    // 无参构造函数
     public NetworkFailureException() {
         super();
     }
 
-    // 带错误消息的构造函数
     public NetworkFailureException(String paramString) {
         super(paramString);
     }
 
-    // 带错误消息和异常原因的构造函数
     public NetworkFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }
-}
+}

src/net/micode/notes/gtask/remote/GTaskSyncService.java

@@ -23,66 +23,54 @@ import android.content.Intent;
 import android.os.Bundle;
 import android.os.IBinder;
 
-/**
- * Google Tasks同步服务
- * 负责在后台执行与Google Tasks的同步操作，提供同步控制接口和状态广播
- */
 public class GTaskSyncService extends Service {
-    // 服务操作类型常量
     public final static String ACTION_STRING_NAME = "sync_action_type";
-    public final static int ACTION_START_SYNC = 0;         // 启动同步
-    public final static int ACTION_CANCEL_SYNC = 1;        // 取消同步
-    public final static int ACTION_INVALID = 2;            // 无效操作
 
-    // 广播相关常量
+    public final static int ACTION_START_SYNC = 0;
+
+    public final static int ACTION_CANCEL_SYNC = 1;
+
+    public final static int ACTION_INVALID = 2;
+
     public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service";
+
     public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing";
+
     public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg";
 
-    private static GTaskASyncTask mSyncTask = null;        // 当前执行的异步同步任务
-    private static String mSyncProgress = "";              // 当前同步进度消息
+    private static GTaskASyncTask mSyncTask = null;
+
+    private static String mSyncProgress = "";
 
-    /**
-     * 启动同步操作
-     */
     private void startSync() {
         if (mSyncTask == null) {
-            // 创建新的异步同步任务
             mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
-                @Override
                 public void onComplete() {
-                    // 同步完成后的回调处理
                     mSyncTask = null;
-                    sendBroadcast("");  // 发送同步完成广播
-                    stopSelf();         // 停止服务
+                    sendBroadcast("");
+                    stopSelf();
                 }
             });
-            
-            sendBroadcast("");          // 发送同步开始广播
-            mSyncTask.execute();        // 执行异步同步任务
+            sendBroadcast("");
+            mSyncTask.execute();
         }
     }
 
-    /**
-     * 取消正在进行的同步操作
-     */
     private void cancelSync() {
         if (mSyncTask != null) {
-            mSyncTask.cancelSync();     // 调用异步任务的取消方法
+            mSyncTask.cancelSync();
         }
     }
 
     @Override
     public void onCreate() {
-        super.onCreate();
-        mSyncTask = null;               // 服务创建时初始化同步任务
+        mSyncTask = null;
     }
 
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
         Bundle bundle = intent.getExtras();
         if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
-            // 根据传入的操作类型执行相应操作
             switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) {
                 case ACTION_START_SYNC:
                     startSync();
@@ -93,76 +81,48 @@ public class GTaskSyncService extends Service {
                 default:
                     break;
             }
-            return START_STICKY;        // 服务被系统终止后尝试重新启动
+            return START_STICKY;
         }
         return super.onStartCommand(intent, flags, startId);
     }
 
     @Override
     public void onLowMemory() {
-        super.onLowMemory();
-        // 系统内存不足时取消同步任务
         if (mSyncTask != null) {
             mSyncTask.cancelSync();
         }
     }
 
-    @Override
     public IBinder onBind(Intent intent) {
-        return null;                    // 不支持绑定操作
+        return null;
     }
 
-    /**
-     * 发送同步状态广播
-     * @param msg 同步进度消息
-     */
     public void sendBroadcast(String msg) {
         mSyncProgress = msg;
-        
-        // 创建并发送广播
         Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
         intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null);
         intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg);
         sendBroadcast(intent);
     }
 
-    /**
-     * 静态方法：启动同步服务
-     * @param activity 调用该方法的Activity
-     */
     public static void startSync(Activity activity) {
-        GTaskManager.getInstance().setActivityContext(activity);  // 设置Activity上下文
-        
-        // 创建并启动服务
+        GTaskManager.getInstance().setActivityContext(activity);
         Intent intent = new Intent(activity, GTaskSyncService.class);
         intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC);
         activity.startService(intent);
     }
 
-    /**
-     * 静态方法：取消同步服务
-     * @param context 调用该方法的上下文
-     */
     public static void cancelSync(Context context) {
-        // 创建并启动服务，携带取消同步的操作类型
         Intent intent = new Intent(context, GTaskSyncService.class);
         intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC);
         context.startService(intent);
     }
 
-    /**
-     * 静态方法：检查是否正在同步
-     * @return 是否正在同步
-     */
     public static boolean isSyncing() {
         return mSyncTask != null;
     }
 
-    /**
-     * 静态方法：获取当前同步进度消息
-     * @return 同步进度消息
-     */
     public static String getProgressString() {
         return mSyncProgress;
     }
-}
+}

src/net/micode/notes/model/WorkingNote.java

@@ -31,69 +31,77 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.Notes.TextNote;
 import net.micode.notes.tool.ResourceParser.NoteBgResources;
 
-/**
- * 工作笔记管理类
- * 负责管理笔记的创建、加载、保存和设置变更等操作，
- * 提供与笔记交互的统一接口，并支持监听笔记设置变更事件
- */
+
 public class WorkingNote {
-    // 笔记核心数据
-    private Note mNote;                // 底层笔记数据模型
-    private long mNoteId;              // 笔记ID
-    private String mContent;           // 笔记内容
-    private int mMode;                 // 笔记模式（普通文本或待办列表）
-    private long mAlertDate;           // 提醒日期
-    private long mModifiedDate;        // 修改日期
-    private int mBgColorId;            // 背景颜色ID
-    private int mWidgetId;             // 关联的桌面小部件ID
-    private int mWidgetType;           // 小部件类型
-    private long mFolderId;            // 所属文件夹ID
-    private Context mContext;          // 应用上下文
-    private boolean mIsDeleted;        // 删除标记
-    
-    // 事件监听器
+    // Note for the working note
+    private Note mNote;
+    // Note Id
+    private long mNoteId;
+    // Note content
+    private String mContent;
+    // Note mode
+    private int mMode;
+
+    private long mAlertDate;
+
+    private long mModifiedDate;
+
+    private int mBgColorId;
+
+    private int mWidgetId;
+
+    private int mWidgetType;
+
+    private long mFolderId;
+
+    private Context mContext;
+
+    private static final String TAG = "WorkingNote";
+
+    private boolean mIsDeleted;
+
     private NoteSettingChangedListener mNoteSettingStatusListener;
-    
-    // 查询投影
+
     public static final String[] DATA_PROJECTION = new String[] {
-        DataColumns.ID,
-        DataColumns.CONTENT,
-        DataColumns.MIME_TYPE,
-        DataColumns.DATA1,
-        DataColumns.DATA2,
-        DataColumns.DATA3,
-        DataColumns.DATA4,
+            DataColumns.ID,
+            DataColumns.CONTENT,
+            DataColumns.MIME_TYPE,
+            DataColumns.DATA1,
+            DataColumns.DATA2,
+            DataColumns.DATA3,
+            DataColumns.DATA4,
     };
-    
+
     public static final String[] NOTE_PROJECTION = new String[] {
-        NoteColumns.PARENT_ID,
-        NoteColumns.ALERTED_DATE,
-        NoteColumns.BG_COLOR_ID,
-        NoteColumns.WIDGET_ID,
-        NoteColumns.WIDGET_TYPE,
-        NoteColumns.MODIFIED_DATE
+            NoteColumns.PARENT_ID,
+            NoteColumns.ALERTED_DATE,
+            NoteColumns.BG_COLOR_ID,
+            NoteColumns.WIDGET_ID,
+            NoteColumns.WIDGET_TYPE,
+            NoteColumns.MODIFIED_DATE
     };
-    
-    // 投影列索引
+
     private static final int DATA_ID_COLUMN = 0;
+
     private static final int DATA_CONTENT_COLUMN = 1;
+
     private static final int DATA_MIME_TYPE_COLUMN = 2;
+
     private static final int DATA_MODE_COLUMN = 3;
-    
+
     private static final int NOTE_PARENT_ID_COLUMN = 0;
+
     private static final int NOTE_ALERTED_DATE_COLUMN = 1;
+
     private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
+
     private static final int NOTE_WIDGET_ID_COLUMN = 3;
+
     private static final int NOTE_WIDGET_TYPE_COLUMN = 4;
+
     private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
-    
-    private static final String TAG = "WorkingNote";
 
-    /**
-     * 私有构造函数：创建新笔记
-     * @param context 上下文
-     * @param folderId 所属文件夹ID
-     */
+    // New note construct
     private WorkingNote(Context context, long folderId) {
         mContext = context;
         mAlertDate = 0;
@@ -106,12 +114,7 @@ public class WorkingNote {
         mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
     }
 
-    /**
-     * 私有构造函数：加载现有笔记
-     * @param context 上下文
-     * @param noteId 笔记ID
-     * @param folderId 所属文件夹ID
-     */
+    // Existing note construct
     private WorkingNote(Context context, long noteId, long folderId) {
         mContext = context;
         mNoteId = noteId;
@@ -121,18 +124,13 @@ public class WorkingNote {
         loadNote();
     }
 
-    /**
-     * 从数据库加载笔记信息
-     */
     private void loadNote() {
-        // 查询笔记主表信息
         Cursor cursor = mContext.getContentResolver().query(
-            ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), 
-            NOTE_PROJECTION, null, null, null);
+                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
+                null, null);
 
         if (cursor != null) {
             if (cursor.moveToFirst()) {
-                // 读取笔记主表字段
                 mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
                 mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
                 mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
@@ -145,35 +143,24 @@ public class WorkingNote {
             Log.e(TAG, "No note with id:" + mNoteId);
             throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
         }
-        
-        // 加载笔记内容数据
         loadNoteData();
     }
 
-    /**
-     * 从数据库加载笔记内容数据
-     */
     private void loadNoteData() {
-        // 查询笔记内容数据
-        Cursor cursor = mContext.getContentResolver().query(
-            Notes.CONTENT_DATA_URI, 
-            DATA_PROJECTION,
-            DataColumns.NOTE_ID + "=?", 
-            new String[] { String.valueOf(mNoteId) }, 
-            null);
+        Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
+                DataColumns.NOTE_ID + "=?", new String[] {
+                    String.valueOf(mNoteId)
+                }, null);
 
         if (cursor != null) {
             if (cursor.moveToFirst()) {
-                // 遍历所有关联的数据项
                 do {
                     String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
                     if (DataConstants.NOTE.equals(type)) {
-                        // 处理文本笔记数据
                         mContent = cursor.getString(DATA_CONTENT_COLUMN);
                         mMode = cursor.getInt(DATA_MODE_COLUMN);
                         mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
                     } else if (DataConstants.CALL_NOTE.equals(type)) {
-                        // 处理通话记录数据
                         mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
                     } else {
                         Log.d(TAG, "Wrong note type with type:" + type);
@@ -187,15 +174,6 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 创建空笔记的静态工厂方法
-     * @param context 上下文
-     * @param folderId 所属文件夹ID
-     * @param widgetId 关联的小部件ID
-     * @param widgetType 小部件类型
-     * @param defaultBgColorId 默认背景颜色ID
-     * @return 新创建的WorkingNote实例
-     */
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
             int widgetType, int defaultBgColorId) {
         WorkingNote note = new WorkingNote(context, folderId);
@@ -205,35 +183,23 @@ public class WorkingNote {
         return note;
     }
 
-    /**
-     * 从数据库加载现有笔记的静态工厂方法
-     * @param context 上下文
-     * @param id 笔记ID
-     * @return 加载的WorkingNote实例
-     */
     public static WorkingNote load(Context context, long id) {
         return new WorkingNote(context, id, 0);
     }
 
-    /**
-     * 保存笔记到数据库
-     * @return 保存成功返回true，否则返回false
-     */
     public synchronized boolean saveNote() {
         if (isWorthSaving()) {
             if (!existInDatabase()) {
-                // 新笔记需要先创建ID
                 if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
                     Log.e(TAG, "Create new note fail with id:" + mNoteId);
                     return false;
                 }
             }
 
-            // 同步笔记数据到数据库
             mNote.syncNote(mContext, mNoteId);
 
             /**
-             * 更新关联的桌面小部件内容
+             * Update widget content if there exist any widget of this note
              */
             if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                     && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
@@ -246,20 +212,11 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 检查笔记是否已存在于数据库中
-     * @return 存在返回true，否则返回false
-     */
     public boolean existInDatabase() {
         return mNoteId > 0;
     }
 
-    /**
-     * 判断笔记是否值得保存
-     * @return 值得保存返回true，否则返回false
-     */
     private boolean isWorthSaving() {
-        // 已删除或内容为空或无修改的笔记不值得保存
         if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
                 || (existInDatabase() && !mNote.isLocalModified())) {
             return false;
@@ -268,51 +225,31 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 设置笔记设置变更监听器
-     * @param l 监听器实例
-     */
     public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
         mNoteSettingStatusListener = l;
     }
 
-    /**
-     * 设置提醒日期
-     * @param date 提醒日期时间戳
-     * @param set 是否设置提醒
-     */
     public void setAlertDate(long date, boolean set) {
         if (date != mAlertDate) {
             mAlertDate = date;
             mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
         }
-        // 通知监听器提醒设置变更
         if (mNoteSettingStatusListener != null) {
             mNoteSettingStatusListener.onClockAlertChanged(date, set);
         }
     }
 
-    /**
-     * 标记笔记为已删除或未删除
-     * @param mark 删除标记
-     */
     public void markDeleted(boolean mark) {
         mIsDeleted = mark;
-        // 通知监听器小部件可能需要更新
         if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                 && mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
-            mNoteSettingStatusListener.onWidgetChanged();
+                mNoteSettingStatusListener.onWidgetChanged();
         }
     }
 
-    /**
-     * 设置笔记背景颜色
-     * @param id 背景颜色ID
-     */
     public void setBgColorId(int id) {
         if (id != mBgColorId) {
             mBgColorId = id;
-            // 通知监听器背景颜色变更
             if (mNoteSettingStatusListener != null) {
                 mNoteSettingStatusListener.onBackgroundColorChanged();
             }
@@ -320,13 +257,8 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 设置笔记模式（普通文本或待办列表）
-     * @param mode 模式值
-     */
     public void setCheckListMode(int mode) {
         if (mMode != mode) {
-            // 通知监听器模式变更
             if (mNoteSettingStatusListener != null) {
                 mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
             }
@@ -335,10 +267,6 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 设置关联的小部件类型
-     * @param type 小部件类型
-     */
     public void setWidgetType(int type) {
         if (type != mWidgetType) {
             mWidgetType = type;
@@ -346,10 +274,6 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 设置关联的小部件ID
-     * @param id 小部件ID
-     */
     public void setWidgetId(int id) {
         if (id != mWidgetId) {
             mWidgetId = id;
@@ -357,10 +281,6 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 设置笔记文本内容
-     * @param text 文本内容
-     */
     public void setWorkingText(String text) {
         if (!TextUtils.equals(mContent, text)) {
             mContent = text;
@@ -368,140 +288,81 @@ public class WorkingNote {
         }
     }
 
-    /**
-     * 将笔记转换为通话记录笔记
-     * @param phoneNumber 电话号码
-     * @param callDate 通话日期
-     */
     public void convertToCallNote(String phoneNumber, long callDate) {
         mNote.setCallData(CallNote.CALL_DATE, String.valueOf(callDate));
         mNote.setCallData(CallNote.PHONE_NUMBER, phoneNumber);
         mNote.setNoteValue(NoteColumns.PARENT_ID, String.valueOf(Notes.ID_CALL_RECORD_FOLDER));
     }
 
-    /**
-     * 检查笔记是否设置了提醒
-     * @return 设置了提醒返回true，否则返回false
-     */
     public boolean hasClockAlert() {
         return (mAlertDate > 0 ? true : false);
     }
 
-    /**
-     * 获取笔记内容
-     * @return 笔记内容字符串
-     */
     public String getContent() {
         return mContent;
     }
 
-    /**
-     * 获取提醒日期
-     * @return 提醒日期时间戳
-     */
     public long getAlertDate() {
         return mAlertDate;
     }
 
-    /**
-     * 获取修改日期
-     * @return 修改日期时间戳
-     */
     public long getModifiedDate() {
         return mModifiedDate;
     }
 
-    /**
-     * 获取背景颜色资源ID
-     * @return 背景颜色资源ID
-     */
     public int getBgColorResId() {
         return NoteBgResources.getNoteBgResource(mBgColorId);
     }
 
-    /**
-     * 获取背景颜色ID
-     * @return 背景颜色ID
-     */
     public int getBgColorId() {
         return mBgColorId;
     }
 
-    /**
-     * 获取标题背景资源ID
-     * @return 标题背景资源ID
-     */
     public int getTitleBgResId() {
         return NoteBgResources.getNoteTitleBgResource(mBgColorId);
     }
 
-    /**
-     * 获取笔记模式
-     * @return 笔记模式值
-     */
     public int getCheckListMode() {
         return mMode;
     }
 
-    /**
-     * 获取笔记ID
-     * @return 笔记ID
-     */
     public long getNoteId() {
         return mNoteId;
     }
 
-    /**
-     * 获取所属文件夹ID
-     * @return 文件夹ID
-     */
     public long getFolderId() {
         return mFolderId;
     }
 
-    /**
-     * 获取关联的小部件ID
-     * @return 小部件ID
-     */
     public int getWidgetId() {
         return mWidgetId;
     }
 
-    /**
-     * 获取小部件类型
-     * @return 小部件类型
-     */
     public int getWidgetType() {
         return mWidgetType;
     }
 
-    /**
-     * 笔记设置变更监听器接口
-     * 用于监听笔记设置的各种变更事件
-     */
     public interface NoteSettingChangedListener {
         /**
-         * 当笔记背景颜色变更时调用
+         * Called when the background color of current note has just changed
          */
         void onBackgroundColorChanged();
 
         /**
-         * 当用户设置或取消提醒时调用
-         * @param date 提醒日期
-         * @param set 是否设置提醒
+         * Called when user set clock
          */
         void onClockAlertChanged(long date, boolean set);
 
         /**
-         * 当笔记关联的小部件需要更新时调用
+         * Call when user create note from widget
          */
         void onWidgetChanged();
 
         /**
-         * 当笔记模式（普通文本/待办列表）变更时调用
-         * @param oldMode 变更前的模式
-         * @param newMode 变更后的模式
+         * Call when switch between check list mode and normal mode
+         * @param oldMode is previous mode before change
+         * @param newMode is new mode
          */
         void onCheckListModeChanged(int oldMode, int newMode);
     }
-}
+}

src/net/micode/notes/tool/BackupUtils.java

@@ -35,21 +35,12 @@ import java.io.FileOutputStream;
 import java.io.IOException;
 import java.io.PrintStream;
 
-/**
- * 笔记备份工具类
- * 提供将笔记导出为文本文件的功能，支持导出所有文件夹和笔记内容
- * 采用单例模式实现，确保全局唯一实例
- */
+
 public class BackupUtils {
     private static final String TAG = "BackupUtils";
-    // 单例实例
+    // Singleton stuff
     private static BackupUtils sInstance;
 
-    /**
-     * 获取BackupUtils的单例实例
-     * @param context 应用上下文
-     * @return BackupUtils实例
-     */
     public static synchronized BackupUtils getInstance(Context context) {
         if (sInstance == null) {
             sInstance = new BackupUtils(context);
@@ -58,17 +49,18 @@ public class BackupUtils {
     }
 
     /**
-     * 备份/恢复状态码
+     * Following states are signs to represents backup or restore
+     * status
      */
-    // SD卡未挂载
+    // Currently, the sdcard is not mounted
     public static final int STATE_SD_CARD_UNMOUONTED           = 0;
-    // 备份文件不存在
+    // The backup file not exist
     public static final int STATE_BACKUP_FILE_NOT_EXIST        = 1;
-    // 数据格式损坏
+    // The data is not well formated, may be changed by other programs
     public static final int STATE_DATA_DESTROIED               = 2;
-    // 系统错误
+    // Some run-time exception which causes restore or backup fails
     public static final int STATE_SYSTEM_ERROR                 = 3;
-    // 操作成功
+    // Backup or restore success
     public static final int STATE_SUCCESS                      = 4;
 
     private TextExport mTextExport;
@@ -77,43 +69,23 @@ public class BackupUtils {
         mTextExport = new TextExport(context);
     }
 
-    /**
-     * 检查外部存储是否可用
-     * @return 可用返回true，否则返回false
-     */
     private static boolean externalStorageAvailable() {
         return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
     }
 
-    /**
-     * 导出笔记为文本文件
-     * @return 导出状态码
-     */
     public int exportToText() {
         return mTextExport.exportToText();
     }
 
-    /**
-     * 获取导出的文本文件名
-     * @return 文件名
-     */
     public String getExportedTextFileName() {
         return mTextExport.mFileName;
     }
 
-    /**
-     * 获取导出的文本文件目录
-     * @return 文件目录
-     */
     public String getExportedTextFileDir() {
         return mTextExport.mFileDirectory;
     }
 
-    /**
-     * 内部类：处理文本导出逻辑
-     */
     private static class TextExport {
-        // 笔记查询投影
         private static final String[] NOTE_PROJECTION = {
                 NoteColumns.ID,
                 NoteColumns.MODIFIED_DATE,
@@ -121,12 +93,12 @@ public class BackupUtils {
                 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,
@@ -136,13 +108,14 @@ public class BackupUtils {
                 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;
+
         private static final int DATA_COLUMN_PHONE_NUMBER = 4;
 
-        // 文本导出格式
         private final String [] TEXT_FORMAT;
         private static final int FORMAT_FOLDER_NAME          = 0;
         private static final int FORMAT_NOTE_DATE            = 1;
@@ -159,22 +132,15 @@ public class BackupUtils {
             mFileDirectory = "";
         }
 
-        /**
-         * 获取格式化字符串
-         * @param id 格式ID
-         * @return 格式化字符串
-         */
         private String getFormat(int id) {
             return TEXT_FORMAT[id];
         }
 
         /**
-         * 将指定文件夹下的所有笔记导出到文本流
-         * @param folderId 文件夹ID
-         * @param ps 输出流
+         * Export the folder identified by folder id to text
          */
         private void exportFolderToText(String folderId, PrintStream ps) {
-            // 查询该文件夹下的所有笔记
+            // Query notes belong to this folder
             Cursor notesCursor = mContext.getContentResolver().query(Notes.CONTENT_NOTE_URI,
                     NOTE_PROJECTION, NoteColumns.PARENT_ID + "=?", new String[] {
                         folderId
@@ -183,11 +149,11 @@ public class BackupUtils {
             if (notesCursor != null) {
                 if (notesCursor.moveToFirst()) {
                     do {
-                        // 输出笔记修改日期
+                        // Print note's last modified date
                         ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
                                 mContext.getString(R.string.format_datetime_mdhm),
                                 notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
-                        // 导出笔记内容
+                        // Query data belong to this note
                         String noteId = notesCursor.getString(NOTE_COLUMN_ID);
                         exportNoteToText(noteId, ps);
                     } while (notesCursor.moveToNext());
@@ -197,12 +163,9 @@ public class BackupUtils {
         }
 
         /**
-         * 将指定笔记导出到文本流
-         * @param noteId 笔记ID
-         * @param ps 输出流
+         * Export note identified by id to a print stream
          */
         private void exportNoteToText(String noteId, PrintStream ps) {
-            // 查询笔记的数据内容
             Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
                     DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] {
                         noteId
@@ -213,7 +176,7 @@ public class BackupUtils {
                     do {
                         String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
                         if (DataConstants.CALL_NOTE.equals(mimeType)) {
-                            // 处理通话记录类型
+                            // Print phone number
                             String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
                             long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
                             String location = dataCursor.getString(DATA_COLUMN_CONTENT);
@@ -222,17 +185,16 @@ public class BackupUtils {
                                 ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
                                         phoneNumber));
                             }
-                            // 输出通话日期
+                            // Print call date
                             ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), DateFormat
                                     .format(mContext.getString(R.string.format_datetime_mdhm),
                                             callDate)));
-                            // 输出通话附件位置
+                            // Print call attachment location
                             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),
@@ -243,7 +205,7 @@ public class BackupUtils {
                 }
                 dataCursor.close();
             }
-            // 在笔记之间添加分隔符
+            // print a line separator between note
             try {
                 ps.write(new byte[] {
                         Character.LINE_SEPARATOR, Character.LETTER_NUMBER
@@ -254,8 +216,7 @@ public class BackupUtils {
         }
 
         /**
-         * 导出所有笔记为文本文件
-         * @return 导出状态码
+         * Note will be exported as text which is user readable
          */
         public int exportToText() {
             if (!externalStorageAvailable()) {
@@ -268,8 +229,7 @@ public class BackupUtils {
                 Log.e(TAG, "get print stream error");
                 return STATE_SYSTEM_ERROR;
             }
-            
-            // 1. 导出所有文件夹及其包含的笔记
+            // First export folder and its notes
             Cursor folderCursor = mContext.getContentResolver().query(
                     Notes.CONTENT_NOTE_URI,
                     NOTE_PROJECTION,
@@ -280,7 +240,7 @@ public class BackupUtils {
             if (folderCursor != null) {
                 if (folderCursor.moveToFirst()) {
                     do {
-                        // 输出文件夹名称
+                        // Print folder's name
                         String folderName = "";
                         if(folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
                             folderName = mContext.getString(R.string.call_record_folder_name);
@@ -290,7 +250,6 @@ public class BackupUtils {
                         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());
@@ -298,7 +257,7 @@ public class BackupUtils {
                 folderCursor.close();
             }
 
-            // 2. 导出根文件夹中的笔记
+            // Export notes in root's folder
             Cursor noteCursor = mContext.getContentResolver().query(
                     Notes.CONTENT_NOTE_URI,
                     NOTE_PROJECTION,
@@ -308,11 +267,10 @@ public class BackupUtils {
             if (noteCursor != null) {
                 if (noteCursor.moveToFirst()) {
                     do {
-                        // 输出笔记修改日期
                         ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
                                 mContext.getString(R.string.format_datetime_mdhm),
                                 noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
-                        // 导出笔记内容
+                        // Query data belong to this note
                         String noteId = noteCursor.getString(NOTE_COLUMN_ID);
                         exportNoteToText(noteId, ps);
                     } while (noteCursor.moveToNext());
@@ -325,8 +283,7 @@ public class BackupUtils {
         }
 
         /**
-         * 获取用于导出的文本输出流
-         * @return 输出流对象，失败时返回null
+         * Get a print stream pointed to the file {@generateExportedTextFile}
          */
         private PrintStream getExportToTextPrintStream() {
             File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
@@ -353,11 +310,7 @@ public class BackupUtils {
     }
 
     /**
-     * 在SD卡上生成用于存储导出数据的文件
-     * @param context 应用上下文
-     * @param filePathResId 文件路径资源ID
-     * @param fileNameFormatResId 文件名格式资源ID
-     * @return 生成的文件对象，失败时返回null
+     * Generate the text file to store imported data
      */
     private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
         StringBuilder sb = new StringBuilder();
@@ -386,4 +339,6 @@ public class BackupUtils {
 
         return null;
     }
-}
+}
+
+

src/net/micode/notes/tool/DataUtils.java

@@ -34,52 +34,44 @@ import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
 import java.util.ArrayList;
 import java.util.HashSet;
 
-/**
- * 笔记数据操作工具类
- * 提供笔记数据的增删改查等操作，支持批量处理和事务操作
- */
+
 public class DataUtils {
     public static final String TAG = "DataUtils";
-    
-    /**
-     * 批量删除笔记
-     * @param resolver ContentResolver实例
-     * @param ids 要删除的笔记ID集合
-     * @return 删除成功返回true，失败返回false
-     */
     public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
-        if (ids == null || ids.isEmpty()) {
-            Log.d(TAG, "No notes to delete");
+        if (ids == null) {
+            Log.d(TAG, "the ids is null");
+            return true;
+        }
+        if (ids.size() == 0) {
+            Log.d(TAG, "no id is in the hashset");
             return true;
         }
 
-        ArrayList<ContentProviderOperation> operations = new ArrayList<>();
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
         for (long id : ids) {
-            if (id == Notes.ID_ROOT_FOLDER) {
-                Log.e(TAG, "Cannot delete system folder root");
+            if(id == Notes.ID_ROOT_FOLDER) {
+                Log.e(TAG, "Don't delete system folder root");
                 continue;
             }
-            operations.add(ContentProviderOperation
-                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id))
-                    .build());
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            operationList.add(builder.build());
         }
-        
         try {
-            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operations);
-            return results != null && results.length > 0 && results[0] != null;
-        } catch (RemoteException | OperationApplicationException e) {
-            Log.e(TAG, "Batch delete failed: " + e.getMessage());
-            return false;
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "delete notes failed, ids:" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException e) {
+            Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+        } catch (OperationApplicationException e) {
+            Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
         }
+        return false;
     }
 
-    /**
-     * 将笔记移动到指定文件夹
-     * @param resolver ContentResolver实例
-     * @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();
         values.put(NoteColumns.PARENT_ID, desFolderId);
@@ -88,276 +80,208 @@ public class DataUtils {
         resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
     }
 
-    /**
-     * 批量将笔记移动到指定文件夹
-     * @param resolver ContentResolver实例
-     * @param ids 要移动的笔记ID集合
-     * @param folderId 目标文件夹ID
-     * @return 移动成功返回true，失败返回false
-     */
-    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids, long folderId) {
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
+            long folderId) {
         if (ids == null) {
-            Log.d(TAG, "No notes to move");
+            Log.d(TAG, "the ids is null");
             return true;
         }
 
-        ArrayList<ContentProviderOperation> operations = new ArrayList<>();
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
         for (long id : ids) {
-            operations.add(ContentProviderOperation
-                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id))
-                    .withValue(NoteColumns.PARENT_ID, folderId)
-                    .withValue(NoteColumns.LOCAL_MODIFIED, 1)
-                    .build());
+            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, operations);
-            return results != null && results.length > 0 && results[0] != null;
-        } catch (RemoteException | OperationApplicationException e) {
-            Log.e(TAG, "Batch move failed: " + e.getMessage());
-            return false;
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            if (results == null || results.length == 0 || results[0] == null) {
+                Log.d(TAG, "delete notes failed, ids:" + ids.toString());
+                return false;
+            }
+            return true;
+        } catch (RemoteException e) {
+            Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
+        } catch (OperationApplicationException e) {
+            Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
         }
+        return false;
     }
 
     /**
-     * 获取用户创建的文件夹数量（不包括系统文件夹）
-     * @param resolver ContentResolver实例
-     * @return 文件夹数量
+     * Get the all folder count except system folders {@link Notes#TYPE_SYSTEM}}
      */
     public static int getUserFolderCount(ContentResolver resolver) {
-        Cursor cursor = resolver.query(
-                Notes.CONTENT_NOTE_URI,
+        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) },
+                new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
                 null);
 
         int count = 0;
-        if (cursor != null) {
-            try {
-                if (cursor.moveToFirst()) {
+        if(cursor != null) {
+            if(cursor.moveToFirst()) {
+                try {
                     count = cursor.getInt(0);
+                } catch (IndexOutOfBoundsException e) {
+                    Log.e(TAG, "get folder count failed:" + e.toString());
+                } finally {
+                    cursor.close();
                 }
-            } catch (IndexOutOfBoundsException e) {
-                Log.e(TAG, "Failed to get folder count: " + e.toString());
-            } finally {
-                cursor.close();
             }
         }
         return count;
     }
 
-    /**
-     * 检查笔记是否存在且可见（不在回收站）
-     * @param resolver ContentResolver实例
-     * @param noteId 笔记ID
-     * @param type 笔记类型
-     * @return 存在且可见返回true，否则返回false
-     */
     public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
-        Cursor cursor = resolver.query(
-                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+        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) },
+                new String [] {String.valueOf(type)},
                 null);
 
-        boolean exists = false;
+        boolean exist = false;
         if (cursor != null) {
-            exists = cursor.getCount() > 0;
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
             cursor.close();
         }
-        return exists;
+        return exist;
     }
 
-    /**
-     * 检查笔记是否存在于数据库中
-     * @param resolver ContentResolver实例
-     * @param noteId 笔记ID
-     * @return 存在返回true，否则返回false
-     */
     public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(
-                ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
                 null, null, null, null);
 
-        boolean exists = false;
+        boolean exist = false;
         if (cursor != null) {
-            exists = cursor.getCount() > 0;
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
             cursor.close();
         }
-        return exists;
+        return exist;
     }
 
-    /**
-     * 检查数据项是否存在于数据库中
-     * @param resolver ContentResolver实例
-     * @param dataId 数据项ID
-     * @return 存在返回true，否则返回false
-     */
     public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
-        Cursor cursor = resolver.query(
-                ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
                 null, null, null, null);
 
-        boolean exists = false;
+        boolean exist = false;
         if (cursor != null) {
-            exists = cursor.getCount() > 0;
+            if (cursor.getCount() > 0) {
+                exist = true;
+            }
             cursor.close();
         }
-        return exists;
+        return exist;
     }
 
-    /**
-     * 检查可见文件夹中是否存在指定名称的文件夹
-     * @param resolver ContentResolver实例
-     * @param name 文件夹名称
-     * @return 存在返回true，否则返回false
-     */
     public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
-        Cursor cursor = resolver.query(
-                Notes.CONTENT_NOTE_URI, null,
+        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 exists = false;
-        if (cursor != null) {
-            exists = cursor.getCount() > 0;
+        boolean exist = false;
+        if(cursor != null) {
+            if(cursor.getCount() > 0) {
+                exist = true;
+            }
             cursor.close();
         }
-        return exists;
+        return exist;
     }
 
-    /**
-     * 获取指定文件夹下的所有桌面小部件属性
-     * @param resolver ContentResolver实例
-     * @param folderId 文件夹ID
-     * @return 小部件属性集合
-     */
     public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
-        Cursor cursor = resolver.query(
-                Notes.CONTENT_NOTE_URI,
+        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> widgets = null;
-        if (cursor != null) {
-            if (cursor.moveToFirst()) {
-                widgets = new HashSet<>();
+        HashSet<AppWidgetAttribute> set = null;
+        if (c != null) {
+            if (c.moveToFirst()) {
+                set = new HashSet<AppWidgetAttribute>();
                 do {
                     try {
                         AppWidgetAttribute widget = new AppWidgetAttribute();
-                        widget.widgetId = cursor.getInt(0);
-                        widget.widgetType = cursor.getInt(1);
-                        widgets.add(widget);
+                        widget.widgetId = c.getInt(0);
+                        widget.widgetType = c.getInt(1);
+                        set.add(widget);
                     } catch (IndexOutOfBoundsException e) {
-                        Log.e(TAG, "Failed to read widget attribute: " + e.toString());
+                        Log.e(TAG, e.toString());
                     }
-                } while (cursor.moveToNext());
+                } while (c.moveToNext());
             }
-            cursor.close();
+            c.close();
         }
-        return widgets;
+        return set;
     }
 
-    /**
-     * 根据笔记ID获取通话记录的电话号码
-     * @param resolver ContentResolver实例
-     * @param noteId 笔记ID
-     * @return 电话号码，如果不存在则返回空字符串
-     */
     public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(
-                Notes.CONTENT_DATA_URI,
-                new String[] { CallNote.PHONE_NUMBER },
+        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 },
+                new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
                 null);
 
-        String phoneNumber = "";
-        if (cursor != null) {
+        if (cursor != null && cursor.moveToFirst()) {
             try {
-                if (cursor.moveToFirst()) {
-                    phoneNumber = cursor.getString(0);
-                }
+                return cursor.getString(0);
             } catch (IndexOutOfBoundsException e) {
-                Log.e(TAG, "Failed to get call number: " + e.toString());
+                Log.e(TAG, "Get call number fails " + e.toString());
             } finally {
                 cursor.close();
             }
         }
-        return phoneNumber;
+        return "";
     }
 
-    /**
-     * 根据电话号码和通话日期获取笔记ID
-     * @param resolver ContentResolver实例
-     * @param phoneNumber 电话号码
-     * @param callDate 通话日期
-     * @return 笔记ID，如果不存在则返回0
-     */
     public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
-        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 },
+        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);
+            if (cursor.moveToFirst()) {
+                try {
+                    return cursor.getLong(0);
+                } catch (IndexOutOfBoundsException e) {
+                    Log.e(TAG, "Get call note id fails " + e.toString());
                 }
-            } catch (IndexOutOfBoundsException e) {
-                Log.e(TAG, "Failed to get call note id: " + e.toString());
-            } finally {
-                cursor.close();
             }
+            cursor.close();
         }
-        return noteId;
+        return 0;
     }
 
-    /**
-     * 根据笔记ID获取摘要信息
-     * @param resolver ContentResolver实例
-     * @param noteId 笔记ID
-     * @return 摘要信息
-     * @throws IllegalArgumentException 如果笔记不存在
-     */
     public static String getSnippetById(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(
-                Notes.CONTENT_NOTE_URI,
-                new String[] { NoteColumns.SNIPPET },
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String [] { NoteColumns.SNIPPET },
                 NoteColumns.ID + "=?",
-                new String[] { String.valueOf(noteId) },
+                new String [] { String.valueOf(noteId)},
                 null);
 
         if (cursor != null) {
-            try {
-                String snippet = "";
-                if (cursor.moveToFirst()) {
-                    snippet = cursor.getString(0);
-                }
-                return snippet;
-            } finally {
-                cursor.close();
+            String snippet = "";
+            if (cursor.moveToFirst()) {
+                snippet = cursor.getString(0);
             }
+            cursor.close();
+            return snippet;
         }
-        throw new IllegalArgumentException("Note not found with id: " + noteId);
+        throw new IllegalArgumentException("Note is not found with id: " + noteId);
     }
 
-    /**
-     * 格式化摘要信息（去除首尾空格并截取第一行）
-     * @param snippet 原始摘要
-     * @return 格式化后的摘要
-     */
     public static String getFormattedSnippet(String snippet) {
         if (snippet != null) {
             snippet = snippet.trim();
@@ -368,4 +292,4 @@ public class DataUtils {
         }
         return snippet;
     }
-}
+}

src/net/micode/notes/tool/GTaskStringUtils.java

@@ -16,62 +16,98 @@
 
 package net.micode.notes.tool;
 
-/**
- * Google Tasks 数据交互常量工具类
- * 定义与Google Tasks同步时使用的JSON字段常量、文件夹命名规范及元数据标识
- * 用于标准化数据传输格式和本地存储结构
- */
 public class GTaskStringUtils {
 
-    // Google Tasks 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_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_ENTITY_DELTA = "entity_delta";         // 实体变更
-    public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";           // 实体类型
-    public final static String GTASK_JSON_GET_DELETED = "get_deleted";           // 获取已删除项
-    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";                         // 用户信息
-
-    // 本地文件夹命名规范
-    public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]"; // MIUI笔记文件夹前缀
-    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"; // 元数据笔记名称（禁止修改删除）
-}
+    public final static String GTASK_JSON_ACTION_ID = "action_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";
+
+    public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
+
+    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";
+
+    public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_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_ENTITY_DELTA = "entity_delta";
+
+    public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
+
+    public final static String GTASK_JSON_GET_DELETED = "get_deleted";
+
+    public final static String GTASK_JSON_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";
+
+    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";
+
+    public final static String GTASK_JSON_NOTES = "notes";
+
+    public final static String GTASK_JSON_PARENT_ID = "parent_id";
+
+    public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_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";
+
+    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";
+
+    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/net/micode/notes/tool/ResourceParser.java

@@ -22,36 +22,24 @@ import android.preference.PreferenceManager;
 import net.micode.notes.R;
 import net.micode.notes.ui.NotesPreferenceActivity;
 
-/**
- * 资源解析工具类
- * 提供便签各种显示样式的资源ID解析和管理功能，包括背景色、字体大小等
- */
 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,
@@ -60,7 +48,6 @@ public class ResourceParser {
             R.drawable.edit_red
         };
 
-        // 便签标题区域背景资源数组
         private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
             R.drawable.edit_title_yellow,
             R.drawable.edit_title_blue,
@@ -69,47 +56,25 @@ public class ResourceParser {
             R.drawable.edit_title_red
         };
 
-        /**
-         * 获取指定颜色ID对应的便签编辑区域背景资源ID
-         * @param id 颜色ID，如YELLOW、BLUE等
-         * @return 背景资源ID
-         */
         public static int getNoteBgResource(int id) {
             return BG_EDIT_RESOURCES[id];
         }
 
-        /**
-         * 获取指定颜色ID对应的便签标题区域背景资源ID
-         * @param id 颜色ID，如YELLOW、BLUE等
-         * @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)) {
-            // 随机返回一种背景色
             return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
         } else {
-            // 返回默认背景色
             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,
@@ -118,7 +83,6 @@ public class ResourceParser {
             R.drawable.list_red_up
         };
 
-        // 列表中普通便签背景资源数组
         private final static int [] BG_NORMAL_RESOURCES = new int [] {
             R.drawable.list_yellow_middle,
             R.drawable.list_blue_middle,
@@ -127,7 +91,6 @@ public class ResourceParser {
             R.drawable.list_red_middle
         };
 
-        // 列表中最后一个便签背景资源数组
         private final static int [] BG_LAST_RESOURCES = new int [] {
             R.drawable.list_yellow_down,
             R.drawable.list_blue_down,
@@ -136,7 +99,6 @@ public class ResourceParser {
             R.drawable.list_red_down,
         };
 
-        // 列表中单独便签（只有一个便签时）背景资源数组
         private final static int [] BG_SINGLE_RESOURCES = new int [] {
             R.drawable.list_yellow_single,
             R.drawable.list_blue_single,
@@ -145,56 +107,28 @@ public class ResourceParser {
             R.drawable.list_red_single
         };
 
-        /**
-         * 获取列表中第一个便签的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源ID
-         */
         public static int getNoteBgFirstRes(int id) {
             return BG_FIRST_RESOURCES[id];
         }
 
-        /**
-         * 获取列表中最后一个便签的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源ID
-         */
         public static int getNoteBgLastRes(int id) {
             return BG_LAST_RESOURCES[id];
         }
 
-        /**
-         * 获取列表中单独便签的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源ID
-         */
         public static int getNoteBgSingleRes(int id) {
             return BG_SINGLE_RESOURCES[id];
         }
 
-        /**
-         * 获取列表中普通便签的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源ID
-         */
         public static int getNoteBgNormalRes(int id) {
             return BG_NORMAL_RESOURCES[id];
         }
 
-        /**
-         * 获取文件夹背景资源ID
-         * @return 文件夹背景资源ID
-         */
         public static int getFolderBgRes() {
             return R.drawable.list_folder;
         }
     }
 
-    /**
-     * 桌面小部件背景资源
-     */
     public static class WidgetBgResources {
-        // 2x尺寸小部件背景资源数组
         private final static int [] BG_2X_RESOURCES = new int [] {
             R.drawable.widget_2x_yellow,
             R.drawable.widget_2x_blue,
@@ -203,16 +137,10 @@ public class ResourceParser {
             R.drawable.widget_2x_red,
         };
 
-        /**
-         * 获取2x尺寸小部件的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源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,
             R.drawable.widget_4x_blue,
@@ -221,21 +149,12 @@ public class ResourceParser {
             R.drawable.widget_4x_red
         };
 
-        /**
-         * 获取4x尺寸小部件的背景资源ID
-         * @param id 颜色ID
-         * @return 背景资源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,
@@ -243,15 +162,11 @@ public class ResourceParser {
             R.style.TextAppearanceSuper
         };
 
-        /**
-         * 获取指定字体大小ID对应的文本外观样式资源ID
-         * @param id 字体大小ID，如TEXT_SMALL、TEXT_MEDIUM等
-         * @return 文本外观样式资源ID
-         */
         public static int getTexAppearanceResource(int id) {
             /**
-             * 修复在共享偏好中存储资源ID可能导致的问题
-             * 如果ID超出资源数组长度，返回默认字体大小对应的资源ID
+             * HACKME: Fix bug of store the resource id in shared preference.
+             * The id may larger than the length of resources, in this case,
+             * return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
              */
             if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                 return BG_DEFAULT_FONT_SIZE;
@@ -259,12 +174,8 @@ public class ResourceParser {
             return TEXTAPPEARANCE_RESOURCES[id];
         }
 
-        /**
-         * 获取文本外观资源数组的长度
-         * @return 资源数组长度
-         */
         public static int getResourcesSize() {
             return TEXTAPPEARANCE_RESOURCES.length;
         }
     }
-}
+}

src/net/micode/notes/ui/NoteItemData.java

@@ -7,13 +7,13 @@
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * 代码功能：便签项数据模型
- * 主要职责：
- * 1. 封装便签/文件夹的数据库字段
- * 2. 处理通话记录便签的联系人名称解析
- * 3. 维护列表项的位置状态（是否为首项/末项等）
- * 4. 提供类型判断和数据访问接口
+ * 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.ui;
 
 import android.content.Context;
@@ -25,173 +25,200 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.tool.DataUtils;
 
-/**
- * 便签项数据模型
- * 用于封装从数据库查询到的便签或文件夹数据
- * 提供类型判断、位置状态检测和数据访问接口
- */
+
 public class NoteItemData {
-    // 数据库查询投影：指定要获取的字段
-    static final String[] PROJECTION = new String[]{
-        NoteColumns.ID,              // 便签/文件夹ID
-        NoteColumns.ALERTED_DATE,    // 提醒时间
-        NoteColumns.BG_COLOR_ID,     // 背景颜色ID
-        NoteColumns.CREATED_DATE,    // 创建时间
-        NoteColumns.HAS_ATTACHMENT,  // 是否有附件
-        NoteColumns.MODIFIED_DATE,   // 最后修改时间
-        NoteColumns.NOTES_COUNT,     // 子便签数量（文件夹）
-        NoteColumns.PARENT_ID,       // 父文件夹ID
-        NoteColumns.SNIPPET,         // 摘要/名称
-        NoteColumns.TYPE,            // 类型（便签/文件夹/系统项）
-        NoteColumns.WIDGET_ID,       // 小部件ID
-        NoteColumns.WIDGET_TYPE,     // 小部件类型
+    static final String [] PROJECTION = new String [] {
+        NoteColumns.ID,
+        NoteColumns.ALERTED_DATE,
+        NoteColumns.BG_COLOR_ID,
+        NoteColumns.CREATED_DATE,
+        NoteColumns.HAS_ATTACHMENT,
+        NoteColumns.MODIFIED_DATE,
+        NoteColumns.NOTES_COUNT,
+        NoteColumns.PARENT_ID,
+        NoteColumns.SNIPPET,
+        NoteColumns.TYPE,
+        NoteColumns.WIDGET_ID,
+        NoteColumns.WIDGET_TYPE,
     };
 
-    // 列索引常量，用于快速定位Cursor中的数据
-    private static final int ID_COLUMN = 0;
-    private static final int ALERTED_DATE_COLUMN = 1;
-    private static final int BG_COLOR_ID_COLUMN = 2;
-    private static final int CREATED_DATE_COLUMN = 3;
-    private static final int HAS_ATTACHMENT_COLUMN = 4;
-    private static final int MODIFIED_DATE_COLUMN = 5;
-    private static final int NOTES_COUNT_COLUMN = 6;
-    private static final int PARENT_ID_COLUMN = 7;
-    private static final int SNIPPET_COLUMN = 8;
-    private static final int TYPE_COLUMN = 9;
-    private static final int WIDGET_ID_COLUMN = 10;
-    private static final int WIDGET_TYPE_COLUMN = 11;
-
-    // 数据字段
-    private long mId;                // 项ID
-    private long mAlertDate;         // 提醒时间
-    private int mBgColorId;          // 背景颜色ID
-    private long mCreatedDate;       // 创建时间
-    private boolean mHasAttachment;  // 是否有附件
-    private long mModifiedDate;      // 最后修改时间
-    private int mNotesCount;         // 子项数量（文件夹）
-    private long mParentId;          // 父文件夹ID
-    private String mSnippet;         // 摘要/名称
-    private int mType;               // 类型
-    private int mWidgetId;           // 小部件ID
-    private int mWidgetType;         // 小部件类型
-    private String mName;            // 联系人名称（通话记录便签）
-    private String mPhoneNumber;     // 电话号码（通话记录便签）
-
-    // 位置状态字段
-    private boolean mIsLastItem;             // 是否为列表末项
-    private boolean mIsFirstItem;            // 是否为列表首项
-    private boolean mIsOnlyOneItem;          // 是否为列表唯一项
-    private boolean mIsOneNoteFollowingFolder; // 是否为文件夹后的单便签项
-    private boolean mIsMultiNotesFollowingFolder; // 是否为文件夹后的多便签项
-
-    /**
-     * 构造函数：从Cursor中初始化数据
-     * @param context 上下文
-     * @param cursor 包含数据的Cursor
-     */
+    private static final int ID_COLUMN                    = 0;
+    private static final int ALERTED_DATE_COLUMN          = 1;
+    private static final int BG_COLOR_ID_COLUMN           = 2;
+    private static final int CREATED_DATE_COLUMN          = 3;
+    private static final int HAS_ATTACHMENT_COLUMN        = 4;
+    private static final int MODIFIED_DATE_COLUMN         = 5;
+    private static final int NOTES_COUNT_COLUMN           = 6;
+    private static final int PARENT_ID_COLUMN             = 7;
+    private static final int SNIPPET_COLUMN               = 8;
+    private static final int TYPE_COLUMN                  = 9;
+    private static final int WIDGET_ID_COLUMN             = 10;
+    private static final int WIDGET_TYPE_COLUMN           = 11;
+
+    private long mId;
+    private long mAlertDate;
+    private int mBgColorId;
+    private long mCreatedDate;
+    private boolean mHasAttachment;
+    private long mModifiedDate;
+    private int mNotesCount;
+    private long mParentId;
+    private String mSnippet;
+    private int mType;
+    private int mWidgetId;
+    private int mWidgetType;
+    private String mName;
+    private String mPhoneNumber;
+
+    private boolean mIsLastItem;
+    private boolean mIsFirstItem;
+    private boolean mIsOnlyOneItem;
+    private boolean mIsOneNoteFollowingFolder;
+    private boolean mIsMultiNotesFollowingFolder;
+
     public NoteItemData(Context context, Cursor cursor) {
-        // 从Cursor中读取字段值
         mId = cursor.getLong(ID_COLUMN);
         mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
         mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
         mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
-        mHasAttachment = cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0;
+        mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
         mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
         mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
         mParentId = cursor.getLong(PARENT_ID_COLUMN);
         mSnippet = cursor.getString(SNIPPET_COLUMN);
-        // 移除清单模式标记（仅保留文本内容）
         mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
                 NoteEditActivity.TAG_UNCHECKED, "");
         mType = cursor.getInt(TYPE_COLUMN);
         mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
         mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
 
-        // 处理通话记录便签：解析联系人名称
         mPhoneNumber = "";
         if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
             mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
             if (!TextUtils.isEmpty(mPhoneNumber)) {
-                mName = Contact.getContact(context, mPhoneNumber); // 从联系人获取名称
+                mName = Contact.getContact(context, mPhoneNumber);
                 if (mName == null) {
-                    mName = mPhoneNumber; // 无联系人时使用电话号码
+                    mName = mPhoneNumber;
                 }
             }
         }
+
         if (mName == null) {
             mName = "";
         }
-
-        checkPostion(cursor); // 检测列表中的位置状态
+        checkPostion(cursor);
     }
 
-    /**
-     * 检测列表项的位置状态
-     * @param cursor 当前Cursor（需保持原始位置）
-     */
     private void checkPostion(Cursor cursor) {
-        // 获取基本位置状态
-        mIsLastItem = cursor.isLast();
-        mIsFirstItem = cursor.isFirst();
+        mIsLastItem = cursor.isLast() ? true : false;
+        mIsFirstItem = cursor.isFirst() ? true : false;
         mIsOnlyOneItem = (cursor.getCount() == 1);
         mIsMultiNotesFollowingFolder = false;
         mIsOneNoteFollowingFolder = false;
 
-        // 检测是否为文件夹后的便签项
         if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
-            int currentPosition = cursor.getPosition();
-            if (cursor.moveToPrevious()) { // 移动到前一项
-                // 前一项是文件夹或系统项
-                if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER || 
-                    cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
-                    // 判断后续项数量
-                    if (cursor.getCount() > (currentPosition + 1)) {
-                        mIsMultiNotesFollowingFolder = true; // 后续有多条便签
+            int position = cursor.getPosition();
+            if (cursor.moveToPrevious()) {
+                if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
+                        || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
+                    if (cursor.getCount() > (position + 1)) {
+                        mIsMultiNotesFollowingFolder = true;
                     } else {
-                        mIsOneNoteFollowingFolder = true; // 后续仅有一条便签
+                        mIsOneNoteFollowingFolder = true;
                     }
                 }
-                // 恢复Cursor位置
-                if (!cursor.moveToPosition(currentPosition)) {
-                    throw new IllegalStateException("Cursor位置恢复失败");
+                if (!cursor.moveToNext()) {
+                    throw new IllegalStateException("cursor move to previous but can't move back");
                 }
             }
         }
     }
 
-    // 位置状态查询方法
-    public boolean isOneFollowingFolder() { return mIsOneNoteFollowingFolder; }
-    public boolean isMultiFollowingFolder() { return mIsMultiNotesFollowingFolder; }
-    public boolean isLast() { return mIsLastItem; }
-    public boolean isFirst() { return mIsFirstItem; }
-    public boolean isSingle() { return mIsOnlyOneItem; }
-
-    // 数据访问方法
-    public long getId() { return mId; }
-    public long getAlertDate() { return mAlertDate; }
-    public long getCreatedDate() { return mCreatedDate; }
-    public boolean hasAttachment() { return mHasAttachment; }
-    public long getModifiedDate() { return mModifiedDate; }
-    public int getBgColorId() { return mBgColorId; }
-    public long getParentId() { return mParentId; }
-    public int getNotesCount() { return mNotesCount; }
-    public long getFolderId() { return mParentId; } // 文件夹ID等同于父ID
-    public int getType() { return mType; }
-    public int getWidgetType() { return mWidgetType; }
-    public int getWidgetId() { return mWidgetId; }
-    public String getSnippet() { return mSnippet; }
-    public boolean hasAlert() { return mAlertDate > 0; }
-    public boolean isCallRecord() { 
+    public boolean isOneFollowingFolder() {
+        return mIsOneNoteFollowingFolder;
+    }
+
+    public boolean isMultiFollowingFolder() {
+        return mIsMultiNotesFollowingFolder;
+    }
+
+    public boolean isLast() {
+        return mIsLastItem;
+    }
+
+    public String getCallName() {
+        return mName;
+    }
+
+    public boolean isFirst() {
+        return mIsFirstItem;
+    }
+
+    public boolean isSingle() {
+        return mIsOnlyOneItem;
+    }
+
+    public long getId() {
+        return mId;
+    }
+
+    public long getAlertDate() {
+        return mAlertDate;
+    }
+
+    public long getCreatedDate() {
+        return mCreatedDate;
+    }
+
+    public boolean hasAttachment() {
+        return mHasAttachment;
+    }
+
+    public long getModifiedDate() {
+        return mModifiedDate;
+    }
+
+    public int getBgColorId() {
+        return mBgColorId;
+    }
+
+    public long getParentId() {
+        return mParentId;
+    }
+
+    public int getNotesCount() {
+        return mNotesCount;
+    }
+
+    public long getFolderId () {
+        return mParentId;
+    }
+
+    public int getType() {
+        return mType;
+    }
+
+    public int getWidgetType() {
+        return mWidgetType;
+    }
+
+    public int getWidgetId() {
+        return mWidgetId;
+    }
+
+    public String getSnippet() {
+        return mSnippet;
+    }
+
+    public boolean hasAlert() {
+        return (mAlertDate > 0);
+    }
+
+    public boolean isCallRecord() {
         return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
     }
-    public String getCallName() { return mName; } // 获取通话记录的联系人名称
 
-    /**
-     * 静态方法：从Cursor中获取项类型
-     * @param cursor 当前Cursor
-     * @return 项类型（TYPE_NOTE/TYPE_FOLDER等）
-     */
     public static int getNoteType(Cursor cursor) {
         return cursor.getInt(TYPE_COLUMN);
     }
-}
+}

src/net/micode/notes/ui/NotesListAdapter.java

@@ -7,13 +7,13 @@
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * 代码功能：便签列表适配器
- * 主要职责：
- * 1. 管理便签/文件夹列表的数据绑定和视图渲染
- * 2. 支持多选模式下的选中状态管理
- * 3. 提供批量操作所需的选中项数据获取接口
- * 4. 配合CursorAdapter实现数据变化的自动更新
+ * 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.ui;
 
 import android.content.Context;
@@ -30,211 +30,155 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-/**
- * 便签列表适配器
- * 继承自CursorAdapter，用于绑定便签/文件夹数据到列表视图
- * 支持多选模式下的选中状态管理，提供批量操作所需的选中项数据接口
- */
+
 public class NotesListAdapter extends CursorAdapter {
     private static final String TAG = "NotesListAdapter";
-    private Context mContext;                 // 上下文
-    private HashMap<Integer, Boolean> mSelectedIndex; // 选中项索引映射（位置->是否选中）
-    private int mNotesCount;                  // 便签项总数（用于全选判断）
-    private boolean mChoiceMode;              // 是否为多选模式
+    private Context mContext;
+    private HashMap<Integer, Boolean> mSelectedIndex;
+    private int mNotesCount;
+    private boolean mChoiceMode;
 
-    // 小部件属性数据结构
     public static class AppWidgetAttribute {
-        public int widgetId;    // 小部件ID
-        public int widgetType;  // 小部件类型（如2x1、4x1）
-    }
+        public int widgetId;
+        public int widgetType;
+    };
 
     public NotesListAdapter(Context context) {
         super(context, null);
-        mSelectedIndex = new HashMap<>(); // 初始化选中状态集合
+        mSelectedIndex = new HashMap<Integer, Boolean>();
         mContext = context;
         mNotesCount = 0;
     }
 
-    /**
-     * 创建列表项视图
-     * @param context 上下文
-     * @param cursor 数据游标
-     * @param parent 父视图组
-     * @return 列表项视图（NotesListItem实例）
-     */
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
-        return new NotesListItem(context); // 使用自定义列表项视图
+        return new NotesListItem(context);
     }
 
-    /**
-     * 绑定数据到列表项视图
-     * @param view 列表项视图
-     * @param context 上下文
-     * @param cursor 数据游标
-     */
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
         if (view instanceof NotesListItem) {
-            NoteItemData itemData = new NoteItemData(context, cursor); // 从游标创建数据模型
-            // 渲染视图：传入多选模式状态和当前项选中状态
-            ((NotesListItem) view).bind(context, itemData, mChoiceMode, isSelectedItem(cursor.getPosition()));
+            NoteItemData itemData = new NoteItemData(context, cursor);
+            ((NotesListItem) view).bind(context, itemData, mChoiceMode,
+                    isSelectedItem(cursor.getPosition()));
         }
     }
 
-    /**
-     * 设置指定位置项的选中状态
-     * @param position 列表位置
-     * @param checked 是否选中
-     */
     public void setCheckedItem(final int position, final boolean checked) {
-        mSelectedIndex.put(position, checked); // 更新选中状态映射
-        notifyDataSetChanged(); // 通知适配器数据变化，刷新视图
+        mSelectedIndex.put(position, checked);
+        notifyDataSetChanged();
     }
 
-    /**
-     * 获取当前是否为多选模式
-     * @return 是否为多选模式
-     */
     public boolean isInChoiceMode() {
         return mChoiceMode;
     }
 
-    /**
-     * 设置多选模式状态
-     * @param mode 是否开启多选模式
-     */
     public void setChoiceMode(boolean mode) {
-        mSelectedIndex.clear(); // 清空选中状态
+        mSelectedIndex.clear();
         mChoiceMode = mode;
     }
 
-    /**
-     * 全选/反选所有便签项
-     * @param checked 是否全选
-     */
     public void selectAll(boolean checked) {
         Cursor cursor = getCursor();
-        if (cursor != null) {
-            for (int i = 0; i < getCount(); i++) {
-                if (cursor.moveToPosition(i)) {
-                    // 仅对便签项（非文件夹）进行操作
-                    if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
-                        setCheckedItem(i, checked); // 设置选中状态
-                    }
+        for (int i = 0; i < getCount(); i++) {
+            if (cursor.moveToPosition(i)) {
+                if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
+                    setCheckedItem(i, checked);
                 }
             }
         }
     }
 
-    /**
-     * 获取所有选中项的ID集合
-     * @return 选中项ID的HashSet（排除根文件夹）
-     */
     public HashSet<Long> getSelectedItemIds() {
-        HashSet<Long> itemSet = new HashSet<>();
+        HashSet<Long> itemSet = new HashSet<Long>();
         for (Integer position : mSelectedIndex.keySet()) {
-            if (mSelectedIndex.get(position)) { // 仅处理选中的项
-                Long id = getItemId(position); // 获取项ID
-                if (id != Notes.ID_ROOT_FOLDER) { // 过滤根文件夹（不可删除/移动）
-                    itemSet.add(id);
+            if (mSelectedIndex.get(position) == true) {
+                Long id = getItemId(position);
+                if (id == Notes.ID_ROOT_FOLDER) {
+                    Log.d(TAG, "Wrong item id, should not happen");
                 } else {
-                    Log.d(TAG, "错误：选中根文件夹，ID=" + id);
+                    itemSet.add(id);
                 }
             }
         }
+
         return itemSet;
     }
 
-    /**
-     * 获取所有选中项关联的小部件属性
-     * @return 小部件属性的HashSet
-     */
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
-        HashSet<AppWidgetAttribute> widgetSet = new HashSet<>();
+        HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
-            if (mSelectedIndex.get(position)) { // 仅处理选中的项
-                Cursor c = (Cursor) getItem(position); // 获取游标
+            if (mSelectedIndex.get(position) == true) {
+                Cursor c = (Cursor) getItem(position);
                 if (c != null) {
-                    NoteItemData item = new NoteItemData(mContext, c); // 创建数据模型
                     AppWidgetAttribute widget = new AppWidgetAttribute();
-                    widget.widgetId = item.getWidgetId(); // 小部件ID
-                    widget.widgetType = item.getWidgetType(); // 小部件类型
-                    widgetSet.add(widget);
+                    NoteItemData item = new NoteItemData(mContext, c);
+                    widget.widgetId = item.getWidgetId();
+                    widget.widgetType = item.getWidgetType();
+                    itemSet.add(widget);
+                    /**
+                     * Don't close cursor here, only the adapter could close it
+                     */
                 } else {
-                    Log.e(TAG, "错误：游标无效，无法获取小部件信息");
+                    Log.e(TAG, "Invalid cursor");
                     return null;
                 }
             }
         }
-        return widgetSet;
+        return itemSet;
     }
 
-    /**
-     * 获取选中项数量
-     * @return 选中项数量
-     */
     public int getSelectedCount() {
         Collection<Boolean> values = mSelectedIndex.values();
-        if (values == null) return 0;
+        if (null == values) {
+            return 0;
+        }
+        Iterator<Boolean> iter = values.iterator();
         int count = 0;
-        for (Boolean isChecked : values) {
-            if (isChecked) count++; // 统计选中项
+        while (iter.hasNext()) {
+            if (true == iter.next()) {
+                count++;
+            }
         }
         return count;
     }
 
-    /**
-     * 判断是否全选
-     * @return 是否所有便签项均被选中
-     */
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
-        return (checkedCount > 0 && checkedCount == mNotesCount); // 选中数大于0且等于便签总数
+        return (checkedCount != 0 && checkedCount == mNotesCount);
     }
 
-    /**
-     * 判断指定位置项是否选中
-     * @param position 列表位置
-     * @return 是否选中
-     */
     public boolean isSelectedItem(final int position) {
-        return mSelectedIndex.getOrDefault(position, false); // 默认未选中
+        if (null == mSelectedIndex.get(position)) {
+            return false;
+        }
+        return mSelectedIndex.get(position);
     }
 
-    /**
-     * 内容变化时的回调（数据更新）
-     */
     @Override
     protected void onContentChanged() {
         super.onContentChanged();
-        calcNotesCount(); // 重新计算便签项总数
+        calcNotesCount();
     }
 
-    /**
-     * 更换数据游标时的回调
-     * @param cursor 新数据游标
-     */
     @Override
     public void changeCursor(Cursor cursor) {
         super.changeCursor(cursor);
-        calcNotesCount(); // 重新计算便签项总数
+        calcNotesCount();
     }
 
-    /**
-     * 计算便签项总数（排除文件夹）
-     */
     private void calcNotesCount() {
         mNotesCount = 0;
-        Cursor cursor = getCursor();
-        if (cursor != null) {
-            for (int i = 0; i < cursor.getCount(); i++) {
-                if (cursor.moveToPosition(i)) {
-                    if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
-                        mNotesCount++; // 统计类型为便签的项
-                    }
+        for (int i = 0; i < getCount(); i++) {
+            Cursor c = (Cursor) getItem(i);
+            if (c != null) {
+                if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
+                    mNotesCount++;
                 }
+            } else {
+                Log.e(TAG, "Invalid cursor");
+                return;
             }
         }
     }
-}
+}

src/net/micode/notes/ui/NotesListItem.java

@@ -7,13 +7,13 @@
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * 代码功能：便签列表项视图
- * 主要职责：
- * 1. 展示便签/文件夹的视觉样式和数据
- * 2. 处理不同类型项（普通便签、文件夹、通话记录）的差异化渲染
- * 3. 支持多选模式下的复选框显示
- * 4. 根据位置状态动态设置背景样式
+ * 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.ui;
 
 import android.content.Context;
@@ -29,24 +29,18 @@ import net.micode.notes.data.Notes;
 import net.micode.notes.tool.DataUtils;
 import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
 
-/**
- * 便签列表项视图
- * 继承自LinearLayout，用于展示单个便签或文件夹项
- * 支持不同类型项的差异化渲染，包括普通便签、文件夹、通话记录便签
- */
+
 public class NotesListItem extends LinearLayout {
-    private ImageView mAlert;     // 提醒图标
-    private TextView mTitle;       // 标题/内容
-    private TextView mTime;        // 最后修改时间
-    private TextView mCallName;    // 联系人名称（通话记录便签）
-    private NoteItemData mItemData; // 数据模型
-    private CheckBox mCheckBox;    // 多选复选框
+    private ImageView mAlert;
+    private TextView mTitle;
+    private TextView mTime;
+    private TextView mCallName;
+    private NoteItemData mItemData;
+    private CheckBox mCheckBox;
 
     public NotesListItem(Context context) {
         super(context);
-        // 加载列表项布局
         inflate(context, R.layout.note_item, this);
-        // 初始化视图元素
         mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
         mTitle = (TextView) findViewById(R.id.tv_title);
         mTime = (TextView) findViewById(R.id.tv_time);
@@ -54,15 +48,7 @@ public class NotesListItem extends LinearLayout {
         mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
     }
 
-    /**
-     * 绑定数据并渲染视图
-     * @param context 上下文
-     * @param data 数据模型
-     * @param choiceMode 是否为多选模式
-     * @param checked 当前选中状态（多选模式下有效）
-     */
     public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
-        // 处理多选模式下的复选框显示
         if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
             mCheckBox.setVisibility(View.VISIBLE);
             mCheckBox.setChecked(checked);
@@ -71,24 +57,18 @@ public class NotesListItem extends LinearLayout {
         }
 
         mItemData = data;
-
-        // 根据不同类型项进行差异化渲染
         if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
-            // 通话记录文件夹
             mCallName.setVisibility(View.GONE);
             mAlert.setVisibility(View.VISIBLE);
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
-            // 显示文件夹名称和子项数量
-            mTitle.setText(context.getString(R.string.call_record_folder_name) 
+            mTitle.setText(context.getString(R.string.call_record_folder_name)
                     + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
-            mAlert.setImageResource(R.drawable.call_record); // 设置通话记录图标
+            mAlert.setImageResource(R.drawable.call_record);
         } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
-            // 通话记录便签（子项）
             mCallName.setVisibility(View.VISIBLE);
-            mCallName.setText(data.getCallName()); // 显示联系人名称
-            mTitle.setTextAppearance(context, R.style.TextAppearanceSecondaryItem);
-            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 显示格式化后的摘要
-            // 显示提醒图标（如有）
+            mCallName.setText(data.getCallName());
+            mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
+            mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
             if (data.hasAlert()) {
                 mAlert.setImageResource(R.drawable.clock);
                 mAlert.setVisibility(View.VISIBLE);
@@ -96,19 +76,16 @@ public class NotesListItem extends LinearLayout {
                 mAlert.setVisibility(View.GONE);
             }
         } else {
-            // 普通便签或文件夹
             mCallName.setVisibility(View.GONE);
             mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
 
             if (data.getType() == Notes.TYPE_FOLDER) {
-                // 文件夹项：显示名称和子项数量
-                mTitle.setText(data.getSnippet() 
-                        + context.getString(R.string.format_folder_files_count, data.getNotesCount()));
-                mAlert.setVisibility(View.GONE); // 文件夹不显示提醒图标
+                mTitle.setText(data.getSnippet()
+                        + context.getString(R.string.format_folder_files_count,
+                                data.getNotesCount()));
+                mAlert.setVisibility(View.GONE);
             } else {
-                // 普通便签项
-                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 显示格式化后的摘要
-                // 显示提醒图标（如有）
+                mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
                 if (data.hasAlert()) {
                     mAlert.setImageResource(R.drawable.clock);
                     mAlert.setVisibility(View.VISIBLE);
@@ -117,45 +94,29 @@ public class NotesListItem extends LinearLayout {
                 }
             }
         }
-
-        // 显示最后修改时间（相对时间格式）
         mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
-        // 根据位置状态和类型设置背景样式
+
         setBackground(data);
     }
 
-    /**
-     * 根据数据模型设置列表项背景
-     * @param data 数据模型
-     */
     private void setBackground(NoteItemData data) {
-        int bgColorId = data.getBgColorId();
+        int id = data.getBgColorId();
         if (data.getType() == Notes.TYPE_NOTE) {
-            // 便签项背景逻辑（根据位置状态选择不同背景）
             if (data.isSingle() || data.isOneFollowingFolder()) {
-                // 单独项或文件夹后的单条便签
-                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(bgColorId));
+                setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
             } else if (data.isLast()) {
-                // 列表末项
-                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(bgColorId));
+                setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
             } else if (data.isFirst() || data.isMultiFollowingFolder()) {
-                // 列表首项或文件夹后的多条便签首项
-                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(bgColorId));
+                setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
             } else {
-                // 普通中间项
-                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(bgColorId));
+                setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
             }
         } else {
-            // 文件夹项使用统一背景
             setBackgroundResource(NoteItemBgResources.getFolderBgRes());
         }
     }
 
-    /**
-     * 获取数据模型
-     * @return 数据模型实例
-     */
     public NoteItemData getItemData() {
         return mItemData;
     }
-}
+}