Android網絡通訊庫Volley簡介

時間 2019-11-06

原文原文鏈接

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什麼的。 shell

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

1.2. Volley提供的功能
簡單來講，它提供了以下的便利功能：緩存

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

2. 使用前的準備 服務器

引入Volley很是簡單，首先，從git庫先克隆一個下來：網絡

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

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

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

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

3.1. 最簡單的get請求
這個例子很簡單，從網絡取得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設置圖片源
// 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，這個控件的圖片屬性能夠經過

mImageView.setImageUrl(url, imageLoader)

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

NetworkImageView view = (NetworkImageView) findViewById(R.id.network_image_view);
view.setImageUrl(url, new ImageLoader(mQueue, new BitmapCache()));

3.4. 使用ImageLoader

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構造函數的第二個參數是一個ImageCache的實例（嚴格來講，是實現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);
}

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

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

3.5. 使用本身定製的request

咱們也能夠經過繼承Request根據本身的需求來定製本身的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));
    }
}

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

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

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

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線程能夠有多個，這樣能解決比並行問題。
具體能夠參考下圖，此圖節選自Google I/O 演講

Main Thread

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

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

Activity被終止以後，若是繼續使用其中的Context等，除了無辜的浪費CPU，電池，網絡等資源，有可能還會致使程序crash，因此，咱們須要處理這種一場狀況。

使用Volley的話，咱們能夠在Activity中止的時候，同時取消全部或部分未完成的網絡請求。

Volley裏全部的請求結果會返回給主進程，若是在主進程裏取消了某些請求，則這些請求將不會被返回給主線程。
好比，能夠針對某些個request作取消操做：

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

或者，取消這個隊列裏的全部請求：

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

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

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

5.總結

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