Android框架之網絡開發框架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名稱的由來: a burst or emission of many things or a large amount at once
在Google IO的演講上,其配圖是一幅發射火弓箭的圖,有點類似流星。見下圖


 其實,從這幅圖,我們也可以看出來,Volley特別適合數據量不大但是通信頻繁的場景。


2. 下載Volley

介紹了這麼多理論的東西,下面我們就準備開始進行實戰了,首先需要將Volley的jar包準備好,如果你的電腦上裝有Git,可以使用如下命令下載Volley的源碼:

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

下載完成後將它導入到你的Eclipse工程裏,然後再導出一個jar包就可以了。

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

3. StringRequest的用法

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

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. RequestQueue mQueue = Volley.newRequestQueue(context);  

注意這裏拿到的RequestQueue是一個請求隊列對象,它可以緩存所有的HTTP請求,然後按照一定的算法併發地發出這些請求。RequestQueue內部的設計就是非常合適高併發的,因此我們不必爲每一次HTTP請求都創建一個RequestQueue對象,這是非常浪費資源的,基本上在每一個需要和網絡交互的Activity中創建一個RequestQueue對象就足夠了。

 

接下來爲了要發出一條HTTP請求,我們還需要創建一個StringRequest對象,如下所示:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. StringRequest stringRequest = new StringRequest("http://www.baidu.com",  
  2.                         new Response.Listener<String>() {  
  3.                             @Override  
  4.                             public void onResponse(String response) {  
  5.                                 Log.d("TAG", response);  
  6.                             }  
  7.                         }, new Response.ErrorListener() {  
  8.                             @Override  
  9.                             public void onErrorResponse(VolleyError error) {  
  10.                                 Log.e("TAG", error.getMessage(), error);  
  11.                             }  
  12.                         });  

可以看到,這裏new出了一個StringRequest對象,StringRequest的構造函數需要傳入三個參數,第一個參數就是目標服務器的URL地址,第二個參數是服務器響應成功的回調,第三個參數是服務器響應失敗的回調。其中,目標服務器地址我們填寫的是百度的首頁,然後在響應成功的回調裏打印出服務器返回的內容,在響應失敗的回調裏打印出失敗的詳細信息。

 

最後,將這個StringRequest對象添加到RequestQueue裏面並開始就可以了,如下所示:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. mQueue.add(stringRequest);  
  2. mQueue.start();

另外,由於Volley是要訪問網絡的,因此不要忘記在你的AndroidManifest.xml中添加如下權限:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  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中還提供了另外一種四個參數的構造函數,其中第一個參數就是指定請求類型的,我們可以使用如下方式進行指定:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener);  

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

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  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對象,如下所示:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. JsonObjectRequest jsonObjectRequest = new JsonObjectRequest("http://m.weather.com.cn/data/101010100.html"null,  
  2.         new Response.Listener<JSONObject>() {  
  3.             @Override  
  4.             public void onResponse(JSONObject response) {  
  5.                 Log.d("TAG", response.toString());  
  6.             }  
  7.         }, new Response.ErrorListener() {  
  8.             @Override  
  9.             public void 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裏就可以了,如下所示:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
 
  1. mQueue.add(jsonObjectRequest);  

這樣當HTTP通信完成之後,服務器響應的天氣信息就會回調到onResponse()方法中,並打印出來。現在運行一下程序,發出這樣一條HTTP請求,就會看到LogCat中會打印出如下圖所示的數據。

 

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

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

好了,下面說一下實際中會出現的情況:

如果在一個Activity裏面啓動了網絡請求,而在這個網絡請求還沒返回結果的時候,如果Activity被結束了,則我們需要寫如下代碼作爲防守:

@Override 
public void onPostExecute(Result r) {  
    if (getActivity() == null) {  
        return;  
    }  
    // ...  
}  

Activity被終止之後,如果繼續使用其中的Context等,除了無辜的浪費CPU,電池,網絡等資源,有可能還會導致程序crash,所以,我們需要處理這種一場情況。

使用Volley的話,我們可以在Activity停止的時候,同時取消所有或部分未完成的網絡請求。

Volley裏所有的請求結果會返回給主進程,如果在主進程裏取消了某些請求,則這些請求將不會被返回給主線程。
比如,可以針對某些個request做取消操作:

  1. @Override  
  2. public void onStop() {  
  3.     for (Request <?> req : mInFlightRequests) {  
  4.         req.cancel();  
  5.     }  
  6.     ...  
  7. }  

或者,取消這個隊列裏的所有請求:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
  1. @Override pubic void onStop() {  
  2.     mRequestQueue.cancelAll(this);  
  3.     ...  
  4. }  

也可以根據RequestFilter或者Tag來終止某些請求:

[java] view plaincopy在CODE上查看代碼片派生到我的代碼片
  1. @Override public void onStop() {  
  2.     mRequestQueue.cancelAll( new RequestFilter() {})  
  3.     ...  
  4.     // or  
  5.     mRequestQueue.cancelAll(new Object());  

Volley應該是簡化了網絡通信的一些開發,特別是針對如下兩種情況:

  • JSON對象
  • 圖片加載

但是這個東西也有不實用的地方,比如大數據(large payloads ),流媒體,這些case,還需要使用原始的方法,比如Download Manager等。
總之,如果你要編寫網絡程序,是不是可以考慮開始使用Volley呢?




發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章