Android Volley框架使用详解

时间:2022-05-03 15:26:47

Volley了解


Volley的中文翻译为“齐射、并发”,是在2013年的Google大会上发布的一款Android平台网络通信库,具有网络请求的处理、小图片的异步加载和缓存等功能,能够帮助 Android APP 更方便地执行网络操作,而且更快速高效。

在Google IO的演讲上,其配图是一幅发射火弓箭的图,有点类似流星。这表示,Volley特别适合数据量不大但是通信频繁的场景。见下图:
Android Volley框架使用详解

而对于大数据量的网络操作,比如说下载文件等,Volley的表现就会非常糟糕。

下图所示的这些应用都是属于数据量不大,但网络通信频繁的,因此非常适合使用Volley。
Android 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的使用


1、StringRequest(字符串请求)

GET请求

//1.创建出请求队列
RequestQueue mRequestQueue = Volley.newRequestQueue(this);

//2.创建出来字符串请求对象: StringRequest
/**
* 1param: 请求方式 get/post
* 2p:请求的url地址
* 3p:请求成功后的接口回调
* 4p:请求失败后回调
* 5p:成功的监听,通过参数返回请求到的数据
* 6p:失败的监听,失败在这里处理
*/

StringRequest mStrReq = new StringRequest(Request.Method.GET, "https://www.baidu.com",
new Response.Listener<String>() {
@Override
public void onResponse(String response) {
// 这个方法运行在主线程中,可以直接更新ui
// 通过参数返回请求到的数据
mTv_result.setText(response);
Toast.makeText(StrReqActivity.this, "下载成功", Toast.LENGTH_SHORT).show();
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
// 这个方法运行在主线程中,可以直接更新ui
// 失败在这里处理
Toast.makeText(StrReqActivity.this, "下载失败", Toast.LENGTH_SHORT).show();
}
});
//设置Tag值
mStrReq.setTag("100");
btn_req.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
//3.把请求对象添加到请求队列中,会自动发出请求
mRequestQueue.add(mStrReq);
}
});

POST请求

String url_post = "http://zhushou.72g.com/app/gift/gift_list/";
StringRequest mStrReq = new StringRequest(Request.Method.POST, url_post
, new Response.Listener<String>() {
@Override
public void onResponse(String response) {
//
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
//
}
}) {//这里需要重写getParams方法
@Override
protected Map<String, String> getParams() throws AuthFailureError {
//把post的请求参数,放入请求体中
//请求条件:platform=2&gifttype=1&compare=60841c5b7c69a1bbb3f06536ed685a48
Map<String, String> params = new HashMap<>();
params.put("platform", "2");
params.put("gifttype", "1");
params.put("compare", "60841c5b7c69a1bbb3f06536ed685a48");
return params;
}
};
//点击加入到请求队列中
btn_req_json.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
mRequestQueue.add(mStrReq);
}
});

附:
Volley支持手动/自动取消请求,可以在Activity销毁的时候手动取消请求:

@Override
protected void onDestroy() {
super.onDestroy();
//取消请求:有三种方式
//1. 取消对应的请求对象
mStrReq.cancel();
//2. 取消请求队列中对应tag的请求
//mRequestQueue.cancelAll("100");
//3. 取消请求队列中所有的请求
//mRequestQueue.cancelAll(this);
}

2、JsonObjectRequest与JsonArrayRequest(json数据请求)

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) {

}
});

3、ImageRequest图片请求

//1.首先有请求队列
RequestQueue requestQueue = Volley.newRequestQueue(this);
//2.请求对象
//1) 图片下载的url
//2) 下载成功后,返回一个bitmap对象
//3)4) 最大宽度和最大高度,如果超过最大宽度和高度,会进行压缩到你设置的宽度和高度,0不限制
//5) 图片加载的形式
//6)图片显示的质量:RGB_565: 每个像素2字节 ARGB_8888:每个像素占4个字节
//7)下载图片失败后,在这里边处理
ImageRequest imgRequest = new ImageRequest(url_img, new Response.Listener<Bitmap>() {
@Override
public void onResponse(Bitmap response) {
//显示成功的图片
iv_show.setImageBitmap(response);
}
}, 0, 0, ImageView.ScaleType.FIT_XY, Bitmap.Config.RGB_565, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
//设置失败的图片
iv_show.setBackgroundResource(R.mipmap.ic_launcher);
}
});

4、ImageLoader图片加载

//1、首先有请求队列
RequestQueue requestQueue = Volley.newRequestQueue(this);
//2、创建出ImageLoader对象
ImageLoader loader = new ImageLoader(requestQueue, new BitmapCache());
//3、调用ImageLoader的get方法设置图片
//getImageListener中的三个参数:1,下载好的图片设置给哪个控件 2,默认图片 3.下载失败的图片
loader.get(url_img, ImageLoader.getImageListener(iv_show, R.mipmap.ic_default, R.mipmap.ic_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

NetworkImageView拓展了ImageView實現了下載的功能,(相对于使用普通的ImageView,避免由于控件重用带来的图片錯位的问题)。使用方法:

  1. 把使用到ImageView的地方替換成NetworkImageView
  2. 初始化ImageLoader
  3. 通过NetWorkImageView对象设置下载图片的配置信息(如最大宽高等)
  4. 通过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); //下载图片

VolleyUtils

對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);



(完畢,如果您(❤ ω ❤)喜歡,請支持點贊)