正常的思维解读 Volley 的使用以及源码

1,638 阅读7分钟
原文链接: fox-legend.github.io

1.1 Volley简介

Volley是Google I/O 2013发布的一款基于Android平台的网络框架,它的优点有: 1) 默认Android2.3及以上基于 HttpURLConnection,2.3以下基于HttpClient; 2) 提供了两种缓存机制:磁盘缓存和内存缓存,符合Http缓存语义的缓存机制; 3) 支持指定请求的优先级; 4) 提供多样的取消机制:特定任务取消以及多任务取消; 5) 提供简便的图片加载工具(ImageRequest、ImageLoader); 6) 一个优秀的框架. 不足之处:它只适应数据量小,通信频繁的网络操作,如果数据量大如音频、视频等传输,就不要使用Volley为好.下图是官方给出的Velloy网络框架示意图,就表明该框架适合数据量不大但很频繁的场景. Volley

1.2 获取Volley

1) 可以直接从google上git clone下来: git clone android.googlesource.com/platform/fr… 然后使用命令:android update project -p . ant jar生成一个Volley.jar包,直接添加到工程中就可以使用了.

2) 或者从github上下载源码 github.com/Fox-Legend/…

1.3 使用Volley

Volley中构建了很多工具网络请求工具类,如StringRequest、JsonArrayRequest、JsonObjectRequest、ImageRequest等,这些都是常用的网络请求. Volley提供了一个请求队列RequestQueue专门用于存放用户的网络请求,所有的request申请后都添加到这个队列中缓存,然后按照一定的算法并发地发出这些请求, 一般网络请求队列在整个APP内使用是一个全局对象,所以最好写到Application中,

public class AppApplication extends Application {
     * 建立请求队列   */
  private static RequestQueue mQueue;
  public void onCreate() {
      super.onCreate();
      this.mQueue = Volley.newRequestQueue(getApplicationContext());
  }
  public static RequestQueue getRequestQueue(){
      return mQueue;
  }
  }

在创建RequestQueue队列对象的构造函数中,已经调用了RequestQueue的start方法. 对应的需要修改AndroidManifest.xml文件,是的App对应的Application对象为AppApplication. 不要忘记添加访问网络的权限:


        android:name=".AppApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        
        

(1) 建立一个JsonArrayRequest发送Http请求,并添加到RequestQueue中,返回Json数据:

private static final String TAG = "MainActivity";
    private final String mUrl = "http://10.8.204.173:5000/shouye/newdata/1";
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        VolleyGet();
    }
         * 网络请求方式为Get,返回Json     */
    private void VolleyGet() {
                 * 建立JsonArrayRequest请求         */
        JsonArrayRequest request = new JsonArrayRequest(Request.Method.GET,mUrl,null, new Response.Listener() {
            public void onResponse(JSONArray response) {
                Toast.makeText(MainActivity.this,"the response:" + response.toString(),Toast.LENGTH_SHORT).show();
            }
        }, new Response.ErrorListener() {
            public void onErrorResponse(VolleyError error) {
                Log.e(TAG,error.toString());
            }
        });
                 * 为request设置请求标签         */
        request.setTag("JSONArrayRequest_GET");
        AppApplication.getRequestQueue().add(request);
    }
    

返回Json数据: the response: [{“star”:”53”,”date”:”06-18”,”title”:”美发图片长发卷发”,”urls”:[“http:\/\/t1.du114.com\/uploads\/tu\/201606\/changfa250\/2008111233241866_2.jpg”]}] 大家都知道Http的请求类型通常有两种,GET和POST,上面只是使用GET方式,若想要发送POST请求,只需要修改method==Request.Method.POST即可,再加添post请求内容params. JsonArrayRequest其对应的构造函数参数列表为:

 */
public JsonArrayRequest(String url, Listener listener, ErrorListener errorListener) {
     ...
     }
 * Creates a new request. * @param method the HTTP method to use:网络请求的方法,如GET和POST等 * @param url URL to fetch the JSON from:网络请求的地址 * @param jsonRequest A {@link JSONArray} to post with the request. Null is allowed and *   indicates no parameters will be posted along with request * @param listener Listener to receive the JSON response:请求返回结果监听 * @param errorListener Error listener, or null to ignore errors.:请求失败监听 */
 public JsonArrayRequest(int method, String url, JSONArray jsonRequest,                        Listener listener, ErrorListener errorListener) {
    ...
    }

