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

时间:2023-03-08 22:51:48
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);
}

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

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

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

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:

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

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

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