Android Phonebook编写联系人UI加载及联系人保存流程（六）

2014-01-07 11:18:08 将百度空间里的东西移过来。

1. Save contact

我们前面已经写了四篇文章，做了大量的铺垫，总算到了这一步，见证奇迹的时刻终于到了。

用户添加了所有需要添加的信息后，点击“Done”来保存新建好的联系人，我们就从用户点击“Done”Button开始分析。

前面提到过，“Done”的处理事件是在ContactEditorActivity里面设置的，如下：

View saveMenuItem = customActionBarView.findViewById(R.id.save_menu_item);
saveMenuItem.setOnClickListener(new OnClickListener() {
    @Override
    public void onClick(View v) {
        mFragment.doSaveAction();
    }
});

我们进入ContactEditorFragment，看他的调用逻辑，doSaveAction()-->save(SaveMode.CLOSE）,重点看save（）方法:

public boolean save(int saveMode) {
    ...
    // Save contact
    Intent intent = ContactSaveService.createSaveContactIntent(
            mContext, mState,
            SAVE_MODE_EXTRA_KEY, saveMode, isEditingUserProfile(),
            getActivity().getClass(),
            ContactEditorActivity.ACTION_SAVE_COMPLETED,
            mUpdatedPhotos, mPbrIndex);
    mContext.startService(intent);
}

可以看到，我们千里追踪的mState被当作参数，和其他对象一样，进入了ContactSaveService，这个ContactSaveService继承自IntentService，进入ContactSaveService之后调用了一个回调方法，如下：

@Override
protected void onHandleIntent(Intent intent) {
    String action = intent.getAction();
    if (ACTION_SAVE_CONTACT.equals(action)) {
        saveContact(intent);
        CallerInfoCacheUtils.sendUpdateCallerInfoCacheIntent(this);
    }

看saveContact(intent)，这个方法就是保存联系人的终极方法:

private void saveContact(Intent intent) {
    RawContactDeltaList state = intent.getParcelableExtra(EXTRA_CONTACT_STATE);
    final boolean isProfile = intent.getBooleanExtra(EXTRA_SAVE_IS_PROFILE, false);
    Bundle updatedPhotos = intent.getParcelableExtra(EXTRA_UPDATED_PHOTOS);
 
    final AccountTypeManager accountTypes = AccountTypeManager.getInstance(this);
 
    String sourceId = null;
    boolean isNewAdnContact = false;
    RawContactDelta entityDelta = state.get(0);
    final AccountType type = entityDelta.getAccountType(accountTypes);
 
    RawContactModifier.trimEmpty(state, accountTypes, isProfile);
 
    Uri lookupUri = null;
 
    final ContentResolver resolver = getContentResolver();
    boolean succeeded = false;
 
    long insertedRawContactId = -1;
 
    int tries = 0;
    while (tries++ < PERSIST_TRIES) {
        final ArrayList<ContentProviderOperation> diff = state.buildDiff();
 
        ContentProviderResult[] results = null;
        if (!diff.isEmpty()) {
            results = resolver.applyBatch(ContactsContract.AUTHORITY, diff);
        }
        final long rawContactId = getRawContactId(state, diff, results);
        if (rawContactId == -1) {
        }
        insertedRawContactId = getInsertedRawContactId(diff, results);
        final Uri rawContactUri = ContentUris.withAppendedId(RawContacts.CONTENT_URI, rawContactId);
        lookupUri = RawContacts.getContactLookupUri(resolver, rawContactUri);
        succeeded = true;
 
        if (isAdnContact && isNewAdnContact && lookupUri != null) {
            long contactId = ContentUris.parseId(lookupUri);
            long newRawContactId = getRawContactId(state, diff, results);
            AdnContactsCollector.updateAdnContactsNow(
                contactId, newRawContactId,
                entityDelta.getAccountType(),
                entityDelta.getAccountName(), sourceId);
        }
        break;
    }
    reportSaveStatus(intent, lookupUri, succeeded);
}

上面的方法并非是完整的方法，我只是截取了重点代码，看while循环，说明会try保存联系人三次，而不是一次。我们前面一致关注的state = intent.getParcelableExtra(EXTRA_CONTACT_STATE);同时还从intent中取出了账户信息等，而最关键的代码实在while循环里面，首先看final ArrayList<ContentProviderOperation> diff = state.buildDiff();我们知道，保存联系人时一般会把所有的信息封装到ContentProviderOperation里面（可以参考http://www.cnblogs.com/wlrhnh/p/3477216.html 和 http://www.cnblogs.com/wlrhnh/p/3477252.html），然后执行resolver.applyBatch，那么现在的问题就是如何封装ContentProviderOperation了，我们知道state是RawContactDeltaList，而且根据前面的分析，它里面添加了一个RawContactDelta对象，下面我们进入RawContactDeltaList的state.buildDiff()方法：

public ArrayList<ContentProviderOperation> buildDiff() {
    final ArrayList<ContentProviderOperation> diff = Lists.newArrayList();
 
    for (RawContactDelta delta : this) {
        final int firstBatch = diff.size();
        final boolean isInsert = delta.isContactInsert();
        backRefs[rawContactIndex++] = isInsert ? firstBatch : -1;
 
        delta.buildDiff(diff);
 
        if (mIsUnlinkingRawContact) continue;
 
        if (rawContactId != -1) {
            final Builder builder = beginKeepTogether();
            builder.withValue(AggregationExceptions.RAW_CONTACT_ID1, rawContactId);
            builder.withValueBackReference(AggregationExceptions.RAW_CONTACT_ID2, firstBatch);
            diff.add(builder.build());
 
        } else if (firstInsertRow == -1) {
            firstInsertRow = firstBatch;
 
        } else {
            final Builder builder = beginKeepTogether();
            builder.withValueBackReference(AggregationExceptions.RAW_CONTACT_ID1, firstInsertRow);
            builder.withValueBackReference(AggregationExceptions.RAW_CONTACT_ID2, firstBatch);
            diff.add(builder.build());
        }
    }
    return diff;
}

首先for循环中取出了RawContactDelta对象，一般情况下只有一个，然后调用delta.buildDiff(diff)，看来还得进入RawContactDelta的buildDiff（）方法，此处传入的diff是一个ArrayList<ContentProviderOperation>对象：

for (ArrayList<ValuesDelta> mimeEntries : mEntries.values()) {
      for (ValuesDelta child : mimeEntries) {
          if (mContactsQueryUri.equals(Profile.CONTENT_RAW_CONTACTS_URI)) {
              builder = child.buildDiff(Uri.withAppendedPath(Profile.CONTENT_URI, RawContacts.Data.CONTENT_DIRECTORY));
          } else {
              builder = child.buildDiff(Data.CONTENT_URI);
          }
      }
}

看外层的for循环，mEntries是HashMap<String, ArrayList<ValuesDelta>>对象，应该还记得前文中分析的saveValue(String column, String value)方法吧，如下：

protected void saveValue(String column, String value) {
    Log.d("David", "column = " + column);
    Log.d("David", "value = " + value);
    mEntry.put(column, value);
    Log.d("David", "mState = " + mState);
}

其中mEntry是ValuesDelta对象，而且有ValuesDelta entry : mState.getMimeEntries(mKind.mimeType)在KindSectionView.java。

继续分析内层循环，取出每一个ValuesDelta对象，然后调用child.buildDiff(Data.CONTENT_URI)，进入ValuesDelta：

public ContentProviderOperation.Builder buildDiff(Uri targetUri) {
    Builder builder = null;
    if (isInsert()) {
        mAfter.remove(mIdColumn);
        builder = ContentProviderOperation.newInsert(targetUri);
        builder.withValues(mAfter);
    }
    return builder;
}

好了，我们看这几个循环，我在每一循环下面都打了log：

RawContactDeltaList: for (RawContactDelta delta : this)
       Log.d("D1", "delta = " + delta);
 
RawContactDelta: for (ArrayList<ValuesDelta> mimeEntries : mEntries.values())
       Log.d("D1", "===================================");
       Log.d("D1", "mimeEntries = " + mimeEntries);
 
RawContactDelta: for (ValuesDelta child : mimeEntries)
       Log.d("D1", "child = " + child);
 
ValuesDelta: buildDiff(Uri targetUri)
       Log.d("D1", "mAfter = " + mAfter);

当我输入Name=Lucky， PhoneNumber=18611112222，然后点击保存联系人时，log结果如下：

RawContactDelta只有一个，包含所有用户输入的信息，可见RawContactDelta是一个包含所有联系人信息的对象；

每一个RawContactDelta都包含好几个ArrayList<ValuesDelta>，其实每一个ArrayList只有一个对象ValuesDelta；那么一个ValuesDelta包含一个Item的信息，如Name， Phone， Email。然后每一个ValuesDelta做buildDiff（）操作，builder.withValues(mAfter)，mAfter是一个ContentValues对象，打印结果如上图mAfter所示。

好了，现在返回到最开始的位置，ContactSaveService.java，saveContact（）方法，有

final ArrayList<ContentProviderOperation> diff = state.buildDiff();
 
ContentProviderResult[] results = null;
if (!diff.isEmpty()) {
    results = resolver.applyBatch(ContactsContract.AUTHORITY, diff);
}

resolver.applyBatch操作，那我们看看最终返回的diff是什么？

for (ContentProviderOperation d : diff) {
    Log.d("D2", "ContentProviderOperation = " + d);
}
results = resolver.applyBatch(ContactsContract.AUTHORITY, diff);

log截图如下：

可以看到每一个ContentProviderOperation中都附带相应的值，而这些值会被resolver.applyBatch（）方法保存在数据库里。

至此，新建联系人UI和保存联系人分析结束。