android通过拼音搜索中文的功能实现代码

146 阅读 0 评论 97 点赞

我是靠谱客的博主丰富荷花，最近开发中收集的这篇文章主要介绍android通过拼音搜索中文的功能实现代码，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

好几年没写博客了，很多知识不记是真的会忘记，以后还是保持写博客的习惯吧。坚持不一定成功，但放弃一定很舒服！（开玩笑(#^.^#)）

回归正题，今天我要记录的是拼音搜索功能，我记得16年的时候做过这个功能。现在已经忘记很多细节了，所以这次好好写一写！

第一步：准备

第三方包——中文转拼音，pinyin4j-2.5.0.jar，官网http://pinyin4j.sourceforge.net/
Filterable.java 过滤接口

第二步：分析功能并实现

很明显，这是两个功能，一个是中文转拼音，一个是查询过滤
下面我们先实现主要功能，查询过滤
创建布局文件 activity_main.xml，实现如下：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  xmlns:tools="http://schemas.android.com/tools"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  tools:context=".MainActivity"
  android:padding="16dp">
 
  <EditText
    android:id="@+id/etSearchName"
    android:layout_width="match_parent"
    android:layout_height="50dp"
    android:hint="请输入拼音"
    android:padding="5dp"
    app:layout_constraintLeft_toLeftOf="parent"
    app:layout_constraintRight_toRightOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
 
  <androidx.recyclerview.widget.RecyclerView
    android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginTop="10dp"
    app:layout_constraintTop_toBottomOf="@+id/etSearchName"
    />
 
</androidx.constraintlayout.widget.ConstraintLayout>

就一个搜索框和列表控件

接着创建列表适配器 SearchAdapter.java，实现了过滤器类Filterable

public class SearchAdapter extends RecyclerView.Adapter<SearchAdapter.MyViewHolder> implements Filterable {
 
  private Context context;
  private List<String> list;
  //保存原有的数据
  private List<String> originalList;
 
  private OnItemListener onItemListener;
  void setOnItemListener(OnItemListener onItemListener){
    this.onItemListener = onItemListener;
  }
 
  private SearchFilter filter;
 
  SearchAdapter(Context context,List<String> list){
    this.context =context;
    this.list = list;
    originalList = list;
  }
 
  @NonNull
  @Override
  public SearchAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
    View view = LayoutInflater.from(context).inflate(R.layout.item_rv_search,parent,false);
    return new MyViewHolder(view);
  }
 
  @Override
  public void onBindViewHolder(@NonNull SearchAdapter.MyViewHolder holder, final int position) {
    holder.tvName.setText(list.get(position));
    holder.itemView.setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
        if (onItemListener!=null){
          onItemListener.onItem(list.get(position));
        }
      }
    });
  }
 
  @Override
  public int getItemCount() {
    return list==null?0:list.size();
  }
 
  @Override
  public Filter getFilter() {
    if (filter==null){
      filter = new SearchFilter();
    }
    return filter;
  }
 
  class MyViewHolder extends RecyclerView.ViewHolder{
    private TextView tvName;
    MyViewHolder(@NonNull View itemView) {
      super(itemView);
      tvName = itemView.findViewById(R.id.tvName);
    }
  }
 
  interface OnItemListener{
    void onItem(String name);
  }
 
 
  class SearchFilter extends Filter{
 
    @Override
    protected FilterResults performFiltering(CharSequence constraint) {
      //输入框传来的数据 constraint
 
      //用于保存过滤的结果
      FilterResults filterResults = new FilterResults();
 
      if (constraint==null || constraint.length()==0){
        filterResults.values = originalList;
        filterResults.count = originalList.size();
      }else {
        List<String> fList = new ArrayList<>();
        String cons = constraint.toString().trim().toLowerCase();
        for (String s : originalList) {
          //从首位开始匹配
          if (s.startsWith(cons)){
            fList.add(s);
          }
        }
        filterResults.values = fList;
        filterResults.count = fList.size();
      }
 
      return filterResults;
    }
 
    @Override
    protected void publishResults(CharSequence constraint, FilterResults results) {
      list = (List<String>) results.values;
      notifyDataSetChanged();
    }
  }

}

这段代码，重点是SearchFilter类的两个方法

performFiltering(CharSequence constraint) 接收输入数据，在这个方法实现处理逻辑
publishResults(CharSequence constraint, FilterResults results) 接收过滤后的结果

注意点：originalList 这个集合是用来保存原有数据的。因为list会随着搜索结果而变化，我们每次的过滤都是需要用到原有的数据。

