android filter

    一、何谓Android的过滤机制？

    Android对数据的处理是分层的，从上到下，可以分为：数据层、提供层、Cursor层（不好意思，没找到一个词来表示）、适配层、显示层。每个层次通过一定的机制，可以使数据发生变化时能够上下通知。如下图：

 

    显示层（ListView，GridView,AutoCompleteTextView等）

    适配层（Adpater）

    Cursor层（Cursor）

    提供层（ContentProvider）

    数据层（文件、sqlite、SharedPreference）

 

    数据层是数据具体的存储方式，它可以包括文件、sqlite数据库以及SharedPreference。提供层向上层提供了统一的数据调用方式，并负 责向其它应用共享数据。Cursor层将查询的数据统一成Cursor的形式来使用。适配层用来连接Cursor层和显示层，将数据和界面连接起来。显示 层负责数据的显示。

    另外，Andriod提供了数据的过滤机制，也就是在不改变数据存储的情况下，异步或同步的过滤符合条件的数据，并即时的显示在界面上。

    Android原生的例子当中，最明显的例子就是AutoCompleteTextView，见下图。

    当输入“C程”时，数据库中自动过滤出了还有该字符串的联系人姓名，并显示出来。

 

    二、Android做了哪些？

    1、为了实现数据的过滤，andorid设计了抽象类Filter，进行异步和同步的数据过滤操作。

    2、在Adapter中继承Filterable，提供给使用者Filter，进行过滤。

    3、在不同的View中，获得查询约束字符串，传递给Adapter，并且提供配合数据过滤的界面支持。

 

    三、Filter类

    Filter的使用流程如下：

    调用filter方法 ->在另一线程中调用performFiltering进行数据查询->得到数据过滤结果后调用publishResults将结果返回到使用它的客户端。

    该类中的performFiltering和publishResults均为抽象方法，需要继承者自己重写。

    CursorFilter类就是Filter类的继承。CursorFilter在performFiltering中并没有直接进行数据的过滤，而是 加入了CursorFilterClient成员，将过滤的操作转让给了CursorFilterClient,实际上CursorAdpater就是继 承了CursorFilterClient接口，也就是说过滤操作实际上是在CursorAdapter中执行的。

 

    四、Filterable接口

    常用的Adapter基本上都继承了Filterable接口，如CursorAdapter，ArrayAdapter，SimpleAdapter 等。该接口只有一个函数，名为getFilter，通过该函数可以通过Adaper获取Filter，然后通过该Filter进行过滤。

 

    在CursorAdapter中，可以更改过滤的流程，有两种方式：

    1、通过重写CursorAdapter的runQueryOnBackgroundThread函数，在函数中根据过滤约束字符串，重新查找生成新的Cursor。Adapter会适时将旧的Cursor进行替换。

    2、通过调用setFilterQueryProvider函数，提供一个FilterQueryProvider，该对象含有runQuery方法，作用同runQueryOnBackgroundThread方法相同。

    使用那种方法取决于您是不是重载CursorAdapter，以及您的过滤动作需要在Adpter中实现还是在主程序中实现。

 

    五、数据过滤功能的View的界面支持。

    为了实现数据过滤的功能，在数据显示层，也有相应的支持。比如ListView和GridView，设置了setFilterText函数，通过该函数 可以一方面进行数据的过滤，另一方面显示一个PopupWindow,提示用户输入了那种过滤条件。AutoCompleteTextView当用户在文 本框输入文字时，自动进行过滤，并弹出列表显示过滤数据。

 

    六、实战

    知道了Android的过滤机制，我们就以AutoCompleteTextView为例，通过输入文本筛选数据库中的数据。

    1、首先写ContentProvider
    由于代码量比较多，只写出对外的接口。

public
 
static
 
final
 
class
 Location 
