2

Notes-master/src/net/micode/notes/data/Contact.java

@@ -14,40 +14,41 @@
  * limitations under the License.
  */
 
-package net.micode.notes.data;
-
+package net.micode.notes.data;//表示这是在net.micode.notes中data包里面
+//导入android框架中的一些类，便于数据库的管理更新等
 import android.content.Context;
 import android.database.Cursor;
 import android.provider.ContactsContract.CommonDataKinds.Phone;
 import android.provider.ContactsContract.Data;
 import android.telephony.PhoneNumberUtils;
 import android.util.Log;
-
+//导入了标准 Java 库中的 HashMap 类。HashMap 是 Java 中的一个基本数据结构，用于存储键值对。它实现了 Map 接口，允许存储键值对，并提供了快速的数据访问方法
 import java.util.HashMap;
-
+//联系人
 public class Contact {
-    private static HashMap<String, String> sContactCache;
-    private static final String TAG = "Contact";
+    private static HashMap<String, String> sContactCache;//HashMap 通常被用来临时缓存联系人信息
+    //String 是键的类型，表示联系人的标识符或者其他唯一值。String 是值的类型，表示与联系人相关联的信息或数据。
+    private static final String TAG = "Contact";//private static final String定义的是一个类内部的、只能在当前类中访问、不可变的静态字符串常量
 
-    private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER
-    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"
+    private static final String CALLER_ID_SELECTION = "PHONE_NUMBERS_EQUAL(" + Phone.NUMBER  //比较电话号码是否相等，Phone.NUMBER 是电话号码字段名
+    + ",?) AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'"//and逻辑与操作符，用于连接条件
     + " AND " + Data.RAW_CONTACT_ID + " IN "
             + "(SELECT raw_contact_id "
             + " FROM phone_lookup"
-            + " WHERE min_match = '+')";
-
+            + " WHERE min_match = '+')";//查询匹配给定电话号码的联系人信息
+    // 获取联系人
     public static String getContact(Context context, String phoneNumber) {
         if(sContactCache == null) {
             sContactCache = new HashMap<String, String>();
-        }
+        }//如sContactCache是空的就创建一个
 
-        if(sContactCache.containsKey(phoneNumber)) {
-            return sContactCache.get(phoneNumber);
+        if(sContactCache.containsKey(phoneNumber)) {//查找sContactCache中是否有phoneNumber的信息
+            return sContactCache.get(phoneNumber);//如果有就返回如果没有就不管
         }
 
         String selection = CALLER_ID_SELECTION.replace("+",
                 PhoneNumberUtils.toCallerIDMinMatch(phoneNumber));
-        Cursor cursor = context.getContentResolver().query(
+        Cursor cursor = context.getContentResolver().query( // 查找数据库中phoneNumber的信息
                 Data.CONTENT_URI,
                 new String [] { Phone.DISPLAY_NAME },
                 selection,