Android Volley完全解析之初識Volley的基本用法

1. Volley簡介

我們平時在開發Android應用的時候不可避免地都需要用到網絡技術，而多數情況下應用程序都會使用HTTP協議來發送和接收網絡數據。Android系統中主要提供了兩種方式來進行HTTP通信，HttpURLConnection和HttpClient，幾乎在任何項目的代碼中我們都能看到這兩個類的身影，使用率非常高。

不過HttpURLConnection和HttpClient的用法還是稍微有些復雜的，如果不進行適當封裝的話，很容易就會寫出不少重復代碼。於是乎，一些Android網絡通信框架也就應運而生，比如說AsyncHttpClient，它把HTTP所有的通信細節全部封裝在了內部，我們只需要簡單調用幾行代碼就可以完成通信操作了。再比如Universal-Image-Loader，它使得在界面上顯示網絡圖片的操作變得極度簡單，開發者不用關心如何從網絡上獲取圖片，也不用關心開啟線程、回收圖片資源等細節，Universal-Image-Loader已經把一切都做好了。
 

Android開發團隊也是意識到了有必要將HTTP的通信操作再進行簡單化，於是在2013年Google I/O大會上推出了一個新的網絡通信框架——Volley。Volley可是說是把AsyncHttpClient和Universal-Image-Loader的優點集於了一身，既可以像AsyncHttpClient一樣非常簡單地進行HTTP通信，也可以像Universal-Image-Loader一樣輕松加載網絡上的圖片。除了簡單易用之外，Volley在性能方面也進行了大幅度的調整，它的設計目標就是非常適合去進行數據量不大，但通信頻繁的網絡操作，而對於大數據量的網絡操作，比如說下載文件等，Volley的表現就會非常糟糕。

下圖所示的這些應用都是屬於數據量不大，但網絡通信頻繁的，因此非常適合使用Volley。

2. 下載Volley

介紹了這麼多理論的東西，下面我們就准備開始進行實戰了，首先需要將Volley的jar包准備好，如果你的電腦上裝有Git，可以使用如下命令下載Volley的源碼：

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

下載完成後將它導入到你的Eclipse工程裡，然後再導出一個jar包就可以了。如果你的電腦上沒有Git，那麼也可以直接使用我導出好的jar包，下載地址 。

新建一個Android項目，將volley.jar文件復制到libs目錄下，這樣准備工作就算是做好了。

3. StringRequest的用法

前面已經說過，Volley的用法非常簡單，那麼我們就從最基本的HTTP通信開始學習吧，即發起一條HTTP請求，然後接收HTTP響應。首先需要獲取到一個RequestQueue對象，可以調用如下方法獲取到：

RequestQueue mQueue = Volley.newRequestQueue(context);

注意這裡拿到的RequestQueue是一個請求隊列對象，它可以緩存所有的HTTP請求，然後按照一定的算法並發地發出這些請求。RequestQueue內部的設計就是非常合適高並發的，因此我們不必為每一次HTTP請求都創建一個RequestQueue對象，這是非常浪費資源的，基本上在每一個需要和網絡交互的Activity中創建一個RequestQueue對象就足夠了。

接下來為了要發出一條HTTP請求，我們還需要創建一個StringRequest對象，如下所示：

StringRequest stringRequest = new StringRequest("http://www.baidu.com",  
                        new Response.Listener<String>() {  
                            @Override 
                            public void onResponse(String response) {  
                                Log.d("TAG", response);  
                            }  
                        }, new Response.ErrorListener() {  
                            @Override 
                            public void onErrorResponse(VolleyError error) {  
                                Log.e("TAG", error.getMessage(), error);  
                            }  
                        });  

可以看到，這裡new出了一個StringRequest對象，StringRequest的構造函數需要傳入三個參數，第一個參數就是目標服務器的URL地址，第二個參數是服務器響應成功的回調，第三個參數是服務器響應失敗的回調。其中，目標服務器地址我們填寫的是百度的首頁，然後在響應成功的回調裡打印出服務器返回的內容，在響應失敗的回調裡打印出失敗的詳細信息。

最後，將這個StringRequest對象添加到RequestQueue裡面就可以了，如下所示：
 

mQueue.add(stringRequest);

另外，由於Volley是要訪問網絡的，因此不要忘記在你的AndroidManifest.xml中添加如下權限：

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

好了，就是這麼簡單，如果你現在運行一下程序，並發出這樣一條HTTP請求，就會看到LogCat中會打印出如下圖所示的數據。

