AutoCompleteTextView 自定义搜索控件

针对我们平常的搜索框，一个非常常用的组件，我们一般会考虑使用AutoCompleteTextView 作为自定义搜索控件首选,一般我们提供本地的数据，可以直接使用原生组件，但是，如果获取网络数据我们就需要一些变通的手段

背景需求

最近公司需要我们在软件中制作一个带有模糊搜索地址的功能界面组件如图：

需求界面

我们需要在图片的搜索框中输入相应地址的前几位，同时组件开始进行模糊匹配，获得一组地址后直接进行显示

代码分析

自定义搜索view

public class EhiSearchView<T> extends FrameLayout {
    private EhiAutoCompleteTextView acTvSearchBox;
    private AutoAlignTextView tvCancelBtn;
    private ArrayAdapter<T> adapter;
    private List<T> list;

    /**
    * 部分代码省略
    **/
    public EhiSearchView(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        View.inflate(context, R.layout.layout_search_view, this);
        initView();
    }
    /**
     * 初始化搜索框以及取消按钮
    **/
    private void initView() {
        acTvSearchBox = (EhiAutoCompleteTextView) findViewById(R.id.ac_tv_search_box);
        tvCancelBtn = (AutoAlignTextView) findViewById(R.id.tv_cancel_btn);
    }

    
    public void setAdapter(@NonNull ArrayAdapter<T> adapter) {
    this.adapter = adapter;
    acTvSearchBox.setAdapter(adapter);
    adapter.notifyDataSetChanged();//此处必须添加通知数据更新
    }

    
    public void setCancelBtnListener(final OnClickCancelBtnListener cancelBtnListener) {
        tvCancelBtn.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View v) {
                cancelBtnListener.onClick(v);
            }
        });
    }

    /**
     * 取消点击事件
     */
    public interface OnClickCancelBtnListener {
        void onClick(View view);
    }

    
    /**
     * 监听搜索文字字数该改变
     *
     * @param textWatcher 监听器
     */
    public void setSearchBoxTextWatcher(TextWatcher textWatcher) {
        acTvSearchBox.addTextChangedListener(textWatcher);
    }


}

搜索view的使用代码

/**
  * Adatper部分
  **/
public abstract class BaseEhiAdapter<T> extends ArrayAdapter<T> {
    /**
      * 代码部分省略
      */
}  
public class SearchAddressDialog extends EhiNoFixPlaceDialog {
    private EhiSearchView<PoiInfo> searchView;
    private PoiSearch poiSearch;
    private PoiAdapter poiAdapter;
    private static final String CITY_TAG = "city_tag";
    private static final String CLICK_LISTENER_TAG = "click_listener_tag";
    private OnItemClickListener onItemClickListener;
     /**
       * 部分非关键代码省略
      **/
  
    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
        Bundle bundle = getArguments();
        LayoutInflater inflater = getActivity().getLayoutInflater();
        View view = inflater.inflate(R.layout.layout_search_address, null);
        searchView = (EhiSearchView<PoiInfo>) view.findViewById(R.id.search_view);
        searchView.setCancelBtnListener(new EhiSearchView.OnClickCancelBtnListener() {
            @Override
            public void onClick(View view) {
                dismiss();
            }
        });
        initMapSearchConfig();
        initSearchViewConfig(city);
        builder.setView(view);
        return builder.create();
    }

    private void initSearchViewConfig(final String city) {
        searchView.setSearchBoxTextWatcher(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
                //do nothing
            }

            @Override
            public void onTextChanged(CharSequence s, int start, int before, int count) {
                //do nothing
            }

            @Override
            public void afterTextChanged(Editable s) {
                poiSearch.searchInCity(
                        (new PoiCitySearchOption()).city(city).isReturnAddr(true).keyword(s.toString().trim()).pageNum(0));
            }
        });
        searchView.getAcTvSearchBox().setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                if (onItemClickListener != null) {
                    onItemClickListener.onItemClick(parent, view, position, id, searchView.getAdapter().getItem(position));
                }
                dismiss();
            }
        });
    }

    private void initMapSearchConfig() {
        poiSearch = PoiSearch.newInstance();
        poiSearch.setOnGetPoiSearchResultListener(new OnGetPoiSearchResultListener() {
            @Override
            public void onGetPoiResult(PoiResult poiResult) {
                if (getActivity() == null || isDetached()) {
                    return;
                }
                if (poiResult.error != SearchResult.ERRORNO.NO_ERROR) {//包含错误不显示
                    return;
                }
                initAdapter(EhiPoiInfo.convertPoiInfo(poiResult.getAllPoi()));
            }

            @Override
            public void onGetPoiDetailResult(PoiDetailResult poiDetailResult) {
                //do nothing
            }

            @Override
            public void onGetPoiIndoorResult(PoiIndoorResult poiIndoorResult) {
                //do nothing
            }
        });
    }

    /**
     * 初始化适配器
     *
     * @param poiInfoList 搜索信息
     */
    private void initAdapter(List<EhiPoiInfo> poiInfoList) {

        poiAdapter = new PoiAdapter(poiInfoList, getActivity());
        searchView.setAdapter(poiAdapter);
        poiAdapter.notifyDataSetChanged();
    }

   
    public static class EhiPoiInfo extends PoiInfo {
        @Override
        public String toString() {
            return this.name;
        }

        static List<EhiPoiInfo> convertPoiInfo(List<PoiInfo> poiInfoList) {
            String json = GsonUtil.toJson(poiInfoList);
            return GsonUtil.fromJsonList(json, EhiPoiInfo.class);
        }
    }
}

