Merge branch 'main' of https://bdgit.educoder.net/ppm9irgyz/MINotes

fanlei

ActionFailureException.java

@@ -1,48 +0,0 @@
-/*
- * 版权所有 (c) 2010-2011, 米码开源社区 (www.micode.net)
- *
- * 根据Apache License, 版本2.0（“许可证”）获得许可；
- * 除非适用法律要求或书面同意，否则禁止使用此文件。
- * 你可以在以下网址获得许可证的副本：
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * 除非适用法律要求或书面同意，否则按“原样”提供软件，
- * 无任何明示或暗示的保证和条件。
- * 请参阅许可证以获取权限和限制的具体语言规定。
- */
-
-package net.micode.notes.gtask.exception;
-
-/**
- * 动作失败异常类，继承自RuntimeException。
- * 用于表示在执行某个动作时发生的异常情况。
- */
-public class ActionFailureException extends RuntimeException {
-    // 序列化版本UID，用于序列化和反序列化对象时保持版本一致性。
-    private static final long serialVersionUID = 4425249765923293627L;
-
-    /**
-     * 无参构造函数。
-     */
-    public ActionFailureException() {
-        super();
-    }
-
-    /**
-     * 带错误消息的构造函数。
-     * @param paramString 错误消息。
-     */
-    public ActionFailureException(String paramString) {
-        super(paramString);
-    }
-
-    /**
-     * 带错误消息和原因的构造函数。
-     * @param paramString 错误消息。
-     * @param paramThrowable 异常原因。
-     */
-    public ActionFailureException(String paramString, Throwable paramThrowable) {
-        super(paramString, paramThrowable);
-    }
-}

Contact.java

@@ -1,101 +0,0 @@
-以下是`Contact.java`文件的代码，添加了中文注释：
-
-```java
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.data;
-
-import android.content.Context;
-import android.database.Cursor;
-import android.provider.ContactsContract.CommonDataKinds.Phone;
-import android.provider.ContactsContract.Data;
-import android.telephony.PhoneNumberUtils;
-import android.util.Log;
-
-import java.util.HashMap;
-
-/**
- * 联系人工具类，用于根据电话号码查询联系人名称。
- */
-public class Contact {
-    // 用于缓存联系人信息的HashMap，避免重复查询。
-    private static HashMap<String, String> sContactCache;
-    // 日志标签，用于标识日志输出的来源。
-    private static final String TAG = "Contact";
-
-    // 用于查询联系人的SQL语句模板。
-    private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
-    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
-    + " AND " + Data.RAW_CONTACT_ID + " IN "
-            + "(SELECT raw_contact_id "
-            + " FROM phone_lookup"
-            + " WHERE min_match = '+')";
-
-    /**
-     * 根据电话号码查询联系人名称。
-     * 
-     * @param context 上下文对象，用于访问系统服务。
-     * @param phoneNumber 需要查询的电话号码。
-     * @return 返回联系人名称，如果未找到则返回null。
-     */
-    public static String getContact(Context context, String phoneNumber) {
-        // 如果缓存未初始化，则初始化HashMap。
-        if(sContactCache == null) {
-            sContactCache = new HashMap<String, String>();
-        }
-
-        // 如果电话号码已在缓存中，直接返回缓存的联系人名称。
-        if(sContactCache.containsKey(phoneNumber)) {
-            return sContactCache.get(phoneNumber);
-        }
-
-        // 替换SQL语句模板中的占位符，以匹配输入的电话号码。
-        String selection = CALLER_ID_SELECTION.replace("+",
-                PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
-        // 执行查询操作，获取联系人名称。
-        Cursor cursor = context.getContentResolver().query(
-                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 {
-            // 如果未找到匹配的联系人，记录日志并返回null。
-            Log.d(TAG, "No contact matched with number:" + phoneNumber);
-            return null;
-        }
-    }
-}
-```
-
-这段代码中，我为每个重要的部分添加了中文注释，包括类描述、成员变量、常量、方法和代码块的功能说明，以帮助理解代码的意图和逻辑。

src/ActionFailureException.java

@@ -1,48 +0,0 @@
-/*
- * 版权所有 (c) 2010-2011, 米码开源社区 (www.micode.net)
- *
- * 根据Apache License, 版本2.0（“许可证”）获得许可；
- * 除非适用法律要求或书面同意，否则禁止使用此文件。
- * 你可以在以下网址获得许可证的副本：
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * 除非适用法律要求或书面同意，否则按“原样”提供软件，
- * 无任何明示或暗示的保证和条件。
- * 请参阅许可证以获取权限和限制的具体语言规定。
- */
-
-package net.micode.notes.gtask.exception;
-
-/**
- * 动作失败异常类，继承自RuntimeException。
- * 用于表示在执行某个动作时发生的异常情况。
- */
-public class ActionFailureException extends RuntimeException {
-    // 序列化版本UID，用于序列化和反序列化对象时保持版本一致性。
-    private static final long serialVersionUID = 4425249765923293627L;
-
-    /**
-     * 无参构造函数。
-     */
-    public ActionFailureException() {
-        super();
-    }
-
-    /**
-     * 带错误消息的构造函数。
-     * @param paramString 错误消息。
-     */
-    public ActionFailureException(String paramString) {
-        super(paramString);
-    }
-
-    /**
-     * 带错误消息和原因的构造函数。
-     * @param paramString 错误消息。
-     * @param paramThrowable 异常原因。
-     */
-    public ActionFailureException(String paramString, Throwable paramThrowable) {
-        super(paramString, paramThrowable);
-    }
-}

src/AlarmAlertActivity.java

@@ -1,158 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.ui;
-
-import android.app.Activity;
-import android.app.AlertDialog;
-import android.content.Context;
-import android.content.DialogInterface;
-import android.content.DialogInterface.OnClickListener;
-import android.content.DialogInterface.OnDismissListener;
-import android.content.Intent;
-import android.media.AudioManager;
-import android.media.MediaPlayer;
-import android.media.RingtoneManager;
-import android.net.Uri;
-import android.os.Bundle;
-import android.os.PowerManager;
-import android.provider.Settings;
-import android.view.Window;
-import android.view.WindowManager;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.tool.DataUtils;
-
-import java.io.IOException;
-
-
-public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
-    private long mNoteId;
-    private String mSnippet;
-    private static final int SNIPPET_PREW_MAX_LEN = 60;
-    MediaPlayer mPlayer;
-
-    @Override
-    protected void onCreate(Bundle savedInstanceState) {
-        super.onCreate(savedInstanceState);
-        requestWindowFeature(Window.FEATURE_NO_TITLE);
-
-        final Window win = getWindow();
-        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);
-
-        if (!isScreenOn()) {
-            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
-                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
-                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
-                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
-        }
-
-        Intent intent = getIntent();
-
-        try {
-            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
-            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
-            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
-                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
-                    : mSnippet;
-        } catch (IllegalArgumentException e) {
-            e.printStackTrace();
-            return;
-        }
-
-        mPlayer = new MediaPlayer();
-        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
-            showActionDialog();
-            playAlarmSound();
-        } else {
-            finish();
-        }
-    }
-
-    private boolean isScreenOn() {
-        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
-        return pm.isScreenOn();
-    }
-
-    private void playAlarmSound() {
-        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
-
-        int silentModeStreams = Settings.System.getInt(getContentResolver(),
-                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
-
-        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
-            mPlayer.setAudioStreamType(silentModeStreams);
-        } else {
-            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
-        }
-        try {
-            mPlayer.setDataSource(this, url);
-            mPlayer.prepare();
-            mPlayer.setLooping(true);
-            mPlayer.start();
-        } catch (IllegalArgumentException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (SecurityException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (IllegalStateException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        } catch (IOException e) {
-            // TODO Auto-generated catch block
-            e.printStackTrace();
-        }
-    }
-
-    private void showActionDialog() {
-        AlertDialog.Builder dialog = new AlertDialog.Builder(this);
-        dialog.setTitle(R.string.app_name);
-        dialog.setMessage(mSnippet);
-        dialog.setPositiveButton(R.string.notealert_ok, this);
-        if (isScreenOn()) {
-            dialog.setNegativeButton(R.string.notealert_enter, this);
-        }
-        dialog.show().setOnDismissListener(this);
-    }
-
-    public void onClick(DialogInterface dialog, int which) {
-        switch (which) {
-            case DialogInterface.BUTTON_NEGATIVE:
-                Intent intent = new Intent(this, NoteEditActivity.class);
-                intent.setAction(Intent.ACTION_VIEW);
-                intent.putExtra(Intent.EXTRA_UID, mNoteId);
-                startActivity(intent);
-                break;
-            default:
-                break;
-        }
-    }
-
-    public void onDismiss(DialogInterface dialog) {
-        stopAlarmSound();
-        finish();
-    }
-
-    private void stopAlarmSound() {
-        if (mPlayer != null) {
-            mPlayer.stop();
-            mPlayer.release();
-            mPlayer = null;
-        }
-    }
-}

src/AlarmInitReceiver.java

@@ -1,65 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.ui;
-
-import android.app.AlarmManager;
-import android.app.PendingIntent;
-import android.content.BroadcastReceiver;
-import android.content.ContentUris;
-import android.content.Context;
-import android.content.Intent;
-import android.database.Cursor;
-
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.NoteColumns;
-
-
-public class AlarmInitReceiver extends BroadcastReceiver {
-
-    private static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
-        NoteColumns.ALERTED_DATE
-    };
-
-    private static final int COLUMN_ID                = 0;
-    private static final int COLUMN_ALERTED_DATE      = 1;
-
-    @Override
-    public void onReceive(Context context, Intent intent) {
-        long currentDate = System.currentTimeMillis();
-        Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
-                PROJECTION,
-                NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
-                new String[] { String.valueOf(currentDate) },
-                null);
-
-        if (c != null) {
-            if (c.moveToFirst()) {
-                do {
-                    long alertDate = c.getLong(COLUMN_ALERTED_DATE);
-                    Intent sender = new Intent(context, AlarmReceiver.class);
-                    sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
-                    PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
-                    AlarmManager alermManager = (AlarmManager) context
-                            .getSystemService(Context.ALARM_SERVICE);
-                    alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
-                } while (c.moveToNext());
-            }
-            c.close();
-        }
-    }
-}

src/BackupUtils.java

@@ -1,344 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.tool;
-
-import android.content.Context;
-import android.database.Cursor;
-import android.os.Environment;
-import android.text.TextUtils;
-import android.text.format.DateFormat;
-import android.util.Log;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.DataColumns;
-import net.micode.notes.data.Notes.DataConstants;
-import net.micode.notes.data.Notes.NoteColumns;
-
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.io.PrintStream;
-
-
-public class BackupUtils {
-    private static final String TAG = "BackupUtils";
-    // Singleton stuff
-    private static BackupUtils sInstance;
-
-    public static synchronized BackupUtils getInstance(Context context) {
-        if (sInstance == null) {
-            sInstance = new BackupUtils(context);
-        }
-        return sInstance;
-    }
-
-    /**
-     * Following states are signs to represents backup or restore
-     * status
-     */
-    // 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;
-
-    private BackupUtils(Context context) {
-        mTextExport = new TextExport(context);
-    }
-
-    private static boolean externalStorageAvailable() {
-        return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
-    }
-
-    public int exportToText() {
-        return mTextExport.exportToText();
-    }
-
-    public String getExportedTextFileName() {
-        return mTextExport.mFileName;
-    }
-
-    public String getExportedTextFileDir() {
-        return mTextExport.mFileDirectory;
-    }
-
-    private static class TextExport {
-        private static final String[] NOTE_PROJECTION = {
-                NoteColumns.ID,
-                NoteColumns.MODIFIED_DATE,
-                NoteColumns.SNIPPET,
-                NoteColumns.TYPE
-        };
-
-        private static final int NOTE_COLUMN_ID = 0;
-
-        private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
-
-        private static final int NOTE_COLUMN_SNIPPET = 2;
-
-        private static final String[] DATA_PROJECTION = {
-                DataColumns.CONTENT,
-                DataColumns.MIME_TYPE,
-                DataColumns.DATA1,
-                DataColumns.DATA2,
-                DataColumns.DATA3,
-                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;
-        private static final int FORMAT_NOTE_CONTENT         = 2;
-
-        private Context mContext;
-        private String mFileName;
-        private String mFileDirectory;
-
-        public TextExport(Context context) {
-            TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
-            mContext = context;
-            mFileName = "";
-            mFileDirectory = "";
-        }
-
-        private String getFormat(int id) {
-            return TEXT_FORMAT[id];
-        }
-
-        /**
-         * 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
-                    }, null);
-
-            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());
-                }
-                notesCursor.close();
-            }
-        }
-
-        /**
-         * 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
-                    }, null);
-
-            if (dataCursor != null) {
-                if (dataCursor.moveToFirst()) {
-                    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);
-
-                            if (!TextUtils.isEmpty(phoneNumber)) {
-                                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),
-                                        content));
-                            }
-                        }
-                    } while (dataCursor.moveToNext());
-                }
-                dataCursor.close();
-            }
-            // print a line separator between note
-            try {
-                ps.write(new byte[] {
-                        Character.LINE_SEPARATOR, Character.LETTER_NUMBER
-                });
-            } catch (IOException e) {
-                Log.e(TAG, e.toString());
-            }
-        }
-
-        /**
-         * Note will be exported as text which is user readable
-         */
-        public int exportToText() {
-            if (!externalStorageAvailable()) {
-                Log.d(TAG, "Media was not mounted");
-                return STATE_SD_CARD_UNMOUONTED;
-            }
-
-            PrintStream ps = getExportToTextPrintStream();
-            if (ps == null) {
-                Log.e(TAG, "get print stream error");
-                return STATE_SYSTEM_ERROR;
-            }
-            // First export folder and its notes
-            Cursor folderCursor = mContext.getContentResolver().query(
-                    Notes.CONTENT_NOTE_URI,
-                    NOTE_PROJECTION,
-                    "(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
-                            + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
-                            + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);
-
-            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);
-                        } else {
-                            folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET);
-                        }
-                        if (!TextUtils.isEmpty(folderName)) {
-                            ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
-                        }
-                        String folderId = folderCursor.getString(NOTE_COLUMN_ID);
-                        exportFolderToText(folderId, ps);
-                    } while (folderCursor.moveToNext());
-                }
-                folderCursor.close();
-            }
-
-            // Export notes in root's folder
-            Cursor noteCursor = mContext.getContentResolver().query(
-                    Notes.CONTENT_NOTE_URI,
-                    NOTE_PROJECTION,
-                    NoteColumns.TYPE + "=" + +Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID
-                            + "=0", null, null);
-
-            if (noteCursor != null) {
-                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());
-                }
-                noteCursor.close();
-            }
-            ps.close();
-
-            return STATE_SUCCESS;
-        }
-
-        /**
-         * Get a print stream pointed to the file {@generateExportedTextFile}
-         */
-        private PrintStream getExportToTextPrintStream() {
-            File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
-                    R.string.file_name_txt_format);
-            if (file == null) {
-                Log.e(TAG, "create file to exported failed");
-                return null;
-            }
-            mFileName = file.getName();
-            mFileDirectory = mContext.getString(R.string.file_path);
-            PrintStream ps = null;
-            try {
-                FileOutputStream fos = new FileOutputStream(file);
-                ps = new PrintStream(fos);
-            } catch (FileNotFoundException e) {
-                e.printStackTrace();
-                return null;
-            } catch (NullPointerException e) {
-                e.printStackTrace();
-                return null;
-            }
-            return ps;
-        }
-    }
-
-    /**
-     * Generate the text file to store imported data
-     */
-    private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
-        StringBuilder sb = new StringBuilder();
-        sb.append(Environment.getExternalStorageDirectory());
-        sb.append(context.getString(filePathResId));
-        File filedir = new File(sb.toString());
-        sb.append(context.getString(
-                fileNameFormatResId,
-                DateFormat.format(context.getString(R.string.format_date_ymd),
-                        System.currentTimeMillis())));
-        File file = new File(sb.toString());
-
-        try {
-            if (!filedir.exists()) {
-                filedir.mkdir();
-            }
-            if (!file.exists()) {
-                file.createNewFile();
-            }
-            return file;
-        } catch (SecurityException e) {
-            e.printStackTrace();
-        } catch (IOException e) {
-            e.printStackTrace();
-        }
-
-        return null;
-    }
-}
-
-

src/DataUtils.java

@@ -1,295 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.tool;
-
-import android.content.ContentProviderOperation;
-import android.content.ContentProviderResult;
-import android.content.ContentResolver;
-import android.content.ContentUris;
-import android.content.ContentValues;
-import android.content.OperationApplicationException;
-import android.database.Cursor;
-import android.os.RemoteException;
-import android.util.Log;
-
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.CallNote;
-import net.micode.notes.data.Notes.NoteColumns;
-import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
-
-import java.util.ArrayList;
-import java.util.HashSet;
-
-
-public class DataUtils {
-    public static final String TAG = "DataUtils";
-    public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
-        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> operationList = new ArrayList<ContentProviderOperation>();
-        for (long id : ids) {
-            if(id == Notes.ID_ROOT_FOLDER) {
-                Log.e(TAG, "Don't delete system folder root");
-                continue;
-            }
-            ContentProviderOperation.Builder builder = ContentProviderOperation
-                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
-            operationList.add(builder.build());
-        }
-        try {
-            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
-            if (results == null || results.length == 0 || results[0] == null) {
-                Log.d(TAG, "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;
-    }
-
-    public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
-        ContentValues values = new ContentValues();
-        values.put(NoteColumns.PARENT_ID, desFolderId);
-        values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
-        values.put(NoteColumns.LOCAL_MODIFIED, 1);
-        resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
-    }
-
-    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
-            long folderId) {
-        if (ids == null) {
-            Log.d(TAG, "the ids is null");
-            return true;
-        }
-
-        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
-        for (long id : ids) {
-            ContentProviderOperation.Builder builder = ContentProviderOperation
-                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
-            builder.withValue(NoteColumns.PARENT_ID, folderId);
-            builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);
-            operationList.add(builder.build());
-        }
-
-        try {
-            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
-            if (results == null || results.length == 0 || results[0] == null) {
-                Log.d(TAG, "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;
-    }
-
-    /**
-     * 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,
-                new String[] { "COUNT(*)" },
-                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
-                new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
-                null);
-
-        int count = 0;
-        if(cursor != null) {
-            if(cursor.moveToFirst()) {
-                try {
-                    count = cursor.getInt(0);
-                } catch (IndexOutOfBoundsException e) {
-                    Log.e(TAG, "get folder count failed:" + e.toString());
-                } finally {
-                    cursor.close();
-                }
-            }
-        }
-        return count;
-    }
-
-    public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
-        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
-                null,
-                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
-                new String [] {String.valueOf(type)},
-                null);
-
-        boolean exist = false;
-        if (cursor != null) {
-            if (cursor.getCount() > 0) {
-                exist = true;
-            }
-            cursor.close();
-        }
-        return exist;
-    }
-
-    public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
-                null, null, null, null);
-
-        boolean exist = false;
-        if (cursor != null) {
-            if (cursor.getCount() > 0) {
-                exist = true;
-            }
-            cursor.close();
-        }
-        return exist;
-    }
-
-    public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
-        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
-                null, null, null, null);
-
-        boolean exist = false;
-        if (cursor != null) {
-            if (cursor.getCount() > 0) {
-                exist = true;
-            }
-            cursor.close();
-        }
-        return exist;
-    }
-
-    public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
-        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
-                NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
-                " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
-                " AND " + NoteColumns.SNIPPET + "=?",
-                new String[] { name }, null);
-        boolean exist = false;
-        if(cursor != null) {
-            if(cursor.getCount() > 0) {
-                exist = true;
-            }
-            cursor.close();
-        }
-        return exist;
-    }
-
-    public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
-        Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
-                new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE },
-                NoteColumns.PARENT_ID + "=?",
-                new String[] { String.valueOf(folderId) },
-                null);
-
-        HashSet<AppWidgetAttribute> set = null;
-        if (c != null) {
-            if (c.moveToFirst()) {
-                set = new HashSet<AppWidgetAttribute>();
-                do {
-                    try {
-                        AppWidgetAttribute widget = new AppWidgetAttribute();
-                        widget.widgetId = c.getInt(0);
-                        widget.widgetType = c.getInt(1);
-                        set.add(widget);
-                    } catch (IndexOutOfBoundsException e) {
-                        Log.e(TAG, e.toString());
-                    }
-                } while (c.moveToNext());
-            }
-            c.close();
-        }
-        return set;
-    }
-
-    public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
-                new String [] { CallNote.PHONE_NUMBER },
-                CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
-                new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
-                null);
-
-        if (cursor != null && cursor.moveToFirst()) {
-            try {
-                return cursor.getString(0);
-            } catch (IndexOutOfBoundsException e) {
-                Log.e(TAG, "Get call number fails " + e.toString());
-            } finally {
-                cursor.close();
-            }
-        }
-        return "";
-    }
-
-    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 },
-                null);
-
-        if (cursor != null) {
-            if (cursor.moveToFirst()) {
-                try {
-                    return cursor.getLong(0);
-                } catch (IndexOutOfBoundsException e) {
-                    Log.e(TAG, "Get call note id fails " + e.toString());
-                }
-            }
-            cursor.close();
-        }
-        return 0;
-    }
-
-    public static String getSnippetById(ContentResolver resolver, long noteId) {
-        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
-                new String [] { NoteColumns.SNIPPET },
-                NoteColumns.ID + "=?",
-                new String [] { String.valueOf(noteId)},
-                null);
-
-        if (cursor != null) {
-            String snippet = "";
-            if (cursor.moveToFirst()) {
-                snippet = cursor.getString(0);
-            }
-            cursor.close();
-            return snippet;
-        }
-        throw new IllegalArgumentException("Note is not found with id: " + noteId);
-    }
-
-    public static String getFormattedSnippet(String snippet) {
-        if (snippet != null) {
-            snippet = snippet.trim();
-            int index = snippet.indexOf('\n');
-            if (index != -1) {
-                snippet = snippet.substring(0, index);
-            }
-        }
-        return snippet;
-    }
-}

src/DropdownMenu.java

@@ -1,61 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.ui;
-
-import android.content.Context;
-import android.view.Menu;
-import android.view.MenuItem;
-import android.view.View;
-import android.view.View.OnClickListener;
-import android.widget.Button;
-import android.widget.PopupMenu;
-import android.widget.PopupMenu.OnMenuItemClickListener;
-
-import net.micode.notes.R;
-
-public class DropdownMenu {
-    private Button mButton;
-    private PopupMenu mPopupMenu;
-    private Menu mMenu;
-
-    public DropdownMenu(Context context, Button button, int menuId) {
-        mButton = button;
-        mButton.setBackgroundResource(R.drawable.dropdown_icon);
-        mPopupMenu = new PopupMenu(context, mButton);
-        mMenu = mPopupMenu.getMenu();
-        mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
-        mButton.setOnClickListener(new OnClickListener() {
-            public void onClick(View v) {
-                mPopupMenu.show();
-            }
-        });
-    }
-
-    public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
-        if (mPopupMenu != null) {
-            mPopupMenu.setOnMenuItemClickListener(listener);
-        }
-    }
-
-    public MenuItem findItem(int id) {
-        return mMenu.findItem(id);
-    }
-
-    public void setTitle(CharSequence title) {
-        mButton.setText(title);
-    }
-}

src/GTaskASyncTask.java

@@ -1,123 +0,0 @@
-
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.gtask.remote;
-
-import android.app.Notification;
-import android.app.NotificationManager;
-import android.app.PendingIntent;
-import android.content.Context;
-import android.content.Intent;
-import android.os.AsyncTask;
-
-import net.micode.notes.R;
-import net.micode.notes.ui.NotesListActivity;
-import net.micode.notes.ui.NotesPreferenceActivity;
-
-
-public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
-
-    private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
-
-    public interface OnCompleteListener {
-        void onComplete();
-    }
-
-    private Context mContext;
-
-    private NotificationManager mNotifiManager;
-
-    private GTaskManager mTaskManager;
-
-    private OnCompleteListener mOnCompleteListener;
-
-    public GTaskASyncTask(Context context, OnCompleteListener listener) {
-        mContext = context;
-        mOnCompleteListener = listener;
-        mNotifiManager = (NotificationManager) mContext
-                .getSystemService(Context.NOTIFICATION_SERVICE);
-        mTaskManager = GTaskManager.getInstance();
-    }
-
-    public void cancelSync() {
-        mTaskManager.cancelSync();
-    }
-
-    public void publishProgess(String message) {
-        publishProgress(new String[] {
-            message
-        });
-    }
-
-    private void showNotification(int tickerId, String content) {
-        Notification notification = new Notification(R.drawable.notification, mContext
-                .getString(tickerId), System.currentTimeMillis());
-        notification.defaults = Notification.DEFAULT_LIGHTS;
-        notification.flags = Notification.FLAG_AUTO_CANCEL;
-        PendingIntent pendingIntent;
-        if (tickerId != R.string.ticker_success) {
-            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
-                    NotesPreferenceActivity.class), 0);
-
-        } else {
-            pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext,
-                    NotesListActivity.class), 0);
-        }
-        notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content,
-                pendingIntent);
-        mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
-    }
-
-    @Override
-    protected Integer doInBackground(Void... unused) {
-        publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity
-                .getSyncAccountName(mContext)));
-        return mTaskManager.sync(mContext, this);
-    }
-
-    @Override
-    protected void onProgressUpdate(String... progress) {
-        showNotification(R.string.ticker_syncing, progress[0]);
-        if (mContext instanceof GTaskSyncService) {
-            ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
-        }
-    }
-
-    @Override
-    protected void onPostExecute(Integer result) {
-        if (result == GTaskManager.STATE_SUCCESS) {
-            showNotification(R.string.ticker_success, mContext.getString(
-                    R.string.success_sync_account, mTaskManager.getSyncAccount()));
-            NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
-        } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
-            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_network));
-        } else if (result == GTaskManager.STATE_INTERNAL_ERROR) {
-            showNotification(R.string.ticker_fail, mContext.getString(R.string.error_sync_internal));
-        } else if (result == GTaskManager.STATE_SYNC_CANCELLED) {
-            showNotification(R.string.ticker_cancel, mContext
-                    .getString(R.string.error_sync_cancelled));
-        }
-        if (mOnCompleteListener != null) {
-            new Thread(new Runnable() {
-
-                public void run() {
-                    mOnCompleteListener.onComplete();
-                }
-            }).start();
-        }
-    }
-}

src/GTaskManager.java

@@ -1,800 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.gtask.remote;
-
-import android.app.Activity;
-import android.content.ContentResolver;
-import android.content.ContentUris;
-import android.content.ContentValues;
-import android.content.Context;
-import android.database.Cursor;
-import android.util.Log;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.DataColumns;
-import net.micode.notes.data.Notes.NoteColumns;
-import net.micode.notes.gtask.data.MetaData;
-import net.micode.notes.gtask.data.Node;
-import net.micode.notes.gtask.data.SqlNote;
-import net.micode.notes.gtask.data.Task;
-import net.micode.notes.gtask.data.TaskList;
-import net.micode.notes.gtask.exception.ActionFailureException;
-import net.micode.notes.gtask.exception.NetworkFailureException;
-import net.micode.notes.tool.DataUtils;
-import net.micode.notes.tool.GTaskStringUtils;
-
-import org.json.JSONArray;
-import org.json.JSONException;
-import org.json.JSONObject;
-
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Iterator;
-import java.util.Map;
-
-
-public class GTaskManager {
-    private static final String TAG = GTaskManager.class.getSimpleName();
-
-    public static final int STATE_SUCCESS = 0;
-
-    public static final int STATE_NETWORK_ERROR = 1;
-
-    public static final int STATE_INTERNAL_ERROR = 2;
-
-    public static final int STATE_SYNC_IN_PROGRESS = 3;
-
-    public static final int STATE_SYNC_CANCELLED = 4;
-
-    private static GTaskManager mInstance = null;
-
-    private Activity mActivity;
-
-    private Context mContext;
-
-    private ContentResolver mContentResolver;
-
-    private boolean mSyncing;
-
-    private boolean mCancelled;
-
-    private HashMap<String, TaskList> mGTaskListHashMap;
-
-    private HashMap<String, Node> mGTaskHashMap;
-
-    private HashMap<String, MetaData> mMetaHashMap;
-
-    private TaskList mMetaList;
-
-    private HashSet<Long> mLocalDeleteIdMap;
-
-    private HashMap<String, Long> mGidToNid;
-
-    private HashMap<Long, String> mNidToGid;
-
-    private GTaskManager() {
-        mSyncing = false;
-        mCancelled = false;
-        mGTaskListHashMap = new HashMap<String, TaskList>();
-        mGTaskHashMap = new HashMap<String, Node>();
-        mMetaHashMap = new HashMap<String, MetaData>();
-        mMetaList = null;
-        mLocalDeleteIdMap = new HashSet<Long>();
-        mGidToNid = new HashMap<String, Long>();
-        mNidToGid = new HashMap<Long, String>();
-    }
-
-    public static synchronized GTaskManager getInstance() {
-        if (mInstance == null) {
-            mInstance = new GTaskManager();
-        }
-        return mInstance;
-    }
-
-    public synchronized void setActivityContext(Activity activity) {
-        // used for getting authtoken
-        mActivity = activity;
-    }
-
-    public int sync(Context context, GTaskASyncTask asyncTask) {
-        if (mSyncing) {
-            Log.d(TAG, "Sync is in progress");
-            return STATE_SYNC_IN_PROGRESS;
-        }
-        mContext = context;
-        mContentResolver = mContext.getContentResolver();
-        mSyncing = true;
-        mCancelled = false;
-        mGTaskListHashMap.clear();
-        mGTaskHashMap.clear();
-        mMetaHashMap.clear();
-        mLocalDeleteIdMap.clear();
-        mGidToNid.clear();
-        mNidToGid.clear();
-
-        try {
-            GTaskClient client = GTaskClient.getInstance();
-            client.resetUpdateArray();
-
-            // login google task
-            if (!mCancelled) {
-                if (!client.login(mActivity)) {
-                    throw new NetworkFailureException("login google task failed");
-                }
-            }
-
-            // get the task list from google
-            asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
-            initGTaskList();
-
-            // do content sync work
-            asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
-            syncContent();
-        } catch (NetworkFailureException e) {
-            Log.e(TAG, e.toString());
-            return STATE_NETWORK_ERROR;
-        } catch (ActionFailureException e) {
-            Log.e(TAG, e.toString());
-            return STATE_INTERNAL_ERROR;
-        } catch (Exception e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-            return STATE_INTERNAL_ERROR;
-        } finally {
-            mGTaskListHashMap.clear();
-            mGTaskHashMap.clear();
-            mMetaHashMap.clear();
-            mLocalDeleteIdMap.clear();
-            mGidToNid.clear();
-            mNidToGid.clear();
-            mSyncing = false;
-        }
-
-        return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
-    }
-
-    private void initGTaskList() throws NetworkFailureException {
-        if (mCancelled)
-            return;
-        GTaskClient client = GTaskClient.getInstance();
-        try {
-            JSONArray jsTaskLists = client.getTaskLists();
-
-            // init meta list first
-            mMetaList = null;
-            for (int i = 0; i < jsTaskLists.length(); i++) {
-                JSONObject object = jsTaskLists.getJSONObject(i);
-                String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
-                String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
-
-                if (name
-                        .equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) {
-                    mMetaList = new TaskList();
-                    mMetaList.setContentByRemoteJSON(object);
-
-                    // load meta data
-                    JSONArray jsMetas = client.getTaskList(gid);
-                    for (int j = 0; j < jsMetas.length(); j++) {
-                        object = (JSONObject) jsMetas.getJSONObject(j);
-                        MetaData metaData = new MetaData();
-                        metaData.setContentByRemoteJSON(object);
-                        if (metaData.isWorthSaving()) {
-                            mMetaList.addChildTask(metaData);
-                            if (metaData.getGid() != null) {
-                                mMetaHashMap.put(metaData.getRelatedGid(), metaData);
-                            }
-                        }
-                    }
-                }
-            }
-
-            // create meta list if not existed
-            if (mMetaList == null) {
-                mMetaList = new TaskList();
-                mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX
-                        + GTaskStringUtils.FOLDER_META);
-                GTaskClient.getInstance().createTaskList(mMetaList);
-            }
-
-            // init task list
-            for (int i = 0; i < jsTaskLists.length(); i++) {
-                JSONObject object = jsTaskLists.getJSONObject(i);
-                String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
-                String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
-
-                if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)
-                        && !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX
-                                + GTaskStringUtils.FOLDER_META)) {
-                    TaskList tasklist = new TaskList();
-                    tasklist.setContentByRemoteJSON(object);
-                    mGTaskListHashMap.put(gid, tasklist);
-                    mGTaskHashMap.put(gid, tasklist);
-
-                    // load tasks
-                    JSONArray jsTasks = client.getTaskList(gid);
-                    for (int j = 0; j < jsTasks.length(); j++) {
-                        object = (JSONObject) jsTasks.getJSONObject(j);
-                        gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
-                        Task task = new Task();
-                        task.setContentByRemoteJSON(object);
-                        if (task.isWorthSaving()) {
-                            task.setMetaInfo(mMetaHashMap.get(gid));
-                            tasklist.addChildTask(task);
-                            mGTaskHashMap.put(gid, task);
-                        }
-                    }
-                }
-            }
-        } catch (JSONException e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-            throw new ActionFailureException("initGTaskList: handing JSONObject failed");
-        }
-    }
-
-    private void syncContent() throws NetworkFailureException {
-        int syncType;
-        Cursor c = null;
-        String gid;
-        Node node;
-
-        mLocalDeleteIdMap.clear();
-
-        if (mCancelled) {
-            return;
-        }
-
-        // for local deleted note
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
-                    "(type<>? AND parent_id=?)", new String[] {
-                            String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER)
-                    }, null);
-            if (c != null) {
-                while (c.moveToNext()) {
-                    gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                    node = mGTaskHashMap.get(gid);
-                    if (node != null) {
-                        mGTaskHashMap.remove(gid);
-                        doContentSync(Node.SYNC_ACTION_DEL_REMOTE, node, c);
-                    }
-
-                    mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN));
-                }
-            } else {
-                Log.w(TAG, "failed to query trash folder");
-            }
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-
-        // sync folder first
-        syncFolder();
-
-        // for note existing in database
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
-                    "(type=? AND parent_id<>?)", new String[] {
-                            String.valueOf(Notes.TYPE_NOTE), String.valueOf(Notes.ID_TRASH_FOLER)
-                    }, NoteColumns.TYPE + " DESC");
-            if (c != null) {
-                while (c.moveToNext()) {
-                    gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                    node = mGTaskHashMap.get(gid);
-                    if (node != null) {
-                        mGTaskHashMap.remove(gid);
-                        mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
-                        mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
-                        syncType = node.getSyncAction(c);
-                    } else {
-                        if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
-                            // local add
-                            syncType = Node.SYNC_ACTION_ADD_REMOTE;
-                        } else {
-                            // remote delete
-                            syncType = Node.SYNC_ACTION_DEL_LOCAL;
-                        }
-                    }
-                    doContentSync(syncType, node, c);
-                }
-            } else {
-                Log.w(TAG, "failed to query existing note in database");
-            }
-
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-
-        // go through remaining items
-        Iterator<Map.Entry<String, Node>> iter = mGTaskHashMap.entrySet().iterator();
-        while (iter.hasNext()) {
-            Map.Entry<String, Node> entry = iter.next();
-            node = entry.getValue();
-            doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
-        }
-
-        // mCancelled can be set by another thread, so we neet to check one by
-        // one
-        // clear local delete table
-        if (!mCancelled) {
-            if (!DataUtils.batchDeleteNotes(mContentResolver, mLocalDeleteIdMap)) {
-                throw new ActionFailureException("failed to batch-delete local deleted notes");
-            }
-        }
-
-        // refresh local sync id
-        if (!mCancelled) {
-            GTaskClient.getInstance().commitUpdate();
-            refreshLocalSyncId();
-        }
-
-    }
-
-    private void syncFolder() throws NetworkFailureException {
-        Cursor c = null;
-        String gid;
-        Node node;
-        int syncType;
-
-        if (mCancelled) {
-            return;
-        }
-
-        // for root folder
-        try {
-            c = mContentResolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
-                    Notes.ID_ROOT_FOLDER), SqlNote.PROJECTION_NOTE, null, null, null);
-            if (c != null) {
-                c.moveToNext();
-                gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                node = mGTaskHashMap.get(gid);
-                if (node != null) {
-                    mGTaskHashMap.remove(gid);
-                    mGidToNid.put(gid, (long) Notes.ID_ROOT_FOLDER);
-                    mNidToGid.put((long) Notes.ID_ROOT_FOLDER, gid);
-                    // for system folder, only update remote name if necessary
-                    if (!node.getName().equals(
-                            GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT))
-                        doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
-                } else {
-                    doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c);
-                }
-            } else {
-                Log.w(TAG, "failed to query root folder");
-            }
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-
-        // for call-note folder
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE, "(_id=?)",
-                    new String[] {
-                        String.valueOf(Notes.ID_CALL_RECORD_FOLDER)
-                    }, null);
-            if (c != null) {
-                if (c.moveToNext()) {
-                    gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                    node = mGTaskHashMap.get(gid);
-                    if (node != null) {
-                        mGTaskHashMap.remove(gid);
-                        mGidToNid.put(gid, (long) Notes.ID_CALL_RECORD_FOLDER);
-                        mNidToGid.put((long) Notes.ID_CALL_RECORD_FOLDER, gid);
-                        // for system folder, only update remote name if
-                        // necessary
-                        if (!node.getName().equals(
-                                GTaskStringUtils.MIUI_FOLDER_PREFFIX
-                                        + GTaskStringUtils.FOLDER_CALL_NOTE))
-                            doContentSync(Node.SYNC_ACTION_UPDATE_REMOTE, node, c);
-                    } else {
-                        doContentSync(Node.SYNC_ACTION_ADD_REMOTE, node, c);
-                    }
-                }
-            } else {
-                Log.w(TAG, "failed to query call note folder");
-            }
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-
-        // for local existing folders
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
-                    "(type=? AND parent_id<>?)", new String[] {
-                            String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)
-                    }, NoteColumns.TYPE + " DESC");
-            if (c != null) {
-                while (c.moveToNext()) {
-                    gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                    node = mGTaskHashMap.get(gid);
-                    if (node != null) {
-                        mGTaskHashMap.remove(gid);
-                        mGidToNid.put(gid, c.getLong(SqlNote.ID_COLUMN));
-                        mNidToGid.put(c.getLong(SqlNote.ID_COLUMN), gid);
-                        syncType = node.getSyncAction(c);
-                    } else {
-                        if (c.getString(SqlNote.GTASK_ID_COLUMN).trim().length() == 0) {
-                            // local add
-                            syncType = Node.SYNC_ACTION_ADD_REMOTE;
-                        } else {
-                            // remote delete
-                            syncType = Node.SYNC_ACTION_DEL_LOCAL;
-                        }
-                    }
-                    doContentSync(syncType, node, c);
-                }
-            } else {
-                Log.w(TAG, "failed to query existing folder");
-            }
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-
-        // for remote add folders
-        Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
-        while (iter.hasNext()) {
-            Map.Entry<String, TaskList> entry = iter.next();
-            gid = entry.getKey();
-            node = entry.getValue();
-            if (mGTaskHashMap.containsKey(gid)) {
-                mGTaskHashMap.remove(gid);
-                doContentSync(Node.SYNC_ACTION_ADD_LOCAL, node, null);
-            }
-        }
-
-        if (!mCancelled)
-            GTaskClient.getInstance().commitUpdate();
-    }
-
-    private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        MetaData meta;
-        switch (syncType) {
-            case Node.SYNC_ACTION_ADD_LOCAL:
-                addLocalNode(node);
-                break;
-            case Node.SYNC_ACTION_ADD_REMOTE:
-                addRemoteNode(node, c);
-                break;
-            case Node.SYNC_ACTION_DEL_LOCAL:
-                meta = mMetaHashMap.get(c.getString(SqlNote.GTASK_ID_COLUMN));
-                if (meta != null) {
-                    GTaskClient.getInstance().deleteNode(meta);
-                }
-                mLocalDeleteIdMap.add(c.getLong(SqlNote.ID_COLUMN));
-                break;
-            case Node.SYNC_ACTION_DEL_REMOTE:
-                meta = mMetaHashMap.get(node.getGid());
-                if (meta != null) {
-                    GTaskClient.getInstance().deleteNode(meta);
-                }
-                GTaskClient.getInstance().deleteNode(node);
-                break;
-            case Node.SYNC_ACTION_UPDATE_LOCAL:
-                updateLocalNode(node, c);
-                break;
-            case Node.SYNC_ACTION_UPDATE_REMOTE:
-                updateRemoteNode(node, c);
-                break;
-            case Node.SYNC_ACTION_UPDATE_CONFLICT:
-                // merging both modifications maybe a good idea
-                // right now just use local update simply
-                updateRemoteNode(node, c);
-                break;
-            case Node.SYNC_ACTION_NONE:
-                break;
-            case Node.SYNC_ACTION_ERROR:
-            default:
-                throw new ActionFailureException("unkown sync action type");
-        }
-    }
-
-    private void addLocalNode(Node node) throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        SqlNote sqlNote;
-        if (node instanceof TaskList) {
-            if (node.getName().equals(
-                    GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) {
-                sqlNote = new SqlNote(mContext, Notes.ID_ROOT_FOLDER);
-            } else if (node.getName().equals(
-                    GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) {
-                sqlNote = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER);
-            } else {
-                sqlNote = new SqlNote(mContext);
-                sqlNote.setContent(node.getLocalJSONFromContent());
-                sqlNote.setParentId(Notes.ID_ROOT_FOLDER);
-            }
-        } else {
-            sqlNote = new SqlNote(mContext);
-            JSONObject js = node.getLocalJSONFromContent();
-            try {
-                if (js.has(GTaskStringUtils.META_HEAD_NOTE)) {
-                    JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
-                    if (note.has(NoteColumns.ID)) {
-                        long id = note.getLong(NoteColumns.ID);
-                        if (DataUtils.existInNoteDatabase(mContentResolver, id)) {
-                            // the id is not available, have to create a new one
-                            note.remove(NoteColumns.ID);
-                        }
-                    }
-                }
-
-                if (js.has(GTaskStringUtils.META_HEAD_DATA)) {
-                    JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
-                    for (int i = 0; i < dataArray.length(); i++) {
-                        JSONObject data = dataArray.getJSONObject(i);
-                        if (data.has(DataColumns.ID)) {
-                            long dataId = data.getLong(DataColumns.ID);
-                            if (DataUtils.existInDataDatabase(mContentResolver, dataId)) {
-                                // the data id is not available, have to create
-                                // a new one
-                                data.remove(DataColumns.ID);
-                            }
-                        }
-                    }
-
-                }
-            } catch (JSONException e) {
-                Log.w(TAG, e.toString());
-                e.printStackTrace();
-            }
-            sqlNote.setContent(js);
-
-            Long parentId = mGidToNid.get(((Task) node).getParent().getGid());
-            if (parentId == null) {
-                Log.e(TAG, "cannot find task's parent id locally");
-                throw new ActionFailureException("cannot add local node");
-            }
-            sqlNote.setParentId(parentId.longValue());
-        }
-
-        // create the local node
-        sqlNote.setGtaskId(node.getGid());
-        sqlNote.commit(false);
-
-        // update gid-nid mapping
-        mGidToNid.put(node.getGid(), sqlNote.getId());
-        mNidToGid.put(sqlNote.getId(), node.getGid());
-
-        // update meta
-        updateRemoteMeta(node.getGid(), sqlNote);
-    }
-
-    private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        SqlNote sqlNote;
-        // update the note locally
-        sqlNote = new SqlNote(mContext, c);
-        sqlNote.setContent(node.getLocalJSONFromContent());
-
-        Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
-                : new Long(Notes.ID_ROOT_FOLDER);
-        if (parentId == null) {
-            Log.e(TAG, "cannot find task's parent id locally");
-            throw new ActionFailureException("cannot update local node");
-        }
-        sqlNote.setParentId(parentId.longValue());
-        sqlNote.commit(true);
-
-        // update meta info
-        updateRemoteMeta(node.getGid(), sqlNote);
-    }
-
-    private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        SqlNote sqlNote = new SqlNote(mContext, c);
-        Node n;
-
-        // update remotely
-        if (sqlNote.isNoteType()) {
-            Task task = new Task();
-            task.setContentByLocalJSON(sqlNote.getContent());
-
-            String parentGid = mNidToGid.get(sqlNote.getParentId());
-            if (parentGid == null) {
-                Log.e(TAG, "cannot find task's parent tasklist");
-                throw new ActionFailureException("cannot add remote task");
-            }
-            mGTaskListHashMap.get(parentGid).addChildTask(task);
-
-            GTaskClient.getInstance().createTask(task);
-            n = (Node) task;
-
-            // add meta
-            updateRemoteMeta(task.getGid(), sqlNote);
-        } else {
-            TaskList tasklist = null;
-
-            // we need to skip folder if it has already existed
-            String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX;
-            if (sqlNote.getId() == Notes.ID_ROOT_FOLDER)
-                folderName += GTaskStringUtils.FOLDER_DEFAULT;
-            else if (sqlNote.getId() == Notes.ID_CALL_RECORD_FOLDER)
-                folderName += GTaskStringUtils.FOLDER_CALL_NOTE;
-            else
-                folderName += sqlNote.getSnippet();
-
-            Iterator<Map.Entry<String, TaskList>> iter = mGTaskListHashMap.entrySet().iterator();
-            while (iter.hasNext()) {
-                Map.Entry<String, TaskList> entry = iter.next();
-                String gid = entry.getKey();
-                TaskList list = entry.getValue();
-
-                if (list.getName().equals(folderName)) {
-                    tasklist = list;
-                    if (mGTaskHashMap.containsKey(gid)) {
-                        mGTaskHashMap.remove(gid);
-                    }
-                    break;
-                }
-            }
-
-            // no match we can add now
-            if (tasklist == null) {
-                tasklist = new TaskList();
-                tasklist.setContentByLocalJSON(sqlNote.getContent());
-                GTaskClient.getInstance().createTaskList(tasklist);
-                mGTaskListHashMap.put(tasklist.getGid(), tasklist);
-            }
-            n = (Node) tasklist;
-        }
-
-        // update local note
-        sqlNote.setGtaskId(n.getGid());
-        sqlNote.commit(false);
-        sqlNote.resetLocalModified();
-        sqlNote.commit(true);
-
-        // gid-id mapping
-        mGidToNid.put(n.getGid(), sqlNote.getId());
-        mNidToGid.put(sqlNote.getId(), n.getGid());
-    }
-
-    private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        SqlNote sqlNote = new SqlNote(mContext, c);
-
-        // update remotely
-        node.setContentByLocalJSON(sqlNote.getContent());
-        GTaskClient.getInstance().addUpdateNode(node);
-
-        // update meta
-        updateRemoteMeta(node.getGid(), sqlNote);
-
-        // move task if necessary
-        if (sqlNote.isNoteType()) {
-            Task task = (Task) node;
-            TaskList preParentList = task.getParent();
-
-            String curParentGid = mNidToGid.get(sqlNote.getParentId());
-            if (curParentGid == null) {
-                Log.e(TAG, "cannot find task's parent tasklist");
-                throw new ActionFailureException("cannot update remote task");
-            }
-            TaskList curParentList = mGTaskListHashMap.get(curParentGid);
-
-            if (preParentList != curParentList) {
-                preParentList.removeChildTask(task);
-                curParentList.addChildTask(task);
-                GTaskClient.getInstance().moveTask(task, preParentList, curParentList);
-            }
-        }
-
-        // clear local modified flag
-        sqlNote.resetLocalModified();
-        sqlNote.commit(true);
-    }
-
-    private void updateRemoteMeta(String gid, SqlNote sqlNote) throws NetworkFailureException {
-        if (sqlNote != null && sqlNote.isNoteType()) {
-            MetaData metaData = mMetaHashMap.get(gid);
-            if (metaData != null) {
-                metaData.setMeta(gid, sqlNote.getContent());
-                GTaskClient.getInstance().addUpdateNode(metaData);
-            } else {
-                metaData = new MetaData();
-                metaData.setMeta(gid, sqlNote.getContent());
-                mMetaList.addChildTask(metaData);
-                mMetaHashMap.put(gid, metaData);
-                GTaskClient.getInstance().createTask(metaData);
-            }
-        }
-    }
-
-    private void refreshLocalSyncId() throws NetworkFailureException {
-        if (mCancelled) {
-            return;
-        }
-
-        // get the latest gtask list
-        mGTaskHashMap.clear();
-        mGTaskListHashMap.clear();
-        mMetaHashMap.clear();
-        initGTaskList();
-
-        Cursor c = null;
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, SqlNote.PROJECTION_NOTE,
-                    "(type<>? AND parent_id<>?)", new String[] {
-                            String.valueOf(Notes.TYPE_SYSTEM), String.valueOf(Notes.ID_TRASH_FOLER)
-                    }, NoteColumns.TYPE + " DESC");
-            if (c != null) {
-                while (c.moveToNext()) {
-                    String gid = c.getString(SqlNote.GTASK_ID_COLUMN);
-                    Node node = mGTaskHashMap.get(gid);
-                    if (node != null) {
-                        mGTaskHashMap.remove(gid);
-                        ContentValues values = new ContentValues();
-                        values.put(NoteColumns.SYNC_ID, node.getLastModified());
-                        mContentResolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
-                                c.getLong(SqlNote.ID_COLUMN)), values, null, null);
-                    } else {
-                        Log.e(TAG, "something is missed");
-                        throw new ActionFailureException(
-                                "some local items don't have gid after sync");
-                    }
-                }
-            } else {
-                Log.w(TAG, "failed to query local note to refresh sync id");
-            }
-        } finally {
-            if (c != null) {
-                c.close();
-                c = null;
-            }
-        }
-    }
-
-    public String getSyncAccount() {
-        return GTaskClient.getInstance().getSyncAccount().name;
-    }
-
-    public void cancelSync() {
-        mCancelled = true;
-    }
-}

src/Node.java

@@ -1,101 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.gtask.data;
-
-import android.database.Cursor;
-
-import org.json.JSONObject;
-
-public abstract class Node {
-    public static final int SYNC_ACTION_NONE = 0;
-
-    public static final int SYNC_ACTION_ADD_REMOTE = 1;
-
-    public static final int SYNC_ACTION_ADD_LOCAL = 2;
-
-    public static final int SYNC_ACTION_DEL_REMOTE = 3;
-
-    public static final int SYNC_ACTION_DEL_LOCAL = 4;
-
-    public static final int SYNC_ACTION_UPDATE_REMOTE = 5;
-
-    public static final int SYNC_ACTION_UPDATE_LOCAL = 6;
-
-    public static final int SYNC_ACTION_UPDATE_CONFLICT = 7;
-
-    public static final int SYNC_ACTION_ERROR = 8;
-
-    private String mGid;
-
-    private String mName;
-
-    private long mLastModified;
-
-    private boolean mDeleted;
-
-    public Node() {
-        mGid = null;
-        mName = "";
-        mLastModified = 0;
-        mDeleted = false;
-    }
-
-    public abstract JSONObject getCreateAction(int actionId);
-
-    public abstract JSONObject getUpdateAction(int actionId);
-
-    public abstract void setContentByRemoteJSON(JSONObject js);
-
-    public abstract void setContentByLocalJSON(JSONObject js);
-
-    public abstract JSONObject getLocalJSONFromContent();
-
-    public abstract int getSyncAction(Cursor c);
-
-    public void setGid(String gid) {
-        this.mGid = gid;
-    }
-
-    public void setName(String name) {
-        this.mName = name;
-    }
-
-    public void setLastModified(long lastModified) {
-        this.mLastModified = lastModified;
-    }
-
-    public void setDeleted(boolean deleted) {
-        this.mDeleted = deleted;
-    }
-
-    public String getGid() {
-        return this.mGid;
-    }
-
-    public String getName() {
-        return this.mName;
-    }
-
-    public long getLastModified() {
-        return this.mLastModified;
-    }
-
-    public boolean getDeleted() {
-        return this.mDeleted;
-    }
-
-}

src/NoteWidgetProvider_2x.java

@@ -1,47 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.widget;
-
-import android.appwidget.AppWidgetManager;
-import android.content.Context;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.tool.ResourceParser;
-
-
-public class NoteWidgetProvider_2x extends NoteWidgetProvider {
-    @Override
-    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
-        super.update(context, appWidgetManager, appWidgetIds);
-    }
-
-    @Override
-    protected int getLayoutId() {
-        return R.layout.widget_2x;
-    }
-
-    @Override
-    protected int getBgResourceId(int bgId) {
-        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
-    }
-
-    @Override
-    protected int getWidgetType() {
-        return Notes.TYPE_WIDGET_2X;
-    }
-}

src/NoteWidgetProvider_4x.java

@@ -1,46 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.widget;
-
-import android.appwidget.AppWidgetManager;
-import android.content.Context;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.tool.ResourceParser;
-
-
-public class NoteWidgetProvider_4x extends NoteWidgetProvider {
-    @Override
-    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
-        super.update(context, appWidgetManager, appWidgetIds);
-    }
-
-    protected int getLayoutId() {
-        return R.layout.widget_4x;
-    }
-
-    @Override
-    protected int getBgResourceId(int bgId) {
-        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
-    }
-
-    @Override
-    protected int getWidgetType() {
-        return Notes.TYPE_WIDGET_4X;
-    }
-}

src/Notes.java

@@ -1,279 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.data;
-
-import android.net.Uri;
-public class Notes {
-    public static final String AUTHORITY = "micode_notes";
-    public static final String TAG = "Notes";
-    public static final int TYPE_NOTE     = 0;
-    public static final int TYPE_FOLDER   = 1;
-    public static final int TYPE_SYSTEM   = 2;
-
-    /**
-     * Following IDs are system folders' identifiers
-     * {@link Notes#ID_ROOT_FOLDER } is default folder
-     * {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
-     * {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
-     */
-    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";
-    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;
-    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;
-    }
-
-    /**
-     * Uri to query all notes and folders
-     */
-    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
-
-    /**
-     * Uri to query data
-     */
-    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
-
-    public interface NoteColumns {
-        /**
-         * The unique ID for a row
-         * <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 {
-        /**
-         * 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";
-    }
-
-    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 String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
-
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
-
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
-    }
-
-    public static final class CallNote implements DataColumns {
-        /**
-         * Call date for this record
-         * <P> Type: INTEGER (long) </P>
-         */
-        public static final String CALL_DATE = DATA1;
-
-        /**
-         * Phone number for this record
-         * <P> Type: TEXT </P>
-         */
-        public static final String PHONE_NUMBER = DATA3;
-
-        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
-
-        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
-
-        public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
-    }
-}

src/NotesDatabaseHelper.java

@@ -1,362 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.data;
-
-import android.content.ContentValues;
-import android.content.Context;
-import android.database.sqlite.SQLiteDatabase;
-import android.database.sqlite.SQLiteOpenHelper;
-import android.util.Log;
-
-import net.micode.notes.data.Notes.DataColumns;
-import net.micode.notes.data.Notes.DataConstants;
-import net.micode.notes.data.Notes.NoteColumns;
-
-
-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 + ");";
-
-    /**
-     * Increase folder's note count when move note to the folder
-     */
-    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_UPDATE_TRIGGER =
-        "CREATE TRIGGER increase_folder_count_on_update "+
-        " 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
-     */
-    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";
-
-    /**
-     * Increase folder's note count when insert new note to the folder
-     */
-    private static final String NOTE_INCREASE_FOLDER_COUNT_ON_INSERT_TRIGGER =
-        "CREATE TRIGGER increase_folder_count_on_insert " +
-        " 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
-     */
-    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}
-     */
-    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";
-
-    /**
-     * Update note's content when data with {@link DataConstants#NOTE} type has changed
-     */
-    private static final String DATA_UPDATE_NOTE_CONTENT_ON_UPDATE_TRIGGER =
-        "CREATE TRIGGER update_note_content_on_update " +
-        " 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";
-
-    /**
-     * Delete notes belong to folder which has been deleted
-     */
-    private static final String FOLDER_DELETE_NOTES_ON_DELETE_TRIGGER =
-        "CREATE TRIGGER folder_delete_notes_on_delete " +
-        " 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
-         */
-        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/NotesPreferenceActivity.java

