pecvhqap2
/
pyx_gitpractice
1
0
Fork 1
Code Issues Pull Requests Packages Projects Releases Wiki Activity

main文件前两个文件代码注释

Browse Source
pull/7/head
19972076849 2 months ago
parent 2af58d2bcf
commit 70c0226fef
2 changed files with 154 additions and 85 deletions
Show Stats Download Patch File Download Diff File

46
src/Notesmaster/app/src/main/java/net/micode/notes/data/Contact.java
Unescape View File

@ -25,49 +25,79 @@ import android.util.Log;
import java.util.HashMap;
/**
* 该类用于从设备联系人中根据电话号码获取联系人姓名，使用缓存机制提高性能。
*/
public class Contact {
// 静态的联系人缓存，用于存储已经查询过的电话号码及其对应的联系人姓名
private static HashMap<String, String> sContactCache;
// 日志标签，用于在日志中标识该类的日志信息
private static final String TAG = "Contact";
// 查询联系人的 SQL 选择语句模板
private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
+ ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+ " AND " + Data.RAW_CONTACT_ID + " IN "
+ ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+ " AND " + Data.RAW_CONTACT_ID + " IN "
+ "(SELECT raw_contact_id "
+ " FROM phone_lookup"
+ " WHERE min_match = '+')";
/**
* 根据电话号码从设备联系人中获取联系人姓名。
* 如果联系人姓名已经在缓存中，则直接从缓存中获取；
* 否则，执行数据库查询，并将结果存入缓存。
*
* @param context 应用程序上下文，用于访问内容解析器
* @param phoneNumber 要查询的电话号码
* @return 联系人姓名，如果未找到匹配的联系人则返回 null
*/
public static String getContact(Context context, String phoneNumber) {
// 如果联系人缓存还未初始化，则创建一个新的 HashMap 用于存储缓存信息
if(sContactCache == null) {
sContactCache = new HashMap<String, String>();
}
// 检查缓存中是否已经存在该电话号码对应的联系人姓名
if(sContactCache.containsKey(phoneNumber)) {
// 如果存在，则直接从缓存中返回联系人姓名
return sContactCache.get(phoneNumber);
}
// 将查询模板中的占位符 "+" 替换为电话号码的最小匹配格式
String selection = CALLER_ID_SELECTION.replace("+",
PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
// 使用内容解析器查询联系人数据库
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.e(TAG, " Cursor get string error " + e.toString());
// 返回 null 表示未找到联系人姓名
return null;
} finally {
// 无论查询结果如何，最后都要关闭游标以释放资源
cursor.close();
}
} else {
// 如果查询结果为空，记录日志表示未找到匹配的联系人
Log.d(TAG, "No contact matched with number:" + phoneNumber);
// 返回 null 表示未找到联系人姓名
return null;
}
}
}
}

193
src/Notesmaster/app/src/main/java/net/micode/notes/data/Notes.java
Unescape View File

