Android操作联系人

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分类数据

示例：

[html] view plain copy print ?

1. //查询所有联系人
2. public void testGetAll() {
3. ContentResolver resolver = getContext().getContentResolver();
4. Uri uri = Uri.parse("content://com.android.contacts/contacts");
5. Cursor idCursor = resolver.query(uri, new String[] { "_id" }, null, null, null);
6. while (idCursor.moveToNext()) {
7. //获取到raw_contacts表中的id
8. int id = idCursor.getInt(0);
9. //根据获取到的ID查询data表中的数据
10. uri = Uri.parse("content://com.android.contacts/contacts/" + id + "/data");
11. Cursor dataCursor = resolver.query(uri, new String[] { "data1", "mimetype" }, null, null, null);
12. StringBuilder sb = new StringBuilder();
13. sb.append("id=" + id);
14. //查询联系人表中的
15. while (dataCursor.moveToNext()) {
16. String data = dataCursor.getString(0);
17. String type = dataCursor.getString(1);
18. if ("vnd.android.cursor.item/name".equals(type))
19. sb.append(", name=" + data);
20. else if ("vnd.android.cursor.item/phone_v2".equals(type))
21. sb.append(", phone=" + data);
22. else if ("vnd.android.cursor.item/email_v2".equals(type))
23. sb.append(", email=" + data);
24. }
25. System.out.println(sb);
26. }
27. }

//查询所有联系人
	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”可以获取到联系人显示名

示例：

[html] view plain copy print ?

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

//根据电话号码查询联系人名称
	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

示例：

[html] view plain copy print ?

1. //添加联系人
2. ublic void testInsert() {
3. ContentResolver resolver = getContext().getContentResolver();
4. Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
5. ContentValues values = new ContentValues();
6. // 向raw_contacts插入一条除了ID之外, 其他全部为NULL的记录, ID是自动生成的
7. long id = ContentUris.parseId(resolver.insert(uri, values));
8. //添加联系人姓名
9. uri = Uri.parse("content://com.android.contacts/data");
10. values.put("raw_contact_id", id);
11. values.put("data2", "FHM");
12. values.put("mimetype", "vnd.android.cursor.item/name");
13. resolver.insert(uri, values);
14. //添加联系人电话
15. values.clear(); // 清空上次的数据
16. values.put("raw_contact_id", id);
17. values.put("data1", "18600000000");
18. values.put("data2", "2");
19. values.put("mimetype", "vnd.android.cursor.item/phone_v2");
20. resolver.insert(uri, values);
21. //添加联系人邮箱
22. values.clear();
23. values.put("raw_contact_id", id);
24. values.put("data1", "[email protected]");
25. values.put("data2", "1");
26. values.put("mimetype", "vnd.android.cursor.item/email_v2");
27. resolver.insert(uri, values);

//添加联系人
	public 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", "[email protected]");
		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

示例：

[html] view plain copy print ?

1. //使用事务添加联系人
2. public void testInsertBatch() throws Exception {
3. ContentResolver resolver = getContext().getContentResolver();
5. ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>();
7. ContentProviderOperation operation1 = ContentProviderOperation //
8. .newInsert(Uri.parse("content://com.android.contacts/raw_contacts")) //
9. .withValue("_id", null) //
10. .build();
11. operations.add(operation1);
13. ContentProviderOperation operation2 = ContentProviderOperation //
14. .newInsert(Uri.parse("content://com.android.contacts/data")) //
15. .withValueBackReference("raw_contact_id", 0) //
16. .withValue("data2", "ZZH") //
17. .withValue("mimetype", "vnd.android.cursor.item/name") //
18. .build();
19. operations.add(operation2);
21. ContentProviderOperation operation3 = ContentProviderOperation //
22. .newInsert(Uri.parse("content://com.android.contacts/data")) //
23. .withValueBackReference("raw_contact_id", 0) //
24. .withValue("data1", "18612312312") //
25. .withValue("data2", "2") //
26. .withValue("mimetype", "vnd.android.cursor.item/phone_v2") //
27. .build();
28. operations.add(operation3);
30. ContentProviderOperation operation4 = ContentProviderOperation //
31. .newInsert(Uri.parse("content://com.android.contacts/data")) //
32. .withValueBackReference("raw_contact_id", 0) //
33. .withValue("data1", "[email protected]") //
34. .withValue("data2", "2") //
35. .withValue("mimetype", "vnd.android.cursor.item/email_v2") //
36. .build();
37. operations.add(operation4);
39. // 在事务中对多个操作批量执行
40. resolver.applyBatch("com.android.contacts", operations);
41. }

//使用事务添加联系人
	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", "[email protected]") //
				.withValue("data2", "2") //
				.withValue("mimetype", "vnd.android.cursor.item/email_v2") //
				.build();
		operations.add(operation4);

		// 在事务中对多个操作批量执行
		resolver.applyBatch("com.android.contacts", operations);
	}