pyz3hlwn2
/
git.text
1
0
Fork 0
Code Issues Pull Requests 1 Packages Projects Releases Wiki Activity
Labels Milestones
New Pull Request

对tool包、ui包、widget包中的每个类进行了注释。 #7

Merged
pyz3hlwn2 merged 1 commits from wangyixin_branch into master 3 weeks ago
Conversation 0 Commits 1 Files Changed 21
21 changed files with 2373 additions and 694 deletions
Show Stats Download Patch File Download Diff File

308
src/tool/BackupUtils.java
Unescape View File

@ -36,11 +36,20 @@ import java.io.IOException;
import java.io.PrintStream;
/**
* 小米便签的备份工具类，用于将便签数据导出为文本文件存储在SD卡，支持文件夹、普通便签、通话记录便签的备份
* 采用单例模式，确保全局唯一实例（只有当BackupUtils不存在时才创建）
*/
public class BackupUtils {
private static final String TAG = "BackupUtils";
// Singleton stuff
private static final String TAG = "BackupUtils"; // 日志标签
// 单例实例
private static BackupUtils sInstance;
/**
* 获取单例实例
* @param context 应用上下文，用于访问资源和数据库，Context让备份工具能够访问便签数据、读取格式模板、写入SD卡，是连接应用逻辑和Android系统的特殊类
* @return 全局唯一的BackupUtils实例（只有当BackupUtils不存在时才创建）
*/
public static synchronized BackupUtils getInstance(Context context) {
if (sInstance == null) {
sInstance = new BackupUtils(context);
@ -49,251 +58,326 @@ public class BackupUtils {
}
/**
* Following states are signs to represents backup or restore
* 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;
/**
* 私有构造方法，初始化文本导出工具
* @param context 应用上下文
*/
private BackupUtils(Context context) {
mTextExport = new TextExport(context);
}
/**
* 检查外部存储（SD卡）是否可用（已挂载且可读写）
* @return 可用返回true，否则false
*/
private static boolean externalStorageAvailable() {
return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());// 返回存储状态
}
/**
* 对外提供的文本导出入口方法
* @return 备份状态（如STATE_SUCCESS、STATE_SD_CARD_UNMOUONTED等）
*/
public int exportToText() {
return mTextExport.exportToText();
}
/**
* 获取导出的文本文件名
* @return 文件名（如notes_20240520.txt）
*/
public String getExportedTextFileName() {
return mTextExport.mFileName;
}
/**
* 获取导出的文本文件所在目录
* @return 目录路径（如/sdcard/NotesBackup/）
*/
public String getExportedTextFileDir() {
return mTextExport.mFileDirectory;
}
/**
* 静态内部类，封装文本导出的具体逻辑：查询数据库、格式化数据、写入文件
*/
private static class TextExport {
// 查询便签时需要的字段投影（只查询需要的列，优化性能）
private static final String[] NOTE_PROJECTION = {
NoteColumns.ID,
NoteColumns.MODIFIED_DATE,
NoteColumns.SNIPPET,
NoteColumns.TYPE
NoteColumns.ID, // 便签/文件夹ID
NoteColumns.MODIFIED_DATE,// 最后修改时间
NoteColumns.SNIPPET, // 文件夹名或便签摘要
NoteColumns.TYPE // 类型（文件夹/便签）
};
// 字段索引常量，用于从Cursor中快速获取对应值
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;
// 查询便签详情数据时的字段投影
private static final String[] DATA_PROJECTION = {
DataColumns.CONTENT,
DataColumns.MIME_TYPE,
DataColumns.DATA1,
DataColumns.CONTENT, // 内容（文本/位置）
DataColumns.MIME_TYPE, // 类型（普通便签/通话便签）
DataColumns.DATA1, // 通话便签的通话时间，getFormat函数定义的
DataColumns.DATA2,
DataColumns.DATA3,
DataColumns.DATA3, // 通话便签的电话号码，getFormat函数定义的
DataColumns.DATA4,
};
/*
* private String getFormat(int id) {
return TEXT_FORMAT[id];
}*/
// 数据字段索引常量
private static final int DATA_COLUMN_CONTENT = 0;
private static final int DATA_COLUMN_MIME_TYPE = 1;
private static final int DATA_COLUMN_CALL_DATE = 2; // 通话时间在DATA1中，getFormat函数定义的
private static final int DATA_COLUMN_PHONE_NUMBER = 4; // 电话号码在DATA3中，getFormat函数定义的
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 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;
private Context mContext; // 上下文
private String mFileName; // 导出的文件名
private String mFileDirectory; // 导出的文件目录
/**
* 初始化文本导出工具
* @param context 上下文，用于获取资源和查询数据库
*/
public TextExport(Context context) {
// 从资源文件读取格式化模板（如strings.xml中的format_for_exported_note数组）
TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);
mContext = context;
mFileName = "";
mFileDirectory = "";
}
/**
* 获取指定索引的格式化模板
* @param id 模板索引（如FORMAT_FOLDER_NAME）
* @return 模板字符串
*/
private String getFormat(int id) {
return TEXT_FORMAT[id];
}
/**
* Export the folder identified by folder id to text
* 导出指定文件夹下的所有便签到输出流
* @param folderId 文件夹ID
* @param ps 输出流（指向备份文件）
*/
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
}, null);
// 查询该文件夹下的所有便签（通过parent_id关联）
Cursor notesCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI, // 便签数据库的URI
NOTE_PROJECTION, // 要查询的字段
NoteColumns.PARENT_ID + "=?", // 查询条件：parent_id=folderId
new String[] {folderId}, // 条件参数
null); // 排序方式（默认）
if (notesCursor != null) {
if (notesCursor.moveToFirst()) {
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
// 打印便签的最后修改时间（格式化显示）
ps.println(String.format(
getFormat(FORMAT_NOTE_DATE),
DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm), // 时间格式（月日时分）
notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
)
));
// 导出该便签的详细内容
String noteId = notesCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (notesCursor.moveToNext());
}
notesCursor.close();
notesCursor.close(); // 关闭游标，释放资源
}
}
/**
* Export note identified by id to a print stream
* 导出单个便签的详细内容到输出流
* 区分普通便签和通话便签，分别格式化内容
* @param noteId 便签ID
* @param ps 输出流（指向备份文件）
*/
private void exportNoteToText(String noteId, PrintStream ps) {
Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI,
DATA_PROJECTION, DataColumns.NOTE_ID + "=?", new String[] {
noteId
}, null);
// 查询该便签的详细数据（如文本内容、通话记录信息）
Cursor dataCursor = mContext.getContentResolver().query(
Notes.CONTENT_DATA_URI, // 便签数据的URI
DATA_PROJECTION, // 要查询的字段
DataColumns.NOTE_ID + "=?", // 查询条件：note_id=noteId
new String[] {noteId}, // 条件参数
null); // 排序方式
if (dataCursor != null) {
if (dataCursor.moveToFirst()) {
if (dataCursor.moveToFirst()) { // 遍历便签的所有数据
do {
String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE);
if (DataConstants.CALL_NOTE.equals(mimeType)) {
// Print phone number
if (DataConstants.CALL_NOTE.equals(mimeType)) { // 通话记录便签
// 提取电话号码、通话时间、位置信息
String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER);
long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE);
String location = dataCursor.getString(DATA_COLUMN_CONTENT);
// 打印电话号码（非空时）
if (!TextUtils.isEmpty(phoneNumber)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
phoneNumber));
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), 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
// 打印通话时间（格式化）
ps.println(String.format(
getFormat(FORMAT_NOTE_CONTENT),
DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
callDate
)
));
// 打印位置信息（非空时）
if (!TextUtils.isEmpty(location)) {
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT),
location));
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), location));
}
} else if (DataConstants.NOTE.equals(mimeType)) {
} 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),
content));
if (!TextUtils.isEmpty(content)) { // 打印文本内容
ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), content));
}
}
} while (dataCursor.moveToNext());
}
dataCursor.close();
dataCursor.close(); // 关闭游标，释放资源
}
// print a line separator between note
// 便签之间添加分隔符（换行）
try {
ps.write(new byte[] {
Character.LINE_SEPARATOR, Character.LETTER_NUMBER
});
ps.write(new byte[] {Character.LINE_SEPARATOR, Character.LINE_SEPARATOR});
} catch (IOException e) {
Log.e(TAG, e.toString());
Log.e(TAG, "写入分隔符失败：" + e.toString());
}
}
/**
* Note will be exported as text which is user readable
* 执行文本导出的主逻辑：检查SD卡→创建文件→查询数据→写入文件
* @return 备份状态（如STATE_SUCCESS）
*/
public int exportToText() {
// 检查SD卡是否可用
if (!externalStorageAvailable()) {
Log.d(TAG, "Media was not mounted");
Log.d(TAG, "SD卡未挂载，无法导出");
return STATE_SD_CARD_UNMOUONTED;
}
// 获取指向备份文件的输出流
PrintStream ps = getExportToTextPrintStream();
if (ps == null) {
Log.e(TAG, "get print stream error");
Log.e(TAG, "创建输出流失败");
return STATE_SYSTEM_ERROR;
}
// First export folder and its notes
// 1. 导出所有文件夹及其包含的便签（排除回收站，包含通话记录文件夹）
Cursor folderCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
// 查询条件：文件夹类型且不在回收站，或通话记录文件夹
"(" + NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + " AND "
+ NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER + ") OR "
+ NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER, null, null);
+ NoteColumns.ID + "=" + Notes.ID_CALL_RECORD_FOLDER,
null,
null);
if (folderCursor != null) {
if (folderCursor.moveToFirst()) {
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);
if (folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) {
folderName = mContext.getString(R.string.call_record_folder_name); // 从资源获取“通话记录”
} else {
folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET);
folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET); // 普通文件夹名
}
// 打印文件夹名（非空时）
if (!TextUtils.isEmpty(folderName)) {
ps.println(String.format(getFormat(FORMAT_FOLDER_NAME), folderName));
}
// 导出该文件夹下的所有便签
String folderId = folderCursor.getString(NOTE_COLUMN_ID);
exportFolderToText(folderId, ps);
} while (folderCursor.moveToNext());
}
folderCursor.close();
folderCursor.close(); // 关闭游标
}
// Export notes in root's folder
// 2. 导出根目录下的便签（无文件夹归属的便签，parent_id=0）
Cursor noteCursor = mContext.getContentResolver().query(
Notes.CONTENT_NOTE_URI,
NOTE_PROJECTION,
NoteColumns.TYPE + "=" + +Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID
+ "=0", null, null);
NoteColumns.TYPE + "=" + Notes.TYPE_NOTE + " AND " + NoteColumns.PARENT_ID + "=0",
null,
null);
if (noteCursor != null) {
if (noteCursor.moveToFirst()) {
if (noteCursor.moveToFirst()) { // 遍历根目录便签
do {
ps.println(String.format(getFormat(FORMAT_NOTE_DATE), DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE))));
// Query data belong to this note
// 打印修改时间
ps.println(String.format(
getFormat(FORMAT_NOTE_DATE),
DateFormat.format(
mContext.getString(R.string.format_datetime_mdhm),
noteCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)
)
));
// 导出便签内容
String noteId = noteCursor.getString(NOTE_COLUMN_ID);
exportNoteToText(noteId, ps);
} while (noteCursor.moveToNext());
}
noteCursor.close();
noteCursor.close(); // 关闭游标
}
ps.close();
return STATE_SUCCESS;
ps.close(); // 关闭输出流
return STATE_SUCCESS; // 导出成功
}
/**
* Get a print stream pointed to the file {@generateExportedTextFile}
* 创建SD卡上的备份文件，并返回指向该文件的PrintStream
* @return 输出流（PrintStream），失败返回null
*/
private PrintStream getExportToTextPrintStream() {
File file = generateFileMountedOnSDcard(mContext, R.string.file_path,
R.string.file_name_txt_format);
// 在SD卡上生成备份文件（路径和名称从资源获取，包含当前日期）
File file = generateFileMountedOnSDcard(
mContext,
R.string.file_path, // 目录路径（如/sdcard/NotesBackup/）
R.string.file_name_txt_format // 文件名格式（如notes_%s.txt，%s为日期）
);
if (file == null) {
Log.e(TAG, "create file to exported failed");
Log.e(TAG, "创建备份文件失败");
return null;
}
// 记录文件名和目录
mFileName = file.getName();
mFileDirectory = mContext.getString(R.string.file_path);
// 创建输出流
PrintStream ps = null;
try {
FileOutputStream fos = new FileOutputStream(file);
@ -310,35 +394,43 @@ public class BackupUtils {
}
/**
* Generate the text file to store imported data
* 在SD卡上创建备份文件（含目录）
* @param context 上下文
* @param filePathResId 目录路径的资源ID（如R.string.file_path）
* @param fileNameFormatResId 文件名格式的资源ID（如R.string.file_name_txt_format）
* @return 创建的文件，失败返回null
*/
private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) {
StringBuilder sb = new StringBuilder();
// 拼接路径：SD卡根目录 + 应用备份目录（如/sdcard/NotesBackup/）
sb.append(Environment.getExternalStorageDirectory());
sb.append(context.getString(filePathResId));
File filedir = new File(sb.toString());
// 拼接文件名：目录 + 格式化名称（含当前日期，如notes_20240520.txt）
sb.append(context.getString(
fileNameFormatResId,
DateFormat.format(context.getString(R.string.format_date_ymd),
System.currentTimeMillis())));
DateFormat.format(
context.getString(R.string.format_date_ymd), // 日期格式（年月日）
System.currentTimeMillis()
)
));
File file = new File(sb.toString());
// 创建目录和文件
try {
if (!filedir.exists()) {
filedir.mkdir();
filedir.mkdir(); // 目录不存在则创建
}
if (!file.exists()) {
file.createNewFile();
file.createNewFile(); // 文件不存在则创建
}
return file;
} catch (SecurityException e) {
e.printStackTrace();
e.printStackTrace(); // 权限不足
} catch (IOException e) {
e.printStackTrace();
e.printStackTrace(); // 创建文件失败
}
return null;
}
}
}

178
src/tool/DataUtils.java
Unescape View File

