標籤:
Volley首頁 https://android.googlesource.com/platform/frameworks/volley
http://www.youtube.com/watch?v=yhv8l9F44qo&feature=player_embedded
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庫先複製一個下來:
[java] view plaincopy
- git clone https://android.googlesource.com/platform/frameworks/volley
然後編譯為jar包,再在自己的工程裡import進來。
注意,這個庫要求最低SDK版本為Froyo,即至少要設定android:minSdkVersion為8以上。
3.使用例子
下面簡單看看如何使用Volley
3.1. 最簡單的get請求
這個例子很簡單,從網路取得JSON對象,然後列印出來。
[java] view plaincopy
- 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] view plaincopy
- // 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] view plaincopy
- mImageView.setImageUrl(url, imageLoader)
來設定。而且,這個控制項在被從父控制項detach的時候,會自動取消網路請求的,即完全不用我們擔心相關網路請求的生命週期問題。
範例程式碼如下:
[java] view plaincopy
- 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] view plaincopy
- mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache());
ImageLoader建構函式的第二個參數是一個ImageCache的執行個體(嚴格來說,是實現ImageCache介面的某具體類的執行個體)
ImageCache的定義如下(在ImageLoader.java裡):
[java] view plaincopy
- /**
- * 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
[java] view plaincopy
- @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] view plaincopy
- 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] view plaincopy
- @Override public void onPostExecute(Result r) {
- if (getActivity() == null) {
- return;
- }
- // ...
- }
Activity被終止之後,如果繼續使用其中的Context等,除了無辜的浪費CPU,電池,網路等資源,有可能還會導致程式crash,所以,我們需要處理這種一場情況。
使用Volley的話,我們可以在Activity停止的時候,同時取消所有或部分未完成的網路請求。
Volley裡所有的請求結果會返回給主進程,如果在主進程裡取消了某些請求,則這些請求將不會被返回給主線程。
比如,可以針對某些個request做取消操作:
[java] view plaincopy
- @Override
- public void onStop() {
- for (Request <?> req : mInFlightRequests) {
- req.cancel();
- }
- ...
- }
或者,取消這個隊列裡的所有請求:
[java] view plaincopy
- @Override pubic void onStop() {
- mRequestQueue.cancelAll(this);
- ...
- }
也可以根據RequestFilter或者Tag來終止某些請求:
[java] view plaincopy
- @Override public void onStop() {
- mRequestQueue.cancelAll( new RequestFilter() {})
- ...
- // or
- mRequestQueue.cancelAll(new Object());
- ...
5.總結
從演講的例子來看,Volley應該是簡化了網路通訊的一些開發,特別是針對如下兩種情況:
但是這個東西也有不實用的地方,比如大資料(large payloads ),流媒體,這些case,還需要使用原始的方法,比如Download Manager等。
總之,如果你要編寫網路程式,是不是可以考慮開始使用Volley呢?
Google IO2013網路架構Volley 演講PDF下載: http://download.csdn.net/detail/t12x3456/5686041
Android 網路通訊架構Volley簡介(Google IO 2013)