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”的列，否则这个类无法工作。

CursorAdapter常用方法:

　　public CursorAdapter (Context context, Cursor c)

　　CursorAdapter的构造方法，第一个参数传入上下文，第二个参数通常传入null

　　public abstract View newView (Context context, Cursor cursor, ViewGroup parent)

　　Makes a new view to hold the data pointed to by cursor.

　　一般在此进行ListView的ItemView的初始化，和其中控件的初始化

　　public abstract void bindView (View view, Context context, Cursor cursor)

　　Bind an existing view to the data pointed to by cursor

　　在此对ItemView的控件进行数据绑定，可以通过cursor直接获取到需要查询的数据