diff --git a/src/net/micode/notes/model/WorkingNote.java b/src/net/micode/notes/model/WorkingNote.java index be081e4..dc807f7 100644 --- a/src/net/micode/notes/model/WorkingNote.java +++ b/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); } }