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,因为实际开发中,也没怎么用到这个适配器。后续博客会再对这个适配器做详细的介绍。



原文地址:https://www.cnblogs.com/wanghang/p/6299562.html