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_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為鍵。
最後更新:2017-04-02 00:06:51