VOLLEY源码完全解析之RequestQueue

从RequestQueue开始:

  • 创建一个RequestQueue:
        mRequestQueue = Volley.newRequestQueue(getApplicationContext());

一般一个程序只需要一个请求队列,所以在Application中初始化RequestQueue是不错的用法。
newRequestQueue点进去可以看到,其实Volly类中主要封装了创建RequestQueue的几个重载方法,输入不同的参数可以配置不同RequestQueue。

   public static RequestQueue newRequestQueue(Context context, HttpStack stack, int maxDiskCacheBytes) {
        File cacheDir = new File(context.getCacheDir(), "volley");
        String userAgent = "volley/0";

        try {
            String packageName = context.getPackageName();
            PackageInfo info = context.getPackageManager().getPackageInfo(packageName, 0);
            userAgent = packageName + "/" + info.versionCode;
        } catch (NameNotFoundException var7) {
            ;
        }

        if(stack == null) {
            if(VERSION.SDK_INT >= 9) {
                stack = new HurlStack();
            } else {
                stack = new HttpClientStack(AndroidHttpClient.newInstance(userAgent));
            }
        }

        Network network = new BasicNetwork((HttpStack)stack);
        RequestQueue queue;
        if(maxDiskCacheBytes <= -1) {
            queue = new RequestQueue(new DiskBasedCache(cacheDir), network);
        } else {
            queue = new RequestQueue(new DiskBasedCache(cacheDir, maxDiskCacheBytes), network);
        }

        queue.start();
        return queue;
    }

