Volley框架的使用

关于Volley,它是2013年Google I/O上发布的一款网络框架,基于Android平台,能使网络通讯更快,更简单,更健全。php

它的优势:(1)默认Android2.3及以上基于HttpURLConnection,2.3如下使用基于HttpClient;(2)符合Http 缓存语义 的缓存机制(提供了默认的磁盘和内存等缓存);(3)请求队列的优先级排序;(4)提供多样的取消机制;(5)提供简便的图片加载工具(其实图片的加载才是咱们最为看重的功能);(6)一个优秀的框架。android

不足之处也有:它只适合数据量小,通讯频繁的网络操做,若是是数据量大的,像音频,视频等的传输,仍是不要使用Volley的为好。git

 

1、得到Volleygithub

能够直接从google上git clone下来json

git clone https://android.googlesource.com/platform/frameworks/volley

而后生成jar包,导入到本身的项目中使用。注意,这个库要求最低SDK版本为Froyo,即至少要设置android:minSdkVersion为8以上。缓存

不过因为google的被墙,因此可能要FQ出去。嫌麻烦的话也能够直接问我要jar包。服务器

 

2、使用Volleycookie

volley里面自带了不少的工具类,像StringRequest,JsonArrayRequest,JsonObjectRequest,ImageRequest这些都是咱们平时常用的http请求,咱们就能够直接把它们拿过来用。如今来一一说明这些类的用法吧。网络

在此以前,先说一下Volley中的requestQueue吧,全部的request申请出来后都是扔到这个队列里处理。app

requestQueue = Volley.newRequestQueue(context.getApplicationContext());
...
requestQueue.add(request);

这样Volley就会帮你处理网络通讯了。

