From f7c737d2dfda2c6609bb10f10c922904d32dcfc9 Mon Sep 17 00:00:00 2001 From: white-yj8109 <19310195525@163.com> Date: Tue, 27 Jan 2026 09:27:17 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/notes/tool/BackupUtils.java | 74 ++--- src/notes/tool/DataUtils.java | 79 +++-- src/notes/tool/GTaskStringUtils.java | 2 +- src/notes/tool/ResourceParser.java | 7 +- src/notes/ui/AlarmAlertActivity.java | 51 ++-- src/notes/ui/AlarmInitReceiver.java | 12 +- src/notes/ui/AlarmReceiver.java | 8 +- src/notes/ui/DateTimePicker.java | 102 ++++--- src/notes/ui/DateTimePickerDialog.java | 41 +-- src/notes/ui/DropdownMenu.java | 18 +- src/notes/ui/FoldersListAdapter.java | 29 +- src/notes/ui/NoteEditActivity.java | 184 ++++++------ src/notes/ui/NoteEditText.java | 112 +++++-- src/notes/ui/NoteItemData.java | 224 ++++++++++---- src/notes/ui/NotesListActivity.java | 2 +- src/notes/ui/NotesListAdapter.java | 73 +++-- src/notes/ui/NotesListItem.java | 46 ++- src/notes/ui/NotesPreferenceActivity.java | 77 ++++- src/ui/NoteItemData.java | 345 ---------------------- 19 files changed, 707 insertions(+), 779 deletions(-) delete mode 100644 src/ui/NoteItemData.java diff --git a/src/notes/tool/BackupUtils.java b/src/notes/tool/BackupUtils.java index 39f6ec4..807b536 100644 --- a/src/notes/tool/BackupUtils.java +++ b/src/notes/tool/BackupUtils.java @@ -41,8 +41,9 @@ public class BackupUtils { // Singleton stuff private static BackupUtils sInstance; - public static synchronized BackupUtils getInstance(Context context) { + //ynchronized 关键字，代表这个方法加锁,防止多进程混乱 if (sInstance == null) { + //如果当前备份不存在，则新声明一个 sInstance = new BackupUtils(context); } return sInstance; @@ -54,25 +55,25 @@ public class BackupUtils { */ // Currently, the sdcard is not mounted 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; - + //初始化类，将该类设置为context接口格式，提供了访问资源、启动组件、获取系统服务、管理文件、执行权限检查等。 private BackupUtils(Context context) { mTextExport = new TextExport(context); } - + // 获取外部存储的根目录，便于进行api操作 private static boolean externalStorageAvailable() { return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState()); } - + // mTextExport是一个静态内部类,提供了导出功能 public int exportToText() { return mTextExport.exportToText(); } @@ -89,17 +90,17 @@ public class BackupUtils { private static final String[] NOTE_PROJECTION = { NoteColumns.ID, NoteColumns.MODIFIED_DATE, - NoteColumns.SNIPPET, + NoteColumns.SNIPPET, //文本片段 NoteColumns.TYPE }; - + //定义类级别的常量.p s f，下面的 数字代表在字符串中存储位置 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 = { + private static final String[] DATA_PROJECTION = { //数据基础信息，这个数据是啥数据？？？ DataColumns.CONTENT, DataColumns.MIME_TYPE, DataColumns.DATA1, @@ -110,7 +111,7 @@ public class BackupUtils { private static final int DATA_COLUMN_CONTENT = 0; - private static final int DATA_COLUMN_MIME_TYPE = 1; + private static final int DATA_COLUMN_MIME_TYPE = 1; //导出笔记时，先查询这条笔记的 DATA_COLUMN_MIME_TYPE 值，判断格式 private static final int DATA_COLUMN_CALL_DATE = 2; @@ -126,7 +127,7 @@ public class BackupUtils { private String mFileDirectory; public TextExport(Context context) { - TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note); + TEXT_FORMAT = context.getResources().getStringArray(R.array.format_for_exported_note);//从array.xml里获取字符串数组信息 mContext = context; mFileName = ""; mFileDirectory = ""; @@ -137,7 +138,7 @@ public class BackupUtils { } /** - * Export the folder identified by folder id to text + * Export the folder identified by folder id to text ，从文件夹流向便签 */ private void exportFolderToText(String folderId, PrintStream ps) { // Query notes belong to this folder @@ -146,24 +147,24 @@ public class BackupUtils { folderId }, null); - if (notesCursor != null) { - if (notesCursor.moveToFirst()) { + if (notesCursor != null) { //遍历cursor的数据 + 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)))); + mContext.getString(R.string.format_datetime_mdhm), //R.string.xxx 是一个引用字符串资源的标识符，它直接指向资源文件中的字符串,用gststring执行 + notesCursor.getLong(NOTE_COLUMN_MODIFIED_DATE)))); //getXX，XX是结构 // Query data belong to this note String noteId = notesCursor.getString(NOTE_COLUMN_ID); exportNoteToText(noteId, ps); - } while (notesCursor.moveToNext()); + } while (notesCursor.moveToNext()); //没有下一个就终止，代表数据遍历完毕 } notesCursor.close(); } } /** - * Export note identified by id to a print stream + * Export note identified by id to a print stream，从便签流向文本流 */ private void exportNoteToText(String noteId, PrintStream ps) { Cursor dataCursor = mContext.getContentResolver().query(Notes.CONTENT_DATA_URI, @@ -175,14 +176,14 @@ public class BackupUtils { if (dataCursor.moveToFirst()) { do { String mimeType = dataCursor.getString(DATA_COLUMN_MIME_TYPE); - if (DataConstants.CALL_NOTE.equals(mimeType)) { + if (DataConstants.CALL_NOTE.equals(mimeType)) { //有电话的note // Print phone number String phoneNumber = dataCursor.getString(DATA_COLUMN_PHONE_NUMBER); long callDate = dataCursor.getLong(DATA_COLUMN_CALL_DATE); String location = dataCursor.getString(DATA_COLUMN_CONTENT); if (!TextUtils.isEmpty(phoneNumber)) { - ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), + ps.println(String.format(getFormat(FORMAT_NOTE_CONTENT), //在导出内容时，把phoneNumber填充到 “笔记内容的格式模板” 并打印出来 phoneNumber)); } // Print call date @@ -216,9 +217,10 @@ public class BackupUtils { } /** - * Note will be exported as text which is user readable + * Note will be exported as text which is user readable ,下面的是主函数 */ public int exportToText() { + //判断两个失败条件 if (!externalStorageAvailable()) { Log.d(TAG, "Media was not mounted"); return STATE_SD_CARD_UNMOUONTED; @@ -229,7 +231,7 @@ public class BackupUtils { Log.e(TAG, "get print stream error"); return STATE_SYSTEM_ERROR; } - // First export folder and its notes + // First export folder and its notes 输出在文件夹中的便签 Cursor folderCursor = mContext.getContentResolver().query( Notes.CONTENT_NOTE_URI, NOTE_PROJECTION, @@ -242,9 +244,9 @@ public class BackupUtils { 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); - } else { + if(folderCursor.getLong(NOTE_COLUMN_ID) == Notes.ID_CALL_RECORD_FOLDER) { + folderName = mContext.getString(R.string.call_record_folder_name); //Context.getString 是 Android 中用于从资源文件中获取字符串的方法 + } else { //cursor.getString 是 Android 中用于从数据库中获取字符串类型数据的方法 folderName = folderCursor.getString(NOTE_COLUMN_SNIPPET); } if (!TextUtils.isEmpty(folderName)) { @@ -257,7 +259,7 @@ public class BackupUtils { folderCursor.close(); } - // Export notes in root's folder + // Export notes in root's folder，输出根目录中的便签 Cursor noteCursor = mContext.getContentResolver().query( Notes.CONTENT_NOTE_URI, NOTE_PROJECTION, @@ -287,7 +289,7 @@ public class BackupUtils { */ private PrintStream getExportToTextPrintStream() { File file = generateFileMountedOnSDcard(mContext, R.string.file_path, - R.string.file_name_txt_format); + R.string.file_name_txt_format); //建一个指向 SD 卡指定目录的 TXT 导出文件 if (file == null) { Log.e(TAG, "create file to exported failed"); return null; @@ -295,9 +297,9 @@ public class BackupUtils { mFileName = file.getName(); mFileDirectory = mContext.getString(R.string.file_path); PrintStream ps = null; - try { + try { //try catch语法 FileOutputStream fos = new FileOutputStream(file); - ps = new PrintStream(fos); + ps = new PrintStream(fos); //返回操作该文件的 PrintStream 输出流 } catch (FileNotFoundException e) { e.printStackTrace(); return null; @@ -310,7 +312,7 @@ public class BackupUtils { } /** - * Generate the text file to store imported data + * Generate the text file to store imported data把笔记内容（比如之前的电话号码、笔记正文）写入到 TXT 文件中。 */ private static File generateFileMountedOnSDcard(Context context, int filePathResId, int fileNameFormatResId) { StringBuilder sb = new StringBuilder(); @@ -321,14 +323,14 @@ public class BackupUtils { fileNameFormatResId, DateFormat.format(context.getString(R.string.format_date_ymd), System.currentTimeMillis()))); - File file = new File(sb.toString()); + File file = new File(sb.toString()); //stringbuilder转成srting再写进file try { if (!filedir.exists()) { - filedir.mkdir(); + filedir.mkdir(); //文件目录 } if (!file.exists()) { - file.createNewFile(); + file.createNewFile(); //文件 } return file; } catch (SecurityException e) { diff --git a/src/notes/tool/DataUtils.java b/src/notes/tool/DataUtils.java index dc35bfb..937ad81 100644 --- a/src/notes/tool/DataUtils.java +++ b/src/notes/tool/DataUtils.java @@ -37,6 +37,7 @@ import java.util.HashSet; public class DataUtils { public static final String TAG = "DataUtils"; + //批量操作删除便签，发生错误就返回flase，删除成功就返回true public static boolean batchDeleteNotes(ContentResolver resolver, HashSet ids) { if (ids == null) { Log.d(TAG, "the ids is null"); @@ -46,7 +47,7 @@ public class DataUtils { Log.d(TAG, "no id is in the hashset"); return true; } - + // 构建删除操作：拼接标签ID到标签ContentUR ArrayList operationList = new ArrayList(); for (long id : ids) { if(id == Notes.ID_ROOT_FOLDER) { @@ -55,23 +56,24 @@ public class DataUtils { } ContentProviderOperation.Builder builder = ContentProviderOperation .newDelete(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); + //创建一个 ContentProviderOperation.Builder，删除指定id的标签 只查询 ID 为 id 的那一条记录 operationList.add(builder.build()); } try { ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList); - if (results == null || results.length == 0 || results[0] == null) { + if (results == null || results.length == 0 || results[0] == null) {////上面的一条执行数据库操作删除并返回结果数组 Log.d(TAG, "delete notes failed, ids:" + ids.toString()); return false; } return true; - } catch (RemoteException e) { + } catch (RemoteException e) { //记录错误信息 Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } catch (OperationApplicationException e) { Log.e(TAG, String.format("%s: %s", e.toString(), e.getMessage())); } return false; } - + //便签转进新文件夹 public static void moveNoteToFoler(ContentResolver resolver, long id, long srcFolderId, long desFolderId) { ContentValues values = new ContentValues(); values.put(NoteColumns.PARENT_ID, desFolderId); @@ -80,7 +82,7 @@ public class DataUtils { values.put(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); resolver.update(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id), values, null, null); } - + //批量操作便签转进新文件夹 public static boolean batchMoveToFolder(ContentResolver resolver, HashSet ids, long folderId) { if (ids == null) { @@ -91,7 +93,7 @@ public class DataUtils { ArrayList operationList = new ArrayList(); for (long id : ids) { ContentProviderOperation.Builder builder = ContentProviderOperation - .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); + .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); //创建更新, builder.withValue(NoteColumns.PARENT_ID, folderId); builder.withValue(NoteColumns.LOCAL_MODIFIED, 1); builder.withValue(NoteColumns.MODIFIED_DATE, System.currentTimeMillis()); @@ -116,7 +118,18 @@ public class DataUtils { /** * Get the all folder count except system folders {@link Notes#TYPE_SYSTEM}} */ - public static int getUserFolderCount(ContentResolver resolver) { + public static int getUserFolderCount(ContentResolver resolver) { + //查询设备中「类型为文件夹（TYPE_FOLDER）」且「父文件夹 ID 不等于回收站 ID（ID_TRASH_FOLER）」的文件夹总数。 +''' +触发了一次跨进程的数据库查询操作 +Cursor query( + Uri uri, // 要查询的数据 URI + String[] projection, // 要返回的列（字段），null 表示所有列 + String selection, // WHERE 子句（不含 "WHERE" 关键字） + String[] selectionArgs, // WHERE 子句中占位符 ? 的实际值 + String sortOrder // 排序方式（如 "date DESC"） +); +''' Cursor cursor =resolver.query(Notes.CONTENT_NOTE_URI, new String[] { "COUNT(*)" }, NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>?", @@ -127,7 +140,7 @@ public class DataUtils { if(cursor != null) { if(cursor.moveToFirst()) { try { - count = cursor.getInt(0); + count = cursor.getInt(0);//从当前游标指向的行中，读取第 0 列（第一列）的整数类型数据 } catch (IndexOutOfBoundsException e) { Log.e(TAG, "get folder count failed:" + e.toString()); } finally { @@ -137,11 +150,11 @@ public class DataUtils { } return count; } - + //变迁是否可见（没进回收站） public static boolean visibleInNoteDatabase(ContentResolver resolver, long noteId, int type) { Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null, - NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER, + NoteColumns.TYPE + "=? AND " + NoteColumns.PARENT_ID + "<>" + Notes.ID_TRASH_FOLER, //笔记的 parent_id 不能等于回收站的 ID（即不在回收站中） new String [] {String.valueOf(type)}, null); @@ -154,7 +167,7 @@ public class DataUtils { } return exist; } - + //便签还存在否 public static boolean existInNoteDatabase(ContentResolver resolver, long noteId) { Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, noteId), null, null, null, null); @@ -168,7 +181,7 @@ public class DataUtils { } return exist; } - + //便签数据还存在否 public static boolean existInDataDatabase(ContentResolver resolver, long dataId) { Cursor cursor = resolver.query(ContentUris.withAppendedId(Notes.CONTENT_DATA_URI, dataId), null, null, null, null); @@ -182,7 +195,7 @@ public class DataUtils { } return exist; } - + //查看是否存在一个名字是XX的文件夹 public static boolean checkVisibleFolderName(ContentResolver resolver, String name) { Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, null, NoteColumns.TYPE + "=" + Notes.TYPE_FOLDER + @@ -198,9 +211,9 @@ public class DataUtils { } return exist; } - + //获得文件夹下的便签，并仅返回它们的 Widget ID 和 Widget 类型 public static HashSet getFolderNoteWidget(ContentResolver resolver, long folderId) { - Cursor c = resolver.query(Notes.CONTENT_NOTE_URI, + Cursor c = resolver.query(Notes.CONTENT_NOTE_URI, //获得便签 new String[] { NoteColumns.WIDGET_ID, NoteColumns.WIDGET_TYPE }, NoteColumns.PARENT_ID + "=?", new String[] { String.valueOf(folderId) }, @@ -225,7 +238,7 @@ public class DataUtils { } return set; } - + //获得电话号 public static String getCallNumberByNoteId(ContentResolver resolver, long noteId) { Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, new String [] { CallNote.PHONE_NUMBER }, @@ -235,7 +248,7 @@ public class DataUtils { if (cursor != null && cursor.moveToFirst()) { try { - return cursor.getString(0); + return cursor.getString(0); //返回电话号 } catch (IndexOutOfBoundsException e) { Log.e(TAG, "Get call number fails " + e.toString()); } finally { @@ -244,7 +257,7 @@ public class DataUtils { } return ""; } - +//通过电话号和日期查找便签 public static long getNoteIdByPhoneNumberAndCallDate(ContentResolver resolver, String phoneNumber, long callDate) { Cursor cursor = resolver.query(Notes.CONTENT_DATA_URI, new String [] { CallNote.NOTE_ID }, @@ -265,7 +278,7 @@ public class DataUtils { } return 0; } - +//通过id获得名字 public static String getSnippetById(ContentResolver resolver, long noteId) { Cursor cursor = resolver.query(Notes.CONTENT_NOTE_URI, new String [] { NoteColumns.SNIPPET }, @@ -283,13 +296,13 @@ public class DataUtils { } throw new IllegalArgumentException("Note is not found with id: " + noteId); } - +//从一段文本（snippet）中提取作为标题 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');//index即录字符串中第一个换行符 \n 出现的位置 if (index != -1) { - snippet = snippet.substring(0, index); + snippet = snippet.substring(0, index);//只获取换行前的部分（核心）。 } } return snippet; @@ -323,25 +336,15 @@ public class DataUtils { } return ids; } -<<<<<<< HEAD:src/notes/tool/DataUtils.java public static boolean batchMoveToTrash(ContentResolver resolver, HashSet ids, long originFolderId) { if (ids == null || ids.isEmpty()) { Log.d(TAG, "the ids is null or empty"); -======= - public static boolean batchMoveToTrash(ContentResolver resolver, HashSet ids, - long originFolderId) { - if (ids == null) { - Log.d(TAG, "the ids is null"); ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/tool/DataUtils.java return true; } ArrayList operationList = new ArrayList(); long now = System.currentTimeMillis(); -<<<<<<< HEAD:src/notes/tool/DataUtils.java // 1. 更新便签的PARENT_ID为回收站ID -======= ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/tool/DataUtils.java for (long id : ids) { ContentProviderOperation.Builder builder = ContentProviderOperation .newUpdate(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, id)); @@ -351,16 +354,10 @@ public class DataUtils { builder.withValue(NoteColumns.MODIFIED_DATE, now); operationList.add(builder.build()); } -<<<<<<< HEAD:src/notes/tool/DataUtils.java try { ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList); if (results == null || results.length == 0) { -======= - try { - ContentProviderResult[] results = resolver.applyBatch(Notes.AUTHORITY, operationList); - if (results == null || results.length == 0 || results[0] == null) { ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/tool/DataUtils.java Log.d(TAG, "move to trash failed, ids:" + ids.toString()); return false; } @@ -383,7 +380,6 @@ public class DataUtils { NoteColumns.PARENT_ID + "=?", new String[] { String.valueOf(folderId) }); } -<<<<<<< HEAD:src/notes/tool/DataUtils.java /** * 检查文件夹是否为加密文件夹 @@ -406,9 +402,6 @@ public class DataUtils { } return isEncrypted; } -======= - ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/tool/DataUtils.java } diff --git a/src/notes/tool/GTaskStringUtils.java b/src/notes/tool/GTaskStringUtils.java index 666b729..7a4b50f 100644 --- a/src/notes/tool/GTaskStringUtils.java +++ b/src/notes/tool/GTaskStringUtils.java @@ -15,7 +15,7 @@ */ package net.micode.notes.tool; - +//定义一些与 Google Tasks（GTask）JSON 数据交互相关的常量字符串,为与 Google Tasks 同步相关的 JSON 数据结构提供标准化的字段名常量，便于在GTask上同步 public class GTaskStringUtils { public final static String GTASK_JSON_ACTION_ID = "action_id"; diff --git a/src/notes/tool/ResourceParser.java b/src/notes/tool/ResourceParser.java index 5364825..9bc151d 100644 --- a/src/notes/tool/ResourceParser.java +++ b/src/notes/tool/ResourceParser.java @@ -19,7 +19,7 @@ package net.micode.notes.tool; import android.content.Context; import android.preference.PreferenceManager; -import net.micode.notes.R; +import net.micode.notes.R; //资源文件夹中的文件被编译成R类的一部分，R类在编译过程中会生成 import net.micode.notes.ui.NotesPreferenceActivity; public class ResourceParser { @@ -40,6 +40,7 @@ public class ResourceParser { 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, @@ -47,7 +48,7 @@ public class ResourceParser { 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, @@ -80,7 +81,7 @@ public class ResourceParser { } } - public static class NoteItemBgResources { + public static class NoteItemBgResources { //便签主题资源 private final static int [] BG_FIRST_RESOURCES = new int [] { R.drawable.list_yellow_up, R.drawable.list_blue_up, diff --git a/src/notes/ui/AlarmAlertActivity.java b/src/notes/ui/AlarmAlertActivity.java index ba117f5..73e9477 100644 --- a/src/notes/ui/AlarmAlertActivity.java +++ b/src/notes/ui/AlarmAlertActivity.java @@ -45,35 +45,42 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD private static final int SNIPPET_PREW_MAX_LEN = 60; MediaPlayer mPlayer; - @Override + @Override //创建闹钟行为 protected void onCreate(Bundle savedInstanceState) { + //调用其父类Activity的onCreate方法来实现对界面的图画绘制工作。 super.onCreate(savedInstanceState); + //onSaveInstanceState()来保存当前activity的状态信息 requestWindowFeature(Window.FEATURE_NO_TITLE); - + //final类似stactic，获得窗口对象 final Window win = getWindow(); + //为窗口添加各种标志（flags），从而改变窗口的行为和外观 + //屏幕锁定时显示窗口，便于锁屏时启动闹钟 win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED); - - if (!isScreenOn()) { - win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON - | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON - | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON - | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR); + //LayoutParams 布局参数，规定子视图如何放置 + if (!isScreenOn()) {//不锁平时 + win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON//当这个window对用户是可见状态,则保持设备屏幕不关闭且不变暗 + | WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON//当window被添加或者显示,系统会点亮屏幕, + | WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON//允许在屏幕开启的时候锁定屏幕 + | WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);//插入window的矩形大小,来确保内容不会被装饰物(如状态栏)掩盖 } Intent intent = getIntent(); - try { + try { //传递到当前组件的 URI 数据，截取Uri内的字符串的第二个“/”右边的字符及id mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1)); + //根据ID从数据库中获取标签的内容 mSnippet = DataUtils.getSnippetById(this.getContentResolver(), mNoteId); + //判断是否超过最大长度，超过执行截取操作 mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet.substring(0, SNIPPET_PREW_MAX_LEN) + getResources().getString(R.string.notelist_string_info) : mSnippet; } catch (IllegalArgumentException e) { - e.printStackTrace(); + e.printStackTrace();// 将异常的详细信息输出到标准错误流 return; } mPlayer = new MediaPlayer(); + //如果不在回收站就显示文字并发出声音 if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId, Notes.TYPE_NOTE)) { showActionDialog(); playAlarmSound(); @@ -82,26 +89,27 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD } } - private boolean isScreenOn() { + 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.setDataSource(this, url);//指定播放文件的路径 mPlayer.prepare(); - mPlayer.setLooping(true); + mPlayer.setLooping(true);//设置循环播放 mPlayer.start(); } catch (IllegalArgumentException e) { // TODO Auto-generated catch block @@ -119,10 +127,11 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD } private void showActionDialog() { + //AlertDialog.Builder是对话框组件，用于显示信息 AlertDialog.Builder dialog = new AlertDialog.Builder(this); dialog.setTitle(R.string.app_name); dialog.setMessage(mSnippet); - dialog.setPositiveButton(R.string.notealert_ok, this); + dialog.setPositiveButton(R.string.notealert_ok, this); //setPositive/Negative/NeutralButton()设置：确定，取消，中立按钮； if (isScreenOn()) { dialog.setNegativeButton(R.string.notealert_enter, this); //取消 } @@ -133,20 +142,20 @@ public class AlarmAlertActivity extends Activity implements OnClickListener, OnD switch (which) { case DialogInterface.BUTTON_NEGATIVE: Intent intent = new Intent(this, NoteEditActivity.class); - intent.setAction(Intent.ACTION_VIEW); - intent.putExtra(Intent.EXTRA_UID, mNoteId); - startActivity(intent); + intent.setAction(Intent.ACTION_VIEW);//执行安卓内置操作查看数据 + intent.putExtra(Intent.EXTRA_UID, mNoteId);//向目标页面传递笔记的ID + startActivity(intent);//触发页面跳转 break; default: break; } } - + //取消监听后操作 public void onDismiss(DialogInterface dialog) { stopAlarmSound(); finish(); } - + //取消声音 private void stopAlarmSound() { if (mPlayer != null) { mPlayer.stop(); diff --git a/src/notes/ui/AlarmInitReceiver.java b/src/notes/ui/AlarmInitReceiver.java index f221202..d757222 100644 --- a/src/notes/ui/AlarmInitReceiver.java +++ b/src/notes/ui/AlarmInitReceiver.java @@ -27,7 +27,7 @@ import android.database.Cursor; import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; - + //广播接收器用于响应来自其他应用程序或者系统的广播消息（可以使事件） public class AlarmInitReceiver extends BroadcastReceiver { private static final String [] PROJECTION = new String [] { @@ -39,8 +39,10 @@ public class AlarmInitReceiver extends BroadcastReceiver { private static final int COLUMN_ALERTED_DATE = 1; @Override - public void onReceive(Context context, Intent intent) { + public void onReceive(Context context, Intent intent) { //设置接收装置 + //获取当前时间的常用方法。它返回自 1970 年 1 月 1 日 00:00:00.000 到当前时刻的时间距离 long currentDate = System.currentTimeMillis(); + //查询未到响应时间且是有提醒类型的便签 Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI, PROJECTION, NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE, @@ -51,12 +53,18 @@ public class AlarmInitReceiver extends BroadcastReceiver { if (c.moveToFirst()) { do { long alertDate = c.getLong(COLUMN_ALERTED_DATE); + //显示intent格式，明确启动应用中的AlarmReceiver类 Intent sender = new Intent(context, AlarmReceiver.class); + //指定要访问的资源URI(这里的uir是把id和contentUri连接后成一个新的Uri) sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID))); + //(满足特定条件但这里是0即没有)向BroadcastReceiver发送执行sender的广播 PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0); + //获取 AlarmManager AlarmManager alermManager = (AlarmManager) context .getSystemService(Context.ALARM_SERVICE); + //set(int type，long startTime，PendingIntent pi) ,设置一次性定时器，到达时间执行完就没了 alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent); + //闹钟在睡眠状态下会唤醒系统并执行提示功能 } while (c.moveToNext()); } c.close(); diff --git a/src/notes/ui/AlarmReceiver.java b/src/notes/ui/AlarmReceiver.java index 54e503b..9d1be8f 100644 --- a/src/notes/ui/AlarmReceiver.java +++ b/src/notes/ui/AlarmReceiver.java @@ -20,11 +20,11 @@ import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; -public class AlarmReceiver extends BroadcastReceiver { +public class AlarmReceiver extends BroadcastReceiver {//闹钟响应广播接收者 @Override public void onReceive(Context context, Intent intent) { - intent.setClass(context, AlarmAlertActivity.class); - intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); - context.startActivity(intent); + intent.setClass(context, AlarmAlertActivity.class); //启动闹钟响应的行为 + intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);//启动一个新的任务栈 + context.startActivity(intent);//执行 } } diff --git a/src/notes/ui/DateTimePicker.java b/src/notes/ui/DateTimePicker.java index 496b0cd..970e3d6 100644 --- a/src/notes/ui/DateTimePicker.java +++ b/src/notes/ui/DateTimePicker.java @@ -27,7 +27,7 @@ import android.text.format.DateFormat; import android.view.View; import android.widget.FrameLayout; import android.widget.NumberPicker; - + //FrameLayout 是 Android 布局容器之一，用于在屏幕上开辟一块区域，将子控件按照添加顺序进行层叠显示 public class DateTimePicker extends FrameLayout { private static final boolean DEFAULT_ENABLE_STATE = true; @@ -45,7 +45,8 @@ public class DateTimePicker extends FrameLayout { 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; - + //XX选择器设置 + //这里定义的四个变量全部是在设置闹钟时需要选择的变量（如日期、时、分、上午或者下午） private final NumberPicker mDateSpinner; private final NumberPicker mHourSpinner; private final NumberPicker mMinuteSpinner; @@ -53,48 +54,45 @@ public class DateTimePicker extends FrameLayout { private Calendar mDate; private String[] mDateDisplayValues = new String[DAYS_IN_ALL_WEEK]; + + private boolean mIsAm; //12小时制是否上午 - private boolean mIsAm; - - private boolean mIs24HourView; + private boolean mIs24HourView;//24小时制 - private boolean mIsEnabled = DEFAULT_ENABLE_STATE; + private boolean mIsEnabled = DEFAULT_ENABLE_STATE; //是否启动 - private boolean mInitialising; - - private OnDateTimeChangedListener mOnDateTimeChangedListener; + private boolean mInitialising; //是否正在初始化 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(); + updateDateControl();//更新日期 + onDateTimeChanged();//触发自定义接口的回调（把事件传给外部）[实现方法不在此类]，作用未知？？ } }; - - private NumberPicker.OnValueChangeListener mOnHourChangedListener = new NumberPicker.OnValueChangeListener() { + 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) { - if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { - cal.setTimeInMillis(mDate.getTimeInMillis()); + Calendar cal = Calendar.getInstance(); //获取现在的日历 + if (!mIs24HourView) { //12小时制 + if (!mIsAm && oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY) { //从十一点多调整到第二天0点，日期加一。 + cal.setTimeInMillis(mDate.getTimeInMillis());// set time to（ 1970 年 1 月 1 日的 00:00:00.000到Calendar对象表示的时间之间的毫秒数 ）after january 1 1970 cal.add(Calendar.DAY_OF_YEAR, 1); isDateChanged = true; - } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) { + } else if (mIsAm && oldVal == HOURS_IN_HALF_DAY && newVal == HOURS_IN_HALF_DAY - 1) {//从0点多调整到昨天点，日期加一。 cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, -1); isDateChanged = true; } - if (oldVal == HOURS_IN_HALF_DAY - 1 && newVal == HOURS_IN_HALF_DAY || + 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 { - if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) { + } else {//24小时制 + if (oldVal == HOURS_IN_ALL_DAY - 1 && newVal == 0) {//同上面日期切换逻辑 cal.setTimeInMillis(mDate.getTimeInMillis()); cal.add(Calendar.DAY_OF_YEAR, 1); isDateChanged = true; @@ -104,8 +102,8 @@ 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); + int newHour = mHourSpinner.getValue() % HOURS_IN_HALF_DAY + (mIsAm ? 0 : HOURS_IN_HALF_DAY);//24小时制的小时时间数 + mDate.set(Calendar.HOUR_OF_DAY, newHour); //通过set函数将新的Hour值传给mDate onDateTimeChanged(); if (isDateChanged) { setCurrentYear(cal.get(Calendar.YEAR)); @@ -115,18 +113,18 @@ public class DateTimePicker extends FrameLayout { } }; - private NumberPicker.OnValueChangeListener mOnMinuteChangedListener = new NumberPicker.OnValueChangeListener() { + 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; + int offset = 0; //分钟导致的的小时切换 if (oldVal == maxValue && newVal == minValue) { - offset += 1; + offset += 1; //小时加一 } else if (oldVal == minValue && newVal == maxValue) { - offset -= 1; + offset -= 1; //小时减一 } - if (offset != 0) { + if (offset != 0) { //更新小时时间 mDate.add(Calendar.HOUR_OF_DAY, offset); mHourSpinner.setValue(getCurrentHour()); updateDateControl(); @@ -139,7 +137,7 @@ public class DateTimePicker extends FrameLayout { updateAmPmControl(); } } - mDate.set(Calendar.MINUTE, newVal); + mDate.set(Calendar.MINUTE, newVal);//通过set函数将新的minutes值传给mDate onDateTimeChanged(); } }; @@ -158,17 +156,17 @@ public class DateTimePicker extends FrameLayout { } }; - public interface OnDateTimeChangedListener { + public interface OnDateTimeChangedListener {//接口，要求实现onDateTimeChanged void onDateTimeChanged(DateTimePicker view, int year, int month, int dayOfMonth, int hourOfDay, int minute); } - public DateTimePicker(Context context) { + public DateTimePicker(Context context) {// 获得1970 年 1 月 1 日的 00:00:00.000到Calendar对象表示的时间之间的毫秒数 this(context, System.currentTimeMillis()); } public DateTimePicker(Context context, long date) { - this(context, date, DateFormat.is24HourFormat(context)); + this(context, date, DateFormat.is24HourFormat(context));//把上一个函数的毫秒改成24小时制的日期格式 } public DateTimePicker(Context context, long date, boolean is24HourView) { @@ -195,7 +193,7 @@ public class DateTimePicker extends FrameLayout { mAmPmSpinner = (NumberPicker) findViewById(R.id.amPm); mAmPmSpinner.setMinValue(AMPM_SPINNER_MIN_VAL); mAmPmSpinner.setMaxValue(AMPM_SPINNER_MAX_VAL); - mAmPmSpinner.setDisplayedValues(stringsForAmPm); + mAmPmSpinner.setDisplayedValues(stringsForAmPm);//设置展示的字符串 mAmPmSpinner.setOnValueChangedListener(mOnAmPmChangedListener); // update controls to initial state @@ -241,6 +239,7 @@ public class DateTimePicker extends FrameLayout { return mDate.getTimeInMillis(); } +//两种不同的参数，对应不同的设置现在时间的方法 /** * Set the current date * @@ -433,51 +432,80 @@ public class DateTimePicker extends FrameLayout { setCurrentHour(hour); updateAmPmControl(); } - + // + /** + * 更新日期选择控件的显示值 + * 生成当前日期前后一周的日期显示值，并设置到日期选择器中 + */ private void updateDateControl() { Calendar cal = Calendar.getInstance(); cal.setTimeInMillis(mDate.getTimeInMillis()); + // 计算起始日期：当前日期减去3天（DAYS_IN_ALL_WEEK/2=3）再减1天，得到一周前的日期 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); + // 每次循环增加一天，生成一周内的日期 + cal.add(Calendar.DAY_OF_YEAR, 1); + // 格式化日期为"MM.dd EEEE"格式（例如：05.20 星期一） mDateDisplayValues[i] = (String) DateFormat.format("MM.dd EEEE", cal); } + // 设置日期显示值到选择器 mDateSpinner.setDisplayedValues(mDateDisplayValues); + // 将选择器默认值设置为中间位置（即当前日期） mDateSpinner.setValue(DAYS_IN_ALL_WEEK / 2); + // 刷新选择器显示 mDateSpinner.invalidate(); } + /** + * 更新上午/下午选择控件的显示 + * 根据当前是否为24小时制，决定是否显示上午/下午选择器 + */ private void updateAmPmControl() { if (mIs24HourView) { + // 24小时制下，隐藏上午/下午选择器 mAmPmSpinner.setVisibility(View.GONE); } else { + // 12小时制下，根据当前是上午还是下午设置选择器值 int index = mIsAm ? Calendar.AM : Calendar.PM; mAmPmSpinner.setValue(index); + // 显示上午/下午选择器 mAmPmSpinner.setVisibility(View.VISIBLE); } } + /** + * 更新小时选择控件的显示范围 + * 根据当前是否为24小时制，设置不同的小时范围 + */ private void updateHourControl() { if (mIs24HourView) { + // 24小时制：小时范围0-23 mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_24_HOUR_VIEW); mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_24_HOUR_VIEW); } else { + // 12小时制：小时范围1-12 mHourSpinner.setMinValue(HOUR_SPINNER_MIN_VAL_12_HOUR_VIEW); mHourSpinner.setMaxValue(HOUR_SPINNER_MAX_VAL_12_HOUR_VIEW); } } /** - * Set the callback that indicates the 'Set' button has been pressed. - * @param callback the callback, if null will do nothing + * 设置日期时间改变监听器 + * 当用户修改日期或时间时，会调用该监听器的回调方法 + * @param callback 监听器对象，null表示不设置监听器 */ public void setOnDateTimeChangedListener(OnDateTimeChangedListener callback) { mOnDateTimeChangedListener = callback; } + /** + * 日期时间改变时的回调方法 + * 当用户修改日期或时间时，调用该方法通知注册的监听器 + */ private void onDateTimeChanged() { if (mOnDateTimeChangedListener != null) { + // 调用监听器的onDateTimeChanged方法，传递当前选择的年、月、日、时、分 mOnDateTimeChangedListener.onDateTimeChanged(this, getCurrentYear(), getCurrentMonth(), getCurrentDay(), getCurrentHourOfDay(), getCurrentMinute()); } diff --git a/src/notes/ui/DateTimePickerDialog.java b/src/notes/ui/DateTimePickerDialog.java index 2c47ba4..f0d05ef 100644 --- a/src/notes/ui/DateTimePickerDialog.java +++ b/src/notes/ui/DateTimePickerDialog.java @@ -28,37 +28,39 @@ import android.content.DialogInterface; import android.content.DialogInterface.OnClickListener; import android.text.format.DateFormat; import android.text.format.DateUtils; - + //对话框弹出 public class DateTimePickerDialog extends AlertDialog implements OnClickListener { private Calendar mDate = Calendar.getInstance(); private boolean mIs24HourView; - private OnDateTimeSetListener mOnDateTimeSetListener; + private OnDateTimeSetListener mOnDateTimeSetListener; //设置时间的接口 private DateTimePicker mDateTimePicker; - public interface OnDateTimeSetListener { + public interface OnDateTimeSetListener {//实现接口的函数调用 void OnDateTimeSet(AlertDialog dialog, long date); } public DateTimePickerDialog(Context context, long date) { - super(context); + super(context);//访问AlertDialog的context mDateTimePicker = new DateTimePicker(context); - setView(mDateTimePicker); - mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() { + setView(mDateTimePicker);//自定义对话框 + mDateTimePicker.setOnDateTimeChangedListener(new OnDateTimeChangedListener() { //注册监听器，用户操作日期时间选择器时，这个监听器会被自动触发 public void onDateTimeChanged(DateTimePicker view, int year, int month, 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()); + updateTitle(mDate.getTimeInMillis());//根据新的日期时间更新对话框标题 } }); - mDate.setTimeInMillis(date); - mDate.set(Calendar.SECOND, 0); - mDateTimePicker.setCurrentDate(mDate.getTimeInMillis()); - setButton(context.getString(R.string.datetime_dialog_ok), this); + //下面三行是日期时间选择器初始化的核心逻辑 + mDate.setTimeInMillis(date); //导入calendar时间 + mDate.set(Calendar.SECOND, 0);//秒数设为0 + mDateTimePicker.setCurrentDate(mDate.getTimeInMillis());//设置为当前时间 + setButton(context.getString(R.string.datetime_dialog_ok), this);//设置了确认和取消按钮 setButton2(context.getString(R.string.datetime_dialog_cancel), (OnClickListener)null); set24HourView(DateFormat.is24HourFormat(this.getContext())); updateTitle(mDate.getTimeInMillis()); @@ -68,20 +70,21 @@ public class DateTimePickerDialog extends AlertDialog implements OnClickListener mIs24HourView = is24HourView; } - public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { - mOnDateTimeSetListener = callBack; + public void setOnDateTimeSetListener(OnDateTimeSetListener callBack) { //设置时间的接口 + mOnDateTimeSetListener = callBack; } private void updateTitle(long date) { - int flag = + int flag = //亮点，位掩码设计 返回了结果是一个包含所有标志位的整数作为时间显示格式 DateUtils.FORMAT_SHOW_YEAR | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_TIME; - flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_24HOUR; - setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); - } - - public void onClick(DialogInterface arg0, int arg1) { + //再并上24小时格式或12小时格式 + flag |= mIs24HourView ? DateUtils.FORMAT_24HOUR : DateUtils.FORMAT_12HOUR; //错误应为12HOUR + setTitle(DateUtils.formatDateTime(this.getContext(), date, flag)); //设置对话框标题 + } //日期时间的本地化格式化 + + public void onClick(DialogInterface arg0, int arg1) {//点击确认按钮时调用 if (mOnDateTimeSetListener != null) { mOnDateTimeSetListener.OnDateTimeSet(this, mDate.getTimeInMillis()); } diff --git a/src/notes/ui/DropdownMenu.java b/src/notes/ui/DropdownMenu.java index 613dc74..33f6b96 100644 --- a/src/notes/ui/DropdownMenu.java +++ b/src/notes/ui/DropdownMenu.java @@ -29,33 +29,35 @@ import net.micode.notes.R; public class DropdownMenu { private Button mButton; - private PopupMenu mPopupMenu; + private PopupMenu mPopupMenu; //弹窗菜单 private Menu mMenu; public DropdownMenu(Context context, Button button, int menuId) { mButton = button; - mButton.setBackgroundResource(R.drawable.dropdown_icon); + mButton.setBackgroundResource(R.drawable.dropdown_icon);//绘制下拉菜单图标 mPopupMenu = new PopupMenu(context, mButton); - mMenu = mPopupMenu.getMenu(); - mPopupMenu.getMenuInflater().inflate(menuId, mMenu); - mButton.setOnClickListener(new OnClickListener() { + mMenu = mPopupMenu.getMenu();//获取弹窗菜单的菜单对象 + mPopupMenu.getMenuInflater().inflate(menuId, mMenu);//获得菜单 + //第一个参数用于指定我们通过哪一个资源文件来创建菜单，menuId。 + // 第二个参数用于指定我们的菜单项将添加到哪一个 Meau 对象中 + mButton.setOnClickListener(new OnClickListener() {//设置下拉菜单图标点击事件 public void onClick(View v) { mPopupMenu.show(); } }); } - public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) { + public void setOnDropdownMenuItemClickListener(OnMenuItemClickListener listener) {//设置下拉菜单选项点击事件监听 if (mPopupMenu != null) { mPopupMenu.setOnMenuItemClickListener(listener); } } - public MenuItem findItem(int id) { + public MenuItem findItem(int id) {//根据菜单项的ID查找菜单项 return mMenu.findItem(id); } - public void setTitle(CharSequence title) { + public void setTitle(CharSequence title) {//设置下拉菜单图标上的文本 mButton.setText(title); } } diff --git a/src/notes/ui/FoldersListAdapter.java b/src/notes/ui/FoldersListAdapter.java index 96b77da..7ca2926 100644 --- a/src/notes/ui/FoldersListAdapter.java +++ b/src/notes/ui/FoldersListAdapter.java @@ -28,8 +28,8 @@ import net.micode.notes.R; import net.micode.notes.data.Notes; import net.micode.notes.data.Notes.NoteColumns; - -public class FoldersListAdapter extends CursorAdapter { + //将cursor对象数据加载到界面的适配器 +public class FoldersListAdapter extends CursorAdapter {//将文件夹数据转换成视图 public static final String [] PROJECTION = { NoteColumns.ID, NoteColumns.SNIPPET @@ -39,21 +39,23 @@ public class FoldersListAdapter extends CursorAdapter { public static final int NAME_COLUMN = 1; public FoldersListAdapter(Context context, Cursor c) { - super(context, c); + super(context, c);//调用父类构造方法，初始化上下文和游标 // TODO Auto-generated constructor stub } @Override - public View newView(Context context, Cursor cursor, ViewGroup parent) { - return new FolderListItem(context); + public View newView(Context context, Cursor cursor, ViewGroup parent) {//创建新的视图 + return new FolderListItem(context);//创建一个新的FolderListItem视图 } @Override - public void bindView(View view, Context context, Cursor cursor) { - if (view instanceof FolderListItem) { + public void bindView(View view, Context context, Cursor cursor) {//绑定视图与数据 + if (view instanceof FolderListItem) {//判断视图是否为FolderListItem类型 + //根据文件夹类型动态显示不同的名称，当文件夹是文件夹时，显示移动到父文件夹 + //当文件夹是 普通文件夹时，显示其实际名称 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); + ((FolderListItem) view).bind(folderName);//将文件夹名称绑定到FolderListItem视图 } } @@ -62,18 +64,19 @@ public class FoldersListAdapter extends CursorAdapter { return (cursor.getLong(ID_COLUMN) == Notes.ID_ROOT_FOLDER) ? context .getString(R.string.menu_move_parent_folder) : cursor.getString(NAME_COLUMN); } - - private class FolderListItem extends LinearLayout { + //布局管理器 之一，属于 ViewGroup 的子类，用于 将子View按照线性方向排列 + private class FolderListItem extends LinearLayout {//文件夹列表项视图 private TextView mName; public FolderListItem(Context context) { super(context); - inflate(context, R.layout.folder_list_item, this); - mName = (TextView) findViewById(R.id.tv_folder_name); + inflate(context, R.layout.folder_list_item, this);//对 LayoutInflater.inflate()的简化 + //将R.layout.folder_list_item布局文件实例化并添加到当前视图（FolderListItem）中 + mName = (TextView) findViewById(R.id.tv_folder_name);//获取布局文件中的TextView控件 } public void bind(String name) { - mName.setText(name); + mName.setText(name);//将文件夹名称设置到TextView中 } } diff --git a/src/notes/ui/NoteEditActivity.java b/src/notes/ui/NoteEditActivity.java index 3bf0bc9..5140e04 100644 --- a/src/notes/ui/NoteEditActivity.java +++ b/src/notes/ui/NoteEditActivity.java @@ -328,7 +328,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } - private static final Map sBgSelectorBtnsMap = new HashMap(); + private static final Map sBgSelectorBtnsMap = new HashMap();//背景颜色选择按钮映射 static { sBgSelectorBtnsMap.put(R.id.iv_bg_yellow, ResourceParser.YELLOW); sBgSelectorBtnsMap.put(R.id.iv_bg_red, ResourceParser.RED); @@ -346,14 +346,14 @@ public class NoteEditActivity extends Activity implements OnClickListener, sBgSelectorSelectionMap.put(ResourceParser.WHITE, R.id.iv_bg_white_select); } - private static final Map sFontSizeBtnsMap = new HashMap(); + private static final Map sFontSizeBtnsMap = new HashMap();//字体大小选择按钮映射 static { sFontSizeBtnsMap.put(R.id.ll_font_large, ResourceParser.TEXT_LARGE); sFontSizeBtnsMap.put(R.id.ll_font_small, ResourceParser.TEXT_SMALL); sFontSizeBtnsMap.put(R.id.ll_font_normal, ResourceParser.TEXT_MEDIUM); sFontSizeBtnsMap.put(R.id.ll_font_super, ResourceParser.TEXT_SUPER); } - +//同颜色的映射关系 private static final Map sFontSelectorSelectionMap = new HashMap(); static { sFontSelectorSelectionMap.put(ResourceParser.TEXT_LARGE, R.id.iv_large_select); @@ -516,15 +516,15 @@ public class NoteEditActivity extends Activity implements OnClickListener, /** * Starting from the searched result */ - if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) { - noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY)); - mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY); + if (intent.hasExtra(SearchManager.EXTRA_DATA_KEY)) {//如果意图包含搜索数据键 + noteId = Long.parseLong(intent.getStringExtra(SearchManager.EXTRA_DATA_KEY));//解析出笔记id + mUserQuery = intent.getStringExtra(SearchManager.USER_QUERY);//解析出用户查询 } - if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) { + if (!DataUtils.visibleInNoteDatabase(getContentResolver(), noteId, Notes.TYPE_NOTE)) {//如果笔记数据库中不存在该笔记 Intent jump = new Intent(this, NotesListActivity.class); - startActivity(jump); - showToast(R.string.error_note_not_exist); + startActivity(jump);//执行跳转 + showToast(R.string.error_note_not_exist);//显示笔记不存在的提示 finish(); return false; } else { @@ -535,30 +535,30 @@ public class NoteEditActivity extends Activity implements OnClickListener, return false; } } - getWindow().setSoftInputMode( - WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN - | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE); - } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) { + getWindow().setSoftInputMode( //控制软键盘的操作？ + WindowManager.LayoutParams.SOFT_INPUT_STATE_HIDDEN //隐藏 + | WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);//调整布局 + } else if(TextUtils.equals(Intent.ACTION_INSERT_OR_EDIT, intent.getAction())) {//如果意图是插入或编辑操作 // New note - long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0); + long folderId = intent.getLongExtra(Notes.INTENT_EXTRA_FOLDER_ID, 0);//获取文件夹id int widgetId = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_ID, - AppWidgetManager.INVALID_APPWIDGET_ID); + AppWidgetManager.INVALID_APPWIDGET_ID);//获取小部件id int widgetType = intent.getIntExtra(Notes.INTENT_EXTRA_WIDGET_TYPE, - Notes.TYPE_WIDGET_INVALIDE); + Notes.TYPE_WIDGET_INVALIDE);//获取小部件类型 int bgResId = intent.getIntExtra(Notes.INTENT_EXTRA_BACKGROUND_ID, - ResourceParser.getDefaultBgId(this)); + ResourceParser.getDefaultBgId(this));//获取背景资源id // Parse call-record note - String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER); - long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0); - if (callDate != 0 && phoneNumber != null) { + String phoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);//获取电话号码 + long callDate = intent.getLongExtra(Notes.INTENT_EXTRA_CALL_DATE, 0);//获取调用日期 + if (callDate != 0 && phoneNumber != null) {//如果调用日期和电话号码都不为空 if (TextUtils.isEmpty(phoneNumber)) { Log.w(TAG, "The call record number is null"); } - long noteId = 0; + long noteId = 0;//初始化笔记id if ((noteId = DataUtils.getNoteIdByPhoneNumberAndCallDate(getContentResolver(), - phoneNumber, callDate)) > 0) { - mWorkingNote = WorkingNote.load(this, noteId); + phoneNumber, callDate)) > 0) {//如果记录中根据电话号码和调用日期查询到笔记id + mWorkingNote = WorkingNote.load(this, noteId);//加载笔记 if (mWorkingNote == null) { Log.e(TAG, "load call note failed with note id" + noteId); finish(); @@ -566,15 +566,15 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } else { mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, - widgetType, bgResId); - mWorkingNote.convertToCallNote(phoneNumber, callDate); + widgetType, bgResId);//新建笔记 + mWorkingNote.convertToCallNote(phoneNumber, callDate);//将笔记转换为call笔记 } } else { mWorkingNote = WorkingNote.createEmptyNote(this, folderId, widgetId, widgetType, bgResId); } - getWindow().setSoftInputMode( + getWindow().setSoftInputMode(//设置软键盘操作 WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE | WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE); } else { @@ -587,7 +587,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - protected void onResume() { + protected void onResume() {//已经oncreate后切出，再次调用时，初始化笔记界面 super.onResume(); initNoteScreen(); } @@ -989,10 +989,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, if (mWorkingNote.hasClockAlert()) { long time = System.currentTimeMillis(); if (time > mWorkingNote.getAlertDate()) { - mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired); + mNoteHeaderHolder.tvAlertDate.setText(R.string.note_alert_expired);//显示已过期信息 } else { mNoteHeaderHolder.tvAlertDate.setText(DateUtils.getRelativeTimeSpanString( - mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS)); + mWorkingNote.getAlertDate(), time, DateUtils.MINUTE_IN_MILLIS));//显示剩余时间信息 } mNoteHeaderHolder.tvAlertDate.setVisibility(View.VISIBLE); mNoteHeaderHolder.ivAlertIcon.setVisibility(View.VISIBLE); @@ -1009,7 +1009,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - protected void onSaveInstanceState(Bundle outState) { + protected void onSaveInstanceState(Bundle outState) {//保存活动状态 super.onSaveInstanceState(outState); /** * For new note without note id, we should firstly save it to @@ -1024,23 +1024,23 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - public boolean dispatchTouchEvent(MotionEvent ev) { + public boolean dispatchTouchEvent(MotionEvent ev) {//处理触摸事件 if (mNoteBgColorSelector.getVisibility() == View.VISIBLE - && !inRangeOfView(mNoteBgColorSelector, ev)) { - mNoteBgColorSelector.setVisibility(View.GONE); + && !inRangeOfView(mNoteBgColorSelector, ev)) {//如果背景色选择器可见，且触摸事件不在范围内？ + mNoteBgColorSelector.setVisibility(View.GONE);//隐藏背景色选择器 return true; } if (mFontSizeSelector.getVisibility() == View.VISIBLE - && !inRangeOfView(mFontSizeSelector, ev)) { - mFontSizeSelector.setVisibility(View.GONE); + && !inRangeOfView(mFontSizeSelector, ev)) {//如果字体大小选择器可见，且触摸事件不在范围内？ + mFontSizeSelector.setVisibility(View.GONE);//隐藏字体大小选择器 return true; } return super.dispatchTouchEvent(ev); } - private boolean inRangeOfView(View view, MotionEvent ev) { - int []location = new int[2]; + private boolean inRangeOfView(View view, MotionEvent ev) {//判断触摸事件是否在视图范围内 + int []location = new int[2];//获取视图在屏幕上的坐标，长度为2的整数数组 view.getLocationOnScreen(location); int x = location[0]; int y = location[1]; @@ -1157,16 +1157,16 @@ public class NoteEditActivity extends Activity implements OnClickListener, } @Override - protected void onPause() { - super.onPause(); + protected void onPause() {//在活动暂停时调用（切出去了） + super.onPause();//调用父类的onPause方法 if(saveNote()) { Log.d(TAG, "Note data was saved with length:" + mWorkingNote.getContent().length()); } - clearSettingState(); + clearSettingState();//清除设置状态 } - private void updateWidget() { - Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE); + private void updateWidget() {//更新应用小部件 + Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_UPDATE);//接受意图 if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_2X) { intent.setClass(this, NoteWidgetProvider_2x.class); } else if (mWorkingNote.getWidgetType() == Notes.TYPE_WIDGET_4X) { @@ -1180,8 +1180,8 @@ public class NoteEditActivity extends Activity implements OnClickListener, mWorkingNote.getWidgetId() }); - sendBroadcast(intent); - setResult(RESULT_OK, intent); + sendBroadcast(intent);//发送广播更新应用小部件 + setResult(RESULT_OK, intent);//设置结果为成功，返回意图 } public void onClick(View v) { @@ -1199,6 +1199,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, mFontSizeId = sFontSizeBtnsMap.get(id); mSharedPrefs.edit().putInt(PREFERENCE_FONT_SIZE, mFontSizeId).commit(); findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); + //区分两种模式，列表模式和普通模式 if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { getWorkingText(); switchToListMode(mWorkingNote.getContent()); @@ -1246,7 +1247,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, super.onBackPressed(); } - private boolean clearSettingState() { + private boolean clearSettingState() {//清除设置状态 if (mNoteBgColorSelector.getVisibility() == View.VISIBLE) { mNoteBgColorSelector.setVisibility(View.GONE); return true; @@ -1259,25 +1260,25 @@ public class NoteEditActivity extends Activity implements OnClickListener, public void onBackgroundColorChanged() { findViewById(sBgSelectorSelectionMap.get(mWorkingNote.getBgColorId())).setVisibility( - View.VISIBLE); - mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId()); - mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId()); + View.VISIBLE);//显示选中的背景颜色 + mNoteEditorPanel.setBackgroundResource(mWorkingNote.getBgColorResId());//设置笔记编辑面板的背景颜色 + mHeadViewPanel.setBackgroundResource(mWorkingNote.getTitleBgResId());//设置标题栏的背景颜色 } @Override - public boolean onPrepareOptionsMenu(Menu menu) { + public boolean onPrepareOptionsMenu(Menu menu) {//准备选项菜单 if (isFinishing()) { return true; } clearSettingState(); menu.clear(); - if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) { - getMenuInflater().inflate(R.menu.call_note_edit, menu); + if (mWorkingNote.getFolderId() == Notes.ID_CALL_RECORD_FOLDER) {//判断类型 + getMenuInflater().inflate(R.menu.call_note_edit, menu);//如果是通话记录文件夹， 通话记录转化为菜单 } else { getMenuInflater().inflate(R.menu.note_edit, menu); } if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { - menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode); + menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_normal_mode);//如果是列表模式， 菜单标题为普通模式 } else { menu.findItem(R.id.menu_list_mode).setTitle(R.string.menu_list_mode); } @@ -1297,11 +1298,11 @@ public class NoteEditActivity extends Activity implements OnClickListener, @Override public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { - case R.id.menu_new_note: + case R.id.menu_new_note://新建笔记 createNewNote(); break; - case R.id.menu_delete: - AlertDialog.Builder builder = new AlertDialog.Builder(this); + case R.id.menu_delete://删除笔记 + AlertDialog.Builder builder = new AlertDialog.Builder(this);//创建删除确认对话框 builder.setTitle(getString(R.string.alert_title_delete)); builder.setIcon(android.R.drawable.ic_dialog_alert); builder.setMessage(getString(R.string.alert_message_delete_note)); @@ -1315,15 +1316,15 @@ public class NoteEditActivity extends Activity implements OnClickListener, builder.setNegativeButton(android.R.string.cancel, null); builder.show(); break; - case R.id.menu_font_size: + case R.id.menu_font_size://字体大小选择 mFontSizeSelector.setVisibility(View.VISIBLE); findViewById(sFontSelectorSelectionMap.get(mFontSizeId)).setVisibility(View.VISIBLE); break; - case R.id.menu_list_mode: + case R.id.menu_list_mode://列表模式切换 mWorkingNote.setCheckListMode(mWorkingNote.getCheckListMode() == 0 ? TextNote.MODE_CHECK_LIST : 0); break; - case R.id.menu_share: + case R.id.menu_share://分享笔记 getWorkingText(); sendTo(this, mWorkingNote.getContent()); break; @@ -1333,10 +1334,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, case R.id.menu_send_to_desktop: sendToDesktop(); break; - case R.id.menu_alert: + case R.id.menu_alert://设置提醒 setReminder(); break; - case R.id.menu_delete_remind: + case R.id.menu_delete_remind://删除提醒 mWorkingNote.setAlertDate(0, false); break; case R.id.menu_set_habit: @@ -1679,8 +1680,8 @@ public class NoteEditActivity extends Activity implements OnClickListener, if (mWorkingNote.existInDatabase()) { HashSet ids = new HashSet(); long id = mWorkingNote.getNoteId(); - if (id != Notes.ID_ROOT_FOLDER) { - ids.add(id); + if (id != Notes.ID_ROOT_FOLDER) {//如果不是根文件夹 + ids.add(id);//将笔记id添加到集合中 } else { Log.d(TAG, "Wrong note id, should not happen"); } @@ -1713,7 +1714,7 @@ public class NoteEditActivity extends Activity implements OnClickListener, return updated > 0; } - public void onClockAlertChanged(long date, boolean set) { + public void onClockAlertChanged(long date, boolean set) {//设置提醒时间 /** * User could set clock to an unsaved note, so before setting the * alert clock, we should save the note first @@ -1747,18 +1748,19 @@ public class NoteEditActivity extends Activity implements OnClickListener, updateWidget(); } - public void onEditTextDelete(int index, String text) { - int childCount = mEditTextList.getChildCount(); + public void onEditTextDelete(int index, String text) {//处理清单模式下删除列表项 的操作 + int childCount = mEditTextList.getChildCount();//获取编辑框的子视图数量 if (childCount == 1) { return; } - for (int i = index + 1; i < childCount; i++) { + for (int i = index + 1; i < childCount; i++) {//遍历删除项（index处）之后的所有列表项 ，将它们的索引减1，不会影响到后续的列表项的索引，从而避免了索引错乱的问题 ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) .setIndex(i - 1); } - mEditTextList.removeViewAt(index); + mEditTextList.removeViewAt(index);//删除index处的子图 + //亮点：小米笔记清单模式下的特殊设计 ，属于防误删的安全机制 ，主要为了保护用户内容，这是啥意思？ NoteEditText edit = null; if(index == 0) { edit = (NoteEditText) mEditTextList.getChildAt(0).findViewById( @@ -1767,13 +1769,13 @@ public class NoteEditActivity extends Activity implements OnClickListener, edit = (NoteEditText) mEditTextList.getChildAt(index - 1).findViewById( R.id.et_edit_text); } - int length = edit.length(); - edit.append(text); - edit.requestFocus(); - edit.setSelection(length); + int length = edit.length();//获取删除项（index处）之前的列表项的文本长度 + edit.append(text);//将被删除项的文本追加到目标项末尾 + edit.requestFocus();//将焦点自动切换到目标项 + edit.setSelection(length);//将光标定位到合并前的文本末尾 } - public void onEditTextEnter(int index, String text) { + public void onEditTextEnter(int index, String text) {//处理清单模式下添加列表项的操作 /** * Should not happen, check for debug */ @@ -1782,17 +1784,17 @@ public class NoteEditActivity extends Activity implements OnClickListener, } View view = getListItem(text, index); - mEditTextList.addView(view, index); - NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); + mEditTextList.addView(view, index);//将新的列表项视图添加到编辑框中，位置为index + NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//获取新添加的列表项的编辑框 edit.requestFocus(); - edit.setSelection(0); - for (int i = index + 1; i < mEditTextList.getChildCount(); i++) { + edit.setSelection(0);//将光标定位到新添加的列表项的文本开头 + for (int i = index + 1; i < mEditTextList.getChildCount(); i++) {//索引加一 ((NoteEditText) mEditTextList.getChildAt(i).findViewById(R.id.et_edit_text)) .setIndex(i); } } - private void switchToListMode(String text) { + private void switchToListMode(String text) {//将编辑框切换到清单模式 mEditTextList.removeAllViews(); String[] items = text.split("\n"); int index = 0; @@ -1802,10 +1804,10 @@ public class NoteEditActivity extends Activity implements OnClickListener, index++; } } - mEditTextList.addView(getListItem("", index)); - mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus(); + mEditTextList.addView(getListItem("", index));//添加一个空列表项 + mEditTextList.getChildAt(index).findViewById(R.id.et_edit_text).requestFocus();//将焦点自动切换到新添加的空列表项的编辑框 - mNoteEditor.setVisibility(View.GONE); + mNoteEditor.setVisibility(View.GONE);//隐藏编辑框 mEditTextList.setVisibility(View.VISIBLE); } @@ -1894,20 +1896,20 @@ public class NoteEditActivity extends Activity implements OnClickListener, private View getListItem(String item, int index) { View view = LayoutInflater.from(this).inflate(R.layout.note_edit_list_item, null); - final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); + final NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text);//获取列表项的编辑框 edit.setTextAppearance(this, TextAppearanceResources.getTexAppearanceResource(mFontSizeId)); - CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); - cb.setOnCheckedChangeListener(new OnCheckedChangeListener() { + CheckBox cb = ((CheckBox) view.findViewById(R.id.cb_edit_item)); //复选框用于让用户从有限数量的选项中选择一个或多个选项。 + cb.setOnCheckedChangeListener(new OnCheckedChangeListener() {//复选框变化监听 public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { - if (isChecked) { - edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); + if (isChecked) {//PaintFlags是Android中用于控制文本绘制样式的位掩码 ，通过位运算组合多个绘制标志 + edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG);//添加删除线效果 } else { - edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG); + edit.setPaintFlags(Paint.ANTI_ALIAS_FLAG | Paint.DEV_KERN_TEXT_FLAG);//清除删除线效果 } } }); - if (item.startsWith(TAG_CHECKED)) { + if (item.startsWith(TAG_CHECKED)) {//如果列表项以(TAG_CHECKED)开头，则将复选框设置为选中状态 cb.setChecked(true); edit.setPaintFlags(edit.getPaintFlags() | Paint.STRIKE_THRU_TEXT_FLAG); item = item.substring(TAG_CHECKED.length(), item.length()).trim(); @@ -1972,19 +1974,19 @@ public class NoteEditActivity extends Activity implements OnClickListener, } } - private boolean getWorkingText() { + private boolean getWorkingText() {//获取选中项的文本 boolean hasChecked = false; - if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) { + if (mWorkingNote.getCheckListMode() == TextNote.MODE_CHECK_LIST) {//如果是检查列表模式 StringBuilder sb = new StringBuilder(); for (int i = 0; i < mEditTextList.getChildCount(); i++) { View view = mEditTextList.getChildAt(i); NoteEditText edit = (NoteEditText) view.findViewById(R.id.et_edit_text); if (!TextUtils.isEmpty(edit.getText())) { if (((CheckBox) view.findViewById(R.id.cb_edit_item)).isChecked()) { - sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n"); + sb.append(TAG_CHECKED).append(" ").append(edit.getText()).append("\n");//如果列表项选中，则将其文本添加到 StringBuilder 中 hasChecked = true; } else { - sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n"); + sb.append(TAG_UNCHECKED).append(" ").append(edit.getText()).append("\n");//如果列表项未选中，则将其文本添加到 StringBuilder 中 } } } diff --git a/src/notes/ui/NoteEditText.java b/src/notes/ui/NoteEditText.java index 03cb5f4..629056c 100644 --- a/src/notes/ui/NoteEditText.java +++ b/src/notes/ui/NoteEditText.java @@ -37,87 +37,113 @@ import net.micode.notes.R; import java.util.HashMap; import java.util.Map; +/** + * 小米笔记的自定义文本编辑组件，扩展了Android原生EditText的功能 + * 支持特殊的按键处理、链接识别和动态添加/删除编辑框 + */ public class NoteEditText extends EditText { - private static final String TAG = "NoteEditText"; - private int mIndex; - private int mSelectionStartBeforeDelete; + 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:" ; // 电话协议 + private static final String SCHEME_HTTP = "http:" ; // HTTP协议 + private static final String SCHEME_EMAIL = "mailto:" ; // 邮件协议 + // 协议到字符串资源的映射表，用于上下文菜单显示 private static final Map sSchemaActionResMap = new HashMap(); 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 + * 与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 新编辑框的索引位置 + * @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); } -<<<<<<< HEAD:src/notes/ui/NoteEditText.java private OnTextViewChangeListener mOnTextViewChangeListener; //新增选区变化回调接口 private OnSelectionChangeListener mOnSelectionChangeListener; -======= - private OnTextViewChangeListener mOnTextViewChangeListener; // 文本变化监听器实例 ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NoteEditText.java + /** + * 构造函数，创建NoteEditText实例 + * @param context 上下文对象 + */ public NoteEditText(Context context) { super(context, null); mIndex = 0; } + /** + * 设置当前编辑框在容器中的索引位置 + * @param index 索引值 + */ public void setIndex(int index) { mIndex = index; } + /** + * 设置文本变化监听器，用于与NoteEditActivity通信 + * @param listener 监听器实例 + */ public void setOnTextViewChangeListener(OnTextViewChangeListener listener) { mOnTextViewChangeListener = listener; } -<<<<<<< HEAD:src/notes/ui/NoteEditText.java //新增选区变化回调接口设置方法 public void setOnSelectionChangeListener(OnSelectionChangeListener listener) { mOnSelectionChangeListener = listener; } -======= ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NoteEditText.java public NoteEditText(Context context, AttributeSet attrs) { super(context, attrs, android.R.attr.editTextStyle); } + /** + * 构造函数，从XML布局创建NoteEditText实例，支持自定义样式 + * @param context 上下文对象 + * @param attrs XML属性集合 + * @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(); @@ -135,15 +161,23 @@ public class NoteEditText extends EditText { return super.onTouchEvent(event); } + /** + * 重写按键按下事件处理 + * @param keyCode 按键码 + * @param event 按键事件对象 + * @return 事件处理结果 + */ @Override public boolean onKeyDown(int keyCode, KeyEvent event) { switch (keyCode) { case KeyEvent.KEYCODE_ENTER: + // 回车键按下时，交由onKeyUp处理 if (mOnTextViewChangeListener != null) { return false; } break; case KeyEvent.KEYCODE_DEL: + // 记录删除前的光标位置 mSelectionStartBeforeDelete = getSelectionStart(); break; default: @@ -152,10 +186,17 @@ 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()); @@ -166,10 +207,14 @@ 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)); + // 通知Activity添加新的编辑框 mOnTextViewChangeListener.onEditTextEnter(mIndex + 1, text); } else { Log.d(TAG, "OnTextViewChangeListener was not seted"); @@ -181,9 +226,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) { + // 失去焦点且文本为空时，通知Activity隐藏相关选项 if (!focused && TextUtils.isEmpty(getText())) { mOnTextViewChangeListener.onTextChange(mIndex, false); } else { @@ -193,8 +245,10 @@ public class NoteEditText extends EditText { super.onFocusChanged(focused, direction, previouslyFocusedRect); } - - + /** + * 创建上下文菜单，支持链接点击操作 + * @param menu 上下文菜单对象 + */ @Override protected void onCreateContextMenu(ContextMenu menu) { if (getText() instanceof Spanned) { @@ -204,8 +258,10 @@ public class NoteEditText extends EditText { int min = Math.min(selStart, selEnd); int max = Math.max(selStart, selEnd); + // 查找选中区域内的URLSpan final URLSpan[] urls = ((Spanned) getText()).getSpans(min, max, URLSpan.class); if (urls.length == 1) { + // 根据链接协议选择合适的菜单文本 int defaultResId = 0; for(String schema: sSchemaActionResMap.keySet()) { if(urls[0].getURL().indexOf(schema) >= 0) { @@ -218,10 +274,11 @@ public class NoteEditText extends EditText { 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); return true; } @@ -231,12 +288,9 @@ public class NoteEditText extends EditText { super.onCreateContextMenu(menu); } } -<<<<<<< HEAD:src/notes/ui/NoteEditText.java // 新增选区变化回调接口 interface OnSelectionChangeListener { void onSelectionChanged(int index, int selStart, int selEnd); } -======= ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NoteEditText.java diff --git a/src/notes/ui/NoteItemData.java b/src/notes/ui/NoteItemData.java index 7de56b1..9c58ddd 100644 --- a/src/notes/ui/NoteItemData.java +++ b/src/notes/ui/NoteItemData.java @@ -26,60 +26,77 @@ import net.micode.notes.data.Notes.NoteColumns; import net.micode.notes.tool.DataUtils; +/** + * 笔记列表项的数据模型类，负责从数据库Cursor中读取数据并封装成Java对象 + * 包含笔记的基本属性、通话记录信息和列表位置状态 + */ 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.IS_HABIT, + 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, // 小部件类型 + NoteColumns.IS_HABIT, // 是否为习惯笔记 }; - 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 static final int IS_HABIT_COLUMN = 12; - - 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 boolean mIsHabit; - private String mName; - private String mPhoneNumber; - - private boolean mIsLastItem; - private boolean mIsFirstItem; - private boolean mIsOnlyOneItem; - private boolean mIsOneNoteFollowingFolder; - private boolean mIsMultiNotesFollowingFolder; - + /** + * 投影数组的列索引常量，用于从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; // 笔记唯一标识符 + 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; // 笔记类型（普通笔记/文件夹/系统文件夹） + private int mWidgetId; // 关联的小部件ID + private int mWidgetType; // 小部件类型 + + // 通话记录相关属性 + private String mName; // 通话记录联系人姓名 + private String mPhoneNumber; // 通话记录电话号码 + + // 列表位置状态 + private boolean mIsLastItem; // 是否为列表最后一项 + private boolean mIsFirstItem; // 是否为列表第一项 + private boolean mIsOnlyOneItem; // 是否为列表唯一一项 + private boolean mIsOneNoteFollowingFolder; // 是否是文件夹下的唯一笔记 + private boolean mIsMultiNotesFollowingFolder; // 是否是文件夹下的多个笔记之一 + + /** + * 构造函数，从Cursor中读取数据并初始化成员变量 + * @param cursor 包含笔记数据的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); @@ -106,11 +123,13 @@ public class NoteItemData { mPhoneNumber = ""; if (mParentId == Notes.ID_CALL_RECORD_FOLDER) { + // 获取通话记录的电话号码 mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); if (!TextUtils.isEmpty(mPhoneNumber)) { + // 获取联系人姓名 mName = Contact.getContact(context, mPhoneNumber); if (mName == null) { - mName = mPhoneNumber; + mName = mPhoneNumber; // 无联系人时显示电话号码 } } } @@ -118,27 +137,37 @@ public class NoteItemData { if (mName == null) { mName = ""; } + // 检查并设置当前项在列表中的位置关系 checkPostion(cursor); } + /** + * 检查当前项在列表中的位置关系，并设置相应的状态标志 + */ private void checkPostion(Cursor cursor) { + // 检查基本位置状态 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.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) { + // 检查后续是否还有更多笔记 if (cursor.getCount() > (position + 1)) { mIsMultiNotesFollowingFolder = true; } else { mIsOneNoteFollowingFolder = true; } } + // 恢复到原位置 if (!cursor.moveToNext()) { throw new IllegalStateException("cursor move to previous but can't move back"); } @@ -146,94 +175,187 @@ public class NoteItemData { } } + /** + * 是否是文件夹下的唯一笔记 + * @return true如果是文件夹下的唯一笔记，否则false + */ public boolean isOneFollowingFolder() { return mIsOneNoteFollowingFolder; } + /** + * 是否是文件夹下的多个笔记之一 + * @return true如果是文件夹下的多个笔记之一，否则false + */ public boolean isMultiFollowingFolder() { return mIsMultiNotesFollowingFolder; } + /** + * 是否为列表最后一项 + * @return true如果是最后一项，否则false + */ public boolean isLast() { return mIsLastItem; } + /** + * 获取通话记录联系人姓名 + * @return 联系人姓名，无联系人时返回电话号码 + */ public String getCallName() { return mName; } + /** + * 是否为列表第一项 + * @return true如果是第一项，否则false + */ public boolean isFirst() { return mIsFirstItem; } + /** + * 是否为列表唯一一项 + * @return true如果是唯一一项，否则false + */ public boolean isSingle() { return mIsOnlyOneItem; } + /** + * 获取笔记ID + * @return 笔记唯一标识符 + */ public long getId() { return mId; } + /** + * 获取提醒日期 + * @return 提醒日期时间戳（毫秒） + */ public long getAlertDate() { return mAlertDate; } + /** + * 获取创建日期 + * @return 创建日期时间戳（毫秒） + */ public long getCreatedDate() { return mCreatedDate; } + /** + * 是否包含附件 + * @return true如果包含附件，否则false + */ public boolean hasAttachment() { return mHasAttachment; } + /** + * 获取最后修改日期 + * @return 最后修改日期时间戳（毫秒） + */ public long getModifiedDate() { return mModifiedDate; } + /** + * 获取背景颜色ID + * @return 背景颜色ID + */ public int getBgColorId() { return mBgColorId; } + /** + * 获取父文件夹ID + * @return 所属父文件夹ID + */ public long getParentId() { return mParentId; } + /** + * 获取文件夹包含的笔记数量 + * @return 笔记数量 + */ public int getNotesCount() { return mNotesCount; } + /** + * 获取文件夹ID（与getParentId()相同） + * @return 文件夹ID + */ public long getFolderId () { return mParentId; } + /** + * 获取笔记类型 + * @return 笔记类型（普通笔记/文件夹/系统文件夹） + */ public int getType() { return mType; } + /** + * 获取小部件类型 + * @return 小部件类型 + */ public int getWidgetType() { return mWidgetType; } + /** + * 获取关联的小部件ID + * @return 小部件ID + */ public int getWidgetId() { return mWidgetId; } + /** + * 获取笔记内容摘要 + * @return 内容摘要 + */ public String getSnippet() { return mSnippet; } + /** + * 是否设置了提醒 + * @return true如果设置了提醒，否则false + */ public boolean hasAlert() { return (mAlertDate > 0); } + /** + * 是否为习惯笔记 + * @return true如果是习惯笔记，否则false + */ public boolean isHabit() { return mIsHabit; } - + + /** + * 是否为通话记录笔记 + * @return true如果是通话记录笔记，否则false + */ public boolean isCallRecord() { return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); } + /** + * 静态方法：从Cursor中直接获取笔记类型 + * @param cursor 包含笔记数据的Cursor + * @return 笔记类型 + */ public static int getNoteType(Cursor cursor) { return cursor.getInt(TYPE_COLUMN); } diff --git a/src/notes/ui/NotesListActivity.java b/src/notes/ui/NotesListActivity.java index 2c73c9d..73970c3 100644 --- a/src/notes/ui/NotesListActivity.java +++ b/src/notes/ui/NotesListActivity.java @@ -701,7 +701,7 @@ public class NotesListActivity extends Activity implements OnClickListener, OnIt } return false; } - default: { + default: {// 处理"新建笔记"按钮的其他事件 if (mDispatch) { event.setLocation(event.getX(), mDispatchY); boolean result = mNotesListView.dispatchTouchEvent(event); diff --git a/src/notes/ui/NotesListAdapter.java b/src/notes/ui/NotesListAdapter.java index 8cff954..059730f 100644 --- a/src/notes/ui/NotesListAdapter.java +++ b/src/notes/ui/NotesListAdapter.java @@ -31,51 +31,46 @@ import java.util.HashSet; import java.util.Iterator; -public class NotesListAdapter extends CursorAdapter { - private static final String TAG = "NotesListAdapter"; - private Context mContext; - private HashMap mSelectedIndex; - private int mNotesCount; - private boolean mChoiceMode; - - private boolean mIncludeFolders; - - public static class AppWidgetAttribute { - public int widgetId; - public int widgetType; +public class NotesListAdapter extends CursorAdapter {//Adapter作为Activity和ListView之间的适配器，将Cursor数据转换为ListView可以理解的视图格式 + private static final String TAG = "NotesListAdapter"; // 日志标签 + private Context mContext; // 上下文对象 + private HashMap mSelectedIndex; // 选中项索引映射 + private int mNotesCount; // 笔记数量（排除文件夹） + private boolean mChoiceMode; // 是否处于选择模式 + + public static class AppWidgetAttribute { // 小部件属性类，用于存储小部件的ID和类型 + public int widgetId; // 小部件ID + public int widgetType; // 小部件类型 }; -<<<<<<< HEAD:src/notes/ui/NotesListAdapter.java -======= ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NotesListAdapter.java - public NotesListAdapter(Context context) { + public NotesListAdapter(Context context) { // 构造函数，创建NotesListAdapter实例 super(context, null); - mSelectedIndex = new HashMap(); + mSelectedIndex = new HashMap(); // 初始化选中项映射 mContext = context; mNotesCount = 0; } @Override public View newView(Context context, Cursor cursor, ViewGroup parent) { - return new NotesListItem(context); + return new NotesListItem(context); // 创建新的NotesListItem } @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, + NoteItemData itemData = new NoteItemData(context, cursor); // 创建数据模型 + ((NotesListItem) view).bind(context, itemData, mChoiceMode, // 绑定数据到视图 isSelectedItem(cursor.getPosition())); } } public void setCheckedItem(final int position, final boolean checked) { - mSelectedIndex.put(position, checked); - notifyDataSetChanged(); + mSelectedIndex.put(position, checked); // 更新选中状态 + notifyDataSetChanged(); // 通知数据变化，刷新UI } public boolean isInChoiceMode() { - return mChoiceMode; + return mChoiceMode; // 检查是否处于选择模式 } public void setChoiceMode(boolean mode) { @@ -101,15 +96,15 @@ public class NotesListAdapter extends CursorAdapter { } } - public HashSet getSelectedItemIds() { + public HashSet getSelectedItemIds() {// 获取选中项的ID集合 HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { if (mSelectedIndex.get(position) == true) { - Long id = getItemId(position); + Long id = getItemId(position); // 获取选中项的ID if (id == Notes.ID_ROOT_FOLDER) { Log.d(TAG, "Wrong item id, should not happen"); } else { - itemSet.add(id); + itemSet.add(id); // 添加到集合 } } } @@ -117,7 +112,7 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } - public HashSet getSelectedWidget() { + public HashSet getSelectedWidget() {// 获取选中项的小部件属性集合 HashSet itemSet = new HashSet(); for (Integer position : mSelectedIndex.keySet()) { if (mSelectedIndex.get(position) == true) { @@ -125,8 +120,8 @@ public class NotesListAdapter extends CursorAdapter { if (c != null) { AppWidgetAttribute widget = new AppWidgetAttribute(); NoteItemData item = new NoteItemData(mContext, c); - widget.widgetId = item.getWidgetId(); - widget.widgetType = item.getWidgetType(); + widget.widgetId = item.getWidgetId(); // 获取小部件ID + widget.widgetType = item.getWidgetType(); // 获取小部件类型 itemSet.add(widget); /** * Don't close cursor here, only the adapter could close it @@ -140,7 +135,7 @@ public class NotesListAdapter extends CursorAdapter { return itemSet; } - public int getSelectedCount() { + public int getSelectedCount() {// 获取选中项数量 Collection values = mSelectedIndex.values(); if (null == values) { return 0; @@ -152,39 +147,39 @@ public class NotesListAdapter extends CursorAdapter { count++; } } - return count; + return count; // 返回选中项数量 } - public boolean isAllSelected() { + public boolean isAllSelected() {// 检查是否所有笔记都被选中 int checkedCount = getSelectedCount(); - return (checkedCount != 0 && checkedCount == mNotesCount); + return (checkedCount != 0 && checkedCount == mNotesCount); } - public boolean isSelectedItem(final int position) { + public boolean isSelectedItem(final int position) {// 检查指定位置的项是否被选中 if (null == mSelectedIndex.get(position)) { return false; } - return mSelectedIndex.get(position); + return mSelectedIndex.get(position); // 检查指定位置的项是否被选中 } @Override protected void onContentChanged() { super.onContentChanged(); - calcNotesCount(); + calcNotesCount(); // 当内容变化时，重新计算笔记数量 } @Override public void changeCursor(Cursor cursor) { super.changeCursor(cursor); - calcNotesCount(); + calcNotesCount(); // 当游标变化时，重新计算笔记数量 } - private void 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) { + if (NoteItemData.getNoteType(c) == Notes.TYPE_NOTE) { // 只统计普通笔记，排除文件夹 mNotesCount++; } } else { diff --git a/src/notes/ui/NotesListItem.java b/src/notes/ui/NotesListItem.java index d5ac8c9..9adad93 100644 --- a/src/notes/ui/NotesListItem.java +++ b/src/notes/ui/NotesListItem.java @@ -31,17 +31,16 @@ import net.micode.notes.tool.ResourceParser.NoteItemBgResources; public class NotesListItem extends LinearLayout { - private ImageView mAlert; -<<<<<<< HEAD:src/notes/ui/NotesListItem.java - private ImageView mHabit; -======= ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NotesListItem.java - 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; // 选择模式下的复选框（用于批量操作） + /** + * 构造函数，初始化视图组件 + */ public NotesListItem(Context context) { super(context); inflate(context, R.layout.note_item, this); @@ -53,6 +52,11 @@ public class NotesListItem extends LinearLayout { mCheckBox = (CheckBox) findViewById(android.R.id.checkbox); } + /** + * 绑定数据到视图，根据数据类型动态调整UI样式 + * @param data 笔记数据模型 + * @param checked 选择模式下是否选中 + */ public void bind(Context context, NoteItemData data, boolean choiceMode, boolean checked) { if (choiceMode && data.getType() == Notes.TYPE_NOTE) { mCheckBox.setVisibility(View.VISIBLE); @@ -75,11 +79,7 @@ public class NotesListItem extends LinearLayout { mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); mTitle.setText(context.getString(R.string.trash_folder_name) + context.getString(R.string.format_folder_files_count, data.getNotesCount())); -<<<<<<< HEAD:src/notes/ui/NotesListItem.java mAlert.setImageResource(R.drawable.baseline_restore_from_trash_24); -======= - mAlert.setImageResource(android.R.drawable.ic_menu_delete); ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NotesListItem.java } else if (data.getParentId() == Notes.ID_CALL_RECORD_FOLDER) { mCallName.setVisibility(View.VISIBLE); mCallName.setText(data.getCallName()); @@ -91,22 +91,12 @@ public class NotesListItem extends LinearLayout { } else { mAlert.setVisibility(View.GONE); } -<<<<<<< HEAD:src/notes/ui/NotesListItem.java // habit badge if (data.isHabit()) { mHabit.setVisibility(View.VISIBLE); } else { mHabit.setVisibility(View.GONE); } -======= - } else if (data.getId() == Notes.ID_TRASH_FOLER) { //为回收站添加图标和显示逻辑 - mCallName.setVisibility(View.GONE); - mAlert.setVisibility(View.VISIBLE); - mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); - mTitle.setText(context.getString(R.string.trash_folder_name) - + context.getString(R.string.format_folder_files_count, data.getNotesCount())); - mAlert.setImageResource(R.drawable.baseline_restore_from_trash_24); ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NotesListItem.java } else { mCallName.setVisibility(View.GONE); mTitle.setTextAppearance(context, R.style.TextAppearancePrimaryItem); @@ -143,9 +133,13 @@ public class NotesListItem extends LinearLayout { setBackground(data); } + /** + * 根据笔记类型和位置设置不同的背景资源 + */ private void setBackground(NoteItemData data) { int id = data.getBgColorId(); if (data.getType() == Notes.TYPE_NOTE) { + // 根据笔记在列表中的位置设置不同背景 if (data.isSingle() || data.isOneFollowingFolder()) { setBackgroundResource(NoteItemBgResources.getNoteBgSingleRes(id)); } else if (data.isLast()) { @@ -156,10 +150,14 @@ public class NotesListItem extends LinearLayout { setBackgroundResource(NoteItemBgResources.getNoteBgNormalRes(id)); } } else { + // 文件夹使用统一背景 setBackgroundResource(NoteItemBgResources.getFolderBgRes()); } } + /** + * 获取当前列表项的数据模型 + */ public NoteItemData getItemData() { return mItemData; } diff --git a/src/notes/ui/NotesPreferenceActivity.java b/src/notes/ui/NotesPreferenceActivity.java index 9964f6d..672cb12 100644 --- a/src/notes/ui/NotesPreferenceActivity.java +++ b/src/notes/ui/NotesPreferenceActivity.java @@ -48,27 +48,37 @@ 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; - + /** GTask同步广播接收器 */ private GTaskReceiver mReceiver; - + /** 原始账户列表，用于检测是否添加了新账户 */ private Account[] mOriAccounts; - + /** 是否添加了新账户的标志 */ private boolean mHasAddedAccount; + /** + * 创建偏好设置活动时的初始化操作 + * @param icicle 保存的活动状态 + */ @Override protected void onCreate(Bundle icicle) { super.onCreate(icicle); @@ -81,21 +91,20 @@ public class NotesPreferenceActivity extends PreferenceActivity { mReceiver = new GTaskReceiver(); IntentFilter filter = new IntentFilter(); filter.addAction(GTaskSyncService.GTASK_SERVICE_BROADCAST_NAME); -<<<<<<< HEAD:src/notes/ui/NotesPreferenceActivity.java if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.TIRAMISU) { registerReceiver(mReceiver, filter, Context.RECEIVER_NOT_EXPORTED); } else { registerReceiver(mReceiver, filter); } -======= - registerReceiver(mReceiver, filter); ->>>>>>> c2e9e136026fe8d21df7cf360e2d6ea397c67d5f:src/ui/NotesPreferenceActivity.java mOriAccounts = null; View header = LayoutInflater.from(this).inflate(R.layout.settings_header, null); getListView().addHeaderView(header, null, true); } + /** + * 活动恢复时调用，处理账户添加检测和UI刷新 + */ @Override protected void onResume() { super.onResume(); @@ -124,6 +133,9 @@ public class NotesPreferenceActivity extends PreferenceActivity { refreshUI(); } + /** + * 活动销毁时调用，用于清理资源 + */ @Override protected void onDestroy() { if (mReceiver != null) { @@ -132,6 +144,9 @@ public class NotesPreferenceActivity extends PreferenceActivity { super.onDestroy(); } + /** + * 加载账户偏好设置，创建账户选择偏好项 + */ private void loadAccountPreference() { mAccountCategory.removeAll(); @@ -162,6 +177,9 @@ 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); @@ -201,11 +219,17 @@ public class NotesPreferenceActivity extends PreferenceActivity { } } + /** + * 刷新UI界面，重新加载账户偏好和同步按钮状态 + */ private void refreshUI() { loadAccountPreference(); loadSyncButton(); } + /** + * 显示选择账户的对话框，允许用户选择或添加Google账户 + */ private void showSelectAccountAlertDialog() { AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this); @@ -262,6 +286,9 @@ public class NotesPreferenceActivity extends PreferenceActivity { }); } + /** + * 显示更改账户的确认对话框，提示用户更改账户的风险 + */ private void showChangeAccountConfirmAlertDialog() { AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(this); @@ -291,11 +318,19 @@ public class NotesPreferenceActivity extends PreferenceActivity { dialogBuilder.show(); } + /** + * 获取所有Google账户列表 + * @return Google账户数组 + */ 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); @@ -326,6 +361,9 @@ public class NotesPreferenceActivity extends PreferenceActivity { } } + /** + * 移除同步账户，清理相关数据 + */ private void removeSyncAccount() { SharedPreferences settings = getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); SharedPreferences.Editor editor = settings.edit(); @@ -348,12 +386,19 @@ public class NotesPreferenceActivity extends PreferenceActivity { }).start(); } + /** + * 获取当前同步账户名称 + * @return 同步账户名称 + */ public static String getSyncAccountName(Context context) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); return settings.getString(PREFERENCE_SYNC_ACCOUNT_NAME, ""); } + /** + * 设置最后同步时间 + */ public static void setLastSyncTime(Context context, long time) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); @@ -362,6 +407,10 @@ public class NotesPreferenceActivity extends PreferenceActivity { editor.commit(); } + /** + * 获取最后同步时间 + * @return 最后同步时间（毫秒） + */ public static long getLastSyncTime(Context context) { SharedPreferences settings = context.getSharedPreferences(PREFERENCE_NAME, Context.MODE_PRIVATE); @@ -382,6 +431,10 @@ public class NotesPreferenceActivity extends PreferenceActivity { } } + /** + * 处理选项菜单点击事件 + * @param item 点击的菜单项 + */ public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case android.R.id.home: diff --git a/src/ui/NoteItemData.java b/src/ui/NoteItemData.java deleted file mode 100644 index 7021ee6..0000000 --- a/src/ui/NoteItemData.java +++ /dev/null @@ -1,345 +0,0 @@ -/* - * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) - * - * Licensed under the Apache License, Version 2.0 (the "License"); - * you may not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, - * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - */ - -package net.micode.notes.ui; - -import android.content.Context; -import android.database.Cursor; -import android.text.TextUtils; - -import net.micode.notes.data.Contact; -import net.micode.notes.data.Notes; -import net.micode.notes.data.Notes.NoteColumns; -import net.micode.notes.tool.DataUtils; - - -/** - * 笔记列表项的数据模型类，负责从数据库Cursor中读取数据并封装成Java对象 - * 包含笔记的基本属性、通话记录信息和列表位置状态 - */ -public class NoteItemData { - /** - * 数据库查询的列投影，定义需要从数据库读取的字段 - */ - static final String [] PROJECTION = new String [] { - 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, // 小部件类型 - }; - - /** - * 投影数组的列索引常量，用于从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; // 笔记唯一标识符 - 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; // 笔记类型（普通笔记/文件夹/系统文件夹） - private int mWidgetId; // 关联的小部件ID - private int mWidgetType; // 小部件类型 - - // 通话记录相关属性 - private String mName; // 通话记录联系人姓名 - private String mPhoneNumber; // 通话记录电话号码 - - // 列表位置状态 - private boolean mIsLastItem; // 是否为列表最后一项 - private boolean mIsFirstItem; // 是否为列表第一项 - private boolean mIsOnlyOneItem; // 是否为列表唯一一项 - private boolean mIsOneNoteFollowingFolder; // 是否是文件夹下的唯一笔记 - private boolean mIsMultiNotesFollowingFolder; // 是否是文件夹下的多个笔记之一 - - /** - * 构造函数，从Cursor中读取数据并初始化成员变量 - * @param cursor 包含笔记数据的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); - mCreatedDate = cursor.getLong(CREATED_DATE_COLUMN); - mHasAttachment = (cursor.getInt(HAS_ATTACHMENT_COLUMN) > 0) ? true : false; - mModifiedDate = cursor.getLong(MODIFIED_DATE_COLUMN); - mNotesCount = cursor.getInt(NOTES_COUNT_COLUMN); - mParentId = cursor.getLong(PARENT_ID_COLUMN); - mSnippet = cursor.getString(SNIPPET_COLUMN); - 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) { - // 获取通话记录的电话号码 - mPhoneNumber = DataUtils.getCallNumberByNoteId(context.getContentResolver(), mId); - if (!TextUtils.isEmpty(mPhoneNumber)) { - // 获取联系人姓名 - mName = Contact.getContact(context, mPhoneNumber); - if (mName == null) { - mName = mPhoneNumber; // 无联系人时显示电话号码 - } - } - } - - if (mName == null) { - mName = ""; - } - // 检查并设置当前项在列表中的位置关系 - checkPostion(cursor); - } - - /** - * 检查当前项在列表中的位置关系，并设置相应的状态标志 - */ - private void checkPostion(Cursor cursor) { - // 检查基本位置状态 - 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.getInt(TYPE_COLUMN) == Notes.TYPE_FOLDER - || cursor.getInt(TYPE_COLUMN) == Notes.TYPE_SYSTEM) { - // 检查后续是否还有更多笔记 - if (cursor.getCount() > (position + 1)) { - mIsMultiNotesFollowingFolder = true; // 文件夹后有多个笔记 - } else { - mIsOneNoteFollowingFolder = true; // 文件夹后只有一个笔记 - } - } - // 恢复到原位置 - if (!cursor.moveToNext()) { - throw new IllegalStateException("cursor move to previous but can't move back"); - } - } - } - } - - /** - * 是否是文件夹下的唯一笔记 - * @return true如果是文件夹下的唯一笔记，否则false - */ - public boolean isOneFollowingFolder() { - return mIsOneNoteFollowingFolder; - } - - /** - * 是否是文件夹下的多个笔记之一 - * @return true如果是文件夹下的多个笔记之一，否则false - */ - public boolean isMultiFollowingFolder() { - return mIsMultiNotesFollowingFolder; - } - - /** - * 是否为列表最后一项 - * @return true如果是最后一项，否则false - */ - public boolean isLast() { - return mIsLastItem; - } - - /** - * 获取通话记录联系人姓名 - * @return 联系人姓名，无联系人时返回电话号码 - */ - public String getCallName() { - return mName; - } - - /** - * 是否为列表第一项 - * @return true如果是第一项，否则false - */ - public boolean isFirst() { - return mIsFirstItem; - } - - /** - * 是否为列表唯一一项 - * @return true如果是唯一一项，否则false - */ - public boolean isSingle() { - return mIsOnlyOneItem; - } - - /** - * 获取笔记ID - * @return 笔记唯一标识符 - */ - public long getId() { - return mId; - } - - /** - * 获取提醒日期 - * @return 提醒日期时间戳（毫秒） - */ - public long getAlertDate() { - return mAlertDate; - } - - /** - * 获取创建日期 - * @return 创建日期时间戳（毫秒） - */ - public long getCreatedDate() { - return mCreatedDate; - } - - /** - * 是否包含附件 - * @return true如果包含附件，否则false - */ - public boolean hasAttachment() { - return mHasAttachment; - } - - /** - * 获取最后修改日期 - * @return 最后修改日期时间戳（毫秒） - */ - public long getModifiedDate() { - return mModifiedDate; - } - - /** - * 获取背景颜色ID - * @return 背景颜色ID - */ - public int getBgColorId() { - return mBgColorId; - } - - /** - * 获取父文件夹ID - * @return 所属父文件夹ID - */ - public long getParentId() { - return mParentId; - } - - /** - * 获取文件夹包含的笔记数量 - * @return 笔记数量 - */ - public int getNotesCount() { - return mNotesCount; - } - - /** - * 获取文件夹ID（与getParentId()相同） - * @return 文件夹ID - */ - public long getFolderId () { - return mParentId; - } - - /** - * 获取笔记类型 - * @return 笔记类型（普通笔记/文件夹/系统文件夹） - */ - public int getType() { - return mType; - } - - /** - * 获取小部件类型 - * @return 小部件类型 - */ - public int getWidgetType() { - return mWidgetType; - } - - /** - * 获取关联的小部件ID - * @return 小部件ID - */ - public int getWidgetId() { - return mWidgetId; - } - - /** - * 获取笔记内容摘要 - * @return 内容摘要 - */ - public String getSnippet() { - return mSnippet; - } - - /** - * 是否设置了提醒 - * @return true如果设置了提醒，否则false - */ - public boolean hasAlert() { - return (mAlertDate > 0); - } - - /** - * 是否为通话记录 - * @return true如果是通话记录，否则false - */ - public boolean isCallRecord() { - return (mParentId == Notes.ID_CALL_RECORD_FOLDER && !TextUtils.isEmpty(mPhoneNumber)); - } - - /** - * 静态方法：从Cursor中直接获取笔记类型 - * @param cursor 包含笔记数据的Cursor - * @return 笔记类型 - */ - public static int getNoteType(Cursor cursor) { - return cursor.getInt(TYPE_COLUMN); - } -}