首先我们来看看在http请求里面,如何提交数组参数,这里我们以GET请求为例。比如我们需要向服务器发送多个用户ID,那么如何以数组的方式向服务器提交数据呢?下面是示例代码:
http://192.168.1.1/api?id=1&id=2&id=3
基本做法就是这样,重复的参数名,不同的参数内容。那么回到xUtils3这个http请求库上来,我们怎么向服务器提交数组参数呢?xUtils3里面发起GET请求添加参数,通常都是调用RequestParams的addQueryStringParameter方法,但是这个方法仅允许我们提交String对象,无法直接添加数组对象。
后来,我采取了一种折中办法,代码示意如下:
params.addQueryStringParameter("id","1&id=2&id=3")
但是xUtils在组装参数的时候,会进行encode导致服务器无法正常识别我们的参数。因此,我又回去研究了一下RequestParams的源码,发现有个方法可以直接添加数组,那就是addParameter。在这个方法里面,我们的value参数直接就是Object类型,所以数组也是ok的。下面贴一下这个方法的实现,我们可以看到xUtils3很贴心的为我们做了判断。
/**
* 添加请求参数(根据请求谓词, 将参数加入QueryString或Body.)
*
* @param name 参数名
* @param value 可以是String, File, InputStream 或 byte[]
*/
public void addParameter(String name, Object value) {
if (value == null) return;
if (method == null || HttpMethod.permitsRequestBody(method)) {
if (!TextUtils.isEmpty(name)) {
if (value instanceof File
|| value instanceof InputStream
|| value instanceof byte[]) {
this.fileParams.add(new KeyValue(name, value));
} else {
if (value instanceof Iterable) {
for (Object item : (Iterable) value) {
this.bodyParams.add(new ArrayItem(name, item));
}
} else if (value instanceof JSONArray) {
JSONArray array = (JSONArray) value;
int len = array.length();
for (int i = 0; i < len; i++) {
this.bodyParams.add(new ArrayItem(name, array.opt(i)));
}
} else if (value.getClass().isArray()) {
int len = Array.getLength(value);
for (int i = 0; i < len; i++) {
this.bodyParams.add(new ArrayItem(name, Array.get(value, i)));
}
} else {
this.bodyParams.add(new KeyValue(name, value));
}
}
} else {
this.bodyContent = value.toString();
}
} else {
if (!TextUtils.isEmpty(name)) {
if (value instanceof Iterable) {
for (Object item : (Iterable) value) {
this.queryStringParams.add(new ArrayItem(name, item));
}
} else if (value.getClass().isArray()) {
int len = Array.getLength(value);
for (int i = 0; i < len; i++) {
this.queryStringParams.add(new ArrayItem(name, Array.get(value, i)));
}
} else {
this.queryStringParams.add(new KeyValue(name, value));
}
}
}
}