(1)字符数据的处理

  1. StringRequest 网络请求返回字符串
    StringRequest的网络请求返回的是一个字符串。它有两个构造函数
    /**
         * 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);
        }

    第二个构造函数相比第一个少了个method的参数,因此它是默认使用get方法。第一个构造函数是可让咱们本身定义请求的方式,method的类型定义在Request类中

        /**
         * Supported request methods.
         */
        public interface Method {
            int DEPRECATED_GET_OR_POST = -1;
            int GET = 0;
            int POST = 1;
            int PUT = 2;
            int DELETE = 3;
            int HEAD = 4;
            int OPTIONS = 5;
            int TRACE = 6;
            int PATCH = 7;
        }

    默认是get,而除此之外咱们使用最多的是post的请求方法。

    Get请求:

            StringRequest request = new StringRequest(   
                    "http://www.baidu.com/",  
                    new Response.Listener<String>() {  
                        @Override  
                        public void onResponse(String arg0) {  //收到成功应答后会触发这里  
      
                        }  
                    },  
                    new Response.ErrorListener() {  
                        @Override  
                        public void onErrorResponse(VolleyError volleyError) { //出现链接错误会触发这里  
                           
    } } );

    在StringRequest中传入一个url,一个通讯成功的触发器和一个通讯失败的触发器。
    而post的请求方式以下:

               StringRequest request = new StringRequest(  
                        Request.Method.POST,  
                        "http://xxx.xxx.xxx",  
                        new Response.Listener<String>() {  
                            @Override  
                            public void onResponse(String s) {  
          
                            }  
                        },  
                        new Response.ErrorListener() {  
                            @Override  
                            public void onErrorResponse(VolleyError volleyError) {  
          
                            }  
                        }  
                ) {  
                    @Override  
                    public Map<String, String> getHeaders() throws AuthFailureError {  //设置头信息  
                        Map<String, String> map = new HashMap<String, String>();  
                        map.put("Content-Type", "application/x-www-form-urldecoded");  
                        return map;  
                    }  
          
                    @Override  
                    protected Map<String, String> getParams() throws AuthFailureError {  //设置参数  
                        Map<String, String> map = new HashMap<String, String>();  
                        map.put("name", "cpacm");  
                        map.put("password", "12345");  
                        return map;  
                    }  
                };  

    能够经过复写里面的方法把数据给传进去,不止如此,若是还想对返回的数据进行进一步的处理,能够在重写下面这个方法

                /**
                 * 能够对返回的reponse作处理, NetworkResponse里面包括状态码,头信息,内容数据,是否缓存在本地,花费的时间(ms)等内容
                 **/
                @Override
                protected Response<String> parseNetworkResponse(
                        NetworkResponse response) {
                    // 好比下面的例子是取头信息里的cookie数据
                    /*
                     * String mCookie; 
    * for (String s : response.headers.keySet()) { * if (s.contains("Set-Cookie")) { mCookie = * response.headers.get(s); break; } } */ return super.parseNetworkResponse(response); }

    与前面两个重写方法在通讯前调用不一样,这个方法是在通讯结束后调用的。
    StringRequest的内容就那么多,不是很理解的话能够参考示例来仔细琢磨...

  2.  JsonObjectRequest json格式的数据通讯
    JsonArrayRequest是专对于jsonArray的处理,而JsonObjectRequest是对jsonObject的处理,因此两个区别不大,因此我这里就主要介绍JsonObjectRequest的使用。
    事实上,使用的方法和StringRequest并无什么大的区别,触类旁通嘛。

    JsonObjectRequest的构造函数也是有两个,不过内容与StringRequest有一点不一样。

    public JsonObjectRequest(int method, String url, JSONObject jsonRequest, Listener<JSONObject> listener, ErrorListener errorListener)  
      
    public JsonObjectRequest(String url, JSONObject jsonRequest, Listener<JSONObject> listener, ErrorListener errorListener) 

    第一个构造函数的参数分别为 请求方法,url地址,附带的jsonObject数据,成功监听器,失败监听器。

    第二个构造函数比第一个少了method的参数,它默认的规则是:当jsonRequest为空时,使用get请求方式,不为空则是使用post方式。

    因为构造函数中已经有了数据传递的参数,因此没必要在重写getParams()的方法了(重写了也没用)。
    基本的调用方法:

    JsonObjectRequest request = new JsonObjectRequest(  
            "http://xxx.xxx.xx",  
            jsonObject,  
            new Response.Listener<JSONObject>() {  
                @Override  
                public void onResponse(JSONObject jsonObject) {  
      
                }  
            },  
            new Response.ErrorListener() {  
                @Override  
                public void onErrorResponse(VolleyError volleyError) {  
      
                }  
            }  
    ) {  
        @Override  
        public Map<String, String> getHeaders() throws AuthFailureError {  
            Map<String, String> map = new HashMap<String, String>();  
            map.put("Cookie", mCookie);  
            return map;  
        }  
    }; 

    最后只要再把成功监听器里拿到的数据处理就能使用了。

    post传到服务器上时已是json格式,接着在服务器里处理,返回的也要是json格式的数据,不然会致使数据错误(没法转化成JSONObject格式)。
    (!因此我用php写的后台来接受数据时,没法用$_POST来接收上传的数据)


    最后,别忘了把这些请求加到队列中。

    requestQueue.add(request);

     

