新建联系人分析

3,联系人编辑

3.1 新建联系人

新建联系人界面如下,

对应的activity为CompactContactEditorActivity,在CompactContactEditorActivity的onCreate方法中,

mFragment = (CompactContactEditorFragment) getFragmentManager().findFragmentByTag(
                TAG_COMPACT_EDITOR);

因此,对应的Fragment为CompactContactEditorFragment。

架构图如下,

当保存联系人时,会调用ContactEditorBaseFragment 的onOptionsItemSelected方法,

case R.id.menu_save:
   return save(SaveMode.CLOSE, /* backPressed =*/ true);

save方法的调用流程图如下,

save方法有关保存联系人如下,

return doSaveAction(saveMode, backPressed);

子类CompactContactEditorFragment的doSaveAction方法如下,

final Intent intent = ContactSaveService.createSaveContactIntent(mContext, mState,
                SAVE_MODE_EXTRA_KEY, saveMode, isEditingUserProfile(),
                ((Activity) mContext).getClass(),
                CompactContactEditorActivity.ACTION_SAVE_COMPLETED, mUpdatedPhotos, backPressed);
mContext.startService(intent);

因此,真实的插入数据库的过程是ContactSaveService中完成的。

mState 是RawContactDeltaList对象, RawContactDeltaList类定义如下,

public class RawContactDeltaList extends ArrayList<RawContactDelta> implements Parcelable {

本质上是RawContactDelta的集合,保存了编辑联系人的详细信息,并且可以进行跨进程通信。

ContactSaveService的createSaveContactIntent方法主要逻辑如下,

1,整理intent信息,

Intent serviceIntent = new Intent(context, ContactSaveService.class);
serviceIntent.setAction(ContactSaveService.ACTION_SAVE_CONTACT);
serviceIntent.putExtra(EXTRA_CONTACT_STATE, (Parcelable) state);
•••

2,整理回调的intent信息,

if (callbackActivity != null) {
   Intent callbackIntent = new Intent(context, callbackActivity);
   callbackIntent.putExtra(saveModeExtraKey, saveMode);
   •••

这里的callbackActivity就是CompactContactEditorActivity,也就是说,完成添加联系人之后,会启动CompactContactEditorActivity进行后续处理。

然后就看ContactSaveService了。ContactSaveService的onHandleIntent方法的调用流程图如下,

onHandleIntent方法对ACTION_SAVE_CONTACT类型的intent处理如下,

else if (ACTION_SAVE_CONTACT.equals(action)) {
    saveContact(intent);

因为ContactSaveService继承IntentService,因此onHandleIntent方法在子线程中执行。

saveContact方法主要逻辑如下,

1,获取intent信息,

RawContactDeltaList state = intent.getParcelableExtra(EXTRA_CONTACT_STATE);
boolean isProfile = intent.getBooleanExtra(EXTRA_SAVE_IS_PROFILE, false);
•••

2,如果该联系人是保存在sim卡中,则调用doSaveToSimCard方法完成保存,

if (isCardOperation) {
   result = doSaveToSimCard(entity, resolver, subscription);
   Log.d(TAG, "doSaveToSimCard result is  " + result);
}

3,调用ContentResolver的applyBatch方法将联系人信息插入contacts2.db数据库中,

final ArrayList<ContentProviderOperation> diff = state.buildDiff();
•••
results = resolver.applyBatch(ContactsContract.AUTHORITY, diff);

4,进行各种异常处理,

} catch (SQLiteFullException e) {

5,获取Intent,调用deliverCallback方法进行回调处理,

Intent callbackIntent = intent.getParcelableExtra(EXTRA_CALLBACK_INTENT);
if (callbackIntent != null) {
•••
callbackIntent.putExtra(EXTRA_SAVE_SUCCEEDED, true);
callbackIntent.setData(lookupUri);
callbackIntent.putExtra(SAVE_CONTACT_RESULT, result);
deliverCallback(callbackIntent);

deliverCallback方法如下,

mMainHandler.post(new Runnable() {
@Override
public void run() {
    deliverCallbackOnUiThread(callbackIntent);
} 
});

将后面的流程切换到主线程中执行。

deliverCallbackOnUiThread方法如下,

for (Listener listener : sListeners) {
    if (callbackIntent.getComponent().equals(
           ((Activity) listener).getIntent().getComponent())) {
          listener.onServiceCompleted(callbackIntent);
          return;
    }
}

调用监听器的onServiceCompleted方法, ContactsActivity的onServiceCompleted方法如下,

onNewIntent(callbackIntent);

直接调用onNewIntent方法。子类ContactEditorBaseActivity实现了onNewIntent方法,该方法对ACTION_SAVE_COMPLETED类型的intent处理如下,

else if (ACTION_SAVE_COMPLETED.equals(action)) {
   mFragment.onSaveCompleted(true,
       intent.getIntExtra(ContactEditorFragment.SAVE_MODE_EXTRA_KEY,
          ContactEditor.SaveMode.CLOSE),

此处的mFragment是ContactEditor对象, ContactEditor是ContactEditorBaseActivity的内部接口, onSaveCompleted方法主要逻辑如下,

1,根据不同的结果调用Toast进行提示,

Toast.makeText(mContext, R.string.contactSavedToast,
                                Toast.LENGTH_SHORT).show();

2,根据不同的saveMode分别进行后续处理,

当然,新建联系人的saveMode 是SaveMode.CLOSE类型,因此不做其他处理。