Volley的中文翻译为“齐射、并发”,是在2013年的Google大会上发布的一款Android平台网络通信库,具有网络请求的处理、小图片的异步加载和缓存等功能,能够帮助 Android APP 更方便地执行网络操作,而且更快速高效。
在Google IO的演讲上,其配图是一幅发射火弓箭的图,有点类似流星。这表示,Volley特别适合数据量不大但是通信频繁的场景。见下图:
而对于大数据量的网络操作,比如说下载文件等,Volley的表现就会非常糟糕。
下图所示的这些应用都是属于数据量不大,但网络通信频繁的,因此非常适合使用Volley。
Volley 的优点:
自动调度网络请求;高并发网络连接;通过标准的 HTTP cache coherence(高速缓存一致性)缓存磁盘和内 存透明的响应;支持指定请求的优先级;网络请求cancel机制。我们可以取消单个请求,或者指定取消请求队列中的一个区域;框架容易被定制,例如,定制重试或者回退功能;包含了调试与追踪工具;github地址: https://github.com/mcxiaoke/android-volley
Eclipse的用户: 下载到github上或者maven上下载Volley的jar包volley.jar,放在libs文件夹内;
Android Studio的用户: 在build.gradle中加入:
compile 'com.mcxiaoke.volley:library:1.0.19'附: Volley支持手动/自动取消请求,可以在Activity销毁的时候手动取消请求:
@Override protected void onDestroy() { super.onDestroy(); //取消请求:有三种方式 //1. 取消对应的请求对象 mStrReq.cancel(); //2. 取消请求队列中对应tag的请求 //mRequestQueue.cancelAll("100"); //3. 取消请求队列中所有的请求 //mRequestQueue.cancelAll(this); }JsonObjectRequest请求(一样要加到请求队列中才会自动加载)返回的是一个JSONObject对象,创建方法如下:
JsonObjectRequest jsonObjectRequest =new JsonObjectRequest(Request.Method.GET, url, new Response.Listener<JSONObject>() { @Override public void onResponse(JSONObject response) { } }, new Response.ErrorListener() { @Override public void onErrorResponse(VolleyError error) { } });ImageLoader的get的重载方法一览:
public ImageContainer get(String requestUrl, final ImageListener listener) { return get(requestUrl, listener, 0, 0); } public ImageContainer get(String requestUrl, ImageListener imageListener, int maxWidth, int maxHeight) { return get(requestUrl, imageListener, maxWidth, maxHeight, ScaleType.CENTER_INSIDE); } public ImageContainer get(String requestUrl, ImageListener imageListener, int maxWidth, int maxHeight, ScaleType scaleType) { ~~~ }ImageLoader.getImageListener源码一览:
/** * The default implementation of ImageListener which handles basic functionality * of showing a default image until the network response is received, at which point * it will switch to either the actual image or the error image. * @param view The imageView that the listener is associated with. * @param defaultImageResId Default image resource ID to use, or 0 if it doesn't exist. * @param errorImageResId Error image resource ID to use, or 0 if it doesn't exist. */ public static ImageListener getImageListener(final ImageView view, final int defaultImageResId, final int errorImageResId) { return new ImageListener() { @Override public void onErrorResponse(VolleyError error) { if (errorImageResId != 0) { view.setImageResource(errorImageResId); } } @Override public void onResponse(ImageContainer response, boolean isImmediate) { if (response.getBitmap() != null) { view.setImageBitmap(response.getBitmap()); } else if (defaultImageResId != 0) { view.setImageResource(defaultImageResId); } } }; }这个方法返回一个默认的监听器,来给ImageView设置不同状态下显示的图片。参数defaultImageResId,errorImageResId,可设置0,表示没有默认的图片id和加载错误的图片id。
/** *缓存bitmap的类 */ public class BitmapCache implements ImageLoader.ImageCache { /** * LruCache最近最少使用的算法 :内存缓存。。。 * 当内存不充足时,会清除最近最少使用的一些图片。 */ private LruCache<String, Bitmap> mCache; public BitmapCache() { //获得到当前应用分配的最大内存 // 一般分1/8内存给图片做缓存用 int maxSize = (int) (Runtime.getRuntime().maxMemory() / 8); mCache = new LruCache<String, Bitmap>(maxSize) { @Override protected int sizeOf(String key, Bitmap value) { return value.getByteCount(); //返回当前要缓存图片的大小 } }; } @Override public Bitmap getBitmap(String url) { return mCache.get(url); } @Override public void putBitmap(String url, Bitmap bitmap) { if (getBitmap(url) == null){ //如果当前缓存中没有url对应的图片,我们再存到内存缓存 mCache.put(url, bitmap); } } }NetworkImageView拓展了ImageView實現了下載的功能,(相对于使用普通的ImageView,避免由于控件重用带来的图片錯位的问题)。使用方法:
把使用到ImageView的地方替換成NetworkImageView初始化ImageLoader通过NetWorkImageView对象设置下载图片的配置信息(如最大宽高等)通过NetWorkImageView对象调用setImageUrl方法进行图片的下载示例如下:
//事先初始化好的RequestQueue和ImageLoader RequestQueue requestQueue = Volley.newRequestQueue(this); ImageLoader imageLoader = new ImageLoader(requestQueue, new BitmapCache()); //NetWorkImageView netiv.setDefaultImageResId(R.mipmap.ic_default); //设置默认的图片的id netiv.setErrorImageResId(R.mipmap.ic_error); //设置下载失败后的图片的id netiv.setImageUrl(url_img, imageLoader); //下载图片對Volley進行再一次的封裝,方便我們的使用:
package com.alex.week06_02.utils; import android.content.Context; import android.graphics.Bitmap; import android.widget.ImageView; import com.alex.week06_02.BitmapCache; import com.android.volley.AuthFailureError; import com.android.volley.RequestQueue; import com.android.volley.Response; import com.android.volley.toolbox.ImageLoader; import com.android.volley.toolbox.ImageRequest; import com.android.volley.toolbox.StringRequest; import com.android.volley.toolbox.Volley; import java.util.Map; /** * 單例模式對Volley進行簡單封裝 * @author noonecode */ public class VolleyUtils { private static VolleyUtils mInstance; private RequestQueue mRequestQueue; private ImageLoader mImageLoader; private ImageLoader.ImageCache mCache; private VolleyUtils(Context context) { mRequestQueue = Volley.newRequestQueue(context); mCache = new BitmapCache(); mImageLoader = new ImageLoader(mRequestQueue, mCache); } //單例模式 public VolleyUtils newInstance(Context context) { if (mInstance == null) { synchronized (VolleyUtils.class) { if (mInstance == null) { mInstance = new VolleyUtils(context); } } } return mInstance; } public RequestQueue getRequestQueue() { return mRequestQueue; } public ImageLoader getImageLoader(){ return mImageLoader; } /** * 发送一个字符串请求 * @param method 请求方式GET/POST * @param url 请求的链接 * @param params POST请求时的参数,可为null * @param listener 请求返回数据的监听器 * @param errorListener 请求发生错误的监听器 */ public void sendStringRequest(final int method, String url, final Map<String, String> params, Response.Listener<String> listener, Response.ErrorListener errorListener){ StringRequest stringRequest = new StringRequest(method, url, listener, errorListener){ @Override protected Map<String, String> getParams() throws AuthFailureError { if (method == Method.POST) { return params; } return null; } }; mRequestQueue.add(stringRequest); } /** * 发送一个字符串请求 * @param url 图片的链接 * @param listener 成功获取到Bitmap的监听器 * @param maxWidth 最大宽度,0则不限制 * @param maxHeight 最大高度,0则不限制 * @param scaleType ImageView的拉伸属性 * @param decodeConfig 图片的格式 * @param errorListener 失败的监听器 */ public void sendImageRequest(String url, Response.Listener<Bitmap> listener, int maxWidth, int maxHeight, ImageView.ScaleType scaleType, Bitmap.Config decodeConfig, Response.ErrorListener errorListener){ ImageRequest imageRequest = new ImageRequest(url, listener, maxWidth, maxHeight, scaleType, decodeConfig, errorListener); mRequestQueue.add(imageRequest); } }使用方法: 1. 首先通過單例的方法獲得出VolleyUtils的對象
private VolleyUtils mVolleyUtils; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //~~~ mVolleyUtils = VolleyUtils.newInstance(this); }發出一個字符串的請求:
mVolleyUtils.sendStringRequest(Request.Method.GET, "https://www.baidu.com", null, new Response.Listener<String>() { @Override public void onResponse(String response) { tvShow.setText(response); } }, null);發出一個圖片請求:
mVolleyUtils.sendImageRequest("https://www.baidu.com/img/bd_logo1.png", new Response.Listener<Bitmap>() { @Override public void onResponse(Bitmap response) { iv_show.setImageBitmap(response); } }, 0, 0, ImageView.ScaleType.CENTER, Bitmap.Config.RGB_565, null);(完畢,如果您(❤ ω ❤)喜歡,請支持點贊)