android中联系人以及ContactsContract类
1.加入读写权限
1.
2.
联系人信息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.public void testGetAllContact() throws Throwable
5.{
6.//获取联系人信息的Uri
7.Uri uri = ContactsContract.Contacts.CONTENT_URI;
8.//获取ContentResolver
9.ContentResolver contentResolver = this.getContext().getContentResolver();
10.//查询数据,返回Cursor
11.Cursor cursor = contentResolver.query(uri, null, null, null, null);
12.while(cursor.moveToNext())
13.{
14.StringBuilder sb = new StringBuilder();
15.//获取联系人的ID
16.String contactId =
cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));
17.//获取联系人的姓名
18.String name =
cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
19.//构造联系人信息
20.sb.append("contactId=").append(contactId).append(",Name=").append(name);
21.//查询电话类型的数据操作
22.Cursor phones =
contentResolver.query(https://www.360docs.net/doc/a92375727.html,monDataKinds.Phone.CONTENT_URI,
23.null,
https://www.360docs.net/doc/a92375727.html,monDataKinds.Phone.CONTACT_ID +" = "+ contactId,
25.null, null);
26.while(phones.moveToNext())
27.{
28.String phoneNumber = phones.getString(phones.getColumnIndex(
https://www.360docs.net/doc/a92375727.html,monDataKinds.Phone.NUMBER));
30.//添加Phone的信息
31.sb.append(",Phone=").append(phoneNumber);
32.}
33.phones.close();
34.//查询Email类型的数据操作
35.Cursor emails =
contentResolver.query(https://www.360docs.net/doc/a92375727.html,monDataKinds.Email.CONTENT_URI,
36.null,
https://www.360docs.net/doc/a92375727.html,monDataKinds.Email.CONTACT_ID + " = " + contactId,
38.null, null);
39.while (emails.moveToNext())
40.{
41.String emailAddress = emails.getString(emails.getColumnIndex(
https://www.360docs.net/doc/a92375727.html,monDataKinds.Email.DATA));
43.//添加Email的信息
44.sb.append(",Email=").append(emailAddress);
45.}
46.emails.close();
47.Log.i(TAG, sb.toString());
48.}
49.cursor.close();
50.}
51.public void testInsert()
52.{
53.ContentValues values = new ContentValues();
54.//首先向RawContacts.CONTENT_URI执行一个空值插入,目的是获取系统返回的
rawContactId
55.Uri rawContactUri
=this.getContext().getContentResolver().insert(RawContacts.CONTENT_URI, values);
56.//获取id
57.long rawContactId = ContentUris.parseId(rawContactUri);
58.//往data表入姓名数据
59.values.clear();
60.values.put(Data.RAW_CONTACT_ID, rawContactId); //添加id
61.values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);//添加内容类
型(MIMETYPE)
62.values.put(StructuredName.GIVEN_NAME, "凯风自南");//添加名字,添加到first name
位置
63.this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CO
NTENT_URI, values);
64.//往data表入电话数据
65.values.clear();
66.values.put(Data.RAW_CONTACT_ID, rawContactId);
67.values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
68.values.put(Phone.NUMBER, "139********");
69.values.put(Phone.TYPE, Phone.TYPE_MOBILE);
70.this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CO
NTENT_URI, values);
71.//往data表入Email数据
72.values.clear();
73.values.put(Data.RAW_CONTACT_ID, rawContactId);
74.values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
75.values.put(Email.DATA, "kesenhoo@https://www.360docs.net/doc/a92375727.html,");
76.values.put(Email.TYPE, Email.TYPE_WORK);
77.this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CO
NTENT_URI, values);
78.}
79.public void testSave() throws Throwable
80.{
81.//官方文档位置:reference/android/provider/ContactsContract.RawContacts.html
82.//建立一个ArrayList存放批量的参数
83.ArrayList
= new ArrayList
84.int rawContactInsertIndex = ops.size();
85.ops.add(ContentProviderOperation.newInsert(RawContacts.CONTENT_URI)
86..withValue(RawContacts.ACCOUNT_TYPE, null)
87..withValue(RawContacts.ACCOUNT_NAME, null)
88..build());
89.//官方文档位置:reference/android/provider/ContactsContract.Data.html
90.//withValueBackReference后退引用前面联系人的id
91.ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.C
ONTENT_URI)
92..withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
93..withValue(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE)
94..withValue(StructuredName.GIVEN_NAME, "小明")
95..build());
96.ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.C
ONTENT_URI)
97..withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
98..withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE)
99..withValue(Phone.NUMBER, "136********")
100..withValue(Phone.TYPE, Phone.TYPE_MOBILE)
101..withValue(https://www.360docs.net/doc/a92375727.html,BEL, "手机号")
102..build());
103.ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.C ONTENT_URI)
104..withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
105..withValue(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE)
106..withValue(Email.DATA, "kesen@https://www.360docs.net/doc/a92375727.html,")
107..withValue(Email.TYPE, Email.TYPE_WORK)
108..build());
109.ContentProviderResult[] results = this.getContext().getContentResolver()
110..applyBatch(ContactsContract.AUTHORITY, ops);
111.for(ContentProviderResult result : results)
112.{
113.Log.i(TAG, result.uri.toString());
114.}
115.}
116.}********************************************************************** *********************************
这里主要使用的是
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中的所有字段
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_STA TUS_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.
https://www.360docs.net/doc/a92375727.html,ST_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_ALTERNA TIVE. 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 https://www.360docs.net/doc/a92375727.html,monDataKinds.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中的所有字段:
privatevoidlistColumnNames()
{
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 { String temp =cursor.getColumnName(i); Log.e("listColumnNames","" + i + "\t" + temp); } cursor.close(); }