android中联系人 以及 ContactsContract类

1.加入读写权限

  1. <uses-permission android:name="android.permission.READ_CONTACTS" />  
  2. <uses-permission android:name="android.permission.WRITE_CONTACTS" />  
 

联系人信息Uri:

content://com.android.contacts/contacts 

 

联系人电话Uri:

content://com.android.contacts/data/phones 

 

联系人Email Uri:

content://com.android.contacts/data/emails 


(推荐)也可以这样获取联系人信息Uri:Uri uri =  ContactsContract.Contacts.CONTENT_URI;



2.查询与添加联系人的操作(单元测试用例)


  1. public class ContactTest extends AndroidTestCase   
  2. {  
  3.     private static final String TAG = "ContactTest";  
  4.       
  5.     /** 
  6.      * 获取通讯录中所有联系人的简单信息 
  7.      * @throws Throwable 
  8.      */  
  9.     public void testGetAllContact() throws Throwable  
  10.     {  
  11.         //获取联系人信息的Uri  
  12.         Uri uri =  ContactsContract.Contacts.CONTENT_URI;  
  13.         //获取ContentResolver  
  14.         ContentResolver contentResolver = this.getContext().getContentResolver();  
  15.         //查询数据,返回Cursor  
  16.         Cursor cursor = contentResolver.query(uri, nullnullnullnull);  
  17.         while(cursor.moveToNext())  
  18.         {  
  19.             StringBuilder sb = new StringBuilder();  
  20.             //获取联系人的ID  
  21.             String contactId = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));    
  22.             //获取联系人的姓名  
  23.             String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));   
  24.             //构造联系人信息  
  25.             sb.append("contactId=").append(contactId).append(",Name=").append(name);  
  26.             //查询电话类型的数据操作  
  27.             Cursor phones = contentResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,    
  28.                     null,    
  29.                     ContactsContract.CommonDataKinds.Phone.CONTACT_ID +" = "+ contactId,    
  30.                     nullnull);    
  31.             while(phones.moveToNext())  
  32.             {  
  33.                 String phoneNumber = phones.getString(phones.getColumnIndex(  
  34.                         ContactsContract.CommonDataKinds.Phone.NUMBER));  
  35.                 //添加Phone的信息  
  36.                 sb.append(",Phone=").append(phoneNumber);  
  37.             }  
  38.             phones.close();  
  39.               
  40.             //查询Email类型的数据操作  
  41.             Cursor emails = contentResolver.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI,    
  42.                        null,    
  43.                        ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = " + contactId,    
  44.                        nullnull);    
  45.             while (emails.moveToNext())   
  46.             {    
  47.                 String emailAddress = emails.getString(emails.getColumnIndex(  
  48.                         ContactsContract.CommonDataKinds.Email.DATA));  
  49.                 //添加Email的信息  
  50.                 sb.append(",Email=").append(emailAddress);  
  51.             }   
  52.             emails.close();  
  53.             Log.i(TAG, sb.toString());  
  54.         }  
  55.         cursor.close();  
  56.     }  
  57.       
  58.     /**添加联系人的第一种方法: 
  59.      * 首先向RawContacts.CONTENT_URI执行一个空值插入,目的是获取系统返回的rawContactId  
  60.      * 这时后面插入data表的依据,只有执行空值插入,才能使插入的联系人在通讯录里面可见 
  61.      */  
  62.     public void testInsert()   
  63.     {  
  64.         ContentValues values = new ContentValues();  
  65.         //首先向RawContacts.CONTENT_URI执行一个空值插入,目的是获取系统返回的rawContactId   
  66.         Uri rawContactUri = this.getContext().getContentResolver().insert(RawContacts.CONTENT_URI, values);  
  67.         //获取id  
  68.         long rawContactId = ContentUris.parseId(rawContactUri);  
  69.         //往data表入姓名数据  
  70.         values.clear();  
  71.         values.put(Data.RAW_CONTACT_ID, rawContactId); //添加id  
  72.         values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);//添加内容类型(MIMETYPE)  
  73.         values.put(StructuredName.GIVEN_NAME, "凯风自南");//添加名字,添加到first name位置  
  74.         this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);  
  75.         //往data表入电话数据  
  76.         values.clear();  
  77.         values.put(Data.RAW_CONTACT_ID, rawContactId);  
  78.         values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);  
  79.         values.put(Phone.NUMBER, "13921009789");  
  80.         values.put(Phone.TYPE, Phone.TYPE_MOBILE);  
  81.         this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);  
  82.         //往data表入Email数据  
  83.         values.clear();  
  84.         values.put(Data.RAW_CONTACT_ID, rawContactId);  
  85.         values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);  
  86.         values.put(Email.DATA, "kesenhoo@gmail.com");  
  87.         values.put(Email.TYPE, Email.TYPE_WORK);  
  88.         this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);  
  89.     }  
  90.       
  91.     /**添加联系人的第二种方法: 
  92.      * 批量添加联系人 
  93.      * @throws Throwable 
  94.      */  
  95.     public void testSave() throws Throwable  
  96.     {  
  97.         //官方文档位置:reference/android/provider/ContactsContract.RawContacts.html  
  98.         //建立一个ArrayList存放批量的参数  
  99.         ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();  
  100.         int rawContactInsertIndex = ops.size();  
  101.         ops.add(ContentProviderOperation.newInsert(RawContacts.CONTENT_URI)  
  102.                 .withValue(RawContacts.ACCOUNT_TYPE, null)  
  103.                 .withValue(RawContacts.ACCOUNT_NAME, null)  
  104.                 .build());  
  105.         //官方文档位置:reference/android/provider/ContactsContract.Data.html  
  106.         //withValueBackReference后退引用前面联系人的id  
  107.         ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)  
  108.                 .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)  
  109.                 .withValue(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE)  
  110.                 .withValue(StructuredName.GIVEN_NAME, "小明")  
  111.                 .build());  
  112.         ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)  
  113.                  .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)  
  114.                  .withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE)  
  115.                  .withValue(Phone.NUMBER, "13671323809")  
  116.                  .withValue(Phone.TYPE, Phone.TYPE_MOBILE)  
  117.                  .withValue(Phone.LABEL, "手机号")  
  118.                  .build());  
  119.         ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)  
  120.                  .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)  
  121.                  .withValue(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE)  
  122.                  .withValue(Email.DATA, "kesen@gmail.com")  
  123.                  .withValue(Email.TYPE, Email.TYPE_WORK)  
  124.                  .build());  
  125.         ContentProviderResult[] results = this.getContext().getContentResolver()  
  126.             .applyBatch(ContactsContract.AUTHORITY, ops);  
  127.         for(ContentProviderResult result : results)  
  128.         {  
  129.             Log.i(TAG, result.uri.toString());  
  130.         }  
  131.     }  

