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

2014-01-07 10:46:30 将百度空间里的东西移过来。

在前面的文章中我们分析了UI的加载，其中提到了一个重要的对象：RawContactDeltaList mState，我前面说过这个对象很重要，和联系人保存有关，现在就分析一下联系人到底是怎么保存的。

1. 千里追踪mState

ContactEditorFragment类 bindEditorsForNewContact（）方法中创建了一个RawContactDelta对象insert，代码如下：

 private void bindEditorsForNewContact(AccountWithDataSet newAccount,
         final AccountType newAccountType, RawContactDelta oldState,
         AccountType oldAccountType) {

     final RawContact rawContact = new RawContact(mContext);
     if (newAccount != null) {
         rawContact.setAccount(newAccount);
     } else {
         rawContact.setAccountToLocalContact();
     }

     RawContactDelta insert = new RawContactDelta(
         ValuesDelta.fromAfter(rawContact.getValues()));

     if (mState == null) {
         // Create state if none exists yet
         mState = RawContactDeltaList.fromSingle(insert);
     } else {
         // Add contact onto end of existing state
         mState.add(insert);
     }
 }

mState是一个RawContactDeltaList对象，而insert是一个RawContactDelta，上面代码中mState.add(insert)，接着看，在bindEditors（）方法中：

 RawContactDelta rawContactDelta = getFirstVisibleContact();
 if (rawContactDelta != null) {
     editor = createContactEditorView(rawContactDelta);
 }

 private RawContactDelta getFirstVisibleContact() {
     for (final RawContactDelta rawContactDelta : mState) {
         if (!rawContactDelta.isVisible()) continue;
         return rawContactDelta;
     }
     return null;
 }

我们发现，createContactEditorView(rawContactDelta)中的rawContactDelta就是mState中的第一个对象，也就是前面创建的insert，那么insert究竟什么呢？

insert = (Uri=content://com.android.contacts/raw_contacts,
    Values={
         IdColumn=_id, FromTemplate=false, data_set=null, _id=-2,
         account_name=Phone contacts,
         account_type=com.android.localcontacts, },
         Entries={})

可以看到，此时的insert只不过是一个只包含account信息，Entries为空的RawContactDelta对象，这个对象被当作参数传给createContactEditorView(rawContactDelta)方法，该方法中有：

 editor.setState(rawContactDelta, type, mViewIdGenerator, isEditingUserProfile());

我们前面分析过，editor是一个自定义的BaseRawContactEditorView，参数如下：

rawContactDelta：传进来的RawContactDelta对象；

type：账户类型，此处为LocalAccountType；

isEditingUserProfile()：是否是要编辑“我自己”条目；

此时rawContactDelta对象进入BaseRawContactEditorView类，该类又调用了父类RawContactCommonEditorView的super.setState(state, type, vig, isProfile);该方法有一个重要的else语句块，前面分析过，如下：

 else {
      // Otherwise use generic section-based editors
      if (kind.fieldList == null) continue;
      final KindSectionView section = (KindSectionView)mInflater.inflate(R.layout.item_kind_section, mFields, false);
      section.setEnabled(isEnabled());
      section.setState(kind, state, false, vig);
      mFields.addView(section);
 }

rawContactDelta又被当作参数传到KindSectionView， 通过代码section.setState(kind, state, false, vig);进入KindSectionView类，在rebuildFromState（）方法中:

 if (hasEntries) {
     for (ValuesDelta entry : mState.getMimeEntries(mKind.mimeType)) {
         // Skip entries that aren't visible
         if (!entry.isVisible())
             continue;
         if (isEmptyNoop(entry))
             continue;

         createEditorView(entry);
     }
 }

可以看到，在这里mState.getMimeEntries(mKind.mimeType)，根mKind.mimeType从mState中取出entry，然后把entry传到reateEditorView（）方法中，有如下代码：

 private View createEditorView(ValuesDelta entry) {
     final View view;
     try {
         view = mInflater.inflate(mKind.editorLayoutResourceId, mEditors, false);
     } catch (Exception e) {
     }

     view.setEnabled(isEnabled());

     if (view instanceof Editor) {
         Editor editor = (Editor) view;
         editor.setDeletable(true);
         editor.setValues(mKind, entry, mState, mReadOnly, mViewIdGenerator);
         editor.setEditorListener(this);
     }
     mEditors.addView(view);
     return view;
 }

发现rawContactDelta以及根据mimetype生成的entry，又被当作参数传送，通过editor.setValues()方法，前面分析过editor是TextFieldsEditorView，那么看它的setValue()方法：

 int fieldCount = kind.fieldList.size();
 mFieldEditTexts = new EditText[fieldCount];
 for (int index = 0; index < fieldCount; index++) {
     final EditField field = kind.fieldList.get(index);
     final EditText fieldView = createFieldView(field.column);
 ...

这个方法应该很熟悉了，就是根据kind中fieldlist加载EditText的那个方法，同时还给生成的EditText注册了一个TextChangedListener， 如下：

 fieldView.addTextChangedListener(new TextWatcher() {
     @Override
     public void afterTextChanged(Editable s) {
         // Trigger event for newly changed value
         onFieldChanged(column, s.toString());
     }
 });

至于传进来的rawContactDelta和entry对象，调用了父类的setValues（）方法，并将它们分别赋给了LabeledEditorView的mState和mEntry对象。既然给EditText对象添加了TextChangedListener，那么我们可以想到，应该是EditText中的内容发生改变后触发设置的监听方法，看这个监听方法:

 @Override
 public void onFieldChanged(String column,
     String value) {
     if (!isFieldChanged(column, value)) {
         return;
     }
     saveValue(column, value);
     notifyEditorListener();
 }

onFieldChanged()方法是在LabeledEditorView类里，和mState，mEntry对象在同一个类，我们看他的saveValue（）方法:

 protected void saveValue(String column, String value) {
     mEntry.put(column, value);
 }

我们发现，最终把用户输入的信息放到了mEntry中，既然mEntry是从mState中生成的，那么这些值也就保存到mState，我们在saveValue（）方法中打Log，如下：

 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);
 }

如上图，我只在Name里面输入了“D”，我们看log截图：

column就是BaseAccountType中“StructuredName.GIVEN_NAME”，data2和数据库中的field是对应的，关于数据库，以后再分析；

 kind.fieldList.add(new EditField(StructuredName.GIVEN_NAME, R.string.name_given，
                    FLAGS_PERSON_NAME).setNeedFocus(true));

value表示的是用户输入的值；

mState是从ContactEditorFragment中传进来的RawContactDelta对象，取自RawContactDeltaList mState，这个mState（ContactEditorFragment中的）对象非常重要，因为当用户保存联系人时，会用到它。截图中倒数第二行，mimetype=vnd.android.cursor.item/name, data2=D，也就是说，用户输入的联系人信息是保存在对应的mimetype，比如这个是Name，下面我同时输入姓名和号码，再看一下log：

其中我输入的Name=David，number=18611975588.

上面我们千里追mState，以及弄清楚了用户输入的数据是怎么组织的，只是因为当用户点击保存Button时，要用到这个对象，以及该对象包含的值。