implements
 BaseColumns {
    public
 
static
 
final
 Uri CONTENT_URI = Uri.withAppendedPath(AUTHORITY_URI, 
"location"
);
    public
 
static
 
final
 String CONTENT_TYPE = 
"vnd.android.cursor.dir/weather_location"
;
    public
 
static
 
final
 String CONTENT_ITEM_TYPE = 
"vnd.android.cursor.item/weather_location"
;
    public
 
static
 
final
 String CONTENT_DIRECTORY = 
"location"
;

    public
 
static
 
final
 String LOCATION_NAME = 
"location_name"
;
    public
 
static
 
final
 String LONGITUDE = 
"longitude"
;
    public
 
static
 
final
 String ALTITUDE = 
"altitude"
;
}

   2、写CursorAdapter

private
 
static
 
class
 LocationAdapter 
extends
 CursorAdapter {
    private
 LayoutInflater mInflater;
    private
 Context mContext;
    private
 Cursor mCursor;
    public
 LocationAdapter(Context context, Cursor c) {
        super
(context, c);
        mContext = context;
        mInflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    }

    @Override
    public
 
void
 bindView(View view, Context context, Cursor cursor) {
        TextView textView = (TextView) view;
        String location = cursor.getString(cursor.getColumnIndex(Location.LOCATION_NAME));
        textView.setText(location);
    }

    @Override
    public
 View newView(Context context, Cursor cursor, ViewGroup parent) {
        return
 mInflater.inflate(android.R.layout.simple_dropdown_item_1line, 
null
);
    }

    @Override
    public
 Cursor runQueryOnBackgroundThread(CharSequence constraint) {
        String selection = Location.LOCATION_NAME + " LIKE '%"
 + constraint + 
"%'"
;
        return
 mContext.getContentResolver().query(Location.CONTENT_URI
                , null
, selection, 
null
, 
null
);
    }

    /**一定要重写该方法，否则AutoCompleteTextView选中某一项后，文本框显示的不是所要的文本*/
    @Override
    public
 CharSequence convertToString(Cursor cursor) {
        return
 cursor.getString(cursor.getColumnIndex(Location.LOCATION_NAME));
    }
}

    3、AutoCompleteTextView与Adapter关联。

 

private
 
void
 initialTextView() {
    mTextView = new
 AutoCompleteTextView(mContext);
    mTextView.setThreshold(0
);

    Cursor cursor = mContext.getContentResolver().query(Location.CONTENT_URI
            , null
, 
null
, 
null
, 
null
);
    LocationAdapter adapter = new
 LocationAdapter(mContext, cursor);
    mTextView.setAdapter(adapter);
}

    需要提醒的是：AutoCompleteTextView内部的数据筛选并没用采用异步筛选的方式，而是直接调用了Filter内部的performFiltering,所以尽量不要在筛选的函数内做太费时间的事情，否则就乎出现不流畅的情况。

 

 

    Enjoy it！

 

对于短信搜索，是直接使用了Android系统的搜索框架，当然在我们平常做项目的时候，也可以直接调用系统自带的搜索框，这个具体的怎么调用可以用Google或者百度搜索，有许多相关的资料，现在主要记录下自己阅读短息搜索源码的流程以及遇到的问题。

1. 在ConversationList.java文件中有如下一段代码：

public
 
boolean
 onSearchRequested() { startSearch(
null
, 
false
, 
null
 
/*appData*/
, 
false
); 
return
 
true
;}

在这里是重写了Activity里的onSearchRequested（）方法，如果我们不想在这里面做一些操作的话，可以直接调用onSearchRequested（）方法。在onSearchRequested（）方法里是调用了startSearch（）方法。

2. 一直追踪下去可以追溯到SearchaDialog.java中。这里在搜索框中添加了一个Adapter，这个Adapter就是来显示下拉列表的，在 这个类中发现在runQueryOnBackgroundThread（）方法中还是回到了SearchManager的getSuggestions方 法中，根据相应的Uri， mContext.getContentResolver().query(uri, null, selection, selArgs, null);去查询相关的数据库。

3. 在短信搜索这里与之相关的Uri为SuggestionsProvider，最后还是到了MmsSmsProvider中去进行数据库查询操作。

