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时，要用到这个对象，以及该对象包含的值。