(2)图片数据的处理

  1. ImageRequest 图片请求
    ImageRequest与前面的request用法差很少,都是把请求扔到RequestQueue队列里。
    ImageRequest imageRequest = new ImageRequest(url,
                    new Listener<Bitmap>() {
    
                        @Override
                        public void onResponse(Bitmap bitmap) {
                            // TODO Auto-generated method stub    
                        }
    
                    }, maxWidth, maxHeight, decodeConfig, new ErrorListener() {
    
                        @Override
                        public void onErrorResponse(VolleyError arg0) {
                            // TODO Auto-generated method stub
                            Log.e(TAG, "ErrorStatus: " + arg0.toString());
                        }
                    });

    能够看到,ImageRequest的构造函数能接收六个参数,第一个参数就是图片的URL地址。第二个参数是图片请求成功的回调, 这里咱们能够把返回的Bitmap参数设置到ImageView中。第三第四个参数分别用于指定容许图片最大的宽度和高度,若是指定的网络图片的宽度或高度大于这里的最大值,则会对图片进行压缩,指定成0的话就表示无论图片有多大,都不会进行压缩。第五个参数用于指定图片的颜色属性,Bitmap.Config下的几个常量均可以在这里使用,其中ARGB_8888能够展现最好的颜色属性,每一个图片像素占据4个字节的大小,而 RGB_565则表示每一个图片像素占据2个字节大小。第六个参数是图片请求失败的回调,这里咱们能够在请求失败时在ImageView中显示一张默认图片。

    最后,把请求放入队列中。
    requestQueue.add(request);
  2. ImageLoader 更增强大的网络图片请求
    ImageLoader也能够用于加载网络上的图片,而且它的内部也是使用ImageRequest来实现的,不过ImageLoader明显要比ImageRequest更加高效,由于它不只能够帮咱们对图片进行缓存,还能够过滤掉重复的连接,避免重复发送请求。直接上代码吧
            ImageLoader imageLoader = new ImageLoader(requestQueue,
                    new BitmapCache());//新建一个ImageLoader,传入requestQueue和图片缓存类
            ImageListener listener = ImageLoader.getImageListener(imageView,
                    default_image, failed_image);//参数分别为要显示的图片控件,默认显示的图片(用于图片未下载完时显示),下载图片失败时显示的图片
            imageLoader.get(url, listener, maxWidth, maxHeight);//开始请求网络图片

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

    图片缓存类代码以下:
    public class BitmapCache implements ImageCache {
    
        private LruCache<String, Bitmap> mCache;
    
        public BitmapCache() {
            int maxSize = 10 * 1024 * 1024;// 10M的缓存
            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) {
            // TODO Auto-generated method stub
            return mCache.get(url);
        }
    
        @Override
        public void putBitmap(String url, Bitmap bitmap) {
            // TODO Auto-generated method stub
            mCache.put(url, bitmap);
        }
    
    }
  3. NetworkImageView 网络图片加载控件
    除了上面的两种加载图片之外,volley还提供了一个继承ImageView的控件给咱们使用。咱们能够把NetworkImageView控件放入布局文件中而后就能调用了。
    <com.android.volley.toolbox.NetworkImageView   
            android:id="@+id/network_image_view"  
            android:layout_width="200dp"  
            android:layout_height="200dp"  
            android:layout_gravity="center_horizontal"  
            />

    先从布局中得到控件的控制权,

    networkImageView = (NetworkImageView) findViewById(R.id.network_image_view);

    最后在设置一些相关的属性

    networkImageView.setDefaultImageResId(R.drawable.default_image);  
    networkImageView.setErrorImageResId(R.drawable.failed_image);  
    networkImageView.setImageUrl(url,imageLoader);

    setImageUrl()方法接收两个参数,第一个参数用于指定图片的URL地址,第二个参数则是前面建立好的ImageLoader对象。其中的imageLoader须要咱们本身建立(就是上一个图片加载方法的imageLoader),将其做为参数传进去。其实NetworkImageView控件和用ImageLoader加载图片性质上都是同样的。

     

(3)自定义数据的处理

自定义的网络请求能够继承volley的Request类来重写,好比说XML格式的请求。其中最重要的是Request类中的parseNetworkResponse方法。

像StringRequest中的parseNetworkResponse方法

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

 

重点是怎么将response.data转化成相应的字符格式。

像JsonObject里面的方法

@Override
    protected Response<JSONObject> parseNetworkResponse(NetworkResponse response) {
        try {
            String jsonString =
                new String(response.data, HttpHeaderParser.parseCharset(response.headers));
            return Response.success(new JSONObject(jsonString),
                    HttpHeaderParser.parseCacheHeaders(response));
        } catch (UnsupportedEncodingException e) {
            return Response.error(new ParseError(e));
        } catch (JSONException je) {
            return Response.error(new ParseError(je));
        }
    }

先将传过来的数据转化成String格式,再根据状况转成Json或者是XML。

如咱们自定义的XMLRequest能够写成这样子。

@Override
    protected Response<XmlPullParser> 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));
        }
    }

 

 

3、结束语

Volley给咱们在网络传输的方面提供了很大的方便,尤为是网络图片加载的部分。除此以外,咱们能够从volley的源代码入手能够学习到更多的知识,好比说如何构建一个完善的框架,如何使框架具备良好的扩展性。因此我建议有空的话能够把源代码下载过来仔细体味一番...

源码的分析在下面的文章连接中。

 

参考文章:(1) Android Volley彻底解析 http://blog.csdn.net/guolin_blog/article/details/17482095

                  (2)Android应用开发:网络工具——Volley(一) http://blog.csdn.net/airk000/article/details/38983051

                  (3)Android应用开发:网络工具——Volley(二) http://blog.csdn.net/airk000/article/details/39003587

                  (4)github上的volley库分析 https://github.com/android-cn/android-open-project-analysis/tree/master/volley

Demo地址: https://github.com/android-cn/android-open-project-demo/tree/master/volley-demo

相关文章
相关标签/搜索