4.在MmsSmsProvider中有条查询语句：String.format("SELECT _id, index_text, source_id, table_to_use, offsets(words) FROM words WHERE words MATCH '%s*' LIMIT 50;", searchString); 这里将通过这条SQL语句进行查询，将结果以Cursor的形式进行返回。

4. 在SuggestionsProvider，这边对cursor的内容进行提取，显示在下拉列表中。但是这里可能是Google留给广大厂商去解决，就是 SQLite中的 MATCH 并不能很好的匹配亚洲文字，如：汉字，韩语等。所以按照源码的话，这个短信搜索功能搜索英文还可以，但是搜索亚洲文字，则无法搜索出来。不知道以后 SQLite 会不会对 MATCH 增加对非字母文字的支持。

 

关于offsets（），的一些说明：

offsets（），返回一系列以空格隔开的整数，至少含有4为数（以4个整数为一组返回）。

对于这四位数的解释：

第0位：表示列号

第1位：表示在该列中该字符出现的次数

第2位：在该列中匹配项字符的偏移位 （bytes）

第3位：匹配项的大小（bytes）

offsets（）需要和MATCH配对使用。

关于MATCH（）

MATCH ： 如  MATCH 'Hi', 表示存在Hi的字符串，MATCH ‘Hi*’， 表示以Hi开头的字符串。

 

       Android为ListView提供了Filter对象，对显示的条目进行过滤。最常见的用法就是Contact中，根据在输入框中输入姓名 的字母显示过滤。当然android系统中默认提供的过滤功能非常有限，不支持号码或是其他信息过滤。我曾见过有人为了支持对号码的过滤，就将 Android提供的那套机制屏蔽掉，每当过滤事件发生时，手动起AsyncQueryHander去异步查询。当查询完毕时调用 CursorAdapter.changeCursor更新Cursor。虽然基本上做法没错，流程上也跟Android实现过滤的机制大体相同，但重复 了制造轮子的过程，而原有的轮子，只需稍加修改足以满足新的需求。
      我们只需要重写public Cursor runQueryOnBackgroundThread(CharSequence constraint)，或者实现接口FilterQueryProvider的对象，再将该对象setFilterQueryProvider给 CursorAdapter即可。
      下面分析下CursorAdapter与Filter的实现框架。
      先说下Filter：
      Filter与AsyncQueryHander实现基本类似，它包含两个Hander：RequestHandler和ResultHandler，以 及一个HandlerThread：名为Filter的线程。RequestHandler与Filter线程绑定，过滤请求都是通过 RequestHandler发送给Filter线程。当过滤产生后，通过mResultHandler将数据push给UI显示。
      CursorFilter继承Filter，它提供了CursorFilterClient接口，CursorAdapter实现 CursorFilterClient接口。CursorFilter会在过滤的某些点回调CursorFilterClient接口的对应函数，我们就 是通过这些被回调的函数，改变Filter的行为，以实现自己的目的。这与我们熟知的Activity生命周期上 的：onCreate->onResume->onPause......的做法类似。
      来看下这个重要的接口CursorFilterClient的定义
      interface CursorFilterClient {
        CharSequence convertToString(Cursor cursor);
        Cursor runQueryOnBackgroundThread(CharSequence constraint);
        Cursor getCursor();
        void changeCursor(Cursor cursor);
     }
     runQueryOnBackgroundThread是运行在Filter线程中，返回的Cursor将传给ResultHandler，最后传给UI 显示。所以上面的例子中，我们要添加对号码的查询，只需在这里自己组织下查询条件，包含对号码的查询，找数据库查询下，将查询结果返回即可。
     changeCursor在ResultHandler向UI送结果时被调用，通过它更新显示过滤后的数据。我们可以重载它，在过滤数据显示前，做点需要的事情（比如更新下SectionIndexer）。
     getCursor只是返回下Adapter中保存的Cursor，convertToString在CursorAdapter没有被用到，不管它了。