|
|
/*
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// NoteItemData.java - 便签项数据模型类
|
|
|
// 主要功能：封装便签列表项的数据，提供便捷的访问方法和位置判断逻辑
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
// ======================= 导入区域 =======================
|
|
|
// Android基础
|
|
|
import android.content.Context; // 上下文
|
|
|
import android.database.Cursor; // 数据库查询结果游标
|
|
|
import android.text.TextUtils; // 文本工具
|
|
|
|
|
|
// 应用内部工具
|
|
|
import net.micode.notes.data.Contact; // 联系人工具类
|
|
|
import net.micode.notes.data.Notes; // Notes主类
|
|
|
import net.micode.notes.data.Notes.NoteColumns; // 便签表列定义
|
|
|
import net.micode.notes.tool.DataUtils; // 数据工具
|
|
|
|
|
|
// ======================= 便签项数据模型 =======================
|
|
|
/**
|
|
|
* NoteItemData - 便签项数据模型类
|
|
|
* 功能：从数据库Cursor解析便签数据，封装为对象模型
|
|
|
* 用途：在便签列表适配器中表示单个便签项的数据
|
|
|
* 特点：包含位置判断逻辑，用于列表项背景选择
|
|
|
*/
|
|
|
public class NoteItemData {
|
|
|
|
|
|
// ======================= 数据库查询配置 =======================
|
|
|
|
|
|
/**
|
|
|
* 查询投影数组 - 指定从数据库查询哪些字段
|
|
|
* 包含便签表的所有重要字段
|
|
|
*/
|
|
|
static final String [] PROJECTION = new String [] {
|
|
|
NoteColumns.ID, // 0 - 便签ID
|
|
|
NoteColumns.ALERTED_DATE, // 1 - 提醒时间
|
|
|
NoteColumns.BG_COLOR_ID, // 2 - 背景颜色ID
|
|
|
NoteColumns.CREATED_DATE, // 3 - 创建时间
|
|
|
NoteColumns.HAS_ATTACHMENT, // 4 - 是否有附件
|
|
|
NoteColumns.MODIFIED_DATE, // 5 - 修改时间
|
|
|
NoteColumns.NOTES_COUNT, // 6 - 包含的便签数（文件夹用）
|
|
|
NoteColumns.PARENT_ID, // 7 - 父文件夹ID
|
|
|
NoteColumns.SNIPPET, // 8 - 便签摘要
|
|
|
NoteColumns.TYPE, // 9 - 便签类型
|
|
|
NoteColumns.WIDGET_ID, // 10 - 小部件ID
|
|
|
NoteColumns.WIDGET_TYPE, // 11 - 小部件类型
|
|
|
NoteColumns.PINNED // 12 - 是否置顶
|
|
|
};
|
|
|
|
|
|
// ======================= 字段索引常量 =======================
|
|
|
|
|
|
// 使用常量而非魔法数字，提高代码可读性
|
|
|
private static final int ID_COLUMN = 0; // ID字段索引
|
|
|
private static final int ALERTED_DATE_COLUMN = 1; // 提醒时间字段索引
|
|
|
private static final int BG_COLOR_ID_COLUMN = 2; // 背景颜色字段索引
|
|
|
private static final int CREATED_DATE_COLUMN = 3; // 创建时间字段索引
|
|
|
private static final int HAS_ATTACHMENT_COLUMN = 4; // 附件字段索引
|
|
|
private static final int MODIFIED_DATE_COLUMN = 5; // 修改时间字段索引
|
|
|
private static final int NOTES_COUNT_COLUMN = 6; // 便签数字段索引
|
|
|
private static final int PARENT_ID_COLUMN = 7; // 父ID字段索引
|
|
|
private static final int SNIPPET_COLUMN = 8; // 摘要字段索引
|
|
|
private static final int TYPE_COLUMN = 9; // 类型字段索引
|
|
|
private static final int WIDGET_ID_COLUMN = 10; // 小部件ID字段索引
|
|
|
private static final int WIDGET_TYPE_COLUMN = 11; // 小部件类型字段索引
|
|
|
private static final int PINNED_COLUMN = 12; // 是否置顶字段索引
|
|
|
|
|
|
// ======================= 数据成员 =======================
|
|
|
|
|
|
// 基本数据字段
|
|
|
private long mId; // 便签ID
|
|
|
private long mAlertDate; // 提醒时间戳
|
|
|
private int mBgColorId; // 背景颜色索引
|
|
|
private long mCreatedDate; // 创建时间戳
|
|
|
private boolean mHasAttachment; // 是否有附件
|
|
|
private long mModifiedDate; // 修改时间戳
|
|
|
private int mNotesCount; // 包含的便签数（文件夹）
|
|
|
private long mParentId; // 父文件夹ID
|
|
|
private String mSnippet; // 便签摘要
|
|
|
private int mType; // 便签类型
|
|
|
private int mWidgetId; // 小部件ID
|
|
|
private int mWidgetType; // 小部件类型
|
|
|
private boolean mPinned; // 是否置顶
|
|
|
|
|
|
// 通话记录相关
|
|
|
private String mName; // 联系人姓名
|
|
|
private String mPhoneNumber; // 电话号码
|
|
|
|
|
|
// 位置状态标志
|
|
|
private boolean mIsLastItem; // 是否是列表最后一项
|
|
|
private boolean mIsFirstItem; // 是否是列表第一项
|
|
|
private boolean mIsOnlyOneItem; // 是否是唯一一项
|
|
|
private boolean mIsOneNoteFollowingFolder; // 是否是文件夹后的唯一便签
|
|
|
private boolean mIsMultiNotesFollowingFolder; // 是否是文件夹后的多个便签之一
|
|
|
|
|
|
// ======================= 构造函数 =======================
|
|
|
|
|
|
/**
|
|
|
* 构造函数
|
|
|
* 从Cursor解析数据并初始化对象
|
|
|
* 执行流程：
|
|
|
* 1. 从Cursor读取所有字段
|
|
|
* 2. 清理清单标记
|
|
|
* 3. 处理通话记录
|
|
|
* 4. 检查位置状态
|
|
|
*
|
|
|
* @param context 上下文，用于联系人查询
|
|
|
* @param cursor 数据库游标，必须包含PROJECTION指定的字段
|
|
|
*/
|
|
|
public NoteItemData(Context context, Cursor cursor) {
|
|
|
// 1. 读取基本字段
|
|
|
mId = cursor.getLong(ID_COLUMN);
|
|
|
mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
|
|
|
mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
|
|
|
mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
|
|
|
mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false;
|
|
|
mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
|
|
|
mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
|
|
|
mParentId = cursor.getLong(PARENT_ID_COLUMN);
|
|
|
mSnippet = cursor.getString(SNIPPET_COLUMN);
|
|
|
mType = cursor.getInt(TYPE_COLUMN);
|
|
|
mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
|
|
|
mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
|
|
|
mPinned = (cursor.getInt(PINNED_COLUMN) > 0) ? true : false;
|
|
|
|
|
|
// 2. 清理摘要中的清单标记
|
|
|
// 移除已勾选(√)和未勾选(□)标记，只显示纯文本
|
|
|
mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
|
|
|
NoteEditActivity.TAG_UNCHECKED, "");
|
|
|
|
|
|
// 3. 处理通话记录
|
|
|
mPhoneNumber = ""; // 初始化电话号码
|
|
|
if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
|
|
|
// 从通话记录文件夹中获取电话号码
|
|
|
mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
|
|
|
if (!TextUtils.isEmpty(mPhoneNumber)) {
|
|
|
// 根据电话号码查询联系人姓名
|
|
|
mName = Contact.getContact(context, mPhoneNumber);
|
|
|
if (mName == null) {
|
|
|
// 未找到联系人，使用电话号码作为显示名称
|
|
|
mName = mPhoneNumber;
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// 确保名称不为null
|
|
|
if (mName == null) {
|
|
|
mName = "";
|
|
|
}
|
|
|
|
|
|
// 4. 检查位置状态
|
|
|
checkPostion(cursor);
|
|
|
}
|
|
|
|
|
|
// ======================= 位置检查方法 =======================
|
|
|
|
|
|
/**
|
|
|
* 检查便签在列表中的位置状态
|
|
|
* 用于确定列表项应使用的背景样式
|
|
|
* 位置判断逻辑：
|
|
|
* 1. 基本位置：首项、末项、唯一项
|
|
|
* 2. 文件夹后位置：文件夹后的第一个便签、多个便签
|
|
|
*
|
|
|
* @param cursor 数据库游标，用于位置判断
|
|
|
*/
|
|
|
private void checkPostion(Cursor cursor) {
|
|
|
// 1. 基本位置判断
|
|
|
mIsLastItem = cursor.isLast() ? true : false; // 是否是最后一项
|
|
|
mIsFirstItem = cursor.isFirst() ? true : false; // 是否是第一项
|
|
|
mIsOnlyOneItem = (cursor.getCount() == 1); // 是否是唯一一项
|
|
|
|
|
|
// 初始化文件夹后位置标志
|
|
|
mIsMultiNotesFollowingFolder = false;
|
|
|
mIsOneNoteFollowingFolder = false;
|
|
|
|
|
|
// 2. 判断是否是文件夹后的便签
|
|
|
// 条件：当前是便签类型 且 不是第一项
|
|
|
if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
|
|
|
int position = cursor.getPosition(); // 获取当前游标位置
|
|
|
|
|
|
// 向前移动游标检查前一项
|
|
|
if (cursor.moveToPrevious()) {
|
|
|
// 判断前一项是否是文件夹或系统文件夹
|
|
|
if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
|
|
|
|| cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
|
|
|
// 判断后面是否还有更多项
|
|
|
if (cursor.getCount() > (position + 1)) {
|
|
|
// 文件夹后有多个便签
|
|
|
mIsMultiNotesFollowingFolder = true;
|
|
|
} else {
|
|
|
// 文件夹后只有一个便签
|
|
|
mIsOneNoteFollowingFolder = true;
|
|
|
}
|
|
|
}
|
|
|
// 移动回原位置
|
|
|
if (!cursor.moveToNext()) {
|
|
|
throw new IllegalStateException("cursor move to previous but can't move back");
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// ======================= 位置状态获取方法 =======================
|
|
|
|
|
|
/**
|
|
|
* 是否是文件夹后的唯一便签
|
|
|
* 用于选择列表项背景：list_{color}_single
|
|
|
* @return true: 是文件夹后的唯一便签
|
|
|
*/
|
|
|
public boolean isOneFollowingFolder() {
|
|
|
return mIsOneNoteFollowingFolder;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否是文件夹后的多个便签之一
|
|
|
* 用于选择列表项背景：list_{color}_middle
|
|
|
* @return true: 是文件夹后的多个便签之一
|
|
|
*/
|
|
|
public boolean isMultiFollowingFolder() {
|
|
|
return mIsMultiNotesFollowingFolder;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否是列表最后一项
|
|
|
* 用于选择列表项背景：list_{color}_down
|
|
|
* @return true: 是最后一项
|
|
|
*/
|
|
|
public boolean isLast() {
|
|
|
return mIsLastItem;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取通话记录联系人姓名
|
|
|
* 用于通话记录便签的显示
|
|
|
* @return 联系人姓名，无联系人时返回电话号码
|
|
|
*/
|
|
|
public String getCallName() {
|
|
|
return mName;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否是列表第一项
|
|
|
* 用于选择列表项背景：list_{color}_up
|
|
|
* @return true: 是第一项
|
|
|
*/
|
|
|
public boolean isFirst() {
|
|
|
return mIsFirstItem;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否是列表唯一项
|
|
|
* 用于选择列表项背景：list_{color}_single
|
|
|
* @return true: 是唯一项
|
|
|
*/
|
|
|
public boolean isSingle() {
|
|
|
return mIsOnlyOneItem;
|
|
|
}
|
|
|
|
|
|
// ======================= 基本属性获取方法 =======================
|
|
|
|
|
|
/**
|
|
|
* 获取便签ID
|
|
|
* @return 便签ID
|
|
|
*/
|
|
|
public long getId() {
|
|
|
return mId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取提醒时间
|
|
|
* @return 提醒时间戳，0表示无提醒
|
|
|
*/
|
|
|
public long getAlertDate() {
|
|
|
return mAlertDate;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取创建时间
|
|
|
* @return 创建时间戳
|
|
|
*/
|
|
|
public long getCreatedDate() {
|
|
|
return mCreatedDate;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否包含附件
|
|
|
* @return true: 包含附件
|
|
|
*/
|
|
|
public boolean hasAttachment() {
|
|
|
return mHasAttachment;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取修改时间
|
|
|
* @return 修改时间戳
|
|
|
*/
|
|
|
public long getModifiedDate() {
|
|
|
return mModifiedDate;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取背景颜色ID
|
|
|
* @return 背景颜色索引
|
|
|
*/
|
|
|
public int getBgColorId() {
|
|
|
return mBgColorId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取父文件夹ID
|
|
|
* @return 父文件夹ID
|
|
|
*/
|
|
|
public long getParentId() {
|
|
|
return mParentId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取包含的便签数
|
|
|
* 仅对文件夹类型有效
|
|
|
* @return 便签数量
|
|
|
*/
|
|
|
public int getNotesCount() {
|
|
|
return mNotesCount;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取文件夹ID（同getParentId）
|
|
|
* 用于语义化访问
|
|
|
* @return 文件夹ID
|
|
|
*/
|
|
|
public long getFolderId () {
|
|
|
return mParentId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取便签类型
|
|
|
* @return 类型常量：TYPE_NOTE, TYPE_FOLDER, TYPE_SYSTEM
|
|
|
*/
|
|
|
public int getType() {
|
|
|
return mType;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取小部件类型
|
|
|
* @return 小部件类型：TYPE_WIDGET_INVALIDE, TYPE_WIDGET_2X, TYPE_WIDGET_4X
|
|
|
*/
|
|
|
public int getWidgetType() {
|
|
|
return mWidgetType;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取便签是否置顶
|
|
|
* @return true: 置顶, false: 不置顶
|
|
|
*/
|
|
|
public boolean isPinned() {
|
|
|
return mPinned;
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
* 获取小部件ID
|
|
|
* @return 小部件ID
|
|
|
*/
|
|
|
public int getWidgetId() {
|
|
|
return mWidgetId;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取便签摘要
|
|
|
* 已清理清单标记
|
|
|
* @return 便签摘要文本
|
|
|
*/
|
|
|
public String getSnippet() {
|
|
|
return mSnippet;
|
|
|
}
|
|
|
|
|
|
// ======================= 状态判断方法 =======================
|
|
|
|
|
|
/**
|
|
|
* 是否有提醒设置
|
|
|
* @return true: 设置了提醒
|
|
|
*/
|
|
|
public boolean hasAlert() {
|
|
|
return (mAlertDate > 0);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 是否是通话记录
|
|
|
* 判断条件：在通话记录文件夹中 且 有电话号码
|
|
|
* @return true: 是通话记录
|
|
|
*/
|
|
|
public boolean isCallRecord() {
|
|
|
return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
|
|
|
}
|
|
|
|
|
|
// ======================= 静态工具方法 =======================
|
|
|
|
|
|
/**
|
|
|
* 从Cursor获取便签类型
|
|
|
* 静态方法，无需创建对象
|
|
|
* @param cursor 数据库游标
|
|
|
* @return 便签类型
|
|
|
*/
|
|
|
public static int getNoteType(Cursor cursor) {
|
|
|
return cursor.getInt(TYPE_COLUMN);
|
|
|
}
|
|
|
} |
