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设置背景，以及其他属性，来达到定制的需求。