Android Volley详细解析（一）：Volley基本用法

一、什么是Volley？

　　Volley，是谷歌官方于2013年发布的用于Android平台的网络通信库，也即是说它内部封装了HttpURLConnection等常用于网络通信的类。平时我们写网络通信的业务逻辑的时候，通常是一大段一大段的HttpURLConnection的逻辑，这给我们造成了很多麻烦，如可能存在很多重复的代码或者效率过低又或者存在并发问题。而Volley的出现，极大简化了网络通信的业务逻辑的写法，只需要几行代码就能实现复杂的通信内容。
　　Volley的特点有如下：我们的应用进行网络通信的时候会更快、有着高效率的GET、POST及网络图像的异步处理请求机制、能对多个请求进行排序、能对请求的结果进行缓存、能多级别取消请求。
　　说了那么多Volley的优点，我们来说说它的适用场景：它适用于网络通信频繁但是数据量不大的场景；然而对于数据量非常大的情况下，它的性能就会非常差。但对于我们的日常开发开说绰绰有余了，因此使用Volley能极大提高我们的开发效率，所以学习Volley对我们来说是非常有好处的。

二、下载Volley

　　Volley的源码可以利用git命令直接获取：

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

　　然后导出成jar包，在项目中引入即可。或者在这里直接https://github.com/chenyua1995/AndroidFramework 下载笔者生成好的jar包。

三、Volley的基本使用

1、建立请求队列

　　与一般的网络请求不同，Volley把所有请求都保存在一个请求队列中，然后在请求队列中按优先级一个一个取出请求，然后发送出去，因此我们先要实例化一个请求队列：

private static RequestQueue requestQueue;requestQueue = Volley.newRequestQueue(getApplicationContext()); //把上下文context作为参数传递进去

2、三种请求方法

　　在Volley内，一般的Http的请求方法有三种，分别是StringRequest,JsonObjectRequest以及JsonArrayRequest，而每个方法都可以分为GET和POST请求方式。从它们的名字可以知道，StringRequest是请求一段字符串，JsonObjectRequest是请求一个JSON对象。JsonArrayRequest是请求一组JSON数组。我们从最简单的StrringRequest说起。

（1）StringRequest

　　我们先看它的构造方法：

/**  * @param method 请求的方式，可以选择GET或者POST  *        url  请求的网址  *        listener 请求成功的回调函数  *        errorListener 请求失败的回调函数  */public StringRequest(int method, String url, Listener<String> listener, ErrorListener errorListener) {      super(method, url, errorListener);       this.mListener = listener;}

　　通过构造方法获取StringRequest的实例后，通过把这个实例添加进请求队列中，就能正常地进行网络通信了。代码如下：

requestQueue.add(stringRequest);

　　下面我们结合一个实例来实际说明一下，这里选择的请求网址是http://www.thinkpage.cn/doc ，里面有免费的天气查询接口，有兴趣的读者可以去了解一下，里面有详细的文档说明，这里就不再赘述了，MainActivity.java文件代码如下：

public class MainActivity extends Activity {    private static RequestQueue requestQueue;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        //1、创建请求队列        RequestQueue requestQueue = Volley.newRequestQueue(getApplicationContext());         /**2、实例化StringRequest请求          *  第一个参数选择Request.Method.GET即get请求方式          *  第二个参数的url地址根据文档所给          *  第三个参数Response.Listener 请求成功的回调          *  第四个参数Response.ErrorListener 请求失败的回调          */        StringRequest stringRequest = new StringRequest(Request.Method.GET,"https://api.thinkpage.cn/v3/weather/now.json?key=rot2enzrehaztkdk&location=guangzhou&language=zh-Hans&unit=c",             new Response.Listener<String>() {            @Override            public void onResponse(String s) {                //String s即为服务器返回的数据                Log.d("cylog", s);            }        }, new Response.ErrorListener() {            @Override            public void onErrorResponse(VolleyError volleyError) {                Log.e("cylog", volleyError.getMessage(),volleyError);            }        });        //3、将请求添加进请求队列        requestQueue.add(stringRequest);    }}

　　最后，不要忘记在AndroidManifest.xml中声明网络权限~

<uses-permission android:name="android.permission.INTERNET"></uses-permission>

　　我们来看一下运行效果：

　　可以看出，网络通信的任务正常完成，获取了相应的数据。以上是GET请求方式，接下来简单介绍一下POST请求方式：
1、首先，在实例化StringRequest的时候，要写为Method.POST。
2、由于POST方式的参数不是写在url而是写在请求体的，所以我们需要重写getParams()方法，这里的getParams()方法是重写Request父类的方法，具体形式如下：

       StringRequest stringRequest = new StringRequest(Request.Method.POST,"https://www.test.com", new Response.Listener<String>() {}        }, new Response.ErrorListener() {}){                @Override                protected Map<String, String> getParams() throws AuthFailureError {                    //用HashMap来存储请求参数                    Map<String,String> map = new HashMap<String,String>();                    map.put("param1","value1");                    map.put("param2","value2");                    return map;                }            };

　　有些网站是用GET方式来获取数据，有些网站是需要POST请求方式才能获取数据，所以我们要根据业务需求来灵活选择。

（2）JsonObjectRequest和JsonArrayRequest

　　以上两个类的用法和StringRequest很类似，同样有着GET和POST的请求方式，JsonObjectRequest请求的是一个JSON对象，而JsonArrayRequest请求的是一个JSON数组，这里就以JsonObjectRequest为代表讲述。
　　我们先看看构造器：

    public JsonObjectRequest(int method, String url, String requestBody, Listener<JSONObject> listener, ErrorListener errorListener) {        super(method, url, requestBody, listener, errorListener);    }    public JsonObjectRequest(int method, String url, Listener<JSONObject> listener, ErrorListener errorListener) {        super(method, url, (String)null, listener, errorListener);    }

　　从构造器可以看出，它和StringRequest的构造方法大同小异，但有一点要注意的是，JsonObjectRequest和JsonArrayRequest的构造参数有一个是String requestBody，这个就是请求体，如果是POST请求，就可以直接通过构造器把请求体传进去，而不用像StringRequest那样通过重写父类的getParams()来写入请求参数。接下来的实现步骤和上面说的三个步骤一样，实例化了请求实例后，添加进请求队列即可：

        String url = "https://api.thinkpage.cn/v3/weather/now.json?key=rot2enzrehaztkdk&location=guangzhou&language=zh-Hans&unit=c";        JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(Request.Method.GET, url,(String)null,new Response.Listener<JSONObject>() {            @Override            public void onResponse(JSONObject jsonObject) {                Log.d("cylog",jsonObject.toString());            }        }, new Response.ErrorListener() {            @Override            public void onErrorResponse(VolleyError volleyError) {                Log.d("cylog",volleyError.getMessage().toString());            }        });        requestQueue.add(jsonObjectRequest);

　　运行结果和上面给出的一样，通过JsonObjectRequest能获取到JSON对象，然后通过JsonObject的方法能非常方便地取出里面的元素。
　　Volley的基本用法介绍到这里，下一篇文章将开始介绍利用Volley来加载网络图片。