@ -35,88 +35,127 @@ import java.util.ArrayList;
import java.util.HashSet;
/**
* 便签数据操作工具类，封装数据库查询、更新、删除等常用操作，
* 提供与ContentProvider交互的统一接口，支撑UI层的数据需求
*/
public class DataUtils {
public static final String TAG = "DataUtils";
/**
* 批量删除便签或文件夹（跳过系统根目录）
* @param resolver 内容解析器，用于操作数据库
* @param ids 待删除的便签/文件夹ID集合
* @return 操作成功返回true，失败返回false
*/
public static boolean batchDeleteNotes(ContentResolver resolver, HashSet<Long> ids) {
if (ids == null) {
Log.d(TAG, "the ids is null");
Log.d(TAG, "待删除的ID集合为null");
return true;
}
if (ids.size() == 0) {
Log.d(TAG, "no id is in the hashset");
Log.d(TAG, "待删除的ID集合为空");
return true;
}
// 创建批量删除操作列表
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
for (long id : ids) {
// 禁止删除系统根目录
if(id == Notes.ID_ROOT_FOLDER) {
Log.e(TAG, "Don't delete system folder root");
Log.e(TAG, "不能删除系统根目录文件夹");
continue;
}
// 构建删除操作（根据ID删除便签）
ContentProviderOperation.Builder builder = ContentProviderOperation
.newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
operationList.add(builder.build());
}
try {
// 执行批量删除
ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList);
if (results == null || results.length == 0 || results[0] == null) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
Log.d(TAG, "删除失败，ID集合:" + ids.toString());
return false;
}
return true;
} catch (RemoteException e) {
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
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()));
Log.e(TAG, String.format("操作应用异常: %s: %s", e.toString(), e.getMessage()));
}
return false;
}
/**
* 将单个便签移动到目标文件夹
* @param resolver 内容解析器
* @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();
values.put(NoteColumns.PARENT_ID, desFolderId);
values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId);
values.put(NoteColumns.LOCAL_MODIFIED, 1);
values.put(NoteColumns.PARENT_ID, desFolderId); // 更新父目录ID为目标文件夹
values.put(NoteColumns.ORIGIN_PARENT_ID, srcFolderId); // 记录原始文件夹ID
values.put(NoteColumns.LOCAL_MODIFIED, 1); // 标记本地已修改
// 执行更新操作
resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null);
}
/**
* 批量移动便签到目标文件夹
* @param resolver 内容解析器
* @param ids 待移动的便签ID集合
* @param folderId 目标文件夹ID
* @return 操作成功返回true，失败返回false
*/
public static boolean batchMoveToFolder(ContentResolver resolver, HashSet<Long> ids,
long folderId) {
long folderId) {
if (ids == null) {
Log.d(TAG, "the ids is null");
Log.d(TAG, "待移动的ID集合为null");
return true;
}
// 创建批量更新操作列表
ArrayList<ContentProviderOperation> operationList = new ArrayList<ContentProviderOperation>();
for (long id : ids) {
// 构建更新操作（修改父目录ID）
ContentProviderOperation.Builder builder = ContentProviderOperation
.newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id));
builder.withValue(NoteColumns.PARENT_ID, folderId);
builder.withValue(NoteColumns.LOCAL_MODIFIED, 1);
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) {
Log.d(TAG, "delete notes failed, ids:" + ids.toString());
Log.d(TAG, "移动失败，ID集合:" + ids.toString());
return false;
}
return true;
} catch (RemoteException e) {
Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage()));
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()));
Log.e(TAG, String.format("操作应用异常: %s: %s", e.toString(), e.getMessage()));
}
return false;
}
/**
* Get the all folder count except system folders {@link Notes#TYPE_SYSTEM}}
* 获取用户创建的文件夹数量（排除系统文件夹如垃圾站）
* @param resolver 内容解析器
* @return 文件夹数量
*/
public static int getUserFolderCount(ContentResolver resolver) {
// 查询非系统的文件夹且不在垃圾站中的文件夹数量
Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI,
new String[] { "COUNT(*)" },
new String[] { "COUNT(*)" }, // 统计数量
NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?",
new String[] { String.valueOf(Notes.TYPE_FOLDER), String.valueOf(Notes.ID_TRASH_FOLER)},
null);
@ -127,7 +166,7 @@ public class DataUtils {
try {
count = cursor.getInt(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "get folder count failed:" + e.toString());
Log.e(TAG, "获取文件夹数量失败:" + e.toString());
} finally {
cursor.close();
}
@ -136,6 +175,13 @@ public class DataUtils {
return count;
}
/**
* 检查便签是否存在且可见（不在垃圾站中）
* @param resolver 内容解析器
* @param noteId 便签ID
* @param type 便签类型（如Notes.TYPE_NOTE）
* @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,
@ -145,62 +191,78 @@ public class DataUtils {
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) {
exist = true;
}
exist = cursor.getCount() > 0; // 游标有数据则存在
cursor.close();
}
return exist;
}
/**
* 检查便签是否存在（包括垃圾站中的便签）
* @param resolver 内容解析器
* @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);
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) {
exist = true;
}
exist = cursor.getCount() > 0;
cursor.close();
}
return exist;
}
/**
* 检查便签内容数据是否存在
* @param resolver 内容解析器
* @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);
boolean exist = false;
if (cursor != null) {
if (cursor.getCount() > 0) {
exist = true;
}
exist = cursor.getCount() > 0;
cursor.close();
}
return exist;
}
/**
* 检查可见文件夹名称是否已存在（排除垃圾站）
* @param resolver 内容解析器
* @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 +
" AND " + NoteColumns.SNIPPET + "=?",
" AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER +
" AND " + NoteColumns.SNIPPET + "=?", // SNIPPET字段存储文件夹名称
new String[] { name }, null);
boolean exist = false;
if(cursor != null) {
if(cursor.getCount() > 0) {
exist = true;
}
exist = cursor.getCount() > 0;
cursor.close();
}
return exist;
}
/**
* 获取文件夹下所有便签关联的桌面小部件属性
* @param resolver 内容解析器
* @param folderId 文件夹ID
* @return 小部件属性集合（包含widgetId和widgetType）
*/
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 + "=?",
new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE }, // 查询小部件ID和类型
NoteColumns.PARENT_ID + "=?", // 筛选指定文件夹下的便签
new String[] { String.valueOf(folderId) },
null);
@ -224,10 +286,16 @@ public class DataUtils {
return set;
}
/**
* 通过便签ID获取关联的电话号码（用于通话便签）
* @param resolver 内容解析器
* @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 + "=?",
new String [] { CallNote.PHONE_NUMBER }, // 查询电话号码字段
CallNote.NOTE_ID + "=? AND " + CallNote.MIME_TYPE + "=?", // 筛选通话便签数据
new String [] { String.valueOf(noteId), CallNote.CONTENT_ITEM_TYPE },
null);
@ -235,7 +303,7 @@ public class DataUtils {
try {
return cursor.getString(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call number fails " + e.toString());
Log.e(TAG, "获取电话号码失败 " + e.toString());
} finally {
cursor.close();
}
@ -243,11 +311,18 @@ public class DataUtils {
return "";
}
/**
* 通过电话号码和通话时间查找对应的通话便签ID（避免重复创建）
* @param resolver 内容解析器
* @param phoneNumber 电话号码
* @param callDate 通话时间戳
* @return 便签ID，未找到返回0
*/
public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) {
Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI,
new String [] { CallNote.NOTE_ID },
new String [] { CallNote.NOTE_ID }, // 查询关联的便签ID
CallNote.CALL_DATE + "=? AND " + CallNote.MIME_TYPE + "=? AND PHONE_NUMBERS_EQUAL("
+ CallNote.PHONE_NUMBER + ",?)",
+ CallNote.PHONE_NUMBER + ",?)", // 按通话时间和电话号码筛选（支持号码格式匹配）
new String [] { String.valueOf(callDate), CallNote.CONTENT_ITEM_TYPE, phoneNumber },
null);
@ -256,7 +331,7 @@ public class DataUtils {
try {
return cursor.getLong(0);
} catch (IndexOutOfBoundsException e) {
Log.e(TAG, "Get call note id fails " + e.toString());
Log.e(TAG, "获取通话便签ID失败 " + e.toString());
}
}
cursor.close();
@ -264,9 +339,15 @@ public class DataUtils {
return 0;
}
/**
* 通过便签ID获取摘要文本（用于列表页展示）
* @param resolver 内容解析器
* @param noteId 便签ID
* @return 摘要文本，便签不存在则抛出异常
*/
public static String getSnippetById(ContentResolver resolver, long noteId) {
Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI,
new String [] { NoteColumns.SNIPPET },
new String [] { NoteColumns.SNIPPET }, // 查询摘要字段
NoteColumns.ID + "=?",
new String [] { String.valueOf(noteId)},
null);
@ -279,17 +360,22 @@ public class DataUtils {
cursor.close();
return snippet;
}
throw new IllegalArgumentException("Note is not found with id: " + noteId);
throw new IllegalArgumentException("未找到ID为 " + noteId + " 的便签");
}
/**
* 格式化摘要文本（去除首尾空格，取首行内容）
* @param snippet 原始摘要文本
* @return 格式化后的摘要
*/
public static String getFormattedSnippet(String snippet) {
if (snippet != null) {
snippet = snippet.trim();
int index = snippet.indexOf('\n');
snippet = snippet.trim(); // 去除首尾空格
int index = snippet.indexOf('\n'); // 查找第一个换行符
if (index != -1) {
snippet = snippet.substring(0, index);
snippet = snippet.substring(0, index); // 截取首行内容
}
}
return snippet;
}
}
}

60
src/tool/GTaskStringUtils.java
Unescape View File

@ -13,101 +13,157 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.micode.notes.tool;
/**
* GTask字符串常量工具类，定义小米便签与GTask（Google Tasks）同步过程中使用的所有标识符
* 包括JSON键名、文件夹标识、元数据键等，用于统一同步过程中的数据交互格式
*/
public class GTaskStringUtils {
// ========================== GTask JSON动作相关键名 ==========================
/** JSON中动作ID的键名，用于标识同步操作的唯一ID（如创建/更新任务的动作ID） */
public final static String GTASK_JSON_ACTION_ID = "action_id";
/** JSON中动作列表的键名，用于包装多个同步动作（如批量创建/更新任务） */
public final static String GTASK_JSON_ACTION_LIST = "action_list";
/** JSON中动作类型的键名，用于标识当前动作是创建/更新/移动等类型 */
public final static String GTASK_JSON_ACTION_TYPE = "action_type";
/** 动作类型：创建操作，用于标识在GTask中创建新任务或文件夹 */
public final static String GTASK_JSON_ACTION_TYPE_CREATE = "create";
/** 动作类型：获取全部数据，用于请求GTask中的所有任务和文件夹数据 */
public final static String GTASK_JSON_ACTION_TYPE_GETALL = "get_all";
/** 动作类型：移动操作，用于标识将任务/文件夹移动到新位置 */
public final static String GTASK_JSON_ACTION_TYPE_MOVE = "move";
/** 动作类型：更新操作，用于标识修改GTask中已有的任务或文件夹 */
public final static String GTASK_JSON_ACTION_TYPE_UPDATE = "update";
// ========================== GTask JSON实体属性相关键名 ==========================
/** JSON中创建者ID的键名，标识任务/文件夹的创建者（小米便签中暂用"null"） */
public final static String GTASK_JSON_CREATOR_ID = "creator_id";
/** JSON中子实体的键名，用于存储子任务信息 */
public final static String GTASK_JSON_CHILD_ENTITY = "child_entity";
/** JSON中客户端版本的键名，标识当前同步客户端的版本 */
public final static String GTASK_JSON_CLIENT_VERSION = "client_version";
/** JSON中任务完成状态的键名，标识任务是否已完成（true/false） */
public final static String GTASK_JSON_COMPLETED = "completed";
/** JSON中当前列表ID的键名，标识当前操作的任务列表ID */
public final static String GTASK_JSON_CURRENT_LIST_ID = "current_list_id";
/** JSON中默认列表ID的键名，标识GTask中的默认任务列表ID */
public final static String GTASK_JSON_DEFAULT_LIST_ID = "default_list_id";
/** JSON中删除状态的键名，标识任务/文件夹是否已删除（true/false） */
public final static String GTASK_JSON_DELETED = "deleted";
/** JSON中目标列表的键名，用于移动操作时指定目标列表 */
public final static String GTASK_JSON_DEST_LIST = "dest_list";
/** JSON中目标父节点的键名，用于移动操作时指定目标父节点 */
public final static String GTASK_JSON_DEST_PARENT = "dest_parent";
/** JSON中目标父节点类型的键名，标识目标父节点是任务（TASK）还是文件夹（GROUP） */
public final static String GTASK_JSON_DEST_PARENT_TYPE = "dest_parent_type";
/** JSON中实体增量的键名，用于存储任务/文件夹的修改内容（如名称、状态等） */
public final static String GTASK_JSON_ENTITY_DELTA = "entity_delta";
/** JSON中实体类型的键名，标识当前实体是任务（TASK）还是文件夹（GROUP） */
public final static String GTASK_JSON_ENTITY_TYPE = "entity_type";
/** JSON中获取已删除实体的键名，用于请求GTask中已删除的任务/文件夹 */
public final static String GTASK_JSON_GET_DELETED = "get_deleted";
/** JSON中实体ID的键名，标识任务/文件夹在GTask中的唯一ID */
public final static String GTASK_JSON_ID = "id";
/** JSON中排序索引的键名，标识任务/文件夹在列表中的位置（用于排序） */
public final static String GTASK_JSON_INDEX = "index";
/** JSON中最后修改时间的键名，标识任务/文件夹的最近修改时间（用于同步冲突判断） */
public final static String GTASK_JSON_LAST_MODIFIED = "last_modified";
/** JSON中最新同步点的键名，标识上次同步的时间点（用于增量同步） */
public final static String GTASK_JSON_LATEST_SYNC_POINT = "latest_sync_point";
/** JSON中列表ID的键名，标识当前任务所属的列表ID */
public final static String GTASK_JSON_LIST_ID = "list_id";
/** JSON中列表集合的键名，用于存储多个任务列表数据 */
public final static String GTASK_JSON_LISTS = "lists";
/** JSON中名称的键名，标识任务/文件夹的名称 */
public final static String GTASK_JSON_NAME = "name";
/** JSON中新ID的键名，用于标识创建操作后GTask返回的新实体ID */
public final static String GTASK_JSON_NEW_ID = "new_id";
/** JSON中备注的键名，标识任务的备注内容 */
public final static String GTASK_JSON_NOTES = "notes";
/** JSON中父节点ID的键名，标识当前实体的父节点ID（用于层级结构） */
public final static String GTASK_JSON_PARENT_ID = "parent_id";
/** JSON中前序兄弟节点ID的键名，标识当前实体的前一个兄弟节点（用于排序） */
public final static String GTASK_JSON_PRIOR_SIBLING_ID = "prior_sibling_id";
/** JSON中结果集合的键名，用于存储GTask返回的同步结果 */
public final static String GTASK_JSON_RESULTS = "results";
/** JSON中源列表的键名，用于移动操作时指定源列表 */
public final static String GTASK_JSON_SOURCE_LIST = "source_list";
/** JSON中任务集合的键名，用于存储多个任务数据 */
public final static String GTASK_JSON_TASKS = "tasks";
/** JSON中类型的键名，与ENTITY_TYPE配合使用 */
public final static String GTASK_JSON_TYPE = "type";
/** 实体类型：文件夹（分组），标识当前实体是GTask中的文件夹 */
public final static String GTASK_JSON_TYPE_GROUP = "GROUP";
/** 实体类型：任务，标识当前实体是GTask中的任务 */
public final static String GTASK_JSON_TYPE_TASK = "TASK";
/** JSON中用户信息的键名，标识当前同步的用户 */
public final static String GTASK_JSON_USER = "user";
// ========================== 小米便签专属文件夹标识 ==========================
/** 小米便签文件夹前缀，用于在GTask中区分小米便签创建的文件夹（避免与其他应用冲突） */
public final static String MIUI_FOLDER_PREFFIX = "[MIUI_Notes]";
/** 小米便签默认文件夹名称，拼接前缀后为"[MIUI_Notes]Default" */
public final static String FOLDER_DEFAULT = "Default";
/** 小米便签通话记录文件夹名称，拼接前缀后为"[MIUI_Notes]Call_Note" */
public final static String FOLDER_CALL_NOTE = "Call_Note";
/** 小米便签元数据文件夹名称，用于存储便签的额外信息（如本地ID、附件信息等） */
public final static String FOLDER_META = "METADATA";
// ========================== 元数据相关键名 ==========================
/** 元数据中GTask ID的键名，用于存储实体在GTask中的ID */
public final static String META_HEAD_GTASK_ID = "meta_gid";
/** 元数据中便签信息的键名，用于存储便签的核心信息（如ID、类型等） */
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";
}
}