适配器写好了，下面看看怎么使用它

 private RecyclerView recyclerView;
  private SearchAdapter adapter;
  private List<String> list;
 
  private EditText etSearchName;
 
  public static final String[] str = new String[]{
      "陈天丽","黄正","徐明"
      ,"李自成","林子祥","周星星"
      ,"周润发","林星辰","林青霞"
      ,"李赛凤","刘德华","胡歌"
      ,"霍建华","林心如","赵薇"
      ,"赵四","赵本山","郭德纲"
  };
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
 
    etSearchName = findViewById(R.id.etSearchName);
    recyclerView = findViewById(R.id.recyclerView);
 
    recyclerView.setLayoutManager(new LinearLayoutManager(this));
 
    list = new ArrayList<>();
    list.addAll(Arrays.asList(str));
 
    adapter = new SearchAdapter(this,list);
    recyclerView.setAdapter(adapter);
    adapter.setOnItemListener(new SearchAdapter.OnItemListener() {
      @Override
      public void onItem(String name) {
        etSearchName.setText(name);
      }
    });
 
    etSearchName.addTextChangedListener(new TextWatcher() {
      @Override
      public void beforeTextChanged(CharSequence s, int start, int count, int     
   after) {
 
      }
 
      @Override
      public void onTextChanged(CharSequence s, int start, int before, int count) {
        adapter.getFilter().filter(etSearchName.getText().toString().trim());
      }
 
      @Override
      public void afterTextChanged(Editable s) {
 
      }
    });
 
  }

一顿RecyclerView的常规操作

这里需要注意的是这段代码 adapter.getFilter().filter(etSearchName.getText().toString().trim()); 这里就调用了我们写好的过滤器。

到此，我们的搜索过滤功能已经实现了。

看看运行效果：

接下来说说中文转拼音

首先需要修改数据源类型

之前的数据源只是String集合，现在加了拼音，那就不能只用String了。建个实体UserName，字段有pinyin和name；
通过pinyin4j.jar包把中文转成拼音，然后保存到UserName集合，代码如下：

 HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
    format.setToneType(HanyuPinyinToneType.WITHOUT_TONE);//不显示音标
    format.setVCharType(HanyuPinyinVCharType.WITH_V);//“ü”输出V
    format.setCaseType(HanyuPinyinCaseType.LOWERCASE);//拼音输出小写
    userNameList = new ArrayList<>();
    for (String name : list) {
      StringBuffer stringBuffer = new StringBuffer();
      for (int j=0;j<name.length();j++){
        char c = name.charAt(j);
        String[] cStrHY = new String[0];
        try {
          cStrHY = PinyinHelper.toHanyuPinyinStringArray(c,format);
        } catch (BadHanyuPinyinOutputFormatCombination       
            badHanyuPinyinOutputFormatCombination) {
          badHanyuPinyinOutputFormatCombination.printStackTrace();
        }
        stringBuffer.append(cStrHY[0]);
      }
      UserName userName = new UserName();
      userName.setPinyin(stringBuffer.toString());
      userName.setName(name);
      userNameList.add(userName);
    }

PinyinHelper类有很多转换的方法，我选择了toHanyuPinyinStringArray，将单个字符转成拼音

值得注意的是，HanyuPinyinOutputFormat类，可以用你输出不同的拼音格式
setToneType 设置音标的显示方式：

HanyuPinyinToneType.WITH_TONE_MARK：在拼音字母上显示音标，如“zhòng”
HanyuPinyinToneType.WITH_TONE_NUMBER：在拼音字符串后面通过数字显示，如“zhong4”
HanyuPinyinToneType.WITHOUT_TONE：不显示音标

setCaseType 设置拼音大小写：

HanyuPinyinCaseType.LOWERCASE：返回的拼音为小写字母
HanyuPinyinCaseType.UPPERCASE：返回的拼音为大写字母

setVCharType 设置拼音字母“ü”的显示方式
汉语拼音中的“ü”不能简单的通过英文来表示，所以需要单独定义“ü”的显示格式

HanyuPinyinVCharType.WITH_U_UNICODE：默认的显示方式，输出“ü”
HanyuPinyinVCharType.WITH_V：输出“v”
HanyuPinyinVCharType.WITH_U_AND_COLON：输出“u:”

所以过滤的判断需要改一下，代码如下：

 List<UserName> fList = new ArrayList<>();
        String cons = constraint.toString().trim().toLowerCase();
        for (UserName userName : originalList) {
          //从首位开始匹配
          if (userName.getPinyin().startsWith(cons)){
            fList.add(userName);
          }
        }
        filterResults.values = fList;
        filterResults.count = fList.size();

看看运行效果：