Android通信录数据库操做（转）

时间  2019-11-07
标签 android 通信 数据库 栏目 Android 繁體版
原文   原文链接

能够参考  这个博客 http://www.uml.org.cn/mobiledev/201110121.asp
对contact2.db中的几个比较经常使用的表进行总结：
包括 contacts表，raw_contacts表，data表，phone_lookup表

但愿你们参照源代码：

1. ContactsProvider2.java (实现了ContentProvider)html

2. ContactsContract.java 全部的联系人Uri，与联系人相关数据库字段均在此定义。这里面包含如下要讲的contacts表，raw_contacts表，data表，phone_lookup表的字段及Uri描述。java

Table contactsandroid

_idsql

starred数据库

lookupwindows

photo_id网络

 

 

 

 

1app

0eclipse

 省略ide

<null>

 

 

 

 

2

0

 省略

<null>

 

 

 

 

3

1

 省略

2366

 

 

 

 

 

starred：标识该帐户是否为VIP帐户

lookup： 没具体看，也是一个很是重要的字段

photo_id： 引用data表的 _id，

 

Table raw_contacts

_id

contact_id

account_name

account_type

sync1

 

 

 

1

1

Yulei0619@gmail.com

com.google

http://www.google.com/m8/feeds/contacts/yulei0619@gmail.com/base2_property-android/1ac2a39e89c441cc

 

 

 

2

2

Yulei0619@gmail.com

com.google

 省略

 

 

 

3

3

pcsc

com.htc.android.pcsc

 省略

 

 

 

 

contact_id：引用contacts表的_id字段

account_name：指明该联系人是从哪一个帐户上同步下载下来的。

account_type：邮件账户的类型

sync1：说明该联系人信息是与哪一个网址进行交互（同步联系人信息）

 

Table data.

_id

raw_contact_id

mimetype_id

data1

data2

data15

 

1

1

6

南京用友

南京用友

<null>

 

2

1

5

1-318-296-4252

1

<null>

 

3

2

6

司道鹏

司道鹏

<null>

 

4

2

5

1-516-920-8116

2

<null>

 

5

3

6

子江

子江

<null>

 

6

3

5

1795113734017562

1

<null>

 

7

3

5

+8613734017562

2

<null>

 

2366

3

4

<null>

<null>

‰PNG

 

 

raw_contact_id： 引用  raw_contacts表的_id字段

mimetype_id：

vnd.android.cursor.item/photo -> 4 该行 data15表明照片

vnd.android.cursor.item/phone_v2 -> 5 该行data1表明电话号码

vnd.android.cursor.item/name -> 6说明该行data1表明联系人名称

 

data15： 存储照片 （Type： Blob）

 

 

Table phone_lookup

_id

data_id

raw_contact_id

normalized_number

1

2

1

25246928131

2

4

2

61180296151

3

6

3

2657104373115971

4

7

3

2657104373168+

 

data_id： 引用 data 表的_id字段

raw_contact_id： 引用raw_contacts表的 _id字段

normalized_number：联系人电话号码的倒序排列

 

如何将smsmms.db数据库与contacts2.db数据结合起来成为了很是关键的部分

依据联系人的number，查询该联系人的contact_id

public static String getContactId(Context context, String number) {
        Cursor c = null;
        try {
               c = context.getContentResolver().query(Phone.CONTENT_URI,
              new String[] { Phone.CONTACT_ID, Phone.NUMBER }, null,, null);
               if (c != null && c.moveToFirst()) {
                     while (!c.isAfterLast()) {

                         if (PhoneNumberUtils.compare(number, c.getString(1))) {
                                   return c.getString(0);
                         }
                                c.moveToNext();
                        }
                     }
              } catch (Exception e) {
                     Log.e(TAG, "getContactId error:", e);
              } finally {
                     if (c != null) {c.close();
                     }
              }
              return null;
       }

Phone.CONTENT_URI, = “content:// com.android.contacts/data/phones”