*******************************************************************************************************

这里主要使用的是

ContactsContract类

从Android 2.0 SDK开始有关联系人provider的类变成了ContactsContract,虽然老的android.provider.Contacts能用,但是在SDK中标记为为deprecated将被放弃不推荐的方法,而从Android 2.0及API Level为5开始新增了android.provider.ContactsContract来代替原来的方法。不过Android123表示大家做两手准备,毕竟目前70%的设备以及Ophone 1.0和1.5均不支持ContactsContract。

ContactsContract.Contacts中的所有字段  

2011-01-15 23:52:01|  分类: Android |字号 订阅

ContactsContract.Contacts中的所有字段 - 玄机逸士 - 玄机逸士博客
 
ContactsContract.Contracts实现了4个接口,并从4个接口中,继承了不同的字段,一共有23个如下:

1.    ContactsContract.Contacts.TIMES_CONTACTED ="times_contacted"

The number of times a contact has been contacted

 

2.     ContactsContract.Contacts.CONTACT_STATUS ="contact_status"

Contact's latest status update.

 

3.     ContactsContract.Contacts.CUSTOM_RINGTONE ="custom_ringtone"

URI for a custom ringtone associated with the contact. Ifnull or missing, the default ringtone is used.

 

4.     ContactsContract.Contacts.HAS_PHONE_NUMBER ="has_phone_number"

An indicator of whether this contact has at least one phonenumber. "1" if there is at least one phone number, "0"otherwise.

 