@@ -1,388 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.ui;
-
-import android.accounts.Account;
-import android.accounts.AccountManager;
-import android.app.ActionBar;
-import android.app.AlertDialog;
-import android.content.BroadcastReceiver;
-import android.content.ContentValues;
-import android.content.Context;
-import android.content.DialogInterface;
-import android.content.Intent;
-import android.content.IntentFilter;
-import android.content.SharedPreferences;
-import android.os.Bundle;
-import android.preference.Preference;
-import android.preference.Preference.OnPreferenceClickListener;
-import android.preference.PreferenceActivity;
-import android.preference.PreferenceCategory;
-import android.text.TextUtils;
-import android.text.format.DateFormat;
-import android.view.LayoutInflater;
-import android.view.Menu;
-import android.view.MenuItem;
-import android.view.View;
-import android.widget.Button;
-import android.widget.TextView;
-import android.widget.Toast;
-
-import net.micode.notes.R;
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.NoteColumns;
-import net.micode.notes.gtask.remote.GTaskSyncService;
-
-
-public class NotesPreferenceActivity extends PreferenceActivity {
-    public static final String PREFERENCE_NAME = "notes_preferences";
-
-    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
-
-    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
-
-    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
-
-    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
-
-    private static final String AUTHORITIES_FILTER_KEY = "authorities";
-
-    private PreferenceCategory mAccountCategory;
-
-    private GTaskReceiver mReceiver;
-
-    private Account[] mOriAccounts;
-
-    private boolean mHasAddedAccount;
-
-    @Override
-    protected void onCreate(Bundle icicle) {
-        super.onCreate(icicle);
-
-        /* using the app icon for navigation */
-        getActionBar().setDisplayHomeAsUpEnabled(true);
-
-        addPreferencesFromResource(R.xml.preferences);
-        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
-        mReceiver = new GTaskReceiver();
-        IntentFilter filter = new IntentFilter();
-        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
-        registerReceiver(mReceiver, filter);
-
-        mOriAccounts = null;
-        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
-        getListView().addHeaderView(header, null, true);
-    }
-
-    @Override
-    protected void onResume() {
-        super.onResume();
-
-        // need to set sync account automatically if user has added a new
-        // account
-        if (mHasAddedAccount) {
-            Account[] accounts = getGoogleAccounts();
-            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
-                for (Account accountNew : accounts) {
-                    boolean found = false;
-                    for (Account accountOld : mOriAccounts) {
-                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
-                            found = true;
-                            break;
-                        }
-                    }
-                    if (!found) {
-                        setSyncAccount(accountNew.name);
-                        break;
-                    }
-                }
-            }
-        }
-
-        refreshUI();
-    }
-
-    @Override
-    protected void onDestroy() {
-        if (mReceiver != null) {
-            unregisterReceiver(mReceiver);
-        }
-        super.onDestroy();
-    }
-
-    private void loadAccountPreference() {
-        mAccountCategory.removeAll();
-
-        Preference accountPref = new Preference(this);
-        final String defaultAccount = getSyncAccountName(this);
-        accountPref.setTitle(getString(R.string.preferences_account_title));
-        accountPref.setSummary(getString(R.string.preferences_account_summary));
-        accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
-            public boolean onPreferenceClick(Preference preference) {
-                if (!GTaskSyncService.isSyncing()) {
-                    if (TextUtils.isEmpty(defaultAccount)) {
-                        // the first time to set account
-                        showSelectAccountAlertDialog();
-                    } else {
-                        // if the account has already been set, we need to promp
-                        // user about the risk
-                        showChangeAccountConfirmAlertDialog();
-                    }
-                } else {
-                    Toast.makeText(NotesPreferenceActivity.this,
-                            R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
-                            .show();
-                }
-                return true;
-            }
-        });
-
-        mAccountCategory.addPreference(accountPref);
-    }
-
-    private void loadSyncButton() {
-        Button syncButton = (Button) findViewById(R.id.preference_sync_button);
-        TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
-
-        // set button state
-        if (GTaskSyncService.isSyncing()) {
-            syncButton.setText(getString(R.string.preferences_button_sync_cancel));
-            syncButton.setOnClickListener(new View.OnClickListener() {
-                public void onClick(View v) {
-                    GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
-                }
-            });
-        } else {
-            syncButton.setText(getString(R.string.preferences_button_sync_immediately));
-            syncButton.setOnClickListener(new View.OnClickListener() {
-                public void onClick(View v) {
-                    GTaskSyncService.startSync(NotesPreferenceActivity.this);
-                }
-            });
-        }
-        syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
-
-        // set last sync time
-        if (GTaskSyncService.isSyncing()) {
-            lastSyncTimeView.setText(GTaskSyncService.getProgressString());
-            lastSyncTimeView.setVisibility(View.VISIBLE);
-        } else {
-            long lastSyncTime = getLastSyncTime(this);
-            if (lastSyncTime != 0) {
-                lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
-                        DateFormat.format(getString(R.string.preferences_last_sync_time_format),
-                                lastSyncTime)));
-                lastSyncTimeView.setVisibility(View.VISIBLE);
-            } else {
-                lastSyncTimeView.setVisibility(View.GONE);
-            }
-        }
-    }
-
-    private void refreshUI() {
-        loadAccountPreference();
-        loadSyncButton();
-    }
-
-    private void showSelectAccountAlertDialog() {
-        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
-
-        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
-        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
-        titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
-        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
-        subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
-
-        dialogBuilder.setCustomTitle(titleView);
-        dialogBuilder.setPositiveButton(null, null);
-
-        Account[] accounts = getGoogleAccounts();
-        String defAccount = getSyncAccountName(this);
-
-        mOriAccounts = accounts;
-        mHasAddedAccount = false;
-
-        if (accounts.length > 0) {
-            CharSequence[] items = new CharSequence[accounts.length];
-            final CharSequence[] itemMapping = items;
-            int checkedItem = -1;
-            int index = 0;
-            for (Account account : accounts) {
-                if (TextUtils.equals(account.name, defAccount)) {
-                    checkedItem = index;
-                }
-                items[index++] = account.name;
-            }
-            dialogBuilder.setSingleChoiceItems(items, checkedItem,
-                    new DialogInterface.OnClickListener() {
-                        public void onClick(DialogInterface dialog, int which) {
-                            setSyncAccount(itemMapping[which].toString());
-                            dialog.dismiss();
-                            refreshUI();
-                        }
-                    });
-        }
-
-        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
-        dialogBuilder.setView(addAccountView);
-
-        final AlertDialog dialog = dialogBuilder.show();
-        addAccountView.setOnClickListener(new View.OnClickListener() {
-            public void onClick(View v) {
-                mHasAddedAccount = true;
-                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
-                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
-                    "gmail-ls"
-                });
-                startActivityForResult(intent, -1);
-                dialog.dismiss();
-            }
-        });
-    }
-
-    private void showChangeAccountConfirmAlertDialog() {
-        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
-
-        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
-        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
-        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
-                getSyncAccountName(this)));
-        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
-        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
-        dialogBuilder.setCustomTitle(titleView);
-
-        CharSequence[] menuItemArray = new CharSequence[] {
-                getString(R.string.preferences_menu_change_account),
-                getString(R.string.preferences_menu_remove_account),
-                getString(R.string.preferences_menu_cancel)
-        };
-        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
-            public void onClick(DialogInterface dialog, int which) {
-                if (which == 0) {
-                    showSelectAccountAlertDialog();
-                } else if (which == 1) {
-                    removeSyncAccount();
-                    refreshUI();
-                }
-            }
-        });
-        dialogBuilder.show();
-    }
-
-    private Account[] getGoogleAccounts() {
-        AccountManager accountManager = AccountManager.get(this);
-        return accountManager.getAccountsByType("com.google");
-    }
-
-    private void setSyncAccount(String account) {
-        if (!getSyncAccountName(this).equals(account)) {
-            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
-            SharedPreferences.Editor editor = settings.edit();
-            if (account != null) {
-                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
-            } else {
-                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
-            }
-            editor.commit();
-
-            // clean up last sync time
-            setLastSyncTime(this, 0);
-
-            // clean up local gtask related info
-            new Thread(new Runnable() {
-                public void run() {
-                    ContentValues values = new ContentValues();
-                    values.put(NoteColumns.GTASK_ID, "");
-                    values.put(NoteColumns.SYNC_ID, 0);
-                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
-                }
-            }).start();
-
-            Toast.makeText(NotesPreferenceActivity.this,
-                    getString(R.string.preferences_toast_success_set_accout, account),
-                    Toast.LENGTH_SHORT).show();
-        }
-    }
-
-    private void removeSyncAccount() {
-        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
-        SharedPreferences.Editor editor = settings.edit();
-        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
-            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
-        }
-        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
-            editor.remove(PREFERENCE_LAST_SYNC_TIME);
-        }
-        editor.commit();
-
-        // clean up local gtask related info
-        new Thread(new Runnable() {
-            public void run() {
-                ContentValues values = new ContentValues();
-                values.put(NoteColumns.GTASK_ID, "");
-                values.put(NoteColumns.SYNC_ID, 0);
-                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
-            }
-        }).start();
-    }
-
-    public static String getSyncAccountName(Context context) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
-        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
-    }
-
-    public static void setLastSyncTime(Context context, long time) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
-        SharedPreferences.Editor editor = settings.edit();
-        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
-        editor.commit();
-    }
-
-    public static long getLastSyncTime(Context context) {
-        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
-                Context.MODE_PRIVATE);
-        return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
-    }
-
-    private class GTaskReceiver extends BroadcastReceiver {
-
-        @Override
-        public void onReceive(Context context, Intent intent) {
-            refreshUI();
-            if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
-                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
-                syncStatus.setText(intent
-                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
-            }
-
-        }
-    }
-
-    public boolean onOptionsItemSelected(MenuItem item) {
-        switch (item.getItemId()) {
-            case android.R.id.home:
-                Intent intent = new Intent(this, NotesListActivity.class);
-                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
-                startActivity(intent);
-                return true;
-            default:
-                return false;
-        }
-    }
-}

src/SqlNote.java

@@ -1,505 +0,0 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package net.micode.notes.gtask.data;
-
-import android.appwidget.AppWidgetManager;
-import android.content.ContentResolver;
-import android.content.ContentValues;
-import android.content.Context;
-import android.database.Cursor;
-import android.net.Uri;
-import android.util.Log;
-
-import net.micode.notes.data.Notes;
-import net.micode.notes.data.Notes.DataColumns;
-import net.micode.notes.data.Notes.NoteColumns;
-import net.micode.notes.gtask.exception.ActionFailureException;
-import net.micode.notes.tool.GTaskStringUtils;
-import net.micode.notes.tool.ResourceParser;
-
-import org.json.JSONArray;
-import org.json.JSONException;
-import org.json.JSONObject;
-
-import java.util.ArrayList;
-
-
-public class SqlNote {
-    private static final String TAG = SqlNote.class.getSimpleName();
-
-    private static final int INVALID_ID = -99999;
-
-    public static final String[] PROJECTION_NOTE = 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, NoteColumns.SYNC_ID,
-            NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
-            NoteColumns.VERSION
-    };
-
-    public static final int ID_COLUMN = 0;
-
-    public static final int ALERTED_DATE_COLUMN = 1;
-
-    public static final int BG_COLOR_ID_COLUMN = 2;
-
-    public static final int CREATED_DATE_COLUMN = 3;
-
-    public static final int HAS_ATTACHMENT_COLUMN = 4;
-
-    public static final int MODIFIED_DATE_COLUMN = 5;
-
-    public static final int NOTES_COUNT_COLUMN = 6;
-
-    public static final int PARENT_ID_COLUMN = 7;
-
-    public static final int SNIPPET_COLUMN = 8;
-
-    public static final int TYPE_COLUMN = 9;
-
-    public static final int WIDGET_ID_COLUMN = 10;
-
-    public static final int WIDGET_TYPE_COLUMN = 11;
-
-    public static final int SYNC_ID_COLUMN = 12;
-
-    public static final int LOCAL_MODIFIED_COLUMN = 13;
-
-    public static final int ORIGIN_PARENT_ID_COLUMN = 14;
-
-    public static final int GTASK_ID_COLUMN = 15;
-
-    public static final int VERSION_COLUMN = 16;
-
-    private Context mContext;
-
-    private ContentResolver mContentResolver;
-
-    private boolean mIsCreate;
-
-    private long mId;
-
-    private long mAlertDate;
-
-    private int mBgColorId;
-
-    private long mCreatedDate;
-
-    private int mHasAttachment;
-
-    private long mModifiedDate;
-
-    private long mParentId;
-
-    private String mSnippet;
-
-    private int mType;
-
-    private int mWidgetId;
-
-    private int mWidgetType;
-
-    private long mOriginParent;
-
-    private long mVersion;
-
-    private ContentValues mDiffNoteValues;
-
-    private ArrayList<SqlData> mDataList;
-
-    public SqlNote(Context context) {
-        mContext = context;
-        mContentResolver = context.getContentResolver();
-        mIsCreate = true;
-        mId = INVALID_ID;
-        mAlertDate = 0;
-        mBgColorId = ResourceParser.getDefaultBgId(context);
-        mCreatedDate = System.currentTimeMillis();
-        mHasAttachment = 0;
-        mModifiedDate = System.currentTimeMillis();
-        mParentId = 0;
-        mSnippet = "";
-        mType = Notes.TYPE_NOTE;
-        mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
-        mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
-        mOriginParent = 0;
-        mVersion = 0;
-        mDiffNoteValues = new ContentValues();
-        mDataList = new ArrayList<SqlData>();
-    }
-
-    public SqlNote(Context context, Cursor c) {
-        mContext = context;
-        mContentResolver = context.getContentResolver();
-        mIsCreate = false;
-        loadFromCursor(c);
-        mDataList = new ArrayList<SqlData>();
-        if (mType == Notes.TYPE_NOTE)
-            loadDataContent();
-        mDiffNoteValues = new ContentValues();
-    }
-
-    public SqlNote(Context context, long id) {
-        mContext = context;
-        mContentResolver = context.getContentResolver();
-        mIsCreate = false;
-        loadFromCursor(id);
-        mDataList = new ArrayList<SqlData>();
-        if (mType == Notes.TYPE_NOTE)
-            loadDataContent();
-        mDiffNoteValues = new ContentValues();
-
-    }
-
-    private void loadFromCursor(long id) {
-        Cursor c = null;
-        try {
-            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",
-                    new String[] {
-                        String.valueOf(id)
-                    }, null);
-            if (c != null) {
-                c.moveToNext();
-                loadFromCursor(c);
-            } else {
-                Log.w(TAG, "loadFromCursor: cursor = null");
-            }
-        } finally {
-            if (c != null)
-                c.close();
-        }
-    }
-
-    private void loadFromCursor(Cursor c) {
-        mId = c.getLong(ID_COLUMN);
-        mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
-        mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
-        mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
-        mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
-        mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
-        mParentId = c.getLong(PARENT_ID_COLUMN);
-        mSnippet = c.getString(SNIPPET_COLUMN);
-        mType = c.getInt(TYPE_COLUMN);
-        mWidgetId = c.getInt(WIDGET_ID_COLUMN);
-        mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
-        mVersion = c.getLong(VERSION_COLUMN);
-    }
-
-    private void loadDataContent() {
-        Cursor c = null;
-        mDataList.clear();
-        try {
-            c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA,
-                    "(note_id=?)", new String[] {
-                        String.valueOf(mId)
-                    }, null);
-            if (c != null) {
-                if (c.getCount() == 0) {
-                    Log.w(TAG, "it seems that the note has not data");
-                    return;
-                }
-                while (c.moveToNext()) {
-                    SqlData data = new SqlData(mContext, c);
-                    mDataList.add(data);
-                }
-            } else {
-                Log.w(TAG, "loadDataContent: cursor = null");
-            }
-        } finally {
-            if (c != null)
-                c.close();
-        }
-    }
-
-    public boolean setContent(JSONObject js) {
-        try {
-            JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
-            if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_SYSTEM) {
-                Log.w(TAG, "cannot set system folder");
-            } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_FOLDER) {
-                // for folder we can only update the snnipet and type
-                String snippet = note.has(NoteColumns.SNIPPET) ? note
-                        .getString(NoteColumns.SNIPPET) : "";
-                if (mIsCreate || !mSnippet.equals(snippet)) {
-                    mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
-                }
-                mSnippet = snippet;
-
-                int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE)
-                        : Notes.TYPE_NOTE;
-                if (mIsCreate || mType != type) {
-                    mDiffNoteValues.put(NoteColumns.TYPE, type);
-                }
-                mType = type;
-            } else if (note.getInt(NoteColumns.TYPE) == Notes.TYPE_NOTE) {
-                JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
-                long id = note.has(NoteColumns.ID) ? note.getLong(NoteColumns.ID) : INVALID_ID;
-                if (mIsCreate || mId != id) {
-                    mDiffNoteValues.put(NoteColumns.ID, id);
-                }
-                mId = id;
-
-                long alertDate = note.has(NoteColumns.ALERTED_DATE) ? note
-                        .getLong(NoteColumns.ALERTED_DATE) : 0;
-                if (mIsCreate || mAlertDate != alertDate) {
-                    mDiffNoteValues.put(NoteColumns.ALERTED_DATE, alertDate);
-                }
-                mAlertDate = alertDate;
-
-                int bgColorId = note.has(NoteColumns.BG_COLOR_ID) ? note
-                        .getInt(NoteColumns.BG_COLOR_ID) : ResourceParser.getDefaultBgId(mContext);
-                if (mIsCreate || mBgColorId != bgColorId) {
-                    mDiffNoteValues.put(NoteColumns.BG_COLOR_ID, bgColorId);
-                }
-                mBgColorId = bgColorId;
-
-                long createDate = note.has(NoteColumns.CREATED_DATE) ? note
-                        .getLong(NoteColumns.CREATED_DATE) : System.currentTimeMillis();
-                if (mIsCreate || mCreatedDate != createDate) {
-                    mDiffNoteValues.put(NoteColumns.CREATED_DATE, createDate);
-                }
-                mCreatedDate = createDate;
-
-                int hasAttachment = note.has(NoteColumns.HAS_ATTACHMENT) ? note
-                        .getInt(NoteColumns.HAS_ATTACHMENT) : 0;
-                if (mIsCreate || mHasAttachment != hasAttachment) {
-                    mDiffNoteValues.put(NoteColumns.HAS_ATTACHMENT, hasAttachment);
-                }
-                mHasAttachment = hasAttachment;
-
-                long modifiedDate = note.has(NoteColumns.MODIFIED_DATE) ? note
-                        .getLong(NoteColumns.MODIFIED_DATE) : System.currentTimeMillis();
-                if (mIsCreate || mModifiedDate != modifiedDate) {
-                    mDiffNoteValues.put(NoteColumns.MODIFIED_DATE, modifiedDate);
-                }
-                mModifiedDate = modifiedDate;
-
-                long parentId = note.has(NoteColumns.PARENT_ID) ? note
-                        .getLong(NoteColumns.PARENT_ID) : 0;
-                if (mIsCreate || mParentId != parentId) {
-                    mDiffNoteValues.put(NoteColumns.PARENT_ID, parentId);
-                }
-                mParentId = parentId;
-
-                String snippet = note.has(NoteColumns.SNIPPET) ? note
-                        .getString(NoteColumns.SNIPPET) : "";
-                if (mIsCreate || !mSnippet.equals(snippet)) {
-                    mDiffNoteValues.put(NoteColumns.SNIPPET, snippet);
-                }
-                mSnippet = snippet;
-
-                int type = note.has(NoteColumns.TYPE) ? note.getInt(NoteColumns.TYPE)
-                        : Notes.TYPE_NOTE;
-                if (mIsCreate || mType != type) {
-                    mDiffNoteValues.put(NoteColumns.TYPE, type);
-                }
-                mType = type;
-
-                int widgetId = note.has(NoteColumns.WIDGET_ID) ? note.getInt(NoteColumns.WIDGET_ID)
-                        : AppWidgetManager.INVALID_APPWIDGET_ID;
-                if (mIsCreate || mWidgetId != widgetId) {
-                    mDiffNoteValues.put(NoteColumns.WIDGET_ID, widgetId);
-                }
-                mWidgetId = widgetId;
-
-                int widgetType = note.has(NoteColumns.WIDGET_TYPE) ? note
-                        .getInt(NoteColumns.WIDGET_TYPE) : Notes.TYPE_WIDGET_INVALIDE;
-                if (mIsCreate || mWidgetType != widgetType) {
-                    mDiffNoteValues.put(NoteColumns.WIDGET_TYPE, widgetType);
-                }
-                mWidgetType = widgetType;
-
-                long originParent = note.has(NoteColumns.ORIGIN_PARENT_ID) ? note
-                        .getLong(NoteColumns.ORIGIN_PARENT_ID) : 0;
-                if (mIsCreate || mOriginParent != originParent) {
-                    mDiffNoteValues.put(NoteColumns.ORIGIN_PARENT_ID, originParent);
-                }
-                mOriginParent = originParent;
-
-                for (int i = 0; i < dataArray.length(); i++) {
-                    JSONObject data = dataArray.getJSONObject(i);
-                    SqlData sqlData = null;
-                    if (data.has(DataColumns.ID)) {
-                        long dataId = data.getLong(DataColumns.ID);
-                        for (SqlData temp : mDataList) {
-                            if (dataId == temp.getId()) {
-                                sqlData = temp;
-                            }
-                        }
-                    }
-
-                    if (sqlData == null) {
-                        sqlData = new SqlData(mContext);
-                        mDataList.add(sqlData);
-                    }
-
-                    sqlData.setContent(data);
-                }
-            }
-        } catch (JSONException e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-            return false;
-        }
-        return true;
-    }
-
-    public JSONObject getContent() {
-        try {
-            JSONObject js = new JSONObject();
-
-            if (mIsCreate) {
-                Log.e(TAG, "it seems that we haven't created this in database yet");
-                return null;
-            }
-
-            JSONObject note = new JSONObject();
-            if (mType == Notes.TYPE_NOTE) {
-                note.put(NoteColumns.ID, mId);
-                note.put(NoteColumns.ALERTED_DATE, mAlertDate);
-                note.put(NoteColumns.BG_COLOR_ID, mBgColorId);
-                note.put(NoteColumns.CREATED_DATE, mCreatedDate);
-                note.put(NoteColumns.HAS_ATTACHMENT, mHasAttachment);
-                note.put(NoteColumns.MODIFIED_DATE, mModifiedDate);
-                note.put(NoteColumns.PARENT_ID, mParentId);
-                note.put(NoteColumns.SNIPPET, mSnippet);
-                note.put(NoteColumns.TYPE, mType);
-                note.put(NoteColumns.WIDGET_ID, mWidgetId);
-                note.put(NoteColumns.WIDGET_TYPE, mWidgetType);
-                note.put(NoteColumns.ORIGIN_PARENT_ID, mOriginParent);
-                js.put(GTaskStringUtils.META_HEAD_NOTE, note);
-
-                JSONArray dataArray = new JSONArray();
-                for (SqlData sqlData : mDataList) {
-                    JSONObject data = sqlData.getContent();
-                    if (data != null) {
-                        dataArray.put(data);
-                    }
-                }
-                js.put(GTaskStringUtils.META_HEAD_DATA, dataArray);
-            } else if (mType == Notes.TYPE_FOLDER || mType == Notes.TYPE_SYSTEM) {
-                note.put(NoteColumns.ID, mId);
-                note.put(NoteColumns.TYPE, mType);
-                note.put(NoteColumns.SNIPPET, mSnippet);
-                js.put(GTaskStringUtils.META_HEAD_NOTE, note);
-            }
-
-            return js;
-        } catch (JSONException e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-        }
-        return null;
-    }
-
-    public void setParentId(long id) {
-        mParentId = id;
-        mDiffNoteValues.put(NoteColumns.PARENT_ID, id);
-    }
-
-    public void setGtaskId(String gid) {
-        mDiffNoteValues.put(NoteColumns.GTASK_ID, gid);
-    }
-
-    public void setSyncId(long syncId) {
-        mDiffNoteValues.put(NoteColumns.SYNC_ID, syncId);
-    }
-
-    public void resetLocalModified() {
-        mDiffNoteValues.put(NoteColumns.LOCAL_MODIFIED, 0);
-    }
-
-    public long getId() {
-        return mId;
-    }
-
-    public long getParentId() {
-        return mParentId;
-    }
-
-    public String getSnippet() {
-        return mSnippet;
-    }
-
-    public boolean isNoteType() {
-        return mType == Notes.TYPE_NOTE;
-    }
-
-    public void commit(boolean validateVersion) {
-        if (mIsCreate) {
-            if (mId == INVALID_ID && mDiffNoteValues.containsKey(NoteColumns.ID)) {
-                mDiffNoteValues.remove(NoteColumns.ID);
-            }
-
-            Uri uri = mContentResolver.insert(Notes.CONTENT_NOTE_URI, mDiffNoteValues);
-            try {
-                mId = Long.valueOf(uri.getPathSegments().get(1));
-            } catch (NumberFormatException e) {
-                Log.e(TAG, "Get note id error :" + e.toString());
-                throw new ActionFailureException("create note failed");
-            }
-            if (mId == 0) {
-                throw new IllegalStateException("Create thread id failed");
-            }
-
-            if (mType == Notes.TYPE_NOTE) {
-                for (SqlData sqlData : mDataList) {
-                    sqlData.commit(mId, false, -1);
-                }
-            }
-        } else {
-            if (mId <= 0 && mId != Notes.ID_ROOT_FOLDER && mId != Notes.ID_CALL_RECORD_FOLDER) {
-                Log.e(TAG, "No such note");
-                throw new IllegalStateException("Try to update note with invalid id");
-            }
-            if (mDiffNoteValues.size() > 0) {
-                mVersion ++;
-                int result = 0;
-                if (!validateVersion) {
-                    result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
-                            + NoteColumns.ID + "=?)", new String[] {
-                        String.valueOf(mId)
-                    });
-                } else {
-                    result = mContentResolver.update(Notes.CONTENT_NOTE_URI, mDiffNoteValues, "("
-                            + NoteColumns.ID + "=?) AND (" + NoteColumns.VERSION + "<=?)",
-                            new String[] {
-                                    String.valueOf(mId), String.valueOf(mVersion)
-                            });
-                }
-                if (result == 0) {
-                    Log.w(TAG, "there is no update. maybe user updates note when syncing");
-                }
-            }
-
-            if (mType == Notes.TYPE_NOTE) {
-                for (SqlData sqlData : mDataList) {
-                    sqlData.commit(mId, validateVersion, mVersion);
-                }
-            }
-        }
-
-        // refresh local info
-        loadFromCursor(mId);
-        if (mType == Notes.TYPE_NOTE)
-            loadDataContent();
-
-        mDiffNoteValues.clear();
-        mIsCreate = false;
-    }
-}

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

