参考别人的分析对于Volley的理解（一）

痛定思痛。 2022-08-20 14:08 140阅读 0赞

最近由于自己对于Android学习的深入，我发现自己对于Java的编码风格，Android的编码格式等需要有比较迫切的提升，所以我决定从别人的优良库入手，去学习别人的代码是怎么写的。这一次，我选择了Volley库，也是我经常使用的网络库，因为经常有人问我它的原理，而我答得并不是很好。我参考的是 [Volley解析][Volley] 这篇文章。

### 基本介绍 ###

Volley 是 Google 推出的 Android 异步网络请求框架和图片加载框架。在 Google I/O 2013 大会上发布。volley的中文意思是群发，齐射，表明了Volley比较擅长大量迸发的网络请求，特别适合数据量小，通信频繁的网络操作。

### 主要特点 ###

从别人的文章可以看到，Volley的一些总结性的特点，我这里就直接搬运过来了：  
1. 扩展性强。Volley 中大多是基于接口的设计，可配置性强。  
2. 一定程度符合 Http 规范，包括返回 ResponseCode(2xx、3xx、4xx、5xx）的处理，请求头的处理，缓存机制的支持等。并支持重试及优先级定义。  
3. 默认 Android2.3 及以上基于 HttpURLConnection，2.3 以下基于 HttpClient 实现。  
4. 提供简便的图片加载工具。

### 结构图 ###

![这里写图片描述][20160302102945535]

上面是 Volley 的总体设计图（也是直接从别人那里拿来的），主要是通过两种Dispatch Thread不断从RequestQueue中取出请求，根据是否已缓存调用Cache或Network这两类数据获取接口之一，从内存缓存或是服务器取得请求的数据，然后交由ResponseDelivery去做结果分发及回调处理。大致的结构就是上图的4个层。

### Volley的主要概念 ###

Volley 的调用比较简单，通过 newRequestQueue(…) 函数新建并启动一个请求队列RequestQueue后，只需要往这个RequestQueue不断 add Request 即可。一般情况下，都是在整个应用中创建一个队列，然后所有的请求都可以加到这个队列里。  
Request：表示一个请求的抽象类。StringRequest、JsonRequest、ImageRequest 都是它的子类，表示某种类型的请求。它实现了Comparable接口，重写了CompareTo()方法，用来比较请求的优先级。  
RequestQueue：表示请求队列，里面包含一个CacheDispatcher(用于处理走缓存请求的调度线程)、NetworkDispatcher数组(用于处理走网络请求的调度线程)，一个ResponseDelivery(返回结果分发接口)，通过 start() 函数启动时会启动CacheDispatcher和NetworkDispatchers。  
CacheDispatcher：一个线程类，用于调度处理走缓存的请求。启动后会不断从缓存请求队列中取请求处理，队列为空则等待，请求处理结束则将结果传递给ResponseDelivery去执行后续处理。当结果未缓存过、缓存失效或缓存需要刷新的情况下，该请求都需要重新进入NetworkDispatcher去调度处理。  
NetworkDispatcher：一个线程类，用于调度处理走网络的请求。启动后会不断从网络请求队列中取请求处理，队列为空则等待，请求处理结束则将结果传递给ResponseDelivery去执行后续处理，并判断结果是否要进行缓存。  
ResponseDelivery：一个接口类，返回结果分发接口，目前只有基于ExecutorDelivery的在入参 handler 对应线程内进行分发。  
HttpStack：一个接口类，处理 Http 请求，返回请求结果。目前 Volley 中有基于 HttpURLConnection 的HurlStack和 基于 Apache HttpClient 的HttpClientStack。  
Network：一个接口类，调用HttpStack处理请求，并将结果转换为可被ResponseDelivery处理的NetworkResponse。  
Cache：一个接口类。缓存请求结果，Volley 默认使用的是基于 sdcard 的DiskBasedCache。NetworkDispatcher得到请求结果后判断是否需要存储在 Cache，CacheDispatcher会从 Cache 中取缓存结果。

### Volley 请求流程图 ###

![这里写图片描述][20160302135043686]

这里使用的是Volley 请求时的流程图的中文译版，也同样使用的是我所学习参考的网页上的内容。

看了这个图，目前的我还有一个疑问，就是从缓存中读取的相应并解析，那么这个解析结果是缓存在本地的吗，如果是这样，相同的请求请求多次可能会有不同的结果这种情况该怎么避免呢？这个问题我先提出来，放到后面来进行解决。

### 详细类关系图 ###

![这里写图片描述][20160302140856359]

![这里写图片描述][20160302155507424]

![这里写图片描述][20160302155527003]

图中红色圈内的部分，组成了 Volley 框架的核心，围绕 RequestQueue 类，将各个功能点以组合的方式结合在了一起。各个功能点也都是以接口或者抽象类的形式提供。  
红色圈外面的部分，在 Volley 源码中放在了 toolbox 包中，作为 Volley 为各个功能点提供的默认的具体实现。  
通过类图我们看出， Volley 有着非常好的拓展性。通过各个功能点的接口，我们可以给出自定义的，更符合我们需求的具体实现。  
多用组合，少用继承；针对接口编程，不针对具体实现编程。这个框架很值得我学习。

### 具体类介绍 ###

#### Volley.java ####

这个和 Volley 框架同名的类，其实是个工具类，作用是构建一个可用于添加网络请求的RequestQueue对象。一般都是在程序初始化时去调用这个新建队列的方法。  
(1). 主要函数  
Volley.java 有四个重载的静态方法。

newRequestQueue(Context context, HttpStack stack, int maxDiskCacheBytes)
    
    newRequestQueue(Context context, int maxDiskCacheBytes)
    
    newRequestQueue(Context context, HttpStack stack)
    
    newRequestQueue(Context context)

根据代码中的内容，可以看出这个几个函数其实最终都是调用了newRequestQueue(Context context, HttpStack stack, int maxDiskCacheBytes)这个函数。  
这个函数完整如下：

/**
         * Creates a default instance of the worker pool and calls {@link RequestQueue#start()} on it.
         * You may set a maximum size of the disk cache in bytes.
         *
         * @param context A {@link Context} to use for creating the cache dir.
         * @param stack An {@link HttpStack} to use for the network, or null for default.
         * @param maxDiskCacheBytes the maximum size of the disk cache, in bytes. Use -1 for default size.
         * @return A started {@link RequestQueue} instance.
         */
        public static RequestQueue newRequestQueue(Context context, HttpStack stack, int maxDiskCacheBytes) {
            File cacheDir = new File(context.getCacheDir(), DEFAULT_CACHE_DIR);
    
            String userAgent = "volley/0";
            try {
                String packageName = context.getPackageName();
                PackageInfo info = context.getPackageManager().getPackageInfo(packageName, 0);
                userAgent = packageName + "/" + info.versionCode;
            } catch (NameNotFoundException e) {
            }
    
            if (stack == null) {
                if (Build.VERSION.SDK_INT >= 9) {
                    stack = new HurlStack();
                } else {
                    // Prior to Gingerbread, HttpUrlConnection was unreliable.
                    // See: http://android-developers.blogspot.com/2011/09/androids-http-clients.html
                    stack = new HttpClientStack(AndroidHttpClient.newInstance(userAgent));
                }
            }
    
            Network network = new BasicNetwork(stack);
    
            RequestQueue queue;
            if (maxDiskCacheBytes <= -1)
            {
                // No maximum size specified
                queue = new RequestQueue(new DiskBasedCache(cacheDir), network);
            }
            else
            {
                // Disk cache size specified
                queue = new RequestQueue(new DiskBasedCache(cacheDir, maxDiskCacheBytes), network);
            }
    
            queue.start();
    
            return queue;
        }

我们平时大多采用Volly.newRequestQueue(context)的默认实现，构建 RequestQueue。  
以上是主要参考的别人的Volley的基本简介，这只是Volley的一个大概的介绍，后面将会对具体的类进行分析，我将努力把我看见的转变成文字，希望自己能够把问题描述的更清楚。

[Volley]: http://a.codekk.com/detail/Android/grumoon/Volley%20%E6%BA%90%E7%A0%81%E8%A7%A3%E6%9E%90
[20160302102945535]: /images/20220731/7fe6960e436941838c4c87088995d0b4.png
[20160302135043686]: /images/20220731/36edde1fb4fc4b8098bbfafbc883063e.png
[20160302140856359]: /images/20220731/262fe023809b4b67a215db620986959b.png
[20160302155507424]: /images/20220731/d28219f8ce684e0f8d98828b42739356.png
[20160302155527003]: /images/20220731/5262d7a0cade40e3baa0793e7beadb31.png