联系人存储ContactsProvider表分析
生活随笔
收集整理的這篇文章主要介紹了
联系人存储ContactsProvider表分析
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
ContactsProvider建表的都在
packages/providers/ContactsProvider/src/com/android/providers/contacts/ContactsDatabaseHelper.java
首先該文件中有個Tables接口，其中的常量定義了數據庫中大部分的表
public interface Tables {public static final String CONTACTS = "contacts"; //聯系人，由raw_contacts表聚合而成public static final String DELETED_CONTACTS = "deleted_contacts"; //標記要刪除的聯系人public static final String RAW_CONTACTS = "raw_contacts"; //聯系人的原始數據，同一個聯系人可能對應多個raw_contactspublic static final String STREAM_ITEMS = "stream_items"; //IM信息public static final String STREAM_ITEM_PHOTOS = "stream_item_photos"; //IM信息相關頭像public static final String PHOTO_FILES = "photo_files"; //照片public static final String PACKAGES = "packages"; //包名public static final String MIMETYPES = "mimetypes"; //mime類型public static final String PHONE_LOOKUP = "phone_lookup"; //依據號碼查聯系人public static final String NAME_LOOKUP = "name_lookup"; //依據名字查聯系人public static final String AGGREGATION_EXCEPTIONS = "agg_exceptions"; //合并聯系人規則public static final String SETTINGS = "settings"; //設置public static final String DATA = "data"; //聯系人最原始的數據，每一個row可以是號碼、地址、名字等等public static final String GROUPS = "groups"; //聯系人組public static final String PRESENCE = "presence"; //IM在線狀態public static final String AGGREGATED_PRESENCE = "agg_presence"; //IM在線狀態，聚合使用public static final String NICKNAME_LOOKUP = "nickname_lookup"; //昵稱查找public static final String CALLS = "calls"; //通話記錄public static final String STATUS_UPDATES = "status_updates";//聊天程序狀態public static final String PROPERTIES = "properties"; //屬性public static final String ACCOUNTS = "accounts"; //賬戶public static final String VISIBLE_CONTACTS = "visible_contacts"; //標記可見聯系人public static final String DIRECTORIES = "directories";//通訊錄public static final String DEFAULT_DIRECTORY = "default_directory";//默認通訊錄public static final String SEARCH_INDEX = "search_index"; //搜索public static final String VOICEMAIL_STATUS = "voicemail_status";//語音郵箱public static final String PRE_AUTHORIZED_URIS = "pre_authorized_uris";//申請權限...public static final String DATA_USAGE_STAT = "data_usage_stat"; //data使用統計...public static final String DIALER_SEARCH = "dialer_search";//撥號盤搜索表public static final String CONFERENCE_CALLS = "conference_calls"; //會議組通話}PROPERTIES
屬性表db.execSQL("CREATE TABLE " + Tables.PROPERTIES + " (" +PropertiesColumns.PROPERTY_KEY + " TEXT PRIMARY KEY, " + //keyPropertiesColumns.PROPERTY_VALUE + " TEXT " + //value");");只有兩個字段，key值有： public interface DbProperties {String DIRECTORY_SCAN_COMPLETE = "directoryScanComplete"; //Directory掃描完畢String AGGREGATION_ALGORITHM = "aggregation_v2";//聯系人聚合算法String KNOWN_ACCOUNTS = "known_accounts"; //系統所有賬號String ICU_VERSION = "icu_version"; //icu版本String LOCALE = "locale"; //所在區域String DATABASE_TIME_CREATED = "database_time_created"; //數據庫創建時間String CALL_LOG_LAST_SYNCED = "call_log_last_synced"; //最后一次同步通話記錄的時間}
ICU的解釋見點擊打開鏈接
ICU(International Component for Unicode) 是 IBM 與開源組織合作研究 , 基于 "IBM 公共許可證 " 的用于支持軟件國際化的開源項目。 ICU 實現了對數字、日期、貨幣等提供國際化支持，提供了強大的 BIDI 算法，對阿拉伯語和希伯來語等 BiDi 語言提供了完善的支持。 ICU 分為 ICU4J 和 ICU4C，分別對應 Java 和 c/c++ 平臺。 ICU4J 被 Sun 的 JDK1.1 采用并隨 JDK 版本更新。最新的 ICU4J 庫可以從 http://icu-project.org/ 網站上下載。ACCOUNTS?
賬戶表db.execSQL("CREATE TABLE " + Tables.ACCOUNTS + " (" + AccountsColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +AccountsColumns.ACCOUNT_NAME + " TEXT, " + //賬戶名稱AccountsColumns.ACCOUNT_TYPE + " TEXT, " + //賬戶類型AccountsColumns.DATA_SET + " TEXT" + //所屬數據集");");
賬戶類型在ContactsProvider2中針對手機定義了5個，一個本地賬戶（最常用的賬戶）和4個卡賬戶.
public static final String ACCOUNT_TYPE_LOCAL_PHONE = "Local Phone Account";public static final String ACCOUNT_TYPE_SIM = "SIM Account";public static final String ACCOUNT_TYPE_USIM = "USIM Account";public static final String ACCOUNT_TYPE_UIM = "UIM Account";public static final String ACCOUNT_TYPE_CSIM = "CSIM Account";data_set 是區分不同同步源的，因為同一個賬戶的數據是可以被多個數據源備份的。CONTACTS
聯系人表 db.execSQL("CREATE TABLE " + Tables.CONTACTS + " (" +BaseColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +Contacts.NAME_RAW_CONTACT_ID + " INTEGER REFERENCES raw_contacts(_id)," + //對應raw_contacts表中id，用于顯示名字Contacts.PHOTO_ID + " INTEGER REFERENCES data(_id)," + //data表中photo相關row的idContacts.PHOTO_FILE_ID + " INTEGER REFERENCES photo_files(_id)," + //對應photo_files表中idContacts.CUSTOM_RINGTONE + " TEXT," + //來電鈴聲Contacts.SEND_TO_VOICEMAIL + " INTEGER NOT NULL DEFAULT 0," + //標記該聯系人來電是否直接轉接到語音郵箱Contacts.TIMES_CONTACTED + " INTEGER NOT NULL DEFAULT 0," + //聯系次數，如撥號會更新該值。Contacts.LAST_TIME_CONTACTED + " INTEGER," + //最后一次聯系的時間，如電話、短信等Contacts.STARRED + " INTEGER NOT NULL DEFAULT 0," + //是否為星標聯系人Contacts.PINNED + " INTEGER NOT NULL DEFAULT " + PinnedPositions.UNPINNED + "," + //標記在聯系人列表中是否訂住，訂住后滑動列表不會消失Contacts.HAS_PHONE_NUMBER + " INTEGER NOT NULL DEFAULT 0," + //是否有號碼Contacts.LOOKUP_KEY + " TEXT," + //lookup_key, 方便在聚合的情況下找到聯系人，因為聚合的時候有可能id無效ContactsColumns.LAST_STATUS_UPDATE_ID + " INTEGER REFERENCES data(_id)," + //最后更新的對應data表中的idContacts.CONTACT_LAST_UPDATED_TIMESTAMP + " INTEGER," + //最后更新時間Contacts.SEND_TO_VOICEMAIL_VT + " INTEGER NOT NULL DEFAULT 0," + //add by MTK 類似SEND_TO_VOICEMAIL，視頻通話相關Contacts.SEND_TO_VOICEMAIL_SIP + " INTEGER NOT NULL DEFAULT 0," + //add by MTK 類似SEND_TO_VOICEMAIL，sip通話相關Contacts.INDICATE_PHONE_SIM + " INTEGER NOT NULL DEFAULT -1," + //add by MTK,是否為卡聯系人Contacts.INDEX_IN_SIM + " INTEGER NOT NULL DEFAULT -1," + //add by MTK 在sim卡中的索引Contacts.FILTER + " INTEGER NOT NULL DEFAULT 0," + //add by MTK 用于標記該聯系人是否可以顯示桌面widgetContacts.IS_SDN_CONTACT + " INTEGER NOT NULL DEFAULT 0" + // add by MTK 是否為sdn聯系人");");表中的每一個row都代表一個聯系人，這一個聯系人可能在多個賬戶下都有，對應多個RawContact。例如本地賬戶、微信和qq都對應一個手機號碼，聚合后是一個Contact，有3個RawContact。 SDN （系統撥叫號碼） 網絡服務撥號。固化的用戶不能編輯。見點擊打開鏈接DELETED_CONTACTS
刪除聯系人表
db.execSQL("CREATE TABLE " + ContactsDatabaseHelper.Tables.DELETED_CONTACTS + " (" +ContactsContract.DeletedContacts.CONTACT_ID + " INTEGER PRIMARY KEY," + //刪除的聯系人idContactsContract.DeletedContacts.CONTACT_DELETED_TIMESTAMP + //刪除時間" INTEGER NOT NULL default 0"+ ");");刪除聯系人時候并不是直接刪除，而是先標記刪除的聯系人RAW_CONTACTS?
源聯系人表 db.execSQL("CREATE TABLE " + Tables.RAW_CONTACTS + " (" +RawContacts._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +RawContactsColumns.ACCOUNT_ID + " INTEGER REFERENCES " + //賬戶id，對應于account表中的idTables.ACCOUNTS + "(" + AccountsColumns._ID + ")," +RawContacts.SOURCE_ID + " TEXT," + //源賬戶id，例如當前是手機賬戶id，但是源id是sim卡賬戶，表示該聯系人是從sim卡導入的RawContacts.BACKUP_ID + " TEXT," + //備份源id，唯一的RawContacts.RAW_CONTACT_IS_READ_ONLY + " INTEGER NOT NULL DEFAULT 0," + //是否為只讀RawContacts.VERSION + " INTEGER NOT NULL DEFAULT 1," + //版本號，每次更新后都會有變化RawContacts.DIRTY + " INTEGER NOT NULL DEFAULT 0," + //VERSION有變化，表示要同步數據RawContacts.DELETED + " INTEGER NOT NULL DEFAULT 0," + //標記該聯系人要刪除，刪除聚合聯系人和同步server中的數據，最后再刪除數據RawContacts.CONTACT_ID + " INTEGER REFERENCES contacts(_id)," + //對應Contacts表中的idRawContacts.AGGREGATION_MODE + " INTEGER NOT NULL DEFAULT " + //聚合模式，解釋見后文RawContacts.AGGREGATION_MODE_DEFAULT + "," +RawContactsColumns.AGGREGATION_NEEDED + " INTEGER NOT NULL DEFAULT 1," + //標記是否要聚合RawContacts.CUSTOM_RINGTONE + " TEXT," + //鈴聲RawContacts.SEND_TO_VOICEMAIL + " INTEGER NOT NULL DEFAULT 0," + //標記該聯系人來電后是否要直接轉到語音郵箱RawContacts.TIMES_CONTACTED + " INTEGER NOT NULL DEFAULT 0," + //聯系次數RawContacts.LAST_TIME_CONTACTED + " INTEGER," + //最后聯系時間點RawContacts.STARRED + " INTEGER NOT NULL DEFAULT 0," + //是否為星標聯系人RawContacts.PINNED + " INTEGER NOT NULL DEFAULT " + PinnedPositions.UNPINNED + //是否在列表中“訂住”"," + RawContacts.DISPLAY_NAME_PRIMARY + " TEXT," + //名字，名在前，RawContacts.DISPLAY_NAME_ALTERNATIVE + " TEXT," + //名字，姓在前RawContacts.DISPLAY_NAME_SOURCE + " INTEGER NOT NULL DEFAULT " + //名字源，解釋見后文DisplayNameSources.UNDEFINED + "," +RawContacts.PHONETIC_NAME + " TEXT," + //名字對應的語音序列，如漢字對應的拼音RawContacts.PHONETIC_NAME_STYLE + " TEXT," + //語音序列類型，解釋見后文RawContacts.SORT_KEY_PRIMARY + " TEXT COLLATE " + //排序字段ContactsProvider2.PHONEBOOK_COLLATOR_NAME + "," +RawContactsColumns.PHONEBOOK_LABEL_PRIMARY + " TEXT," + //名字首對應首字母，這個是為了歸類名字到26個字母。RawContactsColumns.PHONEBOOK_BUCKET_PRIMARY + " INTEGER," + //名字對應首字母對應的序號，如字母D對應4，RawContacts.SORT_KEY_ALTERNATIVE + " TEXT COLLATE " + //姓在前名字排序字段ContactsProvider2.PHONEBOOK_COLLATOR_NAME + "," +RawContactsColumns.PHONEBOOK_LABEL_ALTERNATIVE + " TEXT," + //類似PHONEBOOK_LABEL_PRIMARYRawContactsColumns.PHONEBOOK_BUCKET_ALTERNATIVE + " INTEGER," + //類似PHONEBOOK_BUCKET_PRIMARYRawContactsColumns.NAME_VERIFIED_OBSOLETE + " INTEGER NOT NULL DEFAULT 0," + //這個字段目前已不用RawContacts.SYNC1 + " TEXT, " + //同步要用的字段RawContacts.SYNC2 + " TEXT, " +RawContacts.SYNC3 + " TEXT, " +RawContacts.SYNC4 + " TEXT, " +RawContacts.TIMESTAMP + " INTEGER," + //add by MTK ,VERSION變化時間點RawContacts.SEND_TO_VOICEMAIL_VT + " INTEGER NOT NULL DEFAULT 0," + // add by MTK，后續同Contacts表中解釋RawContacts.SEND_TO_VOICEMAIL_SIP + " INTEGER NOT NULL DEFAULT 0," + // add by MTKRawContacts.INDICATE_PHONE_SIM + " INTEGER NOT NULL DEFAULT -1," + //add by MTKRawContacts.INDEX_IN_SIM + " INTEGER NOT NULL DEFAULT -1," + //add by MTKRawContacts.IS_SDN_CONTACT + " INTEGER NOT NULL DEFAULT 0" + // add by MTK");");這個表中的每一個row對應于一個賬戶的數據，如果用戶只使用一個本地手機賬戶的話，實際上就是一個RawContact對應一個Contact。AGGREGATION_MODE ?
DISPLAY_NAME_SOURCE
public interface DisplayNameSources {public static final int UNDEFINED = 0; public static final int EMAIL = 10; //電子郵件public static final int PHONE = 20; //電話public static final int ORGANIZATION = 30; //公司public static final int NICKNAME = 35; //昵稱public static final int STRUCTURED_NAME = 40; //名字}PHONETIC_NAME_STYLE? public interface PhoneticNameStyle {public static final int UNDEFINED = 0;public static final int PINYIN = 3; //中文public static final int JAPANESE = 4; //日文public static final int KOREAN = 5; //朝鮮文}STREAM_ITEMS
steam item表 db.execSQL("CREATE TABLE " + Tables.STREAM_ITEMS + " (" +StreamItems._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +StreamItems.RAW_CONTACT_ID + " INTEGER NOT NULL, " + //對應的RawContact IdStreamItems.RES_PACKAGE + " TEXT, " + //相關程序包名StreamItems.RES_ICON + " TEXT, " + //相關程序的圖標StreamItems.RES_LABEL + " TEXT, " + //相關程序名，例如“Google Talk”StreamItems.TEXT + " TEXT, " + //信息字符串，例如朋友圈的內容StreamItems.TIMESTAMP + " INTEGER NOT NULL, " + //時間戳StreamItems.COMMENTS + " TEXT, " + //摘要信息，例如Text已被幾人讀過StreamItems.SYNC1 + " TEXT, " + //同步需要的字段StreamItems.SYNC2 + " TEXT, " +StreamItems.SYNC3 + " TEXT, " +StreamItems.SYNC4 + " TEXT, " +"FOREIGN KEY(" + StreamItems.RAW_CONTACT_ID + ") REFERENCES " +Tables.RAW_CONTACTS + "(" + RawContacts._ID + "));");這個表是Deprecated，不會使用。從注釋看是為聊天工具準備的，記錄聊天工具最新的信息。STREAM_ITEM_PHOTOS
steam photo表 db.execSQL("CREATE TABLE " + Tables.STREAM_ITEM_PHOTOS + " (" +StreamItemPhotos._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +StreamItemPhotos.STREAM_ITEM_ID + " INTEGER NOT NULL, " + //對應的stream item idStreamItemPhotos.SORT_INDEX + " INTEGER, " + //排序字段StreamItemPhotos.PHOTO_FILE_ID + " INTEGER NOT NULL, " + //頭像文件idStreamItemPhotos.SYNC1 + " TEXT, " +StreamItemPhotos.SYNC2 + " TEXT, " +StreamItemPhotos.SYNC3 + " TEXT, " +StreamItemPhotos.SYNC4 + " TEXT, " +"FOREIGN KEY(" + StreamItemPhotos.STREAM_ITEM_ID + ") REFERENCES " +Tables.STREAM_ITEMS + "(" + StreamItems._ID + "));");這個表是Deprecated，不會使用。記錄stream item中的頭像信息PHOTO_FILES
頭像表 db.execSQL("CREATE TABLE " + Tables.PHOTO_FILES + " (" +PhotoFiles._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +PhotoFiles.HEIGHT + " INTEGER NOT NULL, " + //高PhotoFiles.WIDTH + " INTEGER NOT NULL, " + //寬PhotoFiles.FILESIZE + " INTEGER NOT NULL);"); //文件大小PACKAGES
包名表 db.execSQL("CREATE TABLE " + Tables.PACKAGES + " (" +PackagesColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +PackagesColumns.PACKAGE + " TEXT NOT NULL" + //包名");");id 和包名對照表，依據id獲取包名MIMETYPES
mime類型表 db.execSQL("CREATE TABLE " + Tables.MIMETYPES + " (" +MimetypesColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +MimetypesColumns.MIMETYPE + " TEXT NOT NULL" +");");百度百科：MIME(Multipurpose Internet Mail Extensions)多用途互聯網郵件擴展類型。它是一個互聯網標準，擴展了電子郵件標準.這張表記錄了data所有對象的類型，依據該類型可以區分每個row數據是什么。這些類型全部在ContactsContract中已CONTENT_ITEM_TYPE定義，例如Phone中的： /** MIME type used when storing this in data table. */public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/phone_v2"; 標記該類型數據是電話號碼 StructuredName中 /** MIME type used when storing this in data table. */public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/name";標記該類型數據是名字
DATA?
數據表 db.execSQL("CREATE TABLE " + Tables.DATA + " (" +Data._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +DataColumns.PACKAGE_ID + " INTEGER REFERENCES package(_id)," + //插入數據的程序包名idDataColumns.MIMETYPE_ID + " INTEGER REFERENCES mimetype(_id) NOT NULL," + //mime類型idData.RAW_CONTACT_ID + " INTEGER REFERENCES raw_contacts(_id) NOT NULL," + //所屬的RawContact IdData.HASH_ID + " TEXT," + //哈希值,用于恢復和備份數據Data.IS_READ_ONLY + " INTEGER NOT NULL DEFAULT 0," + //是否只讀Data.IS_PRIMARY + " INTEGER NOT NULL DEFAULT 0," + //標記為聯系人的主要屬性Data.IS_SUPER_PRIMARY + " INTEGER NOT NULL DEFAULT 0," + //標記為聯系人聚合后的主要屬性，IS_SUPER_PRIMARY的前提是IS_PRIMARY為trueData.DATA_VERSION + " INTEGER NOT NULL DEFAULT 0," + //版本號Data.DATA1 + " TEXT," + //數據Data.DATA2 + " TEXT," +Data.DATA3 + " TEXT," +Data.DATA4 + " TEXT," +Data.DATA5 + " TEXT," +Data.DATA6 + " TEXT," +Data.DATA7 + " TEXT," +Data.DATA8 + " TEXT," +Data.DATA9 + " TEXT," +Data.DATA10 + " TEXT," +Data.DATA11 + " TEXT," +Data.DATA12 + " TEXT," +Data.DATA13 + " TEXT," +Data.DATA14 + " TEXT," +Data.DATA15 + " TEXT," +Data.SYNC1 + " TEXT, " + //同步需要的字段Data.SYNC2 + " TEXT, " +Data.SYNC3 + " TEXT, " +Data.SYNC4 + " TEXT, " +Data.CARRIER_PRESENCE + " INTEGER NOT NULL DEFAULT 0," + //目前只有一個可選值，標記是否可以視頻通話Data.SIM_ASSOCIATION_ID + " INTEGER NOT NULL DEFAULT -1, " + //add by MTK 卡聯系人相關的sub_idData.IS_ADDITIONAL_NUMBER + " INTEGER NOT NULL DEFAULT 0 " + //add by MTK 作用未知");"); DATA1~DATA15依據mime類型的不同有不同的意義，例如mime是名字：private interface RawContactNameQuery {...public static final int DATA1 = 2; //全名public static final int GIVEN_NAME = 3; // data2 名public static final int FAMILY_NAME = 4; // data3 姓public static final int PREFIX = 5; // data4 前綴public static final int TITLE = 5; // data4 頭銜public static final int MIDDLE_NAME = 6; // data5 中間名public static final int SUFFIX = 7; // data6 后綴public static final int PHONETIC_GIVEN_NAME = 8; // data7 姓的語音字符序列public static final int PHONETIC_MIDDLE_NAME = 9; // data8 中間名語音字符序列public static final int ORGANIZATION_PHONETIC_NAME = 9; // data8 公司名語音字符序列public static final int PHONETIC_FAMILY_NAME = 10; // data9 姓語音字符序列public static final int FULL_NAME_STYLE = 11; // data10 名字類型，解釋如下public static final int ORGANIZATION_PHONETIC_NAME_STYLE = 11; // data10public static final int PHONETIC_NAME_STYLE = 12; // data11}PHONETIC_NAME_STYLE之前已介紹，FULL_NAME_STYLE 如下定義： public interface FullNameStyle {public static final int UNDEFINED = 0;public static final int WESTERN = 1;/*** Used if the name is written in Hanzi/Kanji/Hanja and we could not determine* which specific language it belongs to: Chinese, Japanese or Korean.*/public static final int CJK = 2;public static final int CHINESE = 3;public static final int JAPANESE = 4;public static final int KOREAN = 5;}
PHONE_LOOKUP?
號碼查找表 db.execSQL("CREATE TABLE " + Tables.PHONE_LOOKUP + " (" +PhoneLookupColumns.DATA_ID+ " INTEGER REFERENCES data(_id) NOT NULL," + //對應data表中的idPhoneLookupColumns.RAW_CONTACT_ID+ " INTEGER REFERENCES raw_contacts(_id) NOT NULL," + //對應raw_contacts表idPhoneLookupColumns.NORMALIZED_NUMBER + " TEXT NOT NULL," + //號碼PhoneLookupColumns.MIN_MATCH + " TEXT NOT NULL" + //最小匹配號碼");");依據號碼查找聯系人數據，可見從這個表查找聯系人id會少一個步驟。MIN_MATCH字段是號碼的倒序，且長度不會超過一定長度（默認是7位，國內是11位）。這個是為了號碼匹配，因為號碼匹配是從字符串右邊開始的，且達到一定位數就認為號碼匹配成功，例如+8613812345678和13812345678 是匹配的。NAME_LOOKUP
名字查找表 db.execSQL("CREATE TABLE " + Tables.NAME_LOOKUP + " (" +NameLookupColumns.DATA_ID+ " INTEGER REFERENCES data(_id) NOT NULL," +NameLookupColumns.RAW_CONTACT_ID+ " INTEGER REFERENCES raw_contacts(_id) NOT NULL," +NameLookupColumns.NORMALIZED_NAME + " TEXT NOT NULL," +NameLookupColumns.NAME_TYPE + " INTEGER NOT NULL," +"PRIMARY KEY ("+ NameLookupColumns.DATA_ID + ", "+ NameLookupColumns.NORMALIZED_NAME + ", "+ NameLookupColumns.NAME_TYPE + ")" +");");按名字查找聯系人，其它字段同號碼查找表類似，其中NAME_TYPE public static final int NAME_EXACT = 0;//名字public static final int NAME_VARIANT = 1; //名字變體，就是token的所有順序public static final int NAME_COLLATION_KEY = 2; //為了排序public static final int NICKNAME = 3; //昵稱public static final int EMAIL_BASED_NICKNAME = 4; //郵箱地址名字插入的時候會生成這五種類型的數據到表中，前三中是基于名字的，后兩種是從數據庫表中查詢生成的。這里注意代碼中的NickName有兩種情況，NICKNAME類型對應的是Nickname.CONTENT_ITEM_TYPE類型的data表中的數據，而packages/providers/ContactsProvider/src/com/android/providers/contacts/aggregation/util/CommonNicknameCache.java中的NickName對應的是常用英文名的縮寫，如"Robert", "Bob" and "Rob"是一個意思，這部分的字符串替換是算在NAME_VARIANT類型中的NICKNAME_LOOKUP
昵稱表 db.execSQL("CREATE TABLE " + Tables.NICKNAME_LOOKUP + " (" +NicknameLookupColumns.NAME + " TEXT," + //名字NicknameLookupColumns.CLUSTER + " TEXT" + //名字對應id");");這個是被framework中的資源初始化的private void loadNicknameLookupTable(SQLiteDatabase db) {db.execSQL("DELETE FROM " + Tables.NICKNAME_LOOKUP);String[] strings = mContext.getResources().getStringArray(com.android.internal.R.array.common_nicknames);...}該字符串定義在frameworks/base/core/res/res/values-en-rUS/donottranslate-names.xml中 <string-array name="common_nicknames"><item>Abigail, Abbie</item><item>Abigail, Gail, Gayle</item><item>Abe, Abraham</item>...可以看出每行數據定義了等價的名字，同一行的名字有相同的id
GROUPS
群組表 db.execSQL("CREATE TABLE " + Tables.GROUPS + " (" +Groups._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +GroupsColumns.PACKAGE_ID + " INTEGER REFERENCES package(_id)," + //對應package表中的idGroupsColumns.ACCOUNT_ID + " INTEGER REFERENCES " + //對應account表中的idTables.ACCOUNTS + "(" + AccountsColumns._ID + ")," +Groups.SOURCE_ID + " TEXT," + //源賬戶idGroups.VERSION + " INTEGER NOT NULL DEFAULT 1," + //版本號Groups.DIRTY + " INTEGER NOT NULL DEFAULT 0," + //是否要同步Groups.TITLE + " TEXT," + //群組名Groups.TITLE_RES + " INTEGER," + //群組名資源idGroups.NOTES + " TEXT," + //備注Groups.SYSTEM_ID + " TEXT," + //系統群組id，對同步有重要意義，從代碼中看有系統id的GROUP_IS_READ_ONLY都會設置為1Groups.DELETED + " INTEGER NOT NULL DEFAULT 0," + //標記是否刪除Groups.GROUP_VISIBLE + " INTEGER NOT NULL DEFAULT 0," + //是否可見Groups.SHOULD_SYNC + " INTEGER NOT NULL DEFAULT 1," + //當SYNC_EVERYTHING設置為false的時候，是否同步Groups.AUTO_ADD + " INTEGER NOT NULL DEFAULT 0," + //新建聯系人后是否自動添加到該群組Groups.FAVORITES + " INTEGER NOT NULL DEFAULT 0," + //星標聯系人是否自動添加到該群組Groups.GROUP_IS_READ_ONLY + " INTEGER NOT NULL DEFAULT 0," + //是否只讀Groups.SYNC1 + " TEXT, " + //同步字段Groups.SYNC2 + " TEXT, " +Groups.SYNC3 + " TEXT, " +Groups.SYNC4 + " TEXT " +");");AGGREGATION_EXCEPTIONS
聚合規則表 db.execSQL("CREATE TABLE IF NOT EXISTS " + Tables.AGGREGATION_EXCEPTIONS + " (" +AggregationExceptionColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +AggregationExceptions.TYPE + " INTEGER NOT NULL, " +AggregationExceptions.RAW_CONTACT_ID1+ " INTEGER REFERENCES raw_contacts(_id), " +AggregationExceptions.RAW_CONTACT_ID2+ " INTEGER REFERENCES raw_contacts(_id)" +");");類型有三種： public static final int TYPE_AUTOMATIC = 0; //自動聚合public static final int TYPE_KEEP_TOGETHER = 1; //聚合public static final int TYPE_KEEP_SEPARATE = 2; //不聚合另外兩個字段是兩個RawContact Id. 這個表可以添加聯系人聚合的規則，聯系人聚合時會參照這個規則。這個表的最大用處是手動合并聯系人。SETTINGS
設置表 db.execSQL("CREATE TABLE IF NOT EXISTS " + Tables.SETTINGS + " (" +Settings.ACCOUNT_NAME + " STRING NOT NULL," + //賬戶名稱Settings.ACCOUNT_TYPE + " STRING NOT NULL," + //賬戶類型Settings.DATA_SET + " STRING," + //標記同步源，一個數據庫可備份到多處Settings.UNGROUPED_VISIBLE + " INTEGER NOT NULL DEFAULT 0," + //不再群組內的聯系人是否可見Settings.SHOULD_SYNC + " INTEGER NOT NULL DEFAULT 1" + //是否啟用同步，這個是最高等級的開關");");VISIBLE_CONTACTS
可見聯系人表 db.execSQL("CREATE TABLE " + Tables.VISIBLE_CONTACTS + " (" +Contacts._ID + " INTEGER PRIMARY KEY" +");");只有一個字段，可見聯系人的idDEFAULT_DIRECTORY?
默認通訊錄表 db.execSQL("CREATE TABLE " + Tables.DEFAULT_DIRECTORY + " (" +Contacts._ID + " INTEGER PRIMARY KEY" +");");無賬戶和無群組的聯系人的id都會插入到這個表中CALLS
見通話記錄VOICEMAIL_STATUS
語音郵箱狀態表 db.execSQL("CREATE TABLE " + Tables.VOICEMAIL_STATUS + " (" +VoicemailContract.Status._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +VoicemailContract.Status.SOURCE_PACKAGE + " TEXT UNIQUE NOT NULL," + //VoicemailContract.Status.PHONE_ACCOUNT_COMPONENT_NAME + " TEXT," + //phone進程的包名VoicemailContract.Status.PHONE_ACCOUNT_ID + " TEXT," + //實際就是sim卡的subidVoicemailContract.Status.SETTINGS_URI + " TEXT," + //action view加上這個uri的intent可以拉起設置界面VoicemailContract.Status.VOICEMAIL_ACCESS_URI + " TEXT," + //獲取語音郵件VoicemailContract.Status.CONFIGURATION_STATE + " INTEGER," + //設置狀態，解釋見下VoicemailContract.Status.DATA_CHANNEL_STATE + " INTEGER," + //數據連接狀態VoicemailContract.Status.NOTIFICATION_CHANNEL_STATE + " INTEGER" + //通知連接狀態");");CONFIGURATION_STATE public static final int CONFIGURATION_STATE_OK = 0;public static final int CONFIGURATION_STATE_NOT_CONFIGURED = 1;public static final int CONFIGURATION_STATE_CAN_BE_CONFIGURED = 2;DATA_CHANNEL_STATE public static final int DATA_CHANNEL_STATE_OK = 0;public static final int DATA_CHANNEL_STATE_NO_CONNECTION = 1;NOTIFICATION_CHANNEL_STATEpublic static final int NOTIFICATION_CHANNEL_STATE_OK = 0;public static final int NOTIFICATION_CHANNEL_STATE_NO_CONNECTION = 1;
STATUS_UPDATES?
狀態表 db.execSQL("CREATE TABLE " + Tables.STATUS_UPDATES + " (" +StatusUpdatesColumns.DATA_ID + " INTEGER PRIMARY KEY REFERENCES data(_id)," +StatusUpdates.STATUS + " TEXT," + //狀態StatusUpdates.STATUS_TIMESTAMP + " INTEGER," + //時間戳StatusUpdates.STATUS_RES_PACKAGE + " TEXT, " + //提供資源的包名StatusUpdates.STATUS_LABEL + " INTEGER, " + //狀態資源idStatusUpdates.STATUS_ICON + " INTEGER" + //狀態圖標id");");這個轉門指通訊工具（例如Google Talk）的狀態，例如在線，隱身等。DIRECTORIES?
通訊錄表 db.execSQL("CREATE TABLE " + Tables.DIRECTORIES + "(" +Directory._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +Directory.PACKAGE_NAME + " TEXT NOT NULL," +Directory.DIRECTORY_AUTHORITY + " TEXT NOT NULL," + Directory.TYPE_RESOURCE_ID + " INTEGER," +DirectoryColumns.TYPE_RESOURCE_NAME + " TEXT," +Directory.ACCOUNT_TYPE + " TEXT," +Directory.ACCOUNT_NAME + " TEXT," +Directory.DISPLAY_NAME + " TEXT, " +Directory.EXPORT_SUPPORT + " INTEGER NOT NULL" + //后面詳細解釋" DEFAULT " + Directory.EXPORT_SUPPORT_NONE + "," +Directory.SHORTCUT_SUPPORT + " INTEGER NOT NULL" +" DEFAULT " + Directory.SHORTCUT_SUPPORT_NONE + "," +Directory.PHOTO_SUPPORT + " INTEGER NOT NULL" +" DEFAULT " + Directory.PHOTO_SUPPORT_NONE +");");Directory表示一個集合，例如ContactsProvider默認會添加兩個Directory,一個就是之前介紹的的DEFAULT，還有一個是LOCAL_INVISIBLE/*** _ID of the default directory, which represents locally stored contacts.*/public static final long DEFAULT = 0;/*** _ID of the directory that represents locally stored invisible contacts.*/public static final long LOCAL_INVISIBLE = 1;除了這兩個外，還可以在其他app中實現DirectoryProvider，ContactsProvider會掃描所有的apk，發現AndroidManifest中有 <meta-data android:name="android.content.ContactDirectory" android:value="true"/>都會認為該app是一個DirectoryProvider，ContactsProvider收到相應請求會轉發到相應?AUTHORITY的DirectoryProvider去。
EXPORT_SUPPORT
public static final int EXPORT_SUPPORT_NONE = 0; //不支持導出聯系人public static final int EXPORT_SUPPORT_SAME_ACCOUNT_ONLY = 1; //只能導出到指定的賬戶public static final int EXPORT_SUPPORT_ANY_ACCOUNT = 2; //能導出到任何賬戶SHORTCUT_SUPPORT? public static final int SHORTCUT_SUPPORT_NONE = 0; //不支持快捷方式public static final int SHORTCUT_SUPPORT_DATA_ITEMS_ONLY = 1; //只支持單個data itempublic static final int SHORTCUT_SUPPORT_FULL = 2; //支持全部PHOTO_SUPPORT? public static final int PHOTO_SUPPORT_NONE = 0; //不支持頭像public static final int PHOTO_SUPPORT_THUMBNAIL_ONLY = 1; //小頭像public static final int PHOTO_SUPPORT_FULL_SIZE_ONLY = 2; //大頭像public static final int PHOTO_SUPPORT_FULL = 3; //全部支持DirectoryProvider是針對三方app有自己的聯系人數據，想通過Android標準的聯系人查詢供其它app使用，但是又不暴露自己的數據庫實現，那么就按Android的標準實現一個DirectoryProvider。
SEARCH_INDEX
搜索表 db.execSQL("CREATE VIRTUAL TABLE " + Tables.SEARCH_INDEX+ " USING FTS4 ("+ SearchIndexColumns.CONTACT_ID + " INTEGER REFERENCES contacts(_id) NOT NULL,"+ SearchIndexColumns.CONTENT + " TEXT, " //公司、備注等其它信息+ SearchIndexColumns.NAME + " TEXT, " //名字+ SearchIndexColumns.TOKENS + " TEXT" //號碼+ ")");FTS是Full-Text Search，見全文索引，這個大幅度提高了長文的搜索效率。 這里建立虛表是FTS的要求，更詳細的見sqlite官方網站點擊打開鏈接。注意使用FTS還會有另外5個表自動建立： For each FTS virtual table in a database, three to five real (non-virtual) tables are created to store the underlying data. These real tables are called "shadow tables". The real tables are named "%_content", "%_segdir", "%_segments", "%_stat", and "%_docsize", where "%" is replaced by the name of the FTS virtual table.DIALER_SEARCH
撥號盤搜索表，見MTK的T9搜索流程分析CONFERENCE_CALLS
會議通話表，mtk添加的表 db.execSQL("CREATE TABLE " + Tables.CONFERENCE_CALLS + " (" +ConferenceCalls._ID + " INTEGER PRIMARY KEY AUTOINCREMENT," +ConferenceCalls.GROUP_ID + " INTEGER REFERENCES groups(_id)," + //對應group idConferenceCalls.CONFERENCE_DATE + " INTEGER " + //日期");");DATA_USAGE_STAT?
data使用情況統計表 db.execSQL("CREATE TABLE " + Tables.DATA_USAGE_STAT + "(" +DataUsageStatColumns._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +DataUsageStatColumns.DATA_ID + " INTEGER NOT NULL, " + //對應data表的idDataUsageStatColumns.USAGE_TYPE_INT + " INTEGER NOT NULL DEFAULT 0, " + //類型，解釋見下DataUsageStatColumns.TIMES_USED + " INTEGER NOT NULL DEFAULT 0, " + // 使用次數DataUsageStatColumns.LAST_TIME_USED + " INTERGER NOT NULL DEFAULT 0, " + //最后一次使用的時間"FOREIGN KEY(" + DataUsageStatColumns.DATA_ID + ") REFERENCES "+ Tables.DATA + "(" + Data._ID + ")" +");");USAGE_TYPE_INTpublic static final String USAGE_TYPE_CALL = "call"; //通話public static final String USAGE_TYPE_LONG_TEXT = "long_text"; //長的文本通信，例如電子郵件public static final String USAGE_TYPE_SHORT_TEXT = "short_text"; //短的文本通信，例如短信
PRE_AUTHORIZED_URIS?
權限表 db.execSQL("CREATE TABLE " + Tables.PRE_AUTHORIZED_URIS + " ("+PreAuthorizedUris._ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +PreAuthorizedUris.URI + " STRING NOT NULL, " +PreAuthorizedUris.EXPIRATION + " INTEGER NOT NULL DEFAULT 0);");這個表用于app獲取權限，與Context.grantUriPermission不同的是它不用在代碼中指明要獲取什么權限，授權后5分鐘內可以查詢數據，5分鐘后權限過期。這個表的詳細用法見ContactsContract中的Authorization類。PRESENCE
db.execSQL("ATTACH DATABASE ':memory:' AS " + DATABASE_PRESENCE + ";");db.execSQL("CREATE TABLE IF NOT EXISTS " + DATABASE_PRESENCE + "." + Tables.PRESENCE + " ("+StatusUpdates.DATA_ID + " INTEGER PRIMARY KEY REFERENCES data(_id)," + //對應data表中的idStatusUpdates.PROTOCOL + " INTEGER NOT NULL," + //協議常量StatusUpdates.CUSTOM_PROTOCOL + " TEXT," + //訂制協議名稱StatusUpdates.IM_HANDLE + " TEXT," + //和協議相關StatusUpdates.IM_ACCOUNT + " TEXT," + //IM賬號PresenceColumns.CONTACT_ID + " INTEGER REFERENCES contacts(_id)," + //對應contacts idPresenceColumns.RAW_CONTACT_ID + " INTEGER REFERENCES raw_contacts(_id)," + //對應raw_contacts idStatusUpdates.PRESENCE + " INTEGER," + //im的在線狀態，解釋見下StatusUpdates.CHAT_CAPABILITY + " INTEGER NOT NULL DEFAULT 0," + //通話能力，解釋見下"UNIQUE(" + StatusUpdates.PROTOCOL + ", " + StatusUpdates.CUSTOM_PROTOCOL+ ", " + StatusUpdates.IM_HANDLE + ", " + StatusUpdates.IM_ACCOUNT + ")" + ");");這個表和AGGREGATED_PRESENCE都是在內存數據庫中，在設備中并沒有對應文件，進程關閉后表就消失，進程開啟后表創建。 IM即使通訊，例如Google Talk。這個表主要是記錄IM的在線狀態 PRESENCEint OFFLINE = 0; //不在線int INVISIBLE = 1; //隱身int AWAY = 2; //離開int IDLE = 3; //空閑int DO_NOT_DISTURB = 4; //勿擾int AVAILABLE = 5; //在線 CHAT_CAPABILITY public static final int CAPABILITY_HAS_VOICE = 1; //語音public static final int CAPABILITY_HAS_VIDEO = 2; //視頻public static final int CAPABILITY_HAS_CAMERA = 4; //有前置攝像頭
AGGREGATED_PRESENCE
db.execSQL("CREATE TABLE IF NOT EXISTS "+ DATABASE_PRESENCE + "." + Tables.AGGREGATED_PRESENCE + " ("+AggregatedPresenceColumns.CONTACT_ID+ " INTEGER PRIMARY KEY REFERENCES contacts(_id)," +StatusUpdates.PRESENCE + " INTEGER," +StatusUpdates.CHAT_CAPABILITY + " INTEGER NOT NULL DEFAULT 0" +");");字段同PRESENCE表。這個表的修改都在AbstractContactAggregator中，為了聚合聯系人。總結
以上是生活随笔為你收集整理的联系人存储ContactsProvider表分析的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： HiveSQL和普通SQL的区别
- 下一篇： 通过TMS320F28335学习DSP的