209
src/tool/ResourceParser.java
Unescape View File

@ -22,151 +22,238 @@ 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 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 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 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;
public static final int BG_DEFAULT_FONT_SIZE = TEXT_MEDIUM; // 默认字体大小
/**
* 便签编辑页背景资源管理
* 提供编辑页主体背景和标题栏背景的资源获取
*/
public static class NoteBgResources {
// 编辑页主体背景资源数组（与颜色常量顺序对应）
private final static int [] BG_EDIT_RESOURCES = new int [] {
R.drawable.edit_yellow,
R.drawable.edit_blue,
R.drawable.edit_white,
R.drawable.edit_green,
R.drawable.edit_red
R.drawable.edit_yellow, // 黄色背景
R.drawable.edit_blue, // 蓝色背景
R.drawable.edit_white, // 白色背景
R.drawable.edit_green, // 绿色背景
R.drawable.edit_red // 红色背景
};
// 编辑页标题栏背景资源数组（与颜色常量顺序对应）
private final static int [] BG_EDIT_TITLE_RESOURCES = new int [] {
R.drawable.edit_title_yellow,
R.drawable.edit_title_blue,
R.drawable.edit_title_white,
R.drawable.edit_title_green,
R.drawable.edit_title_red
R.drawable.edit_title_yellow, // 黄色标题栏
R.drawable.edit_title_blue, // 蓝色标题栏
R.drawable.edit_title_white, // 白色标题栏
R.drawable.edit_title_green, // 绿色标题栏
R.drawable.edit_title_red // 红色标题栏
};
/**
* 获取便签编辑页主体背景资源
* @param id 颜色标识（如YELLOW、BLUE等）
* @return 背景图片资源ID
*/
public static int getNoteBgResource(int id) {
return BG_EDIT_RESOURCES[id];
}
/**
* 获取便签编辑页标题栏背景资源
* @param id 颜色标识（如YELLOW、BLUE等）
* @return 标题栏背景图片资源ID
*/
public static int getNoteTitleBgResource(int id) {
return BG_EDIT_TITLE_RESOURCES[id];
}
}
/**
* 获取默认背景颜色ID
* 根据用户设置判断：若开启随机背景，则返回随机颜色；否则返回默认黄色
* @param context 上下文
* @return 背景颜色标识
*/
public static int getDefaultBgId(Context context) {
if (PreferenceManager.getDefaultSharedPreferences(context).getBoolean(
NotesPreferenceActivity.PREFERENCE_SET_BG_COLOR_KEY, false)) {
// 随机选择背景颜色（0到背景资源数量-1之间）
return (int) (Math.random() * NoteBgResources.BG_EDIT_RESOURCES.length);
} else {
// 返回默认背景色
return BG_DEFAULT_COLOR;
}
}
/**
* 便签列表项背景资源管理
* 针对列表中不同位置的项（首项、中间项、末项、唯一项）提供对应的背景资源
*/
public static class NoteItemBgResources {
// 列表首项背景资源数组
private final static int [] BG_FIRST_RESOURCES = new int [] {
R.drawable.list_yellow_up,
R.drawable.list_blue_up,
R.drawable.list_white_up,
R.drawable.list_green_up,
R.drawable.list_red_up
R.drawable.list_yellow_up, // 黄色首项
R.drawable.list_blue_up, // 蓝色首项
R.drawable.list_white_up, // 白色首项
R.drawable.list_green_up, // 绿色首项
R.drawable.list_red_up // 红色首项
};
// 列表中间项背景资源数组
private final static int [] BG_NORMAL_RESOURCES = new int [] {
R.drawable.list_yellow_middle,
R.drawable.list_blue_middle,
R.drawable.list_white_middle,
R.drawable.list_green_middle,
R.drawable.list_red_middle
R.drawable.list_yellow_middle, // 黄色中间项
R.drawable.list_blue_middle, // 蓝色中间项
R.drawable.list_white_middle, // 白色中间项
R.drawable.list_green_middle, // 绿色中间项
R.drawable.list_red_middle // 红色中间项
};
// 列表末项背景资源数组
private final static int [] BG_LAST_RESOURCES = new int [] {
R.drawable.list_yellow_down,
R.drawable.list_blue_down,
R.drawable.list_white_down,
R.drawable.list_green_down,
R.drawable.list_red_down,
R.drawable.list_yellow_down, // 黄色末项
R.drawable.list_blue_down, // 蓝色末项
R.drawable.list_white_down, // 白色末项
R.drawable.list_green_down, // 绿色末项
R.drawable.list_red_down, // 红色末项
};
// 列表唯一项（仅一项时）背景资源数组
private final static int [] BG_SINGLE_RESOURCES = new int [] {
R.drawable.list_yellow_single,
R.drawable.list_blue_single,
R.drawable.list_white_single,
R.drawable.list_green_single,
R.drawable.list_red_single
R.drawable.list_yellow_single, // 黄色唯一项
R.drawable.list_blue_single, // 蓝色唯一项
R.drawable.list_white_single, // 白色唯一项
R.drawable.list_green_single, // 绿色唯一项
R.drawable.list_red_single // 红色唯一项
};
/**
* 获取列表首项背景资源
* @param id 颜色标识
* @return 首项背景资源ID
*/
public static int getNoteBgFirstRes(int id) {
return BG_FIRST_RESOURCES[id];
}
/**
* 获取列表末项背景资源
* @param id 颜色标识
* @return 末项背景资源ID
*/
public static int getNoteBgLastRes(int id) {
return BG_LAST_RESOURCES[id];
}
/**
* 获取列表唯一项背景资源
* @param id 颜色标识
* @return 唯一项背景资源ID
*/
public static int getNoteBgSingleRes(int id) {
return BG_SINGLE_RESOURCES[id];
}
/**
* 获取列表中间项背景资源
* @param id 颜色标识
* @return 中间项背景资源ID
*/
public static int getNoteBgNormalRes(int id) {
return BG_NORMAL_RESOURCES[id];
}
/**
* 获取文件夹项背景资源
* @return 文件夹背景资源ID
*/
public static int getFolderBgRes() {
return R.drawable.list_folder;
}
}
/**
* 桌面小部件（Widget）背景资源管理
* 提供不同尺寸Widget的背景资源
*/
public static class WidgetBgResources {
// 2x尺寸Widget背景资源数组
private final static int [] BG_2X_RESOURCES = new int [] {
R.drawable.widget_2x_yellow,
R.drawable.widget_2x_blue,
R.drawable.widget_2x_white,
R.drawable.widget_2x_green,
R.drawable.widget_2x_red,
R.drawable.widget_2x_yellow, // 2x黄色Widget
R.drawable.widget_2x_blue, // 2x蓝色Widget
R.drawable.widget_2x_white, // 2x白色Widget
R.drawable.widget_2x_green, // 2x绿色Widget
R.drawable.widget_2x_red, // 2x红色Widget
};
/**
* 获取2x尺寸Widget背景资源
* @param id 颜色标识
* @return 2x Widget背景资源ID
*/
public static int getWidget2xBgResource(int id) {
return BG_2X_RESOURCES[id];
}
// 4x尺寸Widget背景资源数组
private final static int [] BG_4X_RESOURCES = new int [] {
R.drawable.widget_4x_yellow,
R.drawable.widget_4x_blue,
R.drawable.widget_4x_white,
R.drawable.widget_4x_green,
R.drawable.widget_4x_red
R.drawable.widget_4x_yellow, // 4x黄色Widget
R.drawable.widget_4x_blue, // 4x蓝色Widget
R.drawable.widget_4x_white, // 4x白色Widget
R.drawable.widget_4x_green, // 4x绿色Widget
R.drawable.widget_4x_red // 4x红色Widget
};
/**
* 获取4x尺寸Widget背景资源
* @param id 颜色标识
* @return 4x Widget背景资源ID
*/
public static int getWidget4xBgResource(int id) {
return BG_4X_RESOURCES[id];
}
}
/**
* 文字样式资源管理
* 提供不同字体大小的样式资源
*/
public static class TextAppearanceResources {
// 文字样式资源数组（与字体大小常量顺序对应）
private final static int [] TEXTAPPEARANCE_RESOURCES = new int [] {
R.style.TextAppearanceNormal,
R.style.TextAppearanceMedium,
R.style.TextAppearanceLarge,
R.style.TextAppearanceSuper
R.style.TextAppearanceNormal, // 小字体样式
R.style.TextAppearanceMedium, // 中字体样式
R.style.TextAppearanceLarge, // 大字体样式
R.style.TextAppearanceSuper // 超大字体样式
};
/**
* 获取文字样式资源
* @param id 字体大小标识（如TEXT_SMALL、TEXT_MEDIUM等）
* @return 文字样式资源ID（若id无效则返回默认样式）
*/
public static int getTexAppearanceResource(int id) {
/**
* HACKME: Fix bug of store the resource id in shared preference.
* The id may larger than the length of resources, in this case,
* return the {@link ResourceParser#BG_DEFAULT_FONT_SIZE}
* 兼容处理：防止存储的资源ID超出范围
* 若id无效，返回默认字体大小样式
*/
if (id >= TEXTAPPEARANCE_RESOURCES.length) {
return BG_DEFAULT_FONT_SIZE;
@ -174,8 +261,12 @@ public class ResourceParser {
return TEXTAPPEARANCE_RESOURCES[id];
}
/**
* 获取文字样式资源数量
* @return 样式资源数组长度
*/
public static int getResourcesSize() {
return TEXTAPPEARANCE_RESOURCES.length;
}
}
}
}

77
src/ui/AlarmAlertActivity.java
Unescape View File

@ -40,20 +40,31 @@ import net.micode.notes.tool.DataUtils;
import java.io.IOException;
/**
* 便签提醒活动页，负责在便签提醒时间到达时显示提醒对话框并播放闹钟声音
* 实现对话框按钮点击监听和对话框消失监听，处理用户操作
*/
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
@ -61,11 +72,15 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
| WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
}
// 获取启动当前Activity的Intent（由AlarmReceiver传递）
Intent intent = getIntent();
try {
// 从Intent的Data中解析便签ID（Data格式为content://.../notes/{id}，取路径的第2段）
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;
@ -74,85 +89,115 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD
return;
}
// 初始化媒体播放器
mPlayer = new MediaPlayer();
// 检查便签是否存在且可见（未被删除）
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) {
// 显示提醒对话框
showActionDialog();
// 播放闹钟声音
playAlarmSound();
} else {
// 便签不存在则直接结束活动
finish();
}
}
/**
* 判断屏幕是否处于亮屏状态
* @return 屏幕亮着返回true，否则返回false
*/
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(),
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
e.printStackTrace();
} catch (SecurityException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IllegalStateException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
} catch (IllegalArgumentException | SecurityException | IllegalStateException | IOException e) {
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);
}
/**
* 处理对话框按钮点击事件
* @param dialog 对话框实例
* @param which 点击的按钮标识（BUTTON_POSITIVE/BUTTON_NEGATIVE）
*/
public void onClick(DialogInterface dialog, int which) {
switch (which) {
// 点击“进入”按钮：跳转到便签编辑页查看完整内容
case DialogInterface.BUTTON_NEGATIVE:
Intent intent = new Intent(this, NoteEditActivity.class);
intent.setAction(Intent.ACTION_VIEW);
intent.putExtra(Intent.EXTRA_UID, mNoteId);
intent.setAction(Intent.ACTION_VIEW); // 动作：查看便签
intent.putExtra(Intent.EXTRA_UID, mNoteId); // 传递便签ID
startActivity(intent);
break;
// 点击“确定”按钮：默认不做额外操作，对话框消失后会停止铃声并结束活动
default:
break;
}
}
/**
* 对话框消失时触发：停止铃声并结束活动
* @param dialog 对话框实例
*/
public void onDismiss(DialogInterface dialog) {
stopAlarmSound();
finish();
}
/**
* 停止闹钟铃声并释放媒体播放器资源
*/
private void stopAlarmSound() {
if (mPlayer != null) {
mPlayer.stop();
mPlayer.release();
mPlayer.stop(); // 停止播放
mPlayer.release(); // 释放资源
mPlayer = null;
}
}
}
}

61
src/ui/AlarmInitReceiver.java
Unescape View File

@ -27,39 +27,74 @@ import android.database.Cursor;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
/**
* 便签提醒初始化接收器
* 用于在系统启动或特定事件触发时，重新注册所有未过期的便签提醒闹钟
* 确保用户设置的便签提醒不会因系统重启等原因丢失
*/
public class AlarmInitReceiver extends BroadcastReceiver {
/**
* 数据库查询字段投影：只查询便签ID和提醒时间
* 优化查询效率，避免获取不必要的字段
*/
private static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.ALERTED_DATE
NoteColumns.ID, // 便签ID
NoteColumns.ALERTED_DATE // 提醒时间戳
};
private static final int COLUMN_ID = 0;
private static final int COLUMN_ALERTED_DATE = 1;
// 字段索引常量，用于快速访问Cursor中的数据
private static final int COLUMN_ID = 0; // 便签ID在投影中的索引
private static final int COLUMN_ALERTED_DATE = 1; // 提醒时间在投影中的索引
/**
* 接收广播时触发的回调方法
* 负责查询所有未过期的便签提醒，并重新注册到AlarmManager
* @param context 上下文对象
* @param intent 接收到的广播意图
*/
@Override
public void onReceive(Context context, Intent intent) {
// 获取当前系统时间，用于筛选未过期的提醒
long currentDate = System.currentTimeMillis();
Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
// 查询数据库中所有未过期的便签提醒
// 条件：提醒时间 > 当前时间 且 便签类型为普通便签（TYPE_NOTE）
Cursor c = context.getContentResolver().query(
Notes.CONTENT_NOTE_URI, // 查询的内容URI（指向便签表）
PROJECTION, // 需要查询的字段
NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
new String[] { String.valueOf(currentDate) },
null);
new String[] { String.valueOf(currentDate) }, // 筛选条件参数（当前时间）
null // 排序方式（无需排序）
);
if (c != null) {
// 遍历查询结果，为每个未过期的提醒注册闹钟
if (c.moveToFirst()) {
do {
// 获取便签的提醒时间
long alertDate = c.getLong(COLUMN_ALERTED_DATE);
// 创建触发提醒时的意图（指向AlarmReceiver）
Intent sender = new Intent(context, AlarmReceiver.class);
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
// 为意图附加便签ID，便于后续定位具体便签
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
c.getLong(COLUMN_ID)));
// 创建延迟执行的PendingIntent（用于触发提醒）
PendingIntent pendingIntent = PendingIntent.getBroadcast(
context, 0, sender, 0);
// 获取AlarmManager服务，用于设置系统闹钟
AlarmManager alermManager = (AlarmManager) context
.getSystemService(Context.ALARM_SERVICE);
// 注册闹钟：在指定时间（alertDate）唤醒设备并发送广播
// RTC_WAKEUP模式确保在设备休眠时也能触发
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
} while (c.moveToNext());
} while (c.moveToNext()); // 继续处理下一个便签
}
// 关闭Cursor，释放资源
c.close();
}
}
}
}

