【译】Volley官方文档二：发送一个简单的request

原文链接：Sending a Simple Request

这次课教你：

• 添加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() {
    @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的生命周期

volley-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号
  - 修正了一些翻译错误
  - 翻译了代码中的注释
  - 添加了原文链接
  - 添加了源码