Android 網絡通訊框架Volley簡介(Google IO 2013)

1. 什麼是Volley html

在這以前,咱們在程序中須要和網絡通訊的時候,大致使用的東西莫過於AsyncTaskLoader,HttpURLConnection,AsyncTask,HTTPClient(Apache)等,今年的Google I/O 2013上,Volley發佈了。Volley是Android平臺上的網絡通訊庫,能使網絡通訊更快,更簡單,更健壯。
這是Volley名稱的由來: a burst or emission of many things or a large amount at once
在Google IO的演講上,其配圖是一幅發射火弓箭的圖,有點相似流星。見下圖

其實,從這幅圖,咱們也能夠看出來,Volley特別適合數據量不大可是通訊頻繁的場景。 java

1.1. Volley引入的背景
在之前,咱們可能面臨以下不少麻煩的問題。 android

好比之前從網上下載圖片的步驟多是這樣的流程: git

  • 在ListAdapter#getView()裏開始圖像的讀取。
  • 經過AsyncTask等機制使用HttpURLConnection從服務器去的圖片資源
  • 在AsyncTask#onPostExecute()裏設置相應ImageView的屬性。

而在Volley下,只須要一個函數便可,詳細見後面的例子。 github

再好比,屏幕旋轉的時候,有時候會致使再次從網絡取得數據。爲了不這種沒必要要的網絡訪問,咱們可能須要本身寫不少針對各類狀況的處理,好比cache什麼的。 json

再有,好比ListView的時候,咱們滾動過快,可能致使有些網絡請求返回的時候,早已經滾過了當時的位置,根本不必顯示在list裏了,雖然咱們能夠經過ViewHolder來保持url等來實現防止兩次取得,可是那些已經沒有必需要的數據,仍是會浪費系統的各類資源。 緩存

1.2. Volley提供的功能
簡單來講,它提供了以下的便利功能: 服務器

  • JSON,圖像等的異步下載;
  • 網絡請求的排序(scheduling)
  • 網絡請求的優先級處理
  • 緩存
  • 多級別取消請求
  • 和Activity和生命週期的聯動(Activity結束時同時取消全部網絡請求)

2. 使用前的準備 網絡

引入Volley很是簡單,首先,從git庫先克隆一個下來: 架構

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

而後編譯爲jar包,再在本身的工程裏import進來。

注意,這個庫要求最低SDK版本爲Froyo,即至少要設置android:minSdkVersion爲8以上。

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

3.1. 最簡單的get請求
這個例子很簡單,從網絡取得JSON對象,而後打印出來。

  1. mQueue = Volley.newRequestQueue(getApplicationContext());  
  2. mQueue.add(new JsonObjectRequest(Method.GET, url, null,  
  3.             new Listener() {  
  4.                 @Override  
  5.                 public void onResponse(JSONObject response) {  
  6.                     Log.d(TAG, "response : " + response.toString());  
  7.                 }  
  8.             }, null));  
  9. mQueue.start();  
  1. mQueue = Volley.newRequestQueue(getApplicationContext());  
  2. mQueue.add(new JsonObjectRequest(Method.GET, url, null,  
  3.             new Listener() {  
  4.                 @Override  
  5.                 public void onResponse(JSONObject response) {  
  6.                     Log.d(TAG, "response : " + response.toString());  
  7.                 }  
  8.             }, null));  
  9. mQueue.start();  
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設置圖片源

  1. // imageView是一個ImageView實例  
  2. // ImageLoader.getImageListener的第二個參數是默認的圖片resource id  
  3. // 第三個參數是請求失敗時候的資源id,能夠指定爲0  
  4. ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_menu_rotate, android.R.drawable.ic_delete);  
  5. mImageLoader.get(url, listener);  
  1. // imageView是一個ImageView實例   
  2. // ImageLoader.getImageListener的第二個參數是默認的圖片resource id   
  3. // 第三個參數是請求失敗時候的資源id,能夠指定爲0   
  4. ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_menu_rotate, android.R.drawable.ic_delete);  
  5. mImageLoader.get(url, listener);  
// imageView是一個ImageView實例
// ImageLoader.getImageListener的第二個參數是默認的圖片resource id
// 第三個參數是請求失敗時候的資源id,能夠指定爲0
ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_menu_rotate, android.R.drawable.ic_delete);
mImageLoader.get(url, listener);