这个方法里,首先配置一些缓存文件的信息和包的信息等。然后根据传入的参数stack,判断是否为NULL。在为NULL的情况下,根据当前SDK的版本,选择使用HttpURLConnection或者HttpClient作为底层的网络请求框架。(关于HttpURLConnection和HttpURLConnection的内容后面再进行介绍。
接着,通过stack创建Network接口的BasicNetwork对象,而该对象封装了进行http请求的一系列配置等。
最后,通过创建所得的Network对象和缓冲大小创建一个RequestQueue对象并返回。(注意queue.start()方法)。

  • RequestQueue的成员变量
    上面我们创建RequestQueue对象,那么这个RequestQueue对象的用处是?从字面上来将,它的意思是请求队列,事实上它的确维护着多个队列。点击去看一下:
    它成员变量有:
    private AtomicInteger mSequenceGenerator;
    private final Map<String, Queue<Request<?>>> mWaitingRequests;
    private final Set<Request<?>> mCurrentRequests;
    private final PriorityBlockingQueue<Request<?>> mCacheQueue;
    private final PriorityBlockingQueue<Request<?>> mNetworkQueue;
    private static final int DEFAULT_NETWORK_THREAD_POOL_SIZE = 4;
    private final Cache mCache;
    private final Network mNetwork;
    private final ResponseDelivery mDelivery;
    private NetworkDispatcher[] mDispatchers;
    private CacheDispatcher mCacheDispatcher;
    private List<RequestQueue.RequestFinishedListener> mFinishedListeners;

mSequenceGenerator:用于生成请求的单调递增序列号。使用AtomicInteger的原因是一种无锁的线程安全整数,减少了并发的消耗(不需要使用关键字synchronized)。
mWaitingRequests:重复缓存请求的暂存队列。
mCurrentRequests:也就是所有被执行中的或者等待中的请求对象。注意到它是一个set,即不允许有重复对象。
mCacheQueue:若创建request的时候允许被缓存,则会被放到该队列中,若不允许被缓存,则会被放到mNetworkQueue队列中。
mNetworkQueue:同上。
DEFAULT_NETWORK_THREAD_POOL_SIZE :默认网络线程数目。
Cache:缓存接口,可以实现该接口配置不同的缓存策略。
Network:上面提到的网络请求框架接口。也可以自己配置。
mDelivery:响应机制的接口,配置有关响应成功或者失败的操作信息。
mDispatchers:网络请求线程的数组,通过mNetworkQueue.take()方法取出响应的网络请求。
mCacheDispatcher:同上,只不过它是一条线程而不是一个数组。
mFinishedListeners:请求完成的响应队列。

  • RequestQueue的构造函数
    接下来看到RequestQueue的构造函数:
    public RequestQueue(Cache cache, Network network, int threadPoolSize, ResponseDelivery delivery) {
        this.mSequenceGenerator = new AtomicInteger();
        this.mWaitingRequests = new HashMap();
        this.mCurrentRequests = new HashSet();
        this.mCacheQueue = new PriorityBlockingQueue();
        this.mNetworkQueue = new PriorityBlockingQueue();
        this.mFinishedListeners = new ArrayList();
        this.mCache = cache;
        this.mNetwork = network;
        this.mDispatchers = new NetworkDispatcher[threadPoolSize];
        this.mDelivery = delivery;
    }

基本上就是对其成员变量的初始化。

  • start()方法
    继续往下看可以看到一个start()方法:
    public void start() {
        this.stop();
        this.mCacheDispatcher = new CacheDispatcher(this.mCacheQueue, this.mNetworkQueue, this.mCache, this.mDelivery);
        this.mCacheDispatcher.start();

        for(int i = 0; i < this.mDispatchers.length; ++i) {
            NetworkDispatcher networkDispatcher = new NetworkDispatcher(this.mNetworkQueue, this.mNetwork, this.mCache, this.mDelivery);
            this.mDispatchers[i] = networkDispatcher;
            networkDispatcher.start();
        }

    }

从表面上看,start()方法其实就是将执行缓存任务的线程和执行网络任务的线程start()了。所以以CacheDispatcher为例,分析其任务执行线程做了什么工作。

   public void run() {
        if(DEBUG) {
            VolleyLog.v("start new dispatcher", new Object[0]);
        }

        Process.setThreadPriority(10);
        this.mCache.initialize();

        while(true) {
            while(true) {
                while(true) {
                    while(true) {
                        try {
                            while(true) {
                                final Request<?> request = (Request)this.mCacheQueue.take();
                                request.addMarker("cache-queue-take");
                                if(request.isCanceled()) {
                                    request.finish("cache-discard-canceled");
                                } else {
                                    Entry entry = this.mCache.get(request.getCacheKey());
                                    if(entry == null) {
                                        request.addMarker("cache-miss");
                                        this.mNetworkQueue.put(request);
                                    } else if(entry.isExpired()) {
                                        request.addMarker("cache-hit-expired");
                                        request.setCacheEntry(entry);
                                        this.mNetworkQueue.put(request);
                                    } else {
                                        request.addMarker("cache-hit");
                                        Response<?> response = request.parseNetworkResponse(new NetworkResponse(entry.data, entry.responseHeaders));
                                        request.addMarker("cache-hit-parsed");
                                        if(entry.refreshNeeded()) {
                                            request.addMarker("cache-hit-refresh-needed");
                                            request.setCacheEntry(entry);
                                            response.intermediate = true;
                                            this.mDelivery.postResponse(request, response, new Runnable() {
                                                public void run() {
                                                    try {
                                                        CacheDispatcher.this.mNetworkQueue.put(request);
                                                    } catch (InterruptedException var2) {
                                                        ;
                                                    }

                                                }
                                            });
                                        } else {
                                            this.mDelivery.postResponse(request, response);
                                        }
                                    }
                                }
                            }
                        } catch (InterruptedException var4) {
                            if(this.mQuit) {
                                return;
                            }
                        }
                    }
                }
            }
        }
    }

可以看到,该线程的RUN方法中有多死个循环,先看最里层的。
首先调用mCacheQueue.take()方法取出请求对象,而这个mCacheQueue之前提过,是一个BlockingQueue,即阻塞队列。其take()方法为从队列中取得对象,如果队列不存在对象,将会被阻塞,直到队列中存在有对象。这就使得在节约系统资源的情况下,RequestQueue只需要start一次就够了。
接着设置DEBUG的一些信息和检查该请求是否被取消。并且,由于这个是缓存任务的执行线程,将会在缓存信息中查找之前是否有缓存该任务的信息,如果有,缓存命中,判断是否过期。所以未命中的和缓存过期的都会被放到mNetworkQueue中执行,否则,直接从缓存实体对象entry中取出数据进行解析并分发。同时,如果是软命中缓存的话,虽然提供缓存数据的响应,但仍需要加入mNetworkQueue中重写执行请求以刷新内容。
分析下来,其实这里并不需要多层死循环,并且我在其他版本的volley源码中也有只有一层的循环的情况,所以这里的用意我不大明确。

  • cancelAll()方法
    回到RequestQueue中,先看个简单cancelAll方法:
    public void cancelAll(RequestQueue.RequestFilter filter) {
        Set var2 = this.mCurrentRequests;
        synchronized(this.mCurrentRequests) {
            Iterator var4 = this.mCurrentRequests.iterator();

            while(var4.hasNext()) {
                Request<?> request = (Request)var4.next();
                if(filter.apply(request)) {
                    request.cancel();
                }
            }

        }
    }

取消过滤出来的请求,其另一个重载方法则是直接将filter设置为tag是否一致。(在python中则是直接一个lambda搞定)。

  • add()方法
    其实在我们使用volley的时候,通过在创建出Request之后,将它添加进RequestQueue中就完事,并不需要手动去开启请求,那么Volley是如何做到的呢。
    public <T> Request<T> add(Request<T> request) {
        request.setRequestQueue(this);
        Set var2 = this.mCurrentRequests;
        synchronized(this.mCurrentRequests) {
            this.mCurrentRequests.add(request);
        }

        request.setSequence(this.getSequenceNumber());
        request.addMarker("add-to-queue");
        if(!request.shouldCache()) {
            this.mNetworkQueue.add(request);
            return request;
        } else {
            Map var7 = this.mWaitingRequests;
            synchronized(this.mWaitingRequests) {
                String cacheKey = request.getCacheKey();
                if(this.mWaitingRequests.containsKey(cacheKey)) {
                    Queue<Request<?>> stagedRequests = (Queue)this.mWaitingRequests.get(cacheKey);
                    if(stagedRequests == null) {
                        stagedRequests = new LinkedList();
                    }

                    ((Queue)stagedRequests).add(request);
                    this.mWaitingRequests.put(cacheKey, stagedRequests);
                    if(VolleyLog.DEBUG) {
                        VolleyLog.v("Request for cacheKey=%s is in flight, putting on hold.", new Object[]{cacheKey});
                    }
                } else {
                    this.mWaitingRequests.put(cacheKey, (Object)null);
                    this.mCacheQueue.add(request);
                }

                return request;
            }
        }
    }

可以看到,每个请求首先会被加入,mCurrentRequests队列中,正如我们前面所说的,mCurrentRequests是所以被执行或者等待中的请求的集合。接着,根据请求是否需要缓存,分别被加入了mNetworkQueue和mCacheQueue,而mWaitingRequests中则维护了具有相同的cacheKey中所有请求的队列。
到这里仍没有解释为什么VOLLEY不需要手动去开启请求。但是其实,上面有讲到mCacheQueue和mNetworkQueue是一个BlockingQueue,在响应的执行线程中通过调用take()方法取得任务或者阻塞线程,我们把请求放进去的时候后,若请求执行线程有空的时候,请求就会被取出并执行。

  • finish()方法
    当请求完成后,我们需要从中取得回调数据,finish()方法就是处理这一块的函数。
   <T> void finish(Request<T> request) {
        Set var2 = this.mCurrentRequests;
        synchronized(this.mCurrentRequests) {
            this.mCurrentRequests.remove(request);
        }

        List var8 = this.mFinishedListeners;
        synchronized(this.mFinishedListeners) {
            Iterator var4 = this.mFinishedListeners.iterator();

            while(true) {
                if(!var4.hasNext()) {
                    break;
                }

                RequestQueue.RequestFinishedListener<T> listener = (RequestQueue.RequestFinishedListener)var4.next();
                listener.onRequestFinished(request);
            }
        }

        if(request.shouldCache()) {
            Map var9 = this.mWaitingRequests;
            synchronized(this.mWaitingRequests) {
                String cacheKey = request.getCacheKey();
                Queue<Request<?>> waitingRequests = (Queue)this.mWaitingRequests.remove(cacheKey);
                if(waitingRequests != null) {
                    if(VolleyLog.DEBUG) {
                        VolleyLog.v("Releasing %d waiting requests for cacheKey=%s.", new Object[]{Integer.valueOf(waitingRequests.size()), cacheKey});
                    }

                    this.mCacheQueue.addAll(waitingRequests);
                }
            }
        }

    }

首先,完成的请求将会被从mCurrentRequests移除,遍历请求队列中所有的完成回调接口,并执行每个listener的回调方法。最后,如果请求可以缓存,在将其从mWaitingRequests中移除,并且将与该请求具有相同cacheKey的请求移入mCacheQueue中处理。以提高处理效率。

小结

到这里,RequestQueue就基本讲完了,对其也有了个大概的了解。下一篇文章计划解析Request类。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,701评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,649评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,037评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,994评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,018评论 6 395
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,796评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,481评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,370评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,868评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,014评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,153评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,832评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,494评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,039评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,156评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,437评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,131评论 2 356

推荐阅读更多精彩内容