18
src/ui/AlarmReceiver.java
Unescape View File

@ -20,11 +20,27 @@ import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
/**
* 便签提醒广播接收器，负责接收系统闹钟触发的广播，并启动提醒展示界面
* 是小米便签提醒流程中连接闹钟触发与提醒展示的中间组件
*/
public class AlarmReceiver extends BroadcastReceiver {
/**
* 接收广播时触发的回调方法
* @param context 上下文环境，用于启动Activity
* @param intent 接收到的意图，包含触发提醒的便签信息（如便签ID）
*/
@Override
public void onReceive(Context context, Intent intent) {
// 将意图的目标组件设置为AlarmAlertActivity（便签提醒展示界面）
// 确保广播中携带的便签信息（如Data中的便签ID）被传递给目标界面
intent.setClass(context, AlarmAlertActivity.class);
// 添加FLAG_ACTIVITY_NEW_TASK标志：在BroadcastReceiver中启动Activity必须设置此标志
// 因为BroadcastReceiver本身没有任务栈，需要为启动的Activity创建新任务栈
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
// 启动AlarmAlertActivity，展示便签提醒对话框并播放铃声
context.startActivity(intent);
}
}
}

259
src/ui/DateTimePicker.java
Unescape View File

@ -28,57 +28,75 @@ import android.view.View;
import android.widget.FrameLayout;
import android.widget.NumberPicker;
/**
* 日期时间选择器组件
* 用于小米便签中设置提醒时间，支持日期、小时、分钟的选择，以及12/24小时制切换
*/
public class DateTimePicker extends FrameLayout {
// 默认启用状态
private static final boolean DEFAULT_ENABLE_STATE = true;
private static final int HOURS_IN_HALF_DAY = 12;
private static final int HOURS_IN_ALL_DAY = 24;
private static final int DAYS_IN_ALL_WEEK = 7;
private static final int DATE_SPINNER_MIN_VAL = 0;
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1;
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0;
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23;
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1;
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12;
private static final int MINUT_SPINNER_MIN_VAL = 0;
private static final int MINUT_SPINNER_MAX_VAL = 59;
private static final int AMPM_SPINNER_MIN_VAL = 0;
private static final int AMPM_SPINNER_MAX_VAL = 1;
private final NumberPicker mDateSpinner;
private final NumberPicker mHourSpinner;
private final NumberPicker mMinuteSpinner;
private final NumberPicker mAmPmSpinner;
private Calendar mDate;
// 时间计算常量定义
private static final int HOURS_IN_HALF_DAY = 12; // 半天的小时数
private static final int HOURS_IN_ALL_DAY = 24; // 一天的小时数
private static final int DAYS_IN_ALL_WEEK = 7; // 一周的天数
private static final int DATE_SPINNER_MIN_VAL = 0; // 日期选择器最小值
private static final int DATE_SPINNER_MAX_VAL = DAYS_IN_ALL_WEEK - 1; // 日期选择器最大值
private static final int HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW = 0; // 24小时制小时最小值
private static final int HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW = 23; // 24小时制小时最大值
private static final int HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW = 1; // 12小时制小时最小值
private static final int HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW = 12; // 12小时制小时最大值
private static final int MINUT_SPINNER_MIN_VAL = 0; // 分钟选择器最小值
private static final int MINUT_SPINNER_MAX_VAL = 59; // 分钟选择器最大值
private static final int AMPM_SPINNER_MIN_VAL = 0; // 上下午选择器最小值
private static final int AMPM_SPINNER_MAX_VAL = 1; // 上下午选择器最大值
// 选择器组件
private final NumberPicker mDateSpinner; // 日期选择器（显示近一周日期）
private final NumberPicker mHourSpinner; // 小时选择器
private final NumberPicker mMinuteSpinner; // 分钟选择器
private final NumberPicker mAmPmSpinner; // 上下午选择器（12小时制用）
private Calendar mDate; // 日期时间计算工具
// 日期显示值数组（存储近一周的日期文本）
private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK];
private boolean mIsAm;
private boolean mIs24HourView;
private boolean mIsEnabled = DEFAULT_ENABLE_STATE;
private boolean mInitialising;
// 时间状态变量
private boolean mIsAm; // 是否为上午（12小时制）
private boolean mIs24HourView; // 是否为24小时制显示
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) {
// 计算日期偏移量并更新
mDate.add(Calendar.DAY_OF_YEAR, newVal - oldVal);
updateDateControl();
onDateTimeChanged();
}
};
/**
* 小时选择器值变化监听器
* 处理小时变更逻辑，包括跨天情况（如23点到0点）和12/24小时制转换
*/
private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
boolean isDateChanged = false;
Calendar cal = Calendar.getInstance();
if (!mIs24HourView) {
// 12小时制处理：跨天情况（如11PM到12AM需加一天，12AM到11PM需减一天）
if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
@ -88,12 +106,14 @@ public class DateTimePicker extends FrameLayout {
cal.add(Calendar.DAY_OF_YEAR, -1);
isDateChanged = true;
}
// 12点和11点切换时，切换上下午状态
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;
updateAmPmControl();
}
} else {
// 24小时制处理：跨天情况（如23点到0点加一天，0点到23点减一天）
if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {
cal.setTimeInMillis(mDate.getTimeInMillis());
cal.add(Calendar.DAY_OF_YEAR, 1);
@ -104,9 +124,13 @@ public class DateTimePicker extends FrameLayout {
isDateChanged = true;
}
}
// 更新小时并触发事件
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,39 +139,55 @@ public class DateTimePicker extends FrameLayout {
}
};
/**
* 分钟选择器值变化监听器
* 处理分钟变更逻辑，包括跨小时情况（如59分到0分需加1小时）
*/
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;
// 判断是否跨小时（59->0加1小时，0->59减1小时）
if (oldVal == maxValue && newVal == minValue) {
offset += 1;
} else if (oldVal == minValue && newVal == maxValue) {
offset -= 1;
}
if (offset != 0) {
// 调整小时并更新相关控件
mDate.add(Calendar.HOUR_OF_DAY, offset);
mHourSpinner.setValue(getCurrentHour());
updateDateControl();
// 更新上下午状态（12小时制）
int newHour = getCurrentHourOfDay();
if (newHour >= HOURS_IN_HALF_DAY) {
mIsAm = false;
updateAmPmControl();
} else {
mIsAm = true;
updateAmPmControl();
}
updateAmPmControl();
}
// 更新分钟并触发事件
mDate.set(Calendar.MINUTE, newVal);
onDateTimeChanged();
}
};
/**
* 上下午选择器值变化监听器
* 切换上午/下午状态，并调整小时（加减12小时）
*/
private NumberPicker.OnValueChangeListener mOnAmPmChangedListener = new NumberPicker.OnValueChangeListener() {
@Override
public void onValueChange(NumberPicker picker, int oldVal, int newVal) {
mIsAm = !mIsAm;
// 切换上下午时调整小时（上午转下午加12小时，反之减12小时）
if (mIsAm) {
mDate.add(Calendar.HOUR_OF_DAY, -HOURS_IN_HALF_DAY);
} else {
@ -158,39 +198,65 @@ public class DateTimePicker extends FrameLayout {
}
};
/**
* 日期时间变更监听器接口
* 当用户修改日期或时间时回调
*/
public interface OnDateTimeChangedListener {
void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute);
int dayOfMonth, int hourOfDay, int minute);
}
/**
* 构造方法：使用当前时间初始化，默认使用系统时间格式（12/24小时制）
* @param context 上下文
*/
public DateTimePicker(Context context) {
this(context, System.currentTimeMillis());
}
/**
* 构造方法：使用指定时间初始化，默认使用系统时间格式（12/24小时制）
* @param context 上下文
* @param date 初始化时间戳（毫秒）
*/
public DateTimePicker(Context context, long date) {
this(context, date, DateFormat.is24HourFormat(context));
}
/**
* 构造方法：使用指定时间和时间格式初始化
* @param context 上下文
* @param date 初始化时间戳（毫秒）
* @param is24HourView 是否使用24小时制
*/
public DateTimePicker(Context context, long date, boolean is24HourView) {
super(context);
mDate = Calendar.getInstance();
mInitialising = true;
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY;
mIsAm = getCurrentHourOfDay() >= HOURS_IN_HALF_DAY; // 初始化上下午状态
// 加载布局
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.setOnLongPressUpdateInterval(100); // 长按更新间隔（毫秒）
mMinuteSpinner.setOnValueChangedListener(mOnMinuteChangedListener);
// 初始化上下午选择器（使用系统本地化的AM/PM文本）
String[] stringsForAmPm = new DateFormatSymbols().getAmPmStrings();
mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm);
mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL);
@ -198,22 +264,28 @@ public class DateTimePicker extends FrameLayout {
mAmPmSpinner.setDisplayedValues(stringsForAmPm);
mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener);
// update controls to initial state
// 更新控件到初始状态
updateDateControl();
updateHourControl();
updateAmPmControl();
// 设置时间格式（12/24小时制）
set24HourView(is24HourView);
// set to current time
// 设置初始时间
setCurrentDate(date);
// 设置启用状态
setEnabled(isEnabled());
// set the content descriptions
// 初始化完成
mInitialising = false;
}
/**
* 设置组件启用状态
* @param enabled 是否启用
*/
@Override
public void setEnabled(boolean enabled) {
if (mIsEnabled == enabled) {
@ -227,24 +299,26 @@ public class DateTimePicker extends FrameLayout {
mIsEnabled = enabled;
}
/**
* 获取组件启用状态
* @return 是否启用
*/
@Override
public boolean isEnabled() {
return mIsEnabled;
}
/**
* Get the current date in millis
*
* @return the current date in millis
* 获取当前选中的日期时间（毫秒时间戳）
* @return 时间戳
*/
public long getCurrentDateInTimeMillis() {
return mDate.getTimeInMillis();
}
/**
* Set the current date
*
* @param date The current date in millis
* 设置当前日期时间（通过时间戳）
* @param date 时间戳（毫秒）
*/
public void setCurrentDate(long date) {
Calendar cal = Calendar.getInstance();
@ -254,16 +328,15 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Set the current date
*
* @param year The current year
* @param month The current month
* @param dayOfMonth The current dayOfMonth
* @param hourOfDay The current hourOfDay
* @param minute The current minute
* 设置当前日期时间（通过年月日时分）
* @param year 年
* @param month 月（0-11）
* @param dayOfMonth 日
* @param hourOfDay 时（24小时制，0-23）
* @param minute 分
*/
public void setCurrentDate(int year, int month,
int dayOfMonth, int hourOfDay, int minute) {
int dayOfMonth, int hourOfDay, int minute) {
setCurrentYear(year);
setCurrentMonth(month);
setCurrentDay(dayOfMonth);
@ -272,18 +345,16 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current year
*
* @return The current year
* 获取当前年份
* @return 年份
*/
public int getCurrentYear() {
return mDate.get(Calendar.YEAR);
}
/**
* Set current year
*
* @param year The current year
* 设置当前年份
* @param year 年份
*/
public void setCurrentYear(int year) {
if (!mInitialising && year == getCurrentYear()) {
@ -295,18 +366,16 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current month in the year
*
* @return The current month in the year
* 获取当前月份（0-11）
* @return 月份
*/
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）
*/
public void setCurrentMonth(int month) {
if (!mInitialising && month == getCurrentMonth()) {
@ -318,18 +387,16 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Get current day of the month
*
* @return The day of the month
* 获取当前日
* @return 日
*/
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 日
*/
public void setCurrentDay(int dayOfMonth) {
if (!mInitialising && dayOfMonth == getCurrentDay()) {
@ -341,18 +408,23 @@ 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
* 获取当前小时（24小时制，0-23）
* @return 小时
*/
public int getCurrentHourOfDay() {
return mDate.get(Calendar.HOUR_OF_DAY);
}
/**
* 根据当前时间格式（12/24小时制）获取小时显示值
* @return 小时显示值
*/
private int getCurrentHour() {
if (mIs24HourView){
return getCurrentHourOfDay();
} else {
int hour = getCurrentHourOfDay();
// 12小时制转换：13->1，0->12
if (hour > HOURS_IN_HALF_DAY) {
return hour - HOURS_IN_HALF_DAY;
} else {
@ -362,16 +434,17 @@ public class DateTimePicker extends FrameLayout {
}
/**
* Set current hour in 24 hour mode, in the range (0~23)
*
* @param hourOfDay
* 设置当前小时（24小时制）
* @param hourOfDay 小时（0-23）
*/
public void setCurrentHour(int hourOfDay) {
if (!mInitialising && hourOfDay == getCurrentHourOfDay()) {
return;
}
mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
if (!mIs24HourView) {
// 12小时制处理：更新上下午状态和小时显示值
if (hourOfDay >= HOURS_IN_HALF_DAY) {
mIsAm = false;
if (hourOfDay > HOURS_IN_HALF_DAY) {
@ -385,21 +458,22 @@ public class DateTimePicker extends FrameLayout {
}
updateAmPmControl();
}
mHourSpinner.setValue(hourOfDay);
onDateTimeChanged();
}
/**
* Get currentMinute
*
* @return The Current Minute
* 获取当前分钟
* @return 分钟
*/
public int getCurrentMinute() {
return mDate.get(Calendar.MINUTE);
}
/**
* Set current minute
* 设置当前分钟
* @param minute 分钟（0-59）
*/
public void setCurrentMinute(int minute) {
if (!mInitialising && minute == getCurrentMinute()) {
@ -411,22 +485,23 @@ public class DateTimePicker extends FrameLayout {
}
/**
* @return true if this is in 24 hour view else false.
* 判断是否为24小时制显示
* @return 是否为24小时制
*/
public boolean is24HourView () {
return mIs24HourView;
}
/**
* Set whether in 24 hour or AM/PM mode.
*
* @param is24HourView True for 24 hour mode. False for AM/PM mode.
* 设置时间显示格式（24小时制/12小时制）
* @param is24HourView true为24小时制，false为12小时制
*/
public void set24HourView(boolean is24HourView) {
if (mIs24HourView == is24HourView) {
return;
}
mIs24HourView = is24HourView;
// 24小时制隐藏上下午选择器，12小时制显示
mAmPmSpinner.setVisibility(is24HourView ? View.GONE : View.VISIBLE);
int hour = getCurrentHourOfDay();
updateHourControl();
@ -434,20 +509,30 @@ public class DateTimePicker extends FrameLayout {
updateAmPmControl();
}
/**
* 更新日期选择器显示内容（近一周的日期，格式：月.日 星期）
*/
private void updateDateControl() {
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(mDate.getTimeInMillis());
// 计算起始日期（当前日期减去3天，用于显示近一周）
cal.add(Calendar.DAY_OF_YEAR, -DAYS_IN_ALL_WEEK / 2 - 1);
mDateSpinner.setDisplayedValues(null);
// 生成近一周的日期文本
for (int i = 0; i < DAYS_IN_ALL_WEEK; ++i) {
cal.add(Calendar.DAY_OF_YEAR, 1);
mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal);
}
mDateSpinner.setDisplayedValues(mDateDisplayValues);
mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2);
mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); // 默认选中当前日期
mDateSpinner.invalidate();
}
/**
* 更新上下午选择器状态（根据12小时制和当前上下午状态）
*/
private void updateAmPmControl() {
if (mIs24HourView) {
mAmPmSpinner.setVisibility(View.GONE);
@ -458,6 +543,9 @@ public class DateTimePicker extends FrameLayout {
}
}
/**
* 更新小时选择器的范围（根据12/24小时制）
*/
private void updateHourControl() {
if (mIs24HourView) {
mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW);
@ -469,17 +557,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
* 设置日期时间变更监听器
* @param callback 监听器实例
*/
public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) {
mOnDateTimeChangedListener = callback;
}
/**
* 触发日期时间变更事件（通知监听器）
*/
private void onDateTimeChanged() {
if (mOnDateTimeChangedListener != null) {
mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(),
getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute());
}
}
}
}

59
src/ui/DateTimePickerDialog.java
Unescape View File

@ -29,60 +29,107 @@ import android.content.DialogInterface.OnClickListener;
import android.text.format.DateFormat;
import android.text.format.DateUtils;
/**
* 日期时间选择对话框，用于小米便签中设置提醒时间的交互界面
* 继承自AlertDialog，内部集成DateTimePicker作为选择视图，提供日期和时间的可视化选择
*/
public class DateTimePickerDialog extends AlertDialog implements OnClickListener {
// 用于维护当前选中的日期时间
private Calendar mDate = Calendar.getInstance();
// 是否采用24小时制显示时间
private boolean mIs24HourView;
// 日期时间选择完成后的回调监听器（由调用者实现，如NoteEditActivity）
private OnDateTimeSetListener mOnDateTimeSetListener;
// 自定义的日期时间选择器视图，负责用户选择交互
private DateTimePicker mDateTimePicker;
/**
* 日期时间选择完成的回调接口
* 当用户点击"确定"后，通过此接口将选中的时间（毫秒级时间戳）传递给调用者
*/
public interface OnDateTimeSetListener {
void OnDateTimeSet(AlertDialog dialog, long date);
}
/**
* 构造方法：初始化日期时间选择对话框
* @param context 上下文环境（如NoteEditActivity）
* @param date 初始日期时间（毫秒级时间戳，通常为当前时间或便签已有的提醒时间）
*/
public DateTimePickerDialog(Context context, long date) {
super(context);
// 初始化自定义的日期时间选择器
mDateTimePicker = new DateTimePicker(context);
// 将选择器设置为对话框的内容视图
setView(mDateTimePicker);
// 为日期时间选择器设置变化监听器：当用户选择的日期或时间变化时触发
mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() {
public void onDateTimeChanged(DateTimePicker view, int year, int month,
int dayOfMonth, int hourOfDay, int minute) {
int dayOfMonth, int hourOfDay, int minute) {
// 更新内部维护的日期时间
mDate.set(Calendar.YEAR, year);
mDate.set(Calendar.MONTH, month);
mDate.set(Calendar.DAY_OF_MONTH, dayOfMonth);
mDate.set(Calendar.HOUR_OF_DAY, hourOfDay);
mDate.set(Calendar.MINUTE, minute);
// 根据新选择的时间更新对话框标题
updateTitle(mDate.getTimeInMillis());
}
});
// 设置初始日期时间（忽略秒数，确保提醒时间精确到分钟）
mDate.setTimeInMillis(date);
mDate.set(Calendar.SECOND, 0);
mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());
// 设置对话框按钮："确定"按钮触发onClick方法，"取消"按钮不执行操作
setButton(context.getString(R.string.datetime_dialog_ok), this);
setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null);
// 根据系统设置初始化24小时制显示模式
set24HourView(DateFormat.is24HourFormat(this.getContext()));
// 初始化对话框标题为初始日期时间
updateTitle(mDate.getTimeInMillis());
}
/**
* 设置时间显示模式（24小时制/12小时制）
* @param is24HourView true为24小时制，false为12小时制
*/
public void set24HourView(boolean is24HourView) {
mIs24HourView = is24HourView;
}
/**
* 设置日期时间选择完成后的回调监听器
* @param callBack 实现了OnDateTimeSetListener的对象（通常为调用对话框的Activity）
*/
public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) {
mOnDateTimeSetListener = callBack;
}
/**
* 更新对话框标题，显示当前选中的日期时间
* @param date 选中的日期时间（毫秒级时间戳）
*/
private void updateTitle(long date) {
int flag =
DateUtils.FORMAT_SHOW_YEAR |
DateUtils.FORMAT_SHOW_DATE |
DateUtils.FORMAT_SHOW_TIME;
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR;
// 定义日期时间的显示格式：包含年、月、日、时间
int flag = DateUtils.FORMAT_SHOW_YEAR | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_TIME;
// 根据24小时制模式调整显示格式
flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_12HOUR;
// 格式化时间并设置为对话框标题
setTitle(DateUtils.formatDateTime(this.getContext(), date, flag));
}
/**
* 处理"确定"按钮的点击事件
* 当用户点击确定后，通过回调接口将选中的时间传递给调用者
*/
public void onClick(DialogInterface arg0, int arg1) {
if (mOnDateTimeSetListener != null) {
// 回调传递选中的时间（毫秒级时间戳）
mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis());
}
}

33
src/ui/DropdownMenu.java
Unescape View File

@ -27,17 +27,35 @@ import android.widget.PopupMenu.OnMenuItemClickListener;
import net.micode.notes.R;
/**
* 下拉菜单工具类，用于在小米便签中实现按钮触发的弹出式菜单
* 典型场景：笔记列表的批量操作菜单、编辑页的功能选项菜单等
*/
public class DropdownMenu {
// 触发下拉菜单的按钮
private Button mButton;
// 系统提供的弹出式菜单组件，负责显示下拉选项
private PopupMenu mPopupMenu;
// 菜单容器，存储从资源文件加载的菜单项
private Menu mMenu;
/**
* 构造方法：初始化下拉菜单
* @param context 上下文对象，用于访问资源和创建视图
* @param button 触发下拉菜单的按钮
* @param menuId 菜单资源ID（定义在res/menu目录下）
*/
public DropdownMenu(Context context, Button button, int menuId) {
mButton = button;
// 设置按钮背景为下拉图标（箭头图标）
mButton.setBackgroundResource(R.drawable.dropdown_icon);
// 初始化PopupMenu，绑定到触发按钮
mPopupMenu = new PopupMenu(context, mButton);
// 获取菜单容器
mMenu = mPopupMenu.getMenu();
// 从资源文件加载菜单项到菜单容器
mPopupMenu.getMenuInflater().inflate(menuId, mMenu);
// 设置按钮点击事件：点击时显示下拉菜单
mButton.setOnClickListener(new OnClickListener() {
public void onClick(View v) {
mPopupMenu.show();
@ -45,17 +63,30 @@ public class DropdownMenu {
});
}
/**
* 设置下拉菜单项的点击事件监听器
* @param listener 监听器对象，处理菜单项点击逻辑
*/
public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {
if (mPopupMenu != null) {
mPopupMenu.setOnMenuItemClickListener(listener);
}
}
/**
* 根据ID查找菜单中的具体选项
* @param id 菜单项的资源ID
* @return 对应的MenuItem对象，可用于修改状态（如勾选、隐藏）
*/
public MenuItem findItem(int id) {
return mMenu.findItem(id);
}
/**
* 设置触发按钮的显示文本
* @param title 要显示的文本（如"已选择3项"）
*/
public void setTitle(CharSequence title) {
mButton.setText(title);
}
}
}

64
src/ui/FoldersListAdapter.java
Unescape View File

@ -28,53 +28,103 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.data.Notes.NoteColumns;
/**
* 文件夹列表适配器，用于小米便签中展示文件夹列表（如移动便签时选择目标文件夹）
* 继承自CursorAdapter，负责将数据库中的文件夹数据与列表视图绑定
*/
public class FoldersListAdapter extends CursorAdapter {
/**
* 数据库查询投影：指定需要查询的文件夹字段
* 包含文件夹ID（用于区分不同文件夹）和文件夹名称（存储在SNIPPET字段）
*/
public static final String [] PROJECTION = {
NoteColumns.ID,
NoteColumns.SNIPPET
NoteColumns.ID, // 文件夹ID
NoteColumns.SNIPPET // 文件夹名称（小米便签中文件夹名称存储在此字段）
};
public static final int ID_COLUMN = 0;
public static final int NAME_COLUMN = 1;
/**
* 投影字段对应的索引，用于从Cursor中快速获取数据
*/
public static final int ID_COLUMN = 0; // PROJECTION中ID字段的索引
public static final int NAME_COLUMN = 1; // PROJECTION中SNIPPET（名称）字段的索引
/**
* 构造方法：初始化文件夹列表适配器
* @param context 上下文环境（如调用文件夹列表的Activity或对话框）
* @param c 包含文件夹数据的数据库游标（查询结果）
*/
public FoldersListAdapter(Context context, Cursor c) {
super(context, c);
// TODO Auto-generated constructor stub
}
/**
* 创建新的列表项视图
* @param context 上下文环境
* @param cursor 包含当前项数据的游标（此处未直接使用，仅用于创建视图）
* @param parent 父视图容器（通常为ListView）
* @return 自定义的文件夹列表项视图（FolderListItem实例）
*/
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
return new FolderListItem(context);
}
/**
* 将游标中的文件夹数据绑定到列表项视图
* @param view 列表项视图（FolderListItem实例）
* @param context 上下文环境
* @param cursor 包含当前文件夹数据的游标
*/
@Override
public void bindView(View view, Context context, Cursor cursor) {
if (view instanceof FolderListItem) {
// 处理根文件夹的特殊名称：根文件夹ID为Notes.ID_ROOT_FOLDER，显示为“移动到父文件夹”
String folderName = (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
.getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
// 将文件夹名称绑定到列表项视图
((FolderListItem) view).bind(folderName);
}
}
/**
* 根据位置获取文件夹名称
* @param context 上下文环境
* @param position 列表项位置
* @return 对应位置的文件夹名称（根文件夹特殊处理）
*/
public String getFolderName(Context context, int position) {
Cursor cursor = (Cursor) getItem(position);
// 根文件夹特殊处理，其他文件夹直接取SNIPPET字段值
return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context
.getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN);
}
/**
* 自定义文件夹列表项视图，继承LinearLayout，用于展示单个文件夹的名称
*/
private class FolderListItem extends LinearLayout {
private TextView mName;
private TextView mName; // 用于显示文件夹名称的文本控件
/**
* 构造方法：初始化列表项布局和控件
* @param context 上下文环境
*/
public FolderListItem(Context context) {
super(context);
// 加载文件夹列表项的布局文件（folder_list_item.xml）
inflate(context, R.layout.folder_list_item, this);
// 获取布局中的文本控件，用于显示文件夹名称
mName = (TextView) findViewById(R.id.tv_folder_name);
}
/**
* 为列表项设置文件夹名称
* @param name 文件夹名称（可能是根文件夹的特殊名称或普通文件夹名称）
*/
public void bind(String name) {
mName.setText(name);
}
}
}
}

488
src/ui/NoteEditActivity.java
View File

File diff suppressed because it is too large Load Diff

123
src/ui/NoteEditText.java
Unescape View File

@ -37,73 +37,114 @@ import net.micode.notes.R;
import java.util.HashMap;
import java.util.Map;
/**
* 小米便签的自定义文本输入控件，继承自EditText，扩展了便签编辑的核心交互功能
* 支持多输入框管理、链接识别与交互、精确光标定位等
*/
public class NoteEditText extends EditText {
private static final String TAG = "NoteEditText";
// 当前输入框在多输入框列表中的索引（用于区分不同输入框）
private int mIndex;
// 记录删除键按下前的光标起始位置（用于判断是否删除当前输入框）
private int mSelectionStartBeforeDelete;
private static final String SCHEME_TEL = "tel:" ;
private static final String SCHEME_HTTP = "http:" ;
private static final String SCHEME_EMAIL = "mailto:" ;
// 支持的链接协议常量
private static final String SCHEME_TEL = "tel:" ; // 电话协议（如"tel:10086"）
private static final String SCHEME_HTTP = "http:" ; // 网页协议（如"http://www.micode.net"）
private static final String SCHEME_EMAIL = "mailto:" ; // 邮件协议（如"mailto:test@micode.net"）
// 链接协议与对应菜单资源的映射（用于上下文菜单显示对应操作文字）
private static final Map<String, Integer> sSchemaActionResMap = new HashMap<String, Integer>();
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);
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); // 邮件链接对应"发送邮件"菜单
}
/**
* Call by the {@link NoteEditActivity} to delete or add edit text
* 文本视图变化监听器，由{@link NoteEditActivity}实现，用于处理输入框的增删和文本状态变化
*/
public interface OnTextViewChangeListener {
/**
* Delete current edit text when {@link KeyEvent#KEYCODE_DEL} happens
* and the text is null
* 当按下删除键且文本为空时，删除当前输入框
* @param index 当前输入框的索引
* @param text 当前输入框的文本内容
*/
void onEditTextDelete(int index, String text);
/**
* Add edit text after current edit text when {@link KeyEvent#KEYCODE_ENTER}
* happen
* 当按下回车键时，在当前输入框后新增一个输入框
* @param index 新增输入框的索引（当前索引+1）
* @param text 回车键后需要移动到新输入框的文本
*/
void onEditTextEnter(int index, String text);
/**
* Hide or show item option when text change
* 当文本内容变化时，通知是否显示输入框相关操作选项
* @param index 当前输入框的索引
* @param hasText 文本是否非空（用于控制操作选项的显示/隐藏）
*/
void onTextChange(int index, boolean hasText);
}
// 文本变化监听器实例（由NoteEditActivity设置）
private OnTextViewChangeListener mOnTextViewChangeListener;
/**
* 构造方法：初始化文本输入控件（仅上下文参数）
* @param context 上下文环境（如NoteEditActivity）
*/
public NoteEditText(Context context) {
super(context, null);
mIndex = 0;
mIndex = 0; // 默认索引为0
}
/**
* 设置当前输入框在多输入框列表中的索引
* @param index 输入框索引
*/
public void setIndex(int index) {
mIndex = index;
}
/**
* 设置文本变化监听器，关联到NoteEditActivity
* @param listener 实现了OnTextViewChangeListener的监听器
*/
public void setOnTextViewChangeListener(OnTextViewChangeListener listener) {
mOnTextViewChangeListener = listener;
}
/**
* 构造方法：初始化文本输入控件（上下文+属性集）
* @param context 上下文环境
* @param attrs 布局中定义的属性集合
*/
public NoteEditText(Context context, AttributeSet attrs) {
super(context, attrs, android.R.attr.editTextStyle);
}
/**
* 构造方法：初始化文本输入控件（上下文+属性集+样式）
* @param context 上下文环境
* @param attrs 属性集合
* @param defStyle 默认样式
*/
public NoteEditText(Context context, AttributeSet attrs, int defStyle) {
super(context, attrs, defStyle);
// TODO Auto-generated constructor stub
}
/**
* 处理触摸事件，精确设置光标位置（根据触摸坐标计算光标应在的文本位置）
* @param event 触摸事件（包含触摸坐标等信息）
* @return 事件是否被处理
*/
@Override
public boolean onTouchEvent(MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
// 计算触摸点在文本中的实际坐标（扣除内边距并加上滚动偏移）
int x = (int) event.getX();
int y = (int) event.getY();
x -= getTotalPaddingLeft();
@ -111,25 +152,33 @@ public class NoteEditText extends EditText {
x += getScrollX();
y += getScrollY();
// 根据坐标获取对应的文本行和偏移量，设置光标位置
Layout layout = getLayout();
int line = layout.getLineForVertical(y);
int off = layout.getOffsetForHorizontal(line, x);
Selection.setSelection(getText(), off);
int line = layout.getLineForVertical(y); // 触摸点所在的文本行
int off = layout.getOffsetForHorizontal(line, x); // 行内的水平偏移（光标位置）
Selection.setSelection(getText(), off); // 设置光标
break;
}
return super.onTouchEvent(event);
}
/**
* 处理键盘按下事件，记录删除键按下前的光标位置
* @param keyCode 按键代码（如KEYCODE_DEL、KEYCODE_ENTER）
* @param event 键盘事件
* @return 事件是否被处理
*/
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
switch (keyCode) {
case KeyEvent.KEYCODE_ENTER:
// 回车键事件由onKeyUp处理，此处返回false让事件继续传递
if (mOnTextViewChangeListener != null) {
return false;
}
break;
case KeyEvent.KEYCODE_DEL:
// 记录删除键按下前的光标起始位置，用于判断是否需要删除输入框
mSelectionStartBeforeDelete = getSelectionStart();
break;
default:
@ -138,11 +187,18 @@ public class NoteEditText extends EditText {
return super.onKeyDown(keyCode, event);
}
/**
* 处理键盘抬起事件，触发输入框增删逻辑
* @param keyCode 按键代码
* @param event 键盘事件
* @return 事件是否被处理
*/
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
switch(keyCode) {
case KeyEvent.KEYCODE_DEL:
if (mOnTextViewChangeListener != null) {
// 若光标在起始位置且不是第一个输入框，通知删除当前输入框
if (0 == mSelectionStartBeforeDelete && mIndex != 0) {
mOnTextViewChangeListener.onEditTextDelete(mIndex, getText().toString());
return true;
@ -153,10 +209,11 @@ public class NoteEditText extends EditText {
break;
case KeyEvent.KEYCODE_ENTER:
if (mOnTextViewChangeListener != null) {
// 处理回车键：将光标后的文本移至新输入框
int selectionStart = getSelectionStart();
String text = getText().subSequence(selectionStart, length()).toString();
setText(getText().subSequence(0, selectionStart));
mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text);
String text = getText().subSequence(selectionStart, length()).toString(); // 光标后文本
setText(getText().subSequence(0, selectionStart)); // 保留光标前文本
mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); // 通知新增输入框
} else {
Log.d(TAG, "OnTextViewChangeListener was not seted");
}
@ -167,9 +224,16 @@ public class NoteEditText extends EditText {
return super.onKeyUp(keyCode, event);
}
/**
* 处理焦点变化事件，通知监听器文本是否为空（用于控制操作选项显示）
* @param focused 是否获得焦点
* @param direction 焦点移动方向
* @param previouslyFocusedRect 上一个焦点区域
*/
@Override
protected void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect) {
if (mOnTextViewChangeListener != null) {
// 失去焦点且文本为空时，通知无文本；否则通知有文本
if (!focused && TextUtils.isEmpty(getText())) {
mOnTextViewChangeListener.onTextChange(mIndex, false);
} else {
@ -179,18 +243,24 @@ public class NoteEditText extends EditText {
super.onFocusChanged(focused, direction, previouslyFocusedRect);
}
/**
* 创建上下文菜单，识别选中的链接并显示对应操作选项（如拨打、打开网页）
* @param menu 上下文菜单实例
*/
@Override
protected void onCreateContextMenu(ContextMenu menu) {
// 仅处理富文本中的链接
if (getText() instanceof Spanned) {
int selStart = getSelectionStart();
int selEnd = getSelectionEnd();
int min = Math.min(selStart, selEnd);
int max = Math.max(selStart, selEnd);
// 获取选中区域内的链接
final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class);
if (urls.length == 1) {
if (urls.length == 1) { // 仅处理单个链接的情况
int defaultResId = 0;
// 识别链接协议，匹配对应的菜单资源
for(String schema: sSchemaActionResMap.keySet()) {
if(urls[0].getURL().indexOf(schema) >= 0) {
defaultResId = sSchemaActionResMap.get(schema);
@ -198,15 +268,16 @@ public class NoteEditText extends EditText {
}
}
// 未匹配到已知协议时，使用默认菜单文本
if (defaultResId == 0) {
defaultResId = R.string.note_link_other;
}
// 向菜单添加链接操作项，点击后触发链接的默认行为（如拨号、打开浏览器）
menu.add(0, 0, 0, defaultResId).setOnMenuItemClickListener(
new OnMenuItemClickListener() {
public boolean onMenuItemClick(MenuItem item) {
// goto a new intent
urls[0].onClick(NoteEditText.this);
urls[0].onClick(NoteEditText.this); // 触发URLSpan的点击事件
return true;
}
});
@ -214,4 +285,4 @@ public class NoteEditText extends EditText {
}
super.onCreateContextMenu(menu);
}
}
}

203
src/ui/NoteItemData.java
Unescape View File

@ -26,57 +26,70 @@ import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.tool.DataUtils;
/**
* 小米便签列表项的数据模型类，封装单个便签的核心信息及列表位置属性，用于支撑列表UI展示
*/
public class NoteItemData {
// 数据库查询的列名数组，对应便签表的核心字段
static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.ALERTED_DATE,
NoteColumns.BG_COLOR_ID,
NoteColumns.CREATED_DATE,
NoteColumns.HAS_ATTACHMENT,
NoteColumns.MODIFIED_DATE,
NoteColumns.NOTES_COUNT,
NoteColumns.PARENT_ID,
NoteColumns.SNIPPET,
NoteColumns.TYPE,
NoteColumns.WIDGET_ID,
NoteColumns.WIDGET_TYPE,
NoteColumns.ID, // 便签ID
NoteColumns.ALERTED_DATE, // 提醒时间
NoteColumns.BG_COLOR_ID, // 背景色ID
NoteColumns.CREATED_DATE, // 创建时间
NoteColumns.HAS_ATTACHMENT, // 是否有附件
NoteColumns.MODIFIED_DATE, // 修改时间
NoteColumns.NOTES_COUNT, // 文件夹包含的便签数量（仅文件夹类型有效）
NoteColumns.PARENT_ID, // 父文件夹ID
NoteColumns.SNIPPET, // 内容摘要（文件夹名或便签内容片段）
NoteColumns.TYPE, // 类型（便签/文件夹/系统文件夹）
NoteColumns.WIDGET_ID, // 桌面插件ID
NoteColumns.WIDGET_TYPE, // 桌面插件类型
};
private static final int ID_COLUMN = 0;
private static final int ALERTED_DATE_COLUMN = 1;
private static final int BG_COLOR_ID_COLUMN = 2;
private static final int CREATED_DATE_COLUMN = 3;
private static final int HAS_ATTACHMENT_COLUMN = 4;
private static final int MODIFIED_DATE_COLUMN = 5;
private static final int NOTES_COUNT_COLUMN = 6;
private static final int PARENT_ID_COLUMN = 7;
private static final int SNIPPET_COLUMN = 8;
private static final int TYPE_COLUMN = 9;
private static final int WIDGET_ID_COLUMN = 10;
private static final int WIDGET_TYPE_COLUMN = 11;
private long mId;
private long mAlertDate;
private int mBgColorId;
private long mCreatedDate;
private boolean mHasAttachment;
private long mModifiedDate;
private int mNotesCount;
private long mParentId;
private String mSnippet;
private int mType;
private int mWidgetId;
private int mWidgetType;
private String mName;
private String mPhoneNumber;
private boolean mIsLastItem;
private boolean mIsFirstItem;
private boolean mIsOnlyOneItem;
private boolean mIsOneNoteFollowingFolder;
private boolean mIsMultiNotesFollowingFolder;
// 上述PROJECTION数组中各列的索引常量，用于从Cursor中提取数据
private static final int ID_COLUMN = 0; // 便签ID索引
private static final int ALERTED_DATE_COLUMN = 1; // 提醒时间索引
private static final int BG_COLOR_ID_COLUMN = 2; // 背景色ID索引
private static final int CREATED_DATE_COLUMN = 3; // 创建时间索引
private static final int HAS_ATTACHMENT_COLUMN = 4; // 是否有附件索引
private static final int MODIFIED_DATE_COLUMN = 5; // 修改时间索引
private static final int NOTES_COUNT_COLUMN = 6; // 文件夹便签数量索引
private static final int PARENT_ID_COLUMN = 7; // 父文件夹ID索引
private static final int SNIPPET_COLUMN = 8; // 内容摘要索引
private static final int TYPE_COLUMN = 9; // 类型索引
private static final int WIDGET_ID_COLUMN = 10; // 桌面插件ID索引
private static final int WIDGET_TYPE_COLUMN = 11; // 桌面插件类型索引
// 便签核心数据字段
private long mId; // 便签唯一ID
private long mAlertDate; // 提醒时间（毫秒时间戳）
private int mBgColorId; // 背景色ID（对应资源文件）
private long mCreatedDate; // 创建时间（毫秒时间戳）
private boolean mHasAttachment; // 是否有附件（如图片等）
private long mModifiedDate; // 最后修改时间（毫秒时间戳）
private int mNotesCount; // 文件夹包含的便签数量（仅文件夹类型使用）
private long mParentId; // 所属文件夹ID
private String mSnippet; // 内容摘要（文件夹名或便签内容的简短展示）
private int mType; // 类型（Notes.TYPE_NOTE：便签；TYPE_FOLDER：文件夹等）
private int mWidgetId; // 关联的桌面插件ID（无则为无效值）
private int mWidgetType; // 桌面插件类型（无则为无效值）
private String mName; // 通话记录便签的联系人姓名（非通话记录则为空）
private String mPhoneNumber; // 通话记录便签的电话号码（非通话记录则为空）
// 列表位置属性（用于UI背景样式适配）
private boolean mIsLastItem; // 是否为列表最后一项
private boolean mIsFirstItem; // 是否为列表第一项
private boolean mIsOnlyOneItem; // 是否为列表中唯一一项
private boolean mIsOneNoteFollowingFolder; // 是否为文件夹后的唯一便签项
private boolean mIsMultiNotesFollowingFolder; // 是否为文件夹后的多个便签项之一
/**
* 构造方法：从数据库查询游标中提取数据初始化便签信息
* @param context 上下文环境（用于获取联系人信息等）
* @param cursor 数据库查询结果游标（包含便签表数据）
*/
public NoteItemData(Context context, Cursor cursor) {
// 从游标中提取核心数据字段
mId = cursor.getLong(ID_COLUMN);
mAlertDate = cursor.getLong(ALERTED_DATE_COLUMN);
mBgColorId = cursor.getInt(BG_COLOR_ID_COLUMN);
@ -86,19 +99,21 @@ public class NoteItemData {
mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN);
mParentId = cursor.getLong(PARENT_ID_COLUMN);
mSnippet = cursor.getString(SNIPPET_COLUMN);
// 移除检查列表标记（用于纯文本展示）
mSnippet = mSnippet.replace(NoteEditActivity.TAG_CHECKED, "").replace(
NoteEditActivity.TAG_UNCHECKED, "");
mType = cursor.getInt(TYPE_COLUMN);
mWidgetId = cursor.getInt(WIDGET_ID_COLUMN);
mWidgetType = cursor.getInt(WIDGET_TYPE_COLUMN);
// 处理通话记录便签：提取电话号码并关联联系人姓名
mPhoneNumber = "";
if (mParentId == Notes.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);
mName = Contact.getContact(context, mPhoneNumber); // 获取联系人姓名
if (mName == null) {
mName = mPhoneNumber;
mName = mPhoneNumber; // 无联系人时显示电话号码
}
}
}
@ -106,27 +121,39 @@ public class NoteItemData {
if (mName == null) {
mName = "";
}
// 计算当前项在列表中的位置属性
checkPostion(cursor);
}
/**
* 判断当前项在游标中的位置，初始化位置属性（用于UI背景样式适配）
* @param cursor 数据库查询结果游标
*/
private void checkPostion(Cursor cursor) {
mIsLastItem = cursor.isLast() ? true : false;
mIsFirstItem = cursor.isFirst() ? true : false;
mIsOnlyOneItem = (cursor.getCount() == 1);
mIsLastItem = cursor.isLast() ? true : false; // 是否为最后一项
mIsFirstItem = cursor.isFirst() ? true : false; // 是否为第一项
mIsOnlyOneItem = (cursor.getCount() == 1); // 是否为唯一一项
// 初始化文件夹后便签的位置属性
mIsMultiNotesFollowingFolder = false;
mIsOneNoteFollowingFolder = false;
// 若当前是便签项且不是第一项，检查前一项是否为文件夹
if (mType == Notes.TYPE_NOTE && !mIsFirstItem) {
int position = cursor.getPosition();
if (cursor.moveToPrevious()) {
if (cursor.moveToPrevious()) { // 移动到前一项
// 前一项是文件夹或系统文件夹
if (cursor.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER
|| cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) {
// 若游标总数大于当前位置+1，说明文件夹后有多个便签
if (cursor.getCount() > (position + 1)) {
mIsMultiNotesFollowingFolder = true;
} else {
// 否则文件夹后只有当前一个便签
mIsOneNoteFollowingFolder = true;
}
}
// 移回原位置，避免游标错乱
if (!cursor.moveToNext()) {
throw new IllegalStateException("cursor move to previous but can't move back");
}
@ -134,91 +161,159 @@ public class NoteItemData {
}
}
/**
* 是否为文件夹后的唯一便签项
*/
public boolean isOneFollowingFolder() {
return mIsOneNoteFollowingFolder;
}
/**
* 是否为文件夹后的多个便签项之一
*/
public boolean isMultiFollowingFolder() {
return mIsMultiNotesFollowingFolder;
}
/**
* 是否为列表最后一项
*/
public boolean isLast() {
return mIsLastItem;
}
/**
* 获取通话记录便签的联系人姓名（非通话记录返回空）
*/
public String getCallName() {
return mName;
}
/**
* 是否为列表第一项
*/
public boolean isFirst() {
return mIsFirstItem;
}
/**
* 是否为列表中唯一一项
*/
public boolean isSingle() {
return mIsOnlyOneItem;
}
/**
* 获取便签ID
*/
public long getId() {
return mId;
}
/**
* 获取提醒时间（毫秒时间戳）
*/
public long getAlertDate() {
return mAlertDate;
}
/**
* 获取创建时间（毫秒时间戳）
*/
public long getCreatedDate() {
return mCreatedDate;
}
/**
* 是否有附件
*/
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);
}
/**
* 是否为通话记录便签（属于通话记录文件夹且有电话号码）
*/
public boolean isCallRecord() {
return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber));
}
/**
* 从游标中获取便签类型
* @param cursor 数据库查询结果游标
* @return 便签类型（Notes.TYPE_NOTE等）
*/
public static int getNoteType(Cursor cursor) {
return cursor.getInt(TYPE_COLUMN);
}
}
}

490
src/ui/NotesListActivity.java
View File

File diff suppressed because it is too large Load Diff

101
src/ui/NotesListAdapter.java
Unescape View File

@ -31,18 +31,30 @@ import java.util.HashSet;
import java.util.Iterator;
/**
* 便签列表适配器，用于将便签数据与列表视图绑定，支持多选操作
* 继承自CursorAdapter，通过Cursor获取数据库中的便签数据
*/
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;
private Context mContext; // 上下文对象
private HashMap<Integer, Boolean> mSelectedIndex; // 存储选中项的位置和状态
private int mNotesCount; // 便签总数（不包含文件夹）
private boolean mChoiceMode; // 是否处于选择模式
/**
* 桌面插件属性封装类
* 用于存储选中项中包含的桌面插件信息
*/
public static class AppWidgetAttribute {
public int widgetId;
public int widgetType;
public int widgetId; // 插件ID
public int widgetType; // 插件类型
};
/**
* 构造方法
* @param context 上下文对象
*/
public NotesListAdapter(Context context) {
super(context, null);
mSelectedIndex = new HashMap<Integer, Boolean>();
@ -50,38 +62,71 @@ public class NotesListAdapter extends CursorAdapter {
mNotesCount = 0;
}
/**
* 创建新的列表项视图
* @param context 上下文
* @param cursor 数据游标
* @param parent 父容器
* @return 新创建的NotesListItem视图
*/
@Override
public View newView(Context context, Cursor cursor, ViewGroup parent) {
return new NotesListItem(context);
}
/**
* 绑定数据到列表项视图
* @param view 列表项视图
* @param context 上下文
* @param cursor 数据游标
*/
@Override
public void bindView(View view, Context context, Cursor cursor) {
if (view instanceof NotesListItem) {
// 从游标中解析便签数据
NoteItemData itemData = new NoteItemData(context, cursor);
// 绑定数据到视图，设置选择模式和选中状态
((NotesListItem) view).bind(context, itemData, mChoiceMode,
isSelectedItem(cursor.getPosition()));
}
}
/**
* 设置指定位置的选中状态
* @param position 列表项位置
* @param checked 是否选中
*/
public void setCheckedItem(final int position, final boolean checked) {
mSelectedIndex.put(position, checked);
notifyDataSetChanged();
notifyDataSetChanged(); // 通知列表刷新
}
/**
* 判断是否处于选择模式
* @return 是否为选择模式
*/
public boolean isInChoiceMode() {
return mChoiceMode;
}
/**
* 设置选择模式
* @param mode 选择模式开关
*/
public void setChoiceMode(boolean mode) {
mSelectedIndex.clear();
mSelectedIndex.clear(); // 清除选中状态
mChoiceMode = mode;
}
/**
* 全选或取消全选所有便签（仅对普通便签有效）
* @param checked 是否选中
*/
public void selectAll(boolean checked) {
Cursor cursor = getCursor();
for (int i = 0; i < getCount(); i++) {
if (cursor.moveToPosition(i)) {
// 仅处理类型为普通便签的项
if (NoteItemData.getNoteType(cursor) == Notes.TYPE_NOTE) {
setCheckedItem(i, checked);
}
@ -89,11 +134,16 @@ public class NotesListAdapter extends CursorAdapter {
}
}
/**
* 获取所有选中项的ID集合
* @return 选中项ID的HashSet
*/
public HashSet<Long> getSelectedItemIds() {
HashSet<Long> itemSet = new HashSet<Long>();
for (Integer position : mSelectedIndex.keySet()) {
if (mSelectedIndex.get(position) == true) {
Long id = getItemId(position);
// 过滤根文件夹ID（不应被选中）
if (id == Notes.ID_ROOT_FOLDER) {
Log.d(TAG, "Wrong item id, should not happen");
} else {
@ -101,10 +151,13 @@ public class NotesListAdapter extends CursorAdapter {
}
}
}
return itemSet;
}
/**
* 获取所有选中项中的桌面插件属性
* @return 插件属性的HashSet
*/
public HashSet<AppWidgetAttribute> getSelectedWidget() {
HashSet<AppWidgetAttribute> itemSet = new HashSet<AppWidgetAttribute>();
for (Integer position : mSelectedIndex.keySet()) {
@ -116,9 +169,7 @@ public class NotesListAdapter extends CursorAdapter {
widget.widgetId = item.getWidgetId();
widget.widgetType = item.getWidgetType();
itemSet.add(widget);
/**
* Don't close cursor here, only the adapter could close it
*/
// 注意：此处不关闭游标，游标由适配器管理
} else {
Log.e(TAG, "Invalid cursor");
return null;
@ -128,6 +179,10 @@ public class NotesListAdapter extends CursorAdapter {
return itemSet;
}
/**
* 获取选中项的数量
* @return 选中项数量
*/
public int getSelectedCount() {
Collection<Boolean> values = mSelectedIndex.values();
if (null == values) {
@ -143,11 +198,20 @@ public class NotesListAdapter extends CursorAdapter {
return count;
}
/**
* 判断是否所有便签都被选中
* @return 是否全选
*/
public boolean isAllSelected() {
int checkedCount = getSelectedCount();
return (checkedCount != 0 && checkedCount == mNotesCount);
}
/**
* 判断指定位置的项是否被选中
* @param position 列表项位置
* @return 是否选中
*/
public boolean isSelectedItem(final int position) {
if (null == mSelectedIndex.get(position)) {
return false;
@ -155,23 +219,34 @@ public class NotesListAdapter extends CursorAdapter {
return mSelectedIndex.get(position);
}
/**
* 当数据发生变化时回调，重新计算便签数量
*/
@Override
protected void onContentChanged() {
super.onContentChanged();
calcNotesCount();
}
/**
* 更换游标时回调，重新计算便签数量
* @param cursor 新游标
*/
@Override
public void changeCursor(Cursor cursor) {
super.changeCursor(cursor);
calcNotesCount();
}
/**
* 计算普通便签的总数（排除文件夹）
*/
private void calcNotesCount() {
mNotesCount = 0;
for (int i = 0; i < getCount(); i++) {
Cursor c = (Cursor) getItem(i);
if (c != null) {
// 仅统计类型为普通便签的项
if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) {
mNotesCount++;
}
@ -181,4 +256,4 @@ public class NotesListAdapter extends CursorAdapter {
}
}
}
}
}

81
src/ui/NotesListItem.java
Unescape View File

@ -30,17 +30,27 @@ import net.micode.notes.tool.DataUtils;
import net.micode.notes.tool.ResourceParser.NoteItemBgResources;
/**
* 小米便签列表中的单个项视图
* 负责展示便签、文件夹或通话记录的内容及状态，支持多选模式
*/
public class NotesListItem extends LinearLayout {
private ImageView mAlert;
private TextView mTitle;
private TextView mTime;
private TextView mCallName;
private NoteItemData mItemData;
private CheckBox mCheckBox;
private ImageView mAlert; // 提醒图标（显示闹钟或通话记录图标）
private TextView mTitle; // 标题/内容文本（显示便签内容、文件夹名称等）
private TextView mTime; // 时间文本（显示最后修改时间）
private TextView mCallName; // 通话记录联系人名称（仅通话记录便签显示）
private NoteItemData mItemData; // 当前项对应的数据模型
private CheckBox mCheckBox; // 多选模式下的复选框
/**
* 构造方法：初始化布局和控件
* @param context 上下文对象
*/
public NotesListItem(Context context) {
super(context);
// 加载列表项布局文件
inflate(context, R.layout.note_item, this);
// 绑定UI控件
mAlert = (ImageView) findViewById(R.id.iv_alert_icon);
mTitle = (TextView) findViewById(R.id.tv_title);
mTime = (TextView) findViewById(R.id.tv_time);
@ -48,7 +58,15 @@ public class NotesListItem extends LinearLayout {
mCheckBox = (CheckBox) findViewById(android.R.id.checkbox);
}
/**
* 绑定数据到当前列表项，根据数据类型和模式展示不同样式
* @param context 上下文对象
* @param data 便签数据模型
* @param choiceMode 是否处于多选模式
* @param checked 多选模式下是否被选中
*/
public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) {
// 处理多选模式：仅普通便签显示复选框并同步选中状态
if (choiceMode && data.getType() == Notes.TYPE_NOTE) {
mCheckBox.setVisibility(View.VISIBLE);
mCheckBox.setChecked(checked);
@ -57,33 +75,44 @@ public class NotesListItem extends LinearLayout {
}
mItemData = data;
// 处理通话记录文件夹（特殊系统文件夹）
if (data.getId() == Notes.ID_CALL_RECORD_FOLDER) {
mCallName.setVisibility(View.GONE);
mAlert.setVisibility(View.VISIBLE);
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()));
mAlert.setImageResource(R.drawable.call_record);
mAlert.setImageResource(R.drawable.call_record); // 显示通话记录图标
// 处理通话记录文件夹下的便签
} else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) {
mCallName.setVisibility(View.VISIBLE);
mCallName.setText(data.getCallName());
mTitle.setTextAppearance(context,R.style.TextAppearanceSecondaryItem);
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
mCallName.setText(data.getCallName()); // 显示联系人名称
mTitle.setTextAppearance(context, R.style.TextAppearanceSecondaryItem);
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet())); // 显示便签内容片段
// 显示提醒图标（如有）
if (data.hasAlert()) {
mAlert.setImageResource(R.drawable.clock);
mAlert.setVisibility(View.VISIBLE);
} else {
mAlert.setVisibility(View.GONE);
}
// 处理普通文件夹和普通便签
} else {
mCallName.setVisibility(View.GONE);
mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem);
// 普通文件夹：显示名称和包含的便签数量
if (data.getType() == Notes.TYPE_FOLDER) {
mTitle.setText(data.getSnippet()
+ context.getString(R.string.format_folder_files_count,
data.getNotesCount()));
data.getNotesCount()));
mAlert.setVisibility(View.GONE);
// 普通便签：显示内容片段和提醒状态
} else {
mTitle.setText(DataUtils.getFormattedSnippet(data.getSnippet()));
if (data.hasAlert()) {
@ -94,29 +123,47 @@ public class NotesListItem extends LinearLayout {
}
}
}
// 显示最后修改时间（相对时间格式，如"1小时前"）
mTime.setText(DateUtils.getRelativeTimeSpanString(data.getModifiedDate()));
// 设置项背景样式
setBackground(data);
}
/**
* 根据便签类型和位置设置背景样式
* @param data 便签数据模型
*/
private void setBackground(NoteItemData data) {
int id = data.getBgColorId();
int bgColorId = data.getBgColorId(); // 获取背景色ID
// 普通便签：根据位置（首项/末项/单项等）设置不同背景
if (data.getType() == Notes.TYPE_NOTE) {
if (data.isSingle() || data.isOneFollowingFolder()) {
setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id));
// 单项或文件夹后的唯一便签
setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(bgColorId));
} else if (data.isLast()) {
setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(id));
// 列表中的最后一项
setBackgroundResource(NoteItemBgResources.getNoteBgLastRes(bgColorId));
} else if (data.isFirst() || data.isMultiFollowingFolder()) {
setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(id));
// 首项或文件夹后的多个便签中的第一项
setBackgroundResource(NoteItemBgResources.getNoteBgFirstRes(bgColorId));
} else {
setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id));
// 中间项
setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(bgColorId));
}
} else {
// 文件夹：使用固定的文件夹背景
setBackgroundResource(NoteItemBgResources.getFolderBgRes());
}
}
/**
* 获取当前项的数据模型
* @return 便签数据模型
*/
public NoteItemData getItemData() {
return mItemData;
}
}
}

119
src/ui/NotesPreferenceActivity.java
Unescape View File

@ -48,41 +48,52 @@ import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.gtask.remote.GTaskSyncService;
/**
* 小米便签的设置页面
* 负责账号管理、同步控制及偏好设置，支持便签数据同步功能
*/
public class NotesPreferenceActivity extends PreferenceActivity {
// 偏好设置存储名称
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;
@Override
protected void onCreate(Bundle icicle) {
super.onCreate(icicle);
/* using the app icon for navigation */
// 设置ActionBar支持返回导航
getActionBar().setDisplayHomeAsUpEnabled(true);
// 加载偏好设置布局
addPreferencesFromResource(R.xml.preferences);
// 获取账号设置分类
mAccountCategory = (PreferenceCategory) findPreference(PREFERENCE_SYNC_ACCOUNT_KEY);
// 初始化广播接收器并注册，监听同步服务广播
mReceiver = new GTaskReceiver();
IntentFilter filter = new IntentFilter();
filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME);
registerReceiver(mReceiver, filter);
// 初始化账号列表和头部视图
mOriAccounts = null;
View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null);
getListView().addHeaderView(header, null, true);
@ -92,8 +103,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
protected void onResume() {
super.onResume();
// need to set sync account automatically if user has added a new
// account
// 如果检测到新添加的账号，自动设置为同步账号
if (mHasAddedAccount) {
Account[] accounts = getGoogleAccounts();
if (mOriAccounts != null && accounts.length > mOriAccounts.length) {
@ -113,17 +123,22 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
// 刷新UI显示
refreshUI();
}
@Override
protected void onDestroy() {
// 注销广播接收器
if (mReceiver != null) {
unregisterReceiver(mReceiver);
}
super.onDestroy();
}
/**
* 加载账号设置项到偏好页面
*/
private void loadAccountPreference() {
mAccountCategory.removeAll();
@ -131,20 +146,21 @@ public class NotesPreferenceActivity extends PreferenceActivity {
final String defaultAccount = getSyncAccountName(this);
accountPref.setTitle(getString(R.string.preferences_account_title));
accountPref.setSummary(getString(R.string.preferences_account_summary));
// 设置账号项点击事件
accountPref.setOnPreferenceClickListener(new OnPreferenceClickListener() {
public boolean onPreferenceClick(Preference preference) {
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.makeText(NotesPreferenceActivity.this,
R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
R.string.preferences_toast_cannot_change_account, Toast.LENGTH_SHORT)
.show();
}
return true;
@ -154,15 +170,19 @@ public class NotesPreferenceActivity extends PreferenceActivity {
mAccountCategory.addPreference(accountPref);
}
/**
* 加载同步按钮和同步状态显示
*/
private void loadSyncButton() {
Button syncButton = (Button) findViewById(R.id.preference_sync_button);
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));
syncButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
// 取消同步
GTaskSyncService.cancelSync(NotesPreferenceActivity.this);
}
});
@ -170,13 +190,15 @@ public class NotesPreferenceActivity extends PreferenceActivity {
syncButton.setText(getString(R.string.preferences_button_sync_immediately));
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()) {
lastSyncTimeView.setText(GTaskSyncService.getProgressString());
lastSyncTimeView.setVisibility(View.VISIBLE);
@ -193,23 +215,30 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
/**
* 刷新整个UI界面
*/
private void refreshUI() {
loadAccountPreference();
loadSyncButton();
}
/**
* 显示账号选择对话框
*/
private void showSelectAccountAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 自定义对话框标题
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_select_account_title));
TextView subtitleTextView = (TextView) titleView.findViewById(R.id.account_dialog_subtitle);
subtitleTextView.setText(getString(R.string.preferences_dialog_select_account_tips));
dialogBuilder.setCustomTitle(titleView);
dialogBuilder.setPositiveButton(null, null);
// 获取谷歌账号列表
Account[] accounts = getGoogleAccounts();
String defAccount = getSyncAccountName(this);
@ -221,12 +250,14 @@ public class NotesPreferenceActivity extends PreferenceActivity {
final CharSequence[] itemMapping = items;
int checkedItem = -1;
int index = 0;
// 构建账号选择列表
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) {
@ -237,6 +268,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
});
}
// 添加"添加账号"选项
View addAccountView = LayoutInflater.from(this).inflate(R.layout.add_account_text, null);
dialogBuilder.setView(addAccountView);
@ -244,9 +276,10 @@ public class NotesPreferenceActivity extends PreferenceActivity {
addAccountView.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
mHasAddedAccount = true;
// 跳转到添加账号设置页面
Intent intent = new Intent("android.settings.ADD_ACCOUNT_SETTINGS");
intent.putExtra(AUTHORITIES_FILTER_KEY, new String[] {
"gmail-ls"
"gmail-ls"
});
startActivityForResult(intent, -1);
dialog.dismiss();
@ -254,9 +287,13 @@ public class NotesPreferenceActivity extends PreferenceActivity {
});
}
/**
* 显示账号变更确认对话框
*/
private void showChangeAccountConfirmAlertDialog() {
AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this);
// 自定义对话框标题
View titleView = LayoutInflater.from(this).inflate(R.layout.account_dialog_title, null);
TextView titleTextView = (TextView) titleView.findViewById(R.id.account_dialog_title);
titleTextView.setText(getString(R.string.preferences_dialog_change_account_title,
@ -265,6 +302,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
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),
@ -273,8 +311,10 @@ public class NotesPreferenceActivity extends PreferenceActivity {
dialogBuilder.setItems(menuItemArray, new DialogInterface.OnClickListener() {
public void onClick(DialogInterface dialog, int which) {
if (which == 0) {
// 变更账号：显示账号选择对话框
showSelectAccountAlertDialog();
} else if (which == 1) {
// 移除账号
removeSyncAccount();
refreshUI();
}
@ -283,11 +323,19 @@ public class NotesPreferenceActivity extends PreferenceActivity {
dialogBuilder.show();
}
/**
* 获取设备上的谷歌账号列表
* @return 谷歌账号数组
*/
private Account[] getGoogleAccounts() {
AccountManager accountManager = AccountManager.get(this);
return accountManager.getAccountsByType("com.google");
}
/**
* 设置同步账号并更新本地数据
* @param account 账号名称
*/
private void setSyncAccount(String account) {
if (!getSyncAccountName(this).equals(account)) {
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
@ -299,10 +347,10 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
editor.commit();
// clean up last sync time
// 清除最后同步时间
setLastSyncTime(this, 0);
// clean up local gtask related info
// 清除本地GTASK相关信息（异步执行）
new Thread(new Runnable() {
public void run() {
ContentValues values = new ContentValues();
@ -318,6 +366,9 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
/**
* 移除当前同步账号并清理数据
*/
private void removeSyncAccount() {
SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE);
SharedPreferences.Editor editor = settings.edit();
@ -329,7 +380,7 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
editor.commit();
// clean up local gtask related info
// 清除本地GTASK相关信息（异步执行）
new Thread(new Runnable() {
public void run() {
ContentValues values = new ContentValues();
@ -340,12 +391,22 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}).start();
}
/**
* 获取保存的同步账号名称
* @param context 上下文
* @return 账号名称，为空表示未设置
*/
public static String getSyncAccountName(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, "");
}
/**
* 保存最后同步时间
* @param context 上下文
* @param time 时间戳
*/
public static void setLastSyncTime(Context context, long time) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
@ -354,16 +415,26 @@ public class NotesPreferenceActivity extends PreferenceActivity {
editor.commit();
}
/**
* 获取最后同步时间
* @param context 上下文
* @return 时间戳，0表示从未同步过
*/
public static long getLastSyncTime(Context context) {
SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME,
Context.MODE_PRIVATE);
return settings.getLong(PREFERENCE_LAST_SYNC_TIME, 0);
}
/**
* 监听同步服务广播的接收器
* 用于同步过程中更新UI状态
*/
private class GTaskReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 刷新UI显示同步状态
refreshUI();
if (intent.getBooleanExtra(GTaskSyncService.GTASK_SERVICE_BROADCAST_IS_SYNCING, false)) {
TextView syncStatus = (TextView) findViewById(R.id.prefenerece_sync_status_textview);
@ -374,9 +445,13 @@ public class NotesPreferenceActivity extends PreferenceActivity {
}
}
/**
* 处理菜单选项点击事件
*/
public boolean onOptionsItemSelected(MenuItem item) {
switch (item.getItemId()) {
case android.R.id.home:
// 返回便签列表页面
Intent intent = new Intent(this, NotesListActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
startActivity(intent);
@ -385,4 +460,4 @@ public class NotesPreferenceActivity extends PreferenceActivity {
return false;
}
}
}
}

75
src/widget/NoteWidgetProvider.java
Unescape View File

@ -32,24 +32,36 @@ import net.micode.notes.tool.ResourceParser;
import net.micode.notes.ui.NoteEditActivity;
import net.micode.notes.ui.NotesListActivity;
/**
* 便签小部件基类，定义不同尺寸小部件的通用行为
* 子类需实现具体布局、背景资源和小部件类型的获取
*/
public abstract class NoteWidgetProvider extends AppWidgetProvider {
// 查询便签数据时使用的字段投影
public static final String [] PROJECTION = new String [] {
NoteColumns.ID,
NoteColumns.BG_COLOR_ID,
NoteColumns.SNIPPET
NoteColumns.ID, // 便签ID
NoteColumns.BG_COLOR_ID, // 背景颜色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 values = new ContentValues();
// 将小部件ID设为无效值
values.put(NoteColumns.WIDGET_ID, AppWidgetManager.INVALID_APPWIDGET_ID);
for (int i = 0; i < appWidgetIds.length; i++) {
// 更新数据库中关联该小部件的便签记录
context.getContentResolver().update(Notes.CONTENT_NOTE_URI,
values,
NoteColumns.WIDGET_ID + "=?",
@ -57,76 +69,119 @@ public abstract class NoteWidgetProvider extends AppWidgetProvider {
}
}
/**
* 获取与指定小部件关联的便签信息
* @param context 上下文
* @param widgetId 小部件ID
* @return 包含便签信息的游标
*/
private Cursor getNoteWidgetInfo(Context context, int widgetId) {
return context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
PROJECTION,
// 查询条件：小部件ID匹配且不在回收站中
NoteColumns.WIDGET_ID + "=? AND " + NoteColumns.PARENT_ID + "<>?",
new String[] { String.valueOf(widgetId), String.valueOf(Notes.ID_TRASH_FOLER) },
null);
}
/**
* 公开的更新方法，调用带隐私模式参数的私有更新方法
*/
protected void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
update(context, appWidgetManager, appWidgetIds, false);
}
/**
* 核心更新方法，更新小部件的UI显示
* @param context 上下文
* @param appWidgetManager 小部件管理器
* @param appWidgetIds 需要更新的小部件ID数组
* @param privacyMode 是否隐私模式（隐藏内容）
*/
private void update(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds,
boolean privacyMode) {
boolean privacyMode) {
for (int i = 0; i < appWidgetIds.length; i++) {
// 只处理有效的小部件ID
if (appWidgetIds[i] != AppWidgetManager.INVALID_APPWIDGET_ID) {
// 默认背景颜色ID
int bgId = ResourceParser.getDefaultBgId(context);
// 便签内容摘要
String snippet = "";
// 点击小部件时的跳转意图
Intent intent = new Intent(context, NoteEditActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
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) {
Log.e(TAG, "Multiple message with same widget id:" + appWidgetIds[i]);
c.close();
return;
}
// 从游标中获取数据
snippet = c.getString(COLUMN_SNIPPET);
bgId = c.getInt(COLUMN_BG_COLOR_ID);
intent.putExtra(Intent.EXTRA_UID, c.getLong(COLUMN_ID));
intent.setAction(Intent.ACTION_VIEW);
intent.setAction(Intent.ACTION_VIEW); // 查看已有便签
} else {
// 无关联便签时显示默认文本
snippet = context.getResources().getString(R.string.widget_havenot_content);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT);
intent.setAction(Intent.ACTION_INSERT_OR_EDIT); // 新建便签
}
// 关闭游标释放资源
if (c != null) {
c.close();
}
// 加载小部件布局
RemoteViews rv = new RemoteViews(context.getPackageName(), getLayoutId());
// 设置背景图片
rv.setImageViewResource(R.id.widget_bg_image, getBgResourceId(bgId));
intent.putExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, bgId);
/**
* Generate the pending intent to start host for the widget
*/
// 创建点击事件的PendingIntent
PendingIntent pendingIntent = null;
if (privacyMode) {
// 隐私模式下显示提示文本，点击跳转至便签列表
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 {
// 正常模式下显示便签内容，点击跳转至编辑页
rv.setTextViewText(R.id.widget_text, snippet);
pendingIntent = PendingIntent.getActivity(context, appWidgetIds[i], intent,
PendingIntent.FLAG_UPDATE_CURRENT);
}
// 设置点击事件
rv.setOnClickPendingIntent(R.id.widget_text, pendingIntent);
// 更新小部件
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
}
}
/**
* 抽象方法：获取背景资源ID
* 由子类实现不同尺寸小部件的背景资源
*/
protected abstract int getBgResourceId(int bgId);
/**
* 抽象方法：获取布局ID
* 由子类实现不同尺寸小部件的布局文件
*/
protected abstract int getLayoutId();
/**
* 抽象方法：获取小部件类型
* 由子类定义具体的小部件类型（如2x、4x等）
*/
protected abstract int getWidgetType();
}
}

33
src/widget/NoteWidgetProvider_2x.java
Unescape View File

@ -23,25 +23,54 @@ import net.micode.notes.R;
import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* 2x尺寸的便签桌面小部件实现类
* 继承自NoteWidgetProvider，专注于2x尺寸的布局、背景和类型定义
*/
public class NoteWidgetProvider_2x extends NoteWidgetProvider {
/**
* 小部件更新回调方法
* 当小部件需要更新时（如添加到桌面、系统触发更新）调用
* @param context 上下文对象，提供应用环境信息
* @param appWidgetManager 小部件管理器，用于更新小部件状态
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// 调用父类的update方法执行通用更新逻辑（如查询数据、绑定事件）
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 实现抽象方法，返回2x尺寸小部件的布局文件ID
* 布局文件定义了小部件的UI结构（如文本位置、背景容器等）
* @return 2x小部件布局ID（R.layout.widget_2x）
*/
@Override
protected int getLayoutId() {
return R.layout.widget_2x;
}
/**
* 实现抽象方法，返回2x尺寸小部件的背景资源ID
* 根据便签的背景色ID（bgId）获取对应的2x尺寸背景图
* @param bgId 便签背景色ID（如红色、黄色等）
* @return 2x小部件对应的背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
// 通过资源解析工具获取2x尺寸的背景资源
return ResourceParser.WidgetBgResources.getWidget2xBgResource(bgId);
}
/**
* 实现抽象方法，返回2x尺寸小部件的类型标识
* 用于系统区分不同尺寸的小部件，关联对应的数据和逻辑
* @return 2x小部件类型标识（Notes.TYPE_WIDGET_2X）
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_2X;
}
}
}

28
src/widget/NoteWidgetProvider_4x.java
Unescape View File

@ -24,23 +24,49 @@ import net.micode.notes.data.Notes;
import net.micode.notes.tool.ResourceParser;
/**
* 小米便签4x尺寸桌面小部件的实现类，继承自NoteWidgetProvider，负责4x小部件的布局、背景和类型管理
*/
public class NoteWidgetProvider_4x extends NoteWidgetProvider {
/**
* 当系统触发小部件更新时调用（如小部件添加到桌面、定时刷新）
* 调用父类的update方法，触发通用更新逻辑（查询便签数据、渲染视图等）
* @param context 应用上下文，用于访问资源和数据库
* @param appWidgetManager 系统小部件管理器，负责更新小部件视图
* @param appWidgetIds 需要更新的小部件ID数组
*/
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
super.update(context, appWidgetManager, appWidgetIds);
}
/**
* 提供4x尺寸小部件的布局文件ID
* 布局文件widget_4x.xml定义了该小部件的UI结构（如文本区域、背景容器等）
* @return 4x小部件的布局资源ID
*/
protected int getLayoutId() {
return R.layout.widget_4x;
}
/**
* 根据背景ID（bgId）获取4x小部件对应的背景资源
* 通过ResourceParser工具类解析，确保背景与便签设置的颜色一致
* @param bgId 背景标识ID（如红色、蓝色等）
* @return 4x小部件的背景资源ID
*/
@Override
protected int getBgResourceId(int bgId) {
return ResourceParser.WidgetBgResources.getWidget4xBgResource(bgId);
}
/**
* 返回4x小部件的类型标识，用于父类逻辑中区分小部件尺寸
* 与Notes类中定义的TYPE_WIDGET_4X常量对应，确保数据关联正确
* @return 4x小部件的类型标识
*/
@Override
protected int getWidgetType() {
return Notes.TYPE_WIDGET_4X;
}
}
}
Write Preview
Loading…
Cancel
Save