Volley StringRequest和JSONObjectRequest使用几个细节

最新推荐文章于 2025-05-13 07:00:00 发布

zhangzhanhua126

最新推荐文章于 2025-05-13 07:00:00 发布

阅读量576

点赞数

分类专栏： volley 文章标签： volley

volley 专栏收录该内容

3 篇文章

订阅专栏

来自http://blog.youkuaiyun.com/onlysnail/article/details/47905375

一、Volley StringRequest

下面是百度api提供的免费的接口‘天气查询-查看可用城市列表’，在百度apistore中有提供(天气查询)。

看下官方提供的代码：

String httpUrl = "http://apis.baidu.com/apistore/weatherservice/citylist";  
String httpArg = "cityname=%E6%9C%9D%E9%98%B3";  
String jsonResult = request(httpUrl, httpArg);  
System.out.println(jsonResult);  
  
/** 
 * @param urlAll 
 *            :请求接口 
 * @param httpArg 
 *            :参数 
 * @return 返回结果 
 */  
public static String request(String httpUrl, String httpArg) {  
    BufferedReader reader = null;  
    String result = null;  
    StringBuffer sbf = new StringBuffer();  
    httpUrl = httpUrl + "?" + httpArg;  
  
    try {  
        URL url = new URL(httpUrl);  
        HttpURLConnection connection = (HttpURLConnection) url  
                .openConnection();  
        connection.setRequestMethod("GET");  
        // 填入apikey到HTTP header  
        connection.setRequestProperty("apikey",  "您自己的apikey");  
        connection.connect();  
        InputStream is = connection.getInputStream();  
        reader = new BufferedReader(new InputStreamReader(is, "UTF-8"));  
        String strRead = null;  
        while ((strRead = reader.readLine()) != null) {  
            sbf.append(strRead);  
            sbf.append("\r\n");  
        }  
        reader.close();  
        result = sbf.toString();  
    } catch (Exception e) {  
        e.printStackTrace();  
    }  
    return result;  
}

现在用Volley 的StringRequest实现它的接口。需要关注的几个地方：

Url

httpUrl = httpUrl + "?" + httpArg;//http://apis.baidu.com/apistore/weatherservice/citylist?cityname=%E6%9C%9D%E9%98%B3

Request Method：

connection.setRequestMethod("GET");

<span style="font-family: Arial; font-size: 14px; line-height: 26px;">Header ：</span>

<span style="font-family: Arial; font-size: 14px; line-height: 26px;"></span><pre name="code" class="java">connection.setRequestProperty("apikey",  "您自己的apikey");

参数带在url后面，如果有多个参数用‘&’分割

如果是拼接参数需要注意最前面还有一个‘？’

GET请求

带了http header参数，对应connection.setRequestProperty("","");

下面使用Volley的StringRequest的两种方式来实现上面的请求。

第一种：StringRequest Method.GET

把参数带在url后面，使用StringRequest的不带参构造。Header参数重写getHeaders方法，对应 connection.setRequestProperty("apikey", "您自己的apikey");

private String url = "http://apis.baidu.com/apistore/weatherservice/citylist";  
private String params = "cityname=朝阳";  
[java] view plain copy print?
private void stringRequestWithGet(){  
       url = url + "?" + params;  
       StringRequest stringRequest = new StringRequest(Request.Method.GET, url, new Response.Listener<String>() {  
           @Override  
           public void onResponse(String response) {  
               try {  
                   //使用JSONObject给response转换编码  
                   JSONObject jsonObject = new JSONObject(response);  
                   responseText.setText(jsonObject.toString());  
               } catch (JSONException e) {  
                   e.printStackTrace();  
               }  
           }  
       }, new Response.ErrorListener() {  
           @Override  
           public void onErrorResponse(VolleyError error) {  
               responseText.setText(error.getMessage());  
           }  
       }){  
           @Override  
           public Map<String, String> getHeaders() throws AuthFailureError {  
               Map<String,String> map = new HashMap<>();  
               map.put("apikey","f71e5f1e08cd5a7e42a7e9aa70d22458");  
               return map;  
           }  
       };  
       mQueue.add(stringRequest);  
   }

第二种：StringRequest Method.POST

Method：改为POST

Params：参数不带在Url末尾，而是重写StringRequest的getParams()。

