發送一個簡單的 Request
在一個較高層次上,你可以使用 Volley 創建一個 RequestQueue
然后可以傳遞一個 Request
對象。RequestQueue
管理 worker threads(工作線程) 來操作網絡,讀取和寫入 cache ,解析 response。
Requests 解析原始的 Responses 然后 Volley 會負責分發解析過的 response 到主線程
這節課描述了如何使用 Volley.newRequestQueue
便利方法來發送一個 Request,如果想自己配置一個 RequestQueue
,點擊下節課,Setting up a RequestQueue 查看更多關于如何配置一個自己的 RequestQueue
。
這節課也描述了如何添加一個 Request 至 RequestQueue
和如何取消一個 Request。
添加 INTERNET 權限
為了使用 Volley,你必須添加 android.permission.INTERNET 權限到你的 App manifest 文件里。沒有該權限,你的 App 無法連接到網絡
使用 newRequestQueue
Volley 提供了一個配置 RequestQueue
的便利方法 Volley.newRequestQueue,內部使用默認的值和啟動隊列的自動操作。例如:
final TextView mTextView = (TextView) findViewById(R.id.text);
...
// Instantiate the RequestQueue.
RequestQueue queue = Volley.newRequestQueue(this);
String url ="http://www.google.com";
// Request a string response from the provided URL.
StringRequest stringRequest = new StringRequest(Request.Method.GET, url,
new Response.Listener<String>() {
@Override
public void onResponse(String response) {
// Display the first 500 characters of the response string.
mTextView.setText("Response is: "+ response.substring(0,500));
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
mTextView.setText("That didn't work!");
}
});
// Add the request to the RequestQueue.
queue.add(stringRequest);
Volley 總是在 main thread 回調當中發送 parsed Response, 運行在主線程中可以方便將接受到的數據與需要填充數據的 UI 進行對照,這樣你就可以在響應處理類中直接自由的修改你的 UI 和數據的對照,但是要尤其注意該 library 中的重要語義,尤其是和取消 request 相關的。
查看 Settings up a RequestQueue 里的描述如何配置一個自己的 RequestQueue
而不是使用 Volley.newRequestQuenue 便利方法。
發送一個 Request
為了發送一個 request,你可以簡單地構造一個然后調用 RequestQueue.add()
方法添加一個 request,就像上面所說的,一旦添加一個 request ,該 request 就會通過管道被移動,獲得處理服務,然后解析原始的 response 最后發送該 response。
當你調用 add()
方法時,Volley 運行一個 cache 處理 thread 和維護一個網絡調度 thread pool,當你添加一個 request 到隊列時,該 request 會被 cache thread 接手并被篩選:如果該 request 可以被 cache 處理,那么這個 cached response 會在 cache thread 被解析然后這個 parsed response 會被發送到 main thread。如果這個 request 不能被 cache 處理,該 request 就會被放置到 network queue,第一個可用的 network thread 會從 queue 取出這個 request, 執行 HTTP 事務,在 work thread 中解析 response,將該 response 寫入 cache 中,然后傳遞 parsed responsed 到 main thread 中
注意那些像 I/O 流,解碼/解析 這些耗時的操作是在 work thread 中被執行的,你可以在任意的 thread 中添加一個 request,但是 responses 總是會在 main thread 中被傳遞。
圖 1 說明了一個 request 的生命周期:
圖 1.request 的生命周期
取消一個 request
可以調用需要被取消的 Request
對象的 cancel()
方法來取消該 request,一旦被取消,Volley 會保證你的 response 處理類相關回調不會被調用。在實際中意味著你可以在你的 Activity的 onStop 中取消你的 pending requests 并且你不需要在你的響應類中檢查 getActivity()==null,不管 onSaveInstanceState() 是否已經被回調,或者其他類似這樣的檢查代碼來回收你的 response 處理類。
為了利用這個優勢,你通常必須跟蹤所有 in-flight request 在適當的時間來取消它們。有一個更加簡單的方法:你可以在每一個 request 上關聯一個 tag 對象。你可以使用它們來取消一個范圍內的 requests。例如,你可以使用 Activity 來標記所有與之相關的 request,然后從該 Activity 的 onStop 方法中調用 requestQueue.cancelAll(this)
。類似的,你可以標記在 ViewPager 各自的 tab 中標記所有的縮略圖 request,然后在滑動時取消這些 request 來確保新 tab 中的 request 不會被另一個 tab 中的 request 所阻塞。
這里有一個使用一個 string 值作為 tag 的例子:
-
定義你的 tag 并添加到你的 request 中.
public static final String TAG = "MyTag"; StringRequest stringRequest; // Assume this exists. RequestQueue mRequestQueue; // Assume this exists. // Set the tag on the request. stringRequest.setTag(TAG); // Add the request to the RequestQueue. mRequestQueue.add(stringRequest);
-
在你的 Activity 的 onStop 方法中取消所有標記為該 tag 的 request.
@Override protected void onStop () { super.onStop(); if (mRequestQueue != null) { mRequestQueue.cancelAll(TAG); } }
注意當你取消 request 時,如果你需要依賴你的 response 處理類來推出一個狀態或者啟動另一個進程,你需要注意這個。再一次說明,取消response 會導致你的 response 處理類相關回調不會被調用