Compare commits

..

34 Commits

Author SHA1 Message Date
13864042598 04c7485085 Merge branch 'huyunfei'
2 months ago
hyf e4cadc5fa1 胡云飞--ui包
2 months ago
XJS 6e7f066ceb Merge branch 'xingjiasen'
2 months ago
XYJ 7939ce2f52 Merge branch 'xinyajie'
2 months ago
hyf 6e14c3527a Merge branch 'huyunfei'
2 months ago
hyf ec0ea1cced 胡云飞
2 months ago
hyf 69ede62db3 胡云飞
2 months ago
hyf edb24d5740 质量分析报告
2 months ago
13864042598 c9a359ebd9 tool包
2 months ago
hyf 1249eaffd8 ..
2 months ago
hyf 5ad54ad609 泛读报告
2 months ago
XJS bd8d18a546 邢加森 -gtask data包exception包
2 months ago
13864042598 557e9f6072 22
2 months ago
13864042598 6e4861104b 11
2 months ago
HYF 7f87b931f0 文档
2 months ago
HYF c40efe34a5 12.20
2 months ago
HYF 3838db52b6 12.20
2 months ago
13864042598 8b526d7be0 10.17
4 months ago
XJS 1954950b7b 10.17-xingjiasen
4 months ago
HYF f2b3d1d113 10.17-huyunfei
4 months ago
HYF 3875d37f70 10.17-huyunfei
4 months ago
HYF 19ed944802 10.17-huyunfei
4 months ago
HYF 50c175747d 10.17-huyunfei
4 months ago
HYF f719fe087d 10.17-huyunfei
4 months ago
13864042598 c7649f85c5 Merge branch 'main' of https://bdgit.educoder.net/pa2tefyxw/xiaomibianqian
4 months ago
HYF 4a1d1601ff hebingceshi
4 months ago
pa2tefyxw 411868b8c3 Merge pull request '合并测试' (#5) from huyunfei into main
4 months ago
HYF 8a5f5d3c17 10.17-huyunfei
4 months ago
13864042598 7f8e96e4a0 10.17-ceshi
4 months ago
13864042598 db1d3885a1 10.17-huyunfei
4 months ago
XYJ 569b393556 10.17--huyunfei
4 months ago
pa2tefyxw 45433723b2 Update README.md
4 months ago
pa2tefyxw c10b60cb0c Update README.md
4 months ago
hyf 5ce76cc89c 10.16
4 months ago

@ -0,0 +1 @@
main分支

@ -25,7 +25,15 @@ import android.util.Log;
import java.util.HashMap;
<<<<<<< HEAD
//ceshihebing2
public class Contact {
private static HashMap<String, String> sContactCache;
private static final String TAG = "Contact";
=======
// 该类用于获取与给定电话号码对应的联系人姓名,通过缓存已查询结果来提高性能
>>>>>>> xinyajie
public class Contact {
// 该类用于获取与给定电话号码对应的联系人姓名,通过缓存已查询结果来提高性能

@ -14,66 +14,90 @@
* limitations under the License.
*/
package net.micode.notes.gtask.data;
<<<<<<< HEAD
package net.micode.notes.gtask.data;//测试
=======
package net.micode.notes.gtask.data;// 该类所在的包用于组织代码结构可能与gtask数据相关
>>>>>>> xingjiasen
import android.database.Cursor;
import android.util.Log;
import net.micode.notes.tool.GTaskStringUtils;
import net.micode.notes.tool.GTaskStringUtils;// 自定义的工具类用于处理与gtask相关的字符串操作
import org.json.JSONException;
import org.json.JSONObject;
// MetaData类继承自Task类假设Task类是一个基类提供了一些通用的任务相关功能
public class MetaData extends Task {
// 定义一个常量TAG用于在日志记录中标识该类值为类的简单名称
private final static String TAG = MetaData.class.getSimpleName();
// 用于存储相关的gid可能是与gtask相关的唯一标识符
private String mRelatedGid = null;
// 设置元数据的方法接受一个gid字符串和一个JSONObject类型的元数据信息
public void setMeta(String gid, JSONObject metaInfo) {
try {
// 尝试将gid放入元数据信息的指定字段假设GTaskStringUtils.META_HEAD_GTASK_ID是一个常量表示在JSONObject中存储gid的键
metaInfo.put(GTaskStringUtils.META_HEAD_GTASK_ID, gid);
} catch (JSONException e) {
// 如果在放入gid时发生JSON异常记录错误日志提示无法放入相关gid
Log.e(TAG, "failed to put related gid");
}
// 将元数据信息转换为字符串并设置为笔记内容假设Task类中有setNotes方法用于设置笔记内容
setNotes(metaInfo.toString());
// 设置名称为指定的常量假设GTaskStringUtils.META_NOTE_NAME是一个常量表示元数据的名称
setName(GTaskStringUtils.META_NOTE_NAME);
}
// 获取相关gid的方法
public String getRelatedGid() {
return mRelatedGid;
}
// 重写isWorthSaving方法假设该方法在Task类中定义用于判断是否值得保存
// 判断依据是笔记内容是否不为空
@Override
public boolean isWorthSaving() {
return getNotes() != null;
}
// 重写setContentByRemoteJSON方法假设该方法在Task类中定义用于根据远程JSON数据设置内容
@Override
public void setContentByRemoteJSON(JSONObject js) {
// 先调用父类的setContentByRemoteJSON方法
super.setContentByRemoteJSON(js);
if (getNotes() != null) {
try {
// 从笔记内容创建一个新的JSONObject去除首尾空格后
JSONObject metaInfo = new JSONObject(getNotes().trim());
// 从元数据信息中获取相关gid并赋值给mRelatedGid
mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
mRelatedGid = metaInfo.getString(GTaskStringUtils.META_HEAD_GTASK_ID);
} catch (JSONException e) {
// 如果获取相关gid时发生JSON异常记录警告日志提示无法获取相关gid并将mRelatedGid设置为null
Log.w(TAG, "failed to get related gid");
mRelatedGid = null;
}
}
}
// 重写setContentByLocalJSON方法假设该方法在Task类中定义用于根据本地JSON数据设置内容
// 这里明确表示该方法不应该被调用如果被调用则抛出IllegalAccessError异常并给出提示信息
@Override
public void setContentByLocalJSON(JSONObject js) {
// this function should not be called
throw new IllegalAccessError("MetaData:setContentByLocalJSON should not be called");
}
// 重写getLocalJSONFromContent方法假设该方法在Task类中定义用于从内容获取本地JSON数据
// 这里明确表示该方法不应该被调用如果被调用则抛出IllegalAccessError异常并给出提示信息
@Override
public JSONObject getLocalJSONFromContent() {
throw new IllegalAccessError("MetaData:getLocalJSONFromContent should not be called");
}
// 重写getSyncAction方法假设该方法在Task类中定义用于获取同步操作相关信息
// 这里明确表示该方法不应该被调用如果被调用则抛出IllegalAccessError异常并给出提示信息
@Override
public int getSyncAction(Cursor c) {
throw new IllegalAccessError("MetaData:getSyncAction should not be called");

@ -20,7 +20,9 @@ import android.database.Cursor;
import org.json.JSONObject;
// 定义一个抽象类Node可能是用于表示某种数据节点作为其他具体节点类的基类
public abstract class Node {
// 定义一系列常量,表示同步操作的类型
public static final int SYNC_ACTION_NONE = 0;
public static final int SYNC_ACTION_ADD_REMOTE = 1;
@ -39,14 +41,16 @@ public abstract class Node {
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 = "";
@ -54,46 +58,62 @@ public abstract class Node {
mDeleted = false;
}
// 抽象方法用于获取创建操作的JSONObject表示具体实现由子类提供
// 参数actionId可能用于指定创建操作的具体类型或相关参数
public abstract JSONObject getCreateAction(int actionId);
// 抽象方法用于获取更新操作的JSONObject表示具体实现由子类提供
// 参数actionId可能用于指定更新操作的具体类型或相关参数
public abstract JSONObject getUpdateAction(int actionId);
// 抽象方法用于根据远程JSON数据设置节点内容具体实现由子类提供
public abstract void setContentByRemoteJSON(JSONObject js);
// 抽象方法用于根据本地JSON数据设置节点内容具体实现由子类提供
public abstract void setContentByLocalJSON(JSONObject js);
// 抽象方法用于从节点内容获取本地JSON数据具体实现由子类提供
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;
}

@ -35,137 +35,195 @@ import org.json.JSONException;
import org.json.JSONObject;
// SqlData类可能用于处理与SQL数据库相关的数据操作与gtask数据相关
public class SqlData {
// 定义一个常量TAG用于在日志记录中标识该类值为类的简单名称
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_TYPE列的索引
public static final int DATA_MIME_TYPE_COLUMN = 1;
// 定义常量表示在投影列数组中CONTENT列的索引
public static final int DATA_CONTENT_COLUMN = 2;
// 定义常量表示在投影列数组中DATA1列的索引假设是CONTENT相关的数据1列
public static final int DATA_CONTENT_DATA_1_COLUMN = 3;
// 定义常量表示在投影列数组中DATA3列的索引假设是CONTENT相关的数据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;
// 构造函数用于创建一个新的SqlData实例通常用于插入新数据
public SqlData(Context context) {
// 获取上下文的内容解析器,用于与内容提供器交互
mContentResolver = context.getContentResolver();
// 标记为创建操作
mIsCreate = true;
// 初始化数据ID为无效值
mDataId = INVALID_ID;
// 初始化MIME类型为默认值假设DataConstants.NOTE是一个常量表示笔记类型的MIME类型
mDataMimeType = DataConstants.NOTE;
// 初始化数据内容为空字符串
mDataContent = "";
// 初始化数据内容相关的数据1为0
mDataContentData1 = 0;
// 初始化数据内容相关的数据3为空字符串
mDataContentData3 = "";
// 创建一个新的ContentValues实例用于存储要更新的数据
mDiffDataValues = new ContentValues();
}
// 构造函数用于根据数据库游标创建一个SqlData实例通常用于查询现有数据
public SqlData(Context context, Cursor c) {
mContentResolver = context.getContentResolver();
// 标记为非创建操作(即查询或更新现有数据)
mIsCreate = false;
// 从游标加载数据到对象属性中
loadFromCursor(c);
mDiffDataValues = new ContentValues();
}
// 从游标加载数据到对象属性的私有方法
private void loadFromCursor(Cursor c) {
// 从游标获取ID列的值并赋值给mDataId
mDataId = c.getLong(DATA_ID_COLUMN);
// 从游标获取MIME_TYPE列的值并赋值给mDataMimeType
mDataMimeType = c.getString(DATA_MIME_TYPE_COLUMN);
// 从游标获取CONTENT列的值并赋值给mDataContent
mDataContent = c.getString(DATA_CONTENT_COLUMN);
// 从游标获取CONTENT相关的数据1列的值并赋值给mDataContentData1
mDataContentData1 = c.getLong(DATA_CONTENT_DATA_1_COLUMN);
// 从游标获取CONTENT相关的数据3列的值并赋值给mDataContentData3
mDataContentData3 = c.getString(DATA_CONTENT_DATA_3_COLUMN);
}
// 设置数据内容的方法接受一个JSONObject作为参数
public void setContent(JSONObject js) throws JSONException {
// 从JSON对象获取ID值如果不存在则使用无效ID
long dataId = js.has(DataColumns.ID) ? js.getLong(DataColumns.ID) : INVALID_ID;
// 如果是创建操作或者数据ID发生了变化则将新的ID值放入要更新的ContentValues中
if (mIsCreate || mDataId != dataId) {
mDiffDataValues.put(DataColumns.ID, dataId);
}
// 更新数据ID
mDataId = dataId;
// 从JSON对象获取MIME_TYPE值如果不存在则使用默认的MIME类型
String dataMimeType = js.has(DataColumns.MIME_TYPE) ? js.getString(DataColumns.MIME_TYPE)
: DataConstants.NOTE;
// 如果是创建操作或者MIME类型发生了变化则将新的MIME类型放入要更新的ContentValues中
if (mIsCreate || !mDataMimeType.equals(dataMimeType)) {
mDiffDataValues.put(DataColumns.MIME_TYPE, dataMimeType);
}
// 更新MIME类型
mDataMimeType = dataMimeType;
// 从JSON对象获取CONTENT值如果不存在则使用空字符串
String dataContent = js.has(DataColumns.CONTENT) ? js.getString(DataColumns.CONTENT) : "";
// 如果是创建操作或者数据内容发生了变化则将新的内容放入要更新的ContentValues中
if (mIsCreate || !mDataContent.equals(dataContent)) {
mDiffDataValues.put(DataColumns.CONTENT, dataContent);
}
// 更新数据内容
mDataContent = dataContent;
// 从JSON对象获取CONTENT相关的数据1值如果不存在则使用0
long dataContentData1 = js.has(DataColumns.DATA1) ? js.getLong(DataColumns.DATA1) : 0;
// 如果是创建操作或者数据内容相关的数据1发生了变化则将新的值放入要更新的ContentValues中
if (mIsCreate || mDataContentData1 != dataContentData1) {
mDiffDataValues.put(DataColumns.DATA1, dataContentData1);
}
// 更新数据内容相关的数据1
mDataContentData1 = dataContentData1;
// 从JSON对象获取CONTENT相关的数据3值如果不存在则使用空字符串
String dataContentData3 = js.has(DataColumns.DATA3) ? js.getString(DataColumns.DATA3) : "";
// 如果是创建操作或者数据内容相关的数据3发生了变化则将新的值放入要更新的ContentValues中
if (mIsCreate || !mDataContentData3.equals(dataContentData3)) {
mDiffDataValues.put(DataColumns.DATA3, dataContentData3);
}
// 更新数据内容相关的数据3
mDataContentData3 = dataContentData3;
}
// 获取数据内容的方法返回一个JSONObject
public JSONObject getContent() throws JSONException {
// 如果是创建操作记录错误日志并返回null因为数据还未在数据库中创建
if (mIsCreate) {
Log.e(TAG, "it seems that we haven't created this in database yet");
return null;
}
// 创建一个新的JSONObject
JSONObject js = new JSONObject();
// 将数据ID放入JSON对象
js.put(DataColumns.ID, mDataId);
// 将MIME类型放入JSON对象
js.put(DataColumns.MIME_TYPE, mDataMimeType);
// 将数据内容放入JSON对象
js.put(DataColumns.CONTENT, mDataContent);
// 将数据内容相关的数据1放入JSON对象
js.put(DataColumns.DATA1, mDataContentData1);
// 将数据内容相关的数据3放入JSON对象
js.put(DataColumns.DATA3, mDataContentData3);
return js;
}
// 提交数据到数据库的方法接受笔记ID、是否验证版本和版本号作为参数
public void commit(long noteId, boolean validateVersion, long version) {
// 如果是创建操作
if (mIsCreate) {
// 如果数据ID为无效值且要更新的ContentValues中包含ID列则移除ID列可能是因为插入操作不需要手动指定ID
if (mDataId == INVALID_ID && mDiffDataValues.containsKey(DataColumns.ID)) {
mDiffDataValues.remove(DataColumns.ID);
}
// 将笔记ID放入要更新的ContentValues中
mDiffDataValues.put(DataColumns.NOTE_ID, noteId);
// 使用内容解析器插入数据到指定的URI假设Notes.CONTENT_DATA_URI是一个常量表示数据插入的URI
Uri uri = mContentResolver.insert(Notes.CONTENT_DATA_URI, mDiffDataValues);
try {
// 尝试从插入后的URI路径片段中获取插入数据的ID并赋值给mDataId
mDataId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
// 如果获取ID时发生数字格式异常记录错误日志并抛出ActionFailureException异常表示创建笔记失败
Log.e(TAG, "Get note id error :" + e.toString());
throw new ActionFailureException("create note failed");
}
} else {
// 如果要更新的数据值不为空
if (mDiffDataValues.size() > 0) {
int result = 0;
// 如果不验证版本
if (!validateVersion) {
// 使用内容解析器更新指定ID的数据不进行版本验证
result = mContentResolver.update(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues, null, null);
} else {
// 使用内容解析器更新指定ID的数据并根据版本号进行验证假设NoteColumns.VERSION是一个常量表示版本列
result = mContentResolver.update(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mDataId), mDiffDataValues,
" ? in (SELECT " + NoteColumns.ID + " FROM " + TABLE.NOTE
@ -173,16 +231,19 @@ public class SqlData {
String.valueOf(noteId), String.valueOf(version)
});
}
// 如果更新结果为0表示没有进行更新记录警告日志可能是因为用户在同步时更新了笔记
if (result == 0) {
Log.w(TAG, "there is no update. maybe user updates note when syncing");
}
}
}
// 清空要更新的数据值
mDiffDataValues.clear();
// 标记为非创建操作
mIsCreate = false;
}
// 获取数据ID的方法
public long getId() {
return mDataId;
}

@ -37,12 +37,13 @@ import org.json.JSONObject;
import java.util.ArrayList;
// SqlNote类可能用于处理与SQL数据库中笔记相关的数据操作与gtask数据相关
public class SqlNote {
// 定义一个常量TAG用于在日志记录中标识该类值为类的简单名称
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,
@ -51,83 +52,86 @@ public class SqlNote {
NoteColumns.LOCAL_MODIFIED, NoteColumns.ORIGIN_PARENT_ID, NoteColumns.GTASK_ID,
NoteColumns.VERSION
};
// 定义常量表示在投影列数组中ID列的索引
public static final int ID_COLUMN = 0;
// 定义常量表示在投影列数组中ALERTED_DATE列的索引
public static final int ALERTED_DATE_COLUMN = 1;
// 定义常量表示在投影列数组中BG_COLOR_ID列的索引
public static final int BG_COLOR_ID_COLUMN = 2;
// 定义常量表示在投影列数组中CREATED_DATE列的索引
public static final int CREATED_DATE_COLUMN = 3;
// 定义常量表示在投影列数组中HAS_ATTACHMENT列的索引
public static final int HAS_ATTACHMENT_COLUMN = 4;
// 定义常量表示在投影列数组中MODIFIED_DATE列的索引
public static final int MODIFIED_DATE_COLUMN = 5;
// 定义常量表示在投影列数组中NOTES_COUNT列的索引
public static final int NOTES_COUNT_COLUMN = 6;
// 定义常量表示在投影列数组中PARENT_ID列的索引
public static final int PARENT_ID_COLUMN = 7;
// 定义常量表示在投影列数组中SNIPPET列的索引
public static final int SNIPPET_COLUMN = 8;
// 定义常量表示在投影列数组中TYPE列的索引
public static final int TYPE_COLUMN = 9;
// 定义常量表示在投影列数组中WIDGET_ID列的索引
public static final int WIDGET_ID_COLUMN = 10;
// 定义常量表示在投影列数组中WIDGET_TYPE列的索引
public static final int WIDGET_TYPE_COLUMN = 11;
// 定义常量表示在投影列数组中SYNC_ID列的索引
public static final int SYNC_ID_COLUMN = 12;
// 定义常量表示在投影列数组中LOCAL_MODIFIED列的索引
public static final int LOCAL_MODIFIED_COLUMN = 13;
// 定义常量表示在投影列数组中ORIGIN_PARENT_ID列的索引
public static final int ORIGIN_PARENT_ID_COLUMN = 14;
// 定义常量表示在投影列数组中GTASK_ID列的索引
public static final int GTASK_ID_COLUMN = 15;
// 定义常量表示在投影列数组中VERSION列的索引
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;
// 存储笔记是否有附件0或1表示
private int mHasAttachment;
// 存储笔记的修改日期
private long mModifiedDate;
// 存储笔记的父ID
private long mParentId;
// 存储笔记的摘要或片段内容
private String mSnippet;
// 存储笔记的类型如普通笔记、文件夹等类型假设Notes.TYPE_NOTE等是常量表示不同类型
private int mType;
// 存储笔记关联的小部件ID
private int mWidgetId;
// 存储笔记关联的小部件类型
private int mWidgetType;
// 存储笔记的原始父ID可能用于记录笔记的来源或初始父节点
private long mOriginParent;
// 存储笔记的版本号
private long mVersion;
// 用于存储要更新的笔记数据值
private ContentValues mDiffNoteValues;
// 存储与笔记相关的数据列表可能是笔记包含的数据内容每个元素是SqlData类型
private ArrayList<SqlData> mDataList;
// 构造函数用于创建一个新的SqlNote实例通常用于插入新笔记
public SqlNote(Context context) {
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = true;
mId = INVALID_ID;
mAlertDate = 0;
// 使用ResourceParser获取默认的背景颜色ID假设ResourceParser类提供了相关方法
mBgColorId = ResourceParser.getDefaultBgId(context);
mCreatedDate = System.currentTimeMillis();
mHasAttachment = 0;
@ -135,6 +139,7 @@ public class SqlNote {
mParentId = 0;
mSnippet = "";
mType = Notes.TYPE_NOTE;
// 使用无效的小部件ID初始化假设AppWidgetManager.INVALID_APPWIDGET_ID是一个常量表示无效ID
mWidgetId = AppWidgetManager.INVALID_APPWIDGET_ID;
mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
mOriginParent = 0;
@ -143,17 +148,20 @@ public class SqlNote {
mDataList = new ArrayList<SqlData>();
}
// 构造函数用于根据数据库游标创建一个SqlNote实例通常用于查询现有笔记
public SqlNote(Context context, Cursor c) {
mContext = context;
mContentResolver = context.getContentResolver();
mIsCreate = false;
loadFromCursor(c);
mDataList = new ArrayList<SqlData>();
// 如果笔记类型是普通笔记则加载数据内容调用loadDataContent方法
if (mType == Notes.TYPE_NOTE)
loadDataContent();
mDiffNoteValues = new ContentValues();
}
// 构造函数用于根据指定的ID从数据库加载笔记数据创建一个SqlNote实例
public SqlNote(Context context, long id) {
mContext = context;
mContentResolver = context.getContentResolver();
@ -166,15 +174,18 @@ public class SqlNote {
}
// 从指定ID的游标加载笔记数据的私有方法
private void loadFromCursor(long id) {
Cursor c = null;
try {
// 使用内容解析器查询指定ID的笔记数据投影列为PROJECTION_NOTE查询条件为_id等于指定ID
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");
@ -185,6 +196,7 @@ public class SqlNote {
}
}
// 从游标加载笔记数据到对象属性的私有方法
private void loadFromCursor(Cursor c) {
mId = c.getLong(ID_COLUMN);
mAlertDate = c.getLong(ALERTED_DATE_COLUMN);
@ -200,10 +212,12 @@ public class SqlNote {
mVersion = c.getLong(VERSION_COLUMN);
}
// 加载笔记数据内容的私有方法将与笔记相关的数据加载到mDataList中
private void loadDataContent() {
Cursor c = null;
mDataList.clear();
try {
// 使用内容解析器查询与笔记相关的数据投影列为SqlData.PROJECTION_DATA查询条件为note_id等于笔记ID
c = mContentResolver.query(Notes.CONTENT_DATA_URI, SqlData.PROJECTION_DATA,
"(note_id=?)", new String[] {
String.valueOf(mId)
@ -214,6 +228,7 @@ public class SqlNote {
return;
}
while (c.moveToNext()) {
// 根据游标创建SqlData实例并添加到数据列表中
SqlData data = new SqlData(mContext, c);
mDataList.add(data);
}
@ -226,13 +241,16 @@ public class SqlNote {
}
}
// 设置笔记内容的方法接受一个JSONObject作为参数
public boolean setContent(JSONObject js) {
try {
// 从JSON对象获取笔记头部信息假设GTaskStringUtils.META_HEAD_NOTE是一个常量表示笔记头部信息的键
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)) {
@ -247,6 +265,7 @@ public class SqlNote {
}
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) {

@ -31,20 +31,22 @@ import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
// Task类继承自Node类可能用于表示任务相关的数据结构与gtask数据相关
public class Task extends Node {
// 定义一个常量TAG用于在日志记录中标识该类值为类的简单名称
private static final String TAG = Task.class.getSimpleName();
// 标记任务是否已完成
private boolean mCompleted;
// 存储任务的笔记内容
private String mNotes;
// 存储任务的元数据信息可能是与任务相关的额外信息以JSONObject形式存储
private JSONObject mMetaInfo;
// 存储任务的前一个兄弟任务(用于构建任务列表的顺序关系)
private Task mPriorSibling;
// 存储任务所属的父任务列表(表示任务的层级关系)
private TaskList mParent;
// 构造函数,初始化任务对象的属性
public Task() {
super();
mCompleted = false;
@ -54,47 +56,54 @@ public class Task extends Node {
mMetaInfo = null;
}
// 生成创建任务的JSON对象的方法用于与外部系统可能是gtask服务端交互指定创建任务的相关信息
public JSONObject getCreateAction(int actionId) {
JSONObject js = new JSONObject();
try {
// action_type
// 设置操作类型为创建任务假设GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE是一个常量表示创建操作类型
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
// 创建任务实体的JSON对象
JSONObject entity = new JSONObject();
// 设置任务名称
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置任务创建者ID为null可能在实际应用中需要根据真实情况设置
entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
// 设置任务实体类型为任务假设GTaskStringUtils.GTASK_JSON_TYPE_TASK是一个常量表示任务类型
entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_TASK);
// 如果有笔记内容,则添加到任务实体中
if (getNotes() != null) {
entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
}
// 将任务实体添加到操作JSON对象中
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
// parent_id
// 设置父任务ID通过父任务列表获取
js.put(GTaskStringUtils.GTASK_JSON_PARENT_ID, mParent.getGid());
// dest_parent_type
// 设置目标父类型为组假设GTaskStringUtils.GTASK_JSON_TYPE_GROUP是一个常量表示组类型
js.put(GTaskStringUtils.GTASK_JSON_DEST_PARENT_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
// list_id
// 设置列表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());
}
} catch (JSONException e) {
// 如果在创建JSON对象过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示生成创建任务的JSON对象失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate task-create jsonobject");
@ -103,30 +112,36 @@ public class Task extends Node {
return js;
}
// 生成更新任务的JSON对象的方法用于与外部系统可能是gtask服务端交互指定更新任务的相关信息
public JSONObject getUpdateAction(int actionId) {
JSONObject js = new JSONObject();
try {
// action_type
// 设置操作类型为更新任务假设GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE是一个常量表示更新操作类型
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
// 创建任务实体的JSON对象
JSONObject entity = new JSONObject();
// 设置任务名称
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 如果有笔记内容,则添加到任务实体中
if (getNotes() != null) {
entity.put(GTaskStringUtils.GTASK_JSON_NOTES, getNotes());
}
// 设置任务的删除标记
entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
// 将任务实体添加到操作JSON对象中
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在创建JSON对象过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示生成更新任务的JSON对象失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate task-update jsonobject");
@ -134,40 +149,41 @@ public class Task extends Node {
return js;
}
// 根据远程JSON数据设置任务内容的方法从远程获取的JSON数据中解析并设置任务的各种属性
public void setContentByRemoteJSON(JSONObject js) {
if (js != null) {
try {
// id
// 如果JSON对象中包含任务ID则设置任务ID
if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
}
// last_modified
// 如果JSON对象中包含最后修改时间则设置最后修改时间
if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
}
// name
// 如果JSON对象中包含任务名称则设置任务名称
if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
}
// notes
// 如果JSON对象中包含笔记内容则设置笔记内容
if (js.has(GTaskStringUtils.GTASK_JSON_NOTES)) {
setNotes(js.getString(GTaskStringUtils.GTASK_JSON_NOTES));
}
// deleted
// 如果JSON对象中包含删除标记则设置删除标记
if (js.has(GTaskStringUtils.GTASK_JSON_DELETED)) {
setDeleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_DELETED));
}
// completed
// 如果JSON对象中包含完成标记则设置完成标记
if (js.has(GTaskStringUtils.GTASK_JSON_COMPLETED)) {
setCompleted(js.getBoolean(GTaskStringUtils.GTASK_JSON_COMPLETED));
}
} catch (JSONException e) {
// 如果在解析JSON数据过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示从JSON对象获取任务内容失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to get task content from jsonobject");
@ -175,6 +191,7 @@ public class Task extends Node {
}
}
// 根据本地JSON数据设置任务内容的方法从本地存储的JSON数据中解析并设置任务的名称根据特定的结构和条件
public void setContentByLocalJSON(JSONObject js) {
if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)
|| !js.has(GTaskStringUtils.META_HEAD_DATA)) {
@ -204,11 +221,12 @@ public class Task extends Node {
}
}
// 从任务内容生成本地JSON对象的方法根据任务的当前状态是否有元数据等构建用于本地存储或传输的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 +243,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,6 +265,7 @@ public class Task extends Node {
}
}
// 设置任务元数据信息的方法接受一个MetaData对象从其中获取笔记内容并尝试转换为JSONObject作为元数据
public void setMetaInfo(MetaData metaData) {
if (metaData != null && metaData.getNotes() != null) {
try {
@ -258,6 +277,7 @@ public class Task extends Node {
}
}
// 根据数据库游标获取任务的同步操作类型的方法通过比较任务的各种属性如元数据中的笔记ID、本地修改标记、gtask ID等与数据库中的数据来确定同步操作类型
public int getSyncAction(Cursor c) {
try {
JSONObject noteInfo = null;
@ -275,29 +295,29 @@ public class Task extends Node {
return SYNC_ACTION_UPDATE_LOCAL;
}
// validate the note id now
// 验证笔记ID是否匹配
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
// 验证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;
@ -311,39 +331,48 @@ public class Task extends Node {
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;
}

@ -29,43 +29,51 @@ import org.json.JSONObject;
import java.util.ArrayList;
// TaskList类继承自Node类可能用于表示任务列表相关的数据结构与gtask数据相关
public class TaskList extends Node {
// 定义一个常量TAG用于在日志记录中标识该类值为类的简单名称
private static final String TAG = TaskList.class.getSimpleName();
// 存储任务列表的索引(可能用于在某个父级结构中的排序或标识)
private int mIndex;
// 存储任务列表中的任务集合使用ArrayList存储任务对象
private ArrayList<Task> mChildren;
// 构造函数,初始化任务列表对象的属性
public TaskList() {
super();
mChildren = new ArrayList<Task>();
mIndex = 1;
}
// 生成创建任务列表的JSON对象的方法用于与外部系统可能是gtask服务端交互指定创建任务列表的相关信息
public JSONObject getCreateAction(int actionId) {
JSONObject js = new JSONObject();
try {
// action_type
// 设置操作类型为创建任务列表假设GTaskStringUtils.GTASK_JSON_ACTION_TYPE_CREATE是一个常量表示创建操作类型
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
// 创建任务列表实体的JSON对象
JSONObject entity = new JSONObject();
// 设置任务列表名称
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置任务列表创建者ID为null可能在实际应用中需要根据真实情况设置
entity.put(GTaskStringUtils.GTASK_JSON_CREATOR_ID, "null");
// 设置任务列表实体类型为组假设GTaskStringUtils.GTASK_JSON_TYPE_GROUP是一个常量表示组类型
entity.put(GTaskStringUtils.GTASK_JSON_ENTITY_TYPE,
GTaskStringUtils.GTASK_JSON_TYPE_GROUP);
// 将任务列表实体添加到操作JSON对象中
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在创建JSON对象过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示生成创建任务列表的JSON对象失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate tasklist-create jsonobject");
@ -74,27 +82,32 @@ public class TaskList extends Node {
return js;
}
// 生成更新任务列表的JSON对象的方法用于与外部系统可能是gtask服务端交互指定更新任务列表的相关信息
public JSONObject getUpdateAction(int actionId) {
JSONObject js = new JSONObject();
try {
// action_type
// 设置操作类型为更新任务列表假设GTaskStringUtils.GTASK_JSON_ACTION_TYPE_UPDATE是一个常量表示更新操作类型
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
// 创建任务列表实体的JSON对象
JSONObject entity = new JSONObject();
// 设置任务列表名称
entity.put(GTaskStringUtils.GTASK_JSON_NAME, getName());
// 设置任务列表的删除标记
entity.put(GTaskStringUtils.GTASK_JSON_DELETED, getDeleted());
// 将任务列表实体添加到操作JSON对象中
js.put(GTaskStringUtils.GTASK_JSON_ENTITY_DELTA, entity);
} catch (JSONException e) {
// 如果在创建JSON对象过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示生成更新任务列表的JSON对象失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to generate tasklist-update jsonobject");
@ -103,25 +116,27 @@ public class TaskList extends Node {
return js;
}
// 根据远程JSON数据设置任务列表内容的方法从远程获取的JSON数据中解析并设置任务列表的各种属性如ID、最后修改时间、名称
public void setContentByRemoteJSON(JSONObject js) {
if (js != null) {
try {
// id
// 如果JSON对象中包含任务列表ID则设置任务列表ID
if (js.has(GTaskStringUtils.GTASK_JSON_ID)) {
setGid(js.getString(GTaskStringUtils.GTASK_JSON_ID));
}
// last_modified
// 如果JSON对象中包含最后修改时间则设置最后修改时间
if (js.has(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED)) {
setLastModified(js.getLong(GTaskStringUtils.GTASK_JSON_LAST_MODIFIED));
}
// name
// 如果JSON对象中包含任务列表名称则设置任务列表名称
if (js.has(GTaskStringUtils.GTASK_JSON_NAME)) {
setName(js.getString(GTaskStringUtils.GTASK_JSON_NAME));
}
} catch (JSONException e) {
// 如果在解析JSON数据过程中发生异常记录错误日志打印堆栈跟踪并抛出ActionFailureException异常表示从JSON对象获取任务列表内容失败
Log.e(TAG, e.toString());
e.printStackTrace();
throw new ActionFailureException("fail to get tasklist content from jsonobject");
@ -129,6 +144,7 @@ public class TaskList extends Node {
}
}
// 根据本地JSON数据设置任务列表内容的方法从本地存储的JSON数据中解析并设置任务列表的名称根据特定的结构和条件区分文件夹类型和系统类型
public void setContentByLocalJSON(JSONObject js) {
if (js == null || !js.has(GTaskStringUtils.META_HEAD_NOTE)) {
Log.w(TAG, "setContentByLocalJSON: nothing is avaiable");
@ -157,6 +173,7 @@ public class TaskList extends Node {
}
}
// 从任务列表内容生成本地JSON对象的方法根据任务列表的当前状态构建用于本地存储或传输的JSON对象包含任务列表名称、类型等信息
public JSONObject getLocalJSONFromContent() {
try {
JSONObject js = new JSONObject();
@ -183,28 +200,29 @@ public class TaskList extends Node {
}
}
// 从任务列表内容生成本地JSON对象的方法根据任务列表的当前状态构建用于本地存储或传输的JSON对象包含任务列表名称、类型等信息
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 +234,18 @@ public class TaskList extends Node {
return SYNC_ACTION_ERROR;
}
// 获取任务列表中任务数量的方法
public int getChildTaskCount() {
return mChildren.size();
}
// 向任务列表中添加任务的方法,将任务添加到任务列表末尾,并设置任务的前一个兄弟任务和父任务列表
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,6 +254,7 @@ public class TaskList extends Node {
return ret;
}
// 向任务列表中指定位置添加任务的方法,根据指定索引将任务插入到任务列表中,并更新任务列表中任务的前一个兄弟任务关系
public boolean addChildTask(Task task, int index) {
if (index < 0 || index > mChildren.size()) {
Log.e(TAG, "add child task: invalid index");
@ -244,7 +265,7 @@ public class TaskList extends Node {
if (task != null && pos == -1) {
mChildren.add(index, task);
// update the task list
// 更新任务列表
Task preTask = null;
Task afterTask = null;
if (index != 0)
@ -260,6 +281,7 @@ public class TaskList extends Node {
return true;
}
// 从任务列表中移除任务的方法,从任务列表中移除指定任务,并重置任务的前一个兄弟任务和父任务关系,同时更新任务列表中任务的前一个兄弟任务关系
public boolean removeChildTask(Task task) {
boolean ret = false;
int index = mChildren.indexOf(task);
@ -267,11 +289,11 @@ public class TaskList extends Node {
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));
@ -281,6 +303,7 @@ public class TaskList extends Node {
return ret;
}
// 在任务列表中移动任务到指定位置的方法,先移除任务再添加到指定位置,实现任务在任务列表中的移动
public boolean moveChildTask(Task task, int index) {
if (index < 0 || index >= mChildren.size()) {
@ -299,6 +322,7 @@ public class TaskList extends Node {
return (removeChildTask(task) && addChildTask(task, index));
}
// 根据任务ID查找任务列表中的任务的方法遍历任务列表查找并返回具有指定ID的任务如果未找到则返回null
public Task findChildTaskByGid(String gid) {
for (int i = 0; i < mChildren.size(); i++) {
Task t = mChildren.get(i);
@ -309,10 +333,12 @@ public class TaskList extends Node {
return null;
}
// 获取任务在任务列表中的索引的方法,返回任务在任务列表中的位置索引,如果任务不在列表中则返回 -1
public int getChildTaskIndex(Task task) {
return mChildren.indexOf(task);
}
// 根据索引获取任务列表中的任务的方法根据指定索引返回任务列表中的任务如果索引无效则记录错误日志并返回null
public Task getChildTaskByIndex(int index) {
if (index < 0 || index >= mChildren.size()) {
Log.e(TAG, "getTaskByIndex: invalid index");
@ -321,6 +347,7 @@ public class TaskList extends Node {
return mChildren.get(index);
}
// 根据任务ID获取任务列表中的任务的方法与findChildTaskByGid方法功能类似可能是为了提供不同的查找方式
public Task getChilTaskByGid(String gid) {
for (Task task : mChildren) {
if (task.getGid().equals(gid))
@ -328,15 +355,17 @@ public class TaskList extends Node {
}
return null;
}
// 获取任务列表中所有任务的列表的方法
public ArrayList<Task> getChildTaskList() {
return this.mChildren;
}
// 设置任务列表索引的方法
public void setIndex(int index) {
this.mIndex = index;
}
// 获取任务列表索引的方法
public int getIndex() {
return this.mIndex;
}

@ -15,18 +15,22 @@
*/
package net.micode.notes.gtask.exception;
// 定义一个名为ActionFailureException的异常类它继承自RuntimeException表示运行时异常
public class ActionFailureException extends RuntimeException {
// serialVersionUID用于在序列化和反序列化过程中验证类的版本一致性
private static final long serialVersionUID = 4425249765923293627L;
// 无参构造函数调用父类RuntimeException的无参构造函数
public ActionFailureException() {
super();
}
// 带字符串参数的构造函数,将传入的字符串作为异常信息传递给父类构造函数
public ActionFailureException(String paramString) {
super(paramString);
}
// 带字符串和Throwable参数的构造函数将传入的字符串作为异常信息Throwable作为异常原因传递给父类构造函数
public ActionFailureException(String paramString, Throwable paramThrowable) {
super(paramString, paramThrowable);
}

@ -16,17 +16,22 @@
package net.micode.notes.gtask.exception;
// 定义一个名为NetworkFailureException的异常类它继承自Exception表示这是一个需要被检查处理的异常
public class NetworkFailureException extends Exception {
// serialVersionUID用于在序列化和反序列化过程中验证类的版本一致性
private static final long serialVersionUID = 2107610287180234136L;
// 无参构造函数调用父类Exception的无参构造函数
public NetworkFailureException() {
super();
}
// 带字符串参数的构造函数,将传入的字符串作为异常信息传递给父类构造函数
public NetworkFailureException(String paramString) {
super(paramString);
}
// 带字符串和Throwable参数的构造函数将传入的字符串作为异常信息Throwable作为异常原因传递给父类构造函数
public NetworkFailureException(String paramString, Throwable paramThrowable) {
super(paramString, paramThrowable);
}

@ -33,73 +33,121 @@ import net.micode.notes.data.Notes.TextNote;
import java.util.ArrayList;
// 定义 Note 类,用于管理笔记相关的数据和操作
public class 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 对象来存储笔记的初始信息
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);
// 将笔记信息插入到内容提供者的 URI 中
Uri uri = context.getContentResolver().insert(Notes.CONTENT_NOTE_URI, values);
long noteId = 0;
try {
// 从 URI 中提取笔记 ID通常 URI 包含笔记的路径信息,路径中的一部分是笔记 ID
noteId = Long.valueOf(uri.getPathSegments().get(1));
} catch (NumberFormatException e) {
// 若出现异常,打印错误日志并将笔记 ID 设为 0
Log.e(TAG, "Get note id error :" + e.toString());
noteId = 0;
}
if (noteId == -1) {
// 若笔记 ID 为 -1抛出异常
throw new IllegalStateException("Wrong note id:" + noteId);
}
return noteId;
}
// 构造函数,初始化笔记的数据存储和变更存储
public Note() {
mNoteDiffValues = new ContentValues();
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());
}
/**
*
* @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 true false
*/
public boolean isLocalModified() {
return mNoteDiffValues.size() > 0 || mNoteData.isLocalModified();
}
/**
*
* @param context
* @param noteId ID
* @return true false
*/
public boolean syncNote(Context context, long noteId) {
if (noteId <= 0) {
throw new IllegalArgumentException("Wrong note id:" + noteId);
@ -110,15 +158,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
* LOCAL_MODIFIED 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();
@ -129,7 +176,7 @@ public class Note {
return true;
}
// 内部类 NoteData用于存储笔记的数据
private class NoteData {
private long mTextDataId;
@ -140,44 +187,67 @@ public class Note {
private ContentValues mCallDataValues;
private static final String TAG = "NoteData";
// 构造函数,初始化数据存储
public NoteData() {
mTextDataValues = new ContentValues();
mCallDataValues = new ContentValues();
mTextDataId = 0;
mCallDataId = 0;
}
/**
*
* @return true false
*/
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");
}
mTextDataId = id;
}
/**
* ID
* @param id ID
*/
void setCallDataId(long id) {
if (id <= 0) {
throw new IllegalArgumentException("Call data id should larger than 0");
}
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());
}
/**
*
* @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());
}
/**
*
* @param context
* @param noteId ID
* @return URI null
*/
Uri pushIntoContentResolver(Context context, long noteId) {
/**
* Check for safety
@ -193,9 +263,11 @@ public class Note {
mTextDataValues.put(DataColumns.NOTE_ID, noteId);
if (mTextDataId == 0) {
mTextDataValues.put(DataColumns.MIME_TYPE, TextNote.CONTENT_ITEM_TYPE);
// 插入新的文本数据
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mTextDataValues);
try {
// 从 URI 中提取新插入的文本数据的 ID
setTextDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
Log.e(TAG, "Insert new text data fail with noteId" + noteId);
@ -203,6 +275,7 @@ public class Note {
return null;
}
} else {
// 更新已有的文本数据
builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mTextDataId));
builder.withValues(mTextDataValues);
@ -215,9 +288,11 @@ public class Note {
mCallDataValues.put(DataColumns.NOTE_ID, noteId);
if (mCallDataId == 0) {
mCallDataValues.put(DataColumns.MIME_TYPE, CallNote.CONTENT_ITEM_TYPE);
// 插入新的通话数据
Uri uri = context.getContentResolver().insert(Notes.CONTENT_DATA_URI,
mCallDataValues);
try {
// 从 URI 中提取新插入的通话数据的 ID
setCallDataId(Long.valueOf(uri.getPathSegments().get(1)));
} catch (NumberFormatException e) {
Log.e(TAG, "Insert new call data fail with noteId" + noteId);
@ -225,6 +300,7 @@ public class Note {
return null;
}
} else {
// 更新已有的通话数据
builder = ContentProviderOperation.newUpdate(ContentUris.withAppendedId(
Notes.CONTENT_DATA_URI, mCallDataId));
builder.withValues(mCallDataValues);
@ -235,6 +311,7 @@ public class Note {
if (operationList.size() > 0) {
try {
// 执行批量操作
ContentProviderResult[] results = context.getContentResolver().applyBatch(
Notes.AUTHORITY, operationList);
return (results == null || results.length == 0 || results[0] == null) ? null

@ -31,37 +31,37 @@ 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 mModifiedDate;
// 背景颜色 ID
private int mBgColorId;
// 小部件的 ID
private int mWidgetId;
// 小部件的类型
private int mWidgetType;
// 笔记所在的文件夹 ID
private long mFolderId;
// 上下文对象
private Context mContext;
// 日志标记
private static final String TAG = "WorkingNote";
// 笔记是否已删除
private boolean mIsDeleted;
// 笔记设置变更监听器
private NoteSettingChangedListener mNoteSettingStatusListener;
// 数据投影,用于查询笔记数据时指定要查询的列
public static final String[] DATA_PROJECTION = new String[] {
DataColumns.ID,
DataColumns.CONTENT,
@ -71,7 +71,7 @@ public class WorkingNote {
DataColumns.DATA3,
DataColumns.DATA4,
};
// 笔记投影,用于查询笔记时指定要查询的列
public static final String[] NOTE_PROJECTION = new String[] {
NoteColumns.PARENT_ID,
NoteColumns.ALERTED_DATE,
@ -80,7 +80,7 @@ public class WorkingNote {
NoteColumns.WIDGET_TYPE,
NoteColumns.MODIFIED_DATE
};
// 数据投影中各列的索引
private static final int DATA_ID_COLUMN = 0;
private static final int DATA_CONTENT_COLUMN = 1;
@ -88,7 +88,7 @@ public class WorkingNote {
private static final int DATA_MIME_TYPE_COLUMN = 2;
private static final int DATA_MODE_COLUMN = 3;
// 笔记投影中各列的索引
private static final int NOTE_PARENT_ID_COLUMN = 0;
private static final int NOTE_ALERTED_DATE_COLUMN = 1;
@ -101,20 +101,22 @@ public class WorkingNote {
private static final int NOTE_MODIFIED_DATE_COLUMN = 5;
// New note construct
// 创建新笔记的构造函数
private WorkingNote(Context context, long folderId) {
mContext = context;
mAlertDate = 0;
//初始化修改日期为当前系统时间
mModifiedDate = System.currentTimeMillis();
mFolderId = folderId;
mNote = new Note();
mNoteId = 0;
// 标记笔记未删除
mIsDeleted = false;
mMode = 0;
mWidgetType = Notes.TYPE_WIDGET_INVALIDE;
}
// Existing note construct
// 加载现有笔记的构造函数
private WorkingNote(Context context, long noteId, long folderId) {
mContext = context;
mNoteId = noteId;
@ -123,18 +125,25 @@ public class WorkingNote {
mNote = new Note();
loadNote();
}
// 加载笔记的方法,从数据库中查询笔记的基本信息
private void loadNote() {
// 1. 通过 ContentResolver 查询笔记信息,使用 NOTE_PROJECTION 投影指定要查询的列
Cursor cursor = mContext.getContentResolver().query(
ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, mNoteId), NOTE_PROJECTION, null,
null, null);
if (cursor != null) {
// 2. 将游标移动到第一个结果
if (cursor.moveToFirst()) {
// 3. 从游标中读取并存储父文件夹 ID
mFolderId = cursor.getLong(NOTE_PARENT_ID_COLUMN);
// 4. 从游标中读取并存储背景颜色 ID
mBgColorId = cursor.getInt(NOTE_BG_COLOR_ID_COLUMN);
// 5. 从游标中读取并存储小部件 ID
mWidgetId = cursor.getInt(NOTE_WIDGET_ID_COLUMN);
// 6. 从游标中读取并存储小部件类型
mWidgetType = cursor.getInt(NOTE_WIDGET_TYPE_COLUMN);
// 7. 从游标中读取并存储提醒日期
mAlertDate = cursor.getLong(NOTE_ALERTED_DATE_COLUMN);
mModifiedDate = cursor.getLong(NOTE_MODIFIED_DATE_COLUMN);
}
@ -145,24 +154,30 @@ public class WorkingNote {
}
loadNoteData();
}
// 加载笔记的数据,从数据库中查询笔记的数据信息
private void loadNoteData() {
// 1. 通过 ContentResolver 查询笔记数据,使用 DATA_PROJECTION 投影指定要查询的列,并通过 NOTE_ID 筛选
Cursor cursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, DATA_PROJECTION,
DataColumns.NOTE_ID + "=?", new String[] {
String.valueOf(mNoteId)
}, null);
if (cursor != null) {
// 2. 将游标移动到第一个结果
if (cursor.moveToFirst()) {
do {
// 3. 读取数据的 MIME 类型
String type = cursor.getString(DATA_MIME_TYPE_COLUMN);
if (DataConstants.NOTE.equals(type)) {
// 4. 如果是普通笔记,存储内容和模式,并设置文本数据的 ID
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)) {
// 5. 如果是通话笔记,设置通话数据的 ID
mNote.setCallDataId(cursor.getLong(DATA_ID_COLUMN));
} else {
// 6. 对于不识别的类型,打印调试日志
Log.d(TAG, "Wrong note type with type:" + type);
}
} while (cursor.moveToNext());
@ -173,7 +188,7 @@ public class WorkingNote {
throw new IllegalArgumentException("Unable to find note's data with id " + mNoteId);
}
}
// 创建一个空的笔记
public static WorkingNote createEmptyNote(Context context, long folderId, int widgetId,
int widgetType, int defaultBgColorId) {
WorkingNote note = new WorkingNote(context, folderId);
@ -182,24 +197,25 @@ public class WorkingNote {
note.setWidgetType(widgetType);
return note;
}
// 从数据库加载一个笔记
public static WorkingNote load(Context context, long id) {
return new WorkingNote(context, id, 0);
}
// 保存笔记到数据库
public synchronized boolean saveNote() {
if (isWorthSaving()) {
if (!existInDatabase()) {
// 如果笔记不存在于数据库中,创建一个新的笔记 ID
if ((mNoteId = Note.getNewNoteId(mContext, mFolderId)) == 0) {
Log.e(TAG, "Create new note fail with id:" + mNoteId);
return false;
}
}
// 调用 Note 对象的 syncNote 方法同步笔记信息
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
@ -212,11 +228,13 @@ public class WorkingNote {
}
}
// 检查笔记是否存在于数据库中
public boolean existInDatabase() {
return mNoteId > 0;
}
// 判断笔记是否值得保存
private boolean isWorthSaving() {
// 1. 判断笔记是否已删除,或者如果笔记不存在且内容为空,或者笔记存在但未被本地修改,则不值得保存
if (mIsDeleted || (!existInDatabase() && TextUtils.isEmpty(mContent))
|| (existInDatabase() && !mNote.isLocalModified())) {
return false;
@ -224,11 +242,11 @@ public class WorkingNote {
return true;
}
}
// 设置笔记设置变更监听器
public void setOnSettingStatusChangedListener(NoteSettingChangedListener l) {
mNoteSettingStatusListener = l;
}
// 设置提醒日期
public void setAlertDate(long date, boolean set) {
if (date != mAlertDate) {
mAlertDate = date;
@ -238,7 +256,7 @@ public class WorkingNote {
mNoteSettingStatusListener.onClockAlertChanged(date, set);
}
}
// 标记笔记是否已删除
public void markDeleted(boolean mark) {
mIsDeleted = mark;
if (mWidgetId != AppWidgetManager.INVALID_APPWIDGET_ID
@ -246,7 +264,7 @@ public class WorkingNote {
mNoteSettingStatusListener.onWidgetChanged();
}
}
// 设置背景颜色 ID
public void setBgColorId(int id) {
if (id != mBgColorId) {
mBgColorId = id;
@ -256,7 +274,7 @@ public class WorkingNote {
mNote.setNoteValue(NoteColumns.BG_COLOR_ID, String.valueOf(id));
}
}
// 设置检查列表模式
public void setCheckListMode(int mode) {
if (mMode != mode) {
if (mNoteSettingStatusListener != null) {
@ -266,102 +284,102 @@ public class WorkingNote {
mNote.setTextData(TextNote.MODE, String.valueOf(mMode));
}
}
// 设置小部件类型
public void setWidgetType(int type) {
if (type != mWidgetType) {
mWidgetType = type;
mNote.setNoteValue(NoteColumns.WIDGET_TYPE, String.valueOf(mWidgetType));
}
}
// 设置小部件 ID
public void setWidgetId(int id) {
if (id != mWidgetId) {
mWidgetId = id;
mNote.setNoteValue(NoteColumns.WIDGET_ID, String.valueOf(mWidgetId));
}
}
// 设置笔记的工作文本
public void setWorkingText(String text) {
if (!TextUtils.equals(mContent, text)) {
mContent = text;
mNote.setTextData(DataColumns.CONTENT, mContent);
}
}
// 将笔记转换为通话笔记
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));
}
// 检查是否有闹钟提醒
public boolean hasClockAlert() {
return (mAlertDate > 0 ? true : false);
}
// 获取笔记内容
public String getContent() {
return mContent;
}
// 获取提醒日期
public long getAlertDate() {
return mAlertDate;
}
// 获取最后修改日期
public long getModifiedDate() {
return mModifiedDate;
}
// 获取背景颜色的资源 ID
public int getBgColorResId() {
return NoteBgResources.getNoteBgResource(mBgColorId);
}
// 获取背景颜色 ID
public int getBgColorId() {
return mBgColorId;
}
// 获取标题背景的资源 ID
public int getTitleBgResId() {
return NoteBgResources.getNoteTitleBgResource(mBgColorId);
}
// 获取检查列表模式
public int getCheckListMode() {
return mMode;
}
// 获取笔记 ID
public long getNoteId() {
return mNoteId;
}
// 获取文件夹 ID
public long getFolderId() {
return mFolderId;
}
// 获取小部件 ID
public int getWidgetId() {
return mWidgetId;
}
// 获取小部件类型
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
/**
*
*/
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);
}

@ -35,12 +35,15 @@ import java.io.FileOutputStream;
import java.io.IOException;
import java.io.PrintStream;
// BackupUtils 类用于实现笔记数据的备份和导出为文本文件的功能
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);
@ -53,52 +56,60 @@ public class BackupUtils {
* status
*/
// Currently, the sdcard is not mounted
// 以下是表示备份或恢复状态的常量
// 表示 SD 卡未挂载
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;
// 私有构造函数,初始化时创建 TextExport 实例
private BackupUtils(Context context) {
mTextExport = new TextExport(context);
}
// 检查外部存储是否可用的方法
private static boolean externalStorageAvailable() {
// 比较外部存储状态是否为已挂载
return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
}
// 调用 TextExport 的 exportToText 方法进行数据导出为文本,并返回结果状态
public int exportToText() {
return mTextExport.exportToText();
}
// 获取导出的文本文件名
public String getExportedTextFileName() {
return mTextExport.mFileName;
}
// 获取导出的文本文件目录
public String getExportedTextFileDir() {
return mTextExport.mFileDirectory;
}
// 内部类 TextExport用于实现具体的文本导出功能
private static class TextExport {
// 用于查询笔记的投影,包含笔记的 ID、修改日期、摘要和类型
private static final String[] NOTE_PROJECTION = {
NoteColumns.ID,
NoteColumns.MODIFIED_DATE,
NoteColumns.SNIPPET,
NoteColumns.TYPE
};
// 笔记投影中 ID 列的索引
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;
// 用于查询数据的投影包含数据的内容、MIME 类型等多个字段
private static final String[] DATA_PROJECTION = {
DataColumns.CONTENT,
DataColumns.MIME_TYPE,
@ -107,31 +118,36 @@ public class BackupUtils {
DataColumns.DATA3,
DataColumns.DATA4,
};
// 数据投影中内容列的索引
private static final int DATA_COLUMN_CONTENT = 0;
// 数据投影中 MIME 类型列的索引
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];
}
@ -139,8 +155,10 @@ public class BackupUtils {
/**
* Export the folder identified by folder id to text
*/
// 将指定文件夹及其下的笔记导出到 PrintStream
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
@ -150,14 +168,18 @@ public class BackupUtils {
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
// 获取笔记 ID
String noteId = notesCursor.getString(NOTE_COLUMN_ID);
// 导出该笔记
exportNoteToText(noteId, ps);
} while (notesCursor.moveToNext());
}
// 关闭游标
notesCursor.close();
}
}
@ -165,7 +187,9 @@ public class BackupUtils {
/**
* Export note identified by id to a print stream
*/
private void exportNoteToText(String noteId, PrintStream ps) {
// 将指定笔记及其相关数据导出到 PrintStream
private void exportNoteToText(String noteId, PrintStream ps) {
// 查询属于该笔记的数据
Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] {
noteId
@ -177,6 +201,7 @@ public class BackupUtils {
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);
@ -186,15 +211,18 @@ public class BackupUtils {
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),
@ -203,9 +231,11 @@ public class BackupUtils {
}
} while (dataCursor.moveToNext());
}
// 关闭游标
dataCursor.close();
}
// print a line separator between note
// 在笔记之间打印换行符
try {
ps.write(new byte[] {
Character.LINE_SEPARATOR, Character.LETTER_NUMBER
@ -218,18 +248,22 @@ public class BackupUtils {
/**
* Note will be exported as text which is user readable
*/
public int exportToText() {
// 将笔记数据导出为用户可读的文本文件
public int exportToText() {
// 检查外部存储是否可用
if (!externalStorageAvailable()) {
Log.d(TAG, "Media was not mounted");
return STATE_SD_CARD_UNMOUONTED;
}
// 获取用于导出的 PrintStream
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,
@ -241,6 +275,7 @@ public class BackupUtils {
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);
@ -254,10 +289,12 @@ public class BackupUtils {
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,
@ -271,12 +308,15 @@ public class BackupUtils {
mContext.getString(R.string.format_datetime_mdhm),
noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// Query data belong to this note
// 获取笔记 ID
String noteId = noteCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (noteCursor.moveToNext());
}
// 关闭游标
noteCursor.close();
}
// 关闭 PrintStream
ps.close();
return STATE_SUCCESS;
@ -285,7 +325,9 @@ public class BackupUtils {
/**
* Get a print stream pointed to the file {@generateExportedTextFile}
*/
// 获取指向导出文件的 PrintStream
private PrintStream getExportToTextPrintStream() {
// 在 SD 卡上生成导出文件
File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
R.string.file_name_txt_format);
if (file == null) {
@ -296,6 +338,7 @@ public class BackupUtils {
mFileDirectory = mContext.getString(R.string.file_path);
PrintStream ps = null;
try {
// 创建文件输出流和 PrintStream
FileOutputStream fos = new FileOutputStream(file);
ps = new PrintStream(fos);
} catch (FileNotFoundException e) {
@ -312,6 +355,7 @@ public class BackupUtils {
/**
* Generate the text file to store imported data
*/
// 在 SD 卡上生成用于存储导入数据的文本文件
private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
StringBuilder sb = new StringBuilder();
sb.append(Environment.getExternalStorageDirectory());
@ -324,9 +368,11 @@ public class BackupUtils {
File file = new File(sb.toString());
try {
// 如果目录不存在则创建目录
if (!filedir.exists()) {
filedir.mkdir();
}
// 如果文件不存在则创建文件
if (!file.exists()) {
file.createNewFile();
}
@ -340,5 +386,13 @@ public class BackupUtils {
return null;
}
}
/*
*
BackupUtils
便
TextExport SD
使getInstanceBackupUtilsexportToText
NotesNoteColumnsDataColumnsDataConstantsR.string
*/

@ -36,85 +36,142 @@ import java.util.HashSet;
public class DataUtils {
// 用于日志记录的标签
public static final String TAG = "DataUtils";
/**
*
*
* @param resolver ContentResolver
* @param ids ID HashSet
* @return true false
*/
public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
// 检查 ids 是否为 null
if (ids == null) {
Log.d(TAG, "the ids is null");
// 如果为 null视为删除操作成功可能是因为没有要删除的内容
return true;
}
// 检查 ids 集合是否为空
if (ids.size() == 0) {
Log.d(TAG, "no id is in the hashset");
// 如果为空,视为删除操作成功(没有实际要删除的笔记)
return true;
}
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
// 遍历要删除的笔记 ID 集合
for (long id : ids) {
// 不允许删除系统根文件夹
if(id == Notes.ID_ROOT_FOLDER) {
Log.e(TAG, "Don't delete system folder root");
continue;
}
// 创建一个删除操作的构建器,指定要删除的笔记 URI
ContentProviderOperation.Builder builder = ContentProviderOperation
.newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
operationList.add(builder.build());
}
try {
// 执行批量操作
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
// 检查结果是否为空或长度为 0 或第一个结果为 null
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
return false;
}
// 如果操作成功,返回 true
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()));
}
// 如果发生异常,返回 false
return false;
}
/**
*
*
* @param resolver ContentResolver
* @param id ID
* @param srcFolderId ID
* @param desFolderId ID
*/
public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) {
ContentValues values = new ContentValues();
// 设置目标文件夹 ID
values.put(NoteColumns.PARENT_ID, desFolderId);
// 设置源文件夹 ID
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);
}
/**
*
*
* @param resolver ContentResolver
* @param ids ID HashSet
* @param folderId ID
* @return true false
*/
public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
long folderId) {
// 检查 ids 是否为 null
if (ids == null) {
Log.d(TAG, "the ids is null");
return true;
}
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
// 遍历要移动的笔记 ID 集合
for (long id : ids) {
// 创建一个更新操作的构建器,指定要更新的笔记 URI
ContentProviderOperation.Builder builder = ContentProviderOperation
.newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
// 设置目标文件夹 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) {
// 执行批量操作
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
// 检查结果是否为空或长度为 0 或第一个结果为 null
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
return false;
}
// 如果操作成功,返回 true
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()));
}
// 如果发生异常,返回 false
return false;
}
/**
* Get the all folder count except system folders {@link Notes#TYPE_SYSTEM}}
*/
/**
* {@link Notes#TYPE_SYSTEM}
*
* @param resolver ContentResolver
* @return
*/
public static int getUserFolderCount(ContentResolver resolver) {
// 查询数据库,计算符合条件的文件夹数量
Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { "COUNT(*)" },
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
@ -125,18 +182,28 @@ public class DataUtils {
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;
}
/**
*
*
* @param resolver ContentResolver
* @param noteId ID
* @param type
* @return true false
*/
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,
@ -152,8 +219,15 @@ public class DataUtils {
}
return exist;
}
/**
*
*
* @param resolver ContentResolver
* @param noteId ID
* @return true false
*/
public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) {
// 查询数据库,检查笔记是否存在
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId),
null, null, null, null);
@ -166,8 +240,15 @@ public class DataUtils {
}
return exist;
}
/**
*
*
* @param resolver ContentResolver
* @param dataId ID
* @return true false
*/
public static boolean existInDataDatabase(ContentResolver resolver, long dataId) {
// 查询数据库,检查数据是否存在
Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId),
null, null, null, null);
@ -180,8 +261,15 @@ public class DataUtils {
}
return exist;
}
/**
*
*
* @param resolver ContentResolver
* @param name
* @return true false
*/
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 +
@ -196,8 +284,15 @@ public class DataUtils {
}
return exist;
}
/**
*
*
* @param resolver ContentResolver
* @param folderId ID
* @return HashSet
*/
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 + "=?",
@ -223,8 +318,15 @@ public class DataUtils {
}
return set;
}
/**
* ID
*
* @param resolver ContentResolver
* @param noteId ID
* @return
*/
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 + "=?",
@ -242,8 +344,16 @@ public class DataUtils {
}
return "";
}
/**
* ID
*
* @param resolver ContentResolver
* @param phoneNumber
* @param callDate
* @return ID 0
*/
public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
// 查询数据库,获取指定电话号码和通话日期对应的笔记 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("
@ -263,8 +373,15 @@ public class DataUtils {
}
return 0;
}
/**
* ID
*
* @param resolver ContentResolver
* @param noteId ID
* @return
*/
public static String getSnippetById(ContentResolver resolver, long noteId) {
// 查询数据库,获取指定笔记的摘要信息
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String [] { NoteColumns.SNIPPET },
NoteColumns.ID + "=?",
@ -281,7 +398,12 @@ public class DataUtils {
}
throw new IllegalArgumentException("Note is not found with id: " + noteId);
}
/**
*
*
* @param snippet
* @return
*/
public static String getFormattedSnippet(String snippet) {
if (snippet != null) {
snippet = snippet.trim();

@ -13,101 +13,104 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
// 该类属于 net.micode.notes.tool 包
package net.micode.notes.tool;
// 定义了一个公共类 GTaskStringUtils
public class GTaskStringUtils {
// 以下是一系列公共的静态常量字符串,它们很可能是用于 JSON 数据处理或数据交互时的键Key
// 表示操作的 ID
public final static String GTASK_JSON_ACTION_ID = "action_id";
// 表示操作列表
public final static String GTASK_JSON_ACTION_LIST = "action_list";
// 表示操作类型
public final static String GTASK_JSON_ACTION_TYPE = "action_type";
// 操作类型为创建
public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
// 操作类型为获取全部
public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
// 操作类型为移动
public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
// 操作类型为更新
public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
// 表示创建者的 ID
public final static String GTASK_JSON_CREATOR_ID = "creator_id";
// 表示子实体
public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
// 表示客户端版本
public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
// 表示完成状态
public final static String GTASK_JSON_COMPLETED = "completed";
// 表示当前列表的 ID
public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
// 表示默认列表的 ID
public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
// 表示已删除状态
public final static String GTASK_JSON_DELETED = "deleted";
// 表示目标列表
public final static String GTASK_JSON_DEST_LIST = "dest_list";
// 表示目标父级
public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
// 表示目标父级的类型
public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
// 表示实体的增量
public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
// 表示实体类型
public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
// 表示获取已删除的内容
public final static String GTASK_JSON_GET_DELETED = "get_deleted";
// 表示 ID
public final static String GTASK_JSON_ID = "id";
// 表示索引
public final static String GTASK_JSON_INDEX = "index";
// 表示最后修改时间
public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
// 表示最新的同步点
public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
// 表示列表的 ID
public final static String GTASK_JSON_LIST_ID = "list_id";
// 表示列表
public final static String GTASK_JSON_LISTS = "lists";
// 表示名称
public final static String GTASK_JSON_NAME = "name";
// 表示新的 ID
public final static String GTASK_JSON_NEW_ID = "new_id";
// 表示笔记
public final static String GTASK_JSON_NOTES = "notes";
// 表示父级的 ID
public final static String GTASK_JSON_PARENT_ID = "parent_id";
// 表示前一个兄弟节点的 ID
public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
// 表示结果
public final static String GTASK_JSON_RESULTS = "results";
// 表示源列表
public final static String GTASK_JSON_SOURCE_LIST = "source_list";
// 表示任务
public final static String GTASK_JSON_TASKS = "tasks";
// 表示类型
public final static String GTASK_JSON_TYPE = "type";
// 类型为组
public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
// 类型为任务
public final static String GTASK_JSON_TYPE_TASK = "TASK";
// 表示用户
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";
}

@ -21,25 +21,26 @@ import android.preference.PreferenceManager;
import net.micode.notes.R;
import net.micode.notes.ui.NotesPreferenceActivity;
// 资源解析器类,用于管理笔记应用中的各种资源
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 {
// 存储笔记编辑界面背景的资源 ID 数组,分别对应不同颜色的背景
private final static int [] BG_EDIT_RESOURCES = new int [] {
R.drawable.edit_yellow,
R.drawable.edit_blue,
@ -47,7 +48,7 @@ public class ResourceParser {
R.drawable.edit_green,
R.drawable.edit_red
};
// 存储笔记编辑界面标题背景的资源 ID 数组,分别对应不同颜色的标题背景
private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
R.drawable.edit_title_yellow,
R.drawable.edit_title_blue,
@ -55,26 +56,30 @@ public class ResourceParser {
R.drawable.edit_title_green,
R.drawable.edit_title_red
};
// 根据传入的颜色 ID 获取笔记编辑界面的背景资源 ID
public static int getNoteBgResource(int id) {
return BG_EDIT_RESOURCES[id];
}
// 根据传入的颜色 ID 获取笔记编辑界面的标题背景资源 ID
public static int getNoteTitleBgResource(int id) {
return BG_EDIT_TITLE_RESOURCES[id];
}
}
// 根据上下文获取默认的背景 ID
public static int getDefaultBgId(Context context) {
// 检查用户偏好设置中是否设置了背景颜色
if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
// 如果设置了,随机选择一个背景颜色
return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
} else {
// 否则使用默认的背景颜色
return BG_DEFAULT_COLOR;
}
}
// 内部类 NoteItemBgResources 用于管理笔记列表项的背景资源
public static class NoteItemBgResources {
// 存储笔记列表项的不同状态(如第一个、正常、最后一个、单个)的背景资源 ID 数组,分别对应不同颜色
private final static int [] BG_FIRST_RESOURCES = new int [] {
R.drawable.list_yellow_up,
R.drawable.list_blue_up,
@ -106,29 +111,30 @@ public class ResourceParser {
R.drawable.list_green_single,
R.drawable.list_red_single
};
// 根据传入的颜色 ID 获取笔记列表项第一个元素的背景资源 ID
public static int getNoteBgFirstRes(int id) {
return BG_FIRST_RESOURCES[id];
}
// 根据传入的颜色 ID 获取笔记列表项最后一个元素的背景资源 ID
public static int getNoteBgLastRes(int id) {
return BG_LAST_RESOURCES[id];
}
// 根据传入的颜色 ID 获取笔记列表项单个元素的背景资源 ID
public static int getNoteBgSingleRes(int id) {
return BG_SINGLE_RESOURCES[id];
}
// 根据传入的颜色 ID 获取笔记列表项正常元素的背景资源 ID
public static int getNoteBgNormalRes(int id) {
return BG_NORMAL_RESOURCES[id];
}
// 获取文件夹的背景资源 ID
public static int getFolderBgRes() {
return R.drawable.list_folder;
}
}
// 内部类 WidgetBgResources 用于管理小部件的背景资源
public static class WidgetBgResources {
// 存储 2x 小部件的不同颜色的背景资源 ID 数组
private final static int [] BG_2X_RESOURCES = new int [] {
R.drawable.widget_2x_yellow,
R.drawable.widget_2x_blue,
@ -136,11 +142,11 @@ public class ResourceParser {
R.drawable.widget_2x_green,
R.drawable.widget_2x_red,
};
// 根据传入的颜色 ID 获取 2x 小部件的背景资源 ID
public static int getWidget2xBgResource(int id) {
return BG_2X_RESOURCES[id];
}
// 存储 4x 小部件的不同颜色的背景资源 ID 数组
private final static int [] BG_4X_RESOURCES = new int [] {
R.drawable.widget_4x_yellow,
R.drawable.widget_4x_blue,
@ -148,20 +154,21 @@ public class ResourceParser {
R.drawable.widget_4x_green,
R.drawable.widget_4x_red
};
// 根据传入的颜色 ID 获取 4x 小部件的背景资源 ID
public static int getWidget4xBgResource(int id) {
return BG_4X_RESOURCES[id];
}
}
// 内部类 TextAppearanceResources 用于管理文本外观资源
public static class TextAppearanceResources {
// 存储不同字体大小的文本外观资源 ID 数组
private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
R.style.TextAppearanceNormal,
R.style.TextAppearanceMedium,
R.style.TextAppearanceLarge,
R.style.TextAppearanceSuper
};
// 根据传入的字体大小 ID 获取文本外观资源 ID
public static int getTexAppearanceResource(int id) {
/**
* HACKME: Fix bug of store the resource id in shared preference.
@ -173,6 +180,7 @@ public class ResourceParser {
}
return TEXTAPPEARANCE_RESOURCES[id];
}
// 获取文本外观资源的数量
public static int getResourcesSize() {
return TEXTAPPEARANCE_RESOURCES.length;

@ -39,33 +39,42 @@ import net.micode.notes.tool.DataUtils;
import java.io.IOException;
// 闹钟提醒活动类,继承自 Activity 并实现 OnClickListener 和 OnDismissListener 接口
public class AlarmAlertActivity extends Activity implements OnClickListener, OnDismissListener {
// 笔记的 ID
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 intent = getIntent();
try {
// 从 Intent 的数据中提取笔记 ID
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
// 根据笔记 ID 获取笔记的摘要
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;
@ -73,36 +82,45 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
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
Uri url = RingtoneManager.getActualDefaultRingtoneUri(this, RingtoneManager.TYPE_ALARM);
int silentModeStreams = Settings.System.getInt(getContentResolver(),
// 获取系统的静音模式设置
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
@ -118,39 +136,53 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
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 指向 NoteEditActivity
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;
}

@ -21,10 +21,24 @@ import android.content.Context;
import android.content.Intent;
public class AlarmReceiver extends BroadcastReceiver {
/**
* 广BroadcastReceiver
* 广Activity
*
* @param context Activity
* @param intent 广Intent使
*/
@Override
public void onReceive(Context context, Intent intent) {
// 通过setClass方法修改Intent的目标组件将原本可能指向其他地方或者没有明确指向的Intent
// 重新设置为指向AlarmAlertActivity也就是将广播触发后的下一步操作引导到展示闹钟提醒界面的Activity上。
intent.setClass(context, AlarmAlertActivity.class);
// 给Intent添加一个标志位FLAG_ACTIVITY_NEW_TASK这个标志表示当启动Activity时
// 如果当前任务栈Task不存在或者不适合启动该Activity系统会创建一个新的任务栈来启动这个Activity。
// 因为BroadcastReceiver的生命周期比较特殊它没有自己的UI界面相关的任务栈所以需要添加这个标志确保Activity能正常启动。
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
// 使用传入的上下文对象启动设置好的Intent对应的Activity这样就会从接收到闹钟提醒广播
// 跳转到展示具体闹钟提醒信息的AlarmAlertActivity界面让用户看到闹钟提醒相关的内容如对话框、提示信息等
context.startActivity(intent);
}
}

@ -28,85 +28,129 @@ import android.view.View;
import android.widget.FrameLayout;
import android.widget.NumberPicker;
// DateTimePicker类继承自FrameLayout可作为界面中的布局容器使用用于实现日期和时间选择的功能
public class DateTimePicker extends FrameLayout {
// 默认的启用状态设置为true表示默认启用该控件
private static final boolean DEFAULT_ENABLE_STATE = true;
// 半天包含的小时数即12小时用于12小时制相关逻辑
private static final int HOURS_IN_HALF_DAY = 12;
// 一整天包含的小时数即24小时用于24小时制相关逻辑
private static final int HOURS_IN_ALL_DAY = 24;
// 一周包含的天数,用于日期选择器相关逻辑,例如循环显示一周内的日期等情况
private static final int DAYS_IN_ALL_WEEK = 7;
// 日期选择器的最小可选值通常设为0比如对应一周内第一天的索引等情况
private static final int DATE_SPINNER_MIN_VAL = 0;
// 日期选择器的最大可选值根据一周的天数减1来设置因为索引从0开始
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
// 24小时制视图下小时选择器的最小可选值即0点
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
// 24小时制视图下小时选择器的最大可选值即23点
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
// 12小时制视图下小时选择器的最小可选值即1点12小时制中通常显示1 - 12
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
// 12小时制视图下小时选择器的最大可选值即12点
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
// 分钟选择器的最小可选值即0分钟
private static final int MINUT_SPINNER_MIN_VAL = 0;
// 分钟选择器的最大可选值即59分钟
private static final int MINUT_SPINNER_MAX_VAL = 59;
// AM/PM选择器的最小可选值通常设为0对应AM
private static final int AMPM_SPINNER_MIN_VAL = 0;
// AM/PM选择器的最大可选值设为1对应PM
private static final int AMPM_SPINNER_MAX_VAL = 1;
// 用于选择日期的NumberPicker控件显示在界面上供用户选择具体日期
private final NumberPicker mDateSpinner;
// 用于选择小时的NumberPicker控件根据是24小时制还是12小时制显示不同范围的小时值供选择
private final NumberPicker mHourSpinner;
// 用于选择分钟的NumberPicker控件可选择0 - 59分钟范围内的值
private final NumberPicker mMinuteSpinner;
// 用于选择上午/下午在12小时制下的NumberPicker控件显示AM或PM供选择
private final NumberPicker mAmPmSpinner;
// Calendar对象用于记录当前选中的日期和时间方便进行各种时间相关的计算和操作
private Calendar mDate;
// 用于存储要在日期选择器中显示的一周内各天的字符串表示,例如"周一"、"周二"等
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
// 标记当前是否是上午用于12小时制下时间显示和逻辑处理
private boolean mIsAm;
// 标记当前是否是24小时制视图如果为true则按24小时制显示时间否则按12小时制显示
private boolean mIs24HourView;
// 记录该DateTimePicker控件的启用状态初始化为默认启用状态
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) {
// 根据新旧值的差值在Calendar对象中调整日期实现日期的增减操作
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
// 更新日期选择器的显示内容,确保显示的是正确的日期信息
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();
// 如果不是24小时制视图即12小时制
if (!mIs24HourView) {
// 如果当前不是上午且旧值是1112小时制下半天的最后一小时新值变为12切换到下午
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
cal.setTimeInMillis(mDate.getTimeInMillis());
// 将日期增加一天因为从上午切换到下午跨越了中午12点到了下一天
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
} else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
// 将日期减少一天因为从下午切换到上午跨越了中午12点回到了前一天
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
// 如果是从上午切换到下午或者从下午切换到上午的情况
if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY ||
oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {
// 切换上午/下午的标记
mIsAm = !mIsAm;
// 更新上午/下午选择器的显示内容确保显示正确的AM/PM状态
updateAmPmControl();
}
} else {
// 如果是24小时制视图且从23点变为0点跨天情况
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
cal.setTimeInMillis(mDate.getTimeInMillis());
// 将日期增加一天,因为跨越了一天的边界
cal.add(Calendar.DAY_OF_YEAR, 1);
isDateChanged = true;
} else if (oldVal == 0 && newVal == HOURS_IN_ALL_DAY - 1) {
cal.setTimeInMillis(mDate.getTimeInMillis());
// 将日期减少一天,因为跨越了一天的边界反向变化
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
}
// 根据当前是否是上午以及小时选择器的值计算出正确的小时数用于设置到Calendar对象中
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));
@ -115,12 +159,14 @@ 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;
// 如果分钟从最大值变为最小值,意味着时间跨越了一个小时边界(可能需要调整小时、日期等)
if (oldVal == maxValue && newVal == minValue) {
offset += 1;
} else if (oldVal == minValue && newVal == maxValue) {
@ -131,6 +177,7 @@ public class DateTimePicker extends FrameLayout {
mHourSpinner.setValue(getCurrentHour());
updateDateControl();
int newHour = getCurrentHourOfDay();
// 如果新的小时数大于等于12半天的小时数则标记为下午
if (newHour >= HOURS_IN_HALF_DAY) {
mIsAm = false;
updateAmPmControl();
@ -140,85 +187,113 @@ public class DateTimePicker extends FrameLayout {
}
}
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;
// 如果切换到下午将小时数增加半天的小时数12小时
if (mIsAm) {
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
} else {
// 如果切换到上午将小时数减少半天的小时数12小时
mDate.add(Calendar.HOUR_OF_DAY, HOURS_IN_HALF_DAY);
}
updateAmPmControl();
// 通知外部监听器(如果有设置的话)时间发生了变化,传递相关时间参数
onDateTimeChanged();
}
};
// 定义一个接口用于外部类监听DateTimePicker的日期和时间变化事件
public interface OnDateTimeChangedListener {
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
}
// 构造方法接受一个Context参数使用当前时间作为初始日期创建DateTimePicker实例
public DateTimePicker(Context context) {
this(context, System.currentTimeMillis());
}
// 构造方法接受一个Context参数和日期的时间戳long类型根据指定日期创建DateTimePicker实例默认按当前系统设置的时间格式24小时制或12小时制显示
public DateTimePicker(Context context, long date) {
this(context, date, DateFormat.is24HourFormat(context));
}
// 完整的构造方法接受Context、日期时间戳和是否是24小时制视图的布尔值作为参数用于创建DateTimePicker实例并进行初始化设置
public DateTimePicker(Context context, long date, boolean is24HourView) {
super(context);
// 获取当前时间作为初始的日期和时间设置
mDate = Calendar.getInstance();
mInitialising = true;
// 根据当前小时数判断是否是上午如果大于等于12小时则为下午
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
// 加载datetime_picker布局文件到该控件中构建其内部的视图结构
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);
// 获取用于显示上午/下午的字符串数组根据系统语言等设置获取对应的AM/PM字符串
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
// 获取布局中的上午/下午选择器控件,设置其最小、最大值以及显示的字符串数组,并设置值变化监听器
mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL);
mAmPmSpinner.setDisplayedValues(stringsForAmPm);
mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
// 更新日期选择器的显示内容,使其显示初始的正确日期信息
// update controls to initial state
updateDateControl();
// 更新小时选择器的显示范围等设置根据是否是24小时制进行相应调整
updateHourControl();
// 更新上午/下午选择器的显示状态根据是否是24小时制显示或隐藏该控件
updateAmPmControl();
// 设置是否是24小时制视图根据传入参数进行相应的显示和逻辑调整
set24HourView(is24HourView);
// 设置当前日期为传入的指定日期
// set to current time
setCurrentDate(date);
// 设置该DateTimePicker控件及其内部各个选择器的启用状态
setEnabled(isEnabled());
// 初始化完成将初始化标记设为false
// set the content descriptions
mInitialising = false;
}
// 重写父类的setEnabled方法用于设置整个DateTimePicker控件及其内部各个时间选择器的启用状态
@Override
public void setEnabled(boolean enabled) {
if (mIsEnabled == enabled) {
return;
}
super.setEnabled(enabled);
mDateSpinner.setEnabled(enabled);
mMinuteSpinner.setEnabled(enabled);
@ -227,11 +302,13 @@ public class DateTimePicker extends FrameLayout {
mIsEnabled = enabled;
}
// 重写父类的isEnabled方法用于获取整个DateTimePicker控件的启用状态
@Override
public boolean isEnabled() {
return mIsEnabled;
}
// 获取当前日期的时间戳以毫秒为单位返回当前记录在mDate中的日期对应的时间戳
/**
* Get the current date in millis
*
@ -241,6 +318,7 @@ public class DateTimePicker extends FrameLayout {
return mDate.getTimeInMillis();
}
// 根据传入的日期时间戳long类型设置当前日期内部会进一步解析并设置具体的年、月、日、时、分等信息
/**
* Set the current date
*
@ -252,6 +330,7 @@ public class DateTimePicker extends FrameLayout {
setCurrentDate(cal.get(Calendar.YEAR), cal.get(Calendar.MONTH), cal.get(Calendar.DAY_OF_MONTH),
cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE));
}
// 设置当前日期的具体年、月、日、时、分信息,同时会更新
/**
* Set the current date
@ -262,28 +341,37 @@ public class DateTimePicker extends FrameLayout {
* @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);
// 调用设置月份的方法
setCurrentMonth(month);
// 调用设置日的方法
setCurrentDay(dayOfMonth);
// 调用设置小时的方法
setCurrentHour(hourOfDay);
// 调用设置分钟的方法
setCurrentMinute(minute);
}
/**
* Get current year
*
*
* @return The current year
* @return Calendar
*/
public int getCurrentYear() {
return mDate.get(Calendar.YEAR);
}
/**
* Set current year
*
*
* @param year The current year
* @param year
* mInitialisingfalse
* Calendar
* updateDateControlonDateTimeChanged
*/
public void setCurrentYear(int year) {
if (!mInitialising && year == getCurrentYear()) {
@ -295,18 +383,21 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current month in the year
* 0 - 11011
*
* @return The current month in the year
* @return Calendar
*/
public int getCurrentMonth() {
return mDate.get(Calendar.MONTH);
}
/**
* Set current month in the year
*
*
* @param month The month in the year
* @param month 0 - 11
* mInitialisingfalse
* Calendar
* updateDateControlonDateTimeChanged
*/
public void setCurrentMonth(int month) {
if (!mInitialising && month == getCurrentMonth()) {
@ -318,18 +409,21 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current day of the month
*
*
* @return The day of the month
* @return Calendar
*/
public int getCurrentDay() {
return mDate.get(Calendar.DAY_OF_MONTH);
}
/**
* Set current day of the month
*
*
* @param dayOfMonth The day of the month
* @param dayOfMonth
* mInitialisingfalse
* Calendar
* updateDateControlonDateTimeChanged
*/
public void setCurrentDay(int dayOfMonth) {
if (!mInitialising && dayOfMonth == getCurrentDay()) {
@ -341,13 +435,21 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current hour in 24 hour mode, in the range (0~23)
* @return The current hour in 24 hour mode
* 240 - 23
*
* @return 24CalendarHOUR_OF_DAY
*/
public int getCurrentHourOfDay() {
return mDate.get(Calendar.HOUR_OF_DAY);
}
/**
* 24
* 2424getCurrentHourOfDay
* 1224121201212
*
* @return
*/
private int getCurrentHour() {
if (mIs24HourView){
return getCurrentHourOfDay();
@ -362,9 +464,14 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Set current hour in 24 hour mode, in the range (0~23)
* 24
*
* @param hourOfDay
* @param hourOfDay 240 - 23
* mInitialisingfalse24
* CalendarHOUR_OF_DAY
* 2412/mIsAm
* 1212updateAmPmControl/
* onDateTimeChanged
*/
public void setCurrentHour(int hourOfDay) {
if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
@ -390,16 +497,19 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get currentMinute
*
*
* @return The Current Minute
* @return Calendar
*/
public int getCurrentMinute() {
return mDate.get(Calendar.MINUTE);
}
/**
* Set current minute
*
* mInitialisingfalse
*
* CalendaronDateTimeChanged
*/
public void setCurrentMinute(int minute) {
if (!mInitialising && minute == getCurrentMinute()) {
@ -411,16 +521,22 @@ public class DateTimePicker extends FrameLayout {
}
/**
* @return true if this is in 24 hour view else false.
* 24
*
* @return 24truefalse
*/
public boolean is24HourView () {
return mIs24HourView;
}
/**
* Set whether in 24 hour or AM/PM mode.
* 24AM/PM12
*
* @param is24HourView True for 24 hour mode. False for AM/PM mode.
* @param is24HourView true24false12AM/PM
* mIs24HourView
* mIs24HourView/mAmPmSpinner2412
* 24updateHourControl2412
* setCurrentHourupdateAmPmControl/
*/
public void set24HourView(boolean is24HourView) {
if (mIs24HourView == is24HourView) {
@ -434,6 +550,17 @@ public class DateTimePicker extends FrameLayout {
updateAmPmControl();
}
/**
* mDateSpinner
*
* 1. CalendarmDate
* 2. CalendarDAYS_IN_ALL_WEEK / 2 + 1
* 3. null
* 4. Calendar使DateFormat"MM.dd EEEE". X
* mDateDisplayValues
* 5. mDateDisplayValuesDAYS_IN_ALL_WEEK / 2
* invalidate使
*/
private void updateDateControl() {
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(mDate.getTimeInMillis());
@ -448,6 +575,12 @@ public class DateTimePicker extends FrameLayout {
mDateSpinner.invalidate();
}
/**
* 24/mAmPmSpinner
* 24/GONE
* 2412/mIsAm/AM0PM1
* /VISIBLE
*/
private void updateAmPmControl() {
if (mIs24HourView) {
mAmPmSpinner.setVisibility(View.GONE);
@ -458,6 +591,13 @@ public class DateTimePicker extends FrameLayout {
}
}
/**
* 24mHourSpinner
* 24HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW0
* HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW23
* 2412HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW1
* HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW12
*/
private void updateHourControl() {
if (mIs24HourView) {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
@ -469,13 +609,20 @@ 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
* OnDateTimeChangedListener
* DateTimePicker
* null
*
* @param callback OnDateTimeChangedListener
*/
public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
mOnDateTimeChangedListener = callback;
}
/**
*
* DateTimePickeronDateTimeChanged
*/
private void onDateTimeChanged() {
if (mOnDateTimeChangedListener != null) {
mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),

@ -28,22 +28,33 @@ import android.content.DialogInterface;
import android.content.DialogInterface.OnClickListener;
import android.text.format.DateFormat;
import android.text.format.DateUtils;
// DateTimePickerDialog类继承自AlertDialog同时实现了OnClickListener接口用于创建一个带有日期和时间选择功能的对话框
public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
// Calendar对象用于记录当前选择的日期和时间初始化为当前系统时间
private Calendar mDate = Calendar.getInstance();
// 标记当前是否是24小时制视图用于控制时间的显示格式
private boolean mIs24HourView;
// 定义一个接口类型的变量,用于监听用户设置好日期和时间后的操作,外部类可实现该接口来响应设置事件
private OnDateTimeSetListener mOnDateTimeSetListener;
// 用于实际进行日期和时间选择操作的DateTimePicker控件实例
private DateTimePicker mDateTimePicker;
// 定义一个接口,用于在用户点击对话框中的确定按钮,设置好日期和时间后进行回调,外部类需实现该接口来处理具体逻辑
public interface OnDateTimeSetListener {
void OnDateTimeSet(AlertDialog dialog, long date);
}
// 构造方法接受一个Context参数和日期的时间戳long类型用于创建DateTimePickerDialog实例并进行初始化设置
public DateTimePickerDialog(Context context, long date) {
super(context);
// 创建一个DateTimePicker实例用于在对话框中展示日期和时间选择的界面
mDateTimePicker = new DateTimePicker(context);
// 将DateTimePicker控件设置为对话框的内容视图使其显示在对话框中供用户操作
setView(mDateTimePicker);
// 为DateTimePicker设置日期和时间变化的监听器当用户在DateTimePicker中选择的日期或时间发生变化时
// 会触发该监听器中的onDateTimeChanged方法在该方法内更新mDate对象记录的日期和时间信息并调用updateTitle方法更新对话框标题显示的当前日期和时间
mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
public void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute) {
@ -55,32 +66,56 @@ public class DateTimePickerDialog extends AlertDialog implements OnClickListener
updateTitle(mDate.getTimeInMillis());
}
});
// 设置当前日期和时间为传入的指定日期时间戳对应的时间同时将秒数设置为0通常在选择时间时精确到分钟即可
mDate.setTimeInMillis(date);
mDate.set(Calendar.SECOND, 0);
// 将DateTimePicker显示的当前日期和时间设置为mDate所记录的时间确保初始显示与传入的指定时间一致
mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
// 设置对话框的确定按钮按钮文本通过资源字符串获取R.string.datetime_dialog_ok并将当前类实现了OnClickListener接口作为点击监听器传入
// 当用户点击确定按钮时会触发onClick方法进行相应处理
setButton(context.getString(R.string.datetime_dialog_ok), this);
// 设置对话框的取消按钮按钮文本通过资源字符串获取R.string.datetime_dialog_cancel传入null作为点击监听器表示使用默认的取消行为关闭对话框
setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
// 根据系统当前的时间格式设置是否是24小时制来设置该对话框的时间显示格式调用set24HourView方法进行设置
set24HourView(DateFormat.is24HourFormat(this.getContext()));
// 初次创建对话框时,根据传入的初始日期时间戳更新对话框标题显示的当前日期和时间
updateTitle(mDate.getTimeInMillis());
}
// 设置该对话框的时间显示格式是否为24小时制传入true表示设置为24小时制传入false表示设置为12小时制AM/PM
public void set24HourView(boolean is24HourView) {
mIs24HourView = is24HourView;
}
// 设置用于监听用户设置好日期和时间后的回调接口外部类实现OnDateTimeSetListener接口后将实例传入该方法
// 以便在用户点击确定按钮完成设置时接收通知并进行相应处理
public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
mOnDateTimeSetListener = callBack;
}
// 私有方法用于根据当前日期时间以及是否是24小时制视图等信息更新对话框标题显示的日期和时间字符串
private void updateTitle(long date) {
private void updateTitle(long date) {
int flag =
DateUtils.FORMAT_SHOW_YEAR |
DateUtils.FORMAT_SHOW_DATE |
DateUtils.FORMAT_SHOW_TIME;
DateUtils.FORMAT_SHOW_YEAR |// 表示在格式化日期时间字符串时显示年份
DateUtils.FORMAT_SHOW_DATE |// 表示显示日期(月、日等)
DateUtils.FORMAT_SHOW_TIME;// 表示显示时间(时、分等)
// 根据当前是否是24小时制视图添加相应的格式化标志用于控制时间的显示格式24小时制或12小时制带AM/PM
flag |= mIs24HourView? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_12HOUR;
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
}
// 实现OnClickListener接口的onClick方法当用户点击对话框中的按钮这里主要是确定按钮时触发该方法
// 如果设置了OnDateTimeSetListener监听器会调用其OnDateTimeSet方法将当前对话框实例以及选择好的日期时间戳传递给外部监听器
// 以便外部类进行相应的后续处理(比如保存选择的时间等操作)
public void onClick(DialogInterface arg0, int arg1) {
if (mOnDateTimeSetListener != null) {
mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());

@ -27,17 +27,35 @@ import android.widget.PopupMenu.OnMenuItemClickListener;
import net.micode.notes.R;
// DropdownMenu类用于创建一个下拉菜单的功能组件通常可以关联一个按钮点击按钮弹出包含相应菜单项的菜单
public class DropdownMenu {
// 用于显示下拉菜单的按钮,用户点击该按钮会触发弹出菜单的操作
private Button mButton;
// PopupMenu实例用于实现弹出式菜单的功能它会依附在指定的View这里是mButton上显示
private PopupMenu mPopupMenu;
// 代表菜单对象,用于操作和获取菜单中的具体菜单项等相关信息
private Menu mMenu;
// 构造方法用于初始化DropdownMenu实例接受上下文环境Context、关联的按钮Button以及菜单资源IDint类型作为参数
public DropdownMenu(Context context, Button button, int menuId) {
// 将传入的按钮赋值给成员变量mButton后续操作会基于这个按钮来触发弹出菜单等行为
mButton = button;
// 为按钮设置背景资源,这里使用的是名为"dropdown_icon"的资源(通常是一个图标,用于提示用户该按钮可弹出菜单)
mButton.setBackgroundResource(R.drawable.dropdown_icon);
// 创建一个PopupMenu实例将传入的上下文环境和关联的按钮作为参数传入使得弹出菜单能够在正确的界面环境下依附该按钮显示
mPopupMenu = new PopupMenu(context, mButton);
// 获取PopupMenu中的Menu对象赋值给成员变量mMenu以便后续对菜单进行各种操作比如添加菜单项、查找菜单项等
mMenu = mPopupMenu.getMenu();
// 通过菜单填充器MenuInflater将指定资源ID对应的菜单布局文件通常定义了菜单项等信息填充到mMenu中
// 这样就构建好了具有具体菜单项的菜单
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
// 为按钮设置点击事件监听器当按钮被点击时会触发onClick方法在该方法内调用PopupMenu的show方法
// 从而显示弹出式菜单供用户选择菜单项
mButton.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
mPopupMenu.show();
@ -45,16 +63,23 @@ public class DropdownMenu {
});
}
// 设置下拉菜单中菜单项的点击事件监听器外部类实现OnMenuItemClickListener接口后
// 通过传入该接口的实现实例,可以监听每个菜单项被点击时的事件,并进行相应的处理逻辑
// 如果PopupMenu实例不为空则将传入的监听器设置给PopupMenu使其能够响应菜单项的点击操作
public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
if (mPopupMenu != null) {
mPopupMenu.setOnMenuItemClickListener(listener);
}
}
// 根据传入的菜单项ID在菜单mMenu中查找对应的MenuItem实例并返回方便外部类对特定菜单项进行进一步操作
// 比如获取菜单项的属性、设置菜单项的状态等
public MenuItem findItem(int id) {
return mMenu.findItem(id);
}
// 设置按钮上显示的文本内容,通常可以用于显示当前选中的菜单项相关信息或者作为菜单的标题等,
// 通过修改按钮的文本setText方法来实现显示效果的更新
public void setTitle(CharSequence title) {
mButton.setText(title);
}

@ -28,26 +28,37 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
// FoldersListAdapter类继承自CursorAdapter用于为包含文件夹相关数据的Cursor通常来自数据库查询结果提供适配
// 以便在ListView等列表视图组件中展示文件夹信息。
public class FoldersListAdapter extends CursorAdapter {
// 定义一个字符串数组用于指定从数据库查询时需要获取的列信息这里包含了文件夹的ID和片段可能是名称等相关信息
public static final String [] PROJECTION = {
NoteColumns.ID,
NoteColumns.SNIPPET
};
// 定义一个常量表示在查询结果的Cursor中文件夹ID所在列的索引值为0方便后续从Cursor中准确获取对应的数据
public static final int ID_COLUMN = 0;
// 定义一个常量表示在查询结果的Cursor中文件夹名称这里用NAME_COLUMN指代可能实际对应NoteColumns.SNIPPET等相关列所在列的索引值为1
public static final int NAME_COLUMN = 1;
// 构造方法接受上下文环境Context和一个Cursor对象作为参数调用父类CursorAdapter的构造方法进行初始化
// 这里的TODO注释表示后续可能需要完善该构造方法的具体逻辑目前仅完成了基本的初始化调用父类构造函数操作。
public FoldersListAdapter(Context context, Cursor c) {
super(context, c);
// TODO Auto-generated constructor stub
}
// 重写CursorAdapter的newView方法该方法用于创建一个新的视图View对象用于展示列表中的每一项数据。
// 在这里返回一个新的FolderListItem实例意味着每个列表项的视图将由FolderListItem来构建和管理。
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
return new FolderListItem(context);
}
// 重写CursorAdapter的bindView方法该方法用于将数据绑定到已经创建好的视图View即将Cursor中的数据填充到对应的视图控件中进行显示。
// 首先判断传入的视图是否是FolderListItem类型如果是则根据Cursor中获取的数据来设置文件夹名称显示的文本内容。
// 如果文件夹的ID等于特定的根文件夹IDNotes.ID_ROOT_FOLDER则显示一个特定的字符串从资源中获取可能是表示根文件夹的提示文本
// 否则显示从Cursor中获取的对应名称列NAME_COLUMN的字符串内容并通过FolderListItem的bind方法将名称设置到对应的TextView控件中进行显示。
@Override
public void bindView(View view, Context context, Cursor cursor) {
if (view instanceof FolderListItem) {
@ -57,21 +68,31 @@ public class FoldersListAdapter extends CursorAdapter {
}
}
// 自定义的方法用于获取指定位置position的文件夹名称。
// 通过调用getItem方法继承自CursorAdapter获取对应位置的Cursor对象然后根据与bindView方法类似的逻辑
// 判断文件夹ID是否为根文件夹ID来决定返回特定字符串还是从Cursor中获取的名称列字符串内容。
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);
}
// 定义一个内部类FolderListItem继承自LinearLayout用于表示列表中每个文件夹项对应的视图布局结构以及相关操作。
private class FolderListItem extends LinearLayout {
// 定义一个TextView控件用于显示文件夹的名称信息。
private TextView mName;
// 构造方法接受上下文环境Context作为参数调用父类LinearLayout的构造方法进行初始化
// 然后通过inflate方法加载名为R.layout.folder_list_item的布局文件到当前视图中
// 最后从加载后的布局中找到ID为R.id.tv_folder_name的TextView控件并赋值给mName成员变量以便后续操作。
public FolderListItem(Context context) {
super(context);
inflate(context, R.layout.folder_list_item, this);
mName = (TextView) findViewById(R.id.tv_folder_name);
}
// 自定义的方法用于将传入的文件夹名称字符串设置到mNameTextView控件上进行显示实现数据与视图的绑定操作。
public void bind(String name) {
mName.setText(name);
}

@ -15,7 +15,7 @@
*/
package net.micode.notes.ui;
// 这里假设你的包名是com.example.yourpackage实际需替换为正确的包名
import android.app.Activity;
import android.app.AlarmManager;
import android.app.AlertDialog;
@ -71,19 +71,23 @@ import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
// NoteEditActivity类继承自Activity或AppCompatActivity取决于实际的父类继承情况实现了多个接口用于处理笔记编辑相关的各种交互逻辑
// 例如点击事件、设置变更监听、文本变更监听等是一个用于编辑笔记的Activity
public class NoteEditActivity extends Activity implements OnClickListener,
NoteSettingChangedListener, OnTextViewChangeListener {
// 内部类HeadViewHolder用于封装笔记头部视图相关的UI组件方便管理和操作
private class HeadViewHolder {
public TextView tvModified;
// 用于显示笔记修改时间的TextView组件
public ImageView ivAlertIcon;
// 用于显示提醒图标如闹钟图标等的ImageView组件
public TextView tvAlertDate;
// 用于显示提醒时间相关信息的TextView组件
public ImageView ibSetBgColor;
// 用于设置背景颜色的ImageView按钮组件
}
// 静态的Map用于将背景颜色选择按钮的资源ID如R.id.iv_bg_yellow等映射到对应的颜色常量如ResourceParser.YELLOW等方便根据按钮ID获取对应的颜色标识
private static final Map<Integer, Integer> sBgSelectorBtnsMap = new HashMap<Integer, Integer>();
static {
sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW);
@ -93,6 +97,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
sBgSelectorBtnsMap.put(R.id.iv_bg_white, ResourceParser.WHITE);
}
// 静态的Map用于将颜色常量如ResourceParser.YELLOW等映射到对应的背景颜色选择按钮被选中时的显示资源ID如R.id.iv_bg_yellow_select等
// 用于在选择颜色后显示相应的选中效果
private static final Map<Integer, Integer> sBgSelectorSelectionMap = new HashMap<Integer, Integer>();
static {
sBgSelectorSelectionMap.put(ResourceParser.YELLOW, R.id.iv_bg_yellow_select);
@ -102,6 +108,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select);
}
// 静态的Map用于将字体大小选择按钮所在的布局资源ID如R.id.ll_font_large等映射到对应的字体大小常量如ResourceParser.TEXT_LARGE等方便根据按钮布局ID获取对应的字体大小标识
private static final Map<Integer, Integer> sFontSizeBtnsMap = new HashMap<Integer, Integer>();
static {
sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE);
@ -110,6 +117,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER);
}
// 静态的Map用于将字体大小常量如ResourceParser.TEXT_LARGE等映射到对应的字体大小选择按钮被选中时的显示资源ID如R.id.iv_large_select等
// 用于在选择字体大小后显示相应的选中效果
private static final Map<Integer, Integer> sFontSelectorSelectionMap = new HashMap<Integer, Integer>();
static {
sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select);
@ -118,46 +127,68 @@ public class NoteEditActivity extends Activity implements OnClickListener,
sFontSelectorSelectionMap.put(ResourceParser.TEXT_SUPER, R.id.iv_super_select);
}
// 用于日志记录的标签方便在日志中识别该Activity相关的输出信息
private static final String TAG = "NoteEditActivity";
// 用于存储笔记头部视图相关组件的实例,方便后续操作和更新头部视图的显示内容
private HeadViewHolder mNoteHeaderHolder;
// 笔记头部视图的整体布局,包含标题、修改时间、提醒相关等组件的外层容器
private View mHeadViewPanel;
// 用于显示背景颜色选择器的视图,包含各种背景颜色选项按钮等
private View mNoteBgColorSelector;
// 用于显示字体大小选择器的视图,包含各种字体大小选项按钮等
private View mFontSizeSelector;
// 用于编辑笔记内容的EditText组件用户在此输入和修改笔记的文本内容
private EditText mNoteEditor;
// 包含笔记编辑区域如mNoteEditor以及相关滚动等功能的外层布局视图用于整体的笔记编辑界面布局管理
private View mNoteEditorPanel;
// 代表正在编辑的笔记对象,包含笔记的各种属性(如内容、修改时间、背景颜色等)以及相关操作方法(如保存、加载等)
private WorkingNote mWorkingNote;
// 用于获取和操作应用的共享偏好设置,可用于存储和读取如字体大小、用户个性化设置等相关信息
private SharedPreferences mSharedPrefs;
// 当前选择的字体大小ID对应于ResourceParser中定义的字体大小常量用于确定笔记编辑区域显示的字体大小
private int mFontSizeId;
// 存储在共享偏好设置中用于标识字体大小偏好设置的键名常量
private static final String PREFERENCE_FONT_SIZE = "pref_font_size";
// 快捷方式图标标题的最大长度限制,用于生成发送到桌面的快捷方式图标时,截取合适长度的笔记内容作为标题
private static final int SHORTCUT_ICON_TITLE_MAX_LEN = 10;
// 表示复选框被选中状态的字符常量,用于处理复选框列表模式下的笔记内容显示和解析
public static final String TAG_CHECKED = String.valueOf('\u221A');
// 表示复选框未被选中状态的字符常量,用于处理复选框列表模式下的笔记内容显示和解析
public static final String TAG_UNCHECKED = String.valueOf('\u25A1');
// 用于存储笔记编辑中多行文本如果是列表模式等情况的LinearLayout每个子项可能是一个包含文本和复选框的自定义布局方便处理多行文本编辑逻辑
private LinearLayout mEditTextList;
// 用户查询的文本内容,可能用于搜索、筛选等功能相关,比如在笔记中查找特定内容等场景
private String mUserQuery;
// 用于正则表达式匹配的Pattern对象可能用于在笔记内容中按照特定规则查找、匹配文本等操作具体取决于业务逻辑中如何使用
private Pattern mPattern;
// Activity创建时调用的方法进行一些初始化操作如设置布局、恢复Activity状态等
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 设置该Activity对应的布局文件即加载笔记编辑界面的UI布局
this.setContentView(R.layout.note_edit);
// 如果是首次创建savedInstanceState为null且初始化Activity状态失败则直接结束该Activity并返回
if (savedInstanceState == null && !initActivityState(getIntent())) {
finish();
return;
}
// 初始化各种资源如查找UI组件、设置点击事件监听器等
initResources();
}
@ -168,6 +199,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
@Override
protected void onRestoreInstanceState(Bundle savedInstanceState) {
super.onRestoreInstanceState(savedInstanceState);
// 如果保存的实例状态不为null且包含特定的用户ID信息通过Intent.EXTRA_UID标识则尝试恢复Activity状态
if (savedInstanceState != null && savedInstanceState.containsKey(Intent.EXTRA_UID)) {
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.putExtra(Intent.EXTRA_UID, savedInstanceState.getLong(Intent.EXTRA_UID));
@ -179,16 +211,21 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
// 根据传入的Intent初始化Activity的状态根据不同的Intent动作如查看、新建/编辑等)来加载相应的笔记数据或者创建新的笔记对象
private boolean initActivityState(Intent intent) {
// 初始化正在编辑的笔记对象为null
/**
* If the user specified the {@link Intent#ACTION_VIEW} but not provided with id,
* then jump to the NotesListActivity
*/
mWorkingNote = null;
// 如果Intent的动作是查看笔记Intent.ACTION_VIEW
if (TextUtils.equals(Intent.ACTION_VIEW, intent.getAction())) {
// 获取笔记的ID如果没有传入则默认为0
long noteId = intent.getLongExtra(Intent.EXTRA_UID, 0);
mUserQuery = "";
// 如果Intent中包含搜索结果相关的额外数据通过SearchManager.EXTRA_DATA_KEY标识则更新笔记ID和用户查询文本
/**
* Starting from the searched result
*/
@ -197,6 +234,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);
}
// 检查该笔记ID对应的笔记在数据库中是否可见是否存在且满足一定可见条件如果不可见则跳转到笔记列表页面并提示笔记不存在然后结束当前Activity
if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {
Intent jump = new Intent(this, NotesListActivity.class);
startActivity(jump);
@ -204,6 +242,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
finish();
return false;
} else {
// 从数据库加载对应笔记ID的笔记对象如果加载失败则记录错误日志并结束当前Activity
mWorkingNote = WorkingNote.load(this, noteId);
if (mWorkingNote == null) {
Log.e(TAG, "load note failed with note id" + noteId);
@ -211,19 +250,28 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return false;
}
}
// 设置软键盘的显示模式,初始隐藏软键盘,并且根据内容调整布局大小
getWindow().setSoftInputMode(
WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN
| WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);
} else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {
// 如果Intent的动作是新建或编辑笔记Intent.ACTION_INSERT_OR_EDIT
// 获取文件夹ID如果没有传入则默认为0
// New note
long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);
// 获取小部件ID如果没有传入则默认为无效的小部件IDAppWidgetManager.INVALID_APPWIDGET_ID
int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
// 获取小部件类型如果没有传入则默认为无效的小部件类型Notes.TYPE_WIDGET_INVALIDE
int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE,
Notes.TYPE_WIDGET_INVALIDE);
// 获取背景资源ID如果没有传入则调用ResourceParser获取默认的背景颜色资源ID
int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID,
ResourceParser.getDefaultBgId(this));
// 解析通话记录笔记相关信息如果Intent中包含电话号码和通话日期则尝试根据这些信息获取对应的笔记ID
// 如果找到对应笔记ID则加载该笔记对象否则创建一个空的笔记对象并转换为通话笔记格式
// Parse call-record note
String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);
long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);
@ -241,11 +289,15 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return false;
}
} else {
// 如果没有通话记录相关信息,则创建一个空的笔记对象
mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId,
widgetType, bgResId);
mWorkingNote.convertToCallNote(phoneNumber, callDate);
}
// 设置软键盘的显示模式,初始显示软键盘并且根据内容调整布局大小
} else {
// 如果Intent没有指定有效的动作则记录错误日志并结束当前Activity因为不支持这种情况
mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType,
bgResId);
}
@ -258,66 +310,96 @@ public class NoteEditActivity extends Activity implements OnClickListener,
finish();
return false;
}
// 设置正在编辑的笔记对象的设置状态变更监听器为当前Activity实现了NoteSettingChangedListener接口
mWorkingNote.setOnSettingStatusChangedListener(this);
return true;
}
// Activity重新恢复到前台可见时调用的方法用于重新初始化笔记编辑界面的显示内容等
@Override
protected void onResume() {
super.onResume();
initNoteScreen();
}
// 初始化笔记编辑界面的显示内容,如设置字体大小、根据笔记模式(是否为复选框列表模式等)显示相应内容、更新头部视图的时间显示等
private void initNoteScreen() {
// 设置笔记编辑区域的文本外观根据当前选择的字体大小ID获取对应的文本外观资源并应用
mNoteEditor.setTextAppearance(this, TextAppearanceResources
.getTexAppearanceResource(mFontSizeId));
// 如果笔记处于复选框列表模式,则切换到列表模式显示界面,并传入笔记内容进行相应处理
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
switchToListMode(mWorkingNote.getContent());
} else {
// 如果不是列表模式,则在编辑区域显示笔记内容,并对用户查询的文本进行高亮显示,然后将光标定位到文本末尾
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
mNoteEditor.setSelection(mNoteEditor.getText().length());
}
// 遍历背景颜色选择按钮选中状态对应的资源ID映射表将所有选中状态的显示组件设置为不可见用于清除之前可能的选中显示效果
for (Integer id : sBgSelectorSelectionMap.keySet()) {
findViewById(sBgSelectorSelectionMap.get(id)).setVisibility(View.GONE);
}
// 设置笔记头部视图的背景资源根据正在编辑的笔记对象获取对应的标题背景资源ID并应用
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
// 设置笔记编辑区域的背景资源根据正在编辑的笔记对象获取对应的背景颜色资源ID并应用
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
// 设置笔记头部视图中修改时间的显示文本,根据笔记的修改时间格式化并显示相应的日期和时间信息
mNoteHeaderHolder.tvModified.setText(DateUtils.formatDateTime(this,
mWorkingNote.getModifiedDate(), DateUtils.FORMAT_SHOW_DATE
| DateUtils.FORMAT_NUMERIC_DATE | DateUtils.FORMAT_SHOW_TIME
| DateUtils.FORMAT_SHOW_YEAR));
// 显示提醒相关的头部信息(如提醒图标和提醒时间等),根据笔记是否设置了提醒以及当前时间等情况进行相应的显示
/**
* TODO: Add the menu for setting alert. Currently disable it because the DateTimePicker
* is not ready
*/
// 显示提醒相关的头部信息(如提醒图标和提醒时间等),根据笔记是否设置了提醒以及当前时间等情况进行相应的显示
showAlertHeader();
}
// 此方法用于根据笔记是否设置了提醒以及当前时间与提醒时间的关系,来设置笔记头部提醒相关视图(提醒时间文本和提醒图标)的显示状态及内容
private void showAlertHeader() {
private void showAlertHeader() {
// 判断正在编辑的笔记对象mWorkingNote是否设置了时钟提醒hasClockAlert方法返回true表示设置了提醒
if (mWorkingNote.hasClockAlert()) {
// 获取当前系统时间以毫秒为单位从1970年1月1日00:00:00 UTC到当前时间的毫秒数
long time = System.currentTimeMillis();
// 如果当前时间大于笔记设置的提醒时间
if (time > mWorkingNote.getAlertDate()) {
// 将提醒时间文本视图mNoteHeaderHolder.tvAlertDate的内容设置为表示提醒已过期的字符串资源R.string.note_alert_expired
mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);
} else {
// 如果当前时间未超过提醒时间则调用DateUtils的方法获取相对时间跨度字符串用于显示距离提醒时间还有多久
// 参数分别为提醒时间、当前时间以及时间跨度的单位这里是以分钟为单位DateUtils.MINUTE_IN_MILLIS表示一分钟对应的毫秒数
mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString(
mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));
}
// 将提醒时间文本视图设置为可见状态,以便用户能看到提醒相关的时间信息
mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE);
// 将提醒图标视图设置为可见状态,展示相应的提醒图标,提示用户有提醒设置
mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE);
} else {
// 如果笔记没有设置时钟提醒,则将提醒时间文本视图设置为不可见状态,隐藏相关文本显示
mNoteHeaderHolder.tvAlertDate.setVisibility(View.GONE);
// 将提醒图标视图设置为不可见状态,隐藏提醒图标
mNoteHeaderHolder.ivAlertIcon.setVisibility(View.GONE);
};
}
// 当Activity接收到新的Intent时会调用此方法它首先调用父类的onNewIntent方法然后根据新传入的Intent重新初始化Activity的状态
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 调用initActivityState方法传入新的Intent根据Intent中的信息来重新加载笔记数据、设置相关属性等以适应新的启动意图
// 比如从其他地方重新启动该Activity并传递了不同的参数就会在此处更新Activity的状态
initActivityState(intent);
}
// 当系统即将销毁Activity以回收内存或者进行配置变更如屏幕旋转等情况时会调用此方法来保存Activity的当前状态信息
// 以便后续可以恢复到当前状态。这里先调用父类的onSaveInstanceState方法来执行默认的保存操作然后进行自定义的保存逻辑
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
@ -328,51 +410,73 @@ public class NoteEditActivity extends Activity implements OnClickListener,
*/
if (!mWorkingNote.existInDatabase()) {
saveNote();
// 将正在编辑的笔记对象的ID存入传出的BundleoutState键为Intent.EXTRA_UID以便后续恢复状态时能获取到该笔记的标识信息
}
outState.putLong(Intent.EXTRA_UID, mWorkingNote.getNoteId());
// 在日志中记录正在保存的工作笔记的ID信息方便调试和查看状态保存情况使用TAG作为日志标签方便识别是该Activity相关的日志输出
Log.d(TAG, "Save working note id: " + mWorkingNote.getNoteId() + " onSaveInstanceState");
}
// 用于分发触摸事件Activity接收到触摸事件后会先经过此方法处理在这里可以拦截触摸事件或者将其传递给子视图进行处理。
// 主要用于处理背景颜色选择器和字体大小选择器在显示时,触摸事件在其范围外的情况
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
// 如果背景颜色选择器mNoteBgColorSelector当前处于可见状态并且触摸事件不在其显示范围内通过inRangeOfView方法判断
if (mNoteBgColorSelector.getVisibility() == View.VISIBLE
&& !inRangeOfView(mNoteBgColorSelector, ev)) {
// 则将背景颜色选择器设置为不可见,隐藏该选择器视
mNoteBgColorSelector.setVisibility(View.GONE);
// 返回true表示已经处理了该触摸事件不会再继续传递给其他视图进行处理即拦截了此次触摸事件对背景颜色选择器的后续影响
return true;
}
if (mFontSizeSelector.getVisibility() == View.VISIBLE
&& !inRangeOfView(mFontSizeSelector, ev)) {
// 将字体大小选择器设置为不可见,隐藏该选择器视图
mFontSizeSelector.setVisibility(View.GONE);
// 返回true表示已经处理了该触摸事件拦截了此次触摸事件对字体大小选择器的后续影响不再继续传递给其他视图
return true;
}
// 如果上述条件都不满足,即触摸事件不在需要特殊处理的选择器范围外,或者选择器本身就不可见等情况,
// 则调用父类的dispatchTouchEvent方法将触摸事件按照默认的分发逻辑继续传递给其他视图进行处理
return super.dispatchTouchEvent(ev);
}
// 此方法用于判断给定的触摸事件MotionEvent是否在指定的视图view范围内通过比较触摸点的坐标与视图在屏幕上的坐标及尺寸来确定
private boolean inRangeOfView(View view, MotionEvent ev) {
int []location = new int[2];
// 获取指定视图在屏幕上的坐标位置将结果存入location数组中通过这种方式可以得到视图左上角顶点相对于屏幕左上角的坐标值
view.getLocationOnScreen(location);
// 获取视图在屏幕上的横坐标x坐标即location数组的第一个元素
int x = location[0];
// 获取视图在屏幕上的纵坐标y坐标即location数组的第二个元素
int y = location[1];
// 判断触摸事件的横坐标ev.getX()获取触摸点相对于触发触摸事件的视图的横坐标是否小于视图的横坐标x
// 如果小于则说明触摸点在视图的左侧不在视图范围内返回false
if (ev.getX() < x
|| ev.getX() > (x + view.getWidth())
|| ev.getY() < y
|| ev.getY() > (y + view.getHeight())) {
return false;
}
// 判断触摸事件的横坐标是否大于视图的横坐标加上视图的宽度x + view.getWidth()表示视图的右侧边界横坐标),
// 如果大于则说明触摸点在视图的右侧不在视图范围内返回false
return true;
}
// 判断触摸事件的纵坐标ev.getY()获取触摸点相对于触发触摸事件的视图的纵坐标是否小于视图的纵坐标y
// 如果小于则说明触摸点在视图的上方不在视图范围内返回false
private void initResources() {
mHeadViewPanel = findViewById(R.id.note_title);
// 创建一个HeadViewHolder实例用于存储笔记头部视图相关的各个子组件方便后续统一操作和管理这些组件
mNoteHeaderHolder = new HeadViewHolder();
// 通过findViewById方法查找布局文件中ID为tv_modified_date的TextView组件该组件通常用于显示笔记的修改时间
// 并将其赋值给mNoteHeaderHolder中的tvModified变量方便后续操作该文本视图如设置显示的文本内容等
mNoteHeaderHolder.tvModified = (TextView) findViewById(R.id.tv_modified_date);
mNoteHeaderHolder.ivAlertIcon = (ImageView) findViewById(R.id.iv_alert_icon);
mNoteHeaderHolder.tvAlertDate = (TextView) findViewById(R.id.tv_alert_date);
mNoteHeaderHolder.ibSetBgColor = (ImageView) findViewById(R.id.btn_set_bg_color);
mNoteHeaderHolder.ibSetBgColor.setOnClickListener(this);
mNoteEditor = (EditText) findViewById(R.id.note_edit_view);
mNoteEditorPanel = findViewById(R.id.sv_note_edit);
mNoteEditorPanel = findViewById(R.id.sv_ note_edit);
mNoteBgColorSelector = findViewById(R.id.note_bg_color_selector);
for (int id : sBgSelectorBtnsMap.keySet()) {
ImageView iv = (ImageView) findViewById(id);
@ -397,15 +501,20 @@ public class NoteEditActivity extends Activity implements OnClickListener,
mEditTextList = (LinearLayout) findViewById(R.id.note_edit_list);
}
// 当Activity失去焦点即将进入暂停状态时调用此方法例如用户切换到其他应用或者按下Home键等情况。
// 先调用父类的onPause方法执行默认的暂停操作然后进行自定义的保存笔记数据和清理设置状态相关操作
@Override
protected void onPause() {
super.onPause();
// 调用saveNote方法保存笔记数据如果保存成功saveNote方法返回true
if(saveNote()) {
Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length());
}
clearSettingState();
}
// 用于更新桌面小部件的显示内容根据正在编辑的笔记对象mWorkingNote的小部件类型
// 构建相应的Intent并发送广播通知系统更新对应的小部件显示
private void updateWidget() {
Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) {
@ -417,10 +526,13 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return;
}
// 将正在编辑的笔记对象的小部件ID添加到Intent的额外数据中键为AppWidgetManager.EXTRA_APPWIDGET_IDS
// 这样接收广播的小部件更新逻辑可以知道要更新哪个具体的小部件实例
intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_IDS, new int[] {
mWorkingNote.getWidgetId()
});
// 处理界面上各个视图的点击事件根据点击的视图ID来执行相应的操作逻辑例如显示或隐藏相关视图、更新笔记的属性如背景颜色、字体大小等
sendBroadcast(intent);
setResult(RESULT_OK, intent);
}
@ -452,12 +564,17 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
// 当用户按下返回键时调用此方法,先尝试清理设置状态(如隐藏背景颜色选择器、字体大小选择器等),
// 如果清理成功则直接返回,不再执行默认的返回操作;如果清理失败则先保存笔记数据,再执行默认的返回操作
@Override
public void onBackPressed() {
if(clearSettingState()) {
return;
}
// 用于清理设置状态,检查背景颜色选择器和字体大小选择器是否处于可见状态,如果处于可见则将其设置为不可见,
// 根据是否有进行隐藏操作来返回相应的布尔值true表示有隐藏操作false表示没有需要隐藏的视图
// 如果清理设置状态失败则调用saveNote方法保存笔记数据
saveNote();
super.onBackPressed();
}
@ -473,13 +590,19 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return false;
}
// 当笔记的背景颜色发生改变时调用此方法,用于更新界面上相关视图的显示,以反映背景颜色的变化,
// 例如显示对应的背景颜色选中状态提示、设置笔记编辑区域和头部视图的背景资源等
public void onBackgroundColorChanged() {
// 根据正在编辑的笔记对象mWorkingNote当前的背景颜色ID找到对应的背景颜色选择按钮选中状态显示的视图并将其设置为可见状态
// 用于提示用户当前选择的是哪种背景颜色(显示选中效果)
findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility(
View.VISIBLE);
mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());
mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());
}
// 在准备显示选项菜单Options Menu时调用此方法进行一些菜单相关的初始化操作例如清理菜单、根据笔记的属性如是否为通话记录笔记、是否有提醒等加载不同的菜单布局、
// 更新菜单项的标题显示等最后返回true表示菜单准备就绪可以显示
@Override
public boolean onPrepareOptionsMenu(Menu menu) {
if (isFinishing()) {
@ -505,10 +628,12 @@ public class NoteEditActivity extends Activity implements OnClickListener,
return true;
}
// 处理选项菜单中各个菜单项的点击事件根据点击的菜单项ID来执行相应的操作逻辑例如创建新笔记、删除笔记、设置提醒、分享笔记等
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case R.id.menu_new_note:
// 如果点击的菜单项是“新建笔记”menu_new_note则调用createNewNote方法创建一个新的笔记
createNewNote();
break;
case R.id.menu_delete:
@ -523,6 +648,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
finish();
}
});
// 设置对话框的“取消”按钮NegativeButton点击时不执行任何操作传入null
builder.setNegativeButton(android.R.string.cancel, null);
builder.show();
break;
@ -531,10 +657,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE);
break;
case R.id.menu_list_mode:
// 如果点击的菜单项是“列表模式”menu_list_mode则切换正在编辑的笔记对象的复选框列表模式状态
// 如果当前是普通模式getCheckListMode返回0则切换为复选框列表模式TextNote.MODE_CHECK_LIST否则切换回普通模式0
mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ?
TextNote.MODE_CHECK_LIST : 0);
break;
case R.id.menu_share:
// 如果点击的菜单项是“分享”menu_share则先调用getWorkingText方法获取笔记的文本内容
// 然后调用sendTo方法将笔记内容分享到支持Intent.ACTION_SEND动作且类型为text/plain的其他应用中
getWorkingText();
sendTo(this, mWorkingNote.getContent());
break;
@ -554,7 +684,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
private void setReminder() {
// 创建一个DateTimePickerDialog实例用于显示日期时间选择对话框传入当前Activity的上下文
DateTimePickerDialog d = new DateTimePickerDialog(this, System.currentTimeMillis());
// 为DateTimePickerDialog设置日期时间设置监听器当用户在对话框中选择好日期时间并点击确定后会触发该监听器的OnDateTimeSet方法。
d.setOnDateTimeSetListener(new OnDateTimeSetListener() {
public void OnDateTimeSet(AlertDialog dialog, long date) {
mWorkingNote.setAlertDate(date , true);
@ -563,6 +695,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
d.show();
}
// 此方法用于将笔记内容分享到支持指定Intent动作Intent.ACTION_SEND和文本类型text/plain的其他应用中比如分享到短信、邮件等应用。
/**
* Share note to apps that support {@link Intent#ACTION_SEND} action
* and {@text/plain} type
@ -574,6 +707,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
context.startActivity(intent);
}
// 此方法用于创建一个新的笔记操作流程为先保存当前正在编辑的笔记如果有然后关闭当前的NoteEditActivity再启动一个新的NoteEditActivity进入新建笔记的流程。
private void createNewNote() {
// Firstly, save current editing notes
saveNote();
@ -586,6 +720,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
startActivity(intent);
}
// 此方法用于删除当前正在编辑的笔记,根据笔记是否存在于数据库以及当前应用是否处于同步模式等情况
private void deleteCurrentNote() {
if (mWorkingNote.existInDatabase()) {
HashSet<Long> ids = new HashSet<Long>();
@ -608,10 +743,12 @@ public class NoteEditActivity extends Activity implements OnClickListener,
mWorkingNote.markDeleted(true);
}
// 此方法用于判断当前应用是否处于同步模式通过获取同步账户名称调用NotesPreferenceActivity的getSyncAccountName方法并检查其去除空格后的长度是否大于0来确定。
private boolean isSyncMode() {
return NotesPreferenceActivity.getSyncAccountName(this).trim().length() > 0;
}
// 此方法用于处理笔记的时钟提醒相关设置的变更例如设置或取消提醒时间等操作在操作前会先确保笔记已保存如果未保存则先保存然后根据不同情况与系统的闹钟服务AlarmManager交互来设置或取消提醒。
public void onClockAlertChanged(long date, boolean set) {
/**
* User could set clock to an unsaved note, so before setting the
@ -642,10 +779,12 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
// 此方法用于处理在笔记编辑的多行文本列表中删除某一行文本的操作,会调整后续行的索引,并将删除行的文本内容合并到前一行(如果是第一行则直接处理该行),同时更新焦点和光标位置等。
public void onWidgetChanged() {
updateWidget();
}
// 遍历从要删除行的下一行index + 1开始到最后一行的所有行调整它们的索引将其索引减1使其与新的行数顺序对应。
public void onEditTextDelete(int index, String text) {
int childCount = mEditTextList.getChildCount();
if (childCount == 1) {
@ -657,6 +796,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
.setIndex(i - 1);
}
// 从多行文本列表中移除指定索引index的行视图。
mEditTextList.removeViewAt(index);
NoteEditText edit = null;
if(index == 0) {
@ -672,6 +812,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
edit.setSelection(length);
}
// 此方法用于处理在笔记编辑的多行文本列表中插入一行新文本的操作,会在指定索引位置添加新的行视图,更新相关行的索引,并设置新行的文本内容、焦点以及光标位置等。
public void onEditTextEnter(int index, String text) {
/**
* Should not happen, check for debug
@ -691,7 +832,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
private void switchToListMode(String text) {
// 首先移除多行文本列表mEditTextList中已有的所有视图清空列表内容为重新构建列表做准备。
mEditTextList.removeAllViews();
String[] items = text.split("\n");
int index = 0;
@ -701,17 +844,24 @@ public class NoteEditActivity extends Activity implements OnClickListener,
index++;
}
}
// 在多行文本列表末尾添加一个空的列表项视图,可能用于方便用户后续继续添加新的内容,提供一个空白的可编辑项。
mEditTextList.addView(getListItem("", index));
// 获取多行文本列表中最后一个添加的列表项(即索引为 index 的项中的文本编辑框NoteEditText组件并请求获取焦点
// 使得用户切换到列表模式后,光标默认处于最后一个可编辑项处,方便用户直接输入内容。
mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();
mNoteEditor.setVisibility(View.GONE);
mEditTextList.setVisibility(View.VISIBLE);
}
// 此方法用于在给定的完整文本fullText根据用户输入的查询文本userQuery查找匹配的内容并将匹配的内容设置为高亮显示最后返回处理后的包含高亮显示效果的 Spannable 对象。
private Spannable getHighlightQueryResult(String fullText, String userQuery) {
// 创建一个 SpannableString 对象,将传入的完整文本(如果传入的 fullText 为 null则初始化为空字符串包装起来
// 以便后续可以对其内容进行样式设置如设置高亮显示等操作SpannableString 类实现了 Spannable 接口,支持设置文本样式。
SpannableString spannable = new SpannableString(fullText == null ? "" : fullText);
if (!TextUtils.isEmpty(userQuery)) {
mPattern = Pattern.compile(userQuery);
// 创建一个 Matcher 对象,通过调用 Pattern 对象的 matcher 方法并传入完整文本fullText用于在文本中执行具体的匹配查找任务
// 可以通过其方法判断是否找到匹配内容以及获取匹配的位置等信息。
Matcher m = mPattern.matcher(fullText);
int start = 0;
while (m.find(start)) {
@ -723,10 +873,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
return spannable;
// 返回处理后的包含高亮显示效果的 SpannableString 对象,该对象可以用于在界面上展示带有高亮查询结果的文本内容。
}
private View getListItem(String item, int index) {
// 通过LayoutInflater从当前Activity的上下文this加载一个布局资源R.layout.note_edit_list_item创建一个视图对象
// 该布局资源定义了列表项的具体界面结构,包含文本编辑框、复选框等组件的布局样式。
View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null);
// 从创建的视图中获取文本编辑框NoteEditText组件用于后续设置文本外观、内容以及添加事件监听器等操作。
final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);
edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId));
CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item));
@ -735,11 +889,14 @@ public class NoteEditActivity extends Activity implements OnClickListener,
if (isChecked) {
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
} else {
// 如果复选框未被选中设置文本编辑框edit的绘制标志为默认的文本抗锯齿Paint.ANTI_ALIAS_FLAG和字距调整Paint.DEV_KERN_TEXT_FLAG标志
// 恢复文本的正常显示样式
edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);
}
}
});
// 判断列表项文本item是否以特定的标记TAG_CHECKED开头如果是表示该项初始状态为已选中状态。
if (item.startsWith(TAG_CHECKED)) {
cb.setChecked(true);
edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);
@ -750,20 +907,31 @@ public class NoteEditActivity extends Activity implements OnClickListener,
item = item.substring(TAG_UNCHECKED.length(), item.length()).trim();
}
// 为文本编辑框edit设置文本内容变化的监听器OnTextViewChangeListener这里传入当前Activitythis可能在监听器中实现了相应的逻辑
// 用于在文本编辑框内容改变时进行一些处理,比如实时更新相关数据等操作。
edit.setOnTextViewChangeListener(this);
edit.setIndex(index);
// 设置文本编辑框edit的文本内容通过调用 getHighlightQueryResult 方法根据当前列表项文本item和用户查询文本mUserQuery获取带有高亮显示效果的文本内容
// 并设置到文本编辑框中展示给用户。
edit.setText(getHighlightQueryResult(item, mUserQuery));
return view;
}
public void onTextChange(int index, boolean hasText) {
// 判断传入的索引index是否大于等于多行文本列表mEditTextList中的子项数量即行数如果大于等于则说明索引超出范围
// 记录错误日志提示不应该出现这种情况,然后直接返回,不进行后续操作。
if (index >= mEditTextList.getChildCount()) {
Log.e(TAG, "Wrong index, should not happen");
return;
}
// 如果文本编辑框中有文本内容hasText 为 true则获取多行文本列表中对应索引位置的视图并找到其中的复选框CheckBox组件将其设置为可见状态
// 以便用户可以看到并操作该复选框,通常用于有文本内容时可进行选中相关操作。
if(hasText) {
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.VISIBLE);
} else {
// 如果文本编辑框中没有文本内容hasText 为 false则获取多行文本列表中对应索引位置的视图并找到其中的复选框CheckBox组件将其设置为不可见状态
// 隐藏复选框,因为没有文本内容时可能不需要显示复选框进行相关操作。
mEditTextList.getChildAt(index).findViewById(R.id.cb_edit_item).setVisibility(View.GONE);
}
}
@ -777,6 +945,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
""));
}
mNoteEditor.setText(getHighlightQueryResult(mWorkingNote.getContent(), mUserQuery));
// 设置笔记编辑框mNoteEditor的文本内容通过调用 getHighlightQueryResult 方法根据正在编辑的笔记对象mWorkingNote的内容和用户查询文本mUserQuery
// 获取带有高亮显示效果的文本内容,并设置到笔记编辑框中展示给用户,恢复普通文本编辑模式下的文本显示。
mEditTextList.setVisibility(View.GONE);
mNoteEditor.setVisibility(View.VISIBLE);
}
@ -784,6 +954,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
private boolean getWorkingText() {
boolean hasChecked = false;
// 判断正在编辑的笔记对象mWorkingNote的复选框列表模式通过 getCheckListMode 方法获取)是否为 TextNote.MODE_CHECK_LIST即处于复选框列表模式
if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {
StringBuilder sb = new StringBuilder();
for (int i = 0; i < mEditTextList.getChildCount(); i++) {
@ -792,8 +963,12 @@ public class NoteEditActivity extends Activity implements OnClickListener,
if (!TextUtils.isEmpty(edit.getText())) {
if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) {
sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");
// 如果复选框处于选中状态将特定的选中标记TAG_CHECKED、空格以及文本编辑框中的文本内容拼接起来并添加换行符
// 按照特定格式构建列表项文本内容,添加到 StringBuilder 中,同时将 hasChecked 标记为 true表示存在已选中的列表项。
hasChecked = true;
} else {
// 如果笔记对象不处于复选框列表模式则直接将笔记编辑框mNoteEditor中的文本内容通过调用其 getText 方法获取文本内容并转换为字符串),
// 设置为正在编辑的笔记对象mWorkingNote的工作文本内容通过调用其 setWorkingText 方法实现。
sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");
}
}
@ -818,6 +993,7 @@ public class NoteEditActivity extends Activity implements OnClickListener,
*/
setResult(RESULT_OK);
}
// 返回保存操作是否成功的布尔值,以便调用此方法的地方根据返回值进行相应的后续处理,比如提示用户保存成功与否等情况。
return saved;
}
@ -844,6 +1020,8 @@ public class NoteEditActivity extends Activity implements OnClickListener,
sender.putExtra("duplicate", true);
sender.setAction("com.android.launcher.action.INSTALL_SHORTCUT");
showToast(R.string.info_note_enter_desktop);
// 此方法用于将正在编辑的笔记相关的快捷方式发送到桌面在操作前会先确保笔记已保存如果是新笔记则先调用saveNote方法保存
// 然后根据笔记的ID是否有效大于0表示有效构建相应的Intent并发送广播来创建桌面快捷方式若笔记ID无效则提示用户输入内容。
sendBroadcast(sender);
} else {
/**
@ -856,9 +1034,13 @@ public class NoteEditActivity extends Activity implements OnClickListener,
}
}
// 此方法用于处理正在编辑的笔记内容文本去除其中特定的标记如选中、未选中标记并根据设定的最大长度限制SHORTCUT_ICON_TITLE_MAX_LEN对文本进行截断处理
// 最终返回处理后的适合作为桌面快捷方式图标的标题文本。
private String makeShortcutIconTitle(String content) {
content = content.replace(TAG_CHECKED, "");
content = content.replace(TAG_UNCHECKED, "");
// 判断处理后的内容文本长度是否大于设定的快捷方式图标标题最大长度SHORTCUT_ICON_TITLE_MAX_LEN如果大于则截取从开头到最大长度位置的子字符串作为最终结果
// 对文本进行截断处理,以满足长度限制要求;如果不大于,则直接返回原内容文本作为最终的快捷方式图标标题文本。
return content.length() > SHORTCUT_ICON_TITLE_MAX_LEN ? content.substring(0,
SHORTCUT_ICON_TITLE_MAX_LEN) : content;
}
@ -867,6 +1049,9 @@ public class NoteEditActivity extends Activity implements OnClickListener,
showToast(resId, Toast.LENGTH_SHORT);
}
// 此重载方法用于根据传入的提示信息对应的资源IDresId以及显示时长参数duration创建并显示一个Toast提示信息
// 通过调用Toast的makeText方法传入当前Activity的上下文this、提示信息资源ID以及显示时长然后调用show方法将Toast显示出来
// 用于在应用中向用户展示简短的提示信息,如操作成功、失败等提示内容。
private void showToast(int resId, int duration) {
Toast.makeText(this, resId, duration).show();
}

@ -37,22 +37,35 @@ import net.micode.notes.R;
import java.util.HashMap;
import java.util.Map;
// NoteEditText类继承自EditText是一个自定义的文本编辑视图类在基础的文本编辑功能上添加了一些自定义的交互逻辑和事件处理机制。
public class NoteEditText extends EditText {
// 用于日志记录的标签,方便在调试时识别该类输出的日志信息
private static final String TAG = "NoteEditText";
// 用于记录当前NoteEditText实例在一组编辑文本中的索引位置可能用于区分不同的编辑文本块等场景
private int mIndex;
// 记录在按下删除键KEYCODE_DEL之前文本选择的起始位置用于后续判断删除操作相关的逻辑
private int mSelectionStartBeforeDelete;
// 定义表示电话号码链接的协议头字符串,用于识别文本中是否包含电话号码链接
private static final String SCHEME_TEL = "tel:" ;
// 定义表示超链接HTTP协议的协议头字符串用于识别文本中是否包含网页链接
private static final String SCHEME_HTTP = "http:" ;
// 定义表示邮件链接的协议头字符串,用于识别文本中是否包含邮件链接
private static final String SCHEME_EMAIL = "mailto:" ;
// 创建一个HashMap用于存储不同协议头字符串与对应的资源ID的映射关系
// 资源ID可能对应着不同链接类型在界面上显示的提示字符串等信息方便后续根据链接类型获取相应的显示资源。
private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
// 静态代码块用于初始化sSchemaActionResMap将不同协议头字符串与对应的资源ID进行关联。
static {
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);
}
// 定义一个内部接口OnTextViewChangeListener用于与外部类进行交互通知外部关于文本编辑视图的一些重要事件变化
// 外部类需要实现该接口来响应这些事件。
/**
* Call by the {@link NoteEditActivity} to delete or add edit text
*/
@ -60,60 +73,88 @@ public class NoteEditText extends EditText {
/**
* Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
* and the text is null
* KEYCODE_DEL
* indexNoteEditTexttext
*/
void onEditTextDelete(int index, String text);
/**
/**
* Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
* happen
* KEYCODE_ENTER
* indexNoteEditTexttext
*/
void onEditTextEnter(int index, String text);
/**
/**
* Hide or show item option when text change
*
* indexNoteEditTexthasTexttruefalse
*/
void onTextChange(int index, boolean hasText);
}
// 用于存储实现了OnTextViewChangeListener接口的实例通过设置该实例使得外部类能够监听该文本编辑视图的相关事件变化。
private OnTextViewChangeListener mOnTextViewChangeListener;
// 构造方法接受一个Context参数用于创建NoteEditText实例调用父类EditText的构造方法进行初始化
// 同时将当前实例的索引mIndex初始化为0。
public NoteEditText(Context context) {
super(context, null);
mIndex = 0;
}
// 设置当前NoteEditText实例在一组编辑文本中的索引位置方便在事件处理等逻辑中区分不同的文本编辑区域。
public void setIndex(int index) {
mIndex = index;
}
// 设置用于监听文本编辑视图相关事件变化的监听器实例外部类实现OnTextViewChangeListener接口后通过传入该实例
// 使得本类能够在相应事件发生时通知外部类进行处理。
public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
mOnTextViewChangeListener = listener;
}
// 构造方法接受一个Context和一个AttributeSet参数用于创建NoteEditText实例
// 调用父类EditText带有特定样式属性android.R.attr.editTextStyle的构造方法进行初始化
// 该样式属性会应用默认的EditText样式到当前实例上。
public NoteEditText(Context context, AttributeSet attrs) {
super(context, attrs, android.R.attr.editTextStyle);
}
// 构造方法接受一个Context、AttributeSet和defStyle参数用于创建NoteEditText实例
// 调用父类EditText的构造方法进行初始化这里的TODO注释表示后续可能需要完善该构造方法的具体逻辑目前仅完成了基本的调用父类构造函数操作。
public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
// TODO Auto-generated constructor stub
}
// 重写onTouchEvent方法用于处理触摸事件。主要功能是在用户按下ACTION_DOWN屏幕时根据触摸点的位置来设置文本的选择位置。
// 通过一系列坐标计算,获取触摸点所在的文本行以及在该行中的水平偏移位置,进而将文本选择位置设置到对应的位置上,方便用户进行后续操作,
// 最后调用父类的onTouchEvent方法继续处理其他触摸相关的逻辑。
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
// 获取触摸点相对于视图左上角的X坐标
int x = (int) event.getX();
// 获取触摸点相对于视图左上角的Y坐标
int y = (int) event.getY();
// 减去视图左边的内边距,将坐标转换为相对于文本内容区域的坐标
x -= getTotalPaddingLeft();
// 减去视图上边的内边距,将坐标转换为相对于文本内容区域的坐标
y -= getTotalPaddingTop();
// 加上视图的水平滚动偏移量,考虑到文本内容可能存在滚动情况
x += getScrollX();
// 加上视图的垂直滚动偏移量,考虑到文本内容可能存在滚动情况
y += getScrollY();
// 获取当前文本的布局信息对象,用于后续根据坐标计算文本位置相关信息
Layout layout = getLayout();
// 根据触摸点的垂直坐标获取所在的文本行索引
int line = layout.getLineForVertical(y);
// 根据触摸点所在的文本行以及水平坐标获取对应的文本偏移位置(字符索引位置)
int off = layout.getOffsetForHorizontal(line, x);
// 将文本选择位置设置为计算得到的偏移位置,使得用户触摸到的位置对应的文本被选中
Selection.setSelection(getText(), off);
break;
}
@ -121,6 +162,9 @@ public class NoteEditText extends EditText {
return super.onTouchEvent(event);
}
// 重写onKeyDown方法用于处理按键按下事件。主要针对回车键KEYCODE_ENTER和删除键KEYCODE_DEL进行特殊处理
// 当按下回车键时如果设置了OnTextViewChangeListener监听器则直接返回false可能后续由外部决定是否处理回车键按下的逻辑
// 当按下删除键时,记录下当前文本选择的起始位置,以便后续在删除键抬起时判断相关删除逻辑,其他按键则按照父类默认逻辑处理。
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
switch (keyCode) {
@ -138,6 +182,12 @@ public class NoteEditText extends EditText {
return super.onKeyDown(keyCode, event);
}
// 重写onKeyUp方法用于处理按键抬起事件。针对删除键KEYCODE_DEL和回车键KEYCODE_ENTER进行特定逻辑处理
// 当删除键抬起时如果设置了OnTextViewChangeListener监听器并且当前文本选择起始位置为0且当前实例索引不为0可能表示删除当前文本块的情况
// 则调用监听器的onEditTextDelete方法通知外部进行删除操作并返回true表示已处理该事件
// 当回车键抬起时如果设置了OnTextViewChangeListener监听器则获取当前文本选择位置后的文本内容将当前文本内容截取到选择位置之前
// 然后调用监听器的onEditTextEnter方法通知外部添加新的编辑文本并传入相关参数最后返回父类的onKeyUp方法处理结果继续处理其他按键抬起相关逻辑。
@Override
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
switch(keyCode) {
@ -167,6 +217,9 @@ public class NoteEditText extends EditText {
return super.onKeyUp(keyCode, event);
}
// 重写onFocusChanged方法用于处理焦点变化事件。当焦点发生变化时如果设置了OnTextViewChangeListener监听器
// 根据当前是否失去焦点以及文本内容是否为空调用监听器的onTextChange方法通知外部进行相应的显示选项等逻辑处理
// 最后调用父类的onFocusChanged方法继续处理其他焦点变化相关逻辑。
@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
if (mOnTextViewChangeListener != null) {
@ -179,6 +232,12 @@ public class NoteEditText extends EditText {
super.onFocusChanged(focused, direction, previouslyFocusedRect);
}
// 重写onCreateContextMenu方法用于创建上下文菜单通常长按文本等操作时弹出
// 如果当前编辑文本内容是Spanned类型表示包含富文本信息比如链接等则获取当前文本选择区域内的URLSpan对象数组可能包含多个链接
// 如果只有一个链接则根据链接的URL判断其协议头如是否是tel、http、mailto等从sSchemaActionResMap中获取对应的资源ID
// 如果没有匹配的协议头则使用默认资源IDR.string.note_link_other然后创建一个菜单项添加到上下文菜单中
// 并设置菜单项的点击监听器当点击该菜单项时调用对应的URLSpan的onClick方法通常会触发相应的链接跳转等操作
// 最后调用父类的onCreateContextMenu方法继续添加其他默认的上下文菜单选项等操作。
@Override
protected void onCreateContextMenu(ContextMenu menu) {
if (getText() instanceof Spanned) {

@ -25,8 +25,9 @@ import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.tool.DataUtils;
// NoteItemData类用于封装笔记相关的数据信息从数据库查询结果Cursor中提取并整理数据同时提供了一些方法用于获取和判断这些数据的相关属性。
public class NoteItemData {
// 定义一个字符串数组用于指定从数据库查询笔记相关信息时需要获取的列名涵盖了笔记的各种属性如ID、提醒日期、背景颜色ID、创建日期等等。
static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.ALERTED_DATE,
@ -42,6 +43,7 @@ public class NoteItemData {
NoteColumns.WIDGET_TYPE,
};
// 定义一系列常量用于表示各个数据列在查询结果的Cursor中的索引位置方便后续从Cursor中准确获取对应的数据提高代码的可读性和可维护性。
private static final int ID_COLUMN = 0;
private static final int ALERTED_DATE_COLUMN = 1;
private static final int BG_COLOR_ID_COLUMN = 2;
@ -55,14 +57,249 @@ public class NoteItemData {
private static final int WIDGET_ID_COLUMN = 10;
private static final int WIDGET_TYPE_COLUMN = 11;
// 笔记的唯一标识符存储从数据库获取的笔记ID值。
private long mId;
// 笔记的提醒日期存储对应的时间戳信息若没有提醒则可能为0等特定值。
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;
// 标记当前笔记数据对应的记录是否是查询结果中的最后一项通过在构造方法中根据Cursor判断并赋值。
private boolean mIsLastItem;
// 标记当前笔记数据对应的记录是否是查询结果中的第一项通过在构造方法中根据Cursor判断并赋值。
private boolean mIsFirstItem;
// 标记查询结果中是否只有一条记录即当前笔记数据是否是唯一的一条记录通过在构造方法中根据Cursor记录数量判断并赋值。
private boolean mIsOnlyOneItem;
// 标记当前笔记是否是某个文件夹后面仅跟随的一条笔记(根据笔记类型以及前后记录的情况判断),通过在构造方法中特定逻辑判断并赋值。
private boolean mIsOneNoteFollowingFolder;
// 标记当前笔记是否是某个文件夹后面跟随的多条笔记中的一条(根据笔记类型以及前后记录的情况判断),通过在构造方法中特定逻辑判断并赋值。
private boolean mIsMultiNotesFollowingFolder;
// 构造方法接受上下文环境Context和一个Cursor对象作为参数用于从Cursor中提取并初始化笔记相关的数据信息同时进行一些额外的逻辑判断和数据处理。
public NoteItemData(Context context, Cursor cursor) {
// 从Cursor中获取笔记的ID值并赋值给成员变量mId。
mId = cursor.getLong(ID_COLUMN);
// 从Cursor中获取笔记的提醒日期时间戳并赋值给成员变量mAlertDate。
mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
// 从Cursor中获取笔记的背景颜色ID并赋值给成员变量mBgColorId。
mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
// 从Cursor中获取笔记的创建日期时间戳并赋值给成员变量mCreatedDate。
mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN);
// 根据从Cursor中获取的表示是否有附件的整数值转换为布尔类型赋值给mHasAttachment大于0表示有附件设为true否则为false。
mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0)? true : false;
// 从Cursor中获取笔记的最后修改日期时间戳并赋值给成员变量mModifiedDate。
mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN);
// 从Cursor中获取笔记相关的数量信息如子笔记数量等并赋值给成员变量mNotesCount。
mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
// 从Cursor中获取笔记的父级ID并赋值给成员变量mParentId。
mParentId = cursor.getLong(PARENT_ID_COLUMN);
// 从Cursor中获取笔记的摘要信息字符串赋值给成员变量mSnippet并进行特定字符串替换操作去除可能存在的一些标记字符串如NoteEditActivity.TAG_CHECKED和NoteEditActivity.TAG_UNCHECKED
mSnippet = cursor.getString(SNIPPET_COLUMN);
mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
NoteEditActivity.TAG_UNCHECKED, "");
// 从Cursor中获取笔记的类型整数值并赋值给成员变量mType。
mType = cursor.getInt(TYPE_COLUMN);
// 从Cursor中获取笔记关联的小部件ID并赋值给成员变量mWidgetId。
mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
// 从Cursor中获取笔记关联的小部件类型整数值并赋值给成员变量mWidgetType。
mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
// 初始化电话号码为空字符串,后续根据笔记所属文件夹情况判断是否获取实际电话号码。
mPhoneNumber = "";
// 如果笔记的父级ID等于特定的通话记录文件夹IDNotes.ID_CALL_RECORD_FOLDER则尝试从数据中获取对应的电话号码。
if (mParentId == Notes.ID_CALL_RECORD_FOLDER) {
mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId);
// 如果获取到的电话号码不为空字符串,尝试通过电话号码获取对应的联系人姓名。
if (!TextUtils.isEmpty(mPhoneNumber)) {
mName = Contact.getContact(context, mPhoneNumber);
// 如果获取联系人姓名失败返回null则将电话号码作为联系人姓名显示可能是一种兜底处理方式
if (mName == null) {
mName = mPhoneNumber;
}
}
}
// 如果联系人姓名仍为null可能前面获取过程都失败了则将其设置为空字符串确保该成员变量有合理的默认值。
if (mName == null) {
mName = "";
}
// 调用checkPostion方法根据Cursor的相关信息判断并设置当前笔记数据在查询结果中的位置相关属性如是否是第一项、最后一项等以及与文件夹关联的笔记数量情况等属性。
checkPostion(cursor);
}
// 私有方法用于根据Cursor的相关信息判断并设置当前笔记数据在查询结果中的位置相关属性如是否是第一项、最后一项等以及与文件夹关联的笔记数量情况等属性。
private void checkPostion(Cursor cursor) {
// 根据Cursor的isLast方法判断当前记录是否是最后一项将结果赋值给mIsLastItem成员变量。
mIsLastItem = cursor.isLast()? true : false;
// 根据Cursor的isFirst方法判断当前记录是否是第一项将结果赋值给mIsFirstItem成员变量。
mIsFirstItem = cursor.isFirst()? true : false;
// 根据Cursor的记录数量判断是否只有一条记录将结果赋值给mIsOnlyOneItem成员变量。
mIsOnlyOneItem = (cursor.getCount() == 1);
// 初始设置为当前笔记不是某个文件夹后面跟随的多条笔记中的一条,后续根据具体逻辑判断是否更改该值。
mIsMultiNotesFollowingFolder = false;
// 初始设置为当前笔记不是某个文件夹后面仅跟随的一条笔记,后续根据具体逻辑判断是否更改该值。
mIsOneNoteFollowingFolder = false;
// 如果笔记类型是普通笔记Notes.TYPE_NOTE并且不是第一项记录说明前面可能有其他记录则进行以下判断逻辑。
if (mType == Notes.TYPE_NOTE &&!mIsFirstItem) {
// 获取当前记录在Cursor中的位置索引。
int position = cursor.getPosition();
// 将Cursor指针移动到前一条记录用于查看前一条记录的类型等信息
if (cursor.moveToPrevious()) {
// 判断前一条记录的类型是否是文件夹类型Notes.TYPE_FOLDER或者系统类型Notes.TYPE_SYSTEM如果是则说明当前笔记可能与文件夹存在关联情况继续后续判断。
if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
|| cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
// 判断Cursor的总记录数是否大于当前位置索引加1即当前笔记后面是否还有其他记录如果是则说明当前笔记是某个文件夹后面跟随的多条笔记中的一条设置相应标记为true。
if (cursor.getCount() > (position + 1)) {
mIsMultiNotesFollowingFolder = true;
} else {
// 否则说明当前笔记是某个文件夹后面仅跟随的一条笔记设置相应标记为true。
mIsOneNoteFollowingFolder = true;
}
}
// 将Cursor指针再移回原来的位置确保后续操作不受影响因为前面移动了指针如果移动失败则抛出异常表示出现了不合理的游标操作情况
if (!cursor.moveToNext()) {
throw new IllegalStateException("cursor move to previous but can't move back");
}
}
}
}
// 判断当前笔记是否是某个文件夹后面仅跟随的一条笔记,返回对应的布尔值。
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;
}
// 判断笔记是否有附件,返回对应的布尔值。
public boolean hasAttachment() {
return mHasAttachment;
}
// 获取笔记的最后修改日期时间戳,返回对应的长整数值。
public long getModifiedDate() {
return mModifiedDate;
}
// 获取笔记的背景颜色ID返回对应的整数值。
public int getBgColorId() {
return mBgColorId;
}
// 获取笔记的父级ID返回对应的长整数值。
public long getParentId() {
return mParentId;
}
// 获取笔记相关的数量信息(如子笔记数量等),返回对应的整数值。
public int getNotesCount() {
return mNotesCount;
}
// 获取笔记所属文件夹的ID与getParentId方法返回值相同可能为了语义更清晰在不同场景使用返回对应的长整数值。
public long getFolderId () {
return mParentId;
}
// 获取笔记的类型(如普通笔记、文件夹类型等,根据业务逻辑定义的类型值),返回对应的整数值。
public int getType() {
return mType;
}
// 获取笔记关联的小部件类型(根据业务逻辑定义的不同小部件类型值),返回对应的整数值。
public int getWidgetType() {
return mWidgetType;
}
// 获取笔记关联的小部件ID返回对应的整数值。
public int getWidgetId() {
return mWidgetId;
}
// 获取笔记的摘要信息字符串,返回对应的字符串内容。
public String getSnippet() {
return mSnippet;
}
// 判断笔记是否设置了提醒通过提醒日期是否大于0来判断返回对应的布尔值。
public boolean hasAlert() {
return (mAlertDate > 0);
}
// 判断笔记是否属于通话记录通过父级ID是否是通话记录文件夹ID以及电话号码是否为空来判断返回对应的布尔值。
public boolean isCallRecord() {
return (mParentId == Notes.ID_CALL_RECORD_FOLDER &&!TextUtils.isEmpty(mPhoneNumber));
}
// 静态方法用于从给定的Cursor中获取笔记的类型通过获取对应类型列的整数值返回对应的整数值方便在其他地方直接获取笔记类型信息而无需创建NoteItemData实例。
public static int getNoteType(Cursor cursor) {
return cursor.getInt(TYPE_COLUMN);
}
}
NoteItemData NoteColumnsNotesDataUtilsContactNoteEditActivity
private String mSnippet;
private int mType;
private int mWidgetId;

@ -147,6 +147,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
setAppInfoFromRawRes();
}
// 当启动的其他Activity返回结果时调用此方法用于处理返回的结果数据根据请求码requestCode和结果码resultCode来执行相应的逻辑。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (resultCode == RESULT_OK
@ -157,6 +158,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
}
// 此方法用于从原始资源文件可能是文本文件等中读取应用的介绍信息并将其保存为一条笔记记录同时将一个表示是否已添加介绍信息的共享偏好设置项设置为true
// 用于标记已经完成了首次使用时介绍信息的插入操作,下次启动应用时就不会重复执行此操作。
private void setAppInfoFromRawRes() {
SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(this);
if (!sp.getBoolean(PREFERENCE_ADD_INTRODUCTION, false)) {
@ -190,6 +193,9 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
}
// 创建一个空的WorkingNote对象通过调用WorkingNote的createEmptyNote静态方法传入当前Activity的上下文this、根文件夹IDNotes.ID_ROOT_FOLDER
// 无效的桌面小部件IDAppWidgetManager.INVALID_APPWIDGET_ID、无效的小部件类型Notes.TYPE_WIDGET_INVALIDE以及默认的颜色资源ResourceParser.RED等参数
// 用于构建一个初始的笔记对象,准备保存介绍信息到该笔记中。
WorkingNote note = WorkingNote.createEmptyNote(this, Notes.ID_ROOT_FOLDER,
AppWidgetManager.INVALID_APPWIDGET_ID, Notes.TYPE_WIDGET_INVALIDE,
ResourceParser.RED);
@ -210,7 +216,12 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
private void initResources() {
// 获取系统的内容解析器ContentResolver通过调用当前Activity的 `getContentResolver` 方法,
// 内容解析器用于与应用的内容提供器Content Provider交互可对数据库等数据源进行查询、插入、更新、删除等操作
// 在这里可能用于后续查询笔记数据等相关操作。
mContentResolver = this.getContentResolver();
// 创建一个 `BackgroundQueryHandler` 实例,传入刚才获取的内容解析器,这个类可能是自定义的用于在后台线程处理查询操作的处理器,
// 以便在执行一些耗时的数据查询等操作时,不会阻塞主线程,保证界面的流畅性。
mBackgroundQueryHandler = new BackgroundQueryHandler(this.getContentResolver());
mCurrentFolderId = Notes.ID_ROOT_FOLDER;
mNotesListView = (ListView) findViewById(R.id.notes_list);
@ -232,8 +243,11 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
private class ModeCallback implements ListView.MultiChoiceModeListener, OnMenuItemClickListener {
// 定义一个 `DropdownMenu` 类型的成员变量,用于展示下拉菜单,可能包含一些与多选操作相关的额外功能选项,
// 具体功能和样式由 `DropdownMenu` 类的实现决定,比如全选、反选等操作可能会放在这个下拉菜单中。
private DropdownMenu mDropDownMenu;
private ActionMode mActionMode;
// 当进入多选操作模式时(例如用户长按 `ListView` 中的某个项后进入多选模式),会调用此方法来创建操作菜单等初始化操作。
private MenuItem mMoveMenu;
public boolean onCreateActionMode(ActionMode mode, Menu menu) {
@ -252,6 +266,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
mNotesListView.setLongClickable(false);
mAddNewNote.setVisibility(View.GONE);
// 通过 `LayoutInflater` 从当前Activity的上下文NotesListActivity.this这里使用外部类名来明确上下文加载一个布局资源R.layout.note_list_dropdown_menu创建一个视图
// 这个视图将作为操作模式的自定义视图,用于展示一些额外的操作界面元素,比如上述提到的下拉菜单等内容。
View customView = LayoutInflater.from(NotesListActivity.this).inflate(
R.layout.note_list_dropdown_menu, null);
mode.setCustomView(customView);
@ -262,6 +278,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
public boolean onMenuItemClick(MenuItem item) {
mNotesListAdapter.selectAll(!mNotesListAdapter.isAllSelected());
updateMenu();
// 返回 `true` 表示操作模式创建成功,系统可以继续进行后续的多选模式相关操作,比如显示操作菜单等。
return true;
}
@ -286,6 +303,10 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
}
// 此方法是 `ListView.MultiChoiceModeListener` 接口中的方法,当用户在多选操作模式下点击了操作菜单中的某个菜单项时会被调用,
// 开发者需要在此方法中编写逻辑来处理不同菜单项点击对应的具体业务操作,比如点击“删除”菜单项执行删除选中笔记的操作等。
// 目前方法体中是自动生成的 `TODO` 注释,意味着还需要根据实际需求添加相应的业务逻辑代码来处理菜单项点击事件,
// 返回值为 `false`,同样按照接口的默认约定,如果返回 `false` 可能表示未处理该点击事件(具体也要看使用场景和框架的要求)。
public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
// TODO Auto-generated method stub
return false;
@ -296,12 +317,16 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
return false;
}
// 此方法是 `ListView.MultiChoiceModeListener` 接口中的方法,当多选操作模式被销毁(例如用户按下返回键或者完成多选操作等情况退出多选模式)时会被调用,
// 用于在操作模式结束后进行一些清理和恢复界面初始状态的操作。
public void onDestroyActionMode(ActionMode mode) {
mNotesListAdapter.setChoiceMode(false);
mNotesListView.setLongClickable(true);
mAddNewNote.setVisibility(View.VISIBLE);
}
// 此方法用于手动结束当前的操作模式,通过调用 `mActionMode`(在 `onCreateActionMode` 方法中初始化的 `ActionMode` 对象)的 `finish` 方法来实现,
// 触发操作模式的销毁流程,会进而调用 `onDestroyActionMode` 等相关方法进行后续的清理和界面恢复操作。
public void finishActionMode() {
mActionMode.finish();
}
@ -313,10 +338,17 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
public boolean onMenuItemClick(MenuItem item) {
// 调用 `NotesListAdapter` 的 `setCheckedItem` 方法,传入发生选中状态改变的列表项的位置(`position`)以及新的选中状态(`checked`)参数,
// 适配器内部会根据这些信息更新其内部记录的选中项相关的数据结构,以便准确统计选中的数量、判断是否全选等情况。
// 此方法实现了 `OnMenuItemClickListener` 接口,用于处理菜单项点击事件,当用户点击了设置了此点击监听器的菜单项时会被调用,
// 在这里主要用于判断当前是否有选中的笔记项,如果没有选中任何笔记项,显示一个提示 `Toast`,告知用户需要先选择笔记项才能进行操作,并返回 `true` 表示已处理该点击事件,
// 避免事件继续向上传递导致其他不必要的处理逻辑执行。
if (mNotesListAdapter.getSelectedCount() == 0) {
Toast.makeText(NotesListActivity.this, getString(R.string.menu_select_none),
Toast.LENGTH_SHORT).show();
return true;
// 如果有选中的笔记项,这里后续应该添加具体的业务逻辑代码来处理不同菜单项点击对应的操作,目前代码没有完整实现这部分逻辑,需要开发者进一步补充完善。
// 返回值目前未明确设定,按正常逻辑应该根据具体业务处理情况返回 `true`(表示已处理)或 `false`(表示未处理)相应的点击事件。
}
switch (item.getItemId()) {
@ -343,14 +375,21 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
return false;
}
return true;
// 如果成功处理了对应的菜单项点击事件(即点击的是“删除”或“移动”菜单项并执行了相应的逻辑),则返回 `true`
// 表示已经处理了该点击操作,通常可以告知调用者或者框架不需要再对该点击事件进行其他额外处理了。
return true;
}
}
private class NewNoteOnTouchListener implements OnTouchListener {
// 重写 `OnTouchListener` 接口中的 `onTouch` 方法,当触摸事件发生在绑定了此监听器的视图(这里是 `mAddNewNote` 按钮对应的视图 `v`)上时,该方法会被调用,
// 并传入触摸事件相关的信息(视图 `v` 和 `MotionEvent` 对象 `event`),根据触摸事件的不同类型(如按下、移动、抬起等)来执行相应的逻辑处理,返回值表示是否消费了该触摸事件(`true` 表示消费,`false` 表示未消费,事件可能会继续传递)。
public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN: {
// 获取当前设备屏幕的默认显示对象,通过调用 `getWindowManager().getDefaultDisplay()` 方法,
// 用于后续获取屏幕相关的尺寸信息等操作,例如屏幕的高度、宽度等,不同设备的屏幕显示属性可能不同,这里获取默认的显示配置。
Display display = getWindowManager().getDefaultDisplay();
int screenHeight = display.getHeight();
int newNoteViewHeight = mAddNewNote.getHeight();
@ -404,6 +443,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
}
return false;
// 如果触摸事件没有在上述任何一个 `switch` 分支中被消费(即没有返回 `true`),则返回 `false`,表示当前监听器没有处理该触摸事件,
// 触摸事件可能会继续向上传递给其他的触摸监听器或者父视图等进行处理,具体行为取决于整个视图层级的触摸事件传递机制。
}
};
@ -416,7 +457,20 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
String.valueOf(mCurrentFolderId)
}, NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC");
}
// `FOLDER_NOTE_LIST_QUERY_TOKEN`是一个自定义的查询令牌Token用于标识此次查询的类型方便在查询完成后根据这个令牌来区分不同的查询结果并进行相应处理
// 例如在 `onQueryComplete` 方法中会通过这个令牌判断是哪个查询任务完成了。
// `null`是一个可以传递给查询处理器的额外对象通常称为Cookie在这里没有使用所以传入 `null`,如果有需要可以传入一个自定义的对象,
// 在查询完成后的回调中可以获取到这个对象进行一些额外的相关操作(具体取决于业务逻辑需求)。
// `Notes.CONTENT_NOTE_URI`应该是一个定义好的表示笔记内容的内容提供者Content Provider的统一资源标识符URI
// 指明了要从哪里查询笔记数据,也就是告诉系统要去哪个数据源(通常是数据库对应的内容提供者)查询相应的笔记信息。
// `NoteItemData.PROJECTION`:是一个字符串数组,定义了查询结果中要返回的列名,也就是指定了从数据库中查询笔记数据时,具体要获取哪些字段的信息,
// 例如可能包含笔记的标题、内容、创建时间等字段,只获取需要的字段可以提高查询效率,减少不必要的数据传输和处理。
// `selection`:就是前面根据当前文件夹情况确定的查询筛选条件字符串,用于在数据库中筛选出符合条件的笔记记录,比如筛选出某个文件夹下的笔记等。
// `new String[] { String.valueOf(mCurrentFolderId) }`:是一个字符串数组,用于给查询筛选条件中的占位符(通常在 `selection` 字符串中用 `?` 表示)赋值,
// 在这里将当前文件夹的ID转换为字符串后放入数组中传递给查询操作使得筛选条件能够准确地基于当前文件夹ID进行筛选例如筛选出父ID等于当前文件夹ID的笔记。
// `NoteColumns.TYPE + " DESC," + NoteColumns.MODIFIED_DATE + " DESC"`:是一个排序规则字符串,指定了查询结果按照笔记的类型(`NoteColumns.TYPE`)降序排列,
// 并且在类型相同的情况下,按照修改日期(`NoteColumns.MODIFIED_DATE`)降序排列,这样查询出来的笔记列表数据在展示时会按照特定的顺序呈现给用户,
// 比如先展示某种特定类型的最新修改的笔记等情况。
private final class BackgroundQueryHandler extends AsyncQueryHandler {
public BackgroundQueryHandler(ContentResolver contentResolver) {
super(contentResolver);
@ -460,6 +514,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
});
builder.show();
// 最后调用 `builder` 对象的 `show` 方法,将构建好的包含文件夹列表的对话框显示在界面上,让用户可以进行文件夹选择操作,
// 根据用户的选择执行相应的业务逻辑,实现将笔记移动到所选文件夹等功能。
}
private void createNewNote() {
@ -555,6 +611,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
mTitleBar.setText(data.getSnippet());
}
mTitleBar.setVisibility(View.VISIBLE);
// 创建一个意图Intent对象用于启动一个新的Activity指定要启动的Activity类为 `NoteEditActivity.class`
// 意味着点击相应按钮或者触发相关操作后,系统将启动 `NoteEditActivity` 这个Activity让用户可以在其中查看和编辑指定的笔记。
}
public void onClick(View v) {
@ -563,9 +621,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
createNewNote();
break;
default:
// 向意图中添加额外的数据信息,通过 `putExtra` 方法,将笔记的唯一标识符(`data.getId()`,这里的 `data` 应该是包含笔记相关信息的对象,通过其 `getId` 方法获取笔记ID添加进去键为 `Intent.EXTRA_UID`
// 这样在 `NoteEditActivity` 中可以获取到这个参数根据笔记ID从数据库等数据源查询并加载相应的笔记数据进行展示和编辑操作。
break;
}
}
// 使用当前Activity`this`启动刚才创建的意图对应的Activity并传入请求码 `REQUEST_CODE_OPEN_NODE`
// 请求码用于在 `onActivityResult` 方法中区分不同的启动Activity返回的结果这里特定的请求码`REQUEST_CODE_OPEN_NODE`)表示是打开已有笔记这个操作返回的结果,
// 启动后,用户将进入 `NoteEditActivity` 查看和编辑指定的笔记完成后会返回到当前Activity可在 `onActivityResult` 方法中处理返回的相关数据和结果。
private void showSoftInput() {
InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
@ -578,11 +641,14 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
InputMethodManager inputMethodManager = (InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE);
inputMethodManager.hideSoftInputFromWindow(view.getWindowToken(), 0);
}
// 此方法用于显示一个创建或修改文件夹的对话框,根据传入的参数 `create` 判断是创建还是修改操作,在对话框中进行相应的界面设置、事件监听以及数据处理逻辑,
// 比如设置标题、按钮文本、文本框初始内容等,并且处理用户点击确定和取消按钮的操作,包括验证文件夹名称的合法性、执行插入或更新文件夹数据等操作。
private void showCreateOrModifyFolderDialog(final boolean create) {
final AlertDialog.Builder builder = new AlertDialog.Builder(this);
View view = LayoutInflater.from(this).inflate(R.layout.dialog_edit_text, null);
final EditText etName = (EditText) view.findViewById(R.id.et_foler_name);
// 此方法用于显示一个创建或修改文件夹的对话框,根据传入的参数 `create` 判断是创建还是修改操作,在对话框中进行相应的界面设置、事件监听以及数据处理逻辑,
// 比如设置标题、按钮文本、文本框初始内容等,并且处理用户点击确定和取消按钮的操作,包括验证文件夹名称的合法性、执行插入或更新文件夹数据等操作。
showSoftInput();
if (!create) {
if (mFocusNoteDataItem != null) {
@ -596,7 +662,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
etName.setText("");
builder.setTitle(this.getString(R.string.menu_create_folder));
}
// 此方法用于显示一个创建或修改文件夹的对话框,根据传入的参数 `create` 判断是创建还是修改操作,在对话框中进行相应的界面设置、事件监听以及数据处理逻辑,
// 比如设置标题、按钮文本、文本框初始内容等,并且处理用户点击确定和取消按钮的操作,包括验证文件夹名称的合法性、执行插入或更新文件夹数据等操作。
builder.setPositiveButton(android.R.string.ok, null);
builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
@ -608,7 +675,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
final Button positive = (Button)dialog.findViewById(android.R.id.button1);
positive.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
hideSoftInput(etName);
hideSoftInput(etName);// 此方法用于显示一个创建或修改文件夹的对话框,根据传入的参数 `create` 判断是创建还是修改操作,在对话框中进行相应的界面设置、事件监听以及数据处理逻辑,
// 比如设置标题、按钮文本、文本框初始内容等,并且处理用户点击确定和取消按钮的操作,包括验证文件夹名称的合法性、执行插入或更新文件夹数据等操作。
String name = etName.getText().toString();
if (DataUtils.checkVisibleFolderName(mContentResolver, name)) {
Toast.makeText(NotesListActivity.this, getString(R.string.folder_exist, name),
@ -639,6 +707,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
if (TextUtils.isEmpty(etName.getText())) {
positive.setEnabled(false);
// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
}
/**
* When the name edit text is null, disable the positive button
@ -648,7 +718,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
// TODO Auto-generated method stub
}
// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
public void onTextChanged(CharSequence s, int start, int before, int count) {
if (TextUtils.isEmpty(etName.getText())) {
positive.setEnabled(false);
@ -662,7 +733,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
});
}
}// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
@Override
public void onBackPressed() {
@ -686,7 +758,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
default:
break;
}
}
}// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
private void updateWidget(int appWidgetId, int appWidgetType) {
Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);
@ -706,7 +779,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
sendBroadcast(intent);
setResult(RESULT_OK, intent);
}
// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
private final OnCreateContextMenuListener mFolderOnCreateContextMenuListener = new OnCreateContextMenuListener() {
public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) {
if (mFocusNoteDataItem != null) {
@ -715,7 +789,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
menu.add(0, MENU_FOLDER_DELETE, 0, R.string.menu_folder_delete);
menu.add(0, MENU_FOLDER_CHANGE_NAME, 0, R.string.menu_folder_change_name);
}
}
}// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
};
@Override
@ -758,7 +833,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
return true;
}
}// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
@Override
public boolean onPrepareOptionsMenu(Menu menu) {
@ -777,7 +853,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
return true;
}
// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
@Override
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
@ -817,13 +894,15 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
return true;
}
// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
@Override
public boolean onSearchRequested() {
startSearch(null, false, null /* appData */, false);
return true;
}
// 调用输入方法管理器的 `hideSoftInputFromWindow` 方法来隐藏软键盘,传入参数 `view.getWindowToken()`,它代表与指定视图(`view`)关联的窗口令牌,
// 用于标识要操作的软键盘所属的窗口,第二个参数 `0` 表示隐藏软键盘的相关选项(这里 `0` 通常表示默认的隐藏方式,不进行额外的特殊处理)。
private void exportNoteToText() {
final BackupUtils backup = BackupUtils.getInstance(NotesListActivity.this);
new AsyncTask<Void, Void, Integer>() {
@ -875,7 +954,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
Intent intent = new Intent(from, NotesPreferenceActivity.class);
from.startActivityIfNeeded(intent, -1);
}
// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
private class OnListItemClickListener implements OnItemClickListener {
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
@ -916,7 +996,8 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt
}
}
// 获取系统的输入方法管理器InputMethodManager实例通过调用 `getSystemService` 方法传入 `Context.INPUT_METHOD_SERVICE` 作为服务类型标识来获取,
// 该管理器用于控制软键盘的显示、隐藏等相关操作,是与系统输入方法交互的重要组件。
private void startQueryDestinationFolders() {
String selection = NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>? AND " + NoteColumns.ID + "<>?";
selection = (mState == ListEditState.NOTE_LIST) ? selection:

@ -32,56 +32,82 @@ import java.util.Iterator;
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;
// 内部类用于封装与应用小部件相关的属性如小部件的ID和类型
public static class AppWidgetAttribute {
public int widgetId;
public int widgetType;
};
// 构造函数,接收一个上下文对象,初始化一些成员变量
public NotesListAdapter(Context context) {
// 调用父类CursorAdapter的构造函数传入上下文和初始化为null的游标
super(context, null);
// 创建一个新的HashMap用于存储选中状态信息
mSelectedIndex = new HashMap<Integer, Boolean>();
mContext = context;
mNotesCount = 0;
}
// 创建一个新的视图View对象用于显示列表中的一项数据
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
// 创建并返回一个NotesListItem类型的视图该视图应该是用于展示笔记列表项的自定义视图
return new NotesListItem(context);
}
// 将数据绑定到给定的视图上,用于显示具体的数据内容
@Override
public void bindView(View view, Context context, Cursor cursor) {
// 判断视图是否是NotesListItem类型的实例
if (view instanceof NotesListItem) {
// 根据给定的上下文和游标创建一个NoteItemData对象用于获取笔记相关的数据
NoteItemData itemData = new NoteItemData(context, cursor);
// 调用NotesListItem的bind方法将相关数据、选择模式状态以及该项是否被选中的信息传递进去进行数据绑定显示等操作
((NotesListItem) view).bind(context, itemData, mChoiceMode,
isSelectedItem(cursor.getPosition()));
}
}
// 设置指定位置的项的选中状态
public void setCheckedItem(final int position, final boolean checked) {
// 将指定位置的选中状态存入mSelectedIndex映射表中
mSelectedIndex.put(position, checked);
// 通知数据集已发生改变以便相关的UI组件如ListView等能相应地更新显示
notifyDataSetChanged();
}
// 判断是否处于选择模式
public boolean isInChoiceMode() {
return mChoiceMode;
}
// 设置选择模式,同时清空之前的选中状态记录
public void setChoiceMode(boolean mode) {
mSelectedIndex.clear();
mChoiceMode = mode;
}
// 全选或全不选所有符合条件笔记类型为Notes.TYPE_NOTE的项
public void selectAll(boolean checked) {
// 获取当前游标对象,用于遍历数据
Cursor cursor = getCursor();
// 遍历数据集的每一项
for (int i = 0; i < getCount(); i++) {
// 将游标移动到指定位置
if (cursor.moveToPosition(i)) {
// 判断该项对应的笔记类型是否为Notes.TYPE_NOTE如果是则设置其选中状态
if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
setCheckedItem(i, checked);
}
@ -89,14 +115,21 @@ public class NotesListAdapter extends CursorAdapter {
}
}
// 获取所有已选中项的ID存储在一个HashSet中返回
public HashSet<Long> getSelectedItemIds() {
// 创建一个用于存储已选中项ID的HashSet对象
HashSet<Long> itemSet = new HashSet<Long>();
// 遍历mSelectedIndex中记录的所有位置
for (Integer position : mSelectedIndex.keySet()) {
// 如果该位置对应的项是被选中的
if (mSelectedIndex.get(position) == true) {
// 获取该项对应的ID
Long id = getItemId(position);
// 如果ID是Notes.ID_ROOT_FOLDER可能是一个特殊的、不符合预期的ID则在日志中记录错误信息通常表示不应该出现这种情况
if (id == Notes.ID_ROOT_FOLDER) {
Log.d(TAG, "Wrong item id, should not happen");
} else {
// 将符合条件的ID添加到HashSet中
itemSet.add(id);
}
}
@ -105,21 +138,32 @@ public class NotesListAdapter extends CursorAdapter {
return itemSet;
}
// 获取所有已选中的应用小部件相关属性信息存储在一个HashSet中返回
public HashSet<AppWidgetAttribute> getSelectedWidget() {
// 创建一个用于存储已选中小部件属性的HashSet对象
HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
// 遍历mSelectedIndex中记录的所有位置
for (Integer position : mSelectedIndex.keySet()) {
// 如果该位置对应的项是被选中的
if (mSelectedIndex.get(position) == true) {
// 获取对应位置的数据项(游标形式)
Cursor c = (Cursor) getItem(position);
if (c != null) {
// 创建一个AppWidgetAttribute对象用于存储小部件相关属性
AppWidgetAttribute widget = new AppWidgetAttribute();
// 根据游标创建一个NoteItemData对象用于获取小部件相关的数据
NoteItemData item = new NoteItemData(mContext, c);
// 设置小部件的ID属性
widget.widgetId = item.getWidgetId();
// 设置小部件的类型属性
widget.widgetType = item.getWidgetType();
// 将封装好的小部件属性对象添加到HashSet中
itemSet.add(widget);
/**
* Don't close cursor here, only the adapter could close it
*
*/
} else {
// 如果游标为空,记录错误日志信息,表示游标无效
Log.e(TAG, "Invalid cursor");
return null;
}
@ -128,13 +172,18 @@ public class NotesListAdapter extends CursorAdapter {
return itemSet;
}
// 获取已选中项的数量
public int getSelectedCount() {
// 获取mSelectedIndex中所有值即每个位置对应的选中状态布尔值的集合
Collection<Boolean> values = mSelectedIndex.values();
// 如果集合为空可能没有任何选中记录等情况返回0
if (null == values) {
return 0;
}
// 获取集合的迭代器,用于遍历集合中的元素(布尔值)
Iterator<Boolean> iter = values.iterator();
int count = 0;
// 遍历集合中的每个布尔值元素如果为true表示该项被选中数量加1
while (iter.hasNext()) {
if (true == iter.next()) {
count++;
@ -143,30 +192,39 @@ public class NotesListAdapter extends CursorAdapter {
return count;
}
// 判断是否所有项都被选中
public boolean isAllSelected() {
// 获取已选中项的数量
int checkedCount = getSelectedCount();
// 如果选中数量不为0有选中项且选中数量等于笔记的总数量说明所有项都被选中了返回true否则返回false
return (checkedCount != 0 && checkedCount == mNotesCount);
}
// 判断指定位置的项是否被选中
public boolean isSelectedItem(final int position) {
// 如果该位置对应的选中状态记录为null可能还未设置等情况则返回false表示未选中
if (null == mSelectedIndex.get(position)) {
return false;
}
// 返回该位置对应的实际选中状态(布尔值)
return mSelectedIndex.get(position);
}
// 当内容发生改变时调用的方法这里调用了calcNotesCount方法来重新计算笔记数量
@Override
protected void onContentChanged() {
super.onContentChanged();
calcNotesCount();
}
// 当游标发生改变时调用的方法同样调用calcNotesCount方法来重新计算笔记数量
@Override
public void changeCursor(Cursor cursor) {
super.changeCursor(cursor);
calcNotesCount();
}
// 计算笔记的数量遍历数据集统计符合条件笔记类型为Notes.TYPE_NOTE的项的数量
private void calcNotesCount() {
mNotesCount = 0;
for (int i = 0; i < getCount(); i++) {

@ -37,85 +37,133 @@ public class NotesListItem extends LinearLayout {
private TextView mCallName;
private NoteItemData mItemData;
private CheckBox mCheckBox;
// NotesListItem类的构造函数用于初始化该列表项相关的视图组件
public NotesListItem(Context context) {
// 调用父类(应该是某个视图类的构造函数,传递上下文对象进行初始化)
super(context);
// 从给定的布局资源R.layout.note_item中加载视图层次结构并将其填充到当前的视图this
inflate(context, R.layout.note_item, this);
// 通过ID查找并获取布局中的ImageView组件用于显示提醒图标等ID为R.id.iv_alert_icon
mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
// 通过ID查找并获取布局中的TextView组件用于显示标题内容ID为R.id.tv_title
mTitle = (TextView) findViewById(R.id.tv_title);
// 通过ID查找并获取布局中的TextView组件用于显示时间相关信息ID为R.id.tv_time
mTime = (TextView) findViewById(R.id.tv_time);
// 通过ID查找并获取布局中的TextView组件用于显示呼叫名称相关信息ID为R.id.tv_name
mCallName = (TextView) findViewById(R.id.tv_name);
// 通过安卓系统内置的IDandroid.R.id.checkbox查找并获取布局中的CheckBox组件用于表示该项是否被选中
mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
}
// 用于将数据绑定到该列表项视图上,根据不同的数据情况设置视图的显示内容和状态
public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
// 如果处于选择模式choiceMode为true并且数据对应的类型是笔记类型Notes.TYPE_NOTE
if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
// 设置复选框CheckBox可见用于在选择模式下让用户选择该项
mCheckBox.setVisibility(View.VISIBLE);
// 根据传入的checked参数设置复选框的选中状态
mCheckBox.setChecked(checked);
} else {
// 如果不满足上述条件,隐藏复选框,表示不在选择模式或者不是笔记类型的项不需要显示复选框
mCheckBox.setVisibility(View.GONE);
}
// 将传入的数据对象保存到成员变量mItemData中方便后续获取和使用
mItemData = data;
// 如果数据的ID等于Notes.ID_CALL_RECORD_FOLDER可能是特定的文件夹类型的标识
if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
// 隐藏呼叫名称相关的TextView因为可能不需要显示
mCallName.setVisibility(View.GONE);
// 显示提醒图标相关的ImageView可能用于提示特殊情况
mAlert.setVisibility(View.VISIBLE);
// 设置标题的文本外观样式采用R.style.TextAppearancePrimaryItem样式
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
// 设置标题的文本内容,由固定字符串(通话记录文件夹名称)和格式化后的包含文件数量的字符串拼接而成,文件数量从数据对象中获取
mTitle.setText(context.getString(R.string.call_record_folder_name)
+ context.getString(R.string.format_folder_files_count, data.getNotesCount()));
// 设置提醒图标对应的图片资源这里使用R.drawable.call_record图片资源
mAlert.setImageResource(R.drawable.call_record);
} else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
// 如果数据的父ID等于Notes.ID_CALL_RECORD_FOLDER表示该项属于通话记录文件夹下的子项
// 显示呼叫名称相关的TextView并设置其文本内容为从数据对象中获取的呼叫名称
mCallName.setVisibility(View.VISIBLE);
mCallName.setText(data.getCallName());
// 设置标题的文本外观样式采用R.style.TextAppearanceSecondaryItem样式
mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
// 设置标题的文本内容通过DataUtils工具类对数据中的摘要snippet进行格式化后设置
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
// 如果数据有提醒通过hasAlert方法判断则设置提醒图标相关的ImageView可见并设置对应的图片资源为R.drawable.clock
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
// 如果没有提醒,则隐藏提醒图标
mAlert.setVisibility(View.GONE);
}
} else {
// 如果不属于上述两种情况(既不是通话记录文件夹本身,也不是其直接子项)
// 隐藏呼叫名称相关的TextView因为不需要显示
mCallName.setVisibility(View.GONE);
// 设置标题的文本外观样式采用R.style.TextAppearancePrimaryItem样式
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
// 如果数据的类型是文件夹类型Notes.TYPE_FOLDER
if (data.getType() == Notes.TYPE_FOLDER) {
// 设置标题的文本内容由数据中的摘要snippet和格式化后的包含文件数量的字符串拼接而成文件数量从数据对象中获取
mTitle.setText(data.getSnippet()
+ context.getString(R.string.format_folder_files_count,
data.getNotesCount()));
// 隐藏提醒图标相关的ImageView文件夹类型可能不需要显示提醒图标
mAlert.setVisibility(View.GONE);
} else {
// 如果是笔记类型(非文件夹类型)
// 设置标题的文本内容通过DataUtils工具类对数据中的摘要snippet进行格式化后设置
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
// 如果数据有提醒通过hasAlert方法判断则设置提醒图标相关的ImageView可见并设置对应的图片资源为R.drawable.clock
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
// 如果没有提醒,则隐藏提醒图标
mAlert.setVisibility(View.GONE);
}
}
}
// 设置时间相关的TextView的文本内容通过DateUtils工具类根据数据中的修改日期获取相对时间格式的字符串进行设置
mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
// 调用setBackground方法根据数据情况设置该项的背景样式
setBackground(data);
}
// 根据传入的NoteItemData数据对象设置该项的背景资源根据不同的条件选择不同的背景资源进行设置
private void setBackground(NoteItemData data) {
// 获取数据中对应的背景颜色ID
int id = data.getBgColorId();
// 如果数据的类型是笔记类型Notes.TYPE_NOTE
if (data.getType() == Notes.TYPE_NOTE) {
// 如果该项是单独的通过isSingle方法判断或者只有一个后续文件夹通过isOneFollowingFolder方法判断
if (data.isSingle() || data.isOneFollowingFolder()) {
// 设置该项的背景资源通过NoteItemBgResources工具类根据背景颜色ID获取对应的单个笔记背景资源进行设置
if (data.isSingle() || data.isOneFollowingFolder()) {
setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
} else if (data.isLast()) {
// 如果该项是最后一个通过isLast方法判断则设置该项的背景资源通过NoteItemBgResources工具类根据背景颜色ID获取对应的最后一个笔记背景资源进行设置
setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
} else if (data.isFirst() || data.isMultiFollowingFolder()) {
// 如果该项是第一个通过isFirst方法判断或者有多个后续文件夹通过isMultiFollowingFolder方法判断则设置该项的背景资源通过NoteItemBgResources工具类根据背景颜色ID获取对应的第一个笔记背景资源进行设置
setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
} else {
// 如果不符合上述任何特殊情况则设置该项的背景资源通过NoteItemBgResources工具类根据背景颜色ID获取对应的普通笔记背景资源进行设置
setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
}
// 如果数据的类型不是笔记类型即文件夹类型等情况则设置该项的背景资源通过NoteItemBgResources工具类获取对应的文件夹背景资源进行设置
} else {
setBackgroundResource(NoteItemBgResources.getFolderBgRes());
}
}
// 获取当前列表项绑定的数据对象,用于在外部获取该列表项对应的数据信息
public NoteItemData getItemData() {
return mItemData;
}

@ -47,64 +47,86 @@ import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.gtask.remote.GTaskSyncService;
// NotesPreferenceActivity类继承自PreferenceActivity用于管理应用中与偏好设置相关的功能和界面展示
public class NotesPreferenceActivity extends PreferenceActivity {
public static final String PREFERENCE_NAME = "notes_preferences";
// 定义偏好设置文件的名称,用于存储和获取应用相关的偏好设置数据
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;
// 在Activity创建时调用的方法进行一些初始化操作
@Override
protected void onCreate(Bundle icicle) {
super.onCreate(icicle);
// 设置ActionBar上的返回按钮可用使用应用图标来实现导航返回功能通常是返回上级界面
/* using the app icon for navigation */
getActionBar().setDisplayHomeAsUpEnabled(true);
// 从指定的XML资源文件R.xml.preferences加载偏好设置界面的布局和相关设置项
addPreferencesFromResource(R.xml.preferences);
// 通过键PREFERENCE_SYNC_ACCOUNT_KEY查找并获取对应的PreferenceCategory组件用于后续操作账户相关的偏好设置项
mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
// 创建一个GTaskReceiver实例用于接收同步相关广播
mReceiver = new GTaskReceiver();
// 创建一个IntentFilter用于定义要接收的广播动作
IntentFilter filter = new IntentFilter();
// 添加要接收的广播动作这里接收GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME对应的广播
filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
// 注册广播接收器,使其能够接收符合条件的广播消息
filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
registerReceiver(mReceiver, filter);
// 初始化为null后续会根据实际情况获取账户信息进行赋值
mOriAccounts = null;
// 通过LayoutInflater加载一个自定义的头部视图R.layout.settings_header并添加到当前Activity的ListView中作为头部视
View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
getListView().addHeaderView(header, null, true);
}
// 在Activity重新恢复可见时调用的方法例如从其他Activity返回等情况进行一些更新操作
@Override
protected void onResume() {
super.onResume();
// 如果添加了新账户mHasAddedAccount为true则进行以下操作
// need to set sync account automatically if user has added a new
// account
if (mHasAddedAccount) {
// 获取当前的谷歌账户列表
Account[] accounts = getGoogleAccounts();
// 如果原始账户列表不为null且当前账户数量大于原始账户数量说明可能添加了新账户
if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
// 遍历新的账户列表
for (Account accountNew : accounts) {
// 标记是否找到匹配的旧账户初始化为false
boolean found = false;
// 遍历原始账户列表,对比账户名称,查找是否已存在相同名称的账户
for (Account accountOld : mOriAccounts) {
if (TextUtils.equals(accountOld.name, accountNew.name)) {
found = true;
break;
}
}
// 如果没有找到匹配的旧账户,说明是新添加的账户,则设置为同步账户,并跳出循环
if (!found) {
setSyncAccount(accountNew.name);
break;
@ -113,36 +135,50 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
// 调用refreshUI方法更新界面显示加载账户偏好设置项、同步按钮等相关UI元素
refreshUI();
}
// 在Activity销毁时调用的方法进行一些清理操作如注销广播接收器
@Override
protected void onDestroy() {
if (mReceiver != null) {
// 注销广播接收器,避免内存泄漏等问题
unregisterReceiver(mReceiver);
}
super.onDestroy();
}
// 加载账户偏好设置相关的视图组件和逻辑,例如添加账户相关的偏好设置项到界面上
private void loadAccountPreference() {
// 移除账户分类下的所有已有偏好设置项(可能是为了重新加载最新的设置项等情况)
mAccountCategory.removeAll();
// 创建一个新的Preference对象用于表示账户相关的偏好设置项
Preference accountPref = new Preference(this);
// 获取当前设置的同步账户名称(如果有的话),作为默认账户名称
final String defaultAccount = getSyncAccountName(this);
// 设置偏好设置项的标题从字符串资源R.string.preferences_account_title中获取
accountPref.setTitle(getString(R.string.preferences_account_title));
// 设置偏好设置项的摘要内容从字符串资源R.string.preferences_account_summary中获取
accountPref.setSummary(getString(R.string.preferences_account_summary));
// 设置偏好设置项的点击监听器,当用户点击该设置项时执行以下逻辑
accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
// 如果同步服务没有正在同步通过GTaskSyncService.isSyncing()判断)
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告知用户不能更改账户
Toast.makeText(NotesPreferenceActivity.this,
R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
.show();
@ -151,85 +187,121 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
});
// 将创建好的账户偏好设置项添加到账户分类mAccountCategory以便在界面上显示
mAccountCategory.addPreference(accountPref);
}
// 加载同步按钮相关的逻辑和状态设置,包括按钮文本、点击事件以及同步状态显示等
private void loadSyncButton() {
// 通过ID查找并获取同步按钮Button组件ID为R.id.preference_sync_button
Button syncButton = (Button) findViewById(R.id.preference_sync_button);
// 通过ID查找并获取显示上次同步时间的TextView组件ID为R.id.prefenerece_sync_status_textview
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));
// 设置按钮的点击事件点击时调用GTaskSyncService.cancelSync方法取消同步
syncButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
}
});
} else {
// 如果没有正在同步,设置按钮文本为立即同步相关的文本(从字符串资源中获取)
syncButton.setText(getString(R.string.preferences_button_sync_immediately));
// 设置按钮的点击事件点击时调用GTaskSyncService.startSync方法启动同步
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()) {
// 如果正在同步设置显示上次同步时间的TextView的文本为同步进度相关的字符串从同步服务获取并设置为可见
lastSyncTimeView.setText(GTaskSyncService.getProgressString());
lastSyncTimeView.setVisibility(View.VISIBLE);
} else {
// 如果没有正在同步获取上次同步时间通过getLastSyncTime方法
long lastSyncTime = getLastSyncTime(this);
if (lastSyncTime != 0) {
// 如果上次同步时间不为0格式化并设置显示上次同步时间的TextView的文本内容然后设置为可见
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 {
// 如果上次同步时间为0隐藏该TextView组件
lastSyncTimeView.setVisibility(View.GONE);
}
}
}
// 用于更新整个界面的显示,调用加载账户偏好设置和同步按钮相关的方法
private void refreshUI() {
loadAccountPreference();
loadSyncButton();
}
// 弹出选择账户的提示对话框,用于让用户选择要设置的同步账户
private void showSelectAccountAlertDialog() {
// 创建一个AlertDialog.Builder对象用于构建提示对话框
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 通过LayoutInflater加载一个自定义的标题视图R.layout.account_dialog_title用于设置对话框的标题部分
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
// 通过ID查找并获取标题TextView组件设置其文本内容为选择账户相关的标题文本从字符串资源中获取
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
// 通过ID查找并获取副标题TextView组件设置其文本内容为选择账户相关的提示文本从字符串资源中获取
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
// 设置对话框的自定义标题视图
dialogBuilder.setCustomTitle(titleView);
// 设置对话框的确定按钮这里先设置为null后续可能根据具体需求再处理
dialogBuilder.setPositiveButton(null, null);
// 获取当前的谷歌账户列表
Account[] accounts = getGoogleAccounts();
// 获取当前设置的同步账户名称(如果有的话)
String defAccount = getSyncAccountName(this);
// 将当前账户列表赋值给mOriAccounts用于后续对比等操作
mOriAccounts = accounts;
// 标记还没有添加新账户
mHasAddedAccount = false;
// 如果账户列表长度大于0说明有可用账户进行以下操作
if (accounts.length > 0) {
// 创建一个字符序列数组,用于存储账户名称,长度与账户列表长度相同
CharSequence[] items = new CharSequence[accounts.length];
// 将items数组赋值给itemMapping方便后续在点击事件中使用这里可能是为了保持引用一致等原因
final CharSequence[] itemMapping = items;
// 标记默认选中的账户索引,初始化为 -1表示没有默认选中项
final CharSequence[] itemMapping = items;
int checkedItem = -1;
int index = 0;
// 遍历账户列表设置每个账户名称到items数组中并查找默认选中的账户与当前同步账户名称相同的账户
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();
@ -237,10 +309,13 @@ public class NotesPreferenceActivity extends PreferenceActivity {
});
}
// 通过LayoutInflater加载一个添加账户的视图R.layout.add_account_text并添加到对话框中
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;
@ -254,98 +329,138 @@ public class NotesPreferenceActivity extends PreferenceActivity {
});
}
// 弹出确认更改账户的提示对话框,用于提示用户更改账户的相关操作和风险等信息
private void showChangeAccountConfirmAlertDialog() {
// 创建一个AlertDialog.Builder对象用于构建提示对话框
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 通过LayoutInflater加载一个自定义的标题视图R.layout.account_dialog_title用于设置对话框的标题部分
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
// 通过ID查找并获取标题TextView组件设置其文本内容为更改账户相关的标题文本包含当前同步账户名称从字符串资源中获取并格式化
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
getSyncAccountName(this)));
// 通过ID查找并获取副标题TextView组件设置其文本内容为更改账户相关的警告提示文本从字符串资源中获取
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方法移除同步账户并更新界面显示
removeSyncAccount();
refreshUI();
}
}
});
// 显示对话框
dialogBuilder.show();
}
// 获取当前设备上的谷歌账户列表通过AccountManager获取指定类型"com.google")的账户
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) {
// 如果账户名称不为null将账户名称保存到偏好设置中键为PREFERENCE_SYNC_ACCOUNT_NAME
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, account);
} else {
// 如果传入的账户名称为null将同步账户名称设置为空字符串存入偏好设置中
editor.putString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
}
// 提交对偏好设置的修改,使其生效
editor.commit();
// clean up last sync time
// 调用setLastSyncTime方法将上次同步时间设置为0可能是为了在更改同步账户时重置同步相关的时间记录
setLastSyncTime(this, 0);
setLastSyncTime(this, 0);
// 清理本地与GTask相关的信息通过开启一个新线程来执行更新操作
// clean up local gtask related info
new Thread(new Runnable() {
public void run() {
// 创建一个ContentValues对象用于存储要更新的数据
ContentValues values = new ContentValues();
// 将NoteColumns.GTASK_ID对应的值设置为空字符串可能是清除之前关联的GTask ID信息
values.put(NoteColumns.GTASK_ID, "");
// 将NoteColumns.SYNC_ID对应的值设置为0可能是重置同步相关的ID等信息
values.put(NoteColumns.SYNC_ID, 0);
// 使用内容解析器getContentResolver更新Notes.CONTENT_NOTE_URI对应的内容将上述设置的值进行更新条件为null可能是更新所有符合该URI的记录
getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
}
}).start();
// 弹出一个Toast提示信息告知用户成功设置账户提示内容通过字符串资源格式化传入账户名称来生成
Toast.makeText(NotesPreferenceActivity.this,
getString(R.string.preferences_toast_success_set_accout, account),
Toast.LENGTH_SHORT).show();
}
}
// 移除同步账户相关的偏好设置信息以及清理本地与GTask相关的信息
private void removeSyncAccount() {
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences settings = get
// 获取应用的共享偏好设置对象,用于操作偏好设置数据
SharedPreferences.(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();
// 清理本地与GTask相关的信息通过开启一个新线程来执行更新操作
// clean up local gtask related info
new Thread(new Runnable() {
public void run() {
// 创建一个ContentValues对象用于存储要更新的数据
ContentValues values = new ContentValues();
// 将NoteColumns.GTASK_ID对应的值设置为空字符串可能是清除之前关联的GTask ID信息
values.put(NoteColumns.GTASK_ID, "");
// 将NoteColumns.SYNC_ID对应的值设置为0可能是重置同步相关的ID等信息
values.put(NoteColumns.SYNC_ID, 0);
// 使用内容解析器getContentResolver更新Notes.CONTENT_NOTE_URI对应的内容将上述设置的值进行更新条件为null可能是更新所有符合该URI的记录
getContentResolver().update(Notes.CONTENT_NOTE_URI, values, null, null);
}
}).start();
}
// 获取当前设置的同步账户名称从应用的共享偏好设置中读取对应键PREFERENCE_SYNC_ACCOUNT_NAME的值如果不存在则返回空字符串
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);
@ -354,18 +469,24 @@ public class NotesPreferenceActivity extends PreferenceActivity {
editor.commit();
}
// 获取上次同步时间从应用的共享偏好设置中读取对应键PREFERENCE_LAST_SYNC_TIME的值如果不存在则返回0
public static long getLastSyncTime(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
}
// 内部类继承自BroadcastReceiver用于接收与GTask同步服务相关的广播消息并进行相应的界面更新操作
private class GTaskReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 接收到广播后调用refreshUI方法更新界面显示例如加载账户偏好设置、同步按钮状态等
refreshUI();
// 判断广播中携带的是否正在同步的额外信息键为GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING是否为true如果是则进行以下操作
if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
// 通过ID查找并获取用于显示同步状态的TextView组件ID为R.id.prefenerece_sync_status_textview
TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
syncStatus.setText(intent
.getStringExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_PROGRESS_MSG));

