1. 程式人生 > >初識Volley的基本用法

初識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的原始碼:

  1. git clone https://android.googlesource.com/platform/frameworks/volley  

新建一個Android專案,將volley.jar檔案複製到libs目錄下,這樣準備工作就算是做好了。

3. StringRequest的用法

前面已經說過,Volley的用法非常簡單,那麼我們就從最基本的HTTP通訊開始學習吧,即發起一條HTTP請求,然後接收HTTP響應。首先需要獲取到一個RequestQueue物件,可以呼叫如下方法獲取到:

  1. RequestQueue mQueue = Volley.newRequestQueue(context);  

注意這裡拿到的RequestQueue是一個請求佇列物件,它可以快取所有的HTTP請求,然後按照一定的演算法併發地發出這些請求。RequestQueue內部的設計就是非常合適高併發的,因此我們不必為每一次HTTP請求都建立一個RequestQueue物件,這是非常浪費資源的,基本上在每一個需要和網路互動的Activity中建立一個RequestQueue物件就足夠了。

接下來為了要發出一條HTTP請求,我們還需要建立一個StringRequest物件,如下所示:

  1. StringRequest stringRequest = new StringRequest("http://www.baidu.com",  
  2.                         new Response.Listener<String>() {  
  3.                             @Override
  4.                             publicvoid onResponse(String response) {  
  5.                                 Log.d("TAG", response);  
  6.                             }  
  7.                         }, new Response.ErrorListener() {  
  8.                             @Override
  9.                             publicvoid onErrorResponse(VolleyError error) {  
  10.                                 Log.e("TAG", error.getMessage(), error);  
  11.                             }  
  12.                         });  

可以看到,這裡new出了一個StringRequest物件,StringRequest的建構函式需要傳入三個引數,第一個引數就是目標伺服器的URL地址,第二個引數是伺服器響應成功的回撥,第三個引數是伺服器響應失敗的回撥。其中,目標伺服器地址我們填寫的是百度的首頁,然後在響應成功的回撥裡打印出伺服器返回的內容,在響應失敗的回撥裡打印出失敗的詳細資訊。

最後,將這個StringRequest物件新增到RequestQueue裡面就可以了,如下所示:

  1. mQueue.add(stringRequest);  

另外,由於Volley是要訪問網路的,因此不要忘記在你的AndroidManifest.xml中新增如下許可權:

  1. <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中還提供了另外一種四個引數的建構函式,其中第一個引數就是指定請求型別的,我們可以使用如下方式進行指定:

  1. StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener);  

可是這只是指定了HTTP請求方式是POST,那麼我們要提交給伺服器的引數又該怎麼設定呢?很遺憾,StringRequest中並沒有提供設定POST引數的方法,但是當發出POST請求的時候,Volley會嘗試呼叫StringRequest的父類——Request中的getParams()方法來獲取POST引數,那麼解決方法自然也就有了,我們只需要在StringRequest的匿名類中重寫getParams()方法,在這裡設定POST引數就可以了,程式碼如下所示:

  1. StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener) {  
  2.     @Override
  3.     protected Map<String, String> getParams() throws AuthFailureError {  
  4.         Map<String, String> map = new HashMap<String, String>();  
  5.         map.put("params1""value1");  
  6.         map.put("params2""value2");  
  7.         return map;  
  8.     }  
  9. };  

你可能會說,每次都這樣用起來豈不是很累?連個設定POST引數的方法都沒有。但是不要忘記,Volley是開源的,只要你願意,你可以自由地在裡面新增和修改任何的方法,輕鬆就能定製出一個屬於你自己的Volley版本。

4. JsonRequest的用法

學完了最基本的StringRequest的用法,我們再來進階學習一下JsonRequest的用法。類似於StringRequest,JsonRequest也是繼承自Request類的,不過由於JsonRequest是一個抽象類,因此我們無法直接建立它的例項,那麼只能從它的子類入手了。JsonRequest有兩個直接的子類,JsonObjectRequest和JsonArrayRequest,從名字上你應該能就看出它們的區別了吧?一個是用於請求一段JSON資料的,一個是用於請求一段JSON陣列的。

至於它們的用法也基本上沒有什麼特殊之處,先new出一個JsonObjectRequest物件,如下所示:

  1. JsonObjectRequest jsonObjectRequest = new JsonObjectRequest("http://m.weather.com.cn/data/101010100.html"null,  
  2.         new Response.Listener<JSONObject>() {  
  3.             @Override
  4.             publicvoid onResponse(JSONObject response) {  
  5.                 Log.d("TAG", response.toString());  
  6.             }  
  7.         }, new Response.ErrorListener() {  
  8.             @Override
  9.             publicvoid onErrorResponse(VolleyError error) {  
  10.                 Log.e("TAG", error.getMessage(), error);  
  11.             }  
  12.         });  

可以看到,這裡我們填寫的URL地址是http://m.weather.com.cn/data/101010100.html,這是中國天氣網提供的一個查詢天氣資訊的介面,響應的資料就是以JSON格式返回的,然後我們在onResponse()方法中將返回的資料打印出來。

最後再將這個JsonObjectRequest物件新增到RequestQueue裡就可以了,如下所示:

  1. mQueue.add(jsonObjectRequest);  

這樣當HTTP通訊完成之後,伺服器響應的天氣資訊就會回撥到onResponse()方法中,並打印出來。現在執行一下程式,發出這樣一條HTTP請求,就會看到LogCat中會打印出如下圖所示的資料。

由此可以看出,伺服器返回給我們的資料確實是JSON格式的,並且onResponse()方法中攜帶的引數也正是一個JSONObject物件,之後只需要從JSONObject物件取出我們想要得到的那部分資料就可以了。

你應該發現了吧,JsonObjectRequest的用法和StringRequest的用法基本上是完全一樣的,Volley的易用之處也在這裡體現出來了,會了一種就可以讓你舉一反三,因此關於JsonArrayRequest的用法相信已經不需要我再去講解了吧。