你的位置:首页 > 操作系统

[操作系统]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”的列,否则这个类无法工作。