|
|
|
|
@ -14,19 +14,23 @@
|
|
|
|
|
* limitations under the License.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
|
|
|
|
import android.content.Context;
|
|
|
|
|
import android.database.Cursor;
|
|
|
|
|
import android.text.TextUtils;
|
|
|
|
|
import android.content.Context;
|
|
|
|
|
import android.database.Cursor;
|
|
|
|
|
import android.text.TextUtils;
|
|
|
|
|
|
|
|
|
|
import net.micode.notes.data.Contact;
|
|
|
|
|
import net.micode.notes.data.Notes;
|
|
|
|
|
import net.micode.notes.data.Notes.NoteColumns;
|
|
|
|
|
import net.micode.notes.tool.DataUtils;
|
|
|
|
|
import net.micode.notes.data.Contact;
|
|
|
|
|
import net.micode.notes.data.Notes;
|
|
|
|
|
import net.micode.notes.data.Notes.NoteColumns;
|
|
|
|
|
import net.micode.notes.tool.DataUtils;
|
|
|
|
|
|
|
|
|
|
// NoteItemData类用于从数据库游标（Cursor）中提取笔记相关的数据信息，并进行一些必要的处理和状态判断，
|
|
|
|
|
// 方便在应用中以对象的形式使用和传递笔记的各项属性数据，例如笔记的ID、创建日期、是否有附件等信息。
|
|
|
|
|
public class NoteItemData {
|
|
|
|
|
|
|
|
|
|
public class NoteItemData {
|
|
|
|
|
// 定义一个字符串数组，用于指定从数据库查询笔记相关信息时需要获取的列名，涵盖了笔记的多个属性字段，
|
|
|
|
|
// 后续可通过游标（Cursor）根据这些列名获取对应的数据来填充当前类的各个成员变量。
|
|
|
|
|
static final String [] PROJECTION = new String [] {
|
|
|
|
|
NoteColumns.ID,
|
|
|
|
|
NoteColumns.ALERTED_DATE,
|
|
|
|
|
@ -42,91 +46,161 @@ public class NoteItemData {
|
|
|
|
|
NoteColumns.WIDGET_TYPE,
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"ID"列所在的索引位置，方便后续通过游标获取对应列的数据。
|
|
|
|
|
private static final int ID_COLUMN = 0;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"ALERTED_DATE"列所在的索引位置，用于获取笔记的提醒日期数据。
|
|
|
|
|
private static final int ALERTED_DATE_COLUMN = 1;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"BG_COLOR_ID"列所在的索引位置，用于获取笔记的背景颜色ID数据。
|
|
|
|
|
private static final int BG_COLOR_ID_COLUMN = 2;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"CREATED_DATE"列所在的索引位置，用于获取笔记的创建日期数据。
|
|
|
|
|
private static final int CREATED_DATE_COLUMN = 3;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"HAS_ATTACHMENT"列所在的索引位置，用于判断笔记是否有附件。
|
|
|
|
|
private static final int HAS_ATTACHMENT_COLUMN = 4;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"MODIFIED_DATE"列所在的索引位置，用于获取笔记的修改日期数据。
|
|
|
|
|
private static final int MODIFIED_DATE_COLUMN = 5;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"NOTES_COUNT"列所在的索引位置，可能用于获取与笔记相关的数量信息（具体含义取决于业务逻辑）。
|
|
|
|
|
private static final int NOTES_COUNT_COLUMN = 6;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"PARENT_ID"列所在的索引位置，用于获取笔记所属父级的ID（例如所属文件夹的ID等）。
|
|
|
|
|
private static final int PARENT_ID_COLUMN = 7;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"SNIPPET"列所在的索引位置，通常用于获取笔记的摘要、简短描述等文本内容。
|
|
|
|
|
private static final int SNIPPET_COLUMN = 8;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"TYPE"列所在的索引位置，用于获取笔记的类型信息（例如普通笔记、系统笔记等不同类型的区分）。
|
|
|
|
|
private static final int TYPE_COLUMN = 9;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"WIDGET_ID"列所在的索引位置，可能与笔记在桌面小部件等相关功能中的标识ID有关。
|
|
|
|
|
private static final int WIDGET_ID_COLUMN = 10;
|
|
|
|
|
// 定义一个常量，表示在查询结果游标（Cursor）中"WIDGET_TYPE"列所在的索引位置，可能用于区分不同类型的桌面小部件相关信息（如果有涉及的话）。
|
|
|
|
|
private static final int WIDGET_TYPE_COLUMN = 11;
|
|
|
|
|
|
|
|
|
|
// 用于存储笔记的ID，从数据库游标中获取对应列的数据进行赋值，代表该笔记在系统中的唯一标识。
|
|
|
|
|
private long mId;
|
|
|
|
|
// 用于存储笔记的提醒日期，从数据库游标获取对应数据，可用于判断笔记是否设置了提醒以及具体的提醒时间点。
|
|
|
|
|
private long mAlertDate;
|
|
|
|
|
// 用于存储笔记的背景颜色ID，根据游标数据赋值，可能用于在界面上显示笔记时设置对应的背景颜色。
|
|
|
|
|
private int mBgColorId;
|
|
|
|
|
// 用于存储笔记的创建日期，通过游标获取，记录笔记最初被创建的时间信息。
|
|
|
|
|
private long mCreatedDate;
|
|
|
|
|
// 用于标记笔记是否有附件，根据游标中对应列的数据转换为布尔值进行存储（大于0表示有附件，赋值为true，否则为false）。
|
|
|
|
|
private boolean mHasAttachment;
|
|
|
|
|
// 用于存储笔记的修改日期，从游标获取相应数据，可用于跟踪笔记最后一次被修改的时间。
|
|
|
|
|
private long mModifiedDate;
|
|
|
|
|
// 用于存储与笔记相关的数量信息（具体含义取决于业务逻辑，可能是关联的子笔记数量等情况），从游标获取对应整数值进行赋值。
|
|
|
|
|
private int mNotesCount;
|
|
|
|
|
// 用于存储笔记所属父级的ID（比如所属文件夹的ID），从游标获取相应长整数值，方便判断笔记的归属关系等。
|
|
|
|
|
private long mParentId;
|
|
|
|
|
// 用于存储笔记的摘要、简短描述等文本内容，从游标获取字符串数据，并进行一些特定字符串替换操作后赋值，去除可能存在的特定标记字符。
|
|
|
|
|
private String mSnippet;
|
|
|
|
|
// 用于存储笔记的类型信息，从游标获取对应整数来表示不同类型（例如普通笔记、系统笔记等不同分类），便于后续根据类型进行不同的业务逻辑处理。
|
|
|
|
|
private int mType;
|
|
|
|
|
// 用于存储可能与笔记在桌面小部件等相关功能中的标识ID，从游标获取对应整数值进行赋值（具体用途取决于相关小部件功能实现）。
|
|
|
|
|
private int mWidgetId;
|
|
|
|
|
// 用于存储可能用于区分不同类型桌面小部件相关信息的类型值（如果有涉及桌面小部件相关业务逻辑的话），从游标获取对应整数进行赋值。
|
|
|
|
|
private int mWidgetType;
|
|
|
|
|
// 用于存储与笔记相关的联系人姓名信息，如果笔记属于通话记录文件夹等相关情况，会尝试获取对应的联系人姓名，初始化为空字符串。
|
|
|
|
|
private String mName;
|
|
|
|
|
// 用于存储与笔记相关的电话号码信息，如果笔记属于通话记录文件夹，会尝试获取对应的电话号码，初始化为空字符串。
|
|
|
|
|
private String mPhoneNumber;
|
|
|
|
|
|
|
|
|
|
// 用于标记当前笔记数据对应的笔记是否是列表中的最后一项，根据游标是否处于最后一条记录来判断赋值。
|
|
|
|
|
private boolean mIsLastItem;
|
|
|
|
|
// 用于标记当前笔记数据对应的笔记是否是列表中的第一项，根据游标是否处于第一条记录来判断赋值。
|
|
|
|
|
private boolean mIsFirstItem;
|
|
|
|
|
// 用于标记当前笔记数据对应的笔记是否是列表中唯一的一项，通过判断游标获取的总记录数是否为1来赋值。
|
|
|
|
|
private boolean mIsOnlyOneItem;
|
|
|
|
|
// 用于标记当前笔记数据对应的笔记是否是某文件夹下仅跟随的一个笔记（具体判断逻辑在后续方法中实现），初始化为false。
|
|
|
|
|
private boolean mIsOneNoteFollowingFolder;
|
|
|
|
|
// 用于标记当前笔记数据对应的笔记是否是某文件夹下跟随的多个笔记之一（具体判断逻辑在后续方法中实现），初始化为false。
|
|
|
|
|
private boolean mIsMultiNotesFollowingFolder;
|
|
|
|
|
|
|
|
|
|
// 构造函数，接收上下文（Context）和数据库游标（Cursor）作为参数，用于从游标中提取笔记相关的各项数据信息并进行初始化操作，
|
|
|
|
|
// 同时还会进行一些与笔记位置、关联情况相关的状态判断。
|
|
|
|
|
public NoteItemData(Context context, Cursor cursor) {
|
|
|
|
|
// 从游标中获取笔记的ID数据，赋值给对应的成员变量mId。
|
|
|
|
|
mId = cursor.getLong(ID_COLUMN);
|
|
|
|
|
// 从游标中获取笔记的提醒日期数据，赋值给mAlertDate成员变量。
|
|
|
|
|
mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
|
|
|
|
|
// 从游标中获取笔记的背景颜色ID数据，赋值给mBgColorId成员变量。
|
|
|
|
|
mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
|
|
|
|
|
// 从游标中获取笔记的创建日期数据，赋值给mCreatedDate成员变量。
|
|
|
|
|
mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
|
|
|
|
|
mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
|
|
|
|
|
// 根据游标中获取的表示是否有附件的数据（整数值），转换为布尔值后赋值给mHasAttachment成员变量，大于0表示有附件，赋值为true，否则为false。
|
|
|
|
|
mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0)? true : false;
|
|
|
|
|
// 从游标中获取笔记的修改日期数据，赋值给mModifiedDate成员变量。
|
|
|
|
|
mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
|
|
|
|
|
// 从游标中获取与笔记相关的数量信息（具体含义取决于业务逻辑），赋值给mNotesCount成员变量。
|
|
|
|
|
mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
|
|
|
|
|
// 从游标中获取笔记所属父级的ID（例如所属文件夹的ID等），赋值给mParentId成员变量。
|
|
|
|
|
mParentId = cursor.getLong(PARENT_ID_COLUMN);
|
|
|
|
|
// 从游标中获取笔记的摘要、简短描述等文本内容，赋值给mSnippet成员变量，并进行特定字符串替换操作，去除可能存在的特定标记字符（如NoteEditActivity.TAG_CHECKED和NoteEditActivity.TAG_UNCHECKED）。
|
|
|
|
|
mSnippet = cursor.getString(SNIPPET_COLUMN);
|
|
|
|
|
mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
|
|
|
|
|
NoteEditActivity.TAG_UNCHECKED, "");
|
|
|
|
|
// 从游标中获取笔记的类型信息（整数表示不同类型），赋值给mType成员变量，便于后续根据类型进行不同业务逻辑处理。
|
|
|
|
|
mType = cursor.getInt(TYPE_COLUMN);
|
|
|
|
|
mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
|
|
|
|
|
// 从游标中获取可能与笔记在桌面小部件等相关功能中的标识ID（具体用途取决于相关小部件功能实现），赋值给mWidgetId成员变量。
|
|
|
|
|
mWidgetId = cursor.getInt(WIDGET_TYPE_COLUMN);
|
|
|
|
|
// 从游标中获取可能用于区分不同类型桌面小部件相关信息的类型值（如果有涉及桌面小部件相关业务逻辑的话），赋值给mWidgetType成员变量。
|
|
|
|
|
mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
|
|
|
|
|
|
|
|
|
|
// 初始化电话号码成员变量为空字符串，后续根据笔记所属情况等可能会重新赋值。
|
|
|
|
|
mPhoneNumber = "";
|
|
|
|
|
// 如果笔记所属父级ID等于通话记录文件夹的特定ID（Notes.ID_CALL_RECORD_FOLDER），表示该笔记与通话记录相关，尝试获取对应的电话号码。
|
|
|
|
|
if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
|
|
|
|
|
// 通过DataUtils工具类的方法，根据笔记ID从内容解析器（context.getContentResolver()）中获取对应的电话号码信息，并赋值给mPhoneNumber成员变量。
|
|
|
|
|
mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
|
|
|
|
|
// 如果获取到的电话号码不为空字符串，说明找到了对应的电话号码，尝试获取对应的联系人姓名。
|
|
|
|
|
if (!TextUtils.isEmpty(mPhoneNumber)) {
|
|
|
|
|
// 通过Contact类的静态方法，根据上下文（context）和电话号码（mPhoneNumber）获取对应的联系人姓名，赋值给mName成员变量。
|
|
|
|
|
mName = Contact.getContact(context, mPhoneNumber);
|
|
|
|
|
// 如果获取联系人姓名失败（返回null），则将电话号码本身作为联系人姓名赋值给mName成员变量。
|
|
|
|
|
if (mName == null) {
|
|
|
|
|
mName = mPhoneNumber;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 如果最终联系人姓名仍为null（可能之前获取过程都失败了），则将其设置为空字符串，保证成员变量有合理的初始值。
|
|
|
|
|
if (mName == null) {
|
|
|
|
|
mName = "";
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 调用checkPostion方法，根据游标情况进行一些与笔记位置、在文件夹下关联情况等相关的状态判断，更新对应的成员变量值。
|
|
|
|
|
checkPostion(cursor);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 私有方法，用于根据游标情况进行一些与笔记位置、在文件夹下关联情况等相关的状态判断，更新对应的成员变量值，
|
|
|
|
|
// 例如判断是否是某文件夹下唯一跟随的笔记、是否是多个笔记跟随某文件夹等情况。
|
|
|
|
|
private void checkPostion(Cursor cursor) {
|
|
|
|
|
mIsLastItem = cursor.isLast() ? true : false;
|
|
|
|
|
mIsFirstItem = cursor.isFirst() ? true : false;
|
|
|
|
|
// 根据游标是否处于最后一条记录，判断当前笔记是否是列表中的最后一项，赋值给mIsLastItem成员变量。
|
|
|
|
|
mIsLastItem = cursor.isLast()? true : false;
|
|
|
|
|
// 根据游标是否处于第一条记录，判断当前笔记是否是列表中的第一项，赋值给mIsFirstItem成员变量。
|
|
|
|
|
mIsFirstItem = cursor.isFirst()? true : false;
|
|
|
|
|
// 通过判断游标获取的总记录数是否为1，确定当前笔记是否是列表中唯一的一项，赋值给mIsOnlyOneItem成员变量。
|
|
|
|
|
mIsOnlyOneItem = (cursor.getCount() == 1);
|
|
|
|
|
// 初始化是否是某文件夹下跟随的多个笔记的标记为false，后续根据具体判断逻辑可能会更新。
|
|
|
|
|
mIsMultiNotesFollowingFolder = false;
|
|
|
|
|
// 初始化是否是某文件夹下仅跟随的一个笔记的标记为false，后续根据具体判断逻辑可能会更新。
|
|
|
|
|
mIsOneNoteFollowingFolder = false;
|
|
|
|
|
|
|
|
|
|
if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
|
|
|
|
|
// 如果笔记类型是普通笔记（Notes.TYPE_NOTE）且不是列表中的第一项（即前面还有其他记录），进行以下判断逻辑。
|
|
|
|
|
if (mType == Notes.TYPE_NOTE &&!mIsFirstItem) {
|
|
|
|
|
// 获取当前游标所在的位置索引，用于后续判断操作。
|
|
|
|
|
int position = cursor.getPosition();
|
|
|
|
|
// 将游标移动到前一条记录，以便查看前一条记录对应的笔记类型等信息。
|
|
|
|
|
if (cursor.moveToPrevious()) {
|
|
|
|
|
// 判断前一条记录对应的笔记类型是否是文件夹类型（Notes.TYPE_FOLDER）或者系统类型（Notes.TYPE_SYSTEM），
|
|
|
|
|
// 如果是，则说明当前笔记可能是跟随在某个文件夹或系统记录之后的笔记，继续进行后续判断。
|
|
|
|
|
if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
|
|
|
|
|
|| cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
|
|
|
|
|
// 判断游标获取的总记录数是否大于当前位置索引加1（即当前笔记后面是否还有其他记录），
|
|
|
|
|
// 如果是，则说明当前笔记是某文件夹下跟随的多个笔记之一，将对应标记变量设置为true。
|
|
|
|
|
if (cursor.getCount() > (position + 1)) {
|
|
|
|
|
mIsMultiNotesFollowingFolder = true;
|
|
|
|
|
} else {
|
|
|
|
|
// 如果后面没有其他记录了，则说明当前笔记是某文件夹下仅跟随的一个笔记，将对应标记变量设置为true。
|
|
|
|
|
mIsOneNoteFollowingFolder = true;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
// 将游标再移回原来的位置（即当前笔记对应的记录位置），保证游标位置的正确性，避免影响后续其他操作对游标的使用。
|
|
|
|
|
if (!cursor.moveToNext()) {
|
|
|
|
|
throw new IllegalStateException("cursor move to previous but can't move back");
|
|
|
|
|
}
|
|
|
|
|
@ -134,90 +208,125 @@ public class NoteItemData {
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断当前笔记是否是某文件夹下仅跟随的一个笔记，返回对应的标记变量值，外部可调用此方法获取该状态信息。
|
|
|
|
|
public boolean isOneFollowingFolder() {
|
|
|
|
|
return mIsOneNoteFollowingFolder;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断当前笔记是否是某文件夹下跟随的多个笔记之一，返回对应的标记变量值，外部可调用此方法获取该状态信息。
|
|
|
|
|
public boolean isMultiFollowingFolder() {
|
|
|
|
|
return mIsMultiNotesFollowingFolder;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断当前笔记是否是列表中的最后一项，返回对应的标记变量值，外部可调用此方法获取该状态信息。
|
|
|
|
|
public boolean isLast() {
|
|
|
|
|
return mIsLastItem;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取与笔记相关的联系人姓名信息（如果有获取到的话），返回对应的成员变量值，外部可调用此方法获取该姓名信息。
|
|
|
|
|
public String getCallName() {
|
|
|
|
|
return mName;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断当前笔记是否是列表中的第一项，返回对应的标记变量值，外部可调用此方法获取该状态信息。
|
|
|
|
|
public boolean isFirst() {
|
|
|
|
|
return mIsFirstItem;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断当前笔记是否是列表中唯一的一项，返回对应的标记变量值，外部可调用此方法获取该状态信息。
|
|
|
|
|
public boolean isSingle() {
|
|
|
|
|
return mIsOnlyOneItem;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的ID，返回对应的成员变量值，外部可调用此方法获取笔记的唯一标识信息。
|
|
|
|
|
public long getId() {
|
|
|
|
|
return mId;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的提醒日期，返回对应的成员变量值，外部可调用此方法获取笔记设置的提醒时间信息。
|
|
|
|
|
public long getAlertDate() {
|
|
|
|
|
return mAlertDate;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的创建日期，返回对应的成员变量值，外部可调用此方法获取笔记最初被创建的时间信息。
|
|
|
|
|
public long getCreatedDate() {
|
|
|
|
|
return mCreatedDate;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断笔记是否有附件，返回对应的标记变量值（mHasAttachment），外部可调用此方法获取笔记是否包含附件的状态信息，
|
|
|
|
|
// 如果返回true，表示笔记存在附件，否则表示没有附件。
|
|
|
|
|
public boolean hasAttachment() {
|
|
|
|
|
return mHasAttachment;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的修改日期，返回对应的成员变量值（mModifiedDate），外部可调用此方法获取笔记最后一次被修改的时间信息，
|
|
|
|
|
// 常用于记录笔记的修改历史、版本管理等相关业务逻辑场景中。
|
|
|
|
|
public long getModifiedDate() {
|
|
|
|
|
return mModifiedDate;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的背景颜色ID，返回对应的成员变量值（mBgColorId），外部可调用此方法获取用于设置笔记显示背景颜色的标识信息，
|
|
|
|
|
// 根据该ID可以在应用的颜色资源等相关配置中找到对应的具体颜色来应用到笔记展示界面上。
|
|
|
|
|
public int getBgColorId() {
|
|
|
|
|
return mBgColorId;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记所属父级的ID（例如所属文件夹的ID等），返回对应的成员变量值（mParentId），外部可调用此方法获取笔记的归属关系信息，
|
|
|
|
|
// 便于判断笔记位于哪个文件夹下或者隶属于哪个上级模块等情况，方便进行分类管理、层级展示等操作。
|
|
|
|
|
public long getParentId() {
|
|
|
|
|
return mParentId;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取与笔记相关的数量信息（具体含义取决于业务逻辑，可能是关联的子笔记数量等情况），返回对应的成员变量值（mNotesCount），
|
|
|
|
|
// 外部可调用此方法获取该数量值，在涉及笔记的统计、分组等业务场景中可能会用到。
|
|
|
|
|
public int getNotesCount() {
|
|
|
|
|
return mNotesCount;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记所属文件夹的ID，这里直接返回笔记的父级ID（mParentId），因为通常情况下父级就是所属的文件夹，外部可调用此方法明确获取到笔记所属文件夹的标识，
|
|
|
|
|
// 方便进行文件夹相关的操作，比如在文件夹内查找笔记、统计文件夹内笔记数量等操作。
|
|
|
|
|
public long getFolderId () {
|
|
|
|
|
return mParentId;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的类型信息，返回对应的成员变量值（mType），外部可调用此方法获取笔记所属的类型（例如普通笔记、系统笔记等不同分类），
|
|
|
|
|
// 根据不同类型可以在应用中进行差异化的展示、操作等业务逻辑处理，比如不同类型笔记有不同的编辑权限、显示样式等。
|
|
|
|
|
public int getType() {
|
|
|
|
|
return mType;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取可能用于区分不同类型桌面小部件相关信息的类型值（如果有涉及桌面小部件相关业务逻辑的话），返回对应的成员变量值（mWidgetType），
|
|
|
|
|
// 外部可调用此方法获取该类型值，以便针对不同小部件类型进行相应的配置、显示控制等操作，例如不同类型小部件展示笔记的不同部分内容或者交互方式不同等。
|
|
|
|
|
public int getWidgetType() {
|
|
|
|
|
return mWidgetType;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取可能与笔记在桌面小部件等相关功能中的标识ID（具体用途取决于相关小部件功能实现），返回对应的成员变量值（mWidgetId），
|
|
|
|
|
// 外部可调用此方法获取该标识ID，用于在小部件相关功能中准确识别和操作对应的笔记，比如在小部件中更新特定笔记的显示内容等情况。
|
|
|
|
|
public int getWidgetId() {
|
|
|
|
|
return mWidgetId;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 获取笔记的摘要、简短描述等文本内容，返回对应的成员变量值（mSnippet），外部可调用此方法获取笔记的简要信息，
|
|
|
|
|
// 常用于在列表展示等场景中先显示笔记的简短描述，用户点击后再查看详细内容，起到一个预览的作用。
|
|
|
|
|
public String getSnippet() {
|
|
|
|
|
return mSnippet;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断笔记是否设置了提醒，通过检查提醒日期（mAlertDate）是否大于0来确定，如果大于0则表示设置了提醒，返回true，否则返回false，
|
|
|
|
|
// 外部可调用此方法快速知晓笔记是否有提醒相关的设置，以便在应用中进行相应的提醒业务逻辑处理，比如定时提醒用户查看笔记等操作。
|
|
|
|
|
public boolean hasAlert() {
|
|
|
|
|
return (mAlertDate > 0);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 判断笔记是否属于通话记录类型，通过检查笔记所属父级ID是否等于通话记录文件夹的特定ID（Notes.ID_CALL_RECORD_FOLDER）并且电话号码（mPhoneNumber）不为空字符串来确定，
|
|
|
|
|
// 如果满足条件则返回true，表示是通话记录相关笔记，否则返回false，外部可调用此方法区分通话记录笔记和其他类型笔记，进行针对性的业务操作，例如通话记录笔记可能有特殊的展示格式或关联操作等。
|
|
|
|
|
public boolean isCallRecord() {
|
|
|
|
|
return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
|
|
|
|
|
return (mParentId == Notes.ID_CALL_RECORD_FOLDER &&!TextUtils.isEmpty(mPhoneNumber));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// 静态方法，接收数据库游标（Cursor）作为参数，从游标中获取笔记的类型信息（通过TYPE_COLUMN指定的列索引获取整数值）并返回，
|
|
|
|
|
// 外部可直接通过类名调用此方法，方便在不需要创建NoteItemData类实例的情况下，仅根据游标快速获取笔记的类型信息，常用于一些仅需判断类型的简单业务场景中。
|
|
|
|
|
public static int getNoteType(Cursor cursor) {
|
|
|
|
|
return cursor.getInt(TYPE_COLUMN);
|
|
|
|
|
}
|
|
|
|
|
|