@ -32,31 +32,37 @@ import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NoteEditActivity;
import net.micode.notes.ui.NotesListActivity;
// 抽象的笔记小部件提供者类,继承自 AppWidgetProvider
public abstract class NoteWidgetProvider extends AppWidgetProvider {
// 投影数组,用于查询笔记小部件信息时指定要查询的列
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;
// 日志标记
private static final String TAG = "NoteWidgetProvider";
// 当小部件被删除时调用的方法
@Override
public void onDeleted(Context context, int[] appWidgetIds) {
// 创建一个 ContentValues 对象,将 WIDGET_ID 设为无效
ContentValues values = new ContentValues();
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
// 遍历要删除的小部件 ID 数组
for (int i = 0; i < appWidgetIds.length; i++) {
// 通过 ContentResolver 更新笔记信息,将对应小部件 ID 的 WIDGET_ID 设为无效
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
NoteColumns.WIDGET_ID + "=?",
new String[] { String.valueOf(appWidgetIds[i])});
}
}
// 获取笔记小部件信息的私有方法,通过 ContentResolver 查询
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
@ -64,34 +70,45 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
null);
}
// 更新小部件的方法,调用另一个重载的 update 方法
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
// 真正执行更新小部件的私有方法
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
// 遍历要更新的小部件 ID 数组
for (int i = 0; i < appWidgetIds.length; i++) {
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
// 获取默认背景颜色 ID
int bgId = ResourceParser.getDefaultBgId(context);
// 初始化 snippet 为一个空字符串
String snippet = "";
// 创建一个 Intent指向 NoteEditActivity
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
// 向 Intent 中添加小部件 ID 和小部件类型信息
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) {
// 如果查询结果数量大于 1打印错误日志并关闭游标
Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
c.close();
return;
}
// 获取 snippet 信息
snippet = c.getString(COLUMN_SNIPPET);
// 获取背景颜色 ID
bgId = c.getInt(COLUMN_BG_COLOR_ID);
// 向 Intent 中添加笔记的唯一标识符
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
// 设置 Intent 的动作
intent.setAction(Intent.ACTION_VIEW);
} else {
// 如果没有找到笔记信息,设置默认的 snippet 信息并设置 Intent 动作
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
}
@ -99,34 +116,37 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
if (c != null) {
c.close();
}
// 创建一个 RemoteViews 对象,使用抽象方法 getLayoutId 获取布局 ID
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
// 设置小部件背景图片资源,使用抽象方法 getBgResourceId 获取资源 ID
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
// 向 Intent 中添加背景颜色 ID 信息
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
/**
* Generate the pending intent to start host for the widget
*/
// 创建一个 PendingIntent根据隐私模式不同创建不同的 PendingIntent
PendingIntent pendingIntent = null;
if (privacyMode) {
// 在隐私模式下,设置文本视图内容并创建一个指向 NotesListActivity 的 PendingIntent
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 {
// 正常模式下,设置文本视图内容为 snippet 并创建一个指向 NoteEditActivity 的 PendingIntent
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}
// 为小部件的文本视图设置点击事件的 PendingIntent
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();
}

