1. 什么是Volley
我們平時在開發(fā)Android應用的時候不可避免地都需要用到網(wǎng)絡技術(shù)，而多數(shù)情況下應用程序都會使用HTTP協(xié)議來發(fā)送和接收網(wǎng)絡數(shù)據(jù)。Android系統(tǒng)中主要提供了兩種方式來進行HTTP通信，HttpURLConnection和HttpClient，幾乎在任何項目的代碼中我們都能看到這兩個類的身影，使用率非常高。

不過HttpURLConnection和HttpClient的用法還是稍微有些復雜的，如果不進行適當封裝的話，很容易就會寫出不少重復代碼。于是乎，一些Android網(wǎng)絡通信框架也就應運而生，比如說AsyncHttpClient，它把HTTP所有的通信細節(jié)全部封裝在了內(nèi)部，我們只需要簡單調(diào)用幾行代碼就可以完成通信操作了。再比如Universal-Image-Loader，它使得在界面上顯示網(wǎng)絡圖片的操作變得極度簡單，開發(fā)者不用關(guān)心如何從網(wǎng)絡上獲取圖片，也不用關(guān)心開啟線程、回收圖片資源等細節(jié)，Universal-Image-Loader已經(jīng)把一切都做好了。

Android開發(fā)團隊也是意識到了有必要將HTTP的通信操作再進行簡單化，于是在2013年Google I/O大會上推出了一個新的網(wǎng)絡通信框架——Volley。Volley可是說是把AsyncHttpClient和Universal-Image-Loader的優(yōu)點集于了一身，既可以像AsyncHttpClient一樣非常簡單地進行HTTP通信，也可以像Universal-Image-Loader一樣輕松加載網(wǎng)絡上的圖片。除了簡單易用之外，Volley在性能方面也進行了大幅度的調(diào)整，它的設(shè)計目標就是非常適合去進行數(shù)據(jù)量不大，但通信頻繁的網(wǎng)絡操作，而對于大數(shù)據(jù)量的網(wǎng)絡操作，比如說下載文件等，Volley的表現(xiàn)就會非常糟糕。
1.1. Volley引入的背景
在以前，我們可能面臨如下很多麻煩的問題。

比如以前從網(wǎng)上下載圖片的步驟可能是這樣的流程：

• 在ListAdapter#getView()里開始圖像的讀取。
• 通過AsyncTask等機制使用HttpURLConnection從服務器去的圖片資源
• 在AsyncTask#onPostExecute()里設(shè)置相應ImageView的屬性。
• 而在Volley下，只需要一個函數(shù)即可，詳細見后面的例子。

再比如，屏幕旋轉(zhuǎn)的時候，有時候會導致再次從網(wǎng)絡取得數(shù)據(jù)。為了避免這種不必要的網(wǎng)絡訪問，我們可能需要自己寫很多針對各種情況的處理，比如cache什么的。

再有，比如ListView的時候，我們滾動過快，可能導致有些網(wǎng)絡請求返回的時候，早已經(jīng)滾過了當時的位置，根本沒必要顯示在list里了，雖然我們可以通過ViewHolder來保持url等來實現(xiàn)防止兩次取得，但是那些已經(jīng)沒有必須要的數(shù)據(jù)，還是會浪費系統(tǒng)的各種資源。

1.2. Volley提供的功能
簡單來說，它提供了如下的便利功能：

• JSON，圖像等的異步下載；
• 網(wǎng)絡請求的排序（scheduling）
• 網(wǎng)絡請求的優(yōu)先級處理
• 緩存
• 多級別取消請求
• Activity和生命周期的聯(lián)動（Activity結(jié)束時同時取消所有網(wǎng)絡請求）

2. 使用前的準備

引入Volley非常簡單，首先，從git庫先克隆一個下來：

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

然后編譯為jar包，再在自己的工程里import進來。

注意，這個庫要求最低SDK版本為Froyo，即至少要設(shè)置android:minSdkVersion為8以上。

