生活随笔
收集整理的這篇文章主要介紹了
Android ContactsProvider源码分析
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
Android源碼目錄packages\providers下的應用是下載，通話等內置基本應用提供數據存儲和操作的provider應用，本文章將針對ContactsProvider源碼的架構和實現展開分析。（注：本文使用使用android4.0版本進行分析）
1、架構設計
? ? ? ContactsProvider中數據操作基類是AbstractContactsProvider.java（參見frameworks\ex\common\java\com\android\common\content\SQLiteContentProvider.java），它繼承ContentProvider.java實現SQLiteTransactionListener.java，類結構如下圖所示：
圖 1 provider結構圖
? ? ? ? 該類是抽象基類，在里面實現了父類的insert、delete和update三個抽象方法，在這三個方法中在其中使用了事務對數據庫進行操作。該類設計時，使用了模板模式模板方法為insertInTransaction，updateInTransaction和deleteInTransaction。該類在對數據庫進行事務操作的同時，對子類開放了onRollback，onCommit等事物回調方法，子類可以根據自己的業務特點進行擴展。增刪改查的調用過程如下圖2 3 4所示：
圖2 ?插入操作
圖 3 更新操作
圖 4 刪除操作
? 在整個設計中有兩個類繼承了AbstractContactsProvider.java，一個是ContactsProvider2.java，我們在調用系統的聯系人數據時基本都是調用該類，里面封裝了所有聯系人的數據操作。第二個是ProfileProvider.java，該類是ContactsProvider2.java的委托類。這三個類的類間關系如下圖5所示：
圖 5 類間關系圖
? 類ContactsTransaction.java是對事務的管理類，主要對進行的事務進行管理，類似一個事務池。是AbstractContactsProvider.java中事務處理的核心類。
? ? ? ? ?DataRowHandler.java是數據處理抽象類，實現了對數據的增刪改操作，子類有如下幾個：
[java]?view plaincopy
DataRowHandlerForCommonDataKind.java?? DataRowHandlerForCustomMimetype.java?? DataRowHandlerForEmail.java?? DataRowHandlerForGroupMembership.java?? DataRowHandlerForIm.java?? DataRowHandlerForNickname.java?? DataRowHandlerForNote.java?? DataRowHandlerForOrganization.java?? DataRowHandlerForPhoneNumber.java?? DataRowHandlerForPhoto.java?? DataRowHandlerForStructuredName.java?? DataRowHandlerForStructuredPostal.java??
這些子類在ContactsProvider2#initDataRowHandlers中初始化
[java]?view plaincopy
private?void?initDataRowHandlers(Map<String,?DataRowHandler>?handlerMap,?? ????????ContactsDatabaseHelper?dbHelper,?ContactAggregator?contactAggregator,?? ????????PhotoStore?photoStore)?{?? ????Context?context?=?getContext();?? ????handlerMap.put(Email.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForEmail(context,?dbHelper,?contactAggregator));?? ????handlerMap.put(Im.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForIm(context,?dbHelper,?contactAggregator));?? ????handlerMap.put(Organization.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForOrganization(context,?dbHelper,?contactAggregator));?? ????handlerMap.put(Phone.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForPhoneNumber(context,?dbHelper,?contactAggregator));?? ????handlerMap.put(Nickname.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForNickname(context,?dbHelper,?contactAggregator));?? ????handlerMap.put(StructuredName.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForStructuredName(context,?dbHelper,?contactAggregator,?? ????????????????????mNameSplitter,?mNameLookupBuilder));?? ????handlerMap.put(StructuredPostal.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForStructuredPostal(context,?dbHelper,?contactAggregator,?? ????????????????????mPostalSplitter));?? ????handlerMap.put(GroupMembership.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForGroupMembership(context,?dbHelper,?contactAggregator,?? ????????????????????mGroupIdCache));?? ????handlerMap.put(Photo.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForPhoto(context,?dbHelper,?contactAggregator,?photoStore));?? ????handlerMap.put(Note.CONTENT_ITEM_TYPE,?? ????????????new?DataRowHandlerForNote(context,?dbHelper,?contactAggregator));?? }??
這些子類在getDataRowHandler方法中中通過mimetype進行調用：
[java]?view plaincopy
public?DataRowHandler?getDataRowHandler(final?String?mimeType)?{?? ????if?(inProfileMode())?{?? ????????return?getDataRowHandlerForProfile(mimeType);?? ????}?? ????DataRowHandler?handler?=?mDataRowHandlers.get(mimeType);?? ????if?(handler?==?null)?{?? ????????handler?=?new?DataRowHandlerForCustomMimetype(?? ????????????????getContext(),?mContactsHelper,?mContactAggregator,?mimeType);?? ????????mDataRowHandlers.put(mimeType,?handler);?? ????}?? ????return?handler;?? }??
getDataRowHandler方法在insertData，deleteData和updateData方法中被調用。
[java]?view plaincopy
? ? ? ? ? ?? ???private?long?insertData(ContentValues?values,?boolean?callerIsSyncAdapter)?{?? ???????long?id?=?0;?? ???????mValues.clear();?? ???????mValues.putAll(values);?? ?? ???????long?rawContactId?=?mValues.getAsLong(Data.RAW_CONTACT_ID);?? ?? ????????? ???????final?String?packageName?=?mValues.getAsString(Data.RES_PACKAGE);?? ???????if?(packageName?!=?null)?{?? ???????????mValues.put(DataColumns.PACKAGE_ID,?mDbHelper.get().getPackageId(packageName));?? ???????}?? ???????mValues.remove(Data.RES_PACKAGE);?? ?? ????????? ???????final?String?mimeType?=?mValues.getAsString(Data.MIMETYPE);?? ???????if?(TextUtils.isEmpty(mimeType))?{?? ???????????throw?new?IllegalArgumentException(Data.MIMETYPE?+?"?is?required");?? ???????}?? ?? ???????mValues.put(DataColumns.MIMETYPE_ID,?mDbHelper.get().getMimeTypeId(mimeType));?? ???????mValues.remove(Data.MIMETYPE);?? ?? ???????DataRowHandler?rowHandler?=?<span?style="color:?rgb(102,?102,?204);">getDataRowHandler(mimeType)</span>;?? ???????id?=?rowHandler.insert(mActiveDb.get(),?mTransactionContext.get(),?rawContactId,?mValues);?? ???????if?(!callerIsSyncAdapter)?{?? ???????????mTransactionContext.get().markRawContactDirty(rawContactId);?? ???????}?? ???????mTransactionContext.get().rawContactUpdated(rawContactId);?? ???????return?id;?? ???}??
所有數據的mimetype都被存儲在表Tables.MIMETYPES中，該只有兩個字段_id和mimetype。
[java]?view plaincopy
db.execSQL("CREATE?TABLE?"?+?Tables.MIMETYPES?+?"?("?? ??????????????+?MimetypesColumns._ID?+?"?INTEGER?PRIMARY?KEY?AUTOINCREMENT,"?? ??????????????+?MimetypesColumns.MIMETYPE?+?"?TEXT?NOT?NULL"?+?");");??
Tables.MIMETYPES表數據的存儲是在ContactsDatabaseHelper#lookupAndCacheId中進行的，具體調用過程如下圖 6 所示：
圖 6 mimetype數據調用流程圖
2、表結構
? ? ? ? ContactsProvider 中共創建了25張表，
[java]?view plaincopy
public?static?final?String?CONTACTS?=?"contacts";?? public?static?final?String?RAW_CONTACTS?=?"raw_contacts";?? public?static?final?String?STREAM_ITEMS?=?"stream_items";?? public?static?final?String?STREAM_ITEM_PHOTOS?=?"stream_item_photos";?? public?static?final?String?PHOTO_FILES?=?"photo_files";?? public?static?final?String?PACKAGES?=?"packages";?? public?static?final?String?MIMETYPES?=?"mimetypes";?? 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";?? public?static?final?String?GROUPS?=?"groups";?? public?static?final?String?PRESENCE?=?"presence";?? public?static?final?String?AGGREGATED_PRESENCE?=?"agg_presence";?? 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";??
這些表數據對開發者開放的api在?\frameworks\base\core\java\android\provider\文件夾下，
[java]?view plaincopy
CallLog.java?? Contacts.java?? ContactsContract.java?? SocialContract.java?? SyncConstValue.java?? VoicemailContract.java??
由于數據查詢涉及多個表間關系，大量數據的查詢都是通過視圖來完成的，創建了如下8個視圖，而這幾個視圖是大家在調用api進行查詢時顯示的數據：
[java]?view plaincopy
public?interface?Views?{?? ????public?static?final?String?DATA?=?"view_data";?? ????public?static?final?String?RAW_CONTACTS?=?"view_raw_contacts";?? ????public?static?final?String?CONTACTS?=?"view_contacts";?? ????public?static?final?String?ENTITIES?=?"view_entities";?? ????public?static?final?String?RAW_ENTITIES?=?"view_raw_entities";?? ????public?static?final?String?GROUPS?=?"view_groups";?? ????public?static?final?String?DATA_USAGE_STAT?=?"view_data_usage_stat";?? ????public?static?final?String?STREAM_ITEMS?=?"view_stream_items";?? }??
4、總結
? ? ? ContactsProvder是provider源碼中數據處理和架構比較全面的一個應用，可以將它的架構核心抽離出來供大家參考和借鑒，以下類構成了整個架構的核心類，可以重點研究：
[java]?view plaincopy
AbstractContactsProvider.java?? ContactAggregator.java?? ContactsDatabaseHelper.java ?
總結
以上是生活随笔為你收集整理的Android ContactsProvider源码分析的全部內容，希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。