经过查看源代码发现：该URI主要对应着contacts表，raw_contacts表，data表。这段源码对于刚了解该contact2数据库的人说比较费劲，

“qb.setProjectionMap(distinct ? sDistinctDataProjectionMap : sDataProjectionMap);”是很是重要的线索，它告诉咱们会查询哪些字段

 

在这里尤为须要说明的是：PhoneNumberUtils.compare(String a, String b) 方法

加入咱们在手机中把“13466739143”存储为联系人“张三”（存储的联系手机号仅仅是13466739143），若是张三使用飞信给你发短信（咱们知道用飞信，电话号码前会自动加12593），用户确定但愿在手机上的未接短信来自张三，而不是有“1259313466739143”被看成一个陌生号码出现

如何将“1259313466739143”和“13466739143”以及可能的“1795113466739143”，“+8613466739143”等等认为是同一个电话号码，这里的PhoneNumberUtils.compare(String a, String b)就起到了很是关键的做用。

  

有了contact_id以后，咱们就能够作不少事情。

1．依据contact_id，去查询该联系人的照片：

  

public static Bitmap getContactsPhoto(Context context, String contactId) {
        Cursor c = null;
        // load icon
        byte[] icon = null;
           try {
                  // get contact photo URI
                  Uri refUri = Uri.withAppendedPath(Contacts.CONTENT_URI, contactId);
                  refUri = Uri.withAppendedPath(refUri,
                  ContactsContract.Contacts.Photo.CONTENT_DIRECTORY);
                  // get cursor
                  c = context.getContentResolver().query(refUri,
                                   new String[] { Photo.PHOTO }, null, null, null);
                 if (c != null && c.moveToFirst()) {
         icon = c.getBlob(0);
                 }
              } catch (Exception e) {
                     e.printStackTrace();
              } finally {
                     if (c != null) {  c.close(); }
                }
              if (icon != null) {
                 try {
                         return BitmapFactory.decodeByteArray(icon, 0, icon.length);
                    } catch (OutOfMemoryError e) {
                            e.printStackTrace();
                            System.gc();
                            return null;
                   }
              }
              return null;
       }

2. 依据该联系人的contact_id, 去查询该联系人的名字(好比“张三”)

      

private static String getDisplayName(Context context, String contacts_id) {
              Cursor c = null;
              try {
                    c = context.getContentResolver().query(Contacts.CONTENT_URI,
                                  new String[] { Contacts.DISPLAY_NAME },
                                   Contacts._ID + "=" + contacts_id, null, null);
                     if (c != null && c.moveToFirst()) {
                            return c.getString(0);
                     }
              } catch (Exception e) {
                     e.printStackTrace();
              } finally {
                     if (c != null) {  c.close(); }
              }
              return null;
       }

3. 依据该联系人的contact_id ，查询同一个contact_id有多少个电话号码。

  （有可能手机上存了张三2个号码）

public static int getContactNumberCount(Context context, String contactId) {
        int count = 0;
        Cursor c = null;
        try {
             c = context.getContentResolver().query(                                                          ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                       new String[] { ContactsContract.CommonDataKinds.Phone.NUMBER},                                                     ContactsContract.CommonDataKinds.Phone.CONTACT_ID  + " = " + contactId, null, null);                                             
                     if (c != null && c.moveToFirst()) {
                            count = c.getCount();
                    }
              } catch (Exception e) {
                    e.printStackTrace();
              } finally {
                     if (c != null) {  c.close(); }
             }
              return count;
       }

------------------------------------------------------------------------------

若是须要读取一个联系人的信息用CONTENT_LOOKUP_RUI代替CONTENT_URI

若是须要经过电话号码查找一个联系人，用PhoneLookup.CONTENT_FIILTER_URI，这个URI为这个目的进行了优化；

若是须要经过部分名字的匹配查找，用CONTENT_FILTER_URI；

Android中的通讯录操做给人的第一感受就是晕，不知道怎么去用。能够看下这张我画的图：（比较丑，可是地球人都能看懂）

