Android 异步查询框架AsyncQueryHandler的使用

AsyncQueryHandler简介:

异步的查询操作帮助类，可以处理增删改(ContentProvider提供的数据)

使用场景:

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

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

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

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

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

AsyncQueryHandler内部实现

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

API中提供

startInsert,

startDelete,

startUpdate,

startQuery四种方法,并有响应的onXXXComplete()方法.于对应的4个onXXXComplete()方法都是空实现,因此我们完成相应调用后进行后续其他的操作.

使用方法

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

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

token,一个令牌，主要用来标识查询,保证唯一即可.需要跟onXXXComplete方法传入的一致。（当然你也可以不一致，同样在数据库的操作结束后会调用对应的onXXXComplete方法 ）。当你使用很多次查询的时候，这个值就相当于绑定了你的查询方法。

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

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

projection 查询的列

selection 限制条件

selectionArgs 查询参数

orderBy 排序条件

下面简单介绍一下查询操作，如果查询操作熟悉了，其他的也就迎刃而解了。

例如，我要查询一下我手机里面有多少视频文件，以及对应的视频文件的名称、视频占用内存、视频时长，以及路径。按照以往的方式，我们会这么写：

List<VideoInfo> videoDatas = new ArrayList<VideoInfo>();

/*//参数：url、查询哪些列、选择条件占位符、选择条件占位符？用什么替换、查询后排序方式
Cursor cursor = context.getContentResolver().query(Media.EXTERNAL_CONTENT_URI,
new String[]{Media.TITLE,//视频名称
Media.SIZE,Media.DURATION,Media.DATA},//大小、时长、视频路径
null, null, null);
while(cursor.moveToNext()){
VideoInfo videoInfo = new VideoInfo();
String title = cursor.getString(cursor.getColumnIndex(Media.TITLE));
int size = cursor.getInt(cursor.getColumnIndex(Media.SIZE));
int duration = cursor.getInt(cursor.getColumnIndex(Media.DURATION));
String path = cursor.getString(cursor.getColumnIndex(Media.DATA));;

videoInfo.setDuration(duration);
videoInfo.setPath(path);
videoInfo.setSize(size);
videoInfo.setTitle(title);
videoDatas.add(videoInfo);
}

很显然，以前的方式就是内容提供者查询数据库操作。外界如果想要获取这些信息，是需要开启Handler---Thread的，如下：

new Thread(new Runnable() {

@Override
public void run() {
// 获取数据
videDatas = MediaInfoEngine.getVideoInfo(UIUtils.getContext());
UIUtils.runOnUiThread(new Runnable() {

@Override
public void run() {
adapter.notifyDataSetChanged();
}
});
}
}).start();

这样就获取到了手机所有视频文件信息了。但是，如果你手机里有1万条视频文件，这个时候，即使使用这种方式，估计上边业报ANR了。这个时候，AsyncQueryHandler帮我们解决很多问题，因为它已经自动帮我们封装了子线程。提供子线程DB操作，然后回调到主线程UI操作。写法如下：

AsyncQueryHandler queryHandler = new AsyncQueryHandler(context.getContentResolver()) {
/**查询的响应回调*/
@Override
protected void onQueryComplete(int token, Object cookie,
Cursor cursor) {
if(token == 1){
while(cursor.moveToNext()){
VideoInfo videoInfo = new VideoInfo();
String title = cursor.getString(cursor.getColumnIndex(Media.TITLE));
int size = cursor.getInt(cursor.getColumnIndex(Media.SIZE));
int duration = cursor.getInt(cursor.getColumnIndex(Media.DURATION));
String path = cursor.getString(cursor.getColumnIndex(Media.DATA));;

videoInfo.setDuration(duration);
videoInfo.setPath(path);
videoInfo.setSize(size);
videoInfo.setTitle(title);
videoDatas.add(videoInfo);
}
}
}
};

/**启动异步查询*/
//参数一：请求码
queryHandler.startQuery(1, null, Media.EXTERNAL_CONTENT_URI,
new String[]{Media.TITLE,//视频名称
Media.SIZE,Media.DURATION,Media.DATA},//大小、时长、视频路径
null, null, null);

具体的参数，在开篇就介绍的很详细了。简单说一下如何操作的：首先执行开始查询操作startQuary()，这个方法给我们封装好了，是在子线程执行的，在它内部自定查询完毕后会生成一个curssor对象，回调内部类里面的onQueryComplete方法，这个方法的三个参数分别是：1：请求码（可以想一下intent隐式启动的那个请求码的意思）2：执行startQuary()时候，第二参数。一般传入null，但是有时候会是某个对象（场景：AsyncQueryHandler与CursorAdapter结合使用的时候，这里就可以传入一个curssorAdapter对象，在回到方法里面就可以接收这个对象。回想message的obj字段）3：startQuary()方法查询数据库后所有返回的结果游标。接下来就很简单了，遍历cursor保存数据即可了。

这个时候，我们获取数据的时候，也就不用自己开启线程了。直接获取即可，如下：

// 获取数据，不用再开启你子线程了
videDatas = MediaInfoEngine.getVideoInfo(UIUtils.getContext());
adapter.notifyDataSetChanged();

这里我没有用到CursorAdapter，因为实际开发中，也没怎么用到这个适配器。后续博客会再对这个适配器做详细的介绍。