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

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

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

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

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

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

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

1.2. Volley提供的功能
簡(jiǎn)單來(lái)說(shuō)，它提供了如下的便利功能：

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

2. 使用前的準(zhǔn)備

引入Volley非常簡(jiǎn)單，首先，從git庫(kù)先克隆一個(gè)下來(lái)：

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

然后編譯為jar包，再在自己的工程里import進(jìn)來(lái)。

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

3.使用例子
下面簡(jiǎn)單看看如何使用Volley

3.1. 最簡(jiǎn)單的get請(qǐng)求
這個(gè)例子很簡(jiǎn)單，從網(wǎng)絡(luò)取得JSON對(duì)象，然后打印出來(lái)。

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是一個(gè)ImageView實(shí)例 
// ImageLoader.getImageListener的第二個(gè)參數(shù)是默認(rèn)的圖片resource id 
// 第三個(gè)參數(shù)是請(qǐng)求失敗時(shí)候的資源id，可以指定為0 
ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_menu_rotate, android.R.drawable.ic_delete); 
mImageLoader.get(url, listener); 

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

3.3. 使用NetworkImageView

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

mImageView.setImageUrl(url, imageLoader) 

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

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ù)的第二個(gè)參數(shù)是一個(gè)ImageCache的實(shí)例（嚴(yán)格來(lái)說(shuō)，是實(shí)現(xiàn)ImageCache接口的某具體類的實(shí)例）
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)址一個(gè)lru的cache實(shí)現(xiàn)例子，請(qǐng)參考：
https://github.com/suwa-yuki/VolleySample/blob/master/src/jp/classmethod/android/sample/volley/BitmapCache.java

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

RequestQueue mQueue = Volley.newRequestQueue(context); 

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

接下來(lái)為了要發(fā)出一條HTTP請(qǐng)求，我們還需要?jiǎng)?chuàng)建一個(gè)StringRequest對(duì)象，如下所示：

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出了一個(gè)StringRequest對(duì)象，StringRequest的構(gòu)造函數(shù)需要傳入三個(gè)參數(shù)，第一個(gè)參數(shù)就是目標(biāo)服務(wù)器的URL地址，第二個(gè)參數(shù)是服務(wù)器響應(yīng)成功的回調(diào)，第三個(gè)參數(shù)是服務(wù)器響應(yīng)失敗的回調(diào)。其中，目標(biāo)服務(wù)器地址我們填寫(xiě)的是百度的首頁(yè)，然后在響應(yīng)成功的回調(diào)里打印出服務(wù)器返回的內(nèi)容，在響應(yīng)失敗的回調(diào)里打印出失敗的詳細(xì)信息。

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

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

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

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

沒(méi)錯(cuò)，百度返回給我們的就是這樣一長(zhǎng)串的HTML代碼，雖然我們看起來(lái)會(huì)有些吃力，但是瀏覽器卻可以輕松地對(duì)這段HTML代碼進(jìn)行解析，然后將百度的首頁(yè)展現(xiàn)出來(lái)。

這樣的話，一個(gè)最基本的HTTP發(fā)送與響應(yīng)的功能就完成了。你會(huì)發(fā)現(xiàn)根本還沒(méi)寫(xiě)幾行代碼就輕易實(shí)現(xiàn)了這個(gè)功能，主要就是進(jìn)行了以下三步操作：

(1). 創(chuàng)建一個(gè)RequestQueue對(duì)象。

(2). 創(chuàng)建一個(gè)StringRequest對(duì)象。

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

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

StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener); 
可是這只是指定了HTTP請(qǐng)求方式是POST，那么我們要提交給服務(wù)器的參數(shù)又該怎么設(shè)置呢？很遺憾，StringRequest中并沒(méi)有提供設(shè)置POST參數(shù)的方法，但是當(dāng)發(fā)出POST請(qǐng)求的時(shí)候，Volley會(huì)嘗試調(diào)用StringRequest的父類——Request中的getParams()方法來(lái)獲取POST參數(shù)，那么解決方法自然也就有了，我們只需要在StringRequest的匿名類中重寫(xiě)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; 
 } 
}; 

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

3.5 JsonRequest的用法
學(xué)完了最基本的StringRequest的用法，我們?cè)賮?lái)進(jìn)階學(xué)習(xí)一下JsonRequest的用法。類似于StringRequest，JsonRequest也是繼承自Request類的，不過(guò)由于JsonRequest是一個(gè)抽象類，因此我們無(wú)法直接創(chuàng)建它的實(shí)例，那么只能從它的子類入手了。JsonRequest有兩個(gè)直接的子類，JsonObjectRequest和JsonArrayRequest，從名字上你應(yīng)該能就看出它們的區(qū)別了吧？一個(gè)是用于請(qǐng)求一段JSON數(shù)據(jù)的，一個(gè)是用于請(qǐng)求一段JSON數(shù)組的。

至于它們的用法也基本上沒(méi)有什么特殊之處，先new出一個(gè)JsonObjectRequest對(duì)象，如下所示：

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

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

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

mQueue.add(jsonObjectRequest); 

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

3.6. 使用自己定制的request

我們也可以通過(guò)繼承Request根據(jù)自己的需求來(lái)定制自己的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的序列化和反序列化的庫(kù)，可以在JSON和java model object之間進(jìn)行轉(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è)計(jì)

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

如果在一個(gè)Activity里面啟動(dòng)了網(wǎng)絡(luò)請(qǐng)求，而在這個(gè)網(wǎng)絡(luò)請(qǐng)求還沒(méi)返回結(jié)果的時(shí)候，如果Activity被結(jié)束了，則我們需要寫(xiě)如下代碼作為防守：

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

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

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

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

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

或者，取消這個(gè)隊(duì)列里的所有請(qǐng)求：

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

也可以根據(jù)RequestFilter或者Tag來(lái)終止某些請(qǐng)求：

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

5.總結(jié)

從演講的例子來(lái)看，Volley應(yīng)該是簡(jiǎn)化了網(wǎng)絡(luò)通信的一些開(kāi)發(fā)，特別是針對(duì)如下兩種情況：

• JSON對(duì)象
• 圖片加載

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

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

最新評(píng)論