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庫先克隆一個下來:
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的時候,會自動取消網路請求的,即完全不用我們擔心相關網路請求的生命週期問題。
示例程式碼如下:
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實現例子,請參考:
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));
}
}
裡面使用的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執行緒可以有多個,這樣能解決比並行問題。如下圖:
如果在一個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應該是簡化了網路通訊的一些開發,特別是針對如下兩種情況:
- JSON物件
- 圖片載入
但是這個東西也有不實用的地方,比如大資料(large payloads ),流媒體,這些case,還需要使用原始的方法,比如Download Manager等。
總之,如果你要編寫網路程式,是不是可以考慮開始使用Volley呢?