注意：我以这种方式请求百度apistore中 ‘天气查询-查看可用城市列表’接口，没有成功。但是访问其他提供商的API是成功的。可能是这个接口不支持Post请求，或者我少传了什么参数吧。

private void stringRequestWithPost(){  
        StringRequest stringRequest = new StringRequest(Request.Method.POST, url, new Response.Listener<String>() {  
            @Override  
            public void onResponse(String response) {  
                try {  
                    //使用JSONObject给response转换编码  
                    JSONObject jsonObject = new JSONObject(response);  
                    responseText.setText(jsonObject.toString());  
                } catch (JSONException e) {  
                    e.printStackTrace();  
                }  
            }  
        }, new Response.ErrorListener() {  
            @Override  
            public void onErrorResponse(VolleyError error) {  
                responseText.setText(error.getMessage());  
            }  
        }){  
            @Override  
            protected Map<String, String> getParams() throws AuthFailureError {  
                Map<String,String> map = new HashMap<>();  
                map.put("cityname","朝阳");  
                return map;  
            }  
  
            @Override  
            public Map<String, String> getHeaders() throws AuthFailureError {  
                Map<String,String> map = new HashMap<>();  
                map.put("apikey","f71e5f1e08cd5a7e42a7e9aa70d22458");  
                return map;  
            }  
        };  
        mQueue.add(stringRequest);  
    }

二、Volley JsonObjectRequest

下面介绍使用JsonObjectRequest，以及使用JsonObjectRequest会遇到的一些坑。

由于百度apistore中我以post请求一直没成功过，不知道是什么问题，下面我换了一家API提供商 showapi 的 'QQ音乐十八大排行榜’接口来进行GET请求和POST请求。

先说Method.POST，遇到的坑会多一点。

第一种：JsonObjectRequest Method.POST

错误写法

/** 
    * JsonOnjectRequest Post 错误方式 
    * 这里使用了和StringRequest一样的方式传参 重写getParams()方法。 
    */  
   private void jsonObjectRequestError1(){  
  
       String url = "http://route.showapi.com/213-3";  
       final Map<String,String> params = DummyData.getDummyData();  
  
       JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(Request.Method.POST,url,null, new Response.Listener<JSONObject>() {  
           @Override  
           public void onResponse(JSONObject response) {  
               responseText.setText(response.toString());  
           }  
       }, new Response.ErrorListener() {  
           @Override  
           public void onErrorResponse(VolleyError error) {  
               responseText.setText(error.getMessage());  
           }  
       }){  
           @Override  
           protected Map<String, String> getParams() throws AuthFailureError {  
               return params;  
           }  
       };  
       mQueue.add(jsonObjectRequest);  
   }

sonObjectRequest构造中的参数传null，和StringRequest一样去重写getParams()方法来传参。貌似是没问题的？

使用这段代码拿不到服务器返回的数据，反馈的结果是没有传参给服务器。那就看看参数最终是在哪里提交给服务器的。

Debug HurlStack.Java中的addBodyIfExists()这个方法，发现request.getBody()==null，也就是没有接收到参数。

StringRequest可以重写getParams来传参是因为Request中的这个方法：

Request.java

public byte[] getBody() throws AuthFailureError {  
    Map<String, String> params = getParams();  
    if (params != null && params.size() > 0) {  
        return encodeParameters(params, getParamsEncoding());  
    }  
    return null;  
}

重写的getParams的结果会传到这里。

JsonObjectRequest不能重写getParams来传参是因为JsonRequest中的这个方法：
JsonRequest.java

@Override  
public byte[] getBody() {  
    try {  
        return mRequestBody == null ? null : mRequestBody.getBytes(PROTOCOL_CHARSET);  
    } catch (UnsupportedEncodingException uee) {  
        VolleyLog.wtf("Unsupported Encoding while trying to get the bytes of %s using %s",  
                mRequestBody, PROTOCOL_CHARSET);  
        return null;  
    }  
}

重写了Request.getBody()，这段代码说明 mRequestBody这个变量就是它的参数。这个变量就存在与JsonRequest的构造函数中。

说明，JsonObjectRequest的传参必须通过构造来传，重写getParams()是无法传递的。

下面按正常思路，来踩第二个坑。给JsonObjectRequest的构造传递参数。又会出现什么问题？

