發(fā)送一個簡單的 Request
在一個較高層次上苗缩,你可以使用 Volley 創(chuàng)建一個 RequestQueue
然后可以傳遞一個 Request
對象。RequestQueue
管理 worker threads(工作線程) 來操作網(wǎng)絡(luò)庆猫,讀取和寫入 cache 停局,解析 response稚茅。
Requests 解析原始的 Responses 然后 Volley 會負(fù)責(zé)分發(fā)解析過的 response 到主線程
這節(jié)課描述了如何使用 Volley.newRequestQueue
便利方法來發(fā)送一個 Request,如果想自己配置一個 RequestQueue
袱院,點擊下節(jié)課屎慢,Setting up a RequestQueue 查看更多關(guān)于如何配置一個自己的 RequestQueue
瞭稼。
這節(jié)課也描述了如何添加一個 Request 至 RequestQueue
和如何取消一個 Request。
添加 INTERNET 權(quán)限
為了使用 Volley腻惠,你必須添加 android.permission.INTERNET 權(quán)限到你的 App manifest 文件里环肘。沒有該權(quán)限,你的 App 無法連接到網(wǎng)絡(luò)
使用 newRequestQueue
Volley 提供了一個配置 RequestQueue
的便利方法 Volley.newRequestQueue集灌,內(nèi)部使用默認(rèn)的值和啟動隊列的自動操作悔雹。例如:
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 回調(diào)當(dāng)中發(fā)送 parsed Response, 運行在主線程中可以方便將接受到的數(shù)據(jù)與需要填充數(shù)據(jù)的 UI 進(jìn)行對照欣喧,這樣你就可以在響應(yīng)處理類中直接自由的修改你的 UI 和數(shù)據(jù)的對照腌零,但是要尤其注意該 library 中的重要語義,尤其是和取消 request 相關(guān)的唆阿。
查看 Settings up a RequestQueue 里的描述如何配置一個自己的 RequestQueue
而不是使用 Volley.newRequestQuenue 便利方法益涧。
發(fā)送一個 Request
為了發(fā)送一個 request,你可以簡單地構(gòu)造一個然后調(diào)用 RequestQueue.add()
方法添加一個 request驯鳖,就像上面所說的闲询,一旦添加一個 request ,該 request 就會通過管道被移動浅辙,獲得處理服務(wù)嘹裂,然后解析原始的 response 最后發(fā)送該 response。
當(dāng)你調(diào)用 add()
方法時摔握,Volley 運行一個 cache 處理 thread 和維護(hù)一個網(wǎng)絡(luò)調(diào)度 thread pool,當(dāng)你添加一個 request 到隊列時丁寄,該 request 會被 cache thread 接手并被篩選:如果該 request 可以被 cache 處理氨淌,那么這個 cached response 會在 cache thread 被解析然后這個 parsed response 會被發(fā)送到 main thread。如果這個 request 不能被 cache 處理伊磺,該 request 就會被放置到 network queue盛正,第一個可用的 network thread 會從 queue 取出這個 request, 執(zhí)行 HTTP 事務(wù)屑埋,在 work thread 中解析 response豪筝,將該 response 寫入 cache 中,然后傳遞 parsed responsed 到 main thread 中
注意那些像 I/O 流,解碼/解析 這些耗時的操作是在 work thread 中被執(zhí)行的摘能,你可以在任意的 thread 中添加一個 request续崖,但是 responses 總是會在 main thread 中被傳遞。
圖 1 說明了一個 request 的生命周期:
圖 1.request 的生命周期
取消一個 request
可以調(diào)用需要被取消的 Request
對象的 cancel()
方法來取消該 request团搞,一旦被取消严望,Volley 會保證你的 response 處理類相關(guān)回調(diào)不會被調(diào)用。在實際中意味著你可以在你的 Activity的 onStop 中取消你的 pending requests 并且你不需要在你的響應(yīng)類中檢查 getActivity()==null逻恐,不管 onSaveInstanceState() 是否已經(jīng)被回調(diào)像吻,或者其他類似這樣的檢查代碼來回收你的 response 處理類峻黍。
為了利用這個優(yōu)勢,你通常必須跟蹤所有 in-flight request 在適當(dāng)?shù)臅r間來取消它們拨匆。有一個更加簡單的方法:你可以在每一個 request 上關(guān)聯(lián)一個 tag 對象姆涩。你可以使用它們來取消一個范圍內(nèi)的 requests。例如惭每,你可以使用 Activity 來標(biāo)記所有與之相關(guān)的 request骨饿,然后從該 Activity 的 onStop 方法中調(diào)用 requestQueue.cancelAll(this)
。類似的洪鸭,你可以標(biāo)記在 ViewPager 各自的 tab 中標(biāo)記所有的縮略圖 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 方法中取消所有標(biāo)記為該 tag 的 request.
@Override protected void onStop () { super.onStop(); if (mRequestQueue != null) { mRequestQueue.cancelAll(TAG); } }
注意當(dāng)你取消 request 時览爵,如果你需要依賴你的 response 處理類來推出一個狀態(tài)或者啟動另一個進(jìn)程置鼻,你需要注意這個。再一次說明,取消response 會導(dǎo)致你的 response 處理類相關(guān)回調(diào)不會被調(diào)用