一、什么是Volley?
Volley,是谷歌官方于2013年發(fā)布的用于Android平臺的網(wǎng)絡(luò)通信庫,也即是說它內(nèi)部封裝了HttpURLConnection等常用于網(wǎng)絡(luò)通信的類。平時我們寫網(wǎng)絡(luò)通信的業(yè)務(wù)邏輯的時候,通常是一大段一大段的HttpURLConnection的邏輯,這給我們造成了很多麻煩,如可能存在很多重復(fù)的代碼或者效率過低又或者存在并發(fā)問題。而Volley的出現(xiàn),極大簡化了網(wǎng)絡(luò)通信的業(yè)務(wù)邏輯的寫法,只需要幾行代碼就能實現(xiàn)復(fù)雜的通信內(nèi)容。
Volley的特點有如下:我們的應(yīng)用進(jìn)行網(wǎng)絡(luò)通信的時候會更快、有著高效率的GET、POST及網(wǎng)絡(luò)圖像的異步處理請求機(jī)制、能對多個請求進(jìn)行排序、能對請求的結(jié)果進(jìn)行緩存、能多級別取消請求。
說了那么多Volley的優(yōu)點,我們來說說它的適用場景:它適用于網(wǎng)絡(luò)通信頻繁但是數(shù)據(jù)量不大的場景;然而對于數(shù)據(jù)量非常大的情況下,它的性能就會非常差。但對于我們的日常開發(fā)開說綽綽有余了,因此使用Volley能極大提高我們的開發(fā)效率,所以學(xué)習(xí)Volley對我們來說是非常有好處的。
二、下載Volley
Volley的源碼可以利用git命令直接獲取:
git clone https://android.googlesource.com/platform/frameworks/volley
然后導(dǎo)出成jar包,在項目中引入即可。或者在這里直接https://github.com/chenyua1995/AndroidFramework 下載筆者生成好的jar包。
三、Volley的基本使用
1、建立請求隊列
與一般的網(wǎng)絡(luò)請求不同,Volley把所有請求都保存在一個請求隊列中,然后在請求隊列中按優(yōu)先級一個一個取出請求,然后發(fā)送出去,因此我們先要實例化一個請求隊列:
private static RequestQueue requestQueue;
requestQueue = Volley.newRequestQueue(getApplicationContext()); //把上下文context作為參數(shù)傳遞進(jìn)去
2、三種請求方法
在Volley內(nèi),一般的Http的請求方法有三種,分別是StringRequest,JsonObjectRequest以及JsonArrayRequest,而每個方法都可以分為GET和POST請求方式。從它們的名字可以知道,StringRequest是請求一段字符串,JsonObjectRequest是請求一個JSON對象。JsonArrayRequest是請求一組JSON數(shù)組。我們從最簡單的StrringRequest說起。
(1)StringRequest
我們先看它的構(gòu)造方法:
/**
* @param method 請求的方式,可以選擇GET或者POST
* url 請求的網(wǎng)址
* listener 請求成功的回調(diào)函數(shù)
* errorListener 請求失敗的回調(diào)函數(shù)
*/
public StringRequest(int method, String url, Listener<String> listener, ErrorListener errorListener) {
super(method, url, errorListener);
this.mListener = listener;
}
通過構(gòu)造方法獲取StringRequest的實例后,通過把這個實例添加進(jìn)請求隊列中,就能正常地進(jìn)行網(wǎng)絡(luò)通信了。代碼如下:
requestQueue.add(stringRequest);
下面我們結(jié)合一個實例來實際說明一下,這里選擇的請求網(wǎng)址是http://www.thinkpage.cn/doc ,里面有免費的天氣查詢接口,有興趣的讀者可以去了解一下,里面有詳細(xì)的文檔說明,這里就不再贅述了,MainActivity.java文件代碼如下:
public class MainActivity extends Activity {
private static RequestQueue requestQueue;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//1、創(chuàng)建請求隊列
RequestQueue requestQueue = Volley.newRequestQueue(getApplicationContext());
/**2、實例化StringRequest請求
* 第一個參數(shù)選擇Request.Method.GET即get請求方式
* 第二個參數(shù)的url地址根據(jù)文檔所給
* 第三個參數(shù)Response.Listener 請求成功的回調(diào)
* 第四個參數(shù)Response.ErrorListener 請求失敗的回調(diào)
*/
StringRequest stringRequest = new StringRequest(Request.Method.GET,"https://api.thinkpage.cn/v3/weather/now.json?key=rot2enzrehaztkdk&location=guangzhou&language=zh-Hans&unit=c",
new Response.Listener<String>() {
@Override
public void onResponse(String s) {
//String s即為服務(wù)器返回的數(shù)據(jù)
Log.d("cylog", s);
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError volleyError) {
Log.e("cylog", volleyError.getMessage(),volleyError);
}
});
//3、將請求添加進(jìn)請求隊列
requestQueue.add(stringRequest);
}
}
最后,不要忘記在AndroidManifest.xml中聲明網(wǎng)絡(luò)權(quán)限~
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
我們來看一下運(yùn)行效果:
可以看出,網(wǎng)絡(luò)通信的任務(wù)正常完成,獲取了相應(yīng)的數(shù)據(jù)。以上是GET請求方式,接下來簡單介紹一下POST請求方式:
1、首先,在實例化StringRequest的時候,要寫為Method.POST。
2、由于POST方式的參數(shù)不是寫在url而是寫在請求體的,所以我們需要重寫getParams()方法,這里的getParams()方法是重寫Request父類的方法,具體形式如下:
StringRequest stringRequest = new StringRequest(Request.Method.POST,"https://www.test.com", new Response.Listener<String>() {}
}, new Response.ErrorListener() {}){
@Override
protected Map<String, String> getParams() throws AuthFailureError {
//用HashMap來存儲請求參數(shù)
Map<String,String> map = new HashMap<String,String>();
map.put("param1","value1");
map.put("param2","value2");
return map;
}
};
有些網(wǎng)站是用GET方式來獲取數(shù)據(jù),有些網(wǎng)站是需要POST請求方式才能獲取數(shù)據(jù),所以我們要根據(jù)業(yè)務(wù)需求來靈活選擇。
(2)JsonObjectRequest和JsonArrayRequest
以上兩個類的用法和StringRequest很類似,同樣有著GET和POST的請求方式,JsonObjectRequest請求的是一個JSON對象,而JsonArrayRequest請求的是一個JSON數(shù)組,這里就以JsonObjectRequest為代表講述。
我們先看看構(gòu)造器:
public JsonObjectRequest(int method, String url, String requestBody, Listener<JSONObject> listener, ErrorListener errorListener) {
super(method, url, requestBody, listener, errorListener);
}
public JsonObjectRequest(int method, String url, Listener<JSONObject> listener, ErrorListener errorListener) {
super(method, url, (String)null, listener, errorListener);
}
從構(gòu)造器可以看出,它和StringRequest的構(gòu)造方法大同小異,但有一點要注意的是,JsonObjectRequest和JsonArrayRequest的構(gòu)造參數(shù)有一個是String requestBody,這個就是請求體,如果是POST請求,就可以直接通過構(gòu)造器把請求體傳進(jìn)去,而不用像StringRequest那樣通過重寫父類的getParams()來寫入請求參數(shù)。接下來的實現(xiàn)步驟和上面說的三個步驟一樣,實例化了請求實例后,添加進(jìn)請求隊列即可:
String url = "https://api.thinkpage.cn/v3/weather/now.json?key=rot2enzrehaztkdk&location=guangzhou&language=zh-Hans&unit=c";
JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(Request.Method.GET, url,(String)null,new Response.Listener<JSONObject>() {
@Override
public void onResponse(JSONObject jsonObject) {
Log.d("cylog",jsonObject.toString());
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError volleyError) {
Log.d("cylog",volleyError.getMessage().toString());
}
});
requestQueue.add(jsonObjectRequest);
運(yùn)行結(jié)果和上面給出的一樣,通過JsonObjectRequest能獲取到JSON對象,然后通過JsonObject的方法能非常方便地取出里面的元素。
Volley的基本用法介紹到這里,下一篇文章將開始介紹利用Volley來加載網(wǎng)絡(luò)圖片。