/** 
 * JsonOnjectRequest Post 可能会出错的方式 
 * 
 * 这里的思路是调用JsonObjectRequest带参构造，传参进入不就得了? 
 * 但是这里还是请求不到数据。 
 * 原因是使用JsonObjectRequest 如果服务器接受的参数类型是 http://....?key1=value1&key2=value2， 
 * 而不是json串{key1 : value1,key2 : value2...}，参数就会传不进去。 
 * 可以在 HurlStack.java 的addBodyIfExists方法中看到你传入的参数信息。 
 */  
private void jsonObjectRequestError2(){  
  
    String url = "http://route.showapi.com/213-3";  
    Map<String,String> map = DummyData.getDummyData();  
    JSONObject params = new JSONObject(map);  
  
    JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(Request.Method.POST,url,params, new Response.Listener<JSONObject>() {  
        @Override  
        public void onResponse(JSONObject response) {  
            responseText.setText(response.toString());  
        }  
    }, new Response.ErrorListener() {  
        @Override  
        public void onErrorResponse(VolleyError error) {  
            responseText.setText(error.getMessage());  
        }  
    });  
    mQueue.add(jsonObjectRequest);  
}

仍然获取不到数据，原因看上面的注释。反馈的结果是没有传参给服务器。那就看看参数最终是在哪里提交给服务器的。

Debug HurlStack.java中的addBodyIfExists()这个方法。

参数传递是正确的，只不过传递的参数格式是一个json串。这时考虑是不是服务器不接受这样的传参，那就换一种格式传递参数：

http://apis.baidu.com/apistore/weatherservice/citylist?key1=value1&key2=value2...

下面以这种思路把代码进行改造。

假设服务器不接受json串的参数，而是接受key=value这样的参数，这样我们就传递这种格式的参数给JsonObjectRequest。然后在试试能否成功。但是JsonObjectRequest的构造中，参数必须以JSONObject来定义，所以只能单独定义一个类继承JSONObject，参数以String的格式传入。

按正常思路，来踩第三个坑。定义一个类继承JsonObjectRequest，传入一个String参数，格式是 "key1=value1&key2=value2..."。

这里不贴代码了，这个类除了把构造的参数JSONObject改为String，其他完全一致。当然，结果还是获取不到数据。

原因很简单，看JsonRequest中的变量 PROTOCOL_CONTENT_TYPE。

/** Content type for request. */  
private static final String PROTOCOL_CONTENT_TYPE =  
String.format("application/json; charset=%s", PROTOCOL_CHARSET);

请求的是一个json串，但是这里自定义的Request传入的参数不是一个json串。所以还需要在自定义的类中重写一个方法：

@Override  
public String getBodyContentType() {  
    return "application/x-www-form-urlencoded; charset=" + getParamsEncoding();  
}

这段代码从Request.java中Copy。

public class MyJsonObjectRequest extends JsonRequest<JSONObject> {  
  
    String stringRequest;  
  
    /** 
     * 这里的method必须是Method.POST，也就是必须带参数。 
     * 如果不想带参数，可以用JsonObjectRequest，给它构造参数传null。GET方式请求。 
     * @param stringRequest 格式应该是 "key1=value1&key2=value2" 
     */  
  
    public MyJsonObjectRequest(String url, String stringRequest,  
                             Response.Listener<JSONObject> listener, Response.ErrorListener errorListener) {  
        super(Method.POST, url,stringRequest , listener, errorListener);  
        this.stringRequest = stringRequest;  
    }  
  
    @Override  
    public String getBodyContentType() {  
        return "application/x-www-form-urlencoded; charset=" + getParamsEncoding();  
    }  
  
    @Override  
    protected Response<JSONObject> parseNetworkResponse(NetworkResponse response) {  
        try {  
            String jsonString = new String(response.data,  
                    HttpHeaderParser.parseCharset(response.headers, PROTOCOL_CHARSET));  
            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));  
        }  
    }

自定义的Request

public class MyJsonObjectRequest extends JsonRequest<JSONObject> {  
  
    String stringRequest;  
  
    /** 
     * 这里的method必须是Method.POST，也就是必须带参数。 
     * 如果不想带参数，可以用JsonObjectRequest，给它构造参数传null。GET方式请求。 
     * @param stringRequest 格式应该是 "key1=value1&key2=value2" 
     */  
  
    public MyJsonObjectRequest(String url, String stringRequest,  
                             Response.Listener<JSONObject> listener, Response.ErrorListener errorListener) {  
        super(Method.POST, url,stringRequest , listener, errorListener);  
        this.stringRequest = stringRequest;  
    }  
  