3.使用例子
下面簡單看看如何使用Volley

3.1. 最簡單的get請求
這個例子很簡單，從網(wǎng)絡取得JSON對象，然后打印出來。

mQueue = Volley.newRequestQueue(getApplicationContext()); 
mQueue.add(new JsonObjectRequest(Method.GET, url, null, 
   new Listener() { 
    @Override 
    public void onResponse(JSONObject response) { 
     Log.d(TAG, "response : " + response.toString()); 
    } 
   }, null)); 
mQueue.start(); 

3.2. 給ImageView設(shè)置圖片源

// imageView是一個ImageView實例 
// ImageLoader.getImageListener的第二個參數(shù)是默認的圖片resource id 
// 第三個參數(shù)是請求失敗時候的資源id，可以指定為0 
ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_menu_rotate, android.R.drawable.ic_delete); 
mImageLoader.get(url, listener); 

ImageLoader的方法都需要從主線程里來調(diào)用。

3.3. 使用NetworkImageView

Volley提供了一個新的控件NetworkImageView來代替?zhèn)鹘y(tǒng)的ImageView，這個控件的圖片屬性可以通過

mImageView.setImageUrl(url, imageLoader) 

來設(shè)定。而且，這個控件在被從父控件detach的時候，會自動取消網(wǎng)絡請求的，即完全不用我們擔心相關(guān)網(wǎng)絡請求的生命周期問題。
示例代碼如下：

mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache()); 
... ... 
 
if(holder.imageRequest != null) { 
 holder.imageRequest.cancel(); 
} 
holder.imageRequest = mImageLoader.get(BASE_UR + item.image_url, holder.imageView, R.drawable.loading, R.drawable.error); 

注意，這里使用的不是ImageView控件，而是Volley新提供的com.android.volley.NetworkImageView。

另外，注意這里：

mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache()); 

ImageLoader構(gòu)造函數(shù)的第二個參數(shù)是一個ImageCache的實例（嚴格來說，是實現(xiàn)ImageCache接口的某具體類的實例）
ImageCache的定義如下（在ImageLoader.java里）：

/** 
 * Simple cache adapter interface. If provided to the ImageLoader, it 
 * will be used as an L1 cache before dispatch to Volley. Implementations 
 * must not block. Implementation with an LruCache is recommended. 
 */ 
public interface ImageCache { 
 public Bitmap getBitmap(String url); 
 public void putBitmap(String url, Bitmap bitmap); 
} 

下面的網(wǎng)址一個lru的cache實現(xiàn)例子，請參考：
https://github.com/suwa-yuki/VolleySample/blob/master/src/jp/classmethod/android/sample/volley/BitmapCache.java

3.4 StringRequest的用法
發(fā)起一條HTTP請求，然后接收HTTP響應。首先需要獲取到一個RequestQueue對象，可以調(diào)用如下方法獲取到：

RequestQueue mQueue = Volley.newRequestQueue(context); 

注意這里拿到的RequestQueue是一個請求隊列對象，它可以緩存所有的HTTP請求，然后按照一定的算法并發(fā)地發(fā)出這些請求。RequestQueue內(nèi)部的設(shè)計就是非常合適高并發(fā)的，因此我們不必為每一次HTTP請求都創(chuàng)建一個RequestQueue對象，這是非常浪費資源的，基本上在每一個需要和網(wǎng)絡交互的Activity中創(chuàng)建一個RequestQueue對象就足夠了。

接下來為了要發(fā)出一條HTTP請求，我們還需要創(chuàng)建一個StringRequest對象，如下所示：

StringRequest stringRequest = new StringRequest("http://www.baidu.com", 
      new Response.Listener<String>() { 
       @Override 
       public void onResponse(String response) { 
        Log.d("TAG", response); 
       } 
      }, new Response.ErrorListener() { 
       @Override 
       public void onErrorResponse(VolleyError error) { 
        Log.e("TAG", error.getMessage(), error); 
       } 
      }); 

