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来加载网络图片。

作者：丶蓝天白云梦
链接：https://www.jianshu.com/p/5dd50bcbcd6d