初識Volley的基本用法
1. Volley簡介
我們平時在開發Android應用的時候不可避免地都需要用到網路技術,而多數情況下應用程式都會使用HTTP協議來發送和接收網路資料。Android系統中主要提供了兩種方式來進行HTTP通訊,HttpURLConnection和HttpClient,幾乎在任何專案的程式碼中我們都能看到這兩個類的身影,使用率非常高。
不過HttpURLConnection和HttpClient的用法還是稍微有些複雜的,如果不進行適當封裝的話,很容易就會寫出不少重複程式碼。於是乎,一些Android網路通訊框架也就應運而生,比如說AsyncHttpClient,它把HTTP所有的通訊細節全部封裝在了內部,我們只需要簡單呼叫幾行程式碼就可以完成通訊操作了。再比如Universal-Image-Loader,它使得在介面上顯示網路圖片的操作變得極度簡單,開發者不用關心如何從網路上獲取圖片,也不用關心開啟執行緒、回收圖片資源等細節,Universal-Image-Loader已經把一切都做好了。
Android開發團隊也是意識到了有必要將HTTP的通訊操作再進行簡單化,於是在2013年Google I/O大會上推出了一個新的網路通訊框架——Volley。Volley可是說是把AsyncHttpClient和Universal-Image-Loader的優點集於了一身,既可以像AsyncHttpClient一樣非常簡單地進行HTTP通訊,也可以像Universal-Image-Loader一樣輕鬆載入網路上的圖片。除了簡單易用之外,Volley在效能方面也進行了大幅度的調整,它的設計目標就是非常適合去進行資料量不大,但通訊頻繁的網路操作,而對於大資料量的網路操作,比如說下載檔案等,Volley的表現就會非常糟糕。
下圖所示的這些應用都是屬於資料量不大,但網路通訊頻繁的,因此非常適合使用Volley。
2. 下載Volley
介紹了這麼多理論的東西,下面我們就準備開始進行實戰了,首先需要將Volley的jar包準備好,如果你的電腦上裝有Git,可以使用如下命令下載Volley的原始碼:
- git clone https://android.googlesource.com/platform/frameworks/volley
新建一個Android專案,將volley.jar檔案複製到libs目錄下,這樣準備工作就算是做好了。
3. StringRequest的用法
前面已經說過,Volley的用法非常簡單,那麼我們就從最基本的HTTP通訊開始學習吧,即發起一條HTTP請求,然後接收HTTP響應。首先需要獲取到一個RequestQueue物件,可以呼叫如下方法獲取到:
- RequestQueue mQueue = Volley.newRequestQueue(context);
注意這裡拿到的RequestQueue是一個請求佇列物件,它可以快取所有的HTTP請求,然後按照一定的演算法併發地發出這些請求。RequestQueue內部的設計就是非常合適高併發的,因此我們不必為每一次HTTP請求都建立一個RequestQueue物件,這是非常浪費資源的,基本上在每一個需要和網路互動的Activity中建立一個RequestQueue物件就足夠了。
接下來為了要發出一條HTTP請求,我們還需要建立一個StringRequest物件,如下所示:
- StringRequest stringRequest = new StringRequest("http://www.baidu.com",
- new Response.Listener<String>() {
- @Override
- publicvoid onResponse(String response) {
- Log.d("TAG", response);
- }
- }, new Response.ErrorListener() {
- @Override
- publicvoid onErrorResponse(VolleyError error) {
- Log.e("TAG", error.getMessage(), error);
- }
- });
可以看到,這裡new出了一個StringRequest物件,StringRequest的建構函式需要傳入三個引數,第一個引數就是目標伺服器的URL地址,第二個引數是伺服器響應成功的回撥,第三個引數是伺服器響應失敗的回撥。其中,目標伺服器地址我們填寫的是百度的首頁,然後在響應成功的回撥裡打印出伺服器返回的內容,在響應失敗的回撥裡打印出失敗的詳細資訊。
最後,將這個StringRequest物件新增到RequestQueue裡面就可以了,如下所示:
- mQueue.add(stringRequest);
另外,由於Volley是要訪問網路的,因此不要忘記在你的AndroidManifest.xml中新增如下許可權:
- <uses-permission android:name="android.permission.INTERNET" />
好了,就是這麼簡單,如果你現在執行一下程式,併發出這樣一條HTTP請求,就會看到LogCat中會打印出如下圖所示的資料。
沒錯,百度返回給我們的就是這樣一長串的HTML程式碼,雖然我們看起來會有些吃力,但是瀏覽器卻可以輕鬆地對這段HTML程式碼進行解析,然後將百度的首頁展現出來。
這樣的話,一個最基本的HTTP傳送與響應的功能就完成了。你會發現根本還沒寫幾行程式碼就輕易實現了這個功能,主要就是進行了以下三步操作:
1. 建立一個RequestQueue物件。
2. 建立一個StringRequest物件。
3. 將StringRequest物件新增到RequestQueue裡面。
不過大家都知道,HTTP的請求型別通常有兩種,GET和POST,剛才我們使用的明顯是一個GET請求,那麼如果想要發出一條POST請求應該怎麼做呢?StringRequest中還提供了另外一種四個引數的建構函式,其中第一個引數就是指定請求型別的,我們可以使用如下方式進行指定:
- StringRequest stringRequest = new StringRequest(Method.POST, url, listener, errorListener);
可是這只是指定了HTTP請求方式是POST,那麼我們要提交給伺服器的引數又該怎麼設定呢?很遺憾,StringRequest中並沒有提供設定POST引數的方法,但是當發出POST請求的時候,Volley會嘗試呼叫StringRequest的父類——Request中的getParams()方法來獲取POST引數,那麼解決方法自然也就有了,我們只需要在StringRequest的匿名類中重寫getParams()方法,在這裡設定POST引數就可以了,程式碼如下所示:
- StringRequest stringRequest = new StringRequest(Method.POST, url, listener, errorListener) {
- @Override
- protected Map<String, String> getParams() throws AuthFailureError {
- Map<String, String> map = new HashMap<String, String>();
- map.put("params1", "value1");
- map.put("params2", "value2");
- return map;
- }
- };
你可能會說,每次都這樣用起來豈不是很累?連個設定POST引數的方法都沒有。但是不要忘記,Volley是開源的,只要你願意,你可以自由地在裡面新增和修改任何的方法,輕鬆就能定製出一個屬於你自己的Volley版本。
4. JsonRequest的用法
學完了最基本的StringRequest的用法,我們再來進階學習一下JsonRequest的用法。類似於StringRequest,JsonRequest也是繼承自Request類的,不過由於JsonRequest是一個抽象類,因此我們無法直接建立它的例項,那麼只能從它的子類入手了。JsonRequest有兩個直接的子類,JsonObjectRequest和JsonArrayRequest,從名字上你應該能就看出它們的區別了吧?一個是用於請求一段JSON資料的,一個是用於請求一段JSON陣列的。
至於它們的用法也基本上沒有什麼特殊之處,先new出一個JsonObjectRequest物件,如下所示:
- JsonObjectRequest jsonObjectRequest = new JsonObjectRequest("http://m.weather.com.cn/data/101010100.html", null,
- new Response.Listener<JSONObject>() {
- @Override
- publicvoid onResponse(JSONObject response) {
- Log.d("TAG", response.toString());
- }
- }, new Response.ErrorListener() {
- @Override
- publicvoid onErrorResponse(VolleyError error) {
- Log.e("TAG", error.getMessage(), error);
- }
- });
可以看到,這裡我們填寫的URL地址是http://m.weather.com.cn/data/101010100.html,這是中國天氣網提供的一個查詢天氣資訊的介面,響應的資料就是以JSON格式返回的,然後我們在onResponse()方法中將返回的資料打印出來。
最後再將這個JsonObjectRequest物件新增到RequestQueue裡就可以了,如下所示:
- mQueue.add(jsonObjectRequest);
這樣當HTTP通訊完成之後,伺服器響應的天氣資訊就會回撥到onResponse()方法中,並打印出來。現在執行一下程式,發出這樣一條HTTP請求,就會看到LogCat中會打印出如下圖所示的資料。
由此可以看出,伺服器返回給我們的資料確實是JSON格式的,並且onResponse()方法中攜帶的引數也正是一個JSONObject物件,之後只需要從JSONObject物件取出我們想要得到的那部分資料就可以了。
你應該發現了吧,JsonObjectRequest的用法和StringRequest的用法基本上是完全一樣的,Volley的易用之處也在這裡體現出來了,會了一種就可以讓你舉一反三,因此關於JsonArrayRequest的用法相信已經不需要我再去講解了吧。