Android 学习笔记之Volley开源框架解析（一）

PS：看完了LGD的六场比赛...让人心酸...

学习内容：

1.Http请求的过程...

2.Volley的简单介绍...

 

1.Http请求...

  这里只是简单的说一下Http请求的过程...非常的简单...首先是发送Request..然后服务器在获取到Request请求后会对其进行相应的处理，然后以Response的形式进行返回，然后分配Response，即谁发送的请求，那么响应就分配给谁...

2.Volley简单介绍...

  这里只是先简单的说一下Volley，Volley框架是由Google发布的一款开源框架...这个框架主要是针对网络请求而包装生成的开源框架...主要功能是异步的网络请求和图片的加载，适用于Android这种请求频繁而每次请求数据量并不是很大的这一类网络请求...通过源码能够发现Volley有非常好的扩展性，更多的地方采用接口的设计...所以我们都可以自己重写内部的一些方法...总体的设计思路也是非常的明确的...

  客户端如果想通过网络连接来连接服务器，那么首先需要发送相关请求...每一个请求都需要被建立，那么建立请求的类就靠Request.java来实现...

  Request.java(源码解析)

  简单的说说Request.java，这是Volley的最核心的类，Request.java不仅仅封装了Request请求，还包括对服务器返回的Response的数据信息进行相应的处理..总之Request.java是一个最大的父类，内部封装了非常多的方法...其他的几个子类都是通过继承Request.java从而实现自己的功能...Request只是对外提供了一个接口，任何方式的请求只需要实现接口就能够实例化自己的请求对象，创建自己内部的方法..从而形成一种良好的扩展...

  凡是继承了Request.java必须要实现的一个方法...

abstract protected Response<T> parseNetworkResponse(NetworkResponse response);

   这个方法是对网络服务器响应的一个解析过程..也是最后由这个函数通过postResponse方法，将Response传递给ResponseDelivery从而对响应进行分发，不难理解，在每一个Request中实现这个方法，那么也就能够知道是谁发出的请求，这样在分发响应的时候也就不会产生错误...

  2.1 public void addMarker(String tag){}函数...

 public void addMarker(String tag) {
        if (MarkerLog.ENABLED) {
            mEventLog.add(tag, Thread.currentThread().getId());
        } else if (mRequestBirthTime == 0) {
            mRequestBirthTime = SystemClock.elapsedRealtime();
        }
    }

  addMarker函数，其实是就是一个标志，这个函数可以为每一个request添加相应事件标识符，这样我们就可以通过捕获标识符的方式从而对每一个request做进一步的操作.

  比如说一个网络请求从请求队列取出的标识：request.addMarker("network-queue-take");

        一个请求被取消的标识：request.addMarker("network-discard-cancelled");

  在Volley中很容易看到这些标识，他们的存在就是为了捕获每一个请求的发生状态，通过捕获这些状态，比如说一个请求已经完成，那么我们捕获到了请求完成之后，我们就需要将这次请求从请求队列当中移除，那么这个操作的执行就需要首先捕获到请求的状态，我们才能够采取下一步的操作...总之就是通过标识才能够清楚的了解请求到底执行到了何种状态...

  2.2 以下几个函数完成实体部分(Body)中验证参数的传递以及编码过程...

  2.2.1 public byte[] getPostBody() throws AuthFailureError{}

        public byte[] getBody() throws AuthFailureError{}

public byte[] getPostBody() throws AuthFailureError {
        // Note: For compatibility with legacy clients of volley, this implementation must remain
        // here instead of simply calling the getBody() function because this function must
        // call getPostParams() and getPostParamsEncoding() since legacy clients would have
        // overridden these two member functions for POST requests.
        Map<String, String> postParams = getPostParams();
        if (postParams != null && postParams.size() > 0) {
            return encodeParameters(postParams, getPostParamsEncoding());
        }
        return null;
    }

 public byte[] getBody() throws AuthFailureError {
        Map<String, String> params = getParams();
        if (params != null && params.size() > 0) {
            return encodeParameters(params, getParamsEncoding());
        }
        return null;
    }

   这两个函数想必大家看函数名称估计都能明白到底是怎么回事了，只不过这里有个小小的区别...第一个方法仅仅是对Post请求方式中Body实体部分的获取，而第二个是对Post或Put请求方式中Body实体部分的获取...

  我们知道网络请求时，信息是以数据报的形式进行传递的，数据报有头部(Headers)和实体(Body)部分...实体一般都是封装着想要发送的数据以及验证信息...因此想要获取Body中的实体数据就必须要通过某种方法来获取原生态的实体数据（Body）...获取了实体数据之后，就可以提交验证以及发送数据...那么上面两个函数就是用来解决这个问题的...

  我们可以从源码看到，二者分别调用getParams()和getPostParams()函数...

  2.2.2 protected Map<String,String> getPostParams() throws AuthFailureError{}

        protected Map<String,String> getParams() throws AuthFailureError{}