ImageLoader的方法都須要從主線程裏來調用。

3.3. 使用NetworkImageView

Volley提供了一個新的控件NetworkImageView來代替傳統的ImageView,這個控件的圖片屬性能夠經過

  1. mImageView.setImageUrl(url, imageLoader)  
  1. mImageView.setImageUrl(url, imageLoader)  
mImageView.setImageUrl(url, imageLoader)

來設定。並且,這個控件在被從父控件detach的時候,會自動取消網絡請求的,即徹底不用咱們擔憂相關網絡請求的生命週期問題。
示例代碼以下:

  1. mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache());  
  2. ... ...  
  3.    
  4. if(holder.imageRequest != null) {  
  5.     holder.imageRequest.cancel();  
  6. }  
  7. holder.imageRequest = mImageLoader.get(BASE_UR + item.image_url, holder.imageView, R.drawable.loading, R.drawable.error);  
  1. mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache());  
  2. ... ...  
  3.    
  4. if(holder.imageRequest != null) {  
  5.     holder.imageRequest.cancel();  
  6. }  
  7. holder.imageRequest = mImageLoader.get(BASE_UR + item.image_url, holder.imageView, R.drawable.loading, R.drawable.error);  
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。

另外,注意這裏:

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

ImageLoader構造函數的第二個參數是一個ImageCache的實例(嚴格來講,是實現ImageCache接口的某具體類的實例)
ImageCache的定義以下(在ImageLoader.java裏):

  1. /** 
  2.  * Simple cache adapter interface. If provided to the ImageLoader, it 
  3.  * will be used as an L1 cache before dispatch to Volley. Implementations 
  4.  * must not block. Implementation with an LruCache is recommended. 
  5.  */  
  6. public interface ImageCache {  
  7.     public Bitmap getBitmap(String url);  
  8.     public void putBitmap(String url, Bitmap bitmap);  
  9. }  
  1. /** 
  2.  * Simple cache adapter interface. If provided to the ImageLoader, it 
  3.  * will be used as an L1 cache before dispatch to Volley. Implementations 
  4.  * must not block. Implementation with an LruCache is recommended. 
  5.  */  
  6. public interface ImageCache {  
  7.     public Bitmap getBitmap(String url);  
  8.     public void putBitmap(String url, Bitmap bitmap);  
  9. }  
