AsyncQueryHandler和CursorAdapter的使用

AsyncQueryHandler

A helper class to help make handling asynchronous ContentResolver queries easier.

一个助手类来帮助简化处理异步ContentResolver查询。

AsyncQueryHandler 的使用场景:

     在一般的应用中可以使用ContentProvider去操作数据库。

     这在数据量很小的时候是没有问题的，但是如果数据量大了，可能导致UI线程发生ANR异常(超过5秒)。

     当然你也可以写个Handler去做这些操作，只是你每次使用ContentProvider时都要再写个Handler，必然降低了效率。

     因此当数据量较大时，最好还是使用Android已经封装好的异步查询框架AsyncQueryHandler,优化我们的代码.

     要注意的是,一般在查询本地的应用的数据的时候要去采用CursorAdapter。

AsyncQueryHandler 的内部实现

     AsyncQueryHandler类封装了调用者线程与工作线程的交互过程。交互的主体是两个Handler，一个运行在调用者线程中，一个运行在工作者线程中。通过提供onXXXComplete的回调接口，实现事件的完成处理。

AsyncQueryHandler  的使用方法

      新建一个类继承AsyncQueryHandler类，并提供onXXXComplete方法的实现（可以实现任何一个或多个，当然你也可以一个也不实现，如果你不关注操作数据库的結果），在你的实现中做一些对数据库操作完成的处理。

     使用时直接调用startXXX方法即可。传入的通用参数如下：

              token,一个令牌，主要用来标识查询,保证唯一即可.需要跟onXXXComplete方法传入的一致。（当然你也可以不一致，同样在数据库的操作结束后会调用对应的onXXXComplete方法 ）

              COOKIE,你想传给onXXXComplete方法使用的一个对象。(没有的话传递null即可)

              Uri uri（进行查询的通用资源标志符）:

              projection 查询的列

              selection  限制条件

              selectionArgs 查询参数

              orderBy 排序条件

     在调用完该方法后，会异步进行相对应的操作，在完成操作后，会回调onQueryComplete(int token, Object COOKIE, Cursor cursor)该方法。通常在该方法中将返回的cursor设置给adapter，也可以在该方法中设置一些监听，来进行相应操作。

/**
* 异步的查询操作帮助类，可以处理增删改(ContentProvider提供的数据)
* @author HelloWorld
*
*/
public class CommonQueryHandler extends AsyncQueryHandler{

    public CommonQueryHandler(ContentResolver cr) {
        super(cr);
    }

    /**
     * 当查询完成后，回调的方法
     */
    @Override
    protected void onQueryComplete(int token, Object COOKIE, Cursor cursor) {

        // 判断传入的COOKIE是否是CursorAdapter
        if(COOKIE!=null && COOKIE instanceof CursorAdapter){
            CursorAdapter adapter = (CursorAdapter) COOKIE;
            //将查询返回的cursor设置给adapter
            adapter.changeCursor(cursor);
        }
       
        //触发监听事件
        if(cursorChangedListener!=null){
            cursorChangedListener.onCursorChanged(token, COOKIE, cursor);
        }
    }
   
   
    public OnCursorChangedListener getCursorChangedListener() {
        return cursorChangedListener;
    }

    public void setOnCursorChangedListener(OnCursorChangedListener cursorChangedListener) {
        this.cursorChangedListener = cursorChangedListener;
    }

    private OnCursorChangedListener cursorChangedListener;
   
    /**
     * 定义cursor改变时的事件监听
     * @author leo
     *
     */
    public interface OnCursorChangedListener{
        void onCursorChanged(int token, Object COOKIE, Cursor cursor);
    }
}

CursorAdapter

Adapter that exposes data from a Cursor to a ListView widget. The Cursor must include a column named "_id" or this class will not work.

通过该类可以用Cursor的方式访问数据库，并将查询出来的数据展示到列表视图(ListView)部件上。其中游标携带的结果集中必须有列名为“_id”的列，否则这个类无法工作。

AsyncQueryHandler 和 CursorAdapter的使用