Filter 过滤器

Posted 2020-07-16 robert_chao

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Filter 过滤器相关的知识，希望对你有一定的参考价值。

一、结构

　　　　public abstract class Filter extends Object

java.lang.Object
android.widget.Filter

　　二、概述

　　　　过滤器通过过滤模式来约束数据，通常由实现了Filterable接口的子类来生成。过滤操作是通过调用 filter(CharSequence) 或者 filter(CharSequence, android.widget.Filter.FilterListener)这些异步方法来完成的。以上方法一旦被调用，过滤请求就会被递交到请求队列中等待处理，同时该操作会取消那些之前递交的但是还没有被处理的请求。

　　三、构造函数

public Filter ()
　创建一个新的异步过滤器。

　　四、公共方法

　　public CharSequence convertResultToString (Object resultValue)
　　将受过滤的集合对象转换成CharSequence文本。所有继承了Filter的子类应该重写该方法。该方法的默认实现：如果参数为null则返回空字符串或者返回参数的字符串形式.
　　参数
resultValue 转换成CharSequence文本的对象
返回值
CharSequence 文本

　　public final void filter(CharSequence constraint, Filter.FilterListener listener)
　　启动一个异步的过滤操作。对该方法的调用会取消之前队列中等待处理的过滤请求并且递交新的过滤请求等待执行。完成过滤操作之后，通知监听器。
　　参数
　　constraint 过滤数据的约束条件
　　listener 监听过滤操作完成之后发出的通知
　　参见
　　filter(CharSequence)
　　performFiltering(CharSequence)
　　publishResults(CharSequence, android.widget.Filter.FilterResults)

　　public final void filter(CharSequence constraint)
　　启动一个异步的过滤操作。对该方法的调用会取消之前队列中等待处理的过滤请求并且递交新的过滤请求等待执行。
　　参数
　　constraint 过滤数据的约束条件
参见
　　filter(CharSequence, android.widget.Filter.FilterListener)

　　五、受保护方法

　　protected abstract Filter.FilterResults performFiltering (CharSequence constraint)
　　根据约束条件调用一个工作线程过滤数据。子类必须实现该方法来执行过滤操作。过滤结果以Filter.FilterResults的形式返回，然后在UI线程中通过publishResults(CharSequence,android.widget.Filter.FilterResults)方法来发布。
　　约定：当约束条件为null时，原始数据必须被恢复。
　　参数
　　constraint 约束条件
　　返回值
　　过滤结果
　　参见
filter(CharSequence, android.widget.Filter.FilterListener)
publishResults(CharSequence, android.widget.Filter.FilterResults)
Filter.FilterResults

　　protected abstract void publishResults (CharSequence constraint, Filter.FilterResults results)
　　通过调用UI线程在用户界面发布过滤结果。子类必须实现该方法来显示performFiltering(CharSequence)的过滤结果。
　　参数
　　constraint 约束条件
　　results 过滤结果
　　参见
filter(CharSequence, android.widget.Filter.FilterListener)
　　performFiltering(CharSequence)
　　　　　　　　Filter.FilterResults