protected Map<String, String> getPostParams() throws AuthFailureError {
        return getParams();
    }

protected Map<String, String> getParams() throws AuthFailureError {
        return null;
    }

  这两个方法就是获取数据报中Body用于验证或授权时传递的参数，通过源码我们可以看到，方法的返回值是空值，这也不难理解，如果客户端想要完成验证和授权，必须要由客户端发送验证数据，通过对客户端验证数据信息的抓取，接着应用程序重写上面的两个方法，客户端的验证数据信息被封装到这两个方法内，这样服务器就可以真正的获取到客户端提交的信息了..来张图片方便大家理解...

  这里还涉及到了一个参数的编码...通过调用encodeParamters()方法...

  2.2.3 private byte[] encodeParameters(Map<String,String>params,String paramsEncoding){}

  这个方法需要对传递过来的所有参数进行遍历...将参数转化成 postid=4868291&update=1 这样的形式...我们在访问网站的时候经常会在url看到这样类似的字串，那也就是传递的参数想必也就不难理解了...

private byte[] encodeParameters(Map<String, String> params, String paramsEncoding) {
        StringBuilder encodedParams = new StringBuilder();
        try {
            for (Map.Entry<String, String> entry : params.entrySet()) {
                encodedParams.append(URLEncoder.encode(entry.getKey(), paramsEncoding));
                encodedParams.append('=');
                encodedParams.append(URLEncoder.encode(entry.getValue(), paramsEncoding));
                encodedParams.append('&');
            }
            return encodedParams.toString().getBytes(paramsEncoding);
        } catch (UnsupportedEncodingException uee) {
            throw new RuntimeException("Encoding not supported: " + paramsEncoding, uee);
        }
    }

  2.3 请求完成后需要执行的函数...

  2.3.1 void finish(final String tag){}

  当一个请求完成之后需要对做出一些操作，首先需要做的事情就是将请求队列中的这次请求进行移除操作，因为请求已经完成...这也不难理解，也就是下面源码第一个if执行的过程，他会再次调用RequestQueue中finish()函数，来移除这次请求，这个源码就先不介绍...等到后面介绍RequestQueue源码的时候再细细说一下...我们只需要知道现在它的功能就行了...也是这个函数的主要部分...而下面第二个if()函数，其实是为了转储这次请求中所有的日志文件，为了以后的调试...

 void finish(final String tag) {
        if (mRequestQueue != null) {
            mRequestQueue.finish(this);
        }
        if (MarkerLog.ENABLED) {
            final long threadId = Thread.currentThread().getId();
            if (Looper.myLooper() != Looper.getMainLooper()) {
                // If we finish marking off of the main thread, we need to
                // actually do it on the main thread to ensure correct ordering.
                Handler mainThread = new Handler(Looper.getMainLooper());
                mainThread.post(new Runnable() {
                    @Override
                    public void run() {
                        mEventLog.add(tag, threadId);
                        mEventLog.finish(this.toString());
                    }
                });
                return;
            }

            mEventLog.add(tag, threadId);
            mEventLog.finish(this.toString());
        } else {
            long requestTime = SystemClock.elapsedRealtime() - mRequestBirthTime;
            if (requestTime >= SLOW_REQUEST_THRESHOLD_MS) {
                VolleyLog.d("%d ms: %s", requestTime, this.toString());
            }
        }
    }

  2.4 Request的构造函数...

  2.4.1 public Request(String url,Response.ErrorListener listener){}

        public Request(int method,String url,Response.ErrorListener listener){}

  构造函数分为两种，一个是直接通过url来执行请求，一个是通过指定提交方式，然后通过url来执行请求...

 public Request(String url, Response.ErrorListener listener) {
        this(Method.DEPRECATED_GET_OR_POST, url, listener);
    }
 public Request(int method, String url, Response.ErrorListener listener) {
        mMethod = method;
        mUrl = url;
        mErrorListener = listener;
        setRetryPolicy(new DefaultRetryPolicy());

        mDefaultTrafficStatsTag = TextUtils.isEmpty(url) ? 0: Uri.parse(url).getHost().hashCode();
    }

  Request只是一个抽象接口，为外部暴露接口，从而让其他的类去实现，其中还有许多的方法，包括请求失败时的重试策略，以及请求缓存的一些定义...还有许多变量和方法，只是在Request中进行了封装，而真正去调用和实现这些方法则需要其他的类进行扩展...因此Request的源码只是做一些简单的介绍..介绍的也是其中非常重要的方法...其他的内容则在后续进行介绍...