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庫先克隆一個下來: 架構
- git clone https://android.googlesource.com/platform/frameworks/volley
- 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對象,而後打印出來。
- 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();
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);
- // 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,這個控件的圖片屬性能夠經過
- mImageView.setImageUrl(url, imageLoader)
- mImageView.setImageUrl(url, imageLoader)
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);
- 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。
另外,注意這裏:
- mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache());
- mImageLoader = new ImageLoader(mRequestQueue, new BitmapLruCache());
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);
- }
- /**
- * 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);
}
下面的網址一個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));
- }
- }
- @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的例子:
- 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();
- }
- }
- }
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;
- }
- // ...
- }
- @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作取消操做:
- @Override
- public void onStop() {
- for (Request <?> req : mInFlightRequests) {
- req.cancel();
- }
- ...
- }
- @Override
- public void onStop() {
- for (Request <?> req : mInFlightRequests) {
- req.cancel();
- }
- ...
- }
@Override
public void onStop() {
for (Request <?> req : mInFlightRequests) {
req.cancel();
}
...
}
或者,取消這個隊列裏的全部請求:
- @Override pubic void onStop() {
- mRequestQueue.cancelAll(this);
- ...
- }
- @Override pubic void onStop() {
- mRequestQueue.cancelAll(this);
- ...
- }
@Override pubic void onStop() {
mRequestQueue.cancelAll(this);
...
}
也能夠根據RequestFilter或者Tag來終止某些請求:
- @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());
- ...
@Override public void onStop() {
mRequestQueue.cancelAll( new RequestFilter() {})
...
// or
mRequestQueue.cancelAll(new Object());
...
5.總結
從演講的例子來看,Volley應該是簡化了網絡通訊的一些開發,特別是針對以下兩種狀況:
可是這個東西也有不實用的地方,好比大數據(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