这次课教你：
- 添加INTENET权限
- 使用newRequestQueue
- 发送一个request
- 取消一个request
高级点说，你可以使用Volley，通过创建一个RequestQueue然后传递Request对象。RequestQueue管理着工作线程，来执行网络操作、读写缓存和解析响应的数据。request做原始响应的解析和调度，Volley负责将解析后的响应发送到交付的主线程中。
本教程描述如何通过Volley.newRequestQueue这个如此方便的方法来建立一个RequestQueue，发送一个请求。查看下一个教程:Setting Up a RequestQueue来了解如何自建RequestQueue。
本教程也描述了如何添加一个request到RequestQueue和取消一个request。
添加INTENET权限
为了使用Volley，你必须添加权限android.permission.INTERNET到你的app的清单文件中。否则，你的app无法访问网络。
使用newRequestQueue
Volley提供了一个便利的方法Volley.newRequestQueue来建立一个RequestQueue，使用默认值启动队列。比如：
final TextView mTextView = (TextView) findViewById(R.id.text);
...
// 初始化请求队列.
RequestQueue queue = Volley.newRequestQueue(this);
String url ="http://www.google.com";
// 从提供的URL中请求一个字符串响应.
StringRequest stringRequest = new StringRequest(Request.Method.GET, url,
new Response.Listener<String>() {
@Override
public void onResponse(String response) {
// 显示响应字符串的前500个字符
mTextView.setText("Response is: "+ response.substring(0,500));
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
mTextView.setText("That didn't work!");
}
});
// 添加请求到请求队列中.
queue.add(stringRequest);
Volley总是在主线程传递解析后的响应数据。跑在主线程可以很方便地填入接收到的数据到UI控件中，因为你可以直接从响应处理器（response handler）中自由地修改UI控件，不仅如此，它在库中还具有更重要的用意，特别是跟取消request相关。
查看Setting Up a RequestQueue来了解如何自建RequestQueue而不是使用Volley.newRequestQueue。
发送一个request
为了发送一个请求，你只需要简单地构造一个request并使用add()方法添加到RequestQueue中即可，如上所述。一旦你添加了request，它会通过管道，开始服务并有了独自的能被解析和传递的原始响应数据。
当你调用add()，Volley运行了一个cache处理线程和一个网络分发线程池。当你添加了一个request到队列中，它会由cache线程获取并分类：如果request能够被cache服务，那么缓存的响应会在cache线程被解析并发送到主线程。如果request不能被cache服务，它会被放置到网络队列（network queue）。第一个可用的network线程从队列中获取request，执行HTTP事务，在工作线程解析响应，写入响应到cache中，然后发送解析后的响应数据到主线程中。
提醒：昂贵的操作（译注：指耗时或耗CPU的操作），比如会引发中断的I/O和解析/解码都是在工作线程执行的。你可以从任意线程添加请求，但是响应总是在主线程发送的。
图1 阐明了request的生命周期
取消一个request
为了取消一个rquest，你可以调用Request对象的cancle()方法。一旦取消，Volley会保证你的响应处理器（response handler）不会被调用。在实践中意味着你可以在activity的onStop()方法中取消所有将要执行的request，而不必到处检查getActivity() == null、是否onSaveInstanceState()被调用了或者其它检查性的样板代码，这些代码把response handler都搞乱了。
为了利用这个行为并在合适的时候取消request，经典的方法是追踪所有运行中的request。然而还有一个更简单的方法：你可以给每个request附带一个tag对象，这样你就可以使用tag来提供一个request作用域（译注：所有的request都可以通过tag操作）供取消。例如，你可以使用创建了request的Activity给每个request打tag，并在onStop()中调用requestQueue.cancelAll(this)。同理，你可以给ViewPager标签中的各自的所有缩略图（thumbnail image）请求打tag，并且在快速切换时取消request来保证新的标签（tab）不会被另外一个标签的请求所拦截。
下面的例子使用一个string值作为tag：
1.定义tag并添加到request中。
public static final String TAG = "MyTag";
StringRequest stringRequest; // 假定存在
RequestQueue mRequestQueue; // 假定存在
// 给请求打tag（标识）
stringRequest.setTag(TAG);
// 添加请求到请求队列中
mRequestQueue.add(stringRequest);
2.在activity的onstop()方法中取消所有带该tag的request。
@Override
protected void onStop () {
super.onStop();
if (mRequestQueue != null) {
mRequestQueue.cancelAll(TAG);
}
}
你应该关心何时取消request。如果你依赖于response handler来更新一个状态或者开始一个方法，那么你要对此负责。response handler不会被再次调用。
项目源码下载 ：点击下载
系列索引
- 【译】Volley官方文档五：实现一个自定义的Request
- 【译】Volley官方文档四：构建一个标准的Request
- 【译】Volley官方文档三：建立一个RequestQueue
- 【译】Volley官方文档二：发送一个简单的request
- 【译】Volley官方文档一：使用Volley传递网络数据
更新记录：
- 2016年03月21日：添加了系列索引
- 2016年3月20号
- 修正了一些翻译错误
- 翻译了代码中的注释
- 添加了原文链接
- 添加了源码