可以看到，這里new出了一個StringRequest對象，StringRequest的構(gòu)造函數(shù)需要傳入三個參數(shù)，第一個參數(shù)就是目標服務器的URL地址，第二個參數(shù)是服務器響應成功的回調(diào)，第三個參數(shù)是服務器響應失敗的回調(diào)。其中，目標服務器地址我們填寫的是百度的首頁，然后在響應成功的回調(diào)里打印出服務器返回的內(nèi)容，在響應失敗的回調(diào)里打印出失敗的詳細信息。

最后，將這個StringRequest對象添加到RequestQueue里面就可以了，如下所示：

mQueue.add(stringRequest); 
另外，由于Volley是要訪問網(wǎng)絡的，因此不要忘記在你的AndroidManifest.xml中添加如下權(quán)限：

<uses-permission android:name="android.permission.INTERNET" /> 

好了，就是這么簡單，如果你現(xiàn)在運行一下程序，并發(fā)出這樣一條HTTP請求，就會看到LogCat中會打印出如下圖所示的數(shù)據(jù)。

沒錯，百度返回給我們的就是這樣一長串的HTML代碼，雖然我們看起來會有些吃力，但是瀏覽器卻可以輕松地對這段HTML代碼進行解析，然后將百度的首頁展現(xiàn)出來。

這樣的話，一個最基本的HTTP發(fā)送與響應的功能就完成了。你會發(fā)現(xiàn)根本還沒寫幾行代碼就輕易實現(xiàn)了這個功能，主要就是進行了以下三步操作：

(1). 創(chuàng)建一個RequestQueue對象。

(2). 創(chuàng)建一個StringRequest對象。

(3). 將StringRequest對象添加到RequestQueue里面。

不過大家都知道，HTTP的請求類型通常有兩種，GET和POST，剛才我們使用的明顯是一個GET請求，那么如果想要發(fā)出一條POST請求應該怎么做呢？StringRequest中還提供了另外一種四個參數(shù)的構(gòu)造函數(shù)，其中第一個參數(shù)就是指定請求類型的，我們可以使用如下方式進行指定：

StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener); 
可是這只是指定了HTTP請求方式是POST，那么我們要提交給服務器的參數(shù)又該怎么設(shè)置呢？很遺憾，StringRequest中并沒有提供設(shè)置POST參數(shù)的方法，但是當發(fā)出POST請求的時候，Volley會嘗試調(diào)用StringRequest的父類——Request中的getParams()方法來獲取POST參數(shù)，那么解決方法自然也就有了，我們只需要在StringRequest的匿名類中重寫getParams()方法，在這里設(shè)置POST參數(shù)就可以了，代碼如下所示：

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; 
 } 
}; 

你可能會說，每次都這樣用起來豈不是很累？連個設(shè)置POST參數(shù)的方法都沒有。但是不要忘記，Volley是開源的，只要你愿意，你可以自由地在里面添加和修改任何的方法，輕松就能定制出一個屬于你自己的Volley版本。

3.5 JsonRequest的用法
學完了最基本的StringRequest的用法，我們再來進階學習一下JsonRequest的用法。類似于StringRequest，JsonRequest也是繼承自Request類的，不過由于JsonRequest是一個抽象類，因此我們無法直接創(chuàng)建它的實例，那么只能從它的子類入手了。JsonRequest有兩個直接的子類，JsonObjectRequest和JsonArrayRequest，從名字上你應該能就看出它們的區(qū)別了吧？一個是用于請求一段JSON數(shù)據(jù)的，一個是用于請求一段JSON數(shù)組的。

至于它們的用法也基本上沒有什么特殊之處，先new出一個JsonObjectRequest對象，如下所示：