沒錯，百度返回給我們的就是這樣一長串的HTML代碼，雖然我們看起來會有些吃力，但是浏覽器卻可以輕松地對這段HTML代碼進行解析，然後將百度的首頁展現出來。

這樣的話，一個最基本的HTTP發送與響應的功能就完成了。你會發現根本還沒寫幾行代碼就輕易實現了這個功能，主要就是進行了以下三步操作：

1. 創建一個RequestQueue對象。

2. 創建一個StringRequest對象。

3. 將StringRequest對象添加到RequestQueue裡面。

不過大家都知道，HTTP的請求類型通常有兩種，GET和POST，剛才我們使用的明顯是一個GET請求，那麼如果想要發出一條POST請求應該怎麼做呢？StringRequest中還提供了另外一種四個參數的構造函數，其中第一個參數就是指定請求類型的，我們可以使用如下方式進行指定：

StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener);

可是這只是指定了HTTP請求方式是POST，那麼我們要提交給服務器的參數又該怎麼設置呢？很遺憾，StringRequest中並沒有提供設置POST參數的方法，但是當發出POST請求的時候，Volley會嘗試調用StringRequest的父類——Request中的getParams()方法來獲取POST參數，那麼解決方法自然也就有了，我們只需要在StringRequest的匿名類中重寫getParams()方法，在這裡設置POST參數就可以了，代碼如下所示：

StringRequest stringRequest = new StringRequest(Method.POST, url,  listener, errorListener) {  
    @Override 
    protected Map<String, String> getParams() throws AuthFailureError {  
        Map<String, String> map = new HashMap<String, String>();  
        map.put("params1", "value1");  
        map.put("params2", "value2");  
        return map;  
    }  
};  

你可能會說，每次都這樣用起來豈不是很累？連個設置POST參數的方法都沒有。但是不要忘記，Volley是開源的，只要你願意，你可以自由地在裡面添加和修改任何的方法，輕松就能定制出一個屬於你自己的Volley版本。

4. JsonRequest的用法

學完了最基本的StringRequest的用法，我們再來進階學習一下JsonRequest的用法。類似於StringRequest，JsonRequest也是繼承自Request類的，不過由於JsonRequest是一個抽象類，因此我們無法直接創建它的實例，那麼只能從它的子類入手了。JsonRequest有兩個直接的子類，JsonObjectRequest和JsonArrayRequest，從名字上你應該能就看出它們的區別了吧？一個是用於請求一段JSON數據的，一個是用於請求一段JSON數組的。

至於它們的用法也基本上沒有什麼特殊之處，先new出一個JsonObjectRequest對象，如下所示：

JsonObjectRequest jsonObjectRequest = new JsonObjectRequest("http://m.weather.com.cn/data/101010100.html", null,  
        new Response.Listener<JSONObject>() {  
            @Override 
            public void onResponse(JSONObject response) {  
                Log.d("TAG", response.toString());  
            }  
        }, new Response.ErrorListener() {  
            @Override 
            public void onErrorResponse(VolleyError error) {  
                Log.e("TAG", error.getMessage(), error);  
            }  
        });  

可以看到，這裡我們填寫的URL地址是http://m.weather.com.cn/data/101010100.html，這是中國天氣網提供的一個查詢天氣信息的接口，響應的數據就是以JSON格式返回的，然後我們在onResponse()方法中將返回的數據打印出來。

最後再將這個JsonObjectRequest對象添加到RequestQueue裡就可以了，如下所示：

mQueue.add(jsonObjectRequest);

這樣當HTTP通信完成之後，服務器響應的天氣信息就會回調到onResponse()方法中，並打印出來。現在運行一下程序，發出這樣一條HTTP請求，就會看到LogCat中會打印出如下圖所示的數據。

由此可以看出，服務器返回給我們的數據確實是JSON格式的，並且onResponse()方法中攜帶的參數也正是一個JSONObject對象，之後只需要從JSONObject對象取出我們想要得到的那部分數據就可以了。

你應該發現了吧，JsonObjectRequest的用法和StringRequest的用法基本上是完全一樣的，Volley的易用之處也在這裡體現出來了，會了一種就可以讓你舉一反三，因此關於JsonArrayRequest的用法相信已經不需要我再去講解了吧。

好了，關於Volley的基本用法就講到這裡，下篇文章中我會帶領大家繼續探究Volley。感興趣的朋友請繼續閱讀看一篇。