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", "[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
示例:
- //使用事務添加聯系人
- 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);
- }