從Android 2.0(API Level 5)開始，Android平臺提供了一個改進的Contacts API，以適應一個聯繫人可以有多個帳戶的需求，比如說手機通訊錄和GMAIL通訊錄，兩個通訊錄中的兩條記錄可以是同一個人。新的Contacts API主要是由ContactsContract及其相關的類來管理，舊的API(android.provider.Contacts）已不贊成使用，但爲了兼容仍可以使用，只不過像以前一樣，只能返回第一個帳戶的信息。
在新的Contacts API中，聯繫人數據被放到三張表中：Contacts、RawContacts和Data。這樣可以幫助系統更好地存儲與管理一個聯繫人的多個帳戶的信息。
Data：
Data表存儲了聯繫人的詳細信息，表中的每一行存儲一個特定類型的信息，比如Email、Address或Phone。每一行通過一個mimetype_id的字段來表示該行存儲的是什麼類型的數據，該字段引用了mimetyps表，此表存儲了常用的數據類型。Data表的字段主要有：
mimetype_id 表示該行存儲的信息的類型
raw_contact_id 表示該行所屬的RawContact
is_primary 多個data數據組成一個raw contact，該字段表示此data是否是其所屬的raw contact的主data，即其display name會作爲raw contact的display name
is_super_primary 該data是否是其所屬的contact的主data，如果is_super_primary爲1則is_primary一定爲1
data1~data15 15個數據字段，對於不同類型的信息，表示不同的含義，ContactsContract.CommomDataKinds類中定義了與常用的數據類型相對應的一些類，這些類中分別定義了相應數據類型中這些字段表示的含義。一般data1表是主信息（如電話，Email地址等），data2表示副信息，data15表示Blob數據。
data_sync1~data_sync4 sync_adapter要用的字段（sync_adapter用於數據的同步，比如你手機中的Gmail帳戶與Google服務器的同步）。
data_version 數據的版本，用於數據的同步。
RawContact：
RawContact表中的一行存儲Data表中一些數據行的集合及一些其他的信息，表示一個聯繫人某一特定帳戶的信息，比如Facebook或Exchange的一個聯繫人。
當插入一個raw contact或當一個raw contact所屬的一個data改變時，系統會檢查這個raw contact跟其他的raw contact是否可以匹配（比如如果兩個raw contact的data包含相同的電話號碼或名字），如果匹配他們就會被綜合到一起，也就是說他們會屬於同一個cantact，表現爲在RawContact表中他們引用的cantact_id是一樣的。
聯繫人姓名、組織、電話號碼、Email或暱稱的改變會引發raw contact的重新聚合。有兩個方法控制聚合的行爲Aggregaton Mode與ContactsContract.AggregationExceptions。
Aggregaton Mode：
RawContact表中有一個字段aggregation_mode，通過向特定raw contact行中插入這個字段可以修改系統對這個raw contact的聚合行爲，其允許的值如下：
AGGREGATION_MODE_DEFAULT：正常模式，允許自動聚合；
AGGREGATION_MODE_DISABLE：不允許聚合；
AGGREGATION_MODE_SUSPENDED：當一個raw contact的aggregation mode修改爲suspended時，如果其已是一個已聚合的contact的一部分，那麼它仍會保持與原來聚合到一起的raw contact的關係，即使它已改變不再跟其他raw contact匹配。
AGGREGATIONEXCEPTIONS：
在數據庫中存在一個表：agg_exceptions。通過字段raw_contact_id1、raw_contact_id2、mode存儲兩個raw contact聚合的方法，系統定義的聚合行爲有3個：
TYPE_AUTOMATIC=0 由系統決定聚合行爲，默認值。
TYPE_KEEP_SEPARATE=2 不聚合
TYPE_KEEP_TOGETHER=1 聚合
Contact：
Contact表中的一行表示一個聯繫人，它是RawContact表中的一行或多行的數據的組合，這些RawContact表中的行表示同一個人的不同的帳戶信息。Contact中的數據由系統組合RawContact表中的數據自動生成。
不可以直接向這個表中插入數據，當一個raw contact被插入的時候，系統會首先查找Contact表看是否有記錄跟插入的raw contact表示同一個人，如果找到了，則把找到的這個contact的_ID插入raw contact記錄的CONTACT_ID字段，如果沒有找到，則系統自動插入一個Contact記錄並把它的_ID插入新插入的raw contact的CONTACT_ID列。
Contact表中只有TIMES_CONTACTED、LAST_TIME_CONTACTED、STARRED、CUSTOM_RINGTONE、SENE_TO_VOICEMAIL列可更改，這些列的更改會導致相應的raw contact被更改。
當刪除Contact表中的記錄時，會刪除一個聯繫人的所有帳戶的信息，也就是說，其對應的所有raw contacts也會被刪除，各raw contact對應的data也就被刪除了，sync adapter同步時也會刪除服務器端的相應記錄。
如果需要讀取一個聯繫人的信息用CONTENT_LOOKUP_RUI代替CONTENT_URI（見後面）；
如果需要通過電話號碼查找一個聯繫人，用PhoneLookup.CONTENT_FIILTER_URI，這個URI爲這個目的進行了優化；
如果需要通過部分名字的匹配查找，用CONTENT_FILTER_URI；
如果需要通過email，address等信息查找，查找表ContactsContract.Data，結果包含contact ID，名字...
android.provider.ontactsContract.Data類
其定義如下：
public final static class Data implements DataColumnsWithJoins {
private Data() {}
public static final Uri CONTENT_URI = Uri.withAppendedPath(AUTHORITY_URI, "data");
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/data";
//This flag is useful (currently) only for vCard exporter in Contacts app
public static final String FOR_EXPORT_ONLY = "for_export_only";
/*Build a CONTENT_LOOKUP_URI style Uri for the parent ContactsContract.Contacts entry of the given ContactsContract.Data entry.*/
public static Uri getContactLookupUri(ContentResolver resolver, Uri dataUri) {...}
}
Data類定義了CONTENT_URI及CONTENT_TYPE，主要是繼承了DataColumnsWithJoins接口中的字段。DataColumnsWithJoins定義如下：
protected interface DataColumnsWithJoins extends BaseColumns, DataColumns, StatusColumns,
RawContactsColumns, ContactsColumns, ContactNameColumns, ContactOptionsColumns,
ContactStatusColumns {
}
該接口只是綜合了一些接口，其中：
BaseColumns定義了_ID與_COUNT字段，ContentProvider查詢中都要用到的字段。
DataColumns定義了與Data表中字段一一對應的常量
RawContactsColumns, ContactsColumns, ContactNameColumns, ContactOptionsColumns表示RawContact與Contact中的一些字段，定義到此類中以方便訪問。
由於聯繫人的信息都是按類別存儲到了這個Data表中，所以我們要查找聯繫人的信息只需要查這個表。Data類中的Data.CONTACT_ID與Data.RAW_CONTACT_ID分別表示該表項對應的聯繫人在Contact與RawContract表中的ID，我們只需要知道某一個聯繫人的contactId或rawContractId，並根據其查找的數據的類型就可以查到相應類型的信息。
Cursor c = getContentResolver().query(Data.CONTENT_URI,
new String[] {Data._ID, Phone.NUMBER, Phone.TYPE, Phone.LABEL},
Data.CONTACT_ID + "=?" + " AND "
+ Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'",
new String[] {String.valueOf(contactId)}, null);
以上代碼根據聯繫人的contractId，並通過設置其MIMETYPE爲Phone.CONTENT_ITEM_TYPE查到了該聯繫人的電話號碼，把Data.CONTACT_ID換爲Data.RAW_CONTACT_ID即可查找相應rawContactId對應的電話號碼。其中用到了Phone.CONTENT_ITEM_TYPE，這是什麼呢？
CommonDataKinds類
在前面講Data表的結構時講到，Data的data1~data15字段用於存儲各類型的數據信息，那麼這15個字段分別表示什麼信息呢？
前面提到了，Data表中有一個mimetype_id字段，通過這個字段關聯mimetypes表表示該行代表的信息類型，因爲Data表中的每一行可以表示如Phone或Address等不同類型的信息，所以對於不同類型的信息，data1~data15這15列表示不同的含義，如果要靠記憶記住這15列對於特定的類型分別表示什麼意義自然不行，於是Google就預定義了一些類，每一個類對應一些預先定義好的數據類型，在每個類中定義了一些語義地、方便記憶的常量，用來對應這15個字段，比如在CommonDataKinds.Email類中有如下定義
public static final String ADDRESS = DATA1;
public static final String DISPLAY_NAME = DATA4;
DATA1與DATA4爲繼承自DataColumns中的常量，在DataColumns中是這樣定義的：
public static final String DATA1 = "data1";
public static final String DATA4 = "data4";
這樣，當於們要查找Email地址時，只需要通過ContactsContract.CommonDataKinds.Email.ADDRESS引用，而不需要知道它是存儲在Data表中的data1列中。
回到上一個問題，上面查詢電話號碼的例子中用到了Phone.CONTENT_ITEM_TYPE，即是表示CommonDataKinds.Phone.CONTENT_ITEM_TYPE，在Phone類中有如下定義
public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/phone_v2";
vnd.android.cursor.item/phone_v2 就是表示Data表中相應的行存儲的是電話號碼的信息，通過相應類型（如Phone、Email）的CONTENT_ITEM_TYPE，我們就可以指定要查詢的MIMETYPE，即要查詢的數據類型。
其實在上面的例子中還有更簡單的方法：
Cursor phone = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
new String[] { CommonDataKinds.Phone.NUMBER }, CommonDataKinds.Phone.CONTACT_ID + " =? ",
new String[] { String.valueOf(contactId) }, null);
只需把query的第一個參數處傳遞想查找的數據類型的相應的類中的CONTENT_URI就可以了。
Lookup Key
在新的Contact API中，爲contact引入了lookup key的概念，當你的程序需要保存對聯繫人的引用時，用lookup key而別用row id，lookup key是contacts表中的一列，當你有一個lookup key時，可以這樣構造一個Uri：
Uri lookupUri = Uri.withAppendedPath(Contacts.CONTENT_LOOKUP_URI, lookupKey);
然後用這個Uri查詢：
Cursor c = getContentResolver().query(lookupUri, new String[]{Contacts.DISPLAY_NAME}, ...);
try {
c.moveToFirst();
String displayName = c.getString(0);
} finally {
c.close();
}
用lookup key 而不用row id的原因是因爲row id容易改變，用戶把原先兩個聯繫人合併成一個或因爲同步的問題都會導致row id的改變。lookup key是一個字符串，它由raw contact的標識連接組成。
使用row id會比使用lookup key效率高，你可以同時保存二者，然後聯合二者生成一個lookup uri：
Uri lookupUri = getLookupUri(contactId, lookupKey)
當同時有row id跟lookup key時，系統會優先以row id查詢，如果無查找結果或找到的結果跟lookup key不匹配，則再用lookup key查找。
在網上看到的讀取所有聯繫人姓名與電話的代碼都是這樣的：
ContentResolver cr = getContentResolver();
Cursor cursor = cr.query(ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
while (cursor.moveToNext())
{
// 取得聯繫人名字
int nameFieldColumnIndex = cursor.getColumnIndex(PhoneLookup.DISPLAY_NAME);
String name = cursor.getString(nameFieldColumnIndex);
string += (name);
// 取得聯繫人ID
String contactId = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));
Cursor phone = cr.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = "
+ contactId, null, null);
// 取得電話號碼(可能存在多個號碼)
while (phone.moveToNext())
{
String strPhoneNumber = phone.getString(phone.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
string += (":" + strPhoneNumber);
}
string += "\n";
phone.close();
}
cursor.close();
如果有n個聯繫人且每個聯繫人都存有電話號碼的話，就得查詢n+1次。
在園子裏看到一個帖子說可以通過
Uri.withAppendedPath(PhoneLookup.CONTENT_FILTER_URI, "*")
取得所有聯繫人的信息，我在Android 4.0模擬器跟2.3.7的真機上測試都不成功。
聯繫人的各種類型的信息都存儲在Data表中，所以查詢Data表並限制其MIMETYPE爲Phone.CONTENT_ITEM_TYPE即可以查到所有姓名與電話
Cursor phone = cr.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, new String[] {
CommonDataKinds.Phone.NUMBER, CommonDataKinds.Phone.DISPLAY_NAME }, null, null, null);
上述代碼可以查到所有聯繫人的姓名與電話，但是如果直接挨個輸出的話會有問題，如果一個人存儲了兩個電話號碼的話，在Data表中會有兩條記錄，比如一個叫張三的人，存儲了他兩個電話：11111，22222。那麼輸出結果中會有兩條關於張三的記錄，並不會合併到一起，所以我想到先把cursor查詢到的所有數據存儲到Map裏，以DISPLAY_NAME爲鍵，以NUMBER組成的List爲值，即
HashMap<String,ArrayList<String>>
於是有了如下代碼：
ContentResolver cr = getContentResolver();
HashMap<String,ArrayList<String>> hs=new HashMap<String,ArrayList<String>>();
Cursor phone = cr.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, new String[] {
CommonDataKinds.Phone.NUMBER, CommonDataKinds.Phone.DISPLAY_NAME }, null, null, null);
while (phone.moveToNext()) {
String strPhoneNumber = phone.getString(phone.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
String name = phone.getString(phone.getColumnIndex(CommonDataKinds.Phone.DISPLAY_NAME));
ArrayList<String> ad=hs.get(name);
if(ad==null){
ad=new ArrayList<String>();
ad.add(strPhoneNumber);
hs.put(dis, ad);
}
else
ad.add(strPhoneNumber);
}
phone.close();
這樣就可以解決一個姓名對應多個號碼的問題，但還有問題，可能是兩個聯繫人同名，但他們屬於不同的聯繫人，在數據庫中表現爲有不同的contact_id，那麼可以將上述代碼修改一下，將projection參數處添加上ContactsContract.CommonDataKinds.Phone.CONTACT_ID，然後把Map改爲以contact_id爲建，以DISPLAY_NAME與NUMBER組成的LIST爲值，把DISPLAY_NAME統一存儲爲LIST的第一項。當然也可以定義一個類，包含姓名字段及電話號碼組成的LIST字段，電話號碼的LIST中的元素還可以是Map，以號碼的TYPE爲鍵。