data1.png
这幅图的意思是： 操做通讯录本质是去操做合适的ContentProvider，经过合适的ContentProvider去操做通信录 。

1： 要想熟练的操做合适的ContentProvider，就必需要掌握一个类ContactsContract（2.0开始使用）。

如今能够思考一个新问题： Android中的联系人信息是如何存储的？
Android中的联系人信息都是存储在一个叫contacts2.db的数据库中。数据库的路径是：/data/data/com.android.provider.contacts/databases/contacts2.db（在这里推荐一个sqlite的查看工具： http://www.sqliteexpert.com/  我的版是免费的）

继续思考一个新问题： 这个数据库是如何来存储联系人信息的？
根据官方的文档：通讯录是一个3层的数据存储模型（初看挺牛的，说穿了就是3张表）
我又画了一张图比较形象的反应这个“3层模型”。
data.png
第一层：Data层，每种独立的数据类型占一行。具体哪些独立的数据能够占一行，能够在mimetypes这张表中找到， 原生Android的系统 一共12种，例如name,phone,email ect..
第二层：RawContracts层，由Data层的多条数据组合成一个完整的联系人信息。
第三层：Contracts层，这一层主要注意与第二层的区别。大部分状况下这两层的数据时指同一个联系人的信息，即他们俩是一一对应的关系，可是有些特殊状况，这个我是查了一些老外的论坛加上本身的理解，例如 我作一个本地通讯录和网络上的通讯录同步的时候，可能有一我的他在本地存在，他在网络上也存在，这个时候Android就能够识别他们，认为他们两个实际上是指同一我的。 （这种状况我没有试出来，我感受这个实际上是Android创造了这个概念以后，留给咱们开发本身去实现的。）


上面说过“要想熟练的操做合适的ContentProvider，就必需要掌握一个类ContactsContract”，
那么这个ContactsContract类是干什么的呢 ？
说穿了这个类就是去解释和翻译这个contacts2.db数据库的。 
这个类超大6000+行代码， 可是确没有什么操做代码，几乎都是来解释contacts2.db数据库的。
这个类中有不少的内部接口和内部类，用来翻译一些表。 例如Data内部类，RawContacts内部类，等等。

下面我以一个实际的例子讲解一下操做过程：
问题： 我有一个电话号码，如今想去查找这个电话号码主人的姓名。
第一步：我要肯定用哪个ContentProvider去查询，这个时候确定想到去用含有电话号码的ContentProvider去查询电话号码所在的Contacts_ID.
第二部：经过Contacts_ID找到对应的Raw_Contacts_ID.
第三部：经过Raw_Contacts_ID找到对应的联系人姓名.

肯定了操做步骤以后，确定是去看文档了，谁也不能猜出来含有电话号码ContentProvider_URI.

经过查询文档： If you need to look up a contact by the phone number, usePhoneLookup.CONTENT_FILTER_URI, which is optimized for this purpose.

咱们肯定了URI以后就能够开始编写代码了。


public String lookupNameByPhoneNumber(Context context,String phoneNumber) {
Uri uri = Uri.withAppendedPath(ContactsContract.PhoneLookup.CONTENT_FILTER_URI, Uri.encode(phoneNumber));
    Cursor cursor = context.getContentResolver().query(uri,
            new String[] {ContactsContract.PhoneLookup.DISPLAY_NAME}, null, null, null);
    String name = null;
    if (cursor == null) {    
    name = null;
    }
    try {
       if (cursor.moveToFirst()) {
           name = cursor.getColumnName(0);
       }
    } finally {
       cursor.close();
    }
    return name;
}

看完这段代码，你可能想去问，第二步跟第三步跑哪里去了。这两步其实已经被封装在Resoler的query方法中了。若是真要咱们编写这两部的话，那咱们还不如不用ContentProvider来的轻松。

最后再来讲下真机上的通讯录模型，真机上的通讯录其实就是原生通讯录的扩展。增长一些东西。

