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

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

5. KindSectionView

KindSectionView是何方神圣呢？它又是怎么怎么和一个DataKind，以及一个RawContactDelta绑定到一起的呢？继续看，进入KindSectionView，其实KindSectionView就是一个普通的自定义View，他的作用还真的就是将DataKind中包含的数据变成UI显示出来，那么这个View是什么呢？它有自己的xml文件：item_kind_section.xml：

<com.android.contacts.editor.KindSectionView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginBottom="@dimen/raw_contact_sect_fields_margin_bottom"
    android:orientation="vertical">
   
    <include
        android:id="@+id/kind_title_layout"
        layout="@layout/edit_kind_title" />
   
    <LinearLayout
        android:id="@+id/kind_editors"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="vertical" />
   
    <Button
        android:id="@+id/add_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="start"
        android:text="@string/add_new_entry_for_section"
        android:drawableStart="@drawable/spb_plus_icn" />
   
</com.android.contacts.editor.KindSectionView>

对照这图片我们分析：

kind_title_layout：就是上图中的Phone那个View；

add_text：就是上图中的“Add new” Button；

kind_editors：就是介于这两者之间的部分。当然，对add_text的点击事件处理也在KindSectionView类，如下：

@Override
protected void onFinishInflate() {
    setDrawingCacheEnabled(true);
    setAlwaysDrawnWithCacheEnabled(true);
   
    mInflater = (LayoutInflater) getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE);
   
    mTitle = (TextView) findViewById(R.id.kind_title);
    mEditors = (ViewGroup) findViewById(R.id.kind_editors);
    mAddFieldFooter = findViewById(R.id.add_text);
    mAddFieldFooter.setOnClickListener(new OnClickListener() {
        @Override
        public void onClick(View v) {
            mAddFieldFooter.setVisibility(View.GONE);
            addItem();
        }
    });
    super.onFinishInflate();
}

不过我们还是继续沿着KindSectionView类setState（）方法往下分析，rebuildFromState（）-->createEditorView(),createEditorView（）方法具体加载了每一个DataKind，代码如下：

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

首先是mKind，这个值就是section.setState(kind, state, false, vig)传过来的，它先取出editorLayoutResourceId，然后解析为View，并绑定在mEditors上，然后再操作，那么editorLayoutResourceId是什么？我们回过头去看DataKind：

public DataKind() {
    editorLayoutResourceId = R.layout.text_fields_editor_view;
    maxLinesForDisplay = 1;
}
   
public DataKind(String mimeType, int titleRes, int weight, boolean editable,
        int editorLayoutResourceId) {
    this.mimeType = mimeType;
    this.titleRes = titleRes;
    this.weight = weight;
    this.editable = editable;
    this.typeOverallMax = -1;
    this.editorLayoutResourceId = editorLayoutResourceId;
    maxLinesForDisplay = 1;
}

DataKind有两个默认的构造器，无参构造器设置了默认的text_fields_editor_view，以LocalAccountType为例：

protected DataKind addDataKindStructuredName(
    Context context) throws DefinitionException {
    DataKind kind = addKind(new DataKind(StructuredName.CONTENT_ITEM_TYPE,
            R.string.nameLabelsGroup, -1, true,
            R.layout.structured_name_editor_view));

添加Name时，使用R.layout.structured_name_editor_view：

protected DataKind addDataKindNickname(
    Context context) throws DefinitionException {
    DataKind kind = addKind(new DataKind(Nickname.CONTENT_ITEM_TYPE,
                R.string.nicknameLabelsGroup, 115, true,
                R.layout.text_fields_editor_view));

添加NickName， Phone， Email等时都是R.layout.text_fields_editor_view。回来接着看createEditorView（）方法，

editorLayoutResourceId有了，剩下的就是把这个id对应的layout显示出来，看

editor.setValues(mKind, entry， mState, mReadOnly, mViewIdGenerator);看两个xml文件：

structured_name_editor_view.xml 这个是专门针对Name的，后面再说，先看text_fields_editor_view.xml：

<com.android.contacts.editor.TextFieldsEditorView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">
   
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:orientation="horizontal"
        android:gravity="center_vertical"
        android:focusable="true"
        android:clickable="true">
   
        <include
            layout="@layout/edit_spinner"
            android:layout_width="@dimen/editor_type_label_width"
            android:layout_height="@dimen/editor_min_line_item_height"
            android:layout_gravity="top"
            android:layout_marginEnd="@dimen/raw_contact_edit_spinner_margin_end"
            android:visibility="gone" />
   
        <include
            layout="@layout/edit_field_list_with_anchor_view" />
   
        <FrameLayout
            android:layout_width="wrap_content"
            android:layout_height="match_parent">
   
            <include
                android:id="@+id/expansion_view_container"
                layout="@layout/edit_expansion_view"
                android:visibility="gone" />
   
            <include
                android:id="@+id/delete_button_container"
                layout="@layout/edit_delete_button"
                android:visibility="gone" />
   
        </FrameLayout>
   
    </LinearLayout>
   
</com.android.contacts.editor.TextFieldsEditorView>

edit_spinner：上图中“Home” Spinner；

expansion_view_container：展开或折叠Button，这个只有在Postal Address和Name中用到；

delete_button_container：上图中的叉；

TextFieldsEditorView类的继承关系如图：

我们进入TextFieldsEditorView的setValues（）方法：

@Override
public void setValues(DataKind kind, ValuesDelta entry, RawContactDelta state, boolean readOnly, ViewIdGenerator vig) {
    super.setValues(kind, entry, state, readOnly, vig);
    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);
        fieldView.setTextAppearance(getContext(), android.R.style.TextAppearance_Medium);
        mFieldEditTexts[index] = fieldView;
   
   
        fieldView.addTextChangedListener(new TextWatcher() {
            @Override
            public void afterTextChanged(Editable s) {
                // Trigger event for newly changed value
                onFieldChanged(column, s.toString());
            }
   
        });
   
        mFields.addView(fieldView);
    }
   
}