总结上述过程总共就三步: a、创建一个RequestQueue对象; b、创建一个JsonArrayRequest对象; c、将JsonArrayRequest对象添加到RequestQueue中.

在Volley中还提供了其它的Request,比如StringRequest/JsonObjectRequest等,而且还可以自定义Request.使用方法基本和上述一样.

(2) 除了一些基本字符数据的网络请求,Volley还可以加载图片数据,有两种请求方式:ImageLoader和ImageRequest ImageRequest ImageRequest和之前的request用法差不多,都是在创建对象后添加到RequestQueue中.

 * 利用ImageRequest加载图片 */
private void VolleyImageRequest(final ImageView imageView) {
    int maxHeight = 480;
    int maxWidth = 640;
    String mPicUrl = "http://t1.du114.com/uploads/tu/201510/fengjing/rgj5thjkwlf.jpg";
    ImageRequest imgRequest = new ImageRequest(mPicUrl, new Response.Listener() {
        public void onResponse(Bitmap response) {
            imageView.setImageBitmap(response);
        }
    }, maxWidth, maxHeight,ImageView.ScaleType.CENTER, Bitmap.Config.RGB_565,
            new Response.ErrorListener() {
        public void onErrorResponse(VolleyError error) {
            Log.e(TAG,error.toString());
        }
    });
    imgRequest.setTag("ImageRequest_TAG");
    AppApplication.getRequestQueue().add(imgRequest);
    }

可以看到,ImageRequest的构造函数能接收七个参数(原有的六个参数的方法最后也是调用该方法),第一个参数就是图片的URL地址。第二个参数是图片请求成功的回调, 这里我们可以把返回的Bitmap参数设置到ImageView中,第三第四个参数分别用于指定允许图片最大的宽度和高度,如果指定的网络图片的宽度或高度大于这里的最大值,则会对图片进行压缩,指定成0的话就表示不管图片有多大,都不会进行压缩. 第五个参数用于指定图片填充空间的缩放方式ScaleType,第六个参数用于指定图片的颜色属性,Bitmap.Config下的几个常量都可以在这里使用,其中ARGB_8888可以展示最好的颜色属性,每个图片像素占据4个字节的大小,而 RGB_565则表示每个图片像素占据2个字节大小。第七个参数是图片请求失败的回调,这里我们可以在请求失败时在ImageView中显示一张默认图片。 ImageLoader ImageLoader也可以用于加载网络图片,并且内部也是使用ImageRequest来实现的,不过ImageLoader比ImageRequest要高效,因为它不仅可以对图片进行缓存而且还可以过滤重复的链接,避免重复发送请求.

 * 利用ImageLoader加载图片 * @param mImgView */
private void VolletImageLoader(final ImageView mImgView) {
    int maxHeight = 480;
    int maxWidth = 640;
    String mPicUrl = "http://t1.du114.com/uploads/tu/201510/fengjing/rgj5thjkwlf.jpg";
    ImageLoader imgLoader = new ImageLoader(AppApplication.getRequestQueue(),new BitmapCache());
    ImageLoader.ImageListener listener =
            ImageLoader.getImageListener(mImgView,android.R.drawable.ic_menu_rotate,android.R.drawable.ic_delete);
    imgLoader.get(mPicUrl,listener,maxWidth,maxHeight);
    }
  * BitmapCache  */
  public class BitmapCache implements ImageLoader.ImageCache {
  private LruCache mCache;
  public BitmapCache(){
      int maxSize = 10 * 1024 * 1024;
      mCache = new LruCache(maxSize){
          protected int sizeOf(String key, Bitmap value) {
              return value.getRowBytes() * value.getHeight();
          }
      };
  }
  public Bitmap getBitmap(String url) {
      return mCache.get(url);
  }
  public void putBitmap(String url, Bitmap bitmap) {
      mCache.put(url,bitmap);
  }
  }

可以看到,ImageLoader的构造函数接收两个参数,第一个参数就是RequestQueue对象,第二个参数是一个ImageCache对象,我们通过调用ImageLoader的getImageListener()方法能够获取到一个ImageListener对象,getImageListener()方法接收三个参数,第一个参数指定用于显示图片的ImageView控件,第二个参数指定加载图片的过程中显示的图片,第三个参数指定加载图片失败的情况下显示的图片。最后,调用ImageLoader的get()方法来加载图片。

Volley还特别为加载网络图片提供了NetworkImageView控件(其继承至ImageView),它将上述单独为ImageView设置加载时图片和加载失败的图片等功能封装在一起,更方便.

private void VolleyImageLoader(NetworkImageView mNetworkView) {
       String mPicUrl = "http://t1.du114.com/uploads/tu/201510/fengjing/rgj5thjkwlf.jpg";
       ImageLoader imgLoader = new ImageLoader(AppApplication.getRequestQueue(),new BitmapCache());
       this.mNetworkView.setDefaultImageResId(android.R.drawable.ic_menu_rotate);
       this.mNetworkView.setErrorImageResId(android.R.drawable.ic_delete);
       this.mNetworkView.setImageUrl(mPicUrl,imgLoader);
   }
   

1.4 自定义Request

Volley允许用户按照自己的意愿定义特定的Request,那么怎么样去定义了? 在Volley中的所有Request都是继承至抽象类Request: 如StringRequest:

 * A canned request for retrieving the response body at a given URL as a String. */
public class StringRequest extends Request {
    private Listener mListener;
    public StringRequest(int method, String url, Listener listener,
            ErrorListener errorListener) {
        super(method, url, errorListener);
        mListener = listener;
    }
    protected void onFinish() {
        super.onFinish();
        mListener = null;
    }
    protected void deliverResponse(String response) {
        if (mListener != null) {
            mListener.onResponse(response);
        }
    }
        * 解析网络请求返回数据    */
    protected Response parseNetworkResponse(NetworkResponse response) {
        String parsed;
        try {
            parsed = new String(response.data, HttpHeaderParser.parseCharset(response.headers));
        } catch (UnsupportedEncodingException e) {
            parsed = new String(response.data);
        }
        return Response.success(parsed, HttpHeaderParser.parseCacheHeaders(response));
    }
    }

若我们想要自定义一个XML文件的XmlRequest,利用XmlPullParserFactory和XmlPullParser去将返回的xml数据进行解析:

/**
 * XmlRequest
 */
 public class XmlRequest extends Request {
    private final Response.Listener mListener;
    public XmlRequest(int method, String url, Response.Listener listener,
                      Response.ErrorListener errorListener) {
        super(method, url, errorListener);
        mListener = listener;
    }
    public XmlRequest(String url, Response.Listener listener, Response.ErrorListener errorListener) {
        this(Method.GET, url, listener, errorListener);
    }
    @Override
    protected Response parseNetworkResponse(NetworkResponse response) {
        try {
            String xmlString = new String(response.data,
                    HttpHeaderParser.parseCharset(response.headers));
            XmlPullParserFactory factory = XmlPullParserFactory.newInstance();
            XmlPullParser xmlPullParser = factory.newPullParser();
            xmlPullParser.setInput(new StringReader(xmlString));
            return Response.success(xmlPullParser, HttpHeaderParser.parseCacheHeaders(response));
        } catch (UnsupportedEncodingException e) {
            return Response.error(new ParseError(e));
        } catch (XmlPullParserException e) {
            return Response.error(new ParseError(e));
        }
    }
    @Override
    protected void deliverResponse(XmlPullParser response) {
        mListener.onResponse(response);
    }
    }

XmlRequest的使用方法和Volley自带的Request差不多.

1.4 取消请求Request

当Activity销毁时,我们可能需要取消一些请求,这时候可以根据在创建Request时,为Request添加的Tag来取消对应的请求,在onDestroy()方法中填写如下代码:

  * 为request设置请求标签  */
 request.setTag("JSONArrayRequest_GET");
 @Override
 protected void onDestroy() {
     super.onDestroy();
     AppApplication.getRequestQueue().cancelAll("JSONArrayRequest_GET");
 }
 

或者若需要取消属于Activity中全部的请求,那么可以为所有属于该Activity的Request添加同样的Tag. RequestQueue#cancelAll还有另一种重载形式,可以传入RequestFilter,自己指定一个过滤策略.