版权声明：本文为LooperJing原创文章，转载请注明出处！
Volley是2013年Google I/O大会上推出了一个新的网络通信框架，特么今年都2016年年尾了，这两年新技术出来的真是多的花了眼睛。虽然是三年前的开原库，但是并不妨碍我们研究它。这一篇先了解其基本用法，下一篇是源码解析，以后的网络库方面的分析，一般也是以这个套路来。
这是一幅经典的图,Volley的中文翻译为“齐射、并发”，这表示，Volley特别适合数据量不大但是通信频繁的场景，不支持 post 大数据，不适合上传文件。本文主要介绍一下Volley的常规用法，就是五个类，StringRequest, JsonRequest ,ImageRequest, ImageLoader, NetWorkImageView。
准备工作：
所需要添加的引用库
compile 'com.mcxiaoke.volley:library:1.0.19'
所需要的请求链接
淘宝商品搜索建议:https://suggest.taobao.com/sug?code=utf-8&q=商品名称
所需要的权限
<uses-permission android:name="android.permission.INTERNET" />
一、StringRequest的用法
StringRequest，字面上理解就是String请求,请求的结果是字符串，这个怎么用，先看构造方法。
/**
/**
* Creates a new request with the given method.
*
* @param method the request {@link Method} to use
* @param url URL to fetch the string at
* @param listener Listener to receive the String response
* @param errorListener Error listener, or null to ignore errors
*/
public StringRequest(int method, String url, Listener<String> listener,
ErrorListener errorListener) {
super(method, url, errorListener);
mListener = listener;
}
/**
* Creates a new GET request.
*
* @param url URL to fetch the string at
* @param listener Listener to receive the String response
* @param errorListener Error listener, or null to ignore errors
*/
public StringRequest(String url, Listener<String> listener, ErrorListener errorListener) {
this(Method.GET, url, listener, errorListener);
}
总共有两个，第一个构造函数有四个参数， 可以指定请求类型，第二个构造函数，有三个参数，默认是GET请求。现在我们尝试发起一个请求，代码就可以这么写。
RequestQueue mQueue = Volley.newRequestQueue(MainActivity.this);
mQueue.add(getStringRequest());
构建一个消息队列RequestQueue，RequestQueue是什么？下面是RequestQueue的类注释
/**
* A request dispatch queue with a thread pool of dispatchers.
*
* Calling {@link #add(Request)} will enqueue the given Request for dispatch,
* resolving from either cache or network on a worker thread, and then delivering
* a parsed response on the main thread.
*/
大概意思就是讲：一个具有线程池的请求调度队列，调用add方法，将会给指定的请求调度，解决从一个工作线程（干活用的线程，即子线程）的缓存或网络，然后提供在主线程上的解析响应。
OK，明确告诉我们需要一个请求，并且add。我们先来个简单的Get请求。
public StringRequest getStringRequest() {
return new StringRequest("https://suggest.taobao.com/sug?code=utf-8&q=beizi",
new Response.Listener<String>() {
@Override
public void onResponse(String response) {
Log.e(getClass().getName(),response);
}
},
new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
Log.e(getClass().getName(),error.getMessage());
}
}
);
第一个参数是请求的链接地址，第二个参数是正确的回调，第三个参数是错误回调。
打印结果：
E/test.volley.com.volley.MainActivity$2: {"result":[["杯子","5198589"],["被子","5508160"],["被子冬被","1657880"],["杯子陶瓷","887481"],["杯子 玻璃","964491"],["杯子陶瓷 带盖","360083"],["被子被芯","1835894"],["杯子创意","1946812"],["杯子 保温杯","1615177"],["被子被芯 冬被","1436705"]]}
上面是GET请求，现在使用第一个四个参数的构造函数试一下POST请求，
public StringRequest(int method, String url, Listener<String> listener, ErrorListener errorListener) {
super(method, url, errorListener); mListener = listener;
}
构造中竟然不能传递post参数，这怎么搞？不必大惊小怪，基本上所有的网络框架，参数怎么会在构造中传呢。肯定是封装了。看StringRequest的父类Request有不少请求配置相关的方法，其中一个是getParams。
/**
* Returns a Map of parameters to be used for a POST or PUT request. Can throw
* {@link AuthFailureError} as authentication may be required to provide these values.
*
* <p>Note that you can directly override {@link #getBody()} for custom data.</p>
*
* @throws AuthFailureError in the event of auth failure
*/
protected Map<String, String> getParams() throws AuthFailureError {
return null;
}
所以，办法有了，在StringRequest中重写父类getParams方法，在getParams中返回我们自己的map。所以上面的Request改成这样
public StringRequest getPostStringRequest() {
return new StringRequest(Request.Method.POST,"https://suggest.taobao.com/sug?code=utf-8&q=beizi",
new Response.Listener<String>() {
@Override
public void onResponse(String response) {
Log.e(getClass().getName(),response);
}
},
new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
Log.e(getClass().getName(),error.getMessage());
}
}
){
@Override
protected Map<String, String> getParams() throws AuthFailureError {
Map<String, String> paramMap=new HashMap<>();
paramMap.put("param1","value1");
paramMap.put("param2","value3");
return paramMap;
}
};
}
总结一下步骤：
- 第一步：构建一个RequestQueue
- 第二步：构建一个合适的Request
- 第三步：把第二步的Request add到RequestQueue中
StringRequest就是这么简单，然而我们更常用的是JsonRequest
二、JsonRequest的用法
废话不多说，直接上代码了。
private void dispatcherJsonObjectRequest() {
Volley.newRequestQueue(getApplicationContext()).add(new JsonObjectRequest(Request.Method.POST, "https://suggest.taobao.com/sug?code=utf-8&q=diannao",
new Response.Listener<JSONObject>() {
@Override
public void onResponse(JSONObject response) {
Log.e(getClass().getName(), response.toString());
}
}, new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
Log.e(getClass().getName(), error.getMessage());
}
}
));
}
打印结果：
E/test.volley.com.volley.MainActivity$2: {"result":[["电脑桌","3558727"],["电脑椅","1740042"],["电脑包","7051240"],["电脑主机","265635"],["电脑音箱","826213"],["电脑","23633255"],["电脑桌 台式 家用","432711"],["电脑显示器","401223"],["电脑耳机","577117"],["电脑椅家用","366804"]]}
对JsonRequest请求，可以引入GSON等类似的类库将JSON字符串一部解析到位。
三、ImageRequest的用法
ImageRequest 的构造函数如下
/**
* Creates a new image request, decoding to a maximum specified width and
* height. If both width and height are zero, the image will be decoded to
* its natural size. If one of the two is nonzero, that dimension will be
* clamped and the other one will be set to preserve the image's aspect
* ratio. If both width and height are nonzero, the image will be decoded to
* be fit in the rectangle of dimensions width x height while keeping its
* aspect ratio.
*
* @param url URL of the image
* @param listener Listener to receive the decoded bitmap
* @param maxWidth Maximum width to decode this bitmap to, or zero for none
* @param maxHeight Maximum height to decode this bitmap to, or zero for
* none
* @param scaleType The ImageViews ScaleType used to calculate the needed image size.
* @param decodeConfig Format to decode the bitmap to
* @param errorListener Error listener, or null to ignore errors
*/
public ImageRequest(String url, Response.Listener<Bitmap> listener, int maxWidth, int maxHeight,
ScaleType scaleType, Config decodeConfig, Response.ErrorListener errorListener) {
super(Method.GET, url, errorListener);
setRetryPolicy(
new DefaultRetryPolicy(IMAGE_TIMEOUT_MS, IMAGE_MAX_RETRIES, IMAGE_BACKOFF_MULT));
mListener = listener;
mDecodeConfig = decodeConfig;
mMaxWidth = maxWidth;
mMaxHeight = maxHeight;
mScaleType = scaleType;
}
参数不少，总共有7个，第一个参数就是图片的URL地址，第二个参数是图片请求成功的回调，第三第四个参数分别用于指定允许图片最大的宽度和高度，第五个参数，指定图片的缩放类型，第六个参数用于指定图片的颜色属性，Bitmap.Config下的几个常量都可以在这里使用，其中ARGB_8888可以展示最好的颜色属性，每个图片像素占据4个字节的大小，而RGB_565则表示每个图片像素占据2个字节大小。第六个参数是图片请求失败的回调，当请求失败时在ImageView中显示一张默认图片。其实个人觉得这不是一种好的设计，参数太多，不利于用户使用。用这个构造函数创建一个新的图像请求，解码到一个最大指定的宽度和高度。如果两个宽度和高度都为零，图像将被解码为其图片本身的大小。如果指定的网络图片的宽度或高度大于这里的最大值，则会对图片进行压缩。
private void dispatherImageRequest(){
Volley.newRequestQueue(getApplicationContext()).add(new ImageRequest("https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png", new Response.Listener<Bitmap>() {
@Override
public void onResponse(Bitmap response) {
mImageView.setImageBitmap(response);
}
},0,0, ImageView.ScaleType.CENTER, Bitmap.Config.ALPHA_8,new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
mImageView.setImageResource(R.mipmap.ic_launcher);
}
}));
}
四、ImageLoader的用法
ImageLoader的内部也是用ImageRequest来实现，它的构造器可以传入一个ImageCache缓存形参，实现了图片缓存的功能，同时还可以过滤重复链接，避免重复发送请求。
private void dispatherImageLoader() {
RequestQueue mQueue = Volley.newRequestQueue(MainActivity.this);
ImageLoader imageLoader = new ImageLoader(mQueue, new ImageLoader.ImageCache() {
int maxSize = 10 * 1024 * 1024;
private LruCache<String, Bitmap> mCache = new LruCache<String, Bitmap>(maxSize) {
@Override
protected int sizeOf(String key, Bitmap bitmap) {
return bitmap.getRowBytes() * bitmap.getHeight();
}
};
@Override
public Bitmap getBitmap(String url) {
return mCache.get(url);
}
@Override
public void putBitmap(String url, Bitmap bitmap) {
mCache.put(url,bitmap);
}
});
imageLoader.get("https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png", new ImageLoader.ImageListener() {
@Override
public void onResponse(ImageLoader.ImageContainer response, boolean isImmediate) {
mImageView.setImageBitmap(response.getBitmap());
}
@Override
public void onErrorResponse(VolleyError error) {
mImageView.setImageResource(R.mipmap.ic_launcher);
}
});
}
与ImageRequest实现效果不同的是，ImageLoader加载图片会先显示默认的图片，等待图片加载完成才会显示在ImageView上。
5、NetworkImageView用法
NetworkImageView是一个自定义控件，继承自ImageView，封装了请求网络加载图片的功能。 这种思想不错，在项目中经常可以使用这种思路加强封装性。
Layout中添加
<com.android.volley.toolbox.NetworkImageView
android:id="@+id/networkview"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
RequestQueue mQueue = Volley.newRequestQueue(MainActivity.this);
ImageLoader imageLoader = new ImageLoader(mQueue, new ImageLoader.ImageCache() {
int maxSize = 10 * 1024 * 1024;
private LruCache<String, Bitmap> mCache = new LruCache<String, Bitmap>(maxSize) {
@Override
protected int sizeOf(String key, Bitmap bitmap) {
return bitmap.getRowBytes() * bitmap.getHeight();
}
};
@Override
public Bitmap getBitmap(String url) {
return mCache.get(url);
}
@Override
public void putBitmap(String url, Bitmap bitmap) {
mCache.put(url,bitmap);
}
});
mNetworkImageView.setDefaultImageResId(R.mipmap.ic_launcher);
mNetworkImageView.setErrorImageResId(R.mipmap.ic_launcher);
mNetworkImageView.setImageUrl("https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png",imageLoader);
调用mNetworkImageView的setDefaultImageResId()方法、setErrorImageResId()方法和setImageUrl()方法来分别设置加载中显示的图片，加载失败时显示的图片，以及目标图片的URL地址。和ImageRequest与ImageLoader不同，不需要显示的指定图片的宽高是否要压缩，这是因为，NetworkImageView可以根据我们设置控件的宽和高结合网络图片的宽和高，内部会自动去实现压缩，如果我们不想要压缩可以设置NetworkImageView控件的宽和高都为wrap_content。