@ -17,263 +17,302 @@
package net.micode.notes.data;
import android.net.Uri;
/**
* 该类定义了笔记应用中使用的常量，包括笔记和文件夹的类型、系统文件夹的ID、
* 意图额外数据的键名、内容URI以及数据库表的列名等。
*/
public class Notes {
// 内容提供者的授权信息，用于标识笔记应用的内容提供者
public static final String AUTHORITY = "micode_notes";
// 日志标签，用于在日志中标识该类的相关信息
public static final String TAG = "Notes";
// 笔记类型的常量值
public static final int TYPE_NOTE = 0;
// 文件夹类型的常量值
public static final int TYPE_FOLDER = 1;
// 系统类型的常量值
public static final int TYPE_SYSTEM = 2;
/**
* Following IDs are system folders' identifiers
* {@link Notes#ID_ROOT_FOLDER } is default folder
* {@link Notes#ID_TEMPARAY_FOLDER } is for notes belonging no folder
* {@link Notes#ID_CALL_RECORD_FOLDER} is to store call records
* 以下ID是系统文件夹的标识符
* {@link Notes#ID_ROOT_FOLDER } 是默认文件夹
* {@link Notes#ID_TEMPARAY_FOLDER } 用于存放不属于任何文件夹的笔记
* {@link Notes#ID_CALL_RECORD_FOLDER} 用于存储通话记录
*/
// 根文件夹的ID，作为默认文件夹
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;
// 意图中传递提醒日期的额外数据键名
public static final String INTENT_EXTRA_ALERT_DATE = "net.micode.notes.alert_date";
// 意图中传递笔记背景颜色ID的额外数据键名
public static final String INTENT_EXTRA_BACKGROUND_ID = "net.micode.notes.background_color_id";
// 意图中传递小部件ID的额外数据键名
public static final String INTENT_EXTRA_WIDGET_ID = "net.micode.notes.widget_id";
// 意图中传递小部件类型的额外数据键名
public static final String INTENT_EXTRA_WIDGET_TYPE = "net.micode.notes.widget_type";
// 意图中传递文件夹ID的额外数据键名
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";
// 无效小部件类型的常量值
public static final int TYPE_WIDGET_INVALIDE = -1;
// 2x尺寸小部件类型的常量值
public static final int TYPE_WIDGET_2X = 0;
// 4x尺寸小部件类型的常量值
public static final int TYPE_WIDGET_4X = 1;
/**
* 该静态内部类定义了数据相关的常量，主要是不同类型笔记的内容项类型。
*/
public static class DataConstants {
// 文本笔记的内容项类型
public static final String NOTE = TextNote.CONTENT_ITEM_TYPE;
// 通话笔记的内容项类型
public static final String CALL_NOTE = CallNote.CONTENT_ITEM_TYPE;
}
/**
* Uri to query all notes and folders
* 用于查询所有笔记和文件夹的内容URI
*/
public static final Uri CONTENT_NOTE_URI = Uri.parse("content://" + AUTHORITY + "/note");
/**
* Uri to query data
* 用于查询数据的内容URI
*/
public static final Uri CONTENT_DATA_URI = Uri.parse("content://" + AUTHORITY + "/data");
/**
* 该接口定义了笔记表的列名常量。
*/
public interface NoteColumns {
/**
* The unique ID for a row
* <P> Type: INTEGER (long) </P>
* 行的唯一ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String ID = "_id";
/**
* The parent's id for note or folder
* <P> Type: INTEGER (long) </P>
* 笔记或文件夹的父ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String PARENT_ID = "parent_id";
/**
* Created data for note or folder
* <P> Type: INTEGER (long) </P>
* 笔记或文件夹的创建日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String CREATED_DATE = "created_date";
/**
* Latest modified date
* <P> Type: INTEGER (long) </P>
* 最新修改日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String MODIFIED_DATE = "modified_date";
/**
* Alert date
* <P> Type: INTEGER (long) </P>
* 提醒日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String ALERTED_DATE = "alert_date";
/**
* Folder's name or text content of note
* <P> Type: TEXT </P>
* 文件夹名称或笔记的文本内容
* <P> 类型: TEXT </P>
*/
public static final String SNIPPET = "snippet";
/**
* Note's widget id
* <P> Type: INTEGER (long) </P>
* 笔记的小部件ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String WIDGET_ID = "widget_id";
/**
* Note's widget type
* <P> Type: INTEGER (long) </P>
* 笔记的小部件类型
* <P> 类型: INTEGER (long) </P>
*/
public static final String WIDGET_TYPE = "widget_type";
/**
* Note's background color's id
* <P> Type: INTEGER (long) </P>
* 笔记的背景颜色ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String BG_COLOR_ID = "bg_color_id";
/**
* For text note, it doesn't has attachment, for multi-media
* note, it has at least one attachment
* <P> Type: INTEGER </P>
* 对于文本笔记，没有附件；对于多媒体笔记，至少有一个附件
* <P> 类型: INTEGER </P>
*/
public static final String HAS_ATTACHMENT = "has_attachment";
/**
* Folder's count of notes
* <P> Type: INTEGER (long) </P>
* 文件夹中笔记的数量
* <P> 类型: INTEGER (long) </P>
*/
public static final String NOTES_COUNT = "notes_count";
/**
* The file type: folder or note
* <P> Type: INTEGER </P>
* 文件类型：文件夹或笔记
* <P> 类型: INTEGER </P>
*/
public static final String TYPE = "type";
/**
* The last sync id
* <P> Type: INTEGER (long) </P>
* 最后同步的ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String SYNC_ID = "sync_id";
/**
* Sign to indicate local modified or not
* <P> Type: INTEGER </P>
* 标记本地是否有修改
* <P> 类型: INTEGER </P>
*/
public static final String LOCAL_MODIFIED = "local_modified";
/**
* Original parent id before moving into temporary folder
* <P> Type : INTEGER </P>
* 移动到临时文件夹之前的原始父ID
* <P> 类型 : INTEGER </P>
*/
public static final String ORIGIN_PARENT_ID = "origin_parent_id";
/**
* The gtask id
* <P> Type : TEXT </P>
* Google任务的ID
* <P> 类型 : TEXT </P>
*/
public static final String GTASK_ID = "gtask_id";
/**
* The version code
* <P> Type : INTEGER (long) </P>
* 版本号
* <P> 类型 : INTEGER (long) </P>
*/
public static final String VERSION = "version";
}
/**
* 该接口定义了数据表的列名常量。
*/
public interface DataColumns {
/**
* The unique ID for a row
* <P> Type: INTEGER (long) </P>
* 行的唯一ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String ID = "_id";
/**
* The MIME type of the item represented by this row.
* <P> Type: Text </P>
* 该行所代表项目的MIME类型
* <P> 类型: Text </P>
*/
public static final String MIME_TYPE = "mime_type";
/**
* The reference id to note that this data belongs to
* <P> Type: INTEGER (long) </P>
* 该数据所属笔记的引用ID
* <P> 类型: INTEGER (long) </P>
*/
public static final String NOTE_ID = "note_id";
/**
* Created data for note or folder
* <P> Type: INTEGER (long) </P>
* 笔记或文件夹的创建日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String CREATED_DATE = "created_date";
/**
* Latest modified date
* <P> Type: INTEGER (long) </P>
* 最新修改日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String MODIFIED_DATE = "modified_date";
/**
* Data's content
* <P> Type: TEXT </P>
* 数据的内容
* <P> 类型: TEXT </P>
*/
public static final String CONTENT = "content";
/**
* Generic data column, the meaning is {@link #MIMETYPE} specific, used for
* integer data type
* <P> Type: INTEGER </P>
* 通用数据列，其含义与 {@link #MIMETYPE} 相关，用于整数类型的数据
* <P> 类型: INTEGER </P>
*/
public static final String DATA1 = "data1";
/**
* Generic data column, the meaning is {@link #MIMETYPE} specific, used for
* integer data type
* <P> Type: INTEGER </P>
* 通用数据列，其含义与 {@link #MIMETYPE} 相关，用于整数类型的数据
* <P> 类型: INTEGER </P>
*/
public static final String DATA2 = "data2";
/**
* Generic data column, the meaning is {@link #MIMETYPE} specific, used for
* TEXT data type
* <P> Type: TEXT </P>
* 通用数据列，其含义与 {@link #MIMETYPE} 相关，用于文本类型的数据
* <P> 类型: TEXT </P>
*/
public static final String DATA3 = "data3";
/**
* Generic data column, the meaning is {@link #MIMETYPE} specific, used for
* TEXT data type
* <P> Type: TEXT </P>
* 通用数据列，其含义与 {@link #MIMETYPE} 相关，用于文本类型的数据
* <P> 类型: TEXT </P>
*/
public static final String DATA4 = "data4";
/**
* Generic data column, the meaning is {@link #MIMETYPE} specific, used for
* TEXT data type
* <P> Type: TEXT </P>
* 通用数据列，其含义与 {@link #MIMETYPE} 相关，用于文本类型的数据
* <P> 类型: TEXT </P>
*/
public static final String DATA5 = "data5";
}
/**
* 该静态内部类定义了文本笔记的相关常量。
*/
public static final class TextNote implements DataColumns {
/**
* Mode to indicate the text in check list mode or not
* <P> Type: Integer 1:check list mode 0: normal mode </P>
* 模式，用于指示文本是否处于复选列表模式
* <P> 类型: Integer 1: 复选列表模式 0: 正常模式 </P>
*/
public static final String MODE = DATA1;
// 复选列表模式的常量值
public static final int MODE_CHECK_LIST = 1;
// 文本笔记的内容类型
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/text_note";
// 文本笔记的内容项类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/text_note";
// 用于查询文本笔记的内容URI
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/text_note");
}
/**
* 该静态内部类定义了通话笔记的相关常量。
*/
public static final class CallNote implements DataColumns {
/**
* Call date for this record
* <P> Type: INTEGER (long) </P>
* 该记录的通话日期
* <P> 类型: INTEGER (long) </P>
*/
public static final String CALL_DATE = DATA1;
/**
* Phone number for this record
* <P> Type: TEXT </P>
* 该记录的电话号码
* <P> 类型: TEXT </P>
*/
public static final String PHONE_NUMBER = DATA3;
// 通话笔记的内容类型
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/call_note";
// 通话笔记的内容项类型
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/call_note";
// 用于查询通话笔记的内容URI
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/call_note");
}
}
}
Write Preview
Loading…
Cancel
Save