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

1. 什麼是Volley

在這之前,我們在程序中需要和網絡通信的時候,大體使用的東西莫過於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特別適合數據量不大但是通信頻繁的場景。

1.1. Volley引入的背景
在以前,我們可能面臨如下很多麻煩的問題。

比如以前從網上下載圖片的步驟可能是這樣的流程:

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

再比如,屏幕旋轉的時候,有時候會導致再次從網絡取得數據。為瞭避免這種不必要的網絡訪問,我們可能需要自己寫很多針對各種情況的處理,比如cache什麼的。

再有,比如ListView的時候,我們滾動過快,可能導致有些網絡請求返回的時候,早已經滾過瞭當時的位置,根本沒必要顯示在list裡瞭,雖然我們可以通過ViewHolder來保持url等來實現防止兩次取得,但是那些已經沒有必須要的數據,還是會浪費系統的各種資源。

1.2. Volley提供的功能
簡單來說,它提供瞭如下的便利功能:

JSON,圖像等的異步下載;
網絡請求的排序(scheduling)
網絡請求的優先級處理
緩存
多級別取消請求
和Activity和生命周期的聯動(Activity結束時同時取消所有網絡請求)
2. 使用前的準備

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

然後編譯為jar包,再在自己的工程裡import進來。

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

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

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

[java]  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(); 

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設置圖片源

[java]  // 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); 

// 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,這個控件的圖片屬性可以通過

[java]  mImageView.setImageUrl(url, imageLoader) 

mImageView.setImageUrl(url, imageLoader)
來設定。而且,這個控件在被從父控件detach的時候,會自動取消網絡請求的,即完全不用我們擔心相關網絡請求的生命周期問題。
示例代碼如下:

[java]  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); 

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。

另外,註意這裡:

[java]  mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache()); 

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

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

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

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

 

3.5. 使用自己定制的request

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

[java]  @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)); 
    } 

@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的例子:

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

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被結束瞭,則我們需要寫如下代碼作為防守:

 

[java] @Override public void onPostExecute(Result r) { 
    if (getActivity() == null) { 
        return; 
    } 
    // …  

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

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

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

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

 

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

@Override
public void onStop() {
    for (Request <?> req : mInFlightRequests) {
        req.cancel();
    }
    …
}
或者,取消這個隊列裡的所有請求:

 

[java]  @Override pubic void onStop() { 
    mRequestQueue.cancelAll(this); 
    … 

@Override pubic void onStop() {
    mRequestQueue.cancelAll(this);
    …
}
也可以根據RequestFilter或者Tag來終止某些請求:

 

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

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

5.總結

從演講的例子來看,Volley應該是簡化瞭網絡通信的一些開發,特別是針對如下兩種情況:

 

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *