注释

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

@@ -128,9 +128,11 @@ public class WorkingNote {
         Cursor cursor = mContext.getContentResolver().query(
                 ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
                 null, null);
-
+        // 检查查询结果是否为空
         if (cursor != null) {
+            // 移动到查询结果的第一行（如果有多行数据）
             if (cursor.moveToFirst()) {
+                // 从查询结果中获取笔记的相关信息并存储到相应的成员变量中
                 mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
                 mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
                 mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
@@ -138,37 +140,49 @@ public class WorkingNote {
                 mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
                 mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
             }
+            // 关闭查询结果的游标
             cursor.close();
         } else {
+            // 如果查询结果为空，则输出错误日志并抛出异常
             Log.e(TAG, "No note with id:" + mNoteId);
             throw new IllegalArgumentException("Unable to find note with id " + mNoteId);
         }
+        // 调用loadNoteData()方法加载笔记的其他数据
         loadNoteData();
     }
 
     private void loadNoteData() {
+        // 通过内容解析器(ContentResolver)查询笔记的数据信息
         Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
                 DataColumns.NOTE_ID + "=?", new String[] {
                     String.valueOf(mNoteId)
                 }, null);
-
+        // 检查查询结果是否为空
         if (cursor != null) {
+            // 移动到查询结果的第一行（如果有多行数据）
             if (cursor.moveToFirst()) {
                 do {
+                    // 获取数据类型
                     String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
+                    // 根据数据类型进行不同的处理
                     if (DataConstants.NOTE.equals(type)) {
+                        // 如果是笔记类型的数据，获取内容和模式，并设置到相应的成员变量中
                         mContent = cursor.getString(DATA_CONTENT_COLUMN);
                         mMode = cursor.getInt(DATA_MODE_COLUMN);
                         mNote.setTextDataId(cursor.getLong(DATA_ID_COLUMN));
                     } else if (DataConstants.CALL_NOTE.equals(type)) {
+                        // 如果是通话笔记类型的数据，设置通话数据ID到相应的成员变量中
                         mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
                     } else {
+                        // 如果是未知类型的数据，输出调试信息
                         Log.d(TAG, "Wrong note type with type:" + type);
                     }
                 } while (cursor.moveToNext());
             }
+            // 关闭查询结果的游标
             cursor.close();
         } else {
+            // 如果查询结果为空，则输出错误日志并抛出异常
             Log.e(TAG, "No data with id:" + mNoteId);
             throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
         }
@@ -188,27 +202,32 @@ public class WorkingNote {
     }
 
     public synchronized boolean saveNote() {
+        // 检查笔记是否值得保存
         if (isWorthSaving()) {
+            // 检查笔记是否存在于数据库中
             if (!existInDatabase()) {
+                // 如果笔记在数据库中不存在，尝试创建一个新的笔记ID
                 if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
+                    // 如果创建新的笔记ID失败，输出错误日志并返回保存失败
                     Log.e(TAG, "Create new note fail with id:" + mNoteId);
                     return false;
                 }
             }
-
+            // 同步笔记信息到数据库中
             mNote.syncNote(mContext, mNoteId);
 
             /**
              * Update widget content if there exist any widget of this note
              */
+            // 如果存在与该笔记相关的小部件，并且小部件类型有效，并且存在小部件设置状态监听器，则通知小部件内容已更改
             if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                     && mWidgetType != Notes.TYPE_WIDGET_INVALIDE
                     && mNoteSettingStatusListener != null) {
                 mNoteSettingStatusListener.onWidgetChanged();
             }
-            return true;
+            return true;//保存成功
         } else {
-            return false;
+            return false;//保存失败
         }
     }
 
@@ -230,38 +249,55 @@ public class WorkingNote {
     }
 
     public void setAlertDate(long date, boolean set) {
+        // 检查传入的日期是否与当前提醒日期不同
         if (date != mAlertDate) {
+            // 如果不同，更新当前提醒日期为传入的日期，并通过 mNote 对象将更新后的提醒日期同步到数据库中
             mAlertDate = date;
             mNote.setNoteValue(NoteColumns.ALERTED_DATE, String.valueOf(mAlertDate));
         }
+        // 检查是否存在笔记设置状态监听器
         if (mNoteSettingStatusListener != null) {
+            // 如果存在，调用监听器的 onClockAlertChanged 方法，通知提醒日期已更改，并传递新的日期和开关状态
             mNoteSettingStatusListener.onClockAlertChanged(date, set);
         }
     }
 
     public void markDeleted(boolean mark) {
+        // 将笔记的删除状态更新为传入的标记值
         mIsDeleted = mark;
+        // 检查是否存在与该笔记相关的小部件，并且小部件类型有效，并且存在笔记设置状态监听器
         if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
                 && mWidgetType != Notes.TYPE_WIDGET_INVALIDE && mNoteSettingStatusListener != null) {
+            // 如果条件满足，调用监听器的 onWidgetChanged 方法，通知小部件内容已更改
                 mNoteSettingStatusListener.onWidgetChanged();
         }
     }
 
     public void setBgColorId(int id) {
+        // 检查传入的颜色ID是否与当前背景颜色ID不同
         if (id != mBgColorId) {
+            // 如果不同，更新当前背景颜色ID为传入的颜色ID
             mBgColorId = id;
+            // 检查是否存在笔记设置状态监听器
             if (mNoteSettingStatusListener != null) {
+                // 如果存在，调用监听器的 onBackgroundColorChanged 方法，通知背景颜色已更改
                 mNoteSettingStatusListener.onBackgroundColorChanged();
             }
+            // 通过 mNote 对象将更新后的背景颜色ID同步到数据库中
             mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
         }
     }
 
     public void setCheckListMode(int mode) {
         if (mMode != mode) {
+            // 如果不同，更新当前模式为传入的模式
+
+            // 检查是否存在笔记设置状态监听器
             if (mNoteSettingStatusListener != null) {
+                // 如果存在，调用监听器的 onCheckListModeChanged 方法，通知检查清单模式已更改，并传递旧模式和新模式
                 mNoteSettingStatusListener.onCheckListModeChanged(mMode, mode);
             }
+            // 将当前模式更新为传入的模式，并通过 mNote 对象将更新后的模式同步到数据库中
             mMode = mode;
             mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
         }
@@ -275,15 +311,23 @@ public class WorkingNote {
     }
 
     public void setWidgetId(int id) {
+        // 检查传入的小部件类型是否与当前小部件类型不同
         if (id != mWidgetId) {
+            // 如果不同，更新当前小部件类型为传入的小部件类型
             mWidgetId = id;
+
+            // 通过 mNote 对象将更新后的小部件类型同步到数据库中
             mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
         }
     }
 
     public void setWorkingText(String text) {
+        // 检查传入的文本内容是否与当前内容不同
         if (!TextUtils.equals(mContent, text)) {
+            // 如果不同，更新当前内容为传入的文本内容
+
             mContent = text;
+            // 通过 mNote 对象将更新后的文本内容同步到数据库中
             mNote.setTextData(DataColumns.CONTENT, mContent);
         }
     }