p82feo7wg
/
MiNoteRead
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

修改部分注释

Browse Source
pull/6/head
AetherPendragon 3 weeks ago
parent 06711ccca6
commit bc5ca6f0a0
3 changed files with 141 additions and 162 deletions
Show Stats Download Patch File Download Diff File

54
src/Notes-master/src/net/micode/notes/data/Contact.java
Unescape View File

@ -26,13 +26,14 @@ import android.util.Log;
import java.util.HashMap;
/**
* 联系人查询工具类。
* <p>职责：根据电话号码在系统通讯录中查找联系人姓名，并通过内存缓存减少重复查询。</p>
* <p>使用场景：通话记录笔记等功能需要把电话号码转成可读的联系人姓名。</p>
* 联系人查询工具类
* 核心功能：在小米便签中用于智能识别电话号码并显示联系人名称
* 实现方法：通过电话号码查询系统联系人的姓名，并通过哈希表缓存查询结果，避免重复查询，提升性能
*/
public class Contact {
/** 联系人缓存，用于提高查询效率，key 为原始电话号码字符串，value 为联系人姓名 */
// 功能：缓存查询结果，，暂时存储电话号码与联系人的映射关系，避免重复查询,节省开销
private static HashMap<String, String> sContactCache;
// 日志标签
private static final String TAG = "Contact";
/**
@ -45,6 +46,20 @@ public class Contact {
+ "(SELECT raw_contact_id "
+ " FROM phone_lookup"
+ " WHERE min_match = '+')";
/**
* SQL语句逻辑解读
* AND 连接一个条件与下一个条件
* 第一个条件：PHONE_NUMBERS_EQUAL(Phone.NUMBER,?)
* PHONE_NUMBERS_EQUAL 函数：Android系统提供的特殊函数，用于查找和Phone.NUMBER相同的电话号码
* 第二个条件：Data.MIMETYPE = 'Phone.CONTENT_ITEM_TYPE'
* 确保数据类型必须是电话号码类型
* 第三个条件：Data.RAW_CONTACT_ID IN A
* 联系人的ID必须存在于这个表格A中
* 表格A：(SELECT raw_contact_id FROM phone_lookup WHERE min_match = '+')
* phone_lookup：Android系统中的一个与联系人数据有关的特殊表
* min_match：最小匹配位数
* 预先计算一个电话号码的最小匹配形式的表格
*/
/**
* 根据电话号码获取联系人姓名。
@ -54,41 +69,50 @@ public class Contact {
* @return 联系人姓名；未找到或异常时返回 null
*/
public static String getContact(Context context, String phoneNumber) {
// 初始化缓存：首次调用时创建，后续复用
// 初始化查询缓存
if(sContactCache == null) {
sContactCache = new HashMap<String, String>();
}
// 先从缓存中查找，命中则直接返回，避免再次访问数据库
// 检查缓存中是否已存在该电话号码的查询结果
if(sContactCache.containsKey(phoneNumber)) {
return sContactCache.get(phoneNumber);
}
// 构建查询条件：将占位符中的“+”替换为待查询号码的最小匹配值
// PhoneNumberUtils.toCallerIDMinMatch(phoneNumber)用于计算电话号码的最小匹配位数
// 将占位符"+"替换为最小匹配数,以构建完整的查询语句
String selection = CALLER_ID_SELECTION.replace("+",
PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
// 查询联系人数据库，仅投影联系人显示名
/**
* 查询联系人数据库
* context.getContentResolver().query：查询当前应用程序的数据
*/
Cursor cursor = context.getContentResolver().query(
Data.CONTENT_URI,
new String [] { Phone.DISPLAY_NAME },
selection,
new String[] { phoneNumber },
null);
Data.CONTENT_URI, // 查询URI
new String [] { Phone.DISPLAY_NAME }, // 联系人的名称作为返回值
selection, // 查询条件
new String[] { phoneNumber }, // 电话号码作为查询参数
null); // 无排序方式
// 查询系统联系人数据库
if (cursor != null && cursor.moveToFirst()) {
try {
// 取出第一条记录的联系人姓名
// 获取第一行第一列的联系人姓名
String name = cursor.getString(0);
// 将结果存入缓存，便于下次直接复用
// 将查询结果存入缓存
sContactCache.put(phoneNumber, name);
return name;
} catch (IndexOutOfBoundsException e) {
// 发生数组越界异常，将异常记录到日志Log中
Log.e(TAG, " Cursor get string error " + e.toString());
return null;
} finally {
// 关闭Cursor，防止内存泄露
cursor.close();
}
} else {
// 没有找到匹配的联系人，将信息写入日志中
Log.d(TAG, "No contact matched with number:" + phoneNumber);
return null;
}

221
src/Notes-master/src/net/micode/notes/data/Notes.java
Unescape View File

@ -20,38 +20,40 @@ import android.net.Uri;
/**
* 笔记应用的数据常量定义类。
* <p>职责：集中管理 ContentProvider 相关的 URI、表字段、类型常量和系统文件夹 ID，避免硬编码分散。</p>
* <p>主要被数据层（Provider、DatabaseHelper）和业务层（UI、同步）引用。</p>
* 功能：集中管理 ContentProvider 相关的 URI、表字段、类型常量和系统文件夹 ID，避免硬编码分散。
* 主要被数据层（Provider、DatabaseHelper）和业务层（UI、GTASK）引用。
*/
public class Notes {
/** ContentProvider的授权标识 */
// ContentProvider的授权标识
public static final String AUTHORITY = "micode_notes";
// 日志标签
public static final String TAG = "Notes";
/** 笔记类型：普通笔记 */
// 0类型：普通笔记
public static final int TYPE_NOTE = 0;
/** 笔记类型：文件夹 */
// 1类型：文件夹
public static final int TYPE_FOLDER = 1;
/** 笔记类型：系统文件夹 */
// 2类型：系统文件夹
public static final int TYPE_SYSTEM = 2;
/**
* 系统文件夹的 ID 定义。
* <ul>
* <li>{@link #ID_ROOT_FOLDER} 默认根文件夹</li>
* <li>{@link #ID_TEMPARAY_FOLDER} 临时文件夹，移动笔记时的中转</li>
* <li>{@link #ID_CALL_RECORD_FOLDER} 通话记录专用文件夹</li>
* <li>{@link #ID_TRASH_FOLER} 回收站</li>
* </ul>
*/
/** 根文件夹ID */
// 系统文件夹的 ID 定义。
// #ID_ROOT_FOLDER 默认根文件夹
// #ID_TEMPARAY_FOLDER 临时文件夹，移动笔记时的中转
// #ID_CALL_RECORD_FOLDER 通话记录专用文件夹
// #ID_TRASH_FOLER 回收站
public static final int ID_ROOT_FOLDER = 0;
/** 临时文件夹ID，用于存放不属于任何文件夹的笔记 */
public static final int ID_TEMPARAY_FOLDER = -1;
/** 通话记录文件夹ID */
public static final int ID_CALL_RECORD_FOLDER = -2;
/** 回收站文件夹ID */
public static final int ID_TRASH_FOLER = -3;
/**
* Intent Extra 键常量，用于在 Android 组件间通过 Intent 传递数据，包括：
* 1. 提醒日期
* 2. 背景颜色ID
* 3. 小部件ID
* 4. 小部件类型
* 5. 文件夹ID
* 6. 通话日期
*/
public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
@ -59,220 +61,171 @@ public class Notes {
public static final String INTENT_EXTRA_FOLDER_ID = "net.micode.notes.folder_id";
public static final String INTENT_EXTRA_CALL_DATE = "net.micode.notes.call_date";
/** 无效的小部件类型 */
// 无效的小部件类型 -1
public static final int TYPE_WIDGET_INVALIDE = -1;
/** 2x2小部件类型 */
// 2x2小部件类型 0
public static final int TYPE_WIDGET_2X = 0;
/** 4x4小部件类型 */
// 4x4小部件类型 1
public static final int TYPE_WIDGET_4X = 1;
/** 数据类型常量，指明不同数据行的 MIME 类型 */
// 数据类型常量，指明不同数据行的 MIME(Multipurpose Internet Mail Extensions,用于标识 ContentProvider 返回的数据类型。)
public static class DataConstants {
/** 普通笔记的MIME类型 */
// 普通笔记的MIME类型
public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
/** 通话记录笔记的MIME类型 */
// 通话记录笔记的MIME类型
public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
}
/** 查询所有笔记和文件夹的URI */
// URI 是 ContentProvider 的标准访问入口，用于统一访问应用的数据。
// 查询所有笔记和文件夹的URI
public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
/** 查询数据表的URI */
// 查询数据表的URI
public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
/** 笔记表的列名接口，声明 note 表包含的所有字段 */
/**
* NoteColumns 接口 - 便签表(notes表)列定义
* 定义了便签和文件夹数据库表的所有列名和类型
*/
public interface NoteColumns {
/**
* 行的唯一ID，类型: INTEGER (long)
*/
// 行的唯一ID
public static final String ID = "_id";
/**
* 笔记或文件夹的父ID，类型: INTEGER (long)
*/
// 笔记或文件夹的父ID
public static final String PARENT_ID = "parent_id";
/**
* 笔记或文件夹的创建日期，类型: INTEGER (long)
*/
// 笔记或文件夹的创建日期
public static final String CREATED_DATE = "created_date";
/**
* 最后修改日期，类型: INTEGER (long)
*/
// 最后修改日期
public static final String MODIFIED_DATE = "modified_date";
/**
* 提醒日期，类型: INTEGER (long)
*/
// 提醒日期
public static final String ALERTED_DATE = "alert_date";
/**
* 文件夹名称或笔记的文本内容摘要，类型: TEXT
*/
// 文件夹名称或笔记的文本内容摘要
public static final String SNIPPET = "snippet";
/**
* 笔记的小部件ID，类型: INTEGER (long)
*/
// 笔记的小部件ID
public static final String WIDGET_ID = "widget_id";
/**
* 笔记的小部件类型，类型: INTEGER (long)
*/
// 笔记的小部件类型
public static final String WIDGET_TYPE = "widget_type";
/**
* 笔记的背景颜色ID，类型: INTEGER (long)
*/
// 笔记的背景颜色ID
public static final String BG_COLOR_ID = "bg_color_id";
/**
* 是否有附件，类型: INTEGER；对于文本笔记没有附件，多媒体笔记至少有一个附件
*/
// 是否有附件；对于文本笔记没有附件，多媒体笔记至少有一个附件
public static final String HAS_ATTACHMENT = "has_attachment";
/**
* 文件夹中的笔记数量，类型: INTEGER (long)
*/
// 文件夹中的笔记数量
public static final String NOTES_COUNT = "notes_count";
/**
* 文件类型：文件夹或笔记，类型: INTEGER
*/
// 文件类型：文件夹或笔记
public static final String TYPE = "type";
/**
* 最后一次同步的ID，类型: INTEGER (long)
*/
// 最后一次同步的ID
public static final String SYNC_ID = "sync_id";
/**
* 标记是否在本地被修改，类型: INTEGER
*/
// 标记是否在本地被修改
public static final String LOCAL_MODIFIED = "local_modified";
/**
* 移动到临时文件夹之前的原始父ID，类型: INTEGER
*/
// 移动到临时文件夹之前的原始父ID
public static final String ORIGIN_PARENT_ID = "origin_parent_id";
/**
* Google Task的ID，类型: TEXT
*/
// Google Task的ID
public static final String GTASK_ID = "gtask_id";
/**
* 版本号，类型: INTEGER (long)
*/
// 版本号
public static final String VERSION = "version";
}
/**
* 数据表的列名接口
/**
* DataColumns 接口 - 便签数据表(data表)列定义
* 定义了便签详细内容的数据表列名和类型
* 使用MIME_TYPE字段区分不同类型的便签数据（文本便签、通话记录等）
*/
public interface DataColumns {
/**
* 行的唯一ID，类型: INTEGER (long)
*/
// 行的唯一ID
public static final String ID = "_id";
/**
* 该行数据项的MIME类型，类型: TEXT
*/
// 该行数据项的MIME类型
public static final String MIME_TYPE = "mime_type";
/**
* 该数据所属笔记的引用ID，类型: INTEGER (long)
*/
// 该数据所属笔记的引用ID
public static final String NOTE_ID = "note_id";
/**
* 笔记或文件夹的创建日期，类型: INTEGER (long)
*/
// 笔记或文件夹的创建日期
public static final String CREATED_DATE = "created_date";
/**
* 最后修改日期，类型: INTEGER (long)
*/
// 最后修改日期
public static final String MODIFIED_DATE = "modified_date";
/**
* 数据内容，类型: TEXT
*/
// 数据内容
public static final String CONTENT = "content";
/**
* 通用数据列1，含义由{@link #MIME_TYPE}决定，用于存储整数类型数据，类型: INTEGER
*/
// 通用数据列1
public static final String DATA1 = "data1";
/**
* 通用数据列2，含义由{@link #MIME_TYPE}决定，用于存储整数类型数据，类型: INTEGER
*/
// 通用数据列2
public static final String DATA2 = "data2";
/**
* 通用数据列3，含义由{@link #MIME_TYPE}决定，用于存储TEXT类型数据，类型: TEXT
*/
// 通用数据列3
public static final String DATA3 = "data3";
/**
* 通用数据列4，含义由{@link #MIME_TYPE}决定，用于存储TEXT类型数据，类型: TEXT
*/
// 通用数据列4
public static final String DATA4 = "data4";
/**
* 通用数据列5，含义由{@link #MIME_TYPE}决定，用于存储TEXT类型数据，类型: TEXT
*/
// 通用数据列5
public static final String DATA5 = "data5";
}
/**
* 文本笔记的数据列定义
* TextNote 类 - 文本便签数据定义
* 定义了文本便签特有的数据列和URI
*/
public static final class TextNote implements DataColumns {
/**
* 模式标识：文本是否为清单模式，类型: Integer（1 清单模式，0 普通模式）
*/
// 模式标识：文本是否为清单模式
public static final String MODE = DATA1;
/** 清单模式常量 */
// 清单模式常量
public static final int MODE_CHECK_LIST = 1;
// 普通模式常量
public static final int MODE_NORMAL = 0;
/** 文本笔记的目录MIME类型 */
// 文本笔记的目录MIME类型
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
/** 文本笔记的单项MIME类型 */
// 文本笔记的单项MIME类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
/** 文本笔记的URI */
// 文本笔记的URI
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
}
/**
* 通话记录笔记的数据列定义
* CallNote 类 - 通话记录便签数据定义
* 定义了通话记录便签特有的数据列和URI
*/
public static final class CallNote implements DataColumns {
/**
* 通话日期，类型: INTEGER (long)
*/
// 通话日期
public static final String CALL_DATE = DATA1;
/**
* 电话号码，类型: TEXT
*/
// 电话号码
public static final String PHONE_NUMBER = DATA3;
/** 通话记录笔记的目录MIME类型 */
// 联系人姓名
public static final String CONTACT_NAME = DATA4;
// 通话记录笔记的目录MIME类型
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
/** 通话记录笔记的单项MIME类型 */
// 通话记录笔记的单项MIME类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
/** 通话记录笔记的URI */
// 通话记录笔记的URI
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
}
}

28
src/Notes-master/src/net/micode/notes/data/NotesProvider.java
Unescape View File

@ -35,30 +35,32 @@ import net.micode.notes.data.Notes.NoteColumns;
import net.micode.notes.data.NotesDatabaseHelper.TABLE;
/**
* 笔记内容提供者。
* <p>职责：对外暴露笔记与数据表的 CRUD、搜索、以及通知能力；封装 URI 匹配和权限检查。</p>
* <p>使用场景：UI、同步服务等通过 ContentResolver 访问笔记内容，统一走此 Provider。</p>
* 笔记内容提供者，继承自 ContentProvider
* 功能：提供笔记数据的增删改查、搜索功能，以及数据变化通知；根据不同的访问地址（URI）找到对应的数据，并检查访问权限。
* 使用场景：UI界面、同步服务等通过 ContentResolver 访问笔记内容，统一走此 Provider。
* ContentResolver：客户端接口，用于访问 ContentProvider 的数据。
* ：客户端与 ContentProvider 之间的桥梁。
*/
public class NotesProvider extends ContentProvider {
private static final UriMatcher mMatcher;
/** 数据库帮助类实例，负责获取读写数据库 */
// 数据库帮助类实例，负责获取读写数据库
private NotesDatabaseHelper mHelper;
private static final String TAG = "NotesProvider";
/** URI匹配码：笔记列表 */
// URI匹配码：笔记列表
private static final int URI_NOTE = 1;
/** URI匹配码：单个笔记 */
// URI匹配码：单个笔记
private static final int URI_NOTE_ITEM = 2;
/** URI匹配码：数据列表 */
// URI匹配码：数据列表
private static final int URI_DATA = 3;
/** URI匹配码：单个数据项 */
// URI匹配码：单个数据项
private static final int URI_DATA_ITEM = 4;
/** URI匹配码：搜索 */
// URI匹配码：搜索
private static final int URI_SEARCH = 5;
/** URI匹配码：搜索建议 */
// URI匹配码：搜索建议
private static final int URI_SEARCH_SUGGEST = 6;
static {
@ -74,7 +76,7 @@ public class NotesProvider extends ContentProvider {
/**
* 笔记搜索投影字段。
* <p>x'0A' 代表 SQLite 中的换行符；搜索时去掉换行与空格，便于列表展示更多内容。</p>
* x'0A' 代表 SQLite 中的换行符；搜索时去掉换行与空格，便于列表展示更多内容。
*/
private static final String NOTES_SEARCH_PROJECTION = NoteColumns.ID + ","
+ NoteColumns.ID + " AS " + SearchManager.SUGGEST_COLUMN_INTENT_EXTRA_DATA + ","
@ -101,7 +103,7 @@ public class NotesProvider extends ContentProvider {
/**
* 查询数据。
* <p>支持 note/data 全表与单行查询，以及搜索入口。</p>
* 支持 note/data 全表与单行查询，以及搜索入口。
*/
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
@ -255,7 +257,7 @@ public class NotesProvider extends ContentProvider {
/**
* 更新数据。
* <p>更新 note 时会先自增 version 字段，便于同步冲突检测；data 更新同样通知 note 列表刷新。</p>
* 更新 note 时会先自增 version 字段，便于同步冲突检测；data 更新同样通知 note 列表刷新。
*/
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {

Write Preview
Loading…
Cancel
Save