/**
 * 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);
}

下面的網址一個lru的cache實現例子,請參考:

https://github.com/suwa-yuki/VolleySample/blob/master/src/jp/classmethod/android/sample/volley/BitmapCache.java

3.5. 使用本身定製的request

咱們也能夠經過繼承Request根據本身的需求來定製本身的request

  1. @Override  
  2. protected Response parseNetworkResponse(NetworkResponse response) {  
  3.     try {  
  4.         String json = new String(  
  5.                 response.data, HttpHeaderParser.parseCharset(response.headers));  
  6.         return Response.success(  
  7.                 gson.fromJson(json, clazz), HttpHeaderParser.parseCacheHeaders(response));  
  8.     } catch (UnsupportedEncodingException e) {  
  9.         return Response.error(new ParseError(e));  
  10.     } catch (JsonSyntaxException e) {  
  11.         return Response.error(new ParseError(e));  
  12.     }  
  13. }  
  1. @Override  
  2. protected Response parseNetworkResponse(NetworkResponse response) {  
  3.     try {  
  4.         String json = new String(  
  5.                 response.data, HttpHeaderParser.parseCharset(response.headers));  
  6.         return Response.success(  
  7.                 gson.fromJson(json, clazz), HttpHeaderParser.parseCacheHeaders(response));  
  8.     } catch (UnsupportedEncodingException e) {  
  9.         return Response.error(new ParseError(e));  
  10.     } catch (JsonSyntaxException e) {  
  11.         return Response.error(new ParseError(e));  
  12.     }  
  13. }  
@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));
    }
}

這段代碼節選自: https://gist.github.com/ficusk/5474673

裏面使用的gson(com.google.gson.Gson)是JSON的序列化和反序列化的庫,能夠在JSON和java model object之間進行轉換。

如下是使用自定製request的例子:

  1. mRequestQueue.add( new GsonRequest(url, ListResponse.classnull,  
  2.     new Listener() {  
  3.         public void onResponse(ListResponse response) {  
  4.             appendItemsToList(response.item);  
  5.             notifyDataSetChanged();  
  6.         }  
  7.     }  
  8. }  
  1. mRequestQueue.add( new GsonRequest(url, ListResponse.classnull,  
  2.     new Listener() {  
  3.         public void onResponse(ListResponse response) {  
  4.             appendItemsToList(response.item);  
  5.             notifyDataSetChanged();  
  6.         }  
  7.     }  
  8. }  
mRequestQueue.add( new GsonRequest(url, ListResponse.class, null,
    new Listener() {
        public void onResponse(ListResponse response) {
            appendItemsToList(response.item);
            notifyDataSetChanged();
        }
    }
}

4. Volley的架構設計

Volley使用了線程池來做爲基礎結構,主要分爲主線程,cache線程和network線程。
主線程和cache線程都只有一個,而NetworkDispatcher線程能夠有多個,這樣能解決比並行問題。以下圖:


若是在一個Activity裏面啓動了網絡請求,而在這個網絡請求還沒返回結果的時候,若是Activity被結束了,則咱們須要寫以下代碼做爲防守:

  1. @Override public void onPostExecute(Result r) {  
  2.     if (getActivity() == null) {  
  3.         return;  
  4.     }  
  5.     // ...  
  6. }  
  1. @Override public void onPostExecute(Result r) {  
  2.     if (getActivity() == null) {  
  3.         return;  
  4.     }  
  5.     // ...   
  6. }  
@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. }  
  1. @Override  
  2. public void onStop() {  
  3.     for (Request <?> req : mInFlightRequests) {  
  4.         req.cancel();  
  5.     }  
  6.     ...  
  7. }  
@Override
public void onStop() {
    for (Request <?> req : mInFlightRequests) {
        req.cancel();
    }
    ...
}

或者,取消這個隊列裏的全部請求:

  1. @Override pubic void onStop() {  
  2.     mRequestQueue.cancelAll(this);  
  3.     ...  
  4. }  
  1. @Override pubic void onStop() {  
  2.     mRequestQueue.cancelAll(this);  
  3.     ...  
  4. }  
@Override pubic void onStop() {
    mRequestQueue.cancelAll(this);
    ...
}

也能夠根據RequestFilter或者Tag來終止某些請求:

  1. @Override public void onStop() {  
  2.     mRequestQueue.cancelAll( new RequestFilter() {})  
  3.     ...  
  4.     // or  
  5.     mRequestQueue.cancelAll(new Object());  
  6.     ...  
  1. @Override public void onStop() {  
  2.     mRequestQueue.cancelAll( new RequestFilter() {})  
  3.     ...  
  4.     // or   
  5.     mRequestQueue.cancelAll(new Object());  
  6.     ...  
@Override public void onStop() {
    mRequestQueue.cancelAll( new RequestFilter() {})
    ...
    // or
    mRequestQueue.cancelAll(new Object());
    ...

5.總結

從演講的例子來看,Volley應該是簡化了網絡通訊的一些開發,特別是針對以下兩種狀況:

  • JSON對象
  • 圖片加載

可是這個東西也有不實用的地方,好比大數據(large payloads ),流媒體,這些case,還須要使用原始的方法,好比Download Manager等。
總之,若是你要編寫網絡程序,是否是能夠考慮開始使用Volley呢?
更多內容,能夠從源代碼獲取,見下面附錄:

附錄、參考link:
1. Volley主頁 https://android.googlesource.com/platform/frameworks/volley
2. Google I/O Volley演講 http://www.youtube.com/watch?v=yhv8l9F44qo&feature=player_embedded
3. Android Tipshttp://dev.classmethod.jp/smartphone/android/android-tips-51-volley/
4. Google I/O 2013 – Android : Volley: Easy, Fast Networking for Android  http://y-anz-m.blogspot.jp/2013/05/google-io-2013-android-volley-easy-fast.html?m=1


Google IO2013網絡框架Volley 演講PDF下載http://download.csdn.net/detail/t12x3456/5686041

相關文章
相關標籤/搜索