5.     ContactsContract.Contacts.PHONETIC_NAME = "phonetic_name"

Pronunciation of the full name in the phonetic alphabetspecified by PHONETIC_NAME_STYLE.

 

6.     ContactsContract.Contacts.PHONETIC_NAME_STYLE ="phonetic_name_style"

The phonetic alphabet used to represent the PHONETIC_NAME.See PhoneticNameStyle.

 

7.     ContactsContract.Contacts.CONTACT_STATUS_LABEL ="contact_status_label"

The resource ID of the label describing the source ofcontact status, e.g. "Google Talk". This resource is scoped by theCONTACT_STATUS_RES_PACKAGE.

 

8.     ContactsContract.Contacts.LOOKUP_KEY = "lookup"

An opaque value that contains hints on how to find thecontact if its row id changed as a result of a sync or aggregation.

 

9.     ContactsContract.Contacts.CONTACT_STATUS_ICON ="contact_status_icon"

The resource ID of the icon for the source of contactstatus. This resource is scoped by the

CONTACT_STATUS_RES_PACKAGE.

 

10.  ContactsContract.Contacts.LAST_TIME_CONTACTED= "last_time_contacted"

The last time a contact was contacted.

 

11.  ContactsContract.Contacts.DISPLAY_NAME= "display_name"

The display name for the contact.

 

12.  ContactsContract.Contacts.SORT_KEY_ALTERNATIVE= "sort_key_alt"

Sort key based on the alternative representation of thefull name, DISPLAY_NAME_ALTERNATIVE. Thus for Western names, it is the oneusing the "family name first" format.

 

13.  ContactsContract.Contacts.IN_VISIBLE_GROUP= "in_visible_group"

Lookup value that reflects the GROUP_VISIBLE state of anyContactsContract.CommonDataKinds.GroupMembership for this contact.

 

14.  ContactsContract.Contacts._ID= "_id"

The unique ID for a row.

 

15.  ContactsContract.Contacts.STARRED= "starred"

Is the contact starred?

 

16.  ContactsContract.Contacts.SORT_KEY_PRIMARY= "sort_key"

Sort key that takes into account locale-based traditionsfor sorting names in address books.

 

17.  ContactsContract.Contacts.DISPLAY_NAME_ALTERNATIVE= "display_name_alt"

An alternative representation of the display name, such as"family name first" instead of "given name first" forWestern names. If an alternative is not available, the values should be thesame as DISPLAY_NAME_PRIMARY

 

18.  ContactsContract.Contacts.CONTACT_PRESENCE= "contact_presence"

Contact presence status. See ContactsContract.StatusUpdatesfor individual status definitions.

 

19.  ContactsContract.Contacts.DISPLAY_NAME_SOURCE= "display_name_source"

The kind of data that is used as the display name for thecontact, such as structured name or email address. See DisplayNameSources.TODO: convert DisplayNameSources to a link after it is un-hidden

 

20.  ContactsContract.Contacts.CONTACT_STATUS_RES_PACKAGE= "contact_status_res_package"

The package containing resources for this status: label andicon.

 

21.  ContactsContract.Contacts.CONTACT_STATUS_TIMESTAMP= "contact_status_ts"

The absolute time in milliseconds when the latest statuswas inserted/updated.

 

22.  ContactsContract.Contacts.PHOTO_ID= "photo_id"

Reference to the row in the data table holding the photo.

 

23.  ContactsContract.Contacts.SEND_TO_VOICEMAIL= "send_to_voicemail"

Whether the contact should always be sent to voicemail. Ifmissing, defaults to false.


可以用以下方法,列出ContactsContract.Contacts中的所有字段:

    privatevoid listColumnNames()

    {

             private Uri contactUri =ContactsContract.Contacts.CONTENT_URI ;

             ContentResolver resolver = this.getContentResolver();

             Cursor cursor =resolver.query(contactUri, null, null, null, null);

             int columnNumber = cursor.getColumnCount();

             for(int i = 0; i <columnNumber; i++)

             {

                       String temp =cursor.getColumnName(i);

                       Log.e("listColumnNames","" + i + "\t" + temp);

             }

             cursor.close();

    }




评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值