JsonObjectRequest jsonObjectRequest = new JsonObjectRequest("http://m.weather.com.cn/data/101010100.html", null, 
  new Response.Listener<JSONObject>() { 
   @Override 
   public void onResponse(JSONObject response) { 
    Log.d("TAG", response.toString()); 
   } 
  }, new Response.ErrorListener() { 
   @Override 
   public void onErrorResponse(VolleyError error) { 
    Log.e("TAG", error.getMessage(), error); 
   } 
  }); 

可以看到，這里我們填寫的URL地址是http://m.weather.com.cn/data/101010100.html，這是中國天氣網(wǎng)提供的一個查詢天氣信息的接口，響應的數(shù)據(jù)就是以JSON格式返回的，然后我們在onResponse()方法中將返回的數(shù)據(jù)打印出來。

最后再將這個JsonObjectRequest對象添加到RequestQueue里就可以了，如下所示：

mQueue.add(jsonObjectRequest); 

這樣當HTTP通信完成之后，服務器響應的天氣信息就會回調(diào)到onResponse()方法中，并打印出來?，F(xiàn)在運行一下程序，發(fā)出這樣一條HTTP請求，就會看到LogCat中會打印出如下圖所示的數(shù)據(jù)。

3.6. 使用自己定制的request

我們也可以通過繼承Request根據(jù)自己的需求來定制自己的request

@Override 
protected Response parseNetworkResponse(NetworkResponse response) { 
 try { 
  String json = new String( 
    response.data, HttpHeaderParser.parseCharset(response.headers)); 
  return Response.success( 
    gson.fromJson(json, clazz), HttpHeaderParser.parseCacheHeaders(response)); 
 } catch (UnsupportedEncodingException e) { 
  return Response.error(new ParseError(e)); 
 } catch (JsonSyntaxException e) { 
  return Response.error(new ParseError(e)); 
 } 
} 

這段代碼節(jié)選自： https://gist.github.com/ficusk/5474673

里面使用的gson（com.google.gson.Gson）是JSON的序列化和反序列化的庫，可以在JSON和java model object之間進行轉(zhuǎn)換。

以下是使用自定制request的例子：

mRequestQueue.add( new GsonRequest(url, ListResponse.class, null, 
 new Listener() { 
  public void onResponse(ListResponse response) { 
   appendItemsToList(response.item); 
   notifyDataSetChanged(); 
  } 
 } 
} 

4. Volley的架構(gòu)設(shè)計

Volley使用了線程池來作為基礎(chǔ)結(jié)構(gòu)，主要分為主線程，cache線程和network線程。
主線程和cache線程都只有一個，而NetworkDispatcher線程可以有多個，這樣能解決比并行問題。如下圖:

如果在一個Activity里面啟動了網(wǎng)絡請求，而在這個網(wǎng)絡請求還沒返回結(jié)果的時候，如果Activity被結(jié)束了，則我們需要寫如下代碼作為防守：

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

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

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

Volley里所有的請求結(jié)果會返回給主進程，如果在主進程里取消了某些請求，則這些請求將不會被返回給主線程。
比如，可以針對某些個request做取消操作：

@Override 
public void onStop() { 
 for (Request <?> req : mInFlightRequests) { 
  req.cancel(); 
 } 
 ... 
} 

或者，取消這個隊列里的所有請求：

@Override pubic void onStop() { 
 mRequestQueue.cancelAll(this); 
 ... 
} 

也可以根據(jù)RequestFilter或者Tag來終止某些請求：

@Override public void onStop() { 
 mRequestQueue.cancelAll( new RequestFilter() {}) 
 ... 
 // or 
 mRequestQueue.cancelAll(new Object()); 
 ... 

5.總結(jié)

從演講的例子來看，Volley應該是簡化了網(wǎng)絡通信的一些開發(fā)，特別是針對如下兩種情況：

• JSON對象
• 圖片加載

但是這個東西也有不實用的地方，比如大數(shù)據(jù)（large payloads ），流媒體，這些case，還需要使用原始的方法，比如Download Manager等。

總之，如果你要編寫網(wǎng)絡程序，是不是可以考慮開始使用Volley呢？

最新評論