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;
}

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

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

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

[b][b] 2.2.2 protected Map<String,String> getPostParams() throws AuthFailureError{}[/b][/b]

[b][b] protected Map<String,String> getParams() throws AuthFailureError{}[/b][/b]

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

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

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

[b][b][b][b][b][b][b][b]

[/b][/b][/b][/b][/b][/b][/b][/b]

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

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

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

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);
}
}

[b][b][b][b][b][b][b][b][b][b][b] 2.3 请求完成后需要执行的函数...
[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

[b][b][b][b][b][b][b][b][b][b][b] 2.3.1 void finish(final String tag){}[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

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

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());
}
}
}

[b][b][b][b][b][b][b][b][b][b][b] [b][b][b][b][b][b][b][b][b][b][b][b]2.4 Request的构造函数...[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]
[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

[b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b] 2.4.1 public Request(String url,Response.ErrorListener listener){}[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

[b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b] public Request(int method,String url,Response.ErrorListener listener){}[/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

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

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();
}

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

[b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]

[b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b][/b]