最重要的一点，原生数据库里有的表，表字段，触发器，视图或索引，在真机上确定也有。
若是想本身作一个通讯录，也确定要在原生的通讯录上扩展，只能增长，不能减小。
想问为何？
若是你少两张表的话，可能一些系统功能就崩溃了。

这就不符合google的目的了，我提供了一些功能，你可使用修改，可是你别删除，因此google火了。

添加一条数据

ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();        ops.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
                .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType())
                .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName())
                .build());        ops.add(ContentProviderOperation 
               .newInsert(ContactsContract.Data.CONTENT_URI)
                .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
                .withValue(ContactsContract.Data.MIMETYPE,
                        ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
                .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, name)
                .build());        ops.add(ContentProviderOperation
                .newInsert(ContactsContract.Data.CONTENT_URI)
                .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
                .withValue(ContactsContract.Data.MIMETYPE,
                        ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
                .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phone)
                .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, phoneType).build());
        ops.add(ContentProviderOperation
                .newInsert(ContactsContract.Data.CONTENT_URI)
                .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
                .withValue(ContactsContract.Data.MIMETYPE,
                        ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE)
                .withValue(ContactsContract.CommonDataKinds.Email.DATA, email) 
               .withValue(ContactsContract.CommonDataKinds.Email.TYPE, emailType).build());
        // Ask the Contact provider to create a new contact        Log.i(TAG,
                "Selected account: " + mSelectedAccount.getName() + " ("
                        + mSelectedAccount.getType() + ")");
        Log.i(TAG, "Creating contact: " + name);
        try {
            getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);
        } catch (Exception e) {
            // Display warning
        }

 

 

---------------------------------------------------------

Android系统中的联系人也是经过ContentProvider来对外提供数据的,咱们这里实现获取全部联系人、经过电话号码获取联系人、添加联系人、使用事务添加联系人。

获取全部联系人

1.   Android系统中的联系人也是经过ContentProvider来对外提供数据的

2.   数据库路径为：/data/data/com.android.providers.contacts/database/contacts2.db

3.   咱们须要关注的有3张表

     raw_contacts：其中保存了联系人id

     data：和raw_contacts是多对一的关系，保存了联系人的各项数据

     mimetypes：为数据类型

4.   Provider的authorites为com.android.contacts

5.   查询raw_contacts表的路径为：contacts

6.   查询data表的路径为：contacts/#/data

     这个路径为链接查询，要查询“mimetype”字段能够根据“mimetype_id”查询到mimetypes表中的数据

7.   先查询raw_contacts获得每一个联系人的id，在使用id从data表中查询对应数据，根据mimetype分类数据

示例：

//查询全部联系人  
public void testGetAll() {  
    ContentResolver resolver = getContext().getContentResolver();  
    Uri uri = Uri.parse("content://com.android.contacts/contacts");  
    Cursor idCursor = resolver.query(uri, new String[] { "_id" }, null, null, null);  
    while (idCursor.moveToNext()) {  
        //获取到raw_contacts表中的id  
        int id = idCursor.getInt(0);   
        //根据获取到的ID查询data表中的数据  
        uri = Uri.parse("content://com.android.contacts/contacts/" + id + "/data");  
        Cursor dataCursor = resolver.query(uri, new String[] { "data1", "mimetype" }, null, null, null);  
        StringBuilder sb = new StringBuilder();  
        sb.append("id=" + id);  
        //查询联系人表中的  
        while (dataCursor.moveToNext()) {  
            String data = dataCursor.getString(0);  
            String type = dataCursor.getString(1);  
            if ("vnd.android.cursor.item/name".equals(type))  
                sb.append(", name=" + data);  
            else if ("vnd.android.cursor.item/phone_v2".equals(type))  
                sb.append(", phone=" + data);  
            else if ("vnd.android.cursor.item/email_v2".equals(type))  
                sb.append(", email=" + data);  
        }  
        System.out.println(sb);  
    }  
}


经过电话号码获取联系人