总结代码思路

自定义思路十分简单粗暴：

将AutoCompleteTextView和取消button定义与布局，封装到一个自定义view中
在使用searchView的类中添加TextWatcher()

searchView.setSearchBoxTextWatcher(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {
                //do nothing
            }

            @Override
            public void onTextChanged(CharSequence s, int start, int before, int count) {
                //do nothing
            }
            /**
              * 检测到输入文字直接使用百度的poiSearch进行模糊匹配
             */ 
            @Override
            public void afterTextChanged(Editable s) {
                poiSearch.searchInCity(
                        (new PoiCitySearchOption()).city(city).isReturnAddr(true).keyword(s.toString().trim()).pageNum(0));
            }
        });

通过网络获取定位数据，更新内容

  private void initMapSearchConfig() {
        poiSearch = PoiSearch.newInstance();
        poiSearch.setOnGetPoiSearchResultListener(new OnGetPoiSearchResultListener() {
            @Override
            public void onGetPoiResult(PoiResult poiResult) {
                if (getActivity() == null || isDetached()) {
                    return;
                }
                if (poiResult.error != SearchResult.ERRORNO.NO_ERROR) {//包含错误不显示
                    return;
                }
                initAdapter(EhiPoiInfo.convertPoiInfo(poiResult.getAllPoi()));
            }

            @Override
            public void onGetPoiDetailResult(PoiDetailResult poiDetailResult) {
                //do nothing
            }

            @Override
            public void onGetPoiIndoorResult(PoiIndoorResult poiIndoorResult) {
                //do nothing
            }
        });
    }

     /**
     * 初始化适配器
     *
     * @param poiInfoList 搜索信息
     */
    private void initAdapter(List<EhiPoiInfo> poiInfoList) {

        poiAdapter = new PoiAdapter(poiInfoList, getActivity());
        searchView.setAdapter(poiAdapter);
    }

   
    public static class EhiPoiInfo extends PoiInfo {
        @Override
        public String toString() {
            return this.name;
        }

        static List<EhiPoiInfo> convertPoiInfo(List<PoiInfo> poiInfoList) {
            String json = GsonUtil.toJson(poiInfoList);
            return GsonUtil.fromJsonList(json, EhiPoiInfo.class);
        }
    }

注意点