@ -23,25 +23,30 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
// 继承自 NoteWidgetProvider 的 2x 笔记小部件提供者类
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
// 当小部件更新时调用此方法
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的 update 方法进行更新操作
super.update(context, appWidgetManager, appWidgetIds);
}
// 实现父类的抽象方法,获取布局 ID
@Override
protected int getLayoutId() {
// 返回 2x 小部件的布局资源 ID
return R.layout.widget_2x;
}
// 实现父类的抽象方法,获取背景资源 ID
@Override
protected int getBgResourceId(int bgId) {
// 使用 ResourceParser 的 WidgetBgResources 类获取 2x 小部件的背景资源 ID
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}
// 实现父类的抽象方法,获取小部件类型
@Override
protected int getWidgetType() {
// 返回 2x 小部件的类型
return Notes.TYPE_WIDGET_2X;
}
}

@ -23,24 +23,29 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
// 继承自 NoteWidgetProvider 的 4x 笔记小部件提供者类
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
// 当小部件更新时调用此方法
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的 update 方法进行更新操作
super.update(context, appWidgetManager, appWidgetIds);
}
// 实现父类的抽象方法,获取布局 ID
protected int getLayoutId() {
// 返回 4x 小部件的布局资源 ID
return R.layout.widget_4x;
}
// 实现父类的抽象方法,获取背景资源 ID
@Override
protected int getBgResourceId(int bgId) {
// 使用 ResourceParser 的 WidgetBgResources 类获取 4x 小部件的背景资源 ID
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}
// 实现父类的抽象方法,获取小部件类型
@Override
protected int getWidgetType() {
// 返回 4x 小部件的类型
return Notes.TYPE_WIDGET_4X;
}
}

Loading…
Cancel
Save