1.   系统内部提供了根据电话号码获取data表数据的功能，路径为：data/phones/filter/*

2.   用电话号码替换“*”部分就能够查到所需数据，获取“display_name”能够获取到联系人显示名

示例：

//根据电话号码查询联系人名称  
public void testGetName() {  
    ContentResolver resolver = getContext().getContentResolver();  
    Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/1111");  
    Cursor c = resolver.query(uri, new String[] { "display_name" }, null, null, null);  
    while (c.moveToNext()) {  
        System.out.println(c.getString(0));  
    }  
}


添加联系人

1.   先向raw_contacts表插入id，路径为：raw_contacts

2.   获得id以后再向data表插入数据，路径为：data

示例：

//添加联系人  
ublic void testInsert() {  
ContentResolver resolver = getContext().getContentResolver();  
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");  
ContentValues values = new ContentValues();  
// 向raw_contacts插入一条除了ID以外, 其余所有为NULL的记录, ID是自动生成的  
long id = ContentUris.parseId(resolver.insert(uri, values));   
//添加联系人姓名  
uri = Uri.parse("content://com.android.contacts/data");  
values.put("raw_contact_id", id);  
values.put("data2", "FHM");  
values.put("mimetype", "vnd.android.cursor.item/name");  
resolver.insert(uri, values);  
                //添加联系人电话  
values.clear(); // 清空上次的数据  
values.put("raw_contact_id", id);  
values.put("data1", "18600000000");  
values.put("data2", "2");  
values.put("mimetype", "vnd.android.cursor.item/phone_v2");  
resolver.insert(uri, values);  
//添加联系人邮箱  
values.clear();  
values.put("raw_contact_id", id);  
values.put("data1", "zxx@itcast.cn");  
values.put("data2", "1");  
values.put("mimetype", "vnd.android.cursor.item/email_v2");  
resolver.insert(uri, values);


使用事务添加联系人

1.   在添加联系人得时候是分屡次访问Provider，若是在过程当中出现异常，会出现数据不完整的状况，这些操做应该放在一次事务中

2.   使用ContentResolver的applyBatch(String authority,ArrayList<ContentProviderOperation> operations) 方法能够将多个操做在一个事务中执行

3.   文档位置:

      file:///F:/android-sdk-windows/docs/reference/android/provider/ContactsContract.RawContacts.html

示例：

//使用事务添加联系人  
public void testInsertBatch() throws Exception {  
    ContentResolver resolver = getContext().getContentResolver();  
  
    ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>();  
  
    ContentProviderOperation operation1 = ContentProviderOperation //  
            .newInsert(Uri.parse("content://com.android.contacts/raw_contacts")) //  
            .withValue("_id", null) //  
            .build();  
    operations.add(operation1);  
  
    ContentProviderOperation operation2 = ContentProviderOperation //  
            .newInsert(Uri.parse("content://com.android.contacts/data")) //  
            .withValueBackReference("raw_contact_id", 0) //  
            .withValue("data2", "ZZH") //  
            .withValue("mimetype", "vnd.android.cursor.item/name") //  
            .build();  
    operations.add(operation2);  
      
    ContentProviderOperation operation3 = ContentProviderOperation //  
            .newInsert(Uri.parse("content://com.android.contacts/data")) //  
            .withValueBackReference("raw_contact_id", 0) //  
            .withValue("data1", "18612312312") //  
            .withValue("data2", "2") //  
            .withValue("mimetype", "vnd.android.cursor.item/phone_v2") //  
            .build();  
    operations.add(operation3);  
  
    ContentProviderOperation operation4 = ContentProviderOperation //  
            .newInsert(Uri.parse("content://com.android.contacts/data")) //  
            .withValueBackReference("raw_contact_id", 0) //  
            .withValue("data1", "zq@itcast.cn") //  
            .withValue("data2", "2") //  
            .withValue("mimetype", "vnd.android.cursor.item/email_v2") //  
            .build();  
    operations.add(operation4);  
  
    // 在事务中对多个操做批量执行  
    resolver.applyBatch("com.android.contacts", operations);  
}
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程