android聯繫人信息的存儲結構

從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_id一、raw_contact_id二、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爲鍵。