Android 异步任务知识梳理(3) AsyncQueryHandler 源码解析

最新推荐文章于 2025-08-23 20:56:03 发布

weixin_34128411

最新推荐文章于 2025-08-23 20:56:03 发布

阅读量78

点赞数

CC 4.0 BY-SA版权

文章标签：移动开发

原文链接：https://juejin.im/post/5a30fa926fb9a0450e761d3e

本文深入解析AsyncQueryHandler的工作原理，包括其内部结构、消息传递机制及如何利用HandlerThread实现异步操作，尤其针对ContentProvider的增删改查进行了详细说明。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、概述

AsyncQueryHandler方便了我们对ContentProvider进行增、删、改、查，此外，我们通过学习它的原理可以更好地理解HandlerThread，学习如何在项目中使用它。

二、源码

AsyncQueryHandler中的关键是mWorkerThreadHandler，它在其handleMessage中进行操作，因为它在构造时传入的Looper所关联的Thread并不是主线程，因此所有在handleMessage中的操作都是异步的，这个变量的初始化时在其构造函数中：

public AsyncQueryHandler(ContentResolver cr) {    
    super();    
    mResolver = new WeakReference<ContentResolver>(cr);    
    synchronized (AsyncQueryHandler.class) {        
        if (sLooper == null) {            
            HandlerThread thread = new HandlerThread("AsyncQueryWorker");            
            thread.start();            
            sLooper = thread.getLooper();        
        }    
    }    
    mWorkerThreadHandler = createHandler(sLooper);
}

protected Handler createHandler(Looper looper) {    
    return new WorkerHandler(looper);
}
复制代码

可以看到sLooper只有在第一次实例化AsyncQueryHandler才会生成，因此当我们采用默认实现时，并且在多个地方实例化不同的AsyncQueryHandler对象，每个对象对应的是不同的WorkerHandler，但是 WorkerHandler关联到的是同一个Looper，我们通过它执行的所有任务是放在一个队列当中顺序执行的。如果我们不希望运行在默认的Looper中，那么也可以通过重写createHandler来传入一个另外的 Looper。因为AsyncQueueHandler的增、删、改、查的原理都是相同的，因此我们单独看一下增加的操作，就可以理解它的思想了：

public final void startInsert(int token, Object cookie, Uri uri, ContentValues initialValues) {     
    Message msg = mWorkerThreadHandler.obtainMessage(token);    
    msg.arg1 = EVENT_ARG_INSERT;    
    WorkerArgs args = new WorkerArgs();    
    args.handler = this;    
    args.uri = uri;    
    args.cookie = cookie;    
    args.values = initialValues;    
    msg.obj = args;    
    mWorkerThreadHandler.sendMessage(msg);
}

protected class WorkerHandler extends Handler {    
    public WorkerHandler(Looper looper) {         
        super(looper);    
    }
    public void handleMessage(Message msg) {
        final ContentResolver resolver = mResolver.get();
        if (resolver == null) return;
        WorkerArgs args = (WorkerArgs) msg.obj;
          int token = msg.what;
          int event = msg.arg1;
          switch (event) {
              case EVENT_ARG_INSERT:    
                  args.result = resolver.insert(args.uri, args.values);    
                  break;
          }
          Message reply = args.handler.obtainMessage(token);
          reply.obj = args;
          reply.arg1 = msg.arg1;
          reply.sendToTarget();
    }
}

@Override
public void handleMessage(Message msg) {    
    WorkerArgs args = (WorkerArgs) msg.obj;
    int token = msg.what;
    int event = msg.arg1;
    switch (event) {
        case EVENT_ARG_INSERT:    
            onInsertComplete(token, args.cookie, (Uri) args.result);    
            break;
    }
}
复制代码

当我们调用了插入方法之后，整个过程如下：

mWorkerThreadHandler发送一条消息，该消息当中带有插入相关的所有参数以及**AsyncQueryHandler子类的实例**。
在mWorkderThreadHanlder的handleMessage中，它调用ContentResolver的对应插入方法进行插入，它和mWorkderThreadHandler关联的Looper是运行在同一个线程当中的。
插入完毕之后，通过消息当中传入的AsyncQueryHandler子类的实例将执行的结果发送回去，在其AsyncQueryHandler的handleMessage(Message message)方法中，回调抽象方法onInsertComplete(token, args.cookie, (Uri) args.result)，子类通过实现该方法来获取执行的结果。