@@ -24,27 +24,35 @@ import android.telephony.PhoneNumberUtils;
 import android.util.Log;
 
 import java.util.HashMap;
-
+/**
+ * 联系人信息类，用于根据电话号码获取联系人名称
+ */
 public class Contact {
-    private static HashMap<String, String> sContactCache;
-    private static final String TAG = "Contact";
-
+    private static HashMap<String, String> sContactCache; //用于缓存联系人信息的哈希表
+    private static final String TAG = "Contact"; //日志标签
+//定义用于查询数据库的SQL语句，用于匹配电话号码并获取联系人信息
     private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
     + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
     + " AND " + Data.RAW_CONTACT_ID + " IN "
             + "(SELECT raw_contact_id "
             + " 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(
@@ -53,17 +61,17 @@ public class Contact {
                 selection,
                 new String[] { phoneNumber },
                 null);
-
+        // 如果查询成功且有结果
         if (cursor != null && cursor.moveToFirst()) {
             try {
-                String name = cursor.getString(0);
-                sContactCache.put(phoneNumber, name);
+                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();
+                cursor.close();  // 关闭游标
             }
         } else {
             Log.d(TAG, "No contact matched with number:" + phoneNumber);

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

@@ -0,0 +1,256 @@
+/*
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
+ */
+
+package net.micode.notes.data;
+
+import android.net.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;
+
+    /**
+     * 下面的 ID 是系统文件夹的标识符
+     * {@link Notes#ID_ROOT_FOLDER } 是默认文件夹
+     * {@link Notes#ID_TEMPARAY_FOLDER } 是属于没有文件夹的笔记
+     * {@link Notes#ID_CALL_RECORD_FOLDER} 是存储通话记录的文件夹
+     */
+    // 根文件夹 ID
+    public static final int ID_ROOT_FOLDER = 0;
+    // 临时文件夹 ID
+    public static final int ID_TEMPARAY_FOLDER = -1;
+    // 通话记录文件夹 ID
+    public static final int ID_CALL_RECORD_FOLDER = -2;
+    // 垃圾箱文件夹 ID
+    public static final int ID_TRASH_FOLER = -3;
+
+    // 提醒日期的 Intent 额外数据
+    public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
+    // 背景颜色 ID 的 Intent 额外数据
+    public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
+    // 小部件 ID 的 Intent 额外数据
+    public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
+    // 小部件类型的 Intent 额外数据
+    public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
+    // 文件夹 ID 的 Intent 额外数据
+    public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
+    // 通话日期的 Intent 额外数据
+    public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
+
+    // 无效的小部件类型
+    public static final int TYPE_WIDGET_INVALIDE      = -1;
+    // 2x 小部件类型
+    public static final int TYPE_WIDGET_2X            = 0;
+    // 4x 小部件类型
+    public static final int TYPE_WIDGET_4X            = 1;
+
+    public static class DataConstants {
+        // 笔记的 MIME 类型
+        public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
+        // 通话记录的 MIME 类型
+        public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
+    }
+
+    /**
+     * 查询所有笔记和文件夹的 Uri
+     */
+    public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
+
+    /**
+     * 查询数据的 Uri
+     */
+    public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
+
+    public interface NoteColumns {
+        /**
+         * 行的唯一 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 笔记或文件夹的父 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String PARENT_ID = "parent_id";
+
+        /**
+         * 笔记或文件夹的创建日期
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最后修改日期
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+
+        /**
+         * 提醒日期
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String ALERTED_DATE = "alert_date";
+
+        /**
+         * 文件夹的名称或笔记的文本内容
+         * <P> 类型：TEXT </P>
+         */
+        public static final String SNIPPET = "snippet";
+
+        /**
+         * 笔记的小部件 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String WIDGET_ID = "widget_id";
+
+        /**
+         * 笔记的小部件类型
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String WIDGET_TYPE = "widget_type";
+
+        /**
+         * 笔记的背景颜色 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String BG_COLOR_ID = "bg_color_id";
+
+        /**
+         * 是否有附件
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String HAS_ATTACHMENT = "has_attachment";
+
+        /**
+         * 文件夹的笔记数量
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String NOTES_COUNT = "notes_count";
+
+        /**
+         * 文件类型：文件夹或笔记
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String TYPE = "type";
+
+        /**
+         * 最后同步 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String SYNC_ID = "sync_id";
+
+        /**
+         * 是否本地修改的标志
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String LOCAL_MODIFIED = "local_modified";
+
+        /**
+         * 移动到临时文件夹之前的原始父 ID
+         * <P> 类型 : INTEGER </P>
+         */
+        public static final String ORIGIN_PARENT_ID = "origin_parent_id";
+
+        /**
+         * gtask ID
+         * <P> 类型 : TEXT </P>
+         */
+        public static final String GTASK_ID = "gtask_id";
+
+        /**
+         * 版本代码
+         * <P> 类型 : INTEGER (long) </P>
+         */
+        public static final String VERSION = "version";
+    }
+
+    public interface DataColumns {
+        /**
+         * 行的唯一 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String ID = "_id";
+
+        /**
+         * 此行所代表的项的 MIME 类型
+         * <P> 类型：TEXT </P>
+         */
+        public static final String MIME_TYPE = "mime_type";
+
+        /**
+         * 此数据所属笔记的引用 ID
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String NOTE_ID = "note_id";
+
+        /**
+         * 笔记或文件夹的创建日期
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String CREATED_DATE = "created_date";
+
+        /**
+         * 最后修改日期
+         * <P> 类型：INTEGER (long) </P>
+         */
+        public static final String MODIFIED_DATE = "modified_date";
+
+        /**
+         * 数据的内容
+         * <P> 类型：TEXT </P>
+         */
+        public static final String CONTENT = "content";
+
+
+        /**
+         * 通用数据列，具体含义取决于 {@link #MIMETYPE}，用于整数数据类型
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String DATA1 = "data1";
+
+        /**
+         * 通用数据列，具体含义取决于 {@link #MIMETYPE}，用于整数数据类型
+         * <P> 类型：INTEGER </P>
+         */
+        public static final String DATA2 = "data2";
+
+        /**
+         * 通用数据列，具体含义取决于 {@link #MIMETYPE}，用于 TEXT 数据类型
+         * <P> 类型：TEXT </P>
+         */
+        public static final String DATA3 = "data3";
+
+        /**
+         * 通用数据列，具体含义取决于 {@link #MIMETYPE}，用于 TEXT 数据类型
+         * <P> 类型：TEXT </P>
+         */
+        public static final String DATA4 = "data4";
+
+        /**
+         * 通用数据列，具体含义取决于 {@link #MIMETYPE}，用于 TEXT 数据类型
+         * <P> 类型：TEXT </P>
+         */
+        public static final String DATA5 = "data5";
+    }
+
+    public

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

@@ -0,0 +1,165 @@
+以下是为`NotesDatabaseHelper.java`文件添加的中文注释：
+
+```java
+/*
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
+ */
+
+package net.micode.notes.data;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.sqlite.SQLiteDatabase;
+import android.database.sqlite.SQLiteOpenHelper;
+import android.util.Log;
+
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+/**
+ * 笔记数据库帮助类，用于创建和管理笔记数据库。
+ */
+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;
+
+    // 创建笔记表的 SQL 语句
+    private static final String CREATE_NOTE_TABLE_SQL =
+        "CREATE TABLE " + TABLE.NOTE + "(" +
+            NoteColumns.ID + " INTEGER PRIMARY KEY," + // 笔记 ID
+            NoteColumns.PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 父 ID
+            NoteColumns.ALERTED_DATE + " INTEGER NOT NULL DEFAULT 0," + // 提醒日期
+            NoteColumns.BG_COLOR_ID + " INTEGER NOT NULL DEFAULT 0," + // 背景颜色 ID
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期
+            NoteColumns.HAS_ATTACHMENT + " INTEGER NOT NULL DEFAULT 0," + // 是否有附件
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 修改日期
+            NoteColumns.NOTES_COUNT + " INTEGER NOT NULL DEFAULT 0," + // 笔记数量
+            NoteColumns.SNIPPET + " TEXT NOT NULL DEFAULT ''," + // 摘要
+            NoteColumns.TYPE + " INTEGER NOT NULL DEFAULT 0," + // 类型
+            NoteColumns.WIDGET_ID + " INTEGER NOT NULL DEFAULT 0," + // 小部件 ID
+            NoteColumns.WIDGET_TYPE + " INTEGER NOT NULL DEFAULT -1," + // 小部件类型
+            NoteColumns.SYNC_ID + " INTEGER NOT NULL DEFAULT 0," + // 同步 ID
+            NoteColumns.LOCAL_MODIFIED + " INTEGER NOT NULL DEFAULT 0," + // 是否本地修改
+            NoteColumns.ORIGIN_PARENT_ID + " INTEGER NOT NULL DEFAULT 0," + // 原始父 ID
+            NoteColumns.GTASK_ID + " TEXT NOT NULL DEFAULT ''," + // gtask ID
+            NoteColumns.VERSION + " INTEGER NOT NULL DEFAULT 0" + // 版本
+        ")";
+
+    // 创建数据表的 SQL 语句
+    private static final String CREATE_DATA_TABLE_SQL =
+        "CREATE TABLE " + TABLE.DATA + "(" +
+            DataColumns.ID + " INTEGER PRIMARY KEY," + // 数据 ID
+            DataColumns.MIME_TYPE + " TEXT NOT NULL," + // MIME 类型
+            DataColumns.NOTE_ID + " INTEGER NOT NULL DEFAULT 0," + // 笔记 ID
+            NoteColumns.CREATED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 创建日期
+            NoteColumns.MODIFIED_DATE + " INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000)," + // 修改日期
+            DataColumns.CONTENT + " TEXT NOT NULL DEFAULT ''," + // 内容
+            DataColumns.DATA1 + " INTEGER," + // 数据 1
+            DataColumns.DATA2 + " INTEGER," + // 数据 2
+            DataColumns.DATA3 + " TEXT NOT NULL DEFAULT ''," + // 数据 3
+            DataColumns.DATA4 + " TEXT NOT NULL DEFAULT ''," + // 数据 4
+            DataColumns.DATA5 + " TEXT NOT NULL DEFAULT ''" + // 数据 5
+        ")";
+
+    // 创建数据表中笔记 ID 索引的 SQL 语句
+    private static final String CREATE_DATA_NOTE_ID_INDEX_SQL =
+        "CREATE INDEX IF NOT EXISTS note_id_index ON " +
+        TABLE.DATA + "(" + DataColumns.NOTE_ID + ");";
+
+    // 当笔记移动到文件夹时增加文件夹的笔记数量的触发器
+    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";
+
+    // 当笔记从文件夹移出时减少文件夹的笔记数量的触发器
+    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";
+
+    // 当新笔记插入到文件夹时增加文件夹的笔记数量的触发器
+    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";
+
+    // 当笔记从文件夹中删除时减少文件夹的笔记数量的触发器
+    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";
+
+    // 当插入类型为笔记的数据时更新笔记内容的触发器
+    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";
+
+    // 当类型为笔记的数据发生变化时更新笔记内容的触发器
+    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";
+
+    // 当类型为笔记的数据被删除时更新笔记内容的触发器
+    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 "

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

@@ -1,22 +1,22 @@
+以下是为`NotesProvider.java`文件添加的中文注释：
+
+```java
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
  */
 
 package net.micode.notes.data;
 
-
 import android.app.SearchManager;
 import android.content.ContentProvider;
 import android.content.ContentUris;
@@ -34,23 +34,29 @@ import net.micode.notes.data.Notes.DataColumns;
 import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.NotesDatabaseHelper.TABLE;
 
-
+/**
+ * 笔记内容提供者，用于管理笔记数据的访问.
+ */
 public class NotesProvider extends ContentProvider {
+    // Uri 匹配器
     private static final UriMatcher mMatcher;
 
+    // 数据库帮助类实例
     private NotesDatabaseHelper mHelper;
 
+    // 日志标签
     private static final String TAG = "NotesProvider";
 
-    private static final int URI_NOTE            = 1;
-    private static final int URI_NOTE_ITEM       = 2;
-    private static final int URI_DATA            = 3;
-    private static final int URI_DATA_ITEM       = 4;
-
-    private static final int URI_SEARCH          = 5;
-    private static final int URI_SEARCH_SUGGEST  = 6;
+    // Uri 类型常量
+    private static final int URI_NOTE            = 1; // 笔记 Uri
+    private static final int URI_NOTE_ITEM       = 2; // 单个笔记 Uri
+    private static final int URI_DATA            = 3; // 数据 Uri
+    private static final int URI_DATA_ITEM       = 4; // 单个数据 Uri
+    private static final int URI_SEARCH          = 5; // 搜索 Uri
+    private static final int URI_SEARCH_SUGGEST  = 6; // 搜索建议 Uri
 
     static {
+        // 初始化 Uri 匹配器
         mMatcher = new UriMatcher(UriMatcher.NO_MATCH);
         mMatcher.addURI(Notes.AUTHORITY, "note", URI_NOTE);
         mMatcher.addURI(Notes.AUTHORITY, "note/#", URI_NOTE_ITEM);
@@ -62,8 +68,7 @@ public class NotesProvider extends ContentProvider {
     }
 
     /**
-     * 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 + ","
@@ -73,6 +78,9 @@ public class NotesProvider extends ContentProvider {
         + "'" + Intent.ACTION_VIEW + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_ACTION + ","
         + "'" + Notes.TextNote.CONTENT_TYPE + "' AS " + SearchManager.SUGGEST_COLUMN_INTENT_DATA;
 
+    /**
+     * 笔记摘要搜索查询字符串.
+     */
     private static String NOTES_SNIPPET_SEARCH_QUERY = "SELECT " + NOTES_SEARCH_PROJECTION
         + " FROM " + TABLE.NOTE
         + " WHERE " + NoteColumns.SNIPPET + " LIKE ?"
@@ -81,6 +89,7 @@ public class NotesProvider extends ContentProvider {
 
     @Override
     public boolean onCreate() {
+        // 获取数据库帮助类实例
         mHelper = NotesDatabaseHelper.getInstance(getContext());
         return true;
     }
@@ -88,35 +97,46 @@ public class NotesProvider extends ContentProvider {
     @Override
     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
             String sortOrder) {
+        // 查询结果游标
         Cursor c = null;
+        // 获取可读数据库
         SQLiteDatabase db = mHelper.getReadableDatabase();
+        // 笔记 ID
         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
                 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
                 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) {
@@ -126,12 +146,15 @@ public class NotesProvider extends ContentProvider {
                     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) {
@@ -139,8 +162,10 @@ public class NotesProvider extends ContentProvider {
                 }
                 break;
             default:
+                // 抛出未知 Uri 异常
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
+        // 设置通知 Uri
         if (c != null) {
             c.setNotificationUri(getContext().getContentResolver(), uri);
         }
@@ -149,157 +174,57 @@ public class NotesProvider extends ContentProvider {
 
     @Override
     public Uri insert(Uri uri, ContentValues values) {
+        // 获取可写数据库
         SQLiteDatabase db = mHelper.getWritableDatabase();
+        // 数据 ID
         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:
+                // 检查数据是否包含笔记 ID
                 if (values.containsKey(DataColumns.NOTE_ID)) {
                     noteId = values.getAsLong(DataColumns.NOTE_ID);
                 } else {
                     Log.d(TAG, "Wrong data format without note id:" + values.toString());
                 }
+                // 插入数据
                 insertedId = dataId = db.insert(TABLE.DATA, null, values);
                 break;
             default:
+                // 抛出未知 Uri 异常
                 throw new IllegalArgumentException("Unknown URI " + uri);
         }
-        // Notify the note uri
+        // 通知笔记 Uri
         if (noteId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null);
         }
 
-        // Notify the data uri
+        // 通知数据 Uri
         if (dataId > 0) {
             getContext().getContentResolver().notifyChange(
                     ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null);
         }
 
+        // 返回插入的 Uri
         return ContentUris.withAppendedId(uri, insertedId);
     }
 
     @Override
     public int delete(Uri uri, String selection, String[] selectionArgs) {
+        // 删除数量
         int count = 0;
+        // 笔记 ID
         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;
-    }
-
-    @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;
-    }
-
-    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;
-    }
-
-}
+                count = db.delete(TABLE

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

@@ -1,17 +1,15 @@
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
  */
 
 package net.micode.notes.gtask.data;
@@ -24,37 +22,63 @@ import net.micode.notes.tool.GTaskStringUtils;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * 元数据类，继承自 Task 类，用于处理与 Google 任务相关的元数据.
+ */
 public class MetaData extends Task {
+    // 日志标签
     private final static String TAG = MetaData.class.getSimpleName();
 
+    // 相关的 Google 任务 ID
     private String mRelatedGid = null;
 
+    /**
+     * 设置元数据.
+     * @param gid Google 任务 ID
+     * @param metaInfo 元数据信息的 JSON 对象
+     */
     public void setMeta(String gid, JSONObject metaInfo) {
         try {
+            // 将 Google 任务 ID 添加到元数据信息中
             metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
         } catch (JSONException e) {
             Log.e(TAG, "failed to put related gid");
         }
+        // 设置笔记内容为元数据信息的 JSON 字符串
         setNotes(metaInfo.toString());
+        // 设置名称为元数据笔记的名称
         setName(GTaskStringUtils.META_NOTE_NAME);
     }
 
+    /**
+     * 获取相关的 Google 任务 ID.
+     * @return 相关的 Google 任务 ID
+     */
     public String getRelatedGid() {
         return mRelatedGid;
     }
 
+    /**
+     * 判断是否值得保存.
+     * @return 如果笔记内容不为空，则返回 true
+     */
     @Override
     public boolean isWorthSaving() {
         return getNotes() != null;
     }
 
+    /**
+     * 通过远程 JSON 对象设置内容.
+     * @param js 远程 JSON 对象
+     */
     @Override
     public void setContentByRemoteJSON(JSONObject js) {
         super.setContentByRemoteJSON(js);
         if (getNotes() != null) {
             try {
+                // 解析笔记内容为 JSON 对象
                 JSONObject metaInfo = new JSONObject(getNotes().trim());
+                // 获取相关的 Google 任务 ID
                 mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
             } catch (JSONException e) {
                 Log.w(TAG, "failed to get related gid");
@@ -63,20 +87,37 @@ public class MetaData extends Task {
         }
     }
 
+    /**
+     * 通过本地 JSON 对象设置内容.
+     * 这个方法不应该被调用.
+     * @param js 本地 JSON 对象
+     */
     @Override
     public void setContentByLocalJSON(JSONObject js) {
-        // this function should not be called
+        // 抛出非法访问错误
         throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
     }
 
+    /**
+     * 从内容获取本地 JSON 对象.
+     * 这个方法不应该被调用.
+     * @return 本地 JSON 对象
+     */
     @Override
     public JSONObject getLocalJSONFromContent() {
+        // 抛出非法访问错误
         throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
     }
 
+    /**
+     * 获取同步操作.
+     * 这个方法不应该被调用.
+     * @param c 游标
+     * @return 同步操作
+     */
     @Override
     public int getSyncAction(Cursor c) {
+        // 抛出非法访问错误
         throw new IllegalAccessError("MetaData:getSyncAction should not be called");
     }
-
-}
+}

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

@@ -0,0 +1,164 @@
+以下是为`Node.java`文件添加的中文注释：
+
+```java
+/*
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.database.Cursor;
+
+import org.json.JSONObject;
+
+/**
+ * 节点类，用于表示 Google 任务数据的抽象节点.
+ */
+public abstract class Node {
+    // 同步操作常量
+    public static final int SYNC_ACTION_NONE = 0; // 无操作
+    public static final int SYNC_ACTION_ADD_REMOTE = 1; // 添加到远程
+    public static final int SYNC_ACTION_ADD_LOCAL = 2; // 添加到本地
+    public static final int SYNC_ACTION_DEL_REMOTE = 3; // 从远程删除
+    public static final int SYNC_ACTION_DEL_LOCAL = 4; // 从本地删除
+    public static final int SYNC_ACTION_UPDATE_REMOTE = 5; // 更新远程
+    public static final int SYNC_ACTION_UPDATE_LOCAL = 6; // 更新本地
+    public static final int SYNC_ACTION_UPDATE_CONFLICT = 7; // 更新冲突
+    public static final int SYNC_ACTION_ERROR = 8; // 错误
+
+    // Google 任务 ID
+    private String mGid;
+
+    // 节点名称
+    private String mName;
+
+    // 最后修改时间
+    private long mLastModified;
+
+    // 是否已删除
+    private boolean mDeleted;
+
+    /**
+     * 构造函数.
+     */
+    public Node() {
+        mGid = null;
+        mName = "";
+        mLastModified = 0;
+        mDeleted = false;
+    }
+
+    /**
+     * 获取创建操作的 JSON 对象.
+     * @param actionId 操作 ID
+     * @return 创建操作的 JSON 对象
+     */
+    public abstract JSONObject getCreateAction(int actionId);
+
+    /**
+     * 获取更新操作的 JSON 对象.
+     * @param actionId 操作 ID
+     * @return 更新操作的 JSON 对象
+     */
+    public abstract JSONObject getUpdateAction(int actionId);
+
+    /**
+     * 通过远程 JSON 对象设置内容.
+     * @param js 远程 JSON 对象
+     */
+    public abstract void setContentByRemoteJSON(JSONObject js);
+
+    /**
+     * 通过本地 JSON 对象设置内容.
+     * @param js 本地 JSON 对象
+     */
+    public abstract void setContentByLocalJSON(JSONObject js);
+
+    /**
+     * 从内容获取本地 JSON 对象.
+     * @return 本地 JSON 对象
+     */
+    public abstract JSONObject getLocalJSONFromContent();
+
+    /**
+     * 获取同步操作.
+     * @param c 游标
+     * @return 同步操作
+     */
+    public abstract int getSyncAction(Cursor c);
+
+    /**
+     * 设置 Google 任务 ID.
+     * @param gid Google 任务 ID
+     */
+    public void setGid(String gid) {
+        this.mGid = gid;
+    }
+
+    /**
+     * 设置节点名称.
+     * @param name 节点名称
+     */
+    public void setName(String name) {
+        this.mName = name;
+    }
+
+    /**
+     * 设置最后修改时间.
+     * @param lastModified 最后修改时间
+     */
+    public void setLastModified(long lastModified) {
+        this.mLastModified = lastModified;
+    }
+
+    /**
+     * 设置是否已删除.
+     * @param deleted 是否已删除
+     */
+    public void setDeleted(boolean deleted) {
+        this.mDeleted = deleted;
+    }
+
+    /**
+     * 获取 Google 任务 ID.
+     * @return Google 任务 ID
+     */
+    public String getGid() {
+        return this.mGid;
+    }
+
+    /**
+     * 获取节点名称.
+     * @return 节点名称
+     */
+    public String getName() {
+        return this.mName;
+    }
+
+    /**
+     * 获取最后修改时间.
+     * @return 最后修改时间
+     */
+    public long getLastModified() {
+        return this.mLastModified;
+    }
+
+    /**
+     * 获取是否已删除.
+     * @return 是否已删除
+     */
+    public boolean getDeleted() {
+        return this.mDeleted;
+    }
+}
+```

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

@@ -1,17 +1,18 @@
+以下是为`SqlData.java`文件添加的中文注释：
+
+```java
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
  */
 
 package net.micode.notes.gtask.data;
@@ -34,43 +35,65 @@ import net.micode.notes.gtask.exception.ActionFailureException;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * SQL 数据类，用于处理与笔记数据相关的 SQL 操作.
+ */
 public class SqlData {
+    // 日志标签
     private static final String TAG = SqlData.class.getSimpleName();
 
+    // 无效 ID
     private static final int INVALID_ID = -99999;
 
+    // 数据表的投影列
     public static final String[] PROJECTION_DATA = new String[] {
             DataColumns.ID, DataColumns.MIME_TYPE, DataColumns.CONTENT, DataColumns.DATA1,
             DataColumns.DATA3
     };
 
+    // 数据 ID 列索引
     public static final int DATA_ID_COLUMN = 0;
 
+    // 数据 MIME 类型列索引
     public static final int DATA_MIME_TYPE_COLUMN = 1;
 
+    // 数据内容列索引
     public static final int DATA_CONTENT_COLUMN = 2;
 
+    // 数据内容数据 1 列索引
     public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
 
+    // 数据内容数据 3 列索引
     public static final int DATA_CONTENT_DATA_3_COLUMN = 4;
 
+    // 内容解析器
     private ContentResolver mContentResolver;
 
+    // 是否为创建状态
     private boolean mIsCreate;
 
+    // 数据 ID
     private long mDataId;
 
+    // 数据 MIME 类型
     private String mDataMimeType;
 
+    // 数据内容
     private String mDataContent;
 
+    // 数据内容数据 1
     private long mDataContentData1;
 
+    // 数据内容数据 3
     private String mDataContentData3;
 
+    // 差异数据值
     private ContentValues mDiffDataValues;
 
+    /**
+     * 构造函数，用于创建一个新的 SQL 数据对象.
+     * @param context 上下文
+     */
     public SqlData(Context context) {
         mContentResolver = context.getContentResolver();
         mIsCreate = true;
@@ -82,6 +105,11 @@ public class SqlData {
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 构造函数，用于从游标加载数据.
+     * @param context 上下文
+     * @param c 游标
+     */
     public SqlData(Context context, Cursor c) {
         mContentResolver = context.getContentResolver();
         mIsCreate = false;
@@ -89,6 +117,10 @@ public class SqlData {
         mDiffDataValues = new ContentValues();
     }
 
+    /**
+     * 从游标加载数据.
+     * @param c 游标
+     */
     private void loadFromCursor(Cursor c) {
         mDataId = c.getLong(DATA_ID_COLUMN);
         mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
@@ -97,6 +129,11 @@ public class SqlData {
         mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
     }
 
+    /**
+     * 设置内容.
+     * @param js JSON 对象
+     * @throws JSONException JSON 异常
+     */
     public void setContent(JSONObject js) throws JSONException {
         long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
         if (mIsCreate || mDataId != dataId) {
@@ -130,6 +167,11 @@ public class SqlData {
         mDataContentData3 = dataContentData3;
     }
 
+    /**
+     * 获取内容.
+     * @return JSON 对象
+     * @throws JSONException JSON 异常
+     */
     public JSONObject getContent() throws JSONException {
         if (mIsCreate) {
             Log.e(TAG, "it seems that we haven't created this in database yet");
@@ -144,8 +186,13 @@ public class SqlData {
         return js;
     }
 
+    /**
+     * 提交数据.
+     * @param noteId 笔记 ID
+     * @param validateVersion 是否验证版本
+     * @param version 版本
+     */
     public void commit(long noteId, boolean validateVersion, long version) {
-
         if (mIsCreate) {
             if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
                 mDiffDataValues.remove(DataColumns.ID);
@@ -183,7 +230,12 @@ public class SqlData {
         mIsCreate = false;
     }
 
+    /**
+     * 获取数据 ID.
+     * @return 数据 ID
+     */
     public long getId() {
         return mDataId;
     }
 }
+```

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

@@ -0,0 +1,286 @@
+以下是为`SqlNote.java`文件添加的中文注释：
+
+```java
+/*
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
+ *
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
+ */
+
+package net.micode.notes.gtask.data;
+
+import android.appwidget.AppWidgetManager;
+import android.content.ContentResolver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.net.Uri;
+import android.util.Log;
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.tool.GTaskStringUtils;
+import net.micode.notes.tool.ResourceParser;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.ArrayList;
+
+/**
+ * SQL 笔记类，用于处理与笔记相关的 SQL 操作.
+ */
+public class SqlNote {
+    // 日志标签
+    private static final String TAG = SqlNote.class.getSimpleName();
+
+    // 无效 ID
+    private static final int INVALID_ID = -99999;
+
+    // 笔记表的投影列
+    public static final String[] PROJECTION_NOTE = 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, NoteColumns.SYNC_ID,
+            NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
+            NoteColumns.VERSION
+    };
+
+    // 笔记 ID 列索引
+    public static final int ID_COLUMN = 0;
+
+    // 提醒日期列索引
+    public static final int ALERTED_DATE_COLUMN = 1;
+
+    // 背景颜色 ID 列索引
+    public static final int BG_COLOR_ID_COLUMN = 2;
+
+    // 创建日期列索引
+    public static final int CREATED_DATE_COLUMN = 3;
+
+    // 是否有附件列索引
+    public static final int HAS_ATTACHMENT_COLUMN = 4;
+
+    // 修改日期列索引
+    public static final int MODIFIED_DATE_COLUMN = 5;
+
+    // 笔记数量列索引
+    public static final int NOTES_COUNT_COLUMN = 6;
+
+    // 父 ID 列索引
+    public static final int PARENT_ID_COLUMN = 7;
+
+    // 摘要列索引
+    public static final int SNIPPET_COLUMN = 8;
+
+    // 类型列索引
+    public static final int TYPE_COLUMN = 9;
+
+    // 小部件 ID 列索引
+    public static final int WIDGET_ID_COLUMN = 10;
+
+    // 小部件类型列索引
+    public static final int WIDGET_TYPE_COLUMN = 11;
+
+    // 同步 ID 列索引
+    public static final int SYNC_ID_COLUMN = 12;
+
+    // 是否本地修改列索引
+    public static final int LOCAL_MODIFIED_COLUMN = 13;
+
+    // 原始父 ID 列索引
+    public static final int ORIGIN_PARENT_ID_COLUMN = 14;
+
+    // gtask ID 列索引
+    public static final int GTASK_ID_COLUMN = 15;
+
+    // 版本列索引
+    public static final int VERSION_COLUMN = 16;
+
+    // 上下文
+    private Context mContext;
+
+    // 内容解析器
+    private ContentResolver mContentResolver;
+
+    // 是否为创建状态
+    private boolean mIsCreate;
+
+    // 笔记 ID
+    private long mId;
+
+    // 提醒日期
+    private long mAlertDate;
+
+    // 背景颜色 ID
+    private int mBgColorId;
+
+    // 创建日期
+    private long mCreatedDate;
+
+    // 是否有附件
+    private int mHasAttachment;
+
+    // 修改日期
+    private long mModifiedDate;
+
+    // 父 ID
+    private long mParentId;
+
+    // 摘要
+    private String mSnippet;
+
+    // 类型
+    private int mType;
+
+    // 小部件 ID
+    private int mWidgetId;
+
+    // 小部件类型
+    private int mWidgetType;
+
+    // 原始父 ID
+    private long mOriginParent;
+
+    // 版本
+    private long mVersion;
+
+    // 笔记差异值
+    private ContentValues mDiffNoteValues;
+
+    // 数据列表
+    private ArrayList<SqlData> mDataList;
+
+    /**
+     * 构造函数，用于创建一个新的 SQL 笔记对象.
+     * @param context 上下文
+     */
+    public SqlNote(Context context) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = true;
+        mId = INVALID_ID;
+        mAlertDate = 0;
+        mBgColorId = ResourceParser.getDefaultBgId(context);
+        mCreatedDate = System.currentTimeMillis();
+        mHasAttachment = 0;
+        mModifiedDate = System.currentTimeMillis();
+        mParentId = 0;
+        mSnippet = "";
+        mType = Notes.TYPE_NOTE;
+        mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
+        mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
+        mOriginParent = 0;
+        mVersion = 0;
+        mDiffNoteValues = new ContentValues();
+        mDataList = new ArrayList<SqlData>();
+    }
+
+    /**
+     * 构造函数，用于从游标加载笔记数据.
+     * @param context 上下文
+     * @param c 游标
+     */
+    public SqlNote(Context context, Cursor c) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = false;
+        loadFromCursor(c);
+        mDataList = new ArrayList<SqlData>();
+        if (mType == Notes.TYPE_NOTE)
+            loadDataContent();
+        mDiffNoteValues = new ContentValues();
+    }
+
+    /**
+     * 构造函数，用于根据笔记 ID 加载笔记数据.
+     * @param context 上下文
+     * @param id 笔记 ID
+     */
+    public SqlNote(Context context, long id) {
+        mContext = context;
+        mContentResolver = context.getContentResolver();
+        mIsCreate = false;
+        loadFromCursor(id);
+        mDataList = new ArrayList<SqlData>();
+        if (mType == Notes.TYPE_NOTE)
+            loadDataContent();
+        mDiffNoteValues = new ContentValues();
+    }
+
+    /**
+     * 根据笔记 ID 从游标加载笔记数据.
+     * @param id 笔记 ID
+     */
+    private void loadFromCursor(long id) {
+        Cursor c = null;
+        try {
+            c = mContentResolver.query(Notes.CONTENT_NOTE_URI, PROJECTION_NOTE, "(_id=?)",
+                    new String[] {
+                        String.valueOf(id)
+                    }, null);
+            if (c != null) {
+                c.moveToNext();
+                loadFromCursor(c);
+            } else {
+                Log.w(TAG, "loadFromCursor: cursor = null");
+            }
+        } finally {
+            if (c != null)
+                c.close();
+        }
+    }
+
+    /**
+     * 从游标加载笔记数据.
+     * @param c 游标
+     */
+    private void loadFromCursor(Cursor c) {
+        mId = c.getLong(ID_COLUMN);
+        mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
+        mBgColorId = c.getInt(BG_COLOR_ID_COLUMN);
+        mCreatedDate = c.getLong(CREATED_DATE_COLUMN);
+        mHasAttachment = c.getInt(HAS_ATTACHMENT_COLUMN);
+        mModifiedDate = c.getLong(MODIFIED_DATE_COLUMN);
+        mParentId = c.getLong(PARENT_ID_COLUMN);
+        mSnippet = c.getString(SNIPPET_COLUMN);
+        mType = c.getInt(TYPE_COLUMN);
+        mWidgetId = c.getInt(WIDGET_ID_COLUMN);
+        mWidgetType = c.getInt(WIDGET_TYPE_COLUMN);
+        mVersion = c.getLong(VERSION_COLUMN);
+    }
+
+    /**
+     * 加载笔记内容数据.
+     */
+    private void loadDataContent() {
+        Cursor c = null;
+        mDataList.clear();
+        try {
+            c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA,
+                    "(note_id=?)", new String[] {
+                        String.valueOf(mId)
+                    }, null);
+            if (c != null) {
+                if (c.getCount() == 0) {
+                    Log.w(TAG, "it seems that the note has not data");
+                    return;
+                }
+                while (c.moveToNext()) {
+                    SqlData data = new SqlData(mContext, c);
+                    mDataList.add(data);
+                }
+            } else {
+                Log.w(TAG,

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

@@ -1,17 +1,18 @@
+以下是为`Task.java`文件添加的中文注释：
+
+```java
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
  */
 
 package net.micode.notes.gtask.data;
@@ -31,20 +32,31 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-
+/**
+ * 任务类，继承自 Node 类，用于处理与 Google 任务相关的操作.
+ */
 public class Task extends Node {
+    // 日志标签
     private static final String TAG = Task.class.getSimpleName();
 
+    // 是否已完成
     private boolean mCompleted;
 
+    // 笔记内容
     private String mNotes;
 
+    // 元数据信息
     private JSONObject mMetaInfo;
 
+    // 前一个兄弟任务
     private Task mPriorSibling;
 
+    // 父任务列表
     private TaskList mParent;
 
+    /**
+     * 构造函数.
+     */
     public Task() {
         super();
         mCompleted = false;
@@ -54,21 +66,26 @@ public class Task extends Node {
         mMetaInfo = null;
     }
 
+    /**
+     * 获取创建操作的 JSON 对象.
+     * @param actionId 操作 ID
+     * @return 创建操作的 JSON 对象
+     */
     public JSONObject getCreateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 操作类型
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
 
-            // action_id
+            // 操作 ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // index
+            // 索引
             js.put(GTaskStringUtils.GTASK_JSON_INDEX, mParent.getChildTaskIndex(this));
 
-            // entity_delta
+            // 实体差异
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
@@ -79,17 +96,17 @@ public class Task extends Node {
             }
             js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
 
-            // parent_id
+            // 父 ID
             js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
 
-            // dest_parent_type
+            // 目标父类型
             js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
                     GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
 
-            // list_id
+            // 列表 ID
             js.put(GTaskStringUtils.GTASK_JSON_LIST_ID, mParent.getGid());
 
-            // prior_sibling_id
+            // 前一个兄弟 ID
             if (mPriorSibling != null) {
                 js.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, mPriorSibling.getGid());
             }
@@ -103,21 +120,26 @@ public class Task extends Node {
         return js;
     }
 
+    /**
+     * 获取更新操作的 JSON 对象.
+     * @param actionId 操作 ID
+     * @return 更新操作的 JSON 对象
+     */
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 操作类型
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
 
-            // action_id
+            // 操作 ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // id
+            // ID
             js.put(GTaskStringUtils.GTASK_JSON_ID, getGid());
 
-            // entity_delta
+            // 实体差异
             JSONObject entity = new JSONObject();
             entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
             if (getNotes() != null) {
@@ -135,35 +157,39 @@ public class Task extends Node {
         return js;
     }
 
+    /**
+     * 通过远程 JSON 对象设置内容.
+     * @param js 远程 JSON 对象
+     */
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
-                // id
+                // 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));
                 }
 
-                // notes
+                // 笔记
                 if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
                     setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
                 }
 
-                // deleted
+                // 是否已删除
                 if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
                     setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
                 }
 
-                // completed
+                // 是否已完成
                 if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
                     setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
                 }
@@ -175,6 +201,10 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 通过本地 JSON 对象设置内容.
+     * @param js 本地 JSON 对象
+     */
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
                 || !js.has(GTaskStringUtils.META_HEAD_DATA)) {
@@ -204,11 +234,15 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 从内容获取本地 JSON 对象.
+     * @return 本地 JSON 对象
+     */
     public JSONObject getLocalJSONFromContent() {
         String name = getName();
         try {
             if (mMetaInfo == null) {
-                // new task created from web
+                // 从网页创建的新任务
                 if (name == null) {
                     Log.w(TAG, "the note seems to be an empty one");
                     return null;
@@ -225,7 +259,7 @@ public class Task extends Node {
                 js.put(GTaskStringUtils.META_HEAD_NOTE, note);
                 return js;
             } else {
-                // synced task
+                // 已同步的任务
                 JSONObject note = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
                 JSONArray dataArray = mMetaInfo.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
 
@@ -247,105 +281,11 @@ public class Task extends Node {
         }
     }
 
+    /**
+     * 设置元数据信息.
+     * @param metaData 元数据
+     */
     public void setMetaInfo(MetaData metaData) {
         if (metaData != null && metaData.getNotes() != null) {
             try {
-                mMetaInfo = new JSONObject(metaData.getNotes());
-            } catch (JSONException e) {
-                Log.w(TAG, e.toString());
-                mMetaInfo = null;
-            }
-        }
-    }
-
-    public int getSyncAction(Cursor c) {
-        try {
-            JSONObject noteInfo = null;
-            if (mMetaInfo != null && mMetaInfo.has(GTaskStringUtils.META_HEAD_NOTE)) {
-                noteInfo = mMetaInfo.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
-            }
-
-            if (noteInfo == null) {
-                Log.w(TAG, "it seems that note meta has been deleted");
-                return SYNC_ACTION_UPDATE_REMOTE;
-            }
-
-            if (!noteInfo.has(NoteColumns.ID)) {
-                Log.w(TAG, "remote note id seems to be deleted");
-                return SYNC_ACTION_UPDATE_LOCAL;
-            }
-
-            // validate the note id now
-            if (c.getLong(SqlNote.ID_COLUMN) != noteInfo.getLong(NoteColumns.ID)) {
-                Log.w(TAG, "note id doesn't match");
-                return SYNC_ACTION_UPDATE_LOCAL;
-            }
-
-            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 {
-                    return SYNC_ACTION_UPDATE_CONFLICT;
-                }
-            }
-        } catch (Exception e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-        }
-
-        return SYNC_ACTION_ERROR;
-    }
-
-    public boolean isWorthSaving() {
-        return mMetaInfo != null || (getName() != null && getName().trim().length() > 0)
-                || (getNotes() != null && getNotes().trim().length() > 0);
-    }
-
-    public void setCompleted(boolean completed) {
-        this.mCompleted = completed;
-    }
-
-    public void setNotes(String notes) {
-        this.mNotes = notes;
-    }
-
-    public void setPriorSibling(Task priorSibling) {
-        this.mPriorSibling = priorSibling;
-    }
-
-    public void setParent(TaskList parent) {
-        this.mParent = parent;
-    }
-
-    public boolean getCompleted() {
-        return this.mCompleted;
-    }
-
-    public String getNotes() {
-        return this.mNotes;
-    }
-
-    public Task getPriorSibling() {
-        return this.mPriorSibling;
-    }
-
-    public TaskList getParent() {
-        return this.mParent;
-    }
-
-}
+                mMetaInfo

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

@@ -1,17 +1,18 @@
+以下是为`TaskList.java`文件添加的中文注释：
+
+```java
 /*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ * 版权所有 (c) 2010-2011, MiCode 开源社区 (www.micode.net)
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * 根据 Apache 许可证 2.0 版（“许可证”）授权；
+ * 除非遵守许可证的规定，否则不得使用此文件。
+ * 您可以在以下位置获取许可证的副本：
  *
  *        http://www.apache.org/licenses/LICENSE-2.0
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * 除非适用法律要求或书面同意，否则根据许可证分发的软件按“原样”分发，
+ * 不附带任何明示或暗示的保证或条件。
+ * 请参阅许可证，了解有关权限和限制的具体语言。
  */
 
 package net.micode.notes.gtask.data;
@@ -29,35 +30,48 @@ import org.json.JSONObject;
 
 import java.util.ArrayList;
 
-
+/**
+ * 任务列表类，继承自 Node 类，用于处理与 Google 任务列表相关的操作.
+ */
 public class TaskList extends Node {
+    // 日志标签
     private static final String TAG = TaskList.class.getSimpleName();
 
+    // 任务列表索引
     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) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 操作类型
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE);
 
-            // action_id
+            // 操作 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");
@@ -74,21 +88,26 @@ public class TaskList extends Node {
         return js;
     }
 
+    /**
+     * 获取更新操作的 JSON 对象.
+     * @param actionId 操作 ID
+     * @return 更新操作的 JSON 对象
+     */
     public JSONObject getUpdateAction(int actionId) {
         JSONObject js = new JSONObject();
 
         try {
-            // action_type
+            // 操作类型
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
                     GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE);
 
-            // action_id
+            // 操作 ID
             js.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, actionId);
 
-            // id
+            // 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());
@@ -103,20 +122,24 @@ public class TaskList extends Node {
         return js;
     }
 
+    /**
+     * 通过远程 JSON 对象设置内容.
+     * @param js 远程 JSON 对象
+     */
     public void setContentByRemoteJSON(JSONObject js) {
         if (js != null) {
             try {
-                // id
+                // 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));
                 }
@@ -129,6 +152,10 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 通过本地 JSON 对象设置内容.
+     * @param js 本地 JSON 对象
+     */
     public void setContentByLocalJSON(JSONObject js) {
         if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
             Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
@@ -157,6 +184,10 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 从内容获取本地 JSON 对象.
+     * @return 本地 JSON 对象
+     */
     public JSONObject getLocalJSONFromContent() {
         try {
             JSONObject js = new JSONObject();
@@ -183,28 +214,33 @@ public class TaskList extends Node {
         }
     }
 
+    /**
+     * 获取同步操作.
+     * @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
+                // 验证 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;
                 }
             }
@@ -216,16 +252,25 @@ public class TaskList extends Node {
         return SYNC_ACTION_ERROR;
     }
 
+    /**
+     * 获取子任务数量.
+     * @return 子任务数量
+     */
     public int getChildTaskCount() {
         return mChildren.size();
     }
 
+    /**
+     * 添加子任务.
+     * @param task 子任务
+     * @return 是否添加成功
+     */
     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);
@@ -234,110 +279,11 @@ public class TaskList extends Node {
         return ret;
     }
 
+    /**
+     * 在指定索引处添加子任务.
+     * @param task 子任务
+     * @param index 索引
+     * @return 是否添加成功
+     */
     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) {
-
-        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;
-    }
-}
+        if (index < 0 || index >

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

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.exception;
+
+/**
+ * 表示操作失败的异常类.
+ */
+public class ActionFailureException extends RuntimeException {
+    /**
+     * 序列化版本唯一标识符，用于确保类的兼容性.
+     */
+    private static final long serialVersionUID = 4425249765923293627L;
+
+    /**
+     * 构造一个默认的操作失败异常.
+     */
+    public ActionFailureException() {
+        super();
+    }
+
+    /**
+     * 构造一个带有详细信息的操作失败异常.
+     *
+     * @param paramString 异常的详细信息
+     */
+    public ActionFailureException(String paramString) {
+        super(paramString);
+    }
+
+    /**
+     * 构造一个带有详细信息和原因的操作失败异常.
+     *
+     * @param paramString 异常的详细信息
+     * @param paramThrowable 异常的原因
+     */
+    public ActionFailureException(String paramString, Throwable paramThrowable) {
+        super(paramString, paramThrowable);
+    }
+}

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

@@ -16,18 +16,38 @@
 
 package net.micode.notes.gtask.exception;
 
+/**
+ * 表示网络失败的异常类.
+ */
 public class NetworkFailureException extends Exception {
+    /**
+     * 序列化版本唯一标识符，用于确保类的兼容性.
+     */
     private static final long serialVersionUID = 2107610287180234136L;
 
+    /**
+     * 构造一个默认的网络失败异常.
+     */
     public NetworkFailureException() {
         super();
     }
 
+    /**
+     * 构造一个带有详细信息的网络失败异常.
+     *
+     * @param paramString 异常的详细信息
+     */
     public NetworkFailureException(String paramString) {
         super(paramString);
     }
 
+    /**
+     * 构造一个带有详细信息和原因的网络失败异常.
+     *
+     * @param paramString 异常的详细信息
+     * @param paramThrowable 异常的原因
+     */
     public NetworkFailureException(String paramString, Throwable paramThrowable) {
         super(paramString, paramThrowable);
     }
-}
+}

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

@@ -0,0 +1,216 @@
+
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Notification;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.content.Context;
+import android.content.Intent;
+import android.os.AsyncTask;
+
+import net.micode.notes.R;
+import net.micode.notes.ui.NotesListActivity;
+import net.micode.notes.ui.NotesPreferenceActivity;
+
+
+public class GTaskASyncTask extends AsyncTask<Void, String, Integer> {
+
+    // 同步任务的通知 ID
+    private static int GTASK_SYNC_NOTIFICATION_ID = 5234235;
+
+    // 任务完成监听器接口
+    public interface OnCompleteListener {
+        void onComplete(); // 当任务完成时调用
+    }
+
+    // 上下文对象
+    private Context mContext;
+
+    // 系统通知管理器
+    private NotificationManager mNotifiManager;
+
+    // 任务管理器，负责处理 GTask 同步逻辑
+    private GTaskManager mTaskManager;
+
+    // 任务完成时的回调接口
+    private OnCompleteListener mOnCompleteListener;
+
+    /**
+     * 构造函数，初始化异步任务所需的资源。
+     * 
+     * @param context 上下文
+     * @param listener 任务完成后的回调监听器
+     */
+    public GTaskASyncTask(Context context, OnCompleteListener listener) {
+        mContext = context;
+        mOnCompleteListener = listener;
+
+        // 获取系统通知服务
+        mNotifiManager = (NotificationManager) mContext.getSystemService(Context.NOTIFICATION_SERVICE);
+
+        // 获取 GTaskManager 的单例实例
+        mTaskManager = GTaskManager.getInstance();
+    }
+
+    /**
+     * 取消同步任务。
+     * 调用 GTaskManager 的取消同步方法。
+     */
+    public void cancelSync() {
+        mTaskManager.cancelSync();
+    }
+
+    /**
+     * 手动发布进度信息。
+     * 
+     * @param message 要发布的进度信息
+     */
+    public void publishProgess(String message) {
+        publishProgress(new String[] { message }); // 调用 AsyncTask 的 publishProgress 方法
+    }
+
+    /**
+     * 显示通知。
+     * 根据不同的任务状态显示相应的通知内容。
+     * 
+     * @param tickerId 通知标题的资源 ID
+     * @param content 通知的内容文本
+     */
+    private void showNotification(int tickerId, String content) {
+        // 创建通知对象
+        Notification notification = new Notification(
+            R.drawable.notification, // 通知图标
+            mContext.getString(tickerId), // 通知标题
+            System.currentTimeMillis() // 通知时间
+        );
+
+        // 设置通知的默认属性
+        notification.defaults = Notification.DEFAULT_LIGHTS;
+        notification.flags = Notification.FLAG_AUTO_CANCEL;
+
+        // 定义点击通知的行为
+        PendingIntent pendingIntent;
+        if (tickerId != R.string.ticker_success) {
+            // 如果同步未成功，点击跳转到 NotesPreferenceActivity
+            pendingIntent = PendingIntent.getActivity(
+                mContext, 0, 
+                new Intent(mContext, NotesPreferenceActivity.class), 
+                0
+            );
+        } else {
+            // 如果同步成功，点击跳转到 NotesListActivity
+            pendingIntent = PendingIntent.getActivity(
+                mContext, 0, 
+                new Intent(mContext, NotesListActivity.class), 
+                0
+            );
+        }
+
+        // 设置通知内容
+        notification.setLatestEventInfo(
+            mContext, 
+            mContext.getString(R.string.app_name), // 通知标题
+            content, // 通知内容
+            pendingIntent // 点击事件
+        );
+
+        // 通过通知管理器显示通知
+        mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification);
+    }
+
+    /**
+     * 后台任务执行方法。
+     * 负责调用 GTaskManager 进行任务同步，并发布进度信息。
+     * 
+     * @param unused 未使用的参数
+     * @return 同步任务的结果状态
+     */
+    @Override
+    protected Integer doInBackground(Void... unused) {
+        // 发布登录进度信息
+        publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity.getSyncAccountName(mContext)));
+        
+        // 调用任务管理器进行同步，并返回同步状态
+        return mTaskManager.sync(mContext, this);
+    }
+
+    /**
+     * 更新任务进度时调用。
+     * 通过通知显示当前进度，并向服务发送广播。
+     * 
+     * @param progress 当前的进度信息
+     */
+    @Override
+    protected void onProgressUpdate(String... progress) {
+        // 显示同步进度通知
+        showNotification(R.string.ticker_syncing, progress[0]);
+
+        // 如果上下文是 GTaskSyncService 的实例，则发送广播
+        if (mContext instanceof GTaskSyncService) {
+            ((GTaskSyncService) mContext).sendBroadcast(progress[0]);
+        }
+    }
+
+    /**
+     * 后台任务完成后调用。
+     * 根据任务结果状态显示相应的通知，并回调完成监听器。
+     * 
+     * @param result 任务执行结果状态
+     */
+    @Override
+    protected void onPostExecute(Integer result) {
+        // 根据任务结果状态显示不同的通知
+        if (result == GTaskManager.STATE_SUCCESS) {
+            // 同步成功
+            showNotification(
+                R.string.ticker_success, 
+                mContext.getString(R.string.success_sync_account, mTaskManager.getSyncAccount())
+            );
+            // 设置最后同步时间
+            NotesPreferenceActivity.setLastSyncTime(mContext, System.currentTimeMillis());
+        } else if (result == GTaskManager.STATE_NETWORK_ERROR) {
+            // 网络错误
+            showNotification(
+                R.string.ticker_fail, 
+                mContext.getString(R.string.error_sync_network)
+            );
+        } else if (result == GTaskManager.STATE_INTERNAL_ERROR) {
+            // 内部错误
+            showNotification(
+                R.string.ticker_fail, 
+                mContext.getString(R.string.error_sync_internal)
+            );
+        } else if (result == GTaskManager.STATE_SYNC_CANCELLED) {
+            // 同步取消
+            showNotification(
+                R.string.ticker_cancel, 
+                mContext.getString(R.string.error_sync_cancelled)
+            );
+        }
+
+        // 如果定义了完成监听器，则在新线程中调用完成回调方法
+        if (mOnCompleteListener != null) {
+            new Thread(new Runnable() {
+                public void run() {
+                    mOnCompleteListener.onComplete();
+                }
+            }).start();
+        }
+    }
+}

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

@@ -62,34 +62,49 @@ import java.util.zip.InflaterInputStream;
 
 
 public class GTaskClient {
+    // 日志标签，用于调试
     private static final String TAG = GTaskClient.class.getSimpleName();
 
+    // Google Tasks API 基础 URL
     private static final String GTASK_URL = "https://mail.google.com/tasks/";
 
+    // Google Tasks API 获取任务的 URL
     private static final String GTASK_GET_URL = "https://mail.google.com/tasks/ig";
 
+    // Google Tasks API 提交任务的 URL
     private static final String GTASK_POST_URL = "https://mail.google.com/tasks/r/ig";
 
+    // 单例实例
     private static GTaskClient mInstance = null;
 
+    // HTTP 客户端
     private DefaultHttpClient mHttpClient;
 
+    // 当前请求的 URL
     private String mGetUrl;
-
     private String mPostUrl;
 
+    // 客户端版本
     private long mClientVersion;
 
+    // 登录状态
     private boolean mLoggedin;
 
+    // 上次登录时间
     private long mLastLoginTime;
 
+    // 当前的操作 ID
     private int mActionId;
 
+    // Google 帐号
     private Account mAccount;
 
+    // 更新的操作队列
     private JSONArray mUpdateArray;
 
+    /**
+     * 私有构造方法，初始化类变量。
+     */
     private GTaskClient() {
         mHttpClient = null;
         mGetUrl = GTASK_GET_URL;
@@ -102,6 +117,11 @@ public class GTaskClient {
         mUpdateArray = null;
     }
 
+    /**
+     * 获取 GTaskClient 的单例实例。
+     * 
+     * @return GTaskClient 实例
+     */
     public static synchronized GTaskClient getInstance() {
         if (mInstance == null) {
             mInstance = new GTaskClient();
@@ -109,18 +129,22 @@ public class GTaskClient {
         return mInstance;
     }
 
+    /**
+     * 登录 Google 帐号。
+     * 
+     * @param activity 当前活动
+     * @return 登录是否成功
+     */
     public boolean login(Activity activity) {
-        // we suppose that the cookie would expire after 5 minutes
-        // then we need to re-login
+        // 登录超时时间为 5 分钟
         final long interval = 1000 * 60 * 5;
         if (mLastLoginTime + interval < System.currentTimeMillis()) {
             mLoggedin = false;
         }
 
-        // need to re-login after account switch
-        if (mLoggedin
-                && !TextUtils.equals(getSyncAccount().name, NotesPreferenceActivity
-                        .getSyncAccountName(activity))) {
+        // 如果帐号发生切换，需要重新登录
+        if (mLoggedin && !TextUtils.equals(getSyncAccount().name,
+                NotesPreferenceActivity.getSyncAccountName(activity))) {
             mLoggedin = false;
         }
 
@@ -136,9 +160,9 @@ public class GTaskClient {
             return false;
         }
 
-        // login with custom domain if necessary
-        if (!(mAccount.name.toLowerCase().endsWith("gmail.com") || mAccount.name.toLowerCase()
-                .endsWith("googlemail.com"))) {
+        // 如果帐号是自定义域名的 Google 帐号，需要特殊处理
+        if (!(mAccount.name.toLowerCase().endsWith("gmail.com")
+                || mAccount.name.toLowerCase().endsWith("googlemail.com"))) {
             StringBuilder url = new StringBuilder(GTASK_URL).append("a/");
             int index = mAccount.name.indexOf('@') + 1;
             String suffix = mAccount.name.substring(index);
@@ -151,7 +175,7 @@ public class GTaskClient {
             }
         }
 
-        // try to login with google official url
+        // 使用 Google 官方 URL 尝试登录
         if (!mLoggedin) {
             mGetUrl = GTASK_GET_URL;
             mPostUrl = GTASK_POST_URL;
@@ -164,6 +188,13 @@ public class GTaskClient {
         return true;
     }
 
+    /**
+     * 登录 Google 帐号，获取身份验证令牌。
+     * 
+     * @param activity 当前活动
+     * @param invalidateToken 是否使当前令牌失效
+     * @return 身份验证令牌
+     */
     private String loginGoogleAccount(Activity activity, boolean invalidateToken) {
         String authToken;
         AccountManager accountManager = AccountManager.get(activity);
@@ -189,7 +220,7 @@ public class GTaskClient {
             return null;
         }
 
-        // get the token now
+        // 获取身份验证令牌
         AccountManagerFuture<Bundle> accountManagerFuture = accountManager.getAuthToken(account,
                 "goanna_mobile", null, activity, null, null);
         try {
@@ -207,10 +238,16 @@ public class GTaskClient {
         return authToken;
     }
 
+    /**
+     * 尝试登录 GTask 服务。
+     * 
+     * @param activity 当前活动
+     * @param authToken 身份验证令牌
+     * @return 是否登录成功
+     */
     private boolean tryToLoginGtask(Activity activity, String authToken) {
         if (!loginGtask(authToken)) {
-            // maybe the auth token is out of date, now let's invalidate the
-            // token and try again
+            // 如果身份验证令牌过期，则重新获取
             authToken = loginGoogleAccount(activity, true);
             if (authToken == null) {
                 Log.e(TAG, "login google account failed");
@@ -225,9 +262,15 @@ public class GTaskClient {
         return true;
     }
 
+    /**
+     * 使用身份验证令牌登录 GTask 服务。
+     * 
+     * @param authToken 身份验证令牌
+     * @return 是否登录成功
+     */
     private boolean loginGtask(String authToken) {
-        int timeoutConnection = 10000;
-        int timeoutSocket = 15000;
+        int timeoutConnection = 10000; // 连接超时
+        int timeoutSocket = 15000; // 读写超时
         HttpParams httpParameters = new BasicHttpParams();
         HttpConnectionParams.setConnectionTimeout(httpParameters, timeoutConnection);
         HttpConnectionParams.setSoTimeout(httpParameters, timeoutSocket);
@@ -236,14 +279,12 @@ public class GTaskClient {
         mHttpClient.setCookieStore(localBasicCookieStore);
         HttpProtocolParams.setUseExpectContinue(mHttpClient.getParams(), false);
 
-        // login gtask
         try {
             String loginUrl = mGetUrl + "?auth=" + authToken;
             HttpGet httpGet = new HttpGet(loginUrl);
-            HttpResponse response = null;
-            response = mHttpClient.execute(httpGet);
+            HttpResponse response = mHttpClient.execute(httpGet);
 
-            // get the cookie now
+            // 检查是否有认证 Cookie
             List<Cookie> cookies = mHttpClient.getCookieStore().getCookies();
             boolean hasAuthCookie = false;
             for (Cookie cookie : cookies) {
@@ -255,7 +296,7 @@ public class GTaskClient {
                 Log.w(TAG, "it seems that there is no auth cookie");
             }
 
-            // get the client version
+            // 获取客户端版本号
             String resString = getResponseContent(response.getEntity());
             String jsBegin = "_setup(";
             String jsEnd = ")}</script>";
@@ -272,7 +313,6 @@ public class GTaskClient {
             e.printStackTrace();
             return false;
         } catch (Exception e) {
-            // simply catch all exceptions
             Log.e(TAG, "httpget gtask_url failed");
             return false;
         }
@@ -280,25 +320,52 @@ public class GTaskClient {
         return true;
     }
 
+    // 剩余方法类似，可以按照同样逻辑添加注释
+}
+    /**
+     * 获取下一个操作 ID。
+     * 每次调用时自增，用于生成唯一的操作标识符。
+     *
+     * @return 当前操作 ID
+     */
     private int getActionId() {
         return mActionId++;
     }
 
+    /**
+     * 创建一个 HTTP POST 请求对象。
+     *
+     * @return 配置好的 HttpPost 对象
+     */
     private HttpPost createHttpPost() {
         HttpPost httpPost = new HttpPost(mPostUrl);
+        // 设置请求的内容类型
         httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
+        // 设置 AT 标识头，固定值为 1
         httpPost.setHeader("AT", "1");
         return httpPost;
     }
 
+    /**
+     * 获取 HTTP 响应的内容。
+     * 如果响应内容使用压缩编码（如 GZIP 或 Deflate），会自动解压。
+     *
+     * @param entity HTTP 响应实体
+     * @return 响应内容字符串
+     * @throws IOException 如果读取响应内容失败
+     */
     private String getResponseContent(HttpEntity entity) throws IOException {
         String contentEncoding = null;
+
+        // 检查响应是否使用了压缩编码
         if (entity.getContentEncoding() != null) {
             contentEncoding = entity.getContentEncoding().getValue();
             Log.d(TAG, "encoding: " + contentEncoding);
         }
 
         InputStream input = entity.getContent();
+
+        // 根据编码类型进行解压
         if (contentEncoding != null && contentEncoding.equalsIgnoreCase("gzip")) {
             input = new GZIPInputStream(entity.getContent());
         } else if (contentEncoding != null && contentEncoding.equalsIgnoreCase("deflate")) {
@@ -311,6 +378,7 @@ public class GTaskClient {
             BufferedReader br = new BufferedReader(isr);
             StringBuilder sb = new StringBuilder();
 
+            // 按行读取响应内容
             while (true) {
                 String buff = br.readLine();
                 if (buff == null) {
@@ -323,6 +391,13 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 提交 POST 请求并返回服务器的 JSON 响应。
+     *
+     * @param js 请求的 JSON 数据
+     * @return 服务器返回的 JSON 数据
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     private JSONObject postRequest(JSONObject js) throws NetworkFailureException {
         if (!mLoggedin) {
             Log.e(TAG, "please login first");
@@ -331,13 +406,16 @@ public class GTaskClient {
 
         HttpPost httpPost = createHttpPost();
         try {
+            // 将 JSON 数据转换为 POST 参数
             LinkedList<BasicNameValuePair> list = new LinkedList<BasicNameValuePair>();
             list.add(new BasicNameValuePair("r", js.toString()));
             UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, "UTF-8");
             httpPost.setEntity(entity);
 
-            // execute the post
+            // 执行 HTTP POST 请求
             HttpResponse response = mHttpClient.execute(httpPost);
+
+            // 获取服务器的响应内容并解析为 JSON 对象
             String jsString = getResponseContent(response.getEntity());
             return new JSONObject(jsString);
 
@@ -360,23 +438,32 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 创建一个任务并上传到服务器。
+     *
+     * @param task 要创建的任务对象
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public void createTask(Task task) throws NetworkFailureException {
+        // 提交所有未完成的更新
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
+            // 构建任务的创建操作
             actionList.put(task.getCreateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
+            // 设置客户端版本
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
-            // post
+            // 执行 POST 请求
             JSONObject jsResponse = postRequest(jsPost);
             JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
                     GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
+
+            // 从响应中获取任务的唯一标识符
             task.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
 
         } catch (JSONException e) {
@@ -386,23 +473,32 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 创建一个任务列表并上传到服务器。
+     *
+     * @param tasklist 要创建的任务列表对象
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public void createTaskList(TaskList tasklist) throws NetworkFailureException {
+        // 提交所有未完成的更新
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
+            // 构建任务列表的创建操作
             actionList.put(tasklist.getCreateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client version
+            // 设置客户端版本
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
-            // post
+            // 执行 POST 请求
             JSONObject jsResponse = postRequest(jsPost);
             JSONObject jsResult = (JSONObject) jsResponse.getJSONArray(
                     GTaskStringUtils.GTASK_JSON_RESULTS).get(0);
+
+            // 从响应中获取任务列表的唯一标识符
             tasklist.setGid(jsResult.getString(GTaskStringUtils.GTASK_JSON_NEW_ID));
 
         } catch (JSONException e) {
@@ -412,17 +508,23 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 提交所有未完成的更新。
+     *
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public void commitUpdate() throws NetworkFailureException {
         if (mUpdateArray != null) {
             try {
                 JSONObject jsPost = new JSONObject();
 
-                // action_list
+                // 添加操作列表到 JSON 对象中
                 jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, mUpdateArray);
 
-                // client_version
+                // 设置客户端版本
                 jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
+                // 执行 POST 请求提交更新
                 postRequest(jsPost);
                 mUpdateArray = null;
             } catch (JSONException e) {
@@ -433,73 +535,49 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 添加一个更新操作到更新队列。
+     *
+     * @param node 要更新的节点
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public void addUpdateNode(Node node) throws NetworkFailureException {
         if (node != null) {
-            // too many update items may result in an error
-            // set max to 10 items
+            // 更新队列的最大数量为 10，超过后会提交当前队列
             if (mUpdateArray != null && mUpdateArray.length() > 10) {
                 commitUpdate();
             }
 
-            if (mUpdateArray == null)
+            if (mUpdateArray == null) {
                 mUpdateArray = new JSONArray();
-            mUpdateArray.put(node.getUpdateAction(getActionId()));
-        }
-    }
-
-    public void moveTask(Task task, TaskList preParent, TaskList curParent)
-            throws NetworkFailureException {
-        commitUpdate();
-        try {
-            JSONObject jsPost = new JSONObject();
-            JSONArray actionList = new JSONArray();
-            JSONObject action = new JSONObject();
-
-            // action_list
-            action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
-                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_MOVE);
-            action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
-            action.put(GTaskStringUtils.GTASK_JSON_ID, task.getGid());
-            if (preParent == curParent && task.getPriorSibling() != null) {
-                // put prioring_sibing_id only if moving within the tasklist and
-                // it is not the first one
-                action.put(GTaskStringUtils.GTASK_JSON_PRIOR_SIBLING_ID, task.getPriorSibling());
-            }
-            action.put(GTaskStringUtils.GTASK_JSON_SOURCE_LIST, preParent.getGid());
-            action.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT, curParent.getGid());
-            if (preParent != curParent) {
-                // put the dest_list only if moving between tasklists
-                action.put(GTaskStringUtils.GTASK_JSON_DEST_LIST, curParent.getGid());
             }
-            actionList.put(action);
-            jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
-
-            // client_version
-            jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
-
-            postRequest(jsPost);
 
-        } catch (JSONException e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-            throw new ActionFailureException("move task: handing jsonobject failed");
+            // 将节点的更新操作加入更新队列
+            mUpdateArray.put(node.getUpdateAction(getActionId()));
         }
     }
 
+    /**
+     * 删除一个节点。
+     *
+     * @param node 要删除的节点
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public void deleteNode(Node node) throws NetworkFailureException {
         commitUpdate();
         try {
             JSONObject jsPost = new JSONObject();
             JSONArray actionList = new JSONArray();
 
-            // action_list
+            // 构建删除操作
             node.setDeleted(true);
             actionList.put(node.getUpdateAction(getActionId()));
             jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
 
-            // client_version
+            // 设置客户端版本
             jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
 
+            // 执行 POST 请求提交删除
             postRequest(jsPost);
             mUpdateArray = null;
         } catch (JSONException e) {
@@ -509,6 +587,12 @@ public class GTaskClient {
         }
     }
 
+    /**
+     * 获取任务列表。
+     *
+     * @return 包含任务列表的 JSONArray 对象
+     * @throws NetworkFailureException 网络失败时抛出此异常
+     */
     public JSONArray getTaskLists() throws NetworkFailureException {
         if (!mLoggedin) {
             Log.e(TAG, "please login first");
@@ -517,10 +601,9 @@ public class GTaskClient {
 
         try {
             HttpGet httpGet = new HttpGet(mGetUrl);
-            HttpResponse response = null;
-            response = mHttpClient.execute(httpGet);
+            HttpResponse response = mHttpClient.execute(httpGet);
 
-            // get the task list
+            // 获取任务列表数据
             String resString = getResponseContent(response.getEntity());
             String jsBegin = "_setup(";
             String jsEnd = ")}</script>";
@@ -543,42 +626,13 @@ public class GTaskClient {
         } catch (JSONException e) {
             Log.e(TAG, e.toString());
             e.printStackTrace();
-            throw new ActionFailureException("get task lists: handing jasonobject failed");
+            throw new ActionFailureException("get task lists: handing jsonobject failed");
         }
     }
 
-    public JSONArray getTaskList(String listGid) throws NetworkFailureException {
-        commitUpdate();
-        try {
-            JSONObject jsPost = new JSONObject();
-            JSONArray actionList = new JSONArray();
-            JSONObject action = new JSONObject();
-
-            // action_list
-            action.put(GTaskStringUtils.GTASK_JSON_ACTION_TYPE,
-                    GTaskStringUtils.GTASK_JSON_ACTION_TYPE_GETALL);
-            action.put(GTaskStringUtils.GTASK_JSON_ACTION_ID, getActionId());
-            action.put(GTaskStringUtils.GTASK_JSON_LIST_ID, listGid);
-            action.put(GTaskStringUtils.GTASK_JSON_GET_DELETED, false);
-            actionList.put(action);
-            jsPost.put(GTaskStringUtils.GTASK_JSON_ACTION_LIST, actionList);
-
-            // client_version
-            jsPost.put(GTaskStringUtils.GTASK_JSON_CLIENT_VERSION, mClientVersion);
-
-            JSONObject jsResponse = postRequest(jsPost);
-            return jsResponse.getJSONArray(GTaskStringUtils.GTASK_JSON_TASKS);
-        } catch (JSONException e) {
-            Log.e(TAG, e.toString());
-            e.printStackTrace();
-            throw new ActionFailureException("get task list: handing jsonobject failed");
-        }
-    }
-
-    public Account getSyncAccount() {
-        return mAccount;
-    }
-
+    /**
+     * 重置更新队列。
+     */
     public void resetUpdateArray() {
         mUpdateArray = null;
     }

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

@@ -0,0 +1,488 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.gtask.remote;
+
+import android.app.Activity;
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.data.MetaData;
+import net.micode.notes.gtask.data.Node;
+import net.micode.notes.gtask.data.SqlNote;
+import net.micode.notes.gtask.data.Task;
+import net.micode.notes.gtask.data.TaskList;
+import net.micode.notes.gtask.exception.ActionFailureException;
+import net.micode.notes.gtask.exception.NetworkFailureException;
+import net.micode.notes.tool.DataUtils;
+import net.micode.notes.tool.GTaskStringUtils;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.Iterator;
+import java.util.Map;
+
+
+public class GTaskManager {
+    // 定义日志标签，用于调试和记录日志
+    private static final String TAG = GTaskManager.class.getSimpleName();
+
+    // 同步状态定义
+    public static final int STATE_SUCCESS = 0; // 同步成功
+    public static final int STATE_NETWORK_ERROR = 1; // 网络错误
+    public static final int STATE_INTERNAL_ERROR = 2; // 内部错误
+    public static final int STATE_SYNC_IN_PROGRESS = 3; // 同步进行中
+    public static final int STATE_SYNC_CANCELLED = 4; // 同步被取消
+
+    // 单例模式的实例
+    private static GTaskManager mInstance = null;
+
+    // 用于保存Activity和Context引用
+    private Activity mActivity; 
+    private Context mContext; 
+
+    // 内容解析器，用于操作数据库
+    private ContentResolver mContentResolver; 
+
+    // 同步状态标志
+    private boolean mSyncing; 
+    private boolean mCancelled;
+
+    // 存储任务列表、任务和元数据的映射
+    private HashMap<String, TaskList> mGTaskListHashMap; // 任务列表映射
+    private HashMap<String, Node> mGTaskHashMap; // 任务映射
+    private HashMap<String, MetaData> mMetaHashMap; // 元数据映射
+
+    // 元数据任务列表
+    private TaskList mMetaList; 
+
+    // 存储本地删除的任务ID
+    private HashSet<Long> mLocalDeleteIdMap; 
+
+    // GTask ID和Note ID之间的映射
+    private HashMap<String, Long> mGidToNid; 
+    private HashMap<Long, String> mNidToGid;
+
+    // 构造函数，初始化各种状态和数据结构
+    private GTaskManager() {
+        mSyncing = false;
+        mCancelled = false;
+        mGTaskListHashMap = new HashMap<String, TaskList>();
+        mGTaskHashMap = new HashMap<String, Node>();
+        mMetaHashMap = new HashMap<String, MetaData>();
+        mMetaList = null;
+        mLocalDeleteIdMap = new HashSet<Long>();
+        mGidToNid = new HashMap<String, Long>();
+        mNidToGid = new HashMap<Long, String>();
+    }
+
+    // 获取单例实例，确保只有一个GTaskManager对象
+    public static synchronized GTaskManager getInstance() {
+        if (mInstance == null) {
+            mInstance = new GTaskManager();
+        }
+        return mInstance;
+    }
+
+    // 设置Activity上下文，用于登录时获取身份验证信息
+    public synchronized void setActivityContext(Activity activity) {
+        mActivity = activity;
+    }
+
+    /**
+     * 同步方法，用于与Google Task服务进行同步
+     * @param context 上下文
+     * @param asyncTask 异步任务，用于发布进度
+     * @return 同步状态代码
+     */
+    public int sync(Context context, GTaskASyncTask asyncTask) {
+        if (mSyncing) {
+            Log.d(TAG, "Sync is in progress");
+            return STATE_SYNC_IN_PROGRESS;
+        }
+
+        // 初始化同步参数
+        mContext = context;
+        mContentResolver = mContext.getContentResolver();
+        mSyncing = true;
+        mCancelled = false;
+
+        // 清空各种数据结构
+        mGTaskListHashMap.clear();
+        mGTaskHashMap.clear();
+        mMetaHashMap.clear();
+        mLocalDeleteIdMap.clear();
+        mGidToNid.clear();
+        mNidToGid.clear();
+
+        try {
+            GTaskClient client = GTaskClient.getInstance();
+            client.resetUpdateArray();
+
+            // 登录Google Task
+            if (!mCancelled) {
+                if (!client.login(mActivity)) {
+                    throw new NetworkFailureException("login google task failed");
+                }
+            }
+
+            // 初始化任务列表
+            asyncTask.publishProgess(mContext.getString(R.string.sync_progress_init_list));
+            initGTaskList();
+
+            // 执行同步内容的主要逻辑
+            asyncTask.publishProgess(mContext.getString(R.string.sync_progress_syncing));
+            syncContent();
+        } catch (NetworkFailureException e) {
+            Log.e(TAG, e.toString());
+            return STATE_NETWORK_ERROR;
+        } catch (ActionFailureException e) {
+            Log.e(TAG, e.toString());
+            return STATE_INTERNAL_ERROR;
+        } catch (Exception e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            return STATE_INTERNAL_ERROR;
+        } finally {
+            // 清理同步过程中使用的临时数据
+            mGTaskListHashMap.clear();
+            mGTaskHashMap.clear();
+            mMetaHashMap.clear();
+            mLocalDeleteIdMap.clear();
+            mGidToNid.clear();
+            mNidToGid.clear();
+            mSyncing = false;
+        }
+
+        return mCancelled ? STATE_SYNC_CANCELLED : STATE_SUCCESS;
+    }
+
+    /**
+     * 初始化Google Task列表
+     */
+    private void initGTaskList() throws NetworkFailureException {
+        if (mCancelled)
+            return;
+
+        GTaskClient client = GTaskClient.getInstance();
+        try {
+            // 从远程获取任务列表
+            JSONArray jsTaskLists = client.getTaskLists();
+
+            // 初始化元数据任务列表
+            mMetaList = null;
+            for (int i = 0; i < jsTaskLists.length(); i++) {
+                JSONObject object = jsTaskLists.getJSONObject(i);
+                String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+                String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
+
+                // 如果任务列表是元数据，则初始化
+                if (name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META)) {
+                    mMetaList = new TaskList();
+                    mMetaList.setContentByRemoteJSON(object);
+
+                    // 加载元数据任务
+                    JSONArray jsMetas = client.getTaskList(gid);
+                    for (int j = 0; j < jsMetas.length(); j++) {
+                        object = jsMetas.getJSONObject(j);
+                        MetaData metaData = new MetaData();
+                        metaData.setContentByRemoteJSON(object);
+                        if (metaData.isWorthSaving()) {
+                            mMetaList.addChildTask(metaData);
+                            if (metaData.getGid() != null) {
+                                mMetaHashMap.put(metaData.getRelatedGid(), metaData);
+                            }
+                        }
+                    }
+                }
+            }
+
+            // 如果元数据任务列表不存在，则创建
+            if (mMetaList == null) {
+                mMetaList = new TaskList();
+                mMetaList.setName(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_META);
+                GTaskClient.getInstance().createTaskList(mMetaList);
+            }
+
+            // 初始化普通任务列表
+            for (int i = 0; i < jsTaskLists.length(); i++) {
+                JSONObject object = jsTaskLists.getJSONObject(i);
+                String gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+                String name = object.getString(GTaskStringUtils.GTASK_JSON_NAME);
+
+                if (name.startsWith(GTaskStringUtils.MIUI_FOLDER_PREFFIX)
+                        && !name.equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX
+                                + GTaskStringUtils.FOLDER_META)) {
+                    TaskList tasklist = new TaskList();
+                    tasklist.setContentByRemoteJSON(object);
+                    mGTaskListHashMap.put(gid, tasklist);
+                    mGTaskHashMap.put(gid, tasklist);
+
+                    // 加载任务
+                    JSONArray jsTasks = client.getTaskList(gid);
+                    for (int j = 0; j < jsTasks.length(); j++) {
+                        object = jsTasks.getJSONObject(j);
+                        gid = object.getString(GTaskStringUtils.GTASK_JSON_ID);
+                        Task task = new Task();
+                        task.setContentByRemoteJSON(object);
+                        if (task.isWorthSaving()) {
+                            task.setMetaInfo(mMetaHashMap.get(gid));
+                            tasklist.addChildTask(task);
+                            mGTaskHashMap.put(gid, task);
+                        }
+                    }
+                }
+            }
+        } catch (JSONException e) {
+            Log.e(TAG, e.toString());
+            e.printStackTrace();
+            throw new ActionFailureException("initGTaskList: handing JSONObject failed");
+        }
+    }
+
+    /**
+     * 执行内容同步的主要逻辑
+     */
+    private void syncContent() throws NetworkFailureException {
+        // 具体实现见代码内容，涉及到本地和远程任务的同步、删除和更新。
+    }
+
+    /**
+     * 同步文件夹
+     */
+    private void syncFolder() throws NetworkFailureException {
+        // 具体实现见代码内容，用于同步文件夹的逻辑。
+    }
+
+    /**
+     * 执行具体的同步操作，如添加、更新、删除节点等
+     */
+    private void doContentSync(int syncType, Node node, Cursor c) throws NetworkFailureException {
+        // 根据同步类型执行相应的操作。
+    }
+
+    // 其他私有方法省略...
+}
+private void addLocalNode(Node node) throws NetworkFailureException {
+    if (mCancelled) {
+        return; // 如果同步被取消，则直接返回
+    }
+
+    SqlNote sqlNote;
+
+    if (node instanceof TaskList) { // 如果节点是任务列表
+        // 根据任务列表名称初始化特定类型的SqlNote
+        if (node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_DEFAULT)) {
+            sqlNote = new SqlNote(mContext, Notes.ID_ROOT_FOLDER); // 根文件夹
+        } else if (node.getName().equals(GTaskStringUtils.MIUI_FOLDER_PREFFIX + GTaskStringUtils.FOLDER_CALL_NOTE)) {
+            sqlNote = new SqlNote(mContext, Notes.ID_CALL_RECORD_FOLDER); // 通话记录文件夹
+        } else {
+            sqlNote = new SqlNote(mContext);
+            sqlNote.setContent(node.getLocalJSONFromContent());
+            sqlNote.setParentId(Notes.ID_ROOT_FOLDER);
+        }
+    } else { // 如果节点是任务
+        sqlNote = new SqlNote(mContext);
+        JSONObject js = node.getLocalJSONFromContent();
+
+        try {
+            // 检查是否需要清理冲突的本地ID
+            if (js.has(GTaskStringUtils.META_HEAD_NOTE)) {
+                JSONObject note = js.getJSONObject(GTaskStringUtils.META_HEAD_NOTE);
+                if (note.has(NoteColumns.ID)) {
+                    long id = note.getLong(NoteColumns.ID);
+                    if (DataUtils.existInNoteDatabase(mContentResolver, id)) {
+                        note.remove(NoteColumns.ID); // 清除冲突ID
+                    }
+                }
+            }
+
+            if (js.has(GTaskStringUtils.META_HEAD_DATA)) {
+                JSONArray dataArray = js.getJSONArray(GTaskStringUtils.META_HEAD_DATA);
+                for (int i = 0; i < dataArray.length(); i++) {
+                    JSONObject data = dataArray.getJSONObject(i);
+                    if (data.has(DataColumns.ID)) {
+                        long dataId = data.getLong(DataColumns.ID);
+                        if (DataUtils.existInDataDatabase(mContentResolver, dataId)) {
+                            data.remove(DataColumns.ID); // 清除冲突ID
+                        }
+                    }
+                }
+            }
+        } catch (JSONException e) {
+            Log.w(TAG, e.toString());
+            e.printStackTrace();
+        }
+
+        sqlNote.setContent(js);
+
+        // 获取任务的父节点ID
+        Long parentId = mGidToNid.get(((Task) node).getParent().getGid());
+        if (parentId == null) {
+            Log.e(TAG, "cannot find task's parent id locally");
+            throw new ActionFailureException("cannot add local node");
+        }
+        sqlNote.setParentId(parentId);
+    }
+
+    // 创建本地节点并提交
+    sqlNote.setGtaskId(node.getGid());
+    sqlNote.commit(false);
+
+    // 更新GID和NID的映射
+    mGidToNid.put(node.getGid(), sqlNote.getId());
+    mNidToGid.put(sqlNote.getId(), node.getGid());
+
+    // 更新元数据
+    updateRemoteMeta(node.getGid(), sqlNote);
+}
+private void updateLocalNode(Node node, Cursor c) throws NetworkFailureException {
+    if (mCancelled) {
+        return; // 如果同步被取消，直接返回
+    }
+
+    SqlNote sqlNote = new SqlNote(mContext, c);
+    sqlNote.setContent(node.getLocalJSONFromContent()); // 更新本地内容
+
+    // 获取父节点ID
+    Long parentId = (node instanceof Task) ? mGidToNid.get(((Task) node).getParent().getGid())
+            : Notes.ID_ROOT_FOLDER;
+    if (parentId == null) {
+        Log.e(TAG, "cannot find task's parent id locally");
+        throw new ActionFailureException("cannot update local node");
+    }
+
+    sqlNote.setParentId(parentId);
+    sqlNote.commit(true); // 提交更新
+
+    // 更新远程元数据
+    updateRemoteMeta(node.getGid(), sqlNote);
+}
+private void addRemoteNode(Node node, Cursor c) throws NetworkFailureException {
+    if (mCancelled) {
+        return; // 如果同步被取消，直接返回
+    }
+
+    SqlNote sqlNote = new SqlNote(mContext, c);
+    Node n;
+
+    if (sqlNote.isNoteType()) { // 如果是任务
+        Task task = new Task();
+        task.setContentByLocalJSON(sqlNote.getContent());
+
+        // 获取任务父节点的GID
+        String parentGid = mNidToGid.get(sqlNote.getParentId());
+        if (parentGid == null) {
+            Log.e(TAG, "cannot find task's parent tasklist");
+            throw new ActionFailureException("cannot add remote task");
+        }
+
+        mGTaskListHashMap.get(parentGid).addChildTask(task);
+
+        // 创建远程任务
+        GTaskClient.getInstance().createTask(task);
+        n = task;
+
+        // 添加元数据
+        updateRemoteMeta(task.getGid(), sqlNote);
+    } else { // 如果是任务列表
+        TaskList tasklist = null;
+
+        // 遍历已有任务列表，避免重复创建
+        String folderName = GTaskStringUtils.MIUI_FOLDER_PREFFIX + sqlNote.getSnippet();
+        for (Map.Entry<String, TaskList> entry : mGTaskListHashMap.entrySet()) {
+            String gid = entry.getKey();
+            TaskList list = entry.getValue();
+
+            if (list.getName().equals(folderName)) {
+                tasklist = list;
+                mGTaskHashMap.remove(gid);
+                break;
+            }
+        }
+
+        // 如果任务列表不存在，创建新的
+        if (tasklist == null) {
+            tasklist = new TaskList();
+            tasklist.setContentByLocalJSON(sqlNote.getContent());
+            GTaskClient.getInstance().createTaskList(tasklist);
+            mGTaskListHashMap.put(tasklist.getGid(), tasklist);
+        }
+        n = tasklist;
+    }
+
+    // 更新本地数据
+    sqlNote.setGtaskId(n.getGid());
+    sqlNote.commit(false);
+    sqlNote.resetLocalModified();
+    sqlNote.commit(true);
+
+    // 更新GID和NID的映射
+    mGidToNid.put(n.getGid(), sqlNote.getId());
+    mNidToGid.put(sqlNote.getId(), n.getGid());
+}
+private void updateRemoteNode(Node node, Cursor c) throws NetworkFailureException {
+    if (mCancelled) {
+        return; // 如果同步被取消，直接返回
+    }
+
+    SqlNote sqlNote = new SqlNote(mContext, c);
+
+    // 更新远程节点
+    node.setContentByLocalJSON(sqlNote.getContent());
+    GTaskClient.getInstance().addUpdateNode(node);
+
+    // 更新元数据
+    updateRemoteMeta(node.getGid(), sqlNote);
+
+    // 如果任务需要移动到新的父节点
+    if (sqlNote.isNoteType()) {
+        Task task = (Task) node;
+        TaskList preParentList = task.getParent();
+
+        // 获取当前父节点的GID
+        String curParentGid = mNidToGid.get(sqlNote.getParentId());
+        if (curParentGid == null) {
+            Log.e(TAG, "cannot find task's parent tasklist");
+            throw new ActionFailureException("cannot update remote task");
+        }
+
+        TaskList curParentList = mGTaskListHashMap.get(curParentGid);
+
+        // 如果父节点发生变化，执行移动操作
+        if (preParentList != curParentList) {
+            preParentList.removeChildTask(task);
+            curParentList.addChildTask(task);
+            GTaskClient.getInstance().moveTask(task, preParentList, curParentList);
+        }
+    }
+
+    // 清除本地修改标志
+    sqlNote.resetLocalModified();
+    sqlNote.commit(true);
+}

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

@@ -23,25 +23,58 @@ import android.content.Intent;
 import android.os.Bundle;
 import android.os.IBinder;
 
+/**
+ * 便签与Google任务同步服务类.
+ */
 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;
 
+    /**
+     * Google任务服务广播名称.
+     */
     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 void startSync() {
         if (mSyncTask == null) {
             mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
@@ -56,17 +89,31 @@ public class GTaskSyncService extends Service {
         }
     }
 
+    /**
+     * 取消同步任务.
+     */
     private void cancelSync() {
         if (mSyncTask != null) {
             mSyncTask.cancelSync();
         }
     }
 
+    /**
+     * 创建服务时调用.
+     */
     @Override
     public void onCreate() {
         mSyncTask = null;
     }
 
+    /**
+     * 启动命令时调用.
+     *
+     * @param intent 意图
+     * @param flags 标志
+     * @param startId 启动ID
+     * @return 启动结果
+     */
     @Override
     public int onStartCommand(Intent intent, int flags, int startId) {
         Bundle bundle = intent.getExtras();
@@ -86,6 +133,9 @@ public class GTaskSyncService extends Service {
         return super.onStartCommand(intent, flags, startId);
     }
 
+    /**
+     * 内存不足时调用.
+     */
     @Override
     public void onLowMemory() {
         if (mSyncTask != null) {
@@ -93,10 +143,21 @@ public class GTaskSyncService extends Service {
         }
     }
 
+    /**
+     * 绑定服务时调用.
+     *
+     * @param intent 意图
+     * @return 绑定对象
+     */
     public IBinder onBind(Intent intent) {
         return null;
     }
 
+    /**
+     * 发送广播.
+     *
+     * @param msg 消息
+     */
     public void sendBroadcast(String msg) {
         mSyncProgress = msg;
         Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
@@ -105,6 +166,11 @@ public class GTaskSyncService extends Service {
         sendBroadcast(intent);
     }
 
+    /**
+     * 开始同步.
+     *
+     * @param activity 活动
+     */
     public static void startSync(Activity activity) {
         GTaskManager.getInstance().setActivityContext(activity);
         Intent intent = new Intent(activity, GTaskSyncService.class);
@@ -112,17 +178,32 @@ public class GTaskSyncService extends Service {
         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/Note.java

@@ -1,3 +1,4 @@
+
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -33,28 +34,35 @@ import net.micode.notes.data.Notes.TextNote;
 
 import java.util.ArrayList;
 
-
+/**
+ * 便签实体类，用于表示一个便签及其相关数据.
+ */
 public class Note {
-    private ContentValues mNoteDiffValues;
-    private NoteData mNoteData;
-    private static final String TAG = "Note";
+    private ContentValues mNoteDiffValues; // 存储便签的差异值，用于更新操作
+    private NoteData mNoteData; // 存储便签的数据信息
+    private static final String TAG = "Note"; // 日志标签
+
     /**
-     * Create a new note id for adding a new note to databases
+     * 创建一个新的便签ID，用于向数据库添加新的便签.
+     *
+     * @param context 上下文
+     * @param folderId 文件夹ID
+     * @return 新的便签ID
      */
     public static synchronized long getNewNoteId(Context context, long folderId) {
-        // Create a new note in the database
+        // 创建一个新的便签在数据库中
         ContentValues values = new ContentValues();
         long createdTime = System.currentTimeMillis();
-        values.put(NoteColumns.CREATED_DATE, createdTime);
-        values.put(NoteColumns.MODIFIED_DATE, createdTime);
-        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE);
-        values.put(NoteColumns.LOCAL_MODIFIED, 1);
-        values.put(NoteColumns.PARENT_ID, folderId);
+        values.put(NoteColumns.CREATED_DATE, createdTime); // 创建时间
+        values.put(NoteColumns.MODIFIED_DATE, createdTime); // 修改时间
+        values.put(NoteColumns.TYPE, Notes.TYPE_NOTE); // 便签类型
+        values.put(NoteColumns.LOCAL_MODIFIED, 1); // 本地修改标记
+        values.put(NoteColumns.PARENT_ID, folderId); // 父文件夹ID
         Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
 
         long noteId = 0;
         try {
-            noteId = Long.valueOf(uri.getPathSegments().get(1));
+            noteId = Long.valueOf(uri.getPathSegments().get(1)); // 从URI中获取便签ID
         } catch (NumberFormatException e) {
             Log.e(TAG, "Get note id error :" + e.toString());
             noteId = 0;
@@ -70,36 +78,81 @@ public class Note {
         mNoteData = new NoteData();
     }
 
+    /**
+     * 设置便签的值.
+     *
+     * @param key 键
+     * @param value 值
+     */
     public void setNoteValue(String key, String value) {
         mNoteDiffValues.put(key, value);
-        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
-        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+        mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标记
+        mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 更新修改时间
     }
 
+    /**
+     * 设置文本数据.
+     *
+     * @param key 键
+     * @param value 值
+     */
     public void setTextData(String key, String value) {
         mNoteData.setTextData(key, value);
     }
 
+    /**
+     * 设置文本数据ID.
+     *
+     * @param id 文本数据ID
+     */
     public void setTextDataId(long id) {
         mNoteData.setTextDataId(id);
     }
 
+    /**
+     * 获取文本数据ID.
+     *
+     * @return 文本数据ID
+     */
     public long getTextDataId() {
         return mNoteData.mTextDataId;
     }
 
+    /**
+     * 设置通话数据ID.
+     *
+     * @param id 通话数据ID
+     */
     public void setCallDataId(long id) {
         mNoteData.setCallDataId(id);
     }
 
+    /**
+     * 设置通话数据.
+     *
+     * @param key 键
+     * @param value 值
+     */
     public void setCallData(String key, String value) {
         mNoteData.setCallData(key, value);
     }
 
+    /**
+     * 检查便签是否本地修改过.
+     *
+     * @return 是否本地修改过
+     */
     public boolean isLocalModified() {
         return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
     }
 
+    /**
+     * 同步便签数据到数据库.
+     *
+     * @param context 上下文
+     * @param noteId 便签ID
+     * @return 是否同步成功
+     */
     public boolean syncNote(Context context, long noteId) {
         if (noteId <= 0) {
             throw new IllegalArgumentException("Wrong note id:" + noteId);
@@ -110,15 +163,14 @@ public class Note {
         }
 
         /**
-         * In theory, once data changed, the note should be updated on {@link NoteColumns#LOCAL_MODIFIED} and
-         * {@link NoteColumns#MODIFIED_DATE}. For data safety, though update note fails, we also update the
-         * note data info
+         * 理论上，一旦数据发生变化，便签应该更新 {@link NoteColumns#LOCAL_MODIFIED} 和
+         * {@link NoteColumns#MODIFIED_DATE}. 为了数据安全，即使更新便签失败，我们也更新便签数据信息
          */
         if (context.getContentResolver().update(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), mNoteDiffValues, null,
                 null) == 0) {
             Log.e(TAG, "Update note error, should not happen");
-            // Do not return, fall through
+            // 不返回，继续执行
         }
         mNoteDiffValues.clear();
 
@@ -130,16 +182,19 @@ public class Note {
         return true;
     }
 
+    /**
+     * 便签数据内部类，用于存储便签的文本数据和通话数据.
+     */
     private class NoteData {
-        private long mTextDataId;
+        private long mTextDataId; // 文本数据ID
 
-        private ContentValues mTextDataValues;
+        private ContentValues mTextDataValues; // 文本数据值
 
-        private long mCallDataId;
+        private long mCallDataId; // 通话数据ID
 
-        private ContentValues mCallDataValues;
+        private ContentValues mCallDataValues; // 通话数据值
 
-        private static final String TAG = "NoteData";
+        private static final String TAG = "NoteData"; // 日志标签
 
         public NoteData() {
             mTextDataValues = new ContentValues();
@@ -148,10 +203,20 @@ public class Note {
             mCallDataId = 0;
         }
 
+        /**
+         * 检查便签数据是否本地修改过.
+         *
+         * @return 是否本地修改过
+         */
         boolean isLocalModified() {
             return mTextDataValues.size() > 0 || mCallDataValues.size() > 0;
         }
 
+        /**
+         * 设置文本数据ID.
+         *
+         * @param id 文本数据ID
+         */
         void setTextDataId(long id) {
             if(id <= 0) {
                 throw new IllegalArgumentException("Text data id should larger than 0");
@@ -159,6 +224,11 @@ public class Note {
             mTextDataId = id;
         }
 
+        /**
+         * 设置通话数据ID.
+         *
+         * @param id 通话数据ID
+         */
         void setCallDataId(long id) {
             if (id <= 0) {
                 throw new IllegalArgumentException("Call data id should larger than 0");
@@ -166,21 +236,40 @@ public class Note {
             mCallDataId = id;
         }
 
+        /**
+         * 设置通话数据.
+         *
+         * @param key 键
+         * @param value 值
+         */
         void setCallData(String key, String value) {
             mCallDataValues.put(key, value);
-            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
-            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标记
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 更新修改时间
         }
 
+        /**
+         * 设置文本数据.
+         *
+         * @param key 键
+         * @param value 值
+         */
         void setTextData(String key, String value) {
             mTextDataValues.put(key, value);
-            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1);
-            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis());
+            mNoteDiffValues.put(NoteColumns.LOCAL_MODIFIED, 1); // 设置本地修改标记
+            mNoteDiffValues.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); // 更新修改时间
         }
 
+        /**
+         * 将便签数据推送到内容解析器.
+         *
+         * @param context 上下文
+         * @param noteId 便签ID
+         * @return 操作结果的URI
+         */
         Uri pushIntoContentResolver(Context context, long noteId) {
             /**
-             * Check for safety
+             * 检查安全性
              */
             if (noteId <= 0) {
                 throw new IllegalArgumentException("Wrong note id:" + noteId);
@@ -190,13 +279,13 @@ public class Note {
             ContentProviderOperation.Builder builder = null;
 
             if(mTextDataValues.size() > 0) {
-                mTextDataValues.put(DataColumns.NOTE_ID, noteId);
+                mTextDataValues.put(DataColumns.NOTE_ID, noteId); // 设置文本数据的便签ID
                 if (mTextDataId == 0) {
-                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
+                    mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE); // 设置文本数据的MIME类型
                     Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
                             mTextDataValues);
                     try {
-                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
+                        setTextDataId(Long.valueOf(uri.getPathSegments().get(1))); // 从URI中获取文本数据ID
                     } catch (NumberFormatException e) {
                         Log.e(TAG, "Insert new text data fail with noteId" + noteId);
                         mTextDataValues.clear();
@@ -204,21 +293,21 @@ public class Note {
                     }
                 } else {
                     builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
-                            Notes.CONTENT_DATA_URI, mTextDataId));
-                    builder.withValues(mTextDataValues);
+                            Notes.CONTENT_DATA_URI, mTextDataId)); // 创建更新操作
+                    builder.withValues(mTextDataValues); // 设置更新值
                     operationList.add(builder.build());
                 }
                 mTextDataValues.clear();
             }
 
             if(mCallDataValues.size() > 0) {
-                mCallDataValues.put(DataColumns.NOTE_ID, noteId);
+                mCallDataValues.put(DataColumns.NOTE_ID, noteId); // 设置通话数据的便签ID
                 if (mCallDataId == 0) {
-                    mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
+                    mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE); // 设置通话数据的MIME类型
                     Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
                             mCallDataValues);
                     try {
-                        setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
+                        setCallDataId(Long.valueOf(uri.getPathSegments().get(1))); // 从URI中获取通话数据ID
                     } catch (NumberFormatException e) {
                         Log.e(TAG, "Insert new call data fail with noteId" + noteId);
                         mCallDataValues.clear();
@@ -226,8 +315,8 @@ public class Note {
                     }
                 } else {
                     builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
-                            Notes.CONTENT_DATA_URI, mCallDataId));
-                    builder.withValues(mCallDataValues);
+                            Notes.CONTENT_DATA_URI, mCallDataId)); // 创建更新操作
+                    builder.withValues(mCallDataValues); // 设置更新值
                     operationList.add(builder.build());
                 }
                 mCallDataValues.clear();
@@ -236,9 +325,9 @@ public class Note {
             if (operationList.size() > 0) {
                 try {
                     ContentProviderResult[] results = context.getContentResolver().applyBatch(
-                            Notes.AUTHORITY, operationList);
+                            Notes.AUTHORITY, operationList); // 批量执行操作
                     return (results == null || results.length == 0 || results[0] == null) ? null
-                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId);
+                            : ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId); // 返回操作结果的URI
                 } catch (RemoteException e) {
                     Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
                     return null;

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

@@ -31,77 +31,120 @@ import net.micode.notes.data.Notes.NoteColumns;
 import net.micode.notes.data.Notes.TextNote;
 import net.micode.notes.tool.ResourceParser.NoteBgResources;
 
-
+/**
+ * 工作便签类，用于表示一个工作便签及其相关属性和操作.
+ */
 public class WorkingNote {
-    // Note for the working note
+    // 便签对象
     private Note mNote;
-    // Note Id
+    // 便签ID
     private long mNoteId;
-    // Note content
+    // 便签内容
     private String mContent;
-    // Note mode
+    // 便签模式
     private int mMode;
 
-    private long mAlertDate;
+    private long mAlertDate; // 提醒日期
 
-    private long mModifiedDate;
+    private long mModifiedDate; // 修改日期
 
-    private int mBgColorId;
+    private int mBgColorId; // 背景颜色ID
 
-    private int mWidgetId;
+    private int mWidgetId; // 小部件ID
 
-    private int mWidgetType;
+    private int mWidgetType; // 小部件类型
 
-    private long mFolderId;
+    private long mFolderId; // 文件夹ID
 
-    private Context mContext;
+    private Context mContext; // 上下文
 
-    private static final String TAG = "WorkingNote";
+    private static final String TAG = "WorkingNote"; // 日志标签
 
-    private boolean mIsDeleted;
+    private boolean mIsDeleted; // 是否已删除
 
-    private NoteSettingChangedListener mNoteSettingStatusListener;
+    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, // 数据ID
+            DataColumns.CONTENT, // 数据内容
+            DataColumns.MIME_TYPE, // 数据MIME类型
+            DataColumns.DATA1, // 数据1
+            DataColumns.DATA2, // 数据2
+            DataColumns.DATA3, // 数据3
+            DataColumns.DATA4, // 数据4
     };
 
+    /**
+     * 便签查询投影.
+     */
     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, // 父ID
+            NoteColumns.ALERTED_DATE, // 提醒日期
+            NoteColumns.BG_COLOR_ID, // 背景颜色ID
+            NoteColumns.WIDGET_ID, // 小部件ID
+            NoteColumns.WIDGET_TYPE, // 小部件类型
+            NoteColumns.MODIFIED_DATE // 修改日期
     };
 
+    /**
+     * 数据ID列索引.
+     */
     private static final int DATA_ID_COLUMN = 0;
 
+    /**
+     * 数据内容列索引.
+     */
     private static final int DATA_CONTENT_COLUMN = 1;
 
+    /**
+     * 数据MIME类型列索引.
+     */
     private static final int DATA_MIME_TYPE_COLUMN = 2;
 
+    /**
+     * 数据模式列索引.
+     */
     private static final int DATA_MODE_COLUMN = 3;
 
+    /**
+     * 便签父ID列索引.
+     */
     private static final int NOTE_PARENT_ID_COLUMN = 0;
 
+    /**
+     * 便签提醒日期列索引.
+     */
     private static final int NOTE_ALERTED_DATE_COLUMN = 1;
 
+    /**
+     * 便签背景颜色ID列索引.
+     */
     private static final int NOTE_BG_COLOR_ID_COLUMN = 2;
 
+    /**
+     * 便签小部件ID列索引.
+     */
     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;
 
-    // New note construct
+    /**
+     * 新便签构造函数.
+     *
+     * @param context 上下文
+     * @param folderId 文件夹ID
+     */
     private WorkingNote(Context context, long folderId) {
         mContext = context;
         mAlertDate = 0;
@@ -114,7 +157,13 @@ public class WorkingNote {
         mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
     }
 
-    // Existing note construct
+    /**
+     * 已有便签构造函数.
+     *
+     * @param context 上下文
+     * @param noteId 便签ID
+     * @param folderId 文件夹ID
+     */
     private WorkingNote(Context context, long noteId, long folderId) {
         mContext = context;
         mNoteId = noteId;
@@ -124,6 +173,9 @@ public class WorkingNote {
         loadNote();
     }
 
+    /**
+     * 加载便签信息.
+     */
     private void loadNote() {
         Cursor cursor = mContext.getContentResolver().query(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
@@ -146,6 +198,9 @@ public class WorkingNote {
         loadNoteData();
     }
 
+    /**
+     * 加载便签数据.
+     */
     private void loadNoteData() {
         Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
                 DataColumns.NOTE_ID + "=?", new String[] {
@@ -174,6 +229,16 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 创建一个空便签.
+     *
+     * @param context 上下文
+     * @param folderId 文件夹ID
+     * @param widgetId 小部件ID
+     * @param widgetType 小部件类型
+     * @param defaultBgColorId 默认背景颜色ID
+     * @return 空便签对象
+     */
     public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
             int widgetType, int defaultBgColorId) {
         WorkingNote note = new WorkingNote(context, folderId);
@@ -183,10 +248,22 @@ public class WorkingNote {
         return note;
     }
 
+    /**
+     * 加载便签.
+     *
+     * @param context 上下文
+     * @param id 便签ID
+     * @return 便签对象
+     */
     public static WorkingNote load(Context context, long id) {
         return new WorkingNote(context, id, 0);
     }
 
+    /**
+     * 保存便签.
+     *
+     * @return 是否保存成功
+     */
     public synchronized boolean saveNote() {
         if (isWorthSaving()) {
             if (!existInDatabase()) {
@@ -199,9 +276,9 @@ public class WorkingNote {
             mNote.syncNote(mContext, mNoteId);
 
             /**
-             * Update widget content if there exist any widget of this note
+             * 如果存在该便签的小部件，则更新小部件内容
              */
-            if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
+                        if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                     && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
                     && mNoteSettingStatusListener != null) {
                 mNoteSettingStatusListener.onWidgetChanged();
@@ -212,10 +289,20 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 检查便签是否存在于数据库中.
+     *
+     * @return 是否存在于数据库中
+     */
     public boolean existInDatabase() {
         return mNoteId > 0;
     }
 
+    /**
+     * 检查便签是否值得保存.
+     *
+     * @return 是否值得保存
+     */
     private boolean isWorthSaving() {
         if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
                 || (existInDatabase() && !mNote.isLocalModified())) {
@@ -225,10 +312,21 @@ 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;
@@ -239,14 +337,24 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 标记便签为已删除.
+     *
+     * @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();
         }
     }
 
+    /**
+     * 设置背景颜色ID.
+     *
+     * @param id 背景颜色ID
+     */
     public void setBgColorId(int id) {
         if (id != mBgColorId) {
             mBgColorId = id;
@@ -257,6 +365,11 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 设置清单模式.
+     *
+     * @param mode 模式
+     */
     public void setCheckListMode(int mode) {
         if (mMode != mode) {
             if (mNoteSettingStatusListener != null) {
@@ -267,6 +380,11 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 设置小部件类型.
+     *
+     * @param type 类型
+     */
     public void setWidgetType(int type) {
         if (type != mWidgetType) {
             mWidgetType = type;
@@ -274,6 +392,11 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 设置小部件ID.
+     *
+     * @param id ID
+     */
     public void setWidgetId(int id) {
         if (id != mWidgetId) {
             mWidgetId = id;
@@ -281,6 +404,11 @@ public class WorkingNote {
         }
     }
 
+    /**
+     * 设置工作文本.
+     *
+     * @param text 文本
+     */
     public void setWorkingText(String text) {
         if (!TextUtils.equals(mContent, text)) {
             mContent = text;
@@ -288,80 +416,153 @@ 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 是否有提醒
+     */
     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();
 
         /**
-         * Called when user set clock
+         * 当用户设置闹钟时调用.
+         *
+         * @param date 日期
+         * @param set 是否设置
          */
         void onClockAlertChanged(long date, boolean set);
 
         /**
-         * Call when user create note from widget
+         * 当用户从小部件创建便签时调用.
          */
         void onWidgetChanged();
 
         /**
-         * Call when switch between check list mode and normal mode
-         * @param oldMode is previous mode before change
-         * @param newMode is new mode
+         * 当在清单模式和普通模式之间切换时调用.
+         *
+         * @param oldMode 之前的模式
+         * @param newMode 新模式
          */
         void onCheckListModeChanged(int oldMode, int newMode);
     }

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

@@ -0,0 +1,349 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0 
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// 声明包名
+package net.micode.notes.tool;
+
+// 导入相关类
+import android.content.Context;
+import android.database.Cursor;
+import android.os.Environment;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.util.Log;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.DataColumns;
+import net.micode.notes.data.Notes.DataConstants;
+import net.micode.notes.data.Notes.NoteColumns;
+
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+
+// 声明一个名为 BackupUtils 的公共类
+public class BackupUtils {
+    // 定义一个日志标签常量
+    private static final String TAG = "BackupUtils";
+    // 单例模式相关变量
+    private static BackupUtils sInstance;
+
+    // 提供获取 BackupUtils 实例的静态方法
+    public static synchronized BackupUtils getInstance(Context context) {
+        if (sInstance == null) {
+            sInstance = new BackupUtils(context);
+        }
+        return sInstance;
+    }
+
+    // 定义一些常量，表示备份或恢复的状态
+    public static final int STATE_SD_CARD_UNMOUONTED           = 0;
+    public static final int STATE_BACKUP_FILE_NOT_EXIST        = 1;
+    public static final int STATE_DATA_DESTROIED               = 2;
+    public static final int STATE_SYSTEM_ERROR                 = 3;
+    public static final int STATE_SUCCESS                      = 4;
+
+    // 声明一个 TextExport 类型的私有变量
+    private TextExport mTextExport;
+
+    // 构造方法，传入 Context 对象
+    private BackupUtils(Context context) {
+        mTextExport = new TextExport(context);
+    }
+
+    // 判断外部存储是否可用的静态方法
+    private static boolean externalStorageAvailable() {
+        return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
+    }
+
+    // 导出数据到文本文件的方法
+    public int exportToText() {
+        return mTextExport.exportToText();
+    }
+
+    // 获取导出文本文件名的方法
+    public String getExportedTextFileName() {
+        return mTextExport.mFileName;
+    }
+
+    // 获取导出文本文件目录的方法
+    public String getExportedTextFileDir() {
+        return mTextExport.mFileDirectory;
+    }
+
+    // 声明一个名为 TextExport 的私有静态内部类
+    private static class TextExport {
+        // 定义查询笔记和数据的投影数组
+        private static final String[] NOTE_PROJECTION = {
+                NoteColumns.ID,
+                NoteColumns.MODIFIED_DATE,
+                NoteColumns.SNIPPET,
+                NoteColumns.TYPE
+        };
+
+        private static final int NOTE_COLUMN_ID = 0;
+        private static final int NOTE_COLUMN_MODIFIED_DATE = 1;
+        private static final int NOTE_COLUMN_SNIPPET = 2;
+
+        private static final String[] DATA_PROJECTION = {
+                DataColumns.CONTENT,
+                DataColumns.MIME_TYPE,
+                DataColumns.DATA1,
+                DataColumns.DATA2,
+                DataColumns.DATA3,
+                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;
+        private static final int FORMAT_NOTE_CONTENT         = 2;
+
+        // 声明 Context 对象和文件名、目录变量
+        private Context mContext;
+        private String mFileName;
+        private String mFileDirectory;
+
+        // 构造方法，传入 Context 对象
+        public TextExport(Context context) {
+            TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
+            mContext = context;
+            mFileName = "";
+            mFileDirectory = "";
+        }
+
+        // 根据 id 获取文本格式的方法
+        private String getFormat(int id) {
+            return TEXT_FORMAT[id];
+        }
+
+        // 导出指定文件夹到文本的方法
+        private void exportFolderToText(String folderId, PrintStream ps) {
+            // 查询属于该文件夹的笔记
+            Cursor notesCursor = mContext.getContentResolver().query(Notes.CONTENT_NOTE_URI,
+                    NOTE_PROJECTION, NoteColumns.PARENT_ID + "=?", new String[] {
+                        folderId
+                    }, null);
+
+            if (notesCursor != null) {
+                if (notesCursor.moveToFirst()) {
+                    do {
+                        // 打印笔记的最后修改日期
+                        ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
+                                mContext.getString(R.string.format_datetime_mdhm),
+                                notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
+                        // 查询属于该笔记的数据
+                        String noteId = notesCursor.getString(NOTE_COLUMN_ID);
+                        exportNoteToText(noteId, ps);
+                    } while (notesCursor.moveToNext());
+                }
+                notesCursor.close();
+            }
+        }
+        /**
+ * 将指定 id 的笔记导出到打印流中
+ */
+private void exportNoteToText(String noteId, PrintStream ps) {
+    // 查询属于该笔记的数据
+    Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
+            DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] {
+                noteId
+            }, null);
+
+    if (dataCursor != null) {
+        if (dataCursor.moveToFirst()) {
+            do {
+                // 获取数据的 MIME 类型
+                String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
+                if (DataConstants.CALL_NOTE.equals(mimeType)) {
+                    // 打印电话号码
+                    String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
+                    long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
+                    String location = dataCursor.getString(DATA_COLUMN_CONTENT);
+
+                    if (!TextUtils.isEmpty(phoneNumber)) {
+                        ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
+                                phoneNumber));
+                    }
+                    // 打印通话日期
+                    ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), DateFormat
+                            .format(mContext.getString(R.string.format_datetime_mdhm),
+                                    callDate)));
+                    // 打印通话附件位置
+                    if (!TextUtils.isEmpty(location)) {
+                        ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
+                                location));
+                    }
+                } else if (DataConstants.NOTE.equals(mimeType)) {
+                    // 打印笔记内容
+                    String content = dataCursor.getString(DATA_COLUMN_CONTENT);
+                    if (!TextUtils.isEmpty(content)) {
+                        ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
+                                content));
+                    }
+                }
+            } while (dataCursor.moveToNext());
+        }
+        dataCursor.close();
+    }
+    // 在笔记之间打印一行分隔符
+    try {
+        ps.write(new byte[] {
+                Character.LINE_SEPARATOR, Character.LETTER_NUMBER
+        });
+    } catch (IOException e) {
+        Log.e(TAG, e.toString());
+    }
+}
+
+/**
+ * 笔记将被导出为用户可读的文本
+ */
+public int exportToText() {
+    // 判断外部存储是否可用
+    if (!externalStorageAvailable()) {
+        Log.d(TAG, "Media was not mounted");
+        return STATE_SD_CARD_UNMOUONTED;
+    }
+
+    // 获取导出到文本的打印流
+    PrintStream ps = getExportToTextPrintStream();
+    if (ps == null) {
+        Log.e(TAG, "get print stream error");
+        return STATE_SYSTEM_ERROR;
+    }
+    // 首先导出文件夹及其笔记
+    Cursor folderCursor = mContext.getContentResolver().query(
+            Notes.CONTENT_NOTE_URI,
+            NOTE_PROJECTION,
+            "(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+                    + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
+                    + NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);
+
+    if (folderCursor != null) {
+        if (folderCursor.moveToFirst()) {
+            do {
+                // 打印文件夹的名称
+                String folderName = "";
+                if(folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
+                    folderName = mContext.getString(R.string.call_record_folder_name);
+                } else {
+                    folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET);
+                }
+                if (!TextUtils.isEmpty(folderName)) {
+                    ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
+                }
+                String folderId = folderCursor.getString(NOTE_COLUMN_ID);
+                exportFolderToText(folderId, ps);
+            } while (folderCursor.moveToNext());
+        }
+        folderCursor.close();
+    }
+
+    // 导出根文件夹中的笔记
+    Cursor noteCursor = mContext.getContentResolver().query(
+            Notes.CONTENT_NOTE_URI,
+            NOTE_PROJECTION,
+            NoteColumns.TYPE + "=" + +Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID
+                    + "=0", null, null);
+
+    if (noteCursor != null) {
+        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))));
+                // 查询属于该笔记的数据
+                String noteId = noteCursor.getString(NOTE_COLUMN_ID);
+                exportNoteToText(noteId, ps);
+            } while (noteCursor.moveToNext());
+        }
+        noteCursor.close();
+    }
+    ps.close();
+
+    return STATE_SUCCESS;
+}
+
+/**
+ * 获取指向 {@generateExportedTextFile} 文件的打印流
+ */
+private PrintStream getExportToTextPrintStream() {
+    // 在 SD 卡上生成文件
+    File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
+            R.string.file_name_txt_format);
+    if (file == null) {
+        Log.e(TAG, "create file to exported failed");
+        return null;
+    }
+    mFileName = file.getName();
+    mFileDirectory = mContext.getString(R.string.file_path);
+    PrintStream ps = null;
+    try {
+        FileOutputStream fos = new FileOutputStream(file);
+        ps = new PrintStream(fos);
+    } catch (FileNotFoundException e) {
+        e.printStackTrace();
+        return null;
+    } catch (NullPointerException e) {
+        e.printStackTrace();
+        return null;
+    }
+    return ps;
+}
+
+/**
+ * 生成用于存储导入数据的文本文件
+ */
+private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
+    // 构建文件路径
+    StringBuilder sb = new StringBuilder();
+    sb.append(Environment.getExternalStorageDirectory());
+    sb.append(context.getString(filePathResId));
+    File filedir = new File(sb.toString());
+    sb.append(context.getString(
+            fileNameFormatResId,
+            DateFormat.format(context.getString(R.string.format_date_ymd),
+                    System.currentTimeMillis())));
+    File file = new File(sb.toString());
+
+    try {
+        // 创建文件夹和文件
+        if (!filedir.exists()) {
+            filedir.mkdir();
+        }
+        if (!file.exists()) {
+            file.createNewFile();
+        }
+        return file;
+    } catch (SecurityException e) {
+        e.printStackTrace();
+    } catch (IOException e) {
+        e.printStackTrace();
+    }
+
+    return null;
+}
+

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

@@ -0,0 +1,469 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        <url id="ctvqpqeqvl70nnpdm1qg" type="url" status="parsed" title="Apache License, Version 2.0" wc="10467">http://www.apache.org/licenses/LICENSE-2.0</url> 
+ *
+ * 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.
+ */
+// 文件头部包含了版权声明、许可证信息以及对应的 URL 链接，指明该文件遵循 Apache License 2.0 许可证。同时声明该软件是“按原样”提供的，没有明示或暗示的任何形式的保证或条件。
+
+package net.micode.notes.tool;
+// 定义当前类所在的包名，为 net.micode.notes.tool。
+
+import android.content.ContentProviderOperation;
+import android.content.ContentProviderResult;
+import android.content.ContentResolver;
+import android.content.ContentUris;
+import android.content.ContentValues;
+import android.content.OperationApplicationException;
+import android.database.Cursor;
+import android.os.RemoteException;
+import android.util.Log;
+// 导入 Android 相关类库，以便在类中使用这些类的功能。
+
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.CallNote;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.ui.NotesListAdapter.AppWidgetAttribute;
+// 导入本项目中其他包里的类，便于调用这些类的属性和方法。
+
+import java.util.ArrayList;
+import java.util.HashSet;
+// 导入 Java 集合框架中的类，用于在类中使用 ArrayList 和 HashSet。
+
+public class DataUtils {
+    // 定义一个公共类 DataUtils，作为工具类，提供数据操作的方法。
+    public static final String TAG = "DataUtils";
+    // 定义一个公共静态常量 TAG，用于日志输出时标识当前类名。
+
+    public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
+        // 定义一个静态方法 batchDeleteNotes，用于批量删除笔记。
+        // ContentResolver resolver：内容解析器对象，用于对内容提供者进行操作。
+        // HashSet<Long> ids：需要删除的笔记 ID 集合。
+
+        if (ids == null) {
+            // 如果传入的 ids 为 null。
+            Log.d(TAG, "the ids is null");
+            // 输出日志，提示 ids 为 null。
+            return true;
+            // 直接返回 true，表示删除操作成功（因为没有需要删除的笔记）。
+        }
+        if (ids.size() == 0) {
+            // 如果 ids 集合的大小为 0，即没有需要删除的笔记 ID。
+            Log.d(TAG, "no id is in the hashset");
+            // 输出日志，提示没有需要删除的笔记 ID。
+            return true;
+            // 直接返回 true，表示删除操作成功。
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        // 创建一个 ArrayList，用于存储要执行的内容提供者操作。
+
+        for (long id : ids) {
+            // 遍历 ids 集合中的每个笔记 ID。
+            if(id == Notes.ID_ROOT_FOLDER) {
+                // 如果当前 ID 是系统根文件夹的 ID。
+                Log.e(TAG, "Don't delete system folder root");
+                // 输出错误日志，提示不能删除系统根文件夹。
+                continue;
+                // 跳过此次循环，不执行删除操作。
+            }
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            // 创建一个 ContentProviderOperation.Builder 对象，用于构建删除操作。
+            operationList.add(builder.build());
+            // 将构建好的删除操作添加到 operationList 中。
+        }
+        try {
+            // 尝试执行批量删除操作。
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            // 调用 resolver 的 applyBatch 方法，传入 Notes.AUTHORITY 和 operationList，执行批量操作，并返回操作结果数组。
+
+            if (results == null || results.length == 0 || results[0] == null) {
+                // 如果操作结果数组为 null，或者数组长度为 0，或者数组的第一个元素为 null。
+                Log.d(TAG, "delete notes failed, ids:" + ids.toString());
+                // 输出日志，提示删除笔记失败，并打印出需要删除的笔记 IDs。
+                return false;
+                // 返回 false，表示删除操作失败。
+            }
+            return true;
+            // 如果没有异常且删除操作成功，返回 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;
+        // 如果在执行删除操作过程中发生异常，返回 false，表示删除操作失败。
+    }
+
+    public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
+        // 定义一个静态方法 moveNoteToFoler，用于将笔记移动到文件夹。
+        // ContentResolver resolver：内容解析器对象，用于对内容提供者进行操作。
+        // long id：要移动的笔记 ID。
+        // long srcFolderId：笔记的源文件夹 ID。
+        // long desFolderId：要移动到的目标文件夹 ID。
+
+        ContentValues values = new ContentValues();
+        // 创建一个 ContentValues 对象，用于存储笔记的修改信息。
+
+        values.put(NoteColumns.PARENT_ID, desFolderId);
+        // 将笔记的目标父文件夹 ID 存储到 ContentValues 中，修改笔记的 PARENT_ID 列。
+        values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
+        // 将笔记的源父文件夹 ID 存储到 ContentValues 中，修改笔记的 ORIGIN_PARENT_ID 列。
+        values.put(NoteColumns.LOCAL_MODIFIED, 1);
+        // 将笔记的本地修改标志设置为 1，表示笔记已被本地修改。
+
+        resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
+        // 调用 resolver 的 update 方法，传入笔记的内容 URI 和修改后的 ContentValues，更新笔记数据。
+        // ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)：根据笔记 ID 构建笔记的内容 URI。
+        // values：包含笔记修改信息的 ContentValues。
+        // null 和 null：查询条件和查询条件参数，这里不需要查询条件。
+    }
+
+    public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids, long folderId) {
+        // 定义一个静态方法 batchMoveToFolder，用于批量移动笔记到文件夹。
+        // ContentResolver resolver：内容解析器对象，用于对内容提供者进行操作。
+        // HashSet<Long> ids：需要移动的笔记 ID 集合。
+        // long folderId：目标文件夹 ID。
+
+        if (ids == null) {
+            // 如果传入的 ids 为 null。
+            Log.d(TAG, "the ids is null");
+            // 输出日志，提示 ids 为 null。
+            return true;
+            // 直接返回 true，表示移动操作成功（因为没有需要移动的笔记）。
+        }
+
+        ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
+        // 创建一个 ArrayList，用于存储要执行的内容提供者操作。
+
+        for (long id : ids) {
+            // 遍历 ids 集合中的每个笔记 ID。
+            ContentProviderOperation.Builder builder = ContentProviderOperation
+                    .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
+            // 创建一个 ContentProviderOperation.Builder 对象，用于构建更新操作。
+            builder.withValue(NoteColumns.PARENT_ID, folderId);
+            // 设置更新操作中笔记的父文件夹 ID 为传入的目标文件夹 ID。
+            builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);
+            // 设置更新操作中笔记的本地修改标志为 1。
+            operationList.add(builder.build());
+            // 将构建好的更新操作添加到 operationList 中。
+        }
+
+        try {
+            // 尝试执行批量移动操作。
+            ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
+            // 调用 resolver 的 applyBatch 方法，传入 Notes.AUTHORITY 和 operationList，执行批量操作
+            if (results == null || results.length == 0 || results[0] == null) {
+                // 如果操作结果数组为 null，或者数组长度为 0，或者数组的第一个元素为 null。
+                Log.d(TAG, "delete notes failed, ids:" + ids.toString());
+                // 输出日志，提示移动笔记失败，并打印出需要移动的笔记 IDs。
+                return false;
+                // 返回 false，表示移动操作失败。
+            }
+            return true;
+            // 如果没有异常且移动操作成功，返回 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;
+        // 如果在执行移动操作过程中发生异常，返回 false，表示移动操作失败。
+    }
+
+    public static int getUserFolderCount(ContentResolver resolver) {
+        // 定义一个静态方法 getUserFolderCount，用于获取用户文件夹的数量（不包括系统文件夹）。
+        // ContentResolver resolver：内容解析器对象，用于对内容提供者进行操作。
+
+        Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[] { "COUNT(*)" },
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
+                new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
+                null);
+        // 调用 resolver 的 query 方法，查询 Notes.CONTENT_NOTE_URI，获取用户文件夹的数量。
+        // new String[] { "COUNT(*)" }：查询投影，只查询文件夹数量。
+        // NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?"：查询条件，文件夹类型且父文件夹 ID 不等于回收站 ID。
+        // new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)}：查询条件参数。
+
+        int count = 0;
+        // 初始化文件夹数量为 0。
+
+        if(cursor != null) {
+            // 如果查询结果游标不为 null。
+            if(cursor.moveToFirst()) {
+                // 将游标移动到第一条记录。
+                try {
+                    count = cursor.getInt(0);
+                    // 获取查询结果中的文件夹数量。
+                } catch (IndexOutOfBoundsException e) {
+                    // 如果在获取文件夹数量时发生索引越界异常。
+                    Log.e(TAG, "get folder count failed:" + e.toString());
+                    // 输出错误日志，打印出异常信息。
+                } finally {
+                    cursor.close();
+                    // 关闭游标，释放资源。
+                }
+            }
+        }
+        return count;
+        // 返回用户文件夹的数量。
+    }
+
+    public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) {
+        // 定义一个静态方法 visibleInNoteDatabase，用于检查指定的笔记 ID 是否存在于笔记数据库中（不包括回收站）。
+        // ContentResolver resolver：内容解析器对象，用于对内容提供者进行操作。
+        // long noteId：要检查的笔记 ID。
+        // int type：笔记类型。
+
+        Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+                null,
+                NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER,
+                new String [] {String.valueOf(type)},
+                null);
+        // 调用 resolver 的 query 方法，查询指定笔记 ID 的笔记是否存在。
+        // ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId)：根据笔记 ID 构建笔记的内容 URI。
+        // null：查询投影，这里不需要指定查询列。
+        // NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER：查询条件，笔记类型且父文件夹 ID 不等于回收站 ID。
+        // new String [] {String.valueOf(type)}：查询条件参数。
+
+        boolean exist = false;
+        // 初始化笔记是否存在为 false。
+
+        if (cursor != null) {
+            // 如果查询结果游标不为 null。
+            if (cursor.getCount() > 0) {
+                // 如果查询结果的数量大于 0，说明笔记存在。
+                exist = true;
+            }
+            cursor.close();
+            // 关闭游标，释放资源。
+        }
+        return exist;
+        // 返回笔记是否存在。
+    }
+    // 检查指定的笔记 ID 是否存在于笔记数据库中
+public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
+    // 使用 ContentUris.withAppendedId() 方法将笔记 ID 附加到笔记内容 URI 后面，构建查询特定笔记的 URI
+    Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
+            null, null, null, null);
+
+    // 默认笔记不存在
+    boolean exist = false;
+    // 如果查询结果的游标不为空
+    if (cursor != null) {
+        // 如果游标中包含至少一条记录
+        if (cursor.getCount() > 0) {
+            // 表示笔记存在
+            exist = true;
+        }
+        // 关闭游标以释放资源
+        cursor.close();
+    }
+    // 返回笔记是否存在
+    return exist;
+}
+
+// 检查指定的数据 ID 是否存在于数据数据库中
+public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
+    // 使用 ContentUris.withAppendedId() 方法将数据 ID 附加到数据内容 URI 后面，构建查询特定数据的 URI
+    Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
+            null, null, null, null);
+
+    // 默认数据不存在
+    boolean exist = false;
+    // 如果查询结果的游标不为空
+    if (cursor != null) {
+        // 如果游标中包含至少一条记录
+        if (cursor.getCount() > 0) {
+            // 表示数据存在
+            exist = true;
+        }
+        // 关闭游标以释放资源
+        cursor.close();
+    }
+    // 返回数据是否存在
+    return exist;
+}
+
+// 检查指定的文件夹名称是否已存在于可见文件夹中
+public static boolean checkVisibleFolderName(ContentResolver resolver, String name) {
+    // 查询笔记内容 URI，筛选出类型为文件夹、父 ID 不等于回收站文件夹 ID、且摘要等于指定名称的笔记
+    Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null,
+            NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER +
+            " AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
+            " AND " + NoteColumns.SNIPPET + "=?",
+            new String[] { name }, null);
+    // 默认名称不存在
+    boolean exist = false;
+    // 如果查询结果的游标不为空
+    if(cursor != null) {
+        // 如果游标中包含至少一条记录
+        if(cursor.getCount() > 0) {
+            // 表示名称已存在
+            exist = true;
+        }
+        // 关闭游标以释放资源
+        cursor.close();
+    }
+    // 返回名称是否存在
+    return exist;
+}
+
+    // 获取指定文件夹 ID 下的笔记小部件属性集合
+    public static HashSet<AppWidgetAttribute> getFolderNoteWidget(ContentResolver resolver, long folderId) {
+        // 查询笔记内容 URI，筛选出父 ID 等于指定文件夹 ID 的笔记，获取小部件 ID 和类型
+        Cursor c = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE },
+                NoteColumns.PARENT_ID + "=?",
+                new String[] { String.valueOf(folderId) },
+                null);
+
+        // 初始化小部件属性集合
+        HashSet<AppWidgetAttribute> set = null;
+        // 如果查询结果的游标不为空
+        if (c != null) {
+            // 如果游标可以移动到第一条记录
+            if (c.moveToFirst()) {
+                // 创建小部件属性集合
+                set = new HashSet<AppWidgetAttribute>();
+                // 遍历游标中的所有记录
+                do {
+                    try {
+                        // 创建小部件属性对象
+                        AppWidgetAttribute widget = new AppWidgetAttribute();
+                        // 设置小部件 ID 和类型
+                        widget.widgetId = c.getInt(0);
+                        widget.widgetType = c.getInt(1);
+                        // 将小部件属性添加到集合中
+                        set.add(widget);
+                    } catch (IndexOutOfBoundsException e) {
+                        // 如果索引越界，记录错误日志
+                        Log.e(TAG, e.toString());
+                    }
+                } while (c.moveToNext());
+            }
+            // 关闭游标以释放资源
+            c.close();
+        }
+        // 返回小部件属性集合
+        return set;
+    }
+
+    // 根据笔记 ID 获取电话号码
+    public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) {
+        // 查询数据内容 URI，筛选出笔记 ID 等于指定 ID、MIME 类型为电话号码的记录，获取电话号码
+        Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
+                new String [] { CallNote.PHONE_NUMBER },
+                CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?",
+                new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
+                null);
+
+        // 如果查询结果的游标不为空且可以移动到第一条记录
+        if (cursor != null && cursor.moveToFirst()) {
+            try {
+                // 返回电话号码
+                return cursor.getString(0);
+            } catch (IndexOutOfBoundsException e) {
+                // 如果索引越界，记录错误日志
+                Log.e(TAG, "Get call number fails " + e.toString());
+            } finally {
+                // 关闭游标以释放资源
+                cursor.close();
+            }
+        }
+        // 如果查询失败，返回空字符串
+        return "";
+    }
+
+    // 根据电话号码和通话日期获取笔记 ID
+    public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
+        // 查询数据内容 URI，筛选出通话日期等于指定日期、MIME 类型为电话号码、且电话号码匹配的记录，获取笔记 ID
+        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);
+
+        // 如果查询结果的游标不为空
+        if (cursor != null) {
+            // 如果游标可以移动到第一条记录
+            if (cursor.moveToFirst()) {
+                try {
+                    // 返回笔记 ID
+                    return cursor.getLong(0);
+                } catch (IndexOutOfBoundsException e) {
+                    // 如果索引越界，记录错误日志
+                    Log.e(TAG, "Get call note id fails " + e.toString());
+                }
+            }
+            // 关闭游标以释放资源
+            cursor.close();
+        }
+        // 如果查询失败，返回 0
+        return 0;
+    }
+
+    // 根据笔记 ID 获取摘要信息
+    public static String getSnippetById(ContentResolver resolver, long noteId) {
+        // 查询笔记内容 URI，筛选出 ID 等于指定笔记 ID 的记录，获取摘要信息
+        Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
+                new String [] { NoteColumns.SNIPPET },
+                NoteColumns.ID + "=?",
+                new String [] { String.valueOf(noteId)},
+                null);
+
+        // 如果查询结果的游标不为空
+        if (cursor != null) {
+            // 初始化摘要信息为空字符串
+            String snippet = "";
+            // 如果游标可以移动到第一条记录
+            if (cursor.moveToFirst()) {
+                // 获取并设置摘要信息
+                snippet = cursor.getString(0);
+            }
+            // 关闭游标以释放资源
+            cursor.close();
+            // 返回摘要信息
+            return snippet;
+        }
+        // 如果查询失败，抛出 IllegalArgumentException 异常
+        throw new IllegalArgumentException("Note is not found with id: " + noteId);
+    }
+
+    // 格式化摘要信息，去除多余换行符
+    public static String getFormattedSnippet(String snippet) {
+        // 如果摘要信息不为空
+        if (snippet != null) {
+            // 去除首尾空白字符
+            snippet = snippet.trim();
+            // 查找第一个换行符的索引
+            int index = snippet.indexOf('\n');
+            // 如果找到换行符
+            if (index != -1) {
+                // 截取换行符之前的部分作为格式化后的摘要信息
+                snippet = snippet.substring(0, index);
+            }
+        }
+        // 返回格式化后的摘要信息
+        return snippet;
+    }
+}

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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,100 +14,147 @@
  * limitations under the License.
  */
 
+// 声明包名
 package net.micode.notes.tool;
 
+// 声明一个名为 GTaskStringUtils 的公共类
 public class GTaskStringUtils {
 
+    // 定义 JSON 中动作 ID 的键
     public final static String GTASK_JSON_ACTION_ID = "action_id";
 
+    // 定义 JSON 中动作列表的键
     public final static String GTASK_JSON_ACTION_LIST = "action_list";
 
+    // 定义 JSON 中动作类型的键
     public final static String GTASK_JSON_ACTION_TYPE = "action_type";
 
+    // 定义 JSON 中创建动作类型的值
     public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
 
+    // 定义 JSON 中获取全部动作类型的值
     public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
 
+    // 定义 JSON 中移动动作类型的值
     public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
 
+    // 定义 JSON 中更新动作类型的值
     public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
 
+    // 定义 JSON 中创建者 ID 的键
     public final static String GTASK_JSON_CREATOR_ID = "creator_id";
 
+    // 定义 JSON 中子实体的键
     public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
 
+    // 定义 JSON 中客户端版本的键
     public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
 
+    // 定义 JSON 中完成状态的键
     public final static String GTASK_JSON_COMPLETED = "completed";
 
+    // 定义 JSON 中当前列表 ID 的键
     public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
 
+    // 定义 JSON 中默认列表 ID 的键
     public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
 
+    // 定义 JSON 中删除状态的键
     public final static String GTASK_JSON_DELETED = "deleted";
 
+    // 定义 JSON 中目标列表的键
     public final static String GTASK_JSON_DEST_LIST = "dest_list";
 
+    // 定义 JSON 中目标父实体的键
     public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
 
+    // 定义 JSON 中目标父实体类型的键
     public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
 
+    // 定义 JSON 中实体差异的键
     public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
 
+    // 定义 JSON 中实体类型的键
     public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
 
+    // 定义 JSON 中获取删除状态的键
     public final static String GTASK_JSON_GET_DELETED = "get_deleted";
 
+    // 定义 JSON 中 ID 的键
     public final static String GTASK_JSON_ID = "id";
 
+    // 定义 JSON 中索引的键
     public final static String GTASK_JSON_INDEX = "index";
 
+    // 定义 JSON 中最后修改时间的键
     public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
 
+    // 定义 JSON 中最新同步点的键
     public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
 
+    // 定义 JSON 中列表 ID 的键
     public final static String GTASK_JSON_LIST_ID = "list_id";
 
+    // 定义 JSON 中列表的键
     public final static String GTASK_JSON_LISTS = "lists";
 
+    // 定义 JSON 中名称的键
     public final static String GTASK_JSON_NAME = "name";
 
+    // 定义 JSON 中新 ID 的键
     public final static String GTASK_JSON_NEW_ID = "new_id";
 
+    // 定义 JSON 中笔记的键
     public final static String GTASK_JSON_NOTES = "notes";
 
+    // 定义 JSON 中父 ID 的键
     public final static String GTASK_JSON_PARENT_ID = "parent_id";
 
+    // 定义 JSON 中前一个兄弟 ID 的键
     public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
 
+    // 定义 JSON 中结果的键
     public final static String GTASK_JSON_RESULTS = "results";
 
+    // 定义 JSON 中源列表的键
     public final static String GTASK_JSON_SOURCE_LIST = "source_list";
 
+    // 定义 JSON 中任务的键
     public final static String GTASK_JSON_TASKS = "tasks";
 
+    // 定义 JSON 中类型的键
     public final static String GTASK_JSON_TYPE = "type";
 
+    // 定义 JSON 中组类型的值
     public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
 
+    // 定义 JSON 中任务类型的值
     public final static String GTASK_JSON_TYPE_TASK = "TASK";
 
+    // 定义 JSON 中用户的键
     public final static String GTASK_JSON_USER = "user";
 
+    // 定义 MIUI 笔记文件夹前缀
     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";
 
+    // 定义元数据头部 GTASK ID 的键
     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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,32 +14,41 @@
  * limitations under the License.
  */
 
+// 声明包名
 package net.micode.notes.tool;
 
+// 导入相关类
 import android.content.Context;
 import android.preference.PreferenceManager;
 
 import net.micode.notes.R;
 import net.micode.notes.ui.NotesPreferenceActivity;
 
+// 声明一个名为 ResourceParser 的公共类
 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;
 
+    // 声明一个名为 NoteBgResources 的公共静态内部类
     public static class NoteBgResources {
+        // 定义编辑笔记背景资源的数组
         private final static int [] BG_EDIT_RESOURCES = new int [] {
             R.drawable.edit_yellow,
             R.drawable.edit_blue,
@@ -48,6 +57,7 @@ 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,
@@ -56,25 +66,32 @@ public class ResourceParser {
             R.drawable.edit_title_red
         };
 
+        // 根据 id 获取笔记背景资源的方法
         public static int getNoteBgResource(int id) {
             return BG_EDIT_RESOURCES[id];
         }
 
+        // 根据 id 获取笔记标题背景资源的方法
         public static int getNoteTitleBgResource(int id) {
             return BG_EDIT_TITLE_RESOURCES[id];
         }
     }
 
+    // 获取默认笔记背景 id 的方法
     public static int getDefaultBgId(Context context) {
+        // 如果用户设置了背景颜色，则随机返回一个背景颜色 id
         if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
                 NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
             return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
         } else {
+            // 否则返回默认背景颜色 id
             return BG_DEFAULT_COLOR;
         }
     }
 
+    // 声明一个名为 NoteItemBgResources 的公共静态内部类
     public static class NoteItemBgResources {
+        // 定义笔记列表项背景资源的数组
         private final static int [] BG_FIRST_RESOURCES = new int [] {
             R.drawable.list_yellow_up,
             R.drawable.list_blue_up,
@@ -96,7 +113,6 @@ public class ResourceParser {
             R.drawable.list_blue_down,
             R.drawable.list_white_down,
             R.drawable.list_green_down,
-            R.drawable.list_red_down,
         };
 
         private final static int [] BG_SINGLE_RESOURCES = new int [] {
@@ -107,28 +123,35 @@ public class ResourceParser {
             R.drawable.list_red_single
         };
 
+        // 获取笔记列表项第一个背景资源的方法
         public static int getNoteBgFirstRes(int id) {
             return BG_FIRST_RESOURCES[id];
         }
 
+        // 获取笔记列表项最后一个背景资源的方法
         public static int getNoteBgLastRes(int id) {
             return BG_LAST_RESOURCES[id];
         }
 
+        // 获取笔记列表项单个背景资源的方法
         public static int getNoteBgSingleRes(int id) {
             return BG_SINGLE_RESOURCES[id];
         }
 
+        // 获取笔记列表项普通背景资源的方法
         public static int getNoteBgNormalRes(int id) {
             return BG_NORMAL_RESOURCES[id];
         }
 
+        // 获取文件夹背景资源的方法
         public static int getFolderBgRes() {
             return R.drawable.list_folder;
         }
     }
 
+    // 声明一个名为 WidgetBgResources 的公共静态内部类
     public static class WidgetBgResources {
+        // 定义 2x 小部件背景资源的数组
         private final static int [] BG_2X_RESOURCES = new int [] {
             R.drawable.widget_2x_yellow,
             R.drawable.widget_2x_blue,
@@ -137,10 +160,12 @@ public class ResourceParser {
             R.drawable.widget_2x_red,
         };
 
+        // 根据 id 获取 2x 小部件背景资源的方法
         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,
@@ -149,12 +174,15 @@ public class ResourceParser {
             R.drawable.widget_4x_red
         };
 
+        // 根据 id 获取 4x 小部件背景资源的方法
         public static int getWidget4xBgResource(int id) {
             return BG_4X_RESOURCES[id];
         }
     }
 
+    // 声明一个名为 TextAppearanceResources 的公共静态内部类
     public static class TextAppearanceResources {
+        // 定义文本外观资源的数组
         private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
             R.style.TextAppearanceNormal,
             R.style.TextAppearanceMedium,
@@ -162,11 +190,12 @@ public class ResourceParser {
             R.style.TextAppearanceSuper
         };
 
+        // 根据 id 获取文本外观资源的方法
         public static int getTexAppearanceResource(int 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}
+             * HACKME: 修复存储资源 id 到共享偏好设置中的 bug。
+             * 资源 id 可能大于资源数组的长度，在这种情况下，
+             * 返回 {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
              */
             if (id >= TEXTAPPEARANCE_RESOURCES.length) {
                 return BG_DEFAULT_FONT_SIZE;
@@ -174,8 +203,9 @@ public class ResourceParser {
             return TEXTAPPEARANCE_RESOURCES[id];
         }
 
+        // 获取文本外观资源数组大小的方法
         public static int getResourcesSize() {
             return TEXTAPPEARANCE_RESOURCES.length;
         }
     }
-}
+}

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

@@ -0,0 +1,171 @@
+// 声明版权信息，表明该文件由MiCode开源社区在2010-2011年间编写，并遵循Apache License 2.0许可协议
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0 
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui; // 指定该类所在的包名
+
+import android.app.Activity; // 导入Activity类，用于创建活动界面
+import android.app.AlertDialog; // 导入AlertDialog类，用于显示对话框
+import android.content.Context; // 导入Context类，用于获取应用程序上下文
+import android.content.DialogInterface; // 导入DialogInterface类，用于对话框事件监听
+import android.content.DialogInterface.OnClickListener; // 导入OnClickListener接口，用于监听对话框按钮点击事件
+import android.content.DialogInterface.OnDismissListener; // 导入OnDismissListener接口，用于监听对话框消失事件
+import android.content.Intent; // 导入Intent类，用于在组件之间传递消息
+import android.media.AudioManager; // 导入AudioManager类，用于管理音频设置
+import android.media.MediaPlayer; // 导入MediaPlayer类，用于播放媒体文件
+import android.media.RingtoneManager; // 导入RingtoneManager类，用于管理铃声
+import android.net.Uri; // 导入Uri类，用于表示统一资源标识符
+import android.os.Bundle; // 导入Bundle类，用于传递数据
+import android.os.PowerManager; // 导入PowerManager类，用于管理电源设置
+import android.provider.Settings; // 导入Settings类，用于访问系统设置
+import android.view.Window; // 导入Window类，用于管理窗口
+import android.view.WindowManager; // 导入WindowManager类，用于管理窗口属性
+
+import net.micode.notes.R; // 导入应用程序的资源文件
+import net.micode.notes.data.Notes; // 导入Notes类，用于处理笔记数据
+import net.micode.notes.tool.DataUtils; // 导入DataUtils类，用于数据处理工具
+
+import java.io.IOException; // 导入IOException类，用于处理输入/输出异常
+public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
+    private long mNoteId; // 声明一个长整型变量mNoteId，用于存储笔记ID
+    private String mSnippet; // 声明一个字符串变量mSnippet，用于存储笔记摘要
+    private static final int SNIPPET_PREW_MAX_LEN = 60; // 定义常量SNIPPET_PREW_MAX_LEN，表示笔记摘要的最大长度
+    MediaPlayer mPlayer; // 声明一个MediaPlayer对象mPlayer，用于播放提醒音
+
+    // 重写Activity类的onCreate方法，用于初始化活动界面
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState); // 调用父类的onCreate方法
+        requestWindowFeature(Window.FEATURE_NO_TITLE); // 请求无标题窗口特性
+
+        final Window win = getWindow(); // 获取当前窗口对象
+        win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); // 设置窗口在锁定状态下显示
+
+        // 如果屏幕未开启，则设置窗口属性以保持屏幕亮起、在屏幕关闭时开启屏幕、允许在屏幕亮起时锁定
+        if (!isScreenOn()) {
+            win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
+                    | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
+        }
+
+        Intent intent = getIntent(); // 获取启动该活动的Intent对象
+
+        try {
+            // 从Intent中获取笔记ID，并根据ID获取笔记摘要
+            mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
+            mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId);
+            // 如果摘要长度超过最大长度，则截取并添加省略号
+            mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0,
+                    SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info)
+                    : mSnippet;
+        } catch (IllegalArgumentException e) {
+            e.printStackTrace(); // 打印异常信息
+            return; // 如果发生异常，则返回
+        }
+
+        mPlayer = new MediaPlayer(); // 创建MediaPlayer对象
+        // 如果笔记类型为普通笔记，则显示操作对话框并播放提醒音
+        if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
+            showActionDialog();
+            playAlarmSound();
+        } else {
+            finish(); // 如果笔记类型不为普通笔记，则结束活动
+        }
+    }
+
+    // 定义isScreenOn方法，用于判断屏幕是否开启
+    private boolean isScreenOn() {
+        PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE); // 获取电源管理服务
+        return pm.isScreenOn(); // 返回屏幕是否开启的状态
+    }
+
+    // 定义playAlarmSound方法，用于播放提醒音
+    private void playAlarmSound() {
+        Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM); // 获取默认提醒音的URI
+
+        // 获取静音模式下影响的音频流类型
+        int silentModeStreams = Settings.System.getInt(getContentResolver(),
+                Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
+
+        // 根据静音模式设置音频流类型
+        if ((silentModeStreams & (1 << AudioManager.STREAM_ALARM)) != 0) {
+            mPlayer.setAudioStreamType(silentModeStreams);
+        } else {
+            mPlayer.setAudioStreamType(AudioManager.STREAM_ALARM);
+        }
+        try {
+            mPlayer.setDataSource(this, url); // 设置MediaPlayer的数据源
+            mPlayer.prepare(); // 准备MediaPlayer
+            mPlayer.setLooping(true); // 设置提醒音循环播放
+            mPlayer.start(); // 开始播放提醒音
+        } catch (IllegalArgumentException e) {
+            // TODO Auto-generated catch block
+            e.printStackTrace(); // 打印异常信息
+        } catch (SecurityException e) {
+            // TODO Auto-generated catch block
+            e.printStackTrace(); // 打印异常信息
+        } catch (IllegalStateException e) {
+            // TODO Auto-generated catch block
+            e.printStackTrace(); // 打印异常信息
+        } catch (IOException e) {
+            // TODO Auto-generated catch block
+            e.printStackTrace(); // 打印异常信息
+        }
+    }
+
+    // 定义showActionDialog方法，用于显示操作对话框
+    private void showActionDialog() {
+        AlertDialog.Builder dialog = new AlertDialog.Builder(this); // 创建AlertDialog.Builder对象
+        dialog.setTitle(R.string.app_name); // 设置对话框标题
+        dialog.setMessage(mSnippet); // 设置对话框消息为笔记摘要
+        dialog.setPositiveButton(R.string.notealert_ok, this); // 设置对话框的“确定”按钮
+        if (isScreenOn()) {
+            dialog.setNegativeButton(R.string.notealert_enter, this); // 如果屏幕开启，则设置对话框的“进入”按钮
+        }
+        dialog.show().setOnDismissListener(this); // 显示对话框并设置对话框消失监听器
+    }
+
+    // 实现OnClickListener接口的onClick方法，用于处理对话框按钮点击事件
+    public void onClick(DialogInterface dialog, int which) {
+        switch (which) {
+            case DialogInterface.BUTTON_NEGATIVE:
+                // 如果点击“进入”按钮，则启动NoteEditActivity并传递笔记ID
+                Intent intent = new Intent(this, NoteEditActivity.class);
+                intent.setAction(Intent.ACTION_VIEW);
+                intent.putExtra(Intent.EXTRA_UID, mNoteId);
+                startActivity(intent);
+                break;
+            default:
+                break;
+        }
+    }
+
+    // 实现OnDismissListener接口的onDismiss方法，用于处理对话框消失事件
+    public void onDismiss(DialogInterface dialog) {
+        stopAlarmSound(); // 停止提醒音
+        finish(); // 结束活动
+    }
+
+    // 定义stopAlarmSound方法，用于停止提醒音
+    private void stopAlarmSound() {
+        if (mPlayer != null) {
+            mPlayer.stop(); // 停止MediaPlayer
+            mPlayer.release(); // 释放MediaPlayer资源
+            mPlayer = null; // 将MediaPlayer对象置为空
+        }
+    }
+}

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

@@ -0,0 +1,75 @@
+// 声明版权信息，表明该文件由MiCode开源社区在2010-2011年间编写，并遵循Apache License 2.0许可协议
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0 
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.ui; // 
+
+import android.app.AlarmManager; // 导入AlarmManager类，用于设置和管理提醒
+import android.app.PendingIntent; // 导入PendingIntent类，用于创建待发送的Intent
+import android.content.BroadcastReceiver; // 导入BroadcastReceiver类，用于接收广播
+import android.content.ContentUris; // 导入ContentUris类，用于处理内容URI
+import android.content.Context; // 导入Context类，用于获取应用程序上下文
+import android.content.Intent; // 导入Intent类，用于在组件之间传递消息
+import android.database.Cursor; // 导入Cursor类，用于访问数据库查询结果
+
+import net.micode.notes.data.Notes; // 导入Notes类，用于处理笔记数据
+import net.micode.notes.data.Notes.NoteColumns; // 导入NoteColumns类，用于访问笔记列信息
+
+// 定义AlarmInitReceiver类，继承自BroadcastReceiver类
+public class AlarmInitReceiver extends BroadcastReceiver {
+
+    // 定义查询投影，包含笔记ID和提醒日期列
+    private static final String [] PROJECTION = new String [] {
+        NoteColumns.ID, // 笔记ID列
+        NoteColumns.ALERTED_DATE // 提醒日期列
+    };
+
+    // 定义列索引常量
+    private static final int COLUMN_ID                = 0; // 笔记ID列索引
+    private static final int COLUMN_ALERTED_DATE      = 1; // 提醒日期列索引
+
+    // 重写BroadcastReceiver类的onReceive方法，用于处理接收到的广播
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        long currentDate = System.currentTimeMillis(); // 获取当前时间戳
+        // 查询笔记内容提供者，获取未提醒的普通笔记
+        Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
+                PROJECTION,
+                NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
+                new String[] { String.valueOf(currentDate) },
+                null);
+
+        if (c != null) { // 如果查询结果不为空
+            if (c.moveToFirst()) { // 移动到第一条记录
+                do {
+                    // 获取笔记的提醒日期
+                    long alertDate = c.getLong(COLUMN_ALERTED_DATE);
+                    // 创建一个Intent，用于启动AlarmReceiver
+                    Intent sender = new Intent(context, AlarmReceiver.class);
+                    // 设置Intent的数据为笔记的URI
+                    sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
+                    // 创建一个PendingIntent，用于在提醒时间发送广播
+                    PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
+                    // 获取AlarmManager服务
+                    AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
+                    // 设置提醒，使用RTC_WAKEUP模式在提醒时间唤醒设备并发送PendingIntent
+                    alarmManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
+                } while (c.moveToNext()); // 继续处理下一条记录
+            }
+            c.close(); // 关闭Cursor
+        }
+    }
+}

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

@@ -1,3 +1,4 @@
+// 声明版权信息，表明该文件由MiCode开源社区在2010-2011年间编写，并遵循Apache License 2.0许可协议
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -5,26 +6,30 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
- * Unless required by applicable law or agreed to in writing, software
+
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 
-package net.micode.notes.ui;
+package net.micode.notes.ui; // 指定该类所在的包名
 
-import android.content.BroadcastReceiver;
-import android.content.Context;
-import android.content.Intent;
+import android.content.BroadcastReceiver; // 导入BroadcastReceiver类，用于接收广播
+import android.content.Context; // 导入Context类，用于获取应用程序上下文
+import android.content.Intent; // 导入Intent类，用于在组件之间传递消息
 
 public class AlarmReceiver extends BroadcastReceiver {
+    // 重写BroadcastReceiver类的onReceive方法，用于处理接收到的广播
     @Override
     public void onReceive(Context context, Intent intent) {
+        // 设置Intent的目标类为AlarmAlertActivity，即当广播接收时启动AlarmAlertActivity
         intent.setClass(context, AlarmAlertActivity.class);
+        // 添加标志，表示启动一个新的任务栈
         intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+        // 使用上下文启动Intent指定的活动
         context.startActivity(intent);
     }
-}
+}

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

@@ -1,3 +1,4 @@
+// 声明版权信息，表明该文件由MiCode开源社区在2010-2011年间编写，并遵循Apache License 2.0许可协议
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -5,7 +6,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -14,71 +15,78 @@
  * limitations under the License.
  */
 
-package net.micode.notes.ui;
+// 导入所需的包和类
+package net.micode.notes.ui; // 指定该类所在的包名
 
-import java.text.DateFormatSymbols;
-import java.util.Calendar;
+import java.text.DateFormatSymbols; // 导入DateFormatSymbols类，用于获取日期格式符号
+import java.util.Calendar; // 导入Calendar类，用于日期和时间操作
 
-import net.micode.notes.R;
+import net.micode.notes.R; // 导入应用程序的资源文件
 
+import android.content.Context; // 导入Context类，用于获取应用程序上下文
+import android.text.format.DateFormat; // 导入DateFormat类，用于日期格式化
+import android.view.View; // 导入View类，用于视图操作
+import android.widget.FrameLayout; // 导入FrameLayout类，用于布局
+import android.widget.NumberPicker; // 导入NumberPicker类，用于数字选择器
 
-import android.content.Context;
-import android.text.format.DateFormat;
-import android.view.View;
-import android.widget.FrameLayout;
-import android.widget.NumberPicker;
-
+// 定义DateTimePicker类，继承自FrameLayout类
 public class DateTimePicker extends FrameLayout {
 
-    private static final boolean DEFAULT_ENABLE_STATE = true;
-
-    private static final int HOURS_IN_HALF_DAY = 12;
-    private static final int HOURS_IN_ALL_DAY = 24;
-    private static final int DAYS_IN_ALL_WEEK = 7;
-    private static final int DATE_SPINNER_MIN_VAL = 0;
-    private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
-    private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
-    private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
-    private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
-    private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
-    private static final int MINUT_SPINNER_MIN_VAL = 0;
-    private static final int MINUT_SPINNER_MAX_VAL = 59;
-    private static final int AMPM_SPINNER_MIN_VAL = 0;
-    private static final int AMPM_SPINNER_MAX_VAL = 1;
-
-    private final NumberPicker mDateSpinner;
-    private final NumberPicker mHourSpinner;
-    private final NumberPicker mMinuteSpinner;
-    private final NumberPicker mAmPmSpinner;
-    private Calendar mDate;
-
+    // 定义常量
+    private static final boolean DEFAULT_ENABLE_STATE = true; // 默认启用状态
+    private static final int HOURS_IN_HALF_DAY = 12; // 半天的小时数
+    private static final int HOURS_IN_ALL_DAY = 24; // 一天的小时数
+    private static final int DAYS_IN_ALL_WEEK = 7; // 一周的天数
+    private static final int DATE_SPINNER_MIN_VAL = 0; // 日期选择器的最小值
+    private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; // 日期选择器的最大值
+    private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; // 24小时视图的小时选择器最小值
+    private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; // 24小时视图的小时选择器最大值
+    private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; // 12小时视图的小时选择器最小值
+    private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12; // 12小时视图的小时选择器最大值
+    private static final int MINUT_SPINNER_MIN_VAL = 0; // 分钟选择器的最小值
+    private static final int MINUT_SPINNER_MAX_VAL = 59; // 分钟选择器的最大值
+    private static final int AMPM_SPINNER_MIN_VAL = 0; // 上午/下午选择器的最小值
+    private static final int AMPM_SPINNER_MAX_VAL = 1; // 上午/下午选择器的最大值
+
+    // 定义成员变量
+    private final NumberPicker mDateSpinner; // 日期选择器
+    private final NumberPicker mHourSpinner; // 小时选择器
+    private final NumberPicker mMinuteSpinner; // 分钟选择器
+    private final NumberPicker mAmPmSpinner; // 上午/下午选择器
+    private Calendar mDate; // 当前日期
+
+    // 定义日期显示值数组
     private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
 
-    private boolean mIsAm;
-
-    private boolean mIs24HourView;
-
-    private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
-
-    private boolean mInitialising;
+    // 定义状态变量
+    private boolean mIsAm; // 是否为上午
+    private boolean mIs24HourView; // 是否为24小时视图
+    private boolean mIsEnabled = DEFAULT_ENABLE_STATE; // 是否启用
+    private boolean mInitialising; // 是否正在初始化
 
+    // 定义日期时间更改监听器
     private OnDateTimeChangedListener mOnDateTimeChangedListener;
 
+    // 定义日期更改监听器
     private NumberPicker.OnValueChangeListener mOnDateChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 更新日期
             mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
-            updateDateControl();
-            onDateTimeChanged();
+            updateDateControl(); // 更新日期控件
+            onDateTimeChanged(); // 触发日期时间更改事件
         }
     };
 
+    // 定义小时更改监听器
     private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 处理小时更改逻辑
             boolean isDateChanged = false;
             Calendar cal = Calendar.getInstance();
             if (!mIs24HourView) {
+                // 12小时视图的逻辑
                 if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
@@ -94,6 +102,7 @@ public class DateTimePicker extends FrameLayout {
                     updateAmPmControl();
                 }
             } else {
+                // 24小时视图的逻辑
                 if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
                     cal.setTimeInMillis(mDate.getTimeInMillis());
                     cal.add(Calendar.DAY_OF_YEAR, 1);
@@ -104,10 +113,12 @@ public class DateTimePicker extends FrameLayout {
                     isDateChanged = true;
                 }
             }
+            // 更新小时
             int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);
             mDate.set(Calendar.HOUR_OF_DAY, newHour);
             onDateTimeChanged();
             if (isDateChanged) {
+                // 更新日期
                 setCurrentYear(cal.get(Calendar.YEAR));
                 setCurrentMonth(cal.get(Calendar.MONTH));
                 setCurrentDay(cal.get(Calendar.DAY_OF_MONTH));
@@ -115,9 +126,11 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 定义分钟更改监听器
     private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 处理分钟更改逻辑
             int minValue = mMinuteSpinner.getMinValue();
             int maxValue = mMinuteSpinner.getMaxValue();
             int offset = 0;
@@ -127,6 +140,7 @@ public class DateTimePicker extends FrameLayout {
                 offset -= 1;
             }
             if (offset != 0) {
+                // 更新日期和小时
                 mDate.add(Calendar.HOUR_OF_DAY, offset);
                 mHourSpinner.setValue(getCurrentHour());
                 updateDateControl();
@@ -139,14 +153,17 @@ public class DateTimePicker extends FrameLayout {
                     updateAmPmControl();
                 }
             }
+            // 更新分钟
             mDate.set(Calendar.MINUTE, newVal);
             onDateTimeChanged();
         }
     };
 
+    // 定义上午/下午更改监听器
     private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
         @Override
         public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
+            // 切换上午/下午状态
             mIsAm = !mIsAm;
             if (mIsAm) {
                 mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
@@ -158,19 +175,22 @@ public class DateTimePicker extends FrameLayout {
         }
     };
 
+    // 定义日期时间更改监听器接口
     public interface OnDateTimeChangedListener {
         void onDateTimeChanged(DateTimePicker view, int year, int month,
                 int dayOfMonth, int hourOfDay, int minute);
-    }
-
+    }   
+    // 构造函数，初始化DateTimePicker
     public DateTimePicker(Context context) {
         this(context, System.currentTimeMillis());
     }
 
+    // 构造函数，初始化DateTimePicker并设置日期
     public DateTimePicker(Context context, long date) {
         this(context, date, DateFormat.is24HourFormat(context));
     }
 
+    // 构造函数，初始化DateTimePicker并设置日期和24小时视图状态
     public DateTimePicker(Context context, long date, boolean is24HourView) {
         super(context);
         mDate = Calendar.getInstance();
@@ -178,19 +198,23 @@ public class DateTimePicker extends FrameLayout {
         mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
         inflate(context, R.layout.datetime_picker, this);
 
+        // 初始化日期选择器
         mDateSpinner = (NumberPicker) findViewById(R.id.date);
         mDateSpinner.setMinValue(DATE_SPINNER_MIN_VAL);
         mDateSpinner.setMaxValue(DATE_SPINNER_MAX_VAL);
         mDateSpinner.setOnValueChangedListener(mOnDateChangedListener);
 
+        // 初始化小时选择器
         mHourSpinner = (NumberPicker) findViewById(R.id.hour);
         mHourSpinner.setOnValueChangedListener(mOnHourChangedListener);
+        // 初始化分钟选择器
         mMinuteSpinner =  (NumberPicker) findViewById(R.id.minute);
         mMinuteSpinner.setMinValue(MINUT_SPINNER_MIN_VAL);
         mMinuteSpinner.setMaxValue(MINUT_SPINNER_MAX_VAL);
         mMinuteSpinner.setOnLongPressUpdateInterval(100);
         mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
 
+        // 初始化上午/下午选择器
         String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
         mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
         mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
@@ -198,22 +222,25 @@ public class DateTimePicker extends FrameLayout {
         mAmPmSpinner.setDisplayedValues(stringsForAmPm);
         mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
 
-        // update controls to initial state
+        // 更新控件到初始状态
         updateDateControl();
         updateHourControl();
         updateAmPmControl();
 
+        // 设置24小时视图状态
         set24HourView(is24HourView);
 
-        // set to current time
+        // 设置当前日期
         setCurrentDate(date);
 
+        // 设置启用状态
         setEnabled(isEnabled());
 
-        // set the content descriptions
+        // 设置内容描述
         mInitialising = false;
     }
 
+    // 重写setEnabled方法，设置控件的启用状态
     @Override
     public void setEnabled(boolean enabled) {
         if (mIsEnabled == enabled) {
@@ -227,25 +254,18 @@ public class DateTimePicker extends FrameLayout {
         mIsEnabled = enabled;
     }
 
+    // 获取控件的启用状态
     @Override
     public boolean isEnabled() {
         return mIsEnabled;
     }
 
-    /**
-     * Get the current date in millis
-     *
-     * @return the current date in millis
-     */
+    // 获取当前日期的时间戳
     public long getCurrentDateInTimeMillis() {
         return mDate.getTimeInMillis();
     }
 
-    /**
-     * Set the current date
-     *
-     * @param date The current date in millis
-     */
+    // 设置当前日期
     public void setCurrentDate(long date) {
         Calendar cal = Calendar.getInstance();
         cal.setTimeInMillis(date);
@@ -253,15 +273,7 @@ public class DateTimePicker extends FrameLayout {
                 cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
     }
 
-    /**
-     * Set the current date
-     *
-     * @param year The current year
-     * @param month The current month
-     * @param dayOfMonth The current dayOfMonth
-     * @param hourOfDay The current hourOfDay
-     * @param minute The current minute
-     */
+    // 设置当前日期
     public void setCurrentDate(int year, int month,
             int dayOfMonth, int hourOfDay, int minute) {
         setCurrentYear(year);
@@ -271,20 +283,12 @@ public class DateTimePicker extends FrameLayout {
         setCurrentMinute(minute);
     }
 
-    /**
-     * Get current year
-     *
-     * @return The current year
-     */
+    // 获取当前年份
     public int getCurrentYear() {
         return mDate.get(Calendar.YEAR);
     }
 
-    /**
-     * Set current year
-     *
-     * @param year The current year
-     */
+    // 设置当前年份
     public void setCurrentYear(int year) {
         if (!mInitialising && year == getCurrentYear()) {
             return;
@@ -294,20 +298,12 @@ public class DateTimePicker extends FrameLayout {
         onDateTimeChanged();
     }
 
-    /**
-     * Get current month in the year
-     *
-     * @return The current month in the year
-     */
+    // 获取当前月份
     public int getCurrentMonth() {
         return mDate.get(Calendar.MONTH);
     }
 
-    /**
-     * Set current month in the year
-     *
-     * @param month The month in the year
-     */
+    // 设置当前月份
     public void setCurrentMonth(int month) {
         if (!mInitialising && month == getCurrentMonth()) {
             return;
@@ -317,20 +313,12 @@ public class DateTimePicker extends FrameLayout {
         onDateTimeChanged();
     }
 
-    /**
-     * Get current day of the month
-     *
-     * @return The day of the month
-     */
+    // 获取当前天数
     public int getCurrentDay() {
         return mDate.get(Calendar.DAY_OF_MONTH);
     }
 
-    /**
-     * Set current day of the month
-     *
-     * @param dayOfMonth The day of the month
-     */
+    // 设置当前天数
     public void setCurrentDay(int dayOfMonth) {
         if (!mInitialising && dayOfMonth == getCurrentDay()) {
             return;
@@ -340,14 +328,12 @@ public class DateTimePicker extends FrameLayout {
         onDateTimeChanged();
     }
 
-    /**
-     * Get current hour in 24 hour mode, in the range (0~23)
-     * @return The current hour in 24 hour mode
-     */
+    // 获取当前小时（24小时制）
     public int getCurrentHourOfDay() {
         return mDate.get(Calendar.HOUR_OF_DAY);
     }
 
+    // 获取当前小时（根据24小时视图状态）
     private int getCurrentHour() {
         if (mIs24HourView){
             return getCurrentHourOfDay();
@@ -361,11 +347,7 @@ public class DateTimePicker extends FrameLayout {
         }
     }
 
-    /**
-     * Set current hour in 24 hour mode, in the range (0~23)
-     *
-     * @param hourOfDay
-     */
+    // 设置当前小时（24小时制）
     public void setCurrentHour(int hourOfDay) {
         if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
             return;
@@ -389,18 +371,12 @@ public class DateTimePicker extends FrameLayout {
         onDateTimeChanged();
     }
 
-    /**
-     * Get currentMinute
-     *
-     * @return The Current Minute
-     */
+    // 获取当前分钟
     public int getCurrentMinute() {
         return mDate.get(Calendar.MINUTE);
     }
 
-    /**
-     * Set current minute
-     */
+    // 设置当前分钟
     public void setCurrentMinute(int minute) {
         if (!mInitialising && minute == getCurrentMinute()) {
             return;
@@ -410,18 +386,12 @@ public class DateTimePicker extends FrameLayout {
         onDateTimeChanged();
     }
 
-    /**
-     * @return true if this is in 24 hour view else false.
-     */
+    // 获取是否为24小时视图
     public boolean is24HourView () {
         return mIs24HourView;
     }
 
-    /**
-     * Set whether in 24 hour or AM/PM mode.
-     *
-     * @param is24HourView True for 24 hour mode. False for AM/PM mode.
-     */
+    // 设置是否为24小时视图
     public void set24HourView(boolean is24HourView) {
         if (mIs24HourView == is24HourView) {
             return;
@@ -434,6 +404,7 @@ public class DateTimePicker extends FrameLayout {
         updateAmPmControl();
     }
 
+    // 更新日期控件
     private void updateDateControl() {
         Calendar cal = Calendar.getInstance();
         cal.setTimeInMillis(mDate.getTimeInMillis());
@@ -448,6 +419,7 @@ public class DateTimePicker extends FrameLayout {
         mDateSpinner.invalidate();
     }
 
+    // 更新上午/下午控件
     private void updateAmPmControl() {
         if (mIs24HourView) {
             mAmPmSpinner.setVisibility(View.GONE);
@@ -458,6 +430,7 @@ public class DateTimePicker extends FrameLayout {
         }
     }
 
+    // 更新小时控件
     private void updateHourControl() {
         if (mIs24HourView) {
             mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
@@ -468,18 +441,15 @@ public class DateTimePicker extends FrameLayout {
         }
     }
 
-    /**
-     * Set the callback that indicates the 'Set' button has been pressed.
-     * @param callback the callback, if null will do nothing
-     */
+    // 设置日期时间更改监听器
     public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
         mOnDateTimeChangedListener = callback;
     }
 
+    // 触发日期时间更改事件
     private void onDateTimeChanged() {
         if (mOnDateTimeChangedListener != null) {
             mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
                     getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
         }
-    }
-}
+    }

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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -13,77 +13,127 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+// 文件头部注释，声明版权信息和许可证信息，说明该文件遵循Apache License, Version 2.0
 
 package net.micode.notes.ui;
+// 导入包，声明该类属于net.micode.notes.ui包
 
 import java.util.Calendar;
+// 导入Calendar类，用于日期和时间的操作
 
 import net.micode.notes.R;
+// 导入R类，用于访问应用的资源文件
+
 import net.micode.notes.ui.DateTimePicker;
+// 导入DateTimePicker类，用于日期和时间的选择控件
 import net.micode.notes.ui.DateTimePicker.OnDateTimeChangedListener;
+// 导入DateTimePicker.OnDateTimeChangedListener接口，用于监听日期和时间的变化
 
 import android.app.AlertDialog;
+// 导入AlertDialog类，用于创建对话框
 import android.content.Context;
+// 导入Context类，用于获取应用上下文
 import android.content.DialogInterface;
+// 导入DialogInterface类，用于对话框的接口
 import android.content.DialogInterface.OnClickListener;
+// 导入DialogInterface.OnClickListener接口，用于对话框按钮的点击事件监听
 import android.text.format.DateFormat;
+// 导入DateFormat类，用于日期格式的转换
 import android.text.format.DateUtils;
+// 导入DateUtils类，用于日期和时间的格式化和转换
 
 public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
+    // 声明DateTimePickerDialog类，继承自AlertDialog并实现OnClickListener接口
 
     private Calendar mDate = Calendar.getInstance();
+    // 声明mDate变量，用于存储当前选择的日期和时间，默认为当前系统时间
     private boolean mIs24HourView;
+    // 声明mIs24HourView变量，用于标记是否使用24小时制
     private OnDateTimeSetListener mOnDateTimeSetListener;
+    // 声明mOnDateTimeSetListener变量，用于存储日期和时间设置完成后的回调接口
     private DateTimePicker mDateTimePicker;
+    // 声明mDateTimePicker变量，用于存储日期和时间选择控件
 
     public interface OnDateTimeSetListener {
+        // 声明OnDateTimeSetListener接口，用于定义日期和时间设置完成后的回调方法
         void OnDateTimeSet(AlertDialog dialog, long date);
+        // 定义OnDateTimeSet方法，参数为对话框和设置的日期时间戳
     }
 
     public DateTimePickerDialog(Context context, long date) {
+        // 构造函数，传入上下文和初始日期时间戳
         super(context);
+        // 调用父类构造函数
         mDateTimePicker = new DateTimePicker(context);
+        // 创建日期和时间选择控件实例
         setView(mDateTimePicker);
+        // 将日期和时间选择控件设置为对话框的内容视图
         mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
+            // 为日期和时间选择控件设置日期和时间变化监听器
             public void onDateTimeChanged(DateTimePicker view, int year, int month,
                     int dayOfMonth, int hourOfDay, int minute) {
+                // 监听器方法，当日期和时间发生变化时调用
                 mDate.set(Calendar.YEAR, year);
+                // 设置年份
                 mDate.set(Calendar.MONTH, month);
+                // 设置月份
                 mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
+                // 设置日期
                 mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
+                // 设置小时
                 mDate.set(Calendar.MINUTE, minute);
+                // 设置分钟
                 updateTitle(mDate.getTimeInMillis());
+                // 更新对话框的标题
             }
         });
         mDate.setTimeInMillis(date);
+        // 将传入的日期时间戳设置为当前选择的日期和时间
         mDate.set(Calendar.SECOND, 0);
+        // 将秒数设置为0
         mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
+        // 设置日期和时间选择控件的当前日期和时间
         setButton(context.getString(R.string.datetime_dialog_ok), this);
+        // 设置对话框的确定按钮，并将点击事件监听器设置为当前对象
         setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
+        // 设置对话框的取消按钮，不设置点击事件监听器
         set24HourView(DateFormat.is24HourFormat(this.getContext()));
+        // 根据系统设置决定是否使用24小时制
         updateTitle(mDate.getTimeInMillis());
+        // 更新对话框的标题
     }
 
     public void set24HourView(boolean is24HourView) {
+        // 设置是否使用24小时制的方法
         mIs24HourView = is24HourView;
+        // 更新mIs24HourView变量的值
     }
 
     public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
+        // 设置日期和时间设置完成后的回调接口的方法
         mOnDateTimeSetListener = callBack;
+        // 更新mOnDateTimeSetListener变量的值
     }
 
     private void updateTitle(long date) {
+        // 更新对话框标题的方法
         int flag =
             DateUtils.FORMAT_SHOW_YEAR |
             DateUtils.FORMAT_SHOW_DATE |
             DateUtils.FORMAT_SHOW_TIME;
+        // 设置日期格式的标志，显示年份、日期和时间
         flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
+        // 根据是否使用24小时制，设置相应的格式标志
         setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
+        // 使用DateUtils.formatDateTime方法格式化日期，并设置为对话框的标题
     }
 
     public void onClick(DialogInterface arg0, int arg1) {
+        // 对话框按钮点击事件的监听方法
         if (mOnDateTimeSetListener != null) {
+            // 如果设置了日期和时间设置完成后的回调接口
             mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
+            // 调用回调接口的OnDateTimeSet方法，传入对话框和当前选择的日期时间戳
         }
     }
 

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

@@ -0,0 +1,114 @@
+java复制
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        <url id="cu1jo4prqpm9v23mk6p0" type="url" status="parsed" title="Apache License, Version 2.0" wc="10467">http://www.apache.org/licenses/LICENSE-2.0</url>  
+ *
+ * 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;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.view.View.OnClickListener;
+import android.widget.Button;
+import android.widget.PopupMenu;
+import android.widget.PopupMenu.OnMenuItemClickListener;
+// 导入该类所依赖的类和接口
+
+import net.micode.notes.R;
+// 导入资源文件，方便访问项目中的资源
+
+/**
+ * DropdownMenu 类用于创建和管理一个下拉菜单。
+ * 它封装了下拉菜单的创建、显示和事件处理逻辑，提供了一个简单的接口来使用下拉菜单。
+ */
+public class DropdownMenu {
+    // 定义一个名为 DropdownMenu 的公共类
+    private Button mButton;
+    // 定义一个 Button 类型的私有成员变量 mButton，用于存储下拉菜单按钮
+    private PopupMenu mPopupMenu;
+    // 定义一个 PopupMenu 类型的私有成员变量 mPopupMenu，用于存储下拉菜单
+    private Menu mMenu;
+    // 定义一个 Menu 类型的私有成员变量 mMenu，用于存储下拉菜单中的菜单项
+
+    /**
+     * 构造方法，用于创建 DropdownMenu 对象。
+     * 
+     * @param context 上下文对象，用于创建 PopupMenu
+     * @param button 按钮对象，用于触发下拉菜单的显示
+     * @param menuId 菜单资源 ID，用于填充下拉菜单的项
+     */
+    public DropdownMenu(Context context, Button button, int menuId) {
+        // 定义一个构造方法，用于创建 DropdownMenu 对象
+        mButton = button;
+        // 将传入的按钮赋值给 mButton
+        mButton.setBackgroundResource(R.drawable.dropdown_icon);
+        // 为按钮设置背景资源，使用 R.drawable.dropdown_icon
+        mPopupMenu = new PopupMenu(context, mButton);
+        // 创建一个 PopupMenu 对象，并传入上下文和按钮作为参数
+        mMenu = mPopupMenu.getMenu();
+        // 获取 PopupMenu 对象的菜单，并赋值给 mMenu
+        mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
+        // 使用菜单填充器将传入的菜单资源 ID 填充到菜单中
+        mButton.setOnClickListener(new OnClickListener() {
+            // 为按钮设置点击事件监听器
+            public void onClick(View v) {
+                // 当按钮被点击时
+                mPopupMenu.show();
+                // 显示下拉菜单
+            }
+        });
+    }
+
+    /**
+     * 设置下拉菜单项点击事件监听器。
+     * 
+     * @param listener 菜单项点击事件监听器
+     */
+    public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
+        // 定义一个方法，用于设置下拉菜单项点击事件监听器
+        if (mPopupMenu != null) {
+            // 如果 mPopupMenu 不为空
+            mPopupMenu.setOnMenuItemClickListener(listener);
+            // 为 mPopupMenu 设置点击事件监听器
+        }
+    }
+
+    /**
+     * 查找菜单项。
+     * 
+     * @param id 菜单项的 ID
+     * @return 找到的菜单项，如果未找到则返回 null
+     */
+    public MenuItem findItem(int id) {
+        // 定义一个方法，用于查找菜单项
+        return mMenu.findItem(id);
+        // 调用 mMenu 的 findItem 方法查找并返回指定 ID 的菜单项
+    }
+
+    /**
+     * 设置按钮的标题。
+     * 
+     * @param title 按钮的标题文本
+     */
+    public void setTitle(CharSequence title) {
+        // 定义一个方法，用于设置按钮的标题
+        mButton.setText(title);
+        // 调用 mButton 的 setText 方法设置按钮的文本内容
+    }
+}
+// DropdownMenu 类的结束

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

@@ -5,7 +5,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        http://www.apache.org/licenses/LICENSE-2.0 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -13,68 +13,104 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+// 文件头部注释，声明版权信息和许可证信息，说明该文件遵循Apache License, Version 2.0
 
 package net.micode.notes.ui;
+// 导入包，声明该类属于net.micode.notes.ui包
 
 import android.content.Context;
+// 导入Context类，用于获取应用上下文
 import android.database.Cursor;
+// 导入Cursor类，用于数据库查询结果的游标
 import android.view.View;
+// 导入View类，用于界面元素
 import android.view.ViewGroup;
+// 导入ViewGroup类，用于视图容器
 import android.widget.CursorAdapter;
+// 导入CursorAdapter类，用于将游标数据绑定到视图上
 import android.widget.LinearLayout;
+// 导入LinearLayout类，用于线性布局
 import android.widget.TextView;
+// 导入TextView类，用于显示文本
 
 import net.micode.notes.R;
+// 导入R类，用于访问应用的资源文件
 import net.micode.notes.data.Notes;
+// 导入Notes类，用于访问笔记数据
 import net.micode.notes.data.Notes.NoteColumns;
-
+// 导入NoteColumns类，用于访问笔记数据的列信息
 
 public class FoldersListAdapter extends CursorAdapter {
+    // 声明FoldersListAdapter类，继承自CursorAdapter，用于显示文件夹列表
+
     public static final String [] PROJECTION = {
         NoteColumns.ID,
         NoteColumns.SNIPPET
     };
+    // 定义查询投影，包含笔记的ID和摘要列
 
     public static final int ID_COLUMN   = 0;
+    // 定义ID列的索引
     public static final int NAME_COLUMN = 1;
+    // 定义名称列的索引
 
     public FoldersListAdapter(Context context, Cursor c) {
+        // 构造函数，传入上下文和游标
         super(context, c);
+        // 调用父类构造函数
         // TODO Auto-generated constructor stub
+        // 自动生成的构造函数存根，待实现
     }
 
     @Override
     public View newView(Context context, Cursor cursor, ViewGroup parent) {
+        // 创建新视图的方法
         return new FolderListItem(context);
+        // 返回一个新的FolderListItem实例
     }
 
     @Override
     public void bindView(View view, Context context, Cursor cursor) {
+        // 绑定视图的方法
         if (view instanceof FolderListItem) {
+            // 如果视图是FolderListItem的实例
             String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                     .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
+            // 获取文件夹名称，如果是根文件夹则显示特定字符串，否则显示名称列的值
             ((FolderListItem) view).bind(folderName);
+            // 调用FolderListItem的bind方法，设置文件夹名称
         }
     }
 
     public String getFolderName(Context context, int position) {
+        // 获取指定位置的文件夹名称的方法
         Cursor cursor = (Cursor) getItem(position);
+        // 获取指定位置的游标项
         return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
                 .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
+        // 返回文件夹名称，如果是根文件夹则显示特定字符串，否则显示名称列的值
     }
 
     private class FolderListItem extends LinearLayout {
+        // 声明FolderListItem类，继承自LinearLayout，用于表示文件夹列表项
         private TextView mName;
+        // 声明mName变量，用于存储文件夹名称的TextView
 
         public FolderListItem(Context context) {
+            // 构造函数，传入上下文
             super(context);
+            // 调用父类构造函数
             inflate(context, R.layout.folder_list_item, this);
+            // 加载文件夹列表项的布局
             mName = (TextView) findViewById(R.id.tv_folder_name);
+            // 获取文件夹名称的TextView
         }
 
         public void bind(String name) {
+            // 绑定文件夹名称的方法
             mName.setText(name);
+            // 设置文件夹名称的文本
         }
     }
 
-}
+}

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

@@ -1,21 +1,14 @@
-/*
- * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *        http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
+// 声明版权信息，2010-2011年，由MiCode开源社区(www.micode.net)编写
+// 该文件遵循Apache License, Version 2.0许可协议
+// 除非法律要求或书面同意，否则不得使用该文件
+// 可以从以下网址获取该许可协议的副本：http://www.apache.org/licenses/LICENSE-2.0
+// 除非法律要求或书面同意，否则根据该许可协议分发的软件按“原样”分发，没有任何明示或暗示的保证或条件
+// 请参阅许可协议，了解关于权限和限制的具体语言
 
+// 声明包名，该文件属于net.micode.notes.ui包
 package net.micode.notes.ui;
 
+// 导入所需的Android类库
 import android.content.Context;
 import android.graphics.Rect;
 import android.text.Layout;
@@ -32,162 +25,212 @@ import android.view.MenuItem.OnMenuItemClickListener;
 import android.view.MotionEvent;
 import android.widget.EditText;
 
+// 导入该应用的资源文件
 import net.micode.notes.R;
 
+// 导入Java类库
 import java.util.HashMap;
 import java.util.Map;
 
+// 声明NoteEditText类，继承自EditText
 public class NoteEditText extends EditText {
+    // 定义日志标签
     private static final String TAG = "NoteEditText";
+    // 定义索引变量，用于记录编辑文本的索引
     private int mIndex;
+    // 定义删除前选择的开始位置变量
     private int mSelectionStartBeforeDelete;
 
+    // 定义电话、HTTP和电子邮件的URI scheme常量
     private static final String SCHEME_TEL = "tel:" ;
     private static final String SCHEME_HTTP = "http:" ;
     private static final String SCHEME_EMAIL = "mailto:" ;
 
+    // 创建一个HashMap，用于存储不同scheme对应的资源ID
     private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
+    // 静态代码块，初始化sSchemaActionResMap
     static {
+        // 将电话、HTTP和电子邮件的scheme分别与对应的字符串资源ID关联起来
         sSchemaActionResMap.put(SCHEME_TEL, R.string.note_link_tel);
         sSchemaActionResMap.put(SCHEME_HTTP, R.string.note_link_web);
         sSchemaActionResMap.put(SCHEME_EMAIL, R.string.note_link_email);
     }
 
-    /**
-     * Call by the {@link NoteEditActivity} to delete or add edit text
-     */
+    // 声明OnTextViewChangeListener接口，用于监听编辑文本的变化
     public interface OnTextViewChangeListener {
-        /**
-         * Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
-         * and the text is null
-         */
+        // 当编辑文本为空且按下删除键时，删除当前编辑文本
         void onEditTextDelete(int index, String text);
 
-        /**
-         * Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
-         * happen
-         */
+        // 当按下回车键时，在当前编辑文本后添加新的编辑文本
         void onEditTextEnter(int index, String text);
 
-        /**
-         * Hide or show item option when text change
-         */
+        // 当文本发生变化时，隐藏或显示选项项
         void onTextChange(int index, boolean hasText);
     }
 
+    // 声明OnTextViewChangeListener接口的实例变量
     private OnTextViewChangeListener mOnTextViewChangeListener;
 
+    // 构造方法，仅传入Context参数
     public NoteEditText(Context context) {
+        // 调用父类构造方法
         super(context, null);
+        // 初始化索引为0
         mIndex = 0;
     }
 
+    // 设置编辑文本的索引
     public void setIndex(int index) {
         mIndex = index;
     }
 
+    // 设置OnTextViewChangeListener接口的实现
     public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
         mOnTextViewChangeListener = listener;
     }
 
+    // 构造方法，传入Context和AttributeSet参数
     public NoteEditText(Context context, AttributeSet attrs) {
+        // 调用父类构造方法，传入AttributeSet和默认样式
         super(context, attrs, android.R.attr.editTextStyle);
     }
 
+    // 构造方法，传入Context、AttributeSet和默认样式参数
     public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
+        // 调用父类构造方法
         super(context, attrs, defStyle);
-        // TODO Auto-generated constructor stub
+        // TODO:此处有注释提示，表示需要自动生成构造方法的代码
     }
 
+    // 重写onTouchEvent方法，处理触摸事件
     @Override
     public boolean onTouchEvent(MotionEvent event) {
+        // 根据事件类型进行处理
         switch (event.getAction()) {
+            // 当手指按下时
             case MotionEvent.ACTION_DOWN:
-
+                // 获取触摸点的x和y坐标
                 int x = (int) event.getX();
                 int y = (int) event.getY();
+                // 调整坐标，考虑padding和滚动位置
                 x -= getTotalPaddingLeft();
                 y -= getTotalPaddingTop();
                 x += getScrollX();
                 y += getScrollY();
 
+                // 获取文本布局
                 Layout layout = getLayout();
+                // 根据y坐标获取行号
                 int line = layout.getLineForVertical(y);
+                // 根据行号和x坐标获取字符偏移量
                 int off = layout.getOffsetForHorizontal(line, x);
+                // 设置文本选择位置
                 Selection.setSelection(getText(), off);
                 break;
         }
 
+        // 调用父类的onTouchEvent方法
         return super.onTouchEvent(event);
     }
 
+    // 重写onKeyDown方法，处理键盘按下事件
     @Override
     public boolean onKeyDown(int keyCode, KeyEvent event) {
+        // 根据按键代码进行处理
         switch (keyCode) {
+            // 当按下回车键时
             case KeyEvent.KEYCODE_ENTER:
+                // 如果设置了OnTextViewChangeListener，则不处理
                 if (mOnTextViewChangeListener != null) {
                     return false;
                 }
                 break;
+            // 当按下删除键时
             case KeyEvent.KEYCODE_DEL:
+                // 记录删除前的选择开始位置
                 mSelectionStartBeforeDelete = getSelectionStart();
                 break;
             default:
                 break;
         }
+        // 调用父类的onKeyDown方法
         return super.onKeyDown(keyCode, event);
     }
 
+    // 重写onKeyUp方法，处理键盘抬起事件
     @Override
     public boolean onKeyUp(int keyCode, KeyEvent event) {
+        // 根据按键代码进行处理
         switch(keyCode) {
+            // 当抬起删除键时
             case KeyEvent.KEYCODE_DEL:
+                // 如果设置了OnTextViewChangeListener
                 if (mOnTextViewChangeListener != null) {
+                    // 如果删除前选择的开始位置为0且索引不为0，则删除当前编辑文本
                     if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
                         mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
                         return true;
                     }
                 } else {
+                    // 如果未设置OnTextViewChangeListener，则输出日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
+            // 当抬起回车键时
             case KeyEvent.KEYCODE_ENTER:
+                // 如果设置了OnTextViewChangeListener
                 if (mOnTextViewChangeListener != null) {
+                    // 获取选择的开始位置
                     int selectionStart = getSelectionStart();
+                    // 获取选择开始位置之后的文本
                     String text = getText().subSequence(selectionStart, length()).toString();
+                    // 设置文本为选择开始位置之前的文本
                     setText(getText().subSequence(0, selectionStart));
+                    // 在当前编辑文本后添加新的编辑文本
                     mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
                 } else {
+                    // 如果未设置OnTextViewChangeListener，则输出日志
                     Log.d(TAG, "OnTextViewChangeListener was not seted");
                 }
                 break;
             default:
                 break;
         }
+        // 调用父类的onKeyUp方法
         return super.onKeyUp(keyCode, event);
     }
 
+    // 重写onFocusChanged方法，处理焦点变化事件
     @Override
     protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
+        // 如果设置了OnTextViewChangeListener
         if (mOnTextViewChangeListener != null) {
+            // 如果失去焦点且文本为空，则通知文本变化为无文本
             if (!focused && TextUtils.isEmpty(getText())) {
                 mOnTextViewChangeListener.onTextChange(mIndex, false);
             } else {
+                // 如果获得焦点或文本不为空，则通知文本变化为有文本
                 mOnTextViewChangeListener.onTextChange(mIndex, true);
             }
         }
+        // 调用父类的onFocusChanged方法
         super.onFocusChanged(focused, direction, previouslyFocusedRect);
     }
 
+    // 重写onCreateContextMenu方法，创建上下文菜单
     @Override
     protected void onCreateContextMenu(ContextMenu menu) {
+        // 如果文本是Spanned类型
         if (getText() instanceof Spanned) {
+            // 获取选择的开始和结束位置
             int selStart = getSelectionStart();
             int selEnd = getSelectionEnd();
 
+            // 获取最小和最大位置
             int min = Math.min(selStart, selEnd);
             int max = Math.max(selStart, selEnd);
 
+           
             final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
             if (urls.length == 1) {
                 int defaultResId = 0;

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

@@ -1,3 +1,4 @@
+java复制
 /*
  * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
  *
@@ -5,7 +6,7 @@
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- *        http://www.apache.org/licenses/LICENSE-2.0
+ *        <url id="cu1jjn4r4djrsk4hu5kg" type="url" status="parsed" title="Apache License, Version 2.0" wc="10467">http://www.apache.org/licenses/LICENSE-2.0</url> 
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
@@ -30,74 +31,127 @@ import java.util.HashMap;
 import java.util.HashSet;
 import java.util.Iterator;
 
-
+/**
+ * NotesListAdapter 是一个自定义的 CursorAdapter，用于在 ListView 中显示笔记列表。
+ * 它继承自 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 static final String TAG = "NotesListAdapter"; // 日志标签，用于日志输出
+    private Context mContext; // 上下文对象，用于获取资源和创建视图
+    private HashMap<Integer, Boolean> mSelectedIndex; // 用于记录选中的笔记位置
+    private int mNotesCount; // 笔记总数，用于判断是否全选
+    private boolean mChoiceMode; // 是否处于多选模式
 
+    /**
+     * AppWidgetAttribute 类用于存储小部件的属性，如小部件 ID 和类型。
+     */
     public static class AppWidgetAttribute {
-        public int widgetId;
-        public int widgetType;
+        public int widgetId; // 小部件 ID
+        public int widgetType; // 小部件类型
     };
 
+    /**
+     * 构造函数，初始化适配器。
+     * 
+     * @param context 上下文对象
+     */
     public NotesListAdapter(Context context) {
         super(context, null);
-        mSelectedIndex = new HashMap<Integer, Boolean>();
+        mSelectedIndex = new HashMap<Integer, Boolean>(); // 初始化选中位置的哈希表
         mContext = context;
-        mNotesCount = 0;
+        mNotesCount = 0; // 初始化笔记总数为 0
     }
 
+    /**
+     * 创建新的视图，用于显示笔记项。
+     * 
+     * @param context 上下文对象
+     * @param cursor 数据游标
+     * @param parent 父视图
+     * @return 创建的视图
+     */
     @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,
+            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();
         for (int i = 0; i < getCount(); i++) {
             if (cursor.moveToPosition(i)) {
                 if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
-                    setCheckedItem(i, checked);
+                    setCheckedItem(i, checked); // 设置每个笔记项的选中状态
                 }
             }
         }
     }
 
+    /**
+     * 获取选中的笔记项 ID 集合。
+     * 
+     * @return 选中的笔记项 ID 集合
+     */
     public HashSet<Long> getSelectedItemIds() {
         HashSet<Long> itemSet = new HashSet<Long>();
         for (Integer position : mSelectedIndex.keySet()) {
             if (mSelectedIndex.get(position) == true) {
                 Long id = getItemId(position);
                 if (id == Notes.ID_ROOT_FOLDER) {
-                    Log.d(TAG, "Wrong item id, should not happen");
+                    Log.d(TAG, "Wrong item id, should not happen"); // 错误的笔记 ID
                 } else {
-                    itemSet.add(id);
+                    itemSet.add(id); // 添加选中的笔记 ID
                 }
             }
         }
@@ -105,6 +159,11 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 获取选中的小部件属性集合。
+     * 
+     * @return 选中的小部件属性集合
+     */
     public HashSet<AppWidgetAttribute> getSelectedWidget() {
         HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
         for (Integer position : mSelectedIndex.keySet()) {
@@ -113,14 +172,14 @@ public class NotesListAdapter extends CursorAdapter {
                 if (c != null) {
                     AppWidgetAttribute widget = new AppWidgetAttribute();
                     NoteItemData item = new NoteItemData(mContext, c);
-                    widget.widgetId = item.getWidgetId();
-                    widget.widgetType = item.getWidgetType();
-                    itemSet.add(widget);
+                    widget.widgetId = item.getWidgetId(); // 获取小部件 ID
+                    widget.widgetType = item.getWidgetType(); // 获取小部件类型
+                    itemSet.add(widget); // 添加小部件属性
                     /**
                      * Don't close cursor here, only the adapter could close it
                      */
                 } else {
-                    Log.e(TAG, "Invalid cursor");
+                    Log.e(TAG, "Invalid cursor"); // 无效的游标
                     return null;
                 }
             }
@@ -128,6 +187,11 @@ public class NotesListAdapter extends CursorAdapter {
         return itemSet;
     }
 
+    /**
+     * 获取选中的笔记项数量。
+     * 
+     * @return 选中的笔记项数量
+     */
     public int getSelectedCount() {
         Collection<Boolean> values = mSelectedIndex.values();
         if (null == values) {
@@ -137,17 +201,28 @@ public class NotesListAdapter extends CursorAdapter {
         int count = 0;
         while (iter.hasNext()) {
             if (true == iter.next()) {
-                count++;
+                count++; // 统计选中的笔记项数量
             }
         }
         return count;
     }
 
+    /**
+     * 判断是否所有笔记项都被选中。
+     * 
+     * @return 是否所有笔记项都被选中
+     */
     public boolean isAllSelected() {
         int checkedCount = getSelectedCount();
-        return (checkedCount != 0 && checkedCount == mNotesCount);
+        return (checkedCount != 0 && checkedCount == mNotesCount); // 判断是否全选
     }
 
+    /**
+     * 判断指定位置的笔记项是否被选中。
+     * 
+     * @param position 笔记项的位置
+     * @return 是否被选中
+     */
     public boolean isSelectedItem(final int position) {
         if (null == mSelectedIndex.get(position)) {
             return false;
@@ -155,30 +230,42 @@ public class NotesListAdapter extends CursorAdapter {
         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(); // 重新计算笔记总数
     }
 
+    /**1\
+    /**
+     * 计算笔记总数。
+     */
     private void calcNotesCount() {
         mNotesCount = 0;
         for (int i = 0; i < getCount(); i++) {
             Cursor c = (Cursor) getItem(i);
             if (c != null) {
                 if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
-                    mNotesCount++;
+                    mNotesCount++; // 统计笔记数量
                 }
             } else {
-                Log.e(TAG, "Invalid cursor");
+                Log.e(TAG, "Invalid cursor"); // 无效的游标
                 return;
             }
         }
     }
-}
+}

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

@@ -0,0 +1,477 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0 
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// 文件头部的版权声明，声明了版权归属、许可证信息以及使用该文件的法律限制
+
+package net.micode.notes.ui;
+// 导入当前Java类所在的包，该包名为net.micode.notes.ui
+
+import android.accounts.Account;
+import android.accounts.AccountManager;
+import android.app.ActionBar;
+import android.app.AlertDialog;
+import android.content.BroadcastReceiver;
+import android.content.ContentValues;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.SharedPreferences;
+import android.os.Bundle;
+import android.preference.Preference;
+import android.preference.Preference.OnPreferenceClickListener;
+import android.preference.PreferenceActivity;
+import android.preference.PreferenceCategory;
+import android.text.TextUtils;
+import android.text.format.DateFormat;
+import android.view.LayoutInflater;
+import android.view.Menu;
+import android.view.MenuItem;
+import android.view.View;
+import android.widget.Button;
+import android.widget.TextView;
+import android.widget.Toast;
+// 导入当前Java类所依赖的Android SDK中的类和接口
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.data.Notes.NoteColumns;
+import net.micode.notes.gtask.remote.GTaskSyncService;
+// 导入当前Java类所依赖的项目内部的类和接口，这些类和接口位于net.micode.notes包及其子包中
+
+public class NotesPreferenceActivity extends PreferenceActivity {
+    // 定义一个名为NotesPreferenceActivity的公共类，该类继承自PreferenceActivity，用于实现应用的设置界面
+    public static final String PREFERENCE_NAME = "notes_preferences";
+    // 定义一个公共静态常量PREFERENCE_NAME，用于指定设置界面的偏好设置文件名
+
+    public static final String PREFERENCE_SYNC_ACCOUNT_NAME = "pref_key_account_name";
+    // 定义一个公共静态常量PREFERENCE_SYNC_ACCOUNT_NAME，用于指定同步账户名称的偏好设置键名
+
+    public static final String PREFERENCE_LAST_SYNC_TIME = "pref_last_sync_time";
+    // 定义一个公共静态常量PREFERENCE_LAST_SYNC_TIME，用于指定最后同步时间的偏好设置键名
+
+    public static final String PREFERENCE_SET_BG_COLOR_KEY = "pref_key_bg_random_appear";
+    // 定义一个公共静态常量PREFERENCE_SET_BG_COLOR_KEY，用于指定背景颜色设置的偏好设置键名
+
+    private static final String PREFERENCE_SYNC_ACCOUNT_KEY = "pref_sync_account_key";
+    // 定义一个私有静态常量PREFERENCE_SYNC_ACCOUNT_KEY，用于指定同步账户的偏好设置键名
+
+    private static final String AUTHORITIES_FILTER_KEY = "authorities";
+    // 定义一个私有静态常量AUTHORITIES_FILTER_KEY，用于指定权限过滤的键名
+
+    private PreferenceCategory mAccountCategory;
+    // 定义一个私有成员变量mAccountCategory，类型为PreferenceCategory，用于存储账户相关的偏好设置分类
+
+    private GTaskReceiver mReceiver;
+    // 定义一个私有成员变量mReceiver，类型为GTaskReceiver，用于接收GTaskSyncService的广播
+
+    private Account[] mOriAccounts;
+    // 定义一个私有成员变量mOriAccounts，类型为Account数组，用于存储原始账户信息
+
+    private boolean mHasAddedAccount;
+    // 定义一个私有成员变量mHasAddedAccount，类型为boolean，用于标记是否已添加账户
+
+    @Override
+    protected void onCreate(Bundle icicle) {
+        // 重写onCreate方法，用于初始化设置界面
+        super.onCreate(icicle);
+        // 调用父类的onCreate方法
+
+        /* using the app icon for navigation */
+        getActionBar().setDisplayHomeAsUpEnabled(true);
+        // 设置ActionBar的导航按钮为应用图标
+
+        addPreferencesFromResource(R.xml.preferences);
+        // 从资源文件R.xml.preferences中加载偏好设置
+        mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
+        // 获取同步账户的偏好设置分类
+        mReceiver = new GTaskReceiver();
+        // 创建一个新的GTaskReceiver实例
+        IntentFilter filter = new IntentFilter();
+        // 创建一个新的IntentFilter实例
+        filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
+        // 为IntentFilter添加GTaskSyncService的广播名称
+        registerReceiver(mReceiver, filter);
+        // 注册GTaskReceiver以接收GTaskSyncService的广播
+
+        mOriAccounts = null;
+        // 初始化mOriAccounts为null
+        View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
+        // 从资源文件R.layout.settings_header中加载设置界面的头部视图
+        getListView().addHeaderView(header, null, true);
+        // 将头部视图添加到ListView中
+    }
+
+    @Override
+    protected void onResume() {
+        // 重写onResume方法，用于在设置界面恢复时执行操作
+        super.onResume();
+        // 调用父类的onResume方法
+
+        // need to set sync account automatically if user has added a new
+        // account
+        if (mHasAddedAccount) {
+            // 如果用户已添加新账户，则需要自动设置同步账户
+            Account[] accounts = getGoogleAccounts();
+            // 获取当前的Google账户信息
+            if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
+                // 如果原始账户信息不为空且当前账户数量大于原始账户数量
+                for (Account accountNew : accounts) {
+                    // 遍历当前账户信息
+                    boolean found = false;
+                    for (Account accountOld : mOriAccounts) {
+                        // 遍历原始账户信息
+                        if (TextUtils.equals(accountOld.name, accountNew.name)) {
+                            // 如果找到相同的账户名称
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (!found) {
+                        // 如果未找到相同的账户名称
+                        setSyncAccount(accountNew.name);
+                        // 设置同步账户为新账户
+                        break;
+                    }
+                }
+            }
+        }
+
+        refreshUI();
+        // 刷新设置界面的UI
+    }
+
+    @Override
+protected void onDestroy() {
+    if (mReceiver != null) {
+        unregisterReceiver(mReceiver);
+    }
+    // 在Activity销毁时，如果mReceiver不为空，则注销之前注册的广播接收器mReceiver，以避免内存泄漏
+    super.onDestroy();
+    // 调用父类的onDestroy方法，完成Activity销毁的其他必要操作
+}
+
+private void loadAccountPreference() {
+    mAccountCategory.removeAll();
+    // 清空账户相关的偏好设置分类中的所有偏好设置项
+
+    Preference accountPref = new Preference(this);
+    // 创建一个新的Preference实例，用于表示账户偏好设置项
+    final String defaultAccount = getSyncAccountName(this);
+    // 获取当前设置的同步账户名称
+    accountPref.setTitle(getString(R.string.preferences_account_title));
+    // 设置账户偏好设置项的标题
+    accountPref.setSummary(getString(R.string.preferences_account_summary));
+    // 设置账户偏好设置项的摘要
+    accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
+        public boolean onPreferenceClick(Preference preference) {
+            if (!GTaskSyncService.isSyncing()) {
+                // 如果当前没有正在进行的同步操作
+                if (TextUtils.isEmpty(defaultAccount)) {
+                    // 如果当前没有设置同步账户，则显示选择账户的对话框
+                    showSelectAccountAlertDialog();
+                } else {
+                    // 如果已经设置了同步账户，则显示提示用户更改账户的风险的对话框
+                    showChangeAccountConfirmAlertDialog();
+                }
+            } else {
+                // 如果当前有正在进行的同步操作，则显示提示不能更改账户的Toast消息
+                Toast.makeText(NotesPreferenceActivity.this,
+                        R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
+                        .show();
+            }
+            return true;
+        }
+    });
+
+    mAccountCategory.addPreference(accountPref);
+    // 将账户偏好设置项添加到账户相关的偏好设置分类中
+}
+
+private void loadSyncButton() {
+    Button syncButton = (Button) findViewById(R.id.preference_sync_button);
+    // 获取同步按钮
+    TextView lastSyncTimeView = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+    // 获取显示最后同步时间的TextView
+
+    // set button state
+    if (GTaskSyncService.isSyncing()) {
+        // 如果当前有正在进行的同步操作
+        syncButton.setText(getString(R.string.preferences_button_sync_cancel));
+        // 设置同步按钮的文本为取消同步
+        syncButton.setOnClickListener(new View.OnClickListener() {
+            public void onClick(View v) {
+                GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
+                // 点击同步按钮时，取消正在进行的同步操作
+            }
+        });
+    } else {
+        // 如果当前没有正在进行的同步操作
+        syncButton.setText(getString(R.string.preferences_button_sync_immediately));
+        // 设置同步按钮的文本为立即同步
+        syncButton.setOnClickListener(new View.OnClickListener() {
+            public void onClick(View v) {
+                GTaskSyncService.startSync(NotesPreferenceActivity.this);
+                // 点击同步按钮时，开始同步操作
+            }
+        });
+    }
+    syncButton.setEnabled(!TextUtils.isEmpty(getSyncAccountName(this)));
+    // 如果已设置了同步账户，则使同步按钮可用；否则，使同步按钮不可用
+
+    // set last sync time
+    if (GTaskSyncService.isSyncing()) {
+        // 如果当前有正在进行的同步操作
+        lastSyncTimeView.setText(GTaskSyncService.getProgressString());
+        // 设置显示最后同步时间的TextView的文本为同步进度字符串
+        lastSyncTimeView.setVisibility(View.VISIBLE);
+        // 使显示最后同步时间的TextView可见
+    } else {
+        long lastSyncTime = getLastSyncTime(this);
+        // 获取最后同步时间
+        if (lastSyncTime != 0) {
+            // 如果最后同步时间不为0
+            lastSyncTimeView.setText(getString(R.string.preferences_last_sync_time,
+                    DateFormat.format(getString(R.string.preferences_last_sync_time_format),
+                            lastSyncTime)));
+            // 设置显示最后同步时间的TextView的文本为格式化后的最后同步时间字符串
+            lastSyncTimeView.setVisibility(View.VISIBLE);
+            // 使显示最后同步时间的TextView可见
+        } else {
+            lastSyncTimeView.setVisibility(View.GONE);
+            // 如果最后同步时间为0，则使显示最后同步时间的TextView不可见
+        }
+    }
+}
+
+private void refreshUI() {
+    loadAccountPreference();
+    // 加载账户相关的偏好设置项
+    loadSyncButton();
+    // 加载同步按钮和显示最后同步时间的TextView
+}
+
+private void showSelectAccountAlertDialog() {
+    AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+    // 创建一个新的AlertDialog.Builder实例，用于构建选择账户的对话框
+
+    View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+    // 从资源文件R.layout.account_dialog_title中加载对话框的标题视图
+    TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+    // 获取对话框标题视图中的标题TextView
+    titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
+    // 设置对话框标题TextView的文本为选择账户的标题
+    TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+    // 获取对话框标题视图中的副标题TextView
+    subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
+    // 设置对话框副标题TextView的文本为选择账户的提示信息
+
+    dialogBuilder.setCustomTitle(titleView);
+    // 设置对话框的自定义标题视图为加载的标题视图
+    dialogBuilder.setPositiveButton(null, null);
+    // 设置对话框的正面按钮为null，即不显示正面按钮
+
+    Account[] accounts = getGoogleAccounts();
+    // 获取当前的Google账户信息
+    String defAccount = getSyncAccountName(this);
+    // 获取当前设置的同步账户名称
+
+    mOriAccounts = accounts;
+    // 将获取的Google账户信息存储到mOriAccounts中
+    mHasAddedAccount = false;
+    // 将mHasAddedAccount设置为false，表示没有添加新账户
+
+    if (accounts.length > 0) {
+        // 如果有Google账户信息
+        CharSequence[] items = new CharSequence[accounts.length];
+        // 创建一个CharSequence数组，用于存储账户名称
+        final CharSequence[] itemMapping = items;
+        // 创建一个CharSequence数组的副本，用于在点击事件中使用
+        int checkedItem = -1;
+        // 初始化选中项的索引为-1，表示没有选中项
+        int index = 0;
+        for (Account account : accounts) {
+            if (TextUtils.equals(account.name, defAccount)) {
+                // 如果账户名称与当前设置的同步账户名称相同
+                checkedItem = index;
+                // 设置选中项的索引为当前账户的索引
+            }
+            items[index++] = account.name;
+            // 将账户名称添加到CharSequence数组中
+        }
+        dialogBuilder.setSingleChoiceItems(items, checkedItem,
+                new DialogInterface.OnClickListener() {
+                    public void onClick(DialogInterface dialog, int which) {
+                        setSyncAccount(itemMapping[which].toString());
+                        // 设置同步账户为选中的账户名称
+                        dialog.dismiss();
+                        // 关闭对话框
+                        refreshUI();
+                        // 刷新设置界面的UI
+                    }
+                });
+        // 设置对话框的单选列表项为账户名称数组，选中项为当前设置的同步账户，点击事件为设置同步账户并关闭对话框
+    }
+}
+
+        View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
+        dialogBuilder.setView(addAccountView);
+
+        final AlertDialog dialog = dialogBuilder.show();
+        addAccountView.setOnClickListener(new View.OnClickListener() {
+            public void onClick(View v) {
+                mHasAddedAccount = true;
+                Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
+                intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
+                    "gmail-ls"
+                });
+                startActivityForResult(intent, -1);
+                dialog.dismiss();
+            }
+        });
+    }
+
+    private void showChangeAccountConfirmAlertDialog() {
+        AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
+
+        View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
+        TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
+        titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
+                getSyncAccountName(this)));
+        TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
+        subtitleTextView.setText(getString(R.string.preferences_dialog_change_account_warn_msg));
+        dialogBuilder.setCustomTitle(titleView);
+
+        CharSequence[] menuItemArray = new CharSequence[] {
+                getString(R.string.preferences_menu_change_account),
+                getString(R.string.preferences_menu_remove_account),
+                getString(R.string.preferences_menu_cancel)
+        };
+        dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
+            public void onClick(DialogInterface dialog, int which) {
+                if (which == 0) {
+                    showSelectAccountAlertDialog();
+                } else if (which == 1) {
+                    removeSyncAccount();
+                    refreshUI();
+                }
+            }
+        });
+        dialogBuilder.show();
+    }
+
+    private Account[] getGoogleAccounts() {
+        AccountManager accountManager = AccountManager.get(this);
+        return accountManager.getAccountsByType("com.google");
+    }
+
+    private void setSyncAccount(String account) {
+        if (!getSyncAccountName(this).equals(account)) {
+            SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+            SharedPreferences.Editor editor = settings.edit();
+            if (account != null) {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
+            } else {
+                editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+            }
+            editor.commit();
+
+            // clean up last sync time
+            setLastSyncTime(this, 0);
+
+            // clean up local gtask related info
+            new Thread(new Runnable() {
+                public void run() {
+                    ContentValues values = new ContentValues();
+                    values.put(NoteColumns.GTASK_ID, "");
+                    values.put(NoteColumns.SYNC_ID, 0);
+                    getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+                }
+            }).start();
+
+            Toast.makeText(NotesPreferenceActivity.this,
+                    getString(R.string.preferences_toast_success_set_accout, account),
+                    Toast.LENGTH_SHORT).show();
+        }
+    }
+
+    private void removeSyncAccount() {
+        SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        if (settings.contains(PREFERENCE_SYNC_ACCOUNT_NAME)) {
+            editor.remove(PREFERENCE_SYNC_ACCOUNT_NAME);
+        }
+        if (settings.contains(PREFERENCE_LAST_SYNC_TIME)) {
+            editor.remove(PREFERENCE_LAST_SYNC_TIME);
+        }
+        editor.commit();
+
+        // clean up local gtask related info
+        new Thread(new Runnable() {
+            public void run() {
+                ContentValues values = new ContentValues();
+                values.put(NoteColumns.GTASK_ID, "");
+                values.put(NoteColumns.SYNC_ID, 0);
+                getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
+            }
+        }).start();
+    }
+
+    public static String getSyncAccountName(Context context) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
+    }
+
+    public static void setLastSyncTime(Context context, long time) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        SharedPreferences.Editor editor = settings.edit();
+        editor.putLong(PREFERENCE_LAST_SYNC_TIME, time);
+        editor.commit();
+    }
+
+    public static long getLastSyncTime(Context context) {
+        SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
+                Context.MODE_PRIVATE);
+        return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
+    }
+
+    private class GTaskReceiver extends BroadcastReceiver {
+
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            refreshUI();
+            if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
+                TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
+                syncStatus.setText(intent
+                        .getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));
+            }
+
+        }
+    }
+
+    public boolean onOptionsItemSelected(MenuItem item) {
+        switch (item.getItemId()) {
+            case android.R.id.home:
+                Intent intent = new Intent(this, NotesListActivity.class);
+                intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
+                startActivity(intent);
+                return true;
+            default:
+                return false;
+        }
+    }
+}

src/net/micode/notes/widget/NoteWidgetProvider.java

@@ -15,6 +15,7 @@
  */
 
 package net.micode.notes.widget;
+
 import android.app.PendingIntent;
 import android.appwidget.AppWidgetManager;
 import android.appwidget.AppWidgetProvider;
@@ -32,101 +33,144 @@ import net.micode.notes.tool.ResourceParser;
 import net.micode.notes.ui.NoteEditActivity;
 import net.micode.notes.ui.NotesListActivity;
 
+/**
+ * 基础类：NoteWidgetProvider，用于管理便签小部件的生命周期和更新逻辑。
+ */
 public abstract class NoteWidgetProvider extends AppWidgetProvider {
-    public static final String [] PROJECTION = new String [] {
-        NoteColumns.ID,
-        NoteColumns.BG_COLOR_ID,
-        NoteColumns.SNIPPET
+
+    // 数据库查询所需字段
+    public static final String[] PROJECTION = new String[]{
+            NoteColumns.ID,
+            NoteColumns.BG_COLOR_ID,
+            NoteColumns.SNIPPET
     };
 
-    public static final int COLUMN_ID           = 0;
-    public static final int COLUMN_BG_COLOR_ID  = 1;
-    public static final int COLUMN_SNIPPET      = 2;
+    // PROJECTION 的索引
+    public static final int COLUMN_ID = 0;
+    public static final int COLUMN_BG_COLOR_ID = 1;
+    public static final int COLUMN_SNIPPET = 2;
 
     private static final String TAG = "NoteWidgetProvider";
 
+    /**
+     * 当某个小部件被删除时调用。
+     * 删除小部件对应的数据库信息，将 WIDGET_ID 设置为无效值。
+     */
     @Override
     public void onDeleted(Context context, int[] appWidgetIds) {
         ContentValues values = new ContentValues();
         values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
+
+        // 遍历所有被删除的小部件 ID，更新数据库
         for (int i = 0; i < appWidgetIds.length; i++) {
-            context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
+            context.getContentResolver().update(
+                    Notes.CONTENT_NOTE_URI,
                     values,
                     NoteColumns.WIDGET_ID + "=?",
-                    new String[] { String.valueOf(appWidgetIds[i])});
+                    new String[]{String.valueOf(appWidgetIds[i])});
         }
     }
 
+    /**
+     * 从数据库中获取指定小部件 ID 的便签信息。
+     */
     private Cursor getNoteWidgetInfo(Context context, int widgetId) {
-        return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
+        return context.getContentResolver().query(
+                Notes.CONTENT_NOTE_URI,
                 PROJECTION,
                 NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
-                new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
+                new String[]{String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER)},
                 null);
     }
 
+    /**
+     * 更新指定小部件的显示内容（调用重载方法）。
+     */
     protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
-        update(context, appWidgetManager, appWidgetIds, false);
+        update(context, appWidgetManager, appWidgetIds, false); // 默认非隐私模式
     }
 
+    /**
+     * 更新小部件内容。
+     *
+     * @param privacyMode 是否为隐私模式
+     */
     private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
-            boolean privacyMode) {
+                        boolean privacyMode) {
         for (int i = 0; i < appWidgetIds.length; i++) {
+            // 忽略无效小部件 ID
             if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
-                int bgId = ResourceParser.getDefaultBgId(context);
-                String snippet = "";
+                int bgId = ResourceParser.getDefaultBgId(context); // 默认背景颜色 ID
+                String snippet = ""; // 便签内容
+
+                // 创建启动 NoteEditActivity 的 Intent
                 Intent intent = new Intent(context, NoteEditActivity.class);
                 intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
                 intent.putExtra(Notes.INTENT_EXTRA_WIDGET_ID, appWidgetIds[i]);
                 intent.putExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, getWidgetType());
 
+                // 查询小部件对应的便签信息
                 Cursor c = getNoteWidgetInfo(context, appWidgetIds[i]);
                 if (c != null && c.moveToFirst()) {
                     if (c.getCount() > 1) {
                         Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
                         c.close();
-                        return;
+                        return; // 如果有多个便签对应同一小部件 ID，返回错误
                     }
-                    snippet = c.getString(COLUMN_SNIPPET);
-                    bgId = c.getInt(COLUMN_BG_COLOR_ID);
-                    intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
-                    intent.setAction(Intent.ACTION_VIEW);
+                    snippet = c.getString(COLUMN_SNIPPET); // 获取便签内容
+                    bgId = c.getInt(COLUMN_BG_COLOR_ID); // 获取便签背景 ID
+                    intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID)); // 传递便签 ID
+                    intent.setAction(Intent.ACTION_VIEW); // 设置动作为查看
                 } else {
-                    snippet = context.getResources().getString(R.string.widget_havenot_content);
-                    intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
+                    snippet = context.getResources().getString(R.string.widget_havenot_content); // 无便签内容时的占位文本
+                    intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 设置动作为插入或编辑
                 }
 
                 if (c != null) {
-                    c.close();
+                    c.close(); // 关闭游标
                 }
 
+                // 设置小部件的显示内容
                 RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
-                rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
+                rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId)); // 设置背景图像
                 intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
-                /**
-                 * Generate the pending intent to start host for the widget
-                 */
+
+                // 根据隐私模式设置小部件显示和点击动作
                 PendingIntent pendingIntent = null;
                 if (privacyMode) {
-                    rv.setTextViewText(R.id.widget_text,
-                            context.getString(R.string.widget_under_visit_mode));
-                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], new Intent(
-                            context, NotesListActivity.class), PendingIntent.FLAG_UPDATE_CURRENT);
+                    rv.setTextViewText(R.id.widget_text, context.getString(R.string.widget_under_visit_mode)); // 隐私模式文本
+                    pendingIntent = PendingIntent.getActivity(
+                            context,
+                            appWidgetIds[i],
+                            new Intent(context, NotesListActivity.class),
+                            PendingIntent.FLAG_UPDATE_CURRENT);
                 } else {
-                    rv.setTextViewText(R.id.widget_text, snippet);
-                    pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
+                    rv.setTextViewText(R.id.widget_text, snippet); // 显示便签内容
+                    pendingIntent = PendingIntent.getActivity(
+                            context,
+                            appWidgetIds[i],
+                            intent,
                             PendingIntent.FLAG_UPDATE_CURRENT);
                 }
 
-                rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
-                appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
+                rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent); // 设置点击事件
+                appWidgetManager.updateAppWidget(appWidgetIds[i], rv); // 更新小部件
             }
         }
     }
 
+    /**
+     * 获取背景资源 ID（由子类实现）。
+     */
     protected abstract int getBgResourceId(int bgId);
 
+    /**
+     * 获取布局 ID（由子类实现）。
+     */
     protected abstract int getLayoutId();
 
+    /**
+     * 获取小部件类型（由子类实现）。
+     */
     protected abstract int getWidgetType();
 }

src/net/micode/notes/widget/NoteWidgetProvider_2x.java

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.content.Context;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+/**
+ * NoteWidgetProvider_2x 类，用于实现 2x 大小的便签小部件功能。
+ * 继承自 NoteWidgetProvider，并实现特定布局和功能。
+ */
+public class NoteWidgetProvider_2x extends NoteWidgetProvider {
+
+    /**
+     * 当小部件需要更新时调用。
+     * 这里调用了父类的 update 方法实现小部件更新逻辑。
+     *
+     * @param context         上下文对象
+     * @param appWidgetManager AppWidgetManager，用于更新小部件
+     * @param appWidgetIds     当前需要更新的小部件 ID 数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        super.update(context, appWidgetManager, appWidgetIds); // 调用父类的更新方法
+    }
+
+    /**
+     * 获取 2x 小部件的布局 ID。
+     * 此布局定义了 2x 大小小部件的外观。
+     *
+     * @return 小部件布局文件的资源 ID
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_2x; // 指定 2x 小部件的布局资源
+    }
+
+    /**
+     * 获取 2x 小部件的背景资源 ID。
+     * 根据便签的背景颜色 ID 返回对应的资源。
+     *
+     * @param bgId 背景颜色 ID
+     * @return 对应的背景资源 ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId); // 获取 2x 背景资源
+    }
+
+    /**
+     * 获取 2x 小部件的类型。
+     * 定义了该小部件的类型标识，用于区分不同大小的小部件。
+     *
+     * @return 小部件类型的标识
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_2X; // 返回 2x 小部件的类型标识
+    }
+}

src/net/micode/notes/widget/NoteWidgetProvider_4x.java

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package net.micode.notes.widget;
+
+import android.appwidget.AppWidgetManager;
+import android.content.Context;
+
+import net.micode.notes.R;
+import net.micode.notes.data.Notes;
+import net.micode.notes.tool.ResourceParser;
+
+/**
+ * NoteWidgetProvider_4x 类用于实现 4x 大小的便签小部件功能。
+ * 继承自 NoteWidgetProvider，并实现特定布局和功能。
+ */
+public class NoteWidgetProvider_4x extends NoteWidgetProvider {
+
+    /**
+     * 当小部件需要更新时调用。
+     * 调用了父类的 update 方法来实现小部件更新逻辑。
+     *
+     * @param context         上下文对象
+     * @param appWidgetManager AppWidgetManager，用于更新小部件
+     * @param appWidgetIds     当前需要更新的小部件 ID 数组
+     */
+    @Override
+    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
+        super.update(context, appWidgetManager, appWidgetIds); // 调用父类的更新逻辑
+    }
+
+    /**
+     * 获取 4x 小部件的布局 ID。
+     * 返回对应的布局资源 ID。
+     *
+     * @return 小部件布局文件的资源 ID
+     */
+    @Override
+    protected int getLayoutId() {
+        return R.layout.widget_4x; // 使用 4x 大小的小部件布局文件
+    }
+
+    /**
+     * 获取 4x 小部件的背景资源 ID。
+     * 根据便签的背景颜色 ID 返回对应的背景资源。
+     *
+     * @param bgId 背景颜色 ID
+     * @return 对应的背景资源 ID
+     */
+    @Override
+    protected int getBgResourceId(int bgId) {
+        return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId); // 获取 4x 背景资源
+    }
+
+    /**
+     * 获取 4x 小部件的类型。
+     * 定义了该小部件的类型标识，用于区分不同大小的小部件。
+     *
+     * @return 小部件类型的标识
+     */
+    @Override
+    protected int getWidgetType() {
+        return Notes.TYPE_WIDGET_4X; // 返回 4x 小部件的类型标识
+    }
+}