    @Override  
    public String getBodyContentType() {  
        return "application/x-www-form-urlencoded; charset=" + getParamsEncoding();  
    }  
  
    @Override  
    protected Response<JSONObject> parseNetworkResponse(NetworkResponse response) {  
        try {  
            String jsonString = new String(response.data,  
                    HttpHeaderParser.parseCharset(response.headers, PROTOCOL_CHARSET));  
            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));  
        }  
    }

请求方法：

private void jsonObjectRequestPostSuccess1(){  
        String url = "http://route.showapi.com/213-3";  
        Map<String,String> map = DummyData.getDummyData();  
        String params = appendParameter(url,map);  
  
        MyJsonObjectRequest jsonObjectRequest = new MyJsonObjectRequest(url,params, new Response.Listener<JSONObject>() {  
            @Override  
            public void onResponse(JSONObject response) {  
                responseText.setText(response.toString());  
            }  
        }, new Response.ErrorListener() {  
            @Override  
            public void onErrorResponse(VolleyError error) {  
                responseText.setText(error.getMessage());  
            }  
        });  
        mQueue.add(jsonObjectRequest);  
    }  
  
  
  
    private String appendParameter(String url,Map<String,String> params){  
        Uri uri = Uri.parse(url);  
        Uri.Builder builder = uri.buildUpon();  
        for(Map.Entry<String,String> entry:params.entrySet()){  
            builder.appendQueryParameter(entry.getKey(),entry.getValue());  
        }  
        return builder.build().getQuery();  
    }

当然，也并非一定要自定义一个JsonObjectRequest不可，如果了解Request的继承关系和参数的传递流程，直接使用JsonObjectRequest也是可以的。

** 
 * 不想自定义，非得用JsonObjectRequestPost不可，只要你不嫌麻烦。 
 */  
private void jsonObjectRequestPostSuccess2(){  
    String url = "http://route.showapi.com/213-3";  
    Map<String,String> params = DummyData.getDummyData();  
    final String mRequestBody = appendParameter(url,params);  
  
    JsonObjectRequest jsonObjectRequest = new JsonObjectRequest(Request.Method.POST,url,null, new Response.Listener<JSONObject>() {  
        @Override  
        public void onResponse(JSONObject response) {  
            responseText.setText(response.toString());  
        }  
    }, new Response.ErrorListener() {  
        @Override  
        public void onErrorResponse(VolleyError error) {  
            responseText.setText(error.getMessage());  
        }  
    }){  
        @Override  
        public String getBodyContentType() {  
            return "application/x-www-form-urlencoded; charset=" + getParamsEncoding();  
        }  
  
        @Override  
        public byte[] getBody() {  
            try {  
                return mRequestBody == null ? null : mRequestBody.getBytes(PROTOCOL_CHARSET);  
            } catch (UnsupportedEncodingException uee) {  
                VolleyLog.wtf("Unsupported Encoding while trying to get the bytes of %s using %s",  
                        mRequestBody, PROTOCOL_CHARSET);  
                return null;  
            }  
        }  
    };  
    mQueue.add(jsonObjectRequest);  
}  
  
private String appendParameter(String url,Map<String,String> params){  
    Uri uri = Uri.parse(url);  
    Uri.Builder builder = uri.buildUpon();  
    for(Map.Entry<String,String> entry:params.entrySet()){  
        builder.appendQueryParameter(entry.getKey(),entry.getValue());  
    }  
    return builder.build().getQuery();  
}

总结：

使用JsonObjectRequest 请求服务器，它的参数是以 json 串的格式传输给服务器的，考虑服务器是否支持这种格式，可以在JsonRequest的PROTOCOL_CONTENT_TYPE中看到它传递参数的类型。如果服务器支持的是 http:...?key1=value1&key2=value2这种格式，也就是对应Request.java中的PROTOCOL_CONTENT_TYPE变量类型。就需要做一些改动，有两种方式来实现。第一种方式是定义一个类继承JsonObjectRequest，第二种直接使用JsonObjectRequest。原理是相同的，重点是重写匿名内部类的getBodyContentType这个方法。不能重写getParams这个方法类传参。

使用StringRequest 如果是带参数，或者Http Header，或者其他，可以重写它匿名内部类方法，如getParams()，getHeader()等等。

有必要关注HurlStack.java这个类。