必须在设置adapter,后再次通知一次数据更新(原因仍在探究)

 public void setAdapter(@NonNull ArrayAdapter<T> adapter) {
    this.adapter = adapter;
    acTvSearchBox.setAdapter(adapter);
    adapter.notifyDataSetChanged();//此处必须添加通知数据更新
    }

使用的实体类，需要重写toString部分 ```java public static class EhiPoiInfo extends PoiInfo { @Override public String toString() { return this.name; }

 static List<EhiPoiInfo> convertPoiInfo(List<PoiInfo> poiInfoList) {
     String json = GsonUtil.toJson(poiInfoList);
     return GsonUtil.fromJsonList(json, EhiPoiInfo.class);
 }  }

由于我们使用的autoCompletTextView的使用的adapter是需要实现Filterable，去进行模糊搜索的实现

```java
public interface Filterable {
   
    Filter getFilter();
}

 public <T extends ListAdapter & Filterable> void setAdapter(T adapter) {
        if (mObserver == null) {
            mObserver = new PopupDataSetObserver(this);
        } else if (mAdapter != null) {
            mAdapter.unregisterDataSetObserver(mObserver);
        }
        mAdapter = adapter;
        if (mAdapter != null) {
            //noinspection unchecked
            mFilter = ((Filterable) mAdapter).getFilter();
            adapter.registerDataSetObserver(mObserver);
        } else {
            mFilter = null;
        }

        mPopup.setAdapter(mAdapter);
    }

所以我们需要我们的adapter去能够自己完成 Filter getFilter();，但是其实我认为没有必要反复造轮子，因为简单的文字检索android的arrayAdapater当中已经实现

public class ArrayAdapter<T> extends BaseAdapter implements Filterable, ThemedSpinnerAdapter {
 @Override
    public @NonNull Filter getFilter() {
        if (mFilter == null) {
            mFilter = new ArrayFilter();
        }
        return mFilter;
    }
}

而重写toString()的作用就在于，作用于arrayAdapter中的自定义filter()

private class ArrayFilter extends Filter {
        @Override
        protected FilterResults performFiltering(CharSequence prefix) {
            final FilterResults results = new FilterResults();

            if (mOriginalValues == null) {
                synchronized (mLock) {
                    mOriginalValues = new ArrayList<>(mObjects);
                }
            }

            if (prefix == null || prefix.length() == 0) {
                final ArrayList<T> list;
                synchronized (mLock) {
                    list = new ArrayList<>(mOriginalValues);
                }
                results.values = list;
                results.count = list.size();
            } else {
                final String prefixString = prefix.toString().toLowerCase();

                final ArrayList<T> values;
                synchronized (mLock) {
                    values = new ArrayList<>(mOriginalValues);
                }

                final int count = values.size();
                final ArrayList<T> newValues = new ArrayList<>();

                for (int i = 0; i < count; i++) {
                    final T value = values.get(i);
                    //此处使用 toString的文本进行匹配
                    final String valueText = value.toString().toLowerCase();

                    // First match against the whole, non-splitted value
                    if (valueText.startsWith(prefixString)) {
                        newValues.add(value);
                    } else {
                        final String[] words = valueText.split(" ");
                        for (String word : words) {
                            if (word.startsWith(prefixString)) {
                                newValues.add(value);
                                break;
                            }
                        }
                    }
                }

                results.values = newValues;
                results.count = newValues.size();
            }

            return results;
        }

        @Override
        protected void publishResults(CharSequence constraint, FilterResults results) {
            //noinspection unchecked
            mObjects = (List<T>) results.values;
            if (results.count > 0) {
                notifyDataSetChanged();
            } else {
                notifyDataSetInvalidated();
            }
        }
    }

至此，一个组件的分析就完成了。

AutoCompleteTextView 自定义搜索控件

AutoCompleteTextView 自定义搜索控件，通过网络获取数据

背景需求

代码分析

总结代码思路

注意点

FEATURED TAGS

FRIENDS