首先调用了父类的setValues()方法，在父类的setValues()方法中对一些UI赋值，如Spinner mLabel，给他设置了一个Adapter，值就是kind.typeList中包含的内容，前文中提到过。

我们继续看TextFieldsEditorView的setValues（）方法，有个for循环，将kind.fieldList中所有的field取出来，并创建一个对应的EditText fieldView，然后添加到mFields，mFields = (ViewGroup) findViewById(R.id.editors)，来自text_fields_editor_view.xml --> edit_field_list_with_anchor_view.xml，如下：

<LinearLayout
    android:layout_width="0dip"
    android:layout_height="wrap_content"
    android:layout_weight="1"
   
    android:orientation="vertical">
    <LinearLayout
         android:id="@+id/editors"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:orientation="vertical"
         android:focusable="true"
         android:focusableInTouchMode="true"
         android:descendantFocusability="afterDescendants" />
    <View
         android:id="@+id/anchor_view"
         android:layout_width="match_parent"
         android:layout_height="0px" />
</LinearLayout>

说白了，editors这个id对应的View就是用来添加一个EditText。

稍微总结一下：

最重要的是RawContactCommonEditorView类setState()方法，其中的for循环，作用就是将账户中的每一个kind取出来，然后生成一个KindSectionView，并显示出来。而每一个KindSectionView里面，又有可能包含多个field，这取决于kind中fieldlist中添加的EditField的个数，如下图，就包含2个EditField。

至此，Phone UI的显示部分完成，具体的细节还得要仔细看代码,比如Spinner的点击事件，叉的点击事件，文中有提到，但是具体的还得研究代码，很简单，至于EditText添加的TextChangedListener的作用，这个设计到Save contact，我们先记住每个EditText都有一个TextChangedListener就好，到分析Save Contact流程时再说。

6. 添加Name UI

前面提到Name UI，我们这里仔细分析它。

在raw_contact_editor_view.xml中，有专门添加Name相关UI的布局：

<include
    android:id="@+id/edit_name"
    layout="@layout/structured_name_editor_view" />

进入structured_name_editor_view.xml：

<com.android.contacts.editor.StructuredNameEditorView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:minHeight="@dimen/editor_min_line_item_height"
    android:orientation="vertical">
   
    <include
        layout="@layout/edit_spinner"
        android:layout_width="@dimen/editor_type_label_width"
        android:layout_height="@dimen/editor_min_line_item_height"
        android:layout_gravity="top"
        android:visibility="gone" />
   
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:clickable="true">
   
        <include
            layout="@layout/edit_field_list_with_anchor_view"/>
   
        <include
            android:id="@+id/expansion_view_container"
            layout="@layout/edit_expansion_view"
            android:visibility="gone" />
   
        <include
            android:id="@+id/delete_button_container"
            layout="@layout/edit_delete_button"
            android:visibility="gone" />
    </LinearLayout>
   
</com.android.contacts.editor.StructuredNameEditorView>

发现这个文件和text_fields_editor_view.xml很像，当然了，看StructuredNameEditorView类的继承图，发现StructuredNameEditorView继承自TextFieldsEditorView，所以啊，他的逻辑其实也在TextFieldsEditorView里面，和Phone一样，只不过因为StructedName比较特殊，比如没有前面的Title， 后面的“Add new”和Spinner等。我以前做这块的UI定制的时候，需要改变页面中所有的EditText的效果，尤其是有多个EditText，比如Name， Address展开后的效果，其实改动还是在TextFieldsEditorView的setValues（）方法中，对EditText设置背景，以及其他属性，来达到定制的需求。