Android Volley文件上传（一）

对于Volley的使用这里不做介绍，不清楚的自己找资料了解，我给大家介绍的是使用Volley网络框架来实现上传文件功能，因为volley没有自带上传文件功能，因此只能自己实现。而实现Volley文件上传前，必须了解表单的提交。

(一)表单提交

要了解表单提交必须知道表单提交的数据格式是什么样，从网站抓取一条数据，分析其表单的数据格式

Connection: keep-alive
Content-Length: 123
X-Requested-With: ShockwaveFlash/16.0.0.296
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.93 Safari/537.36
Content-Type: multipart/form-data; boundary=----------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1
Accept: */*
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.8
Cookie: bdshare_firstime=1409052493497

------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1
Content-Disposition: form-data; name="position"

1425264476444
------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1
Content-Disposition: form-data; name="editorIndex"

ue_con_1425264252856
------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1
Content-Disposition: form-data; name="cm"

100672
------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1--

看上面数据格式，只需要分析数据如何封装的，因为http请求头已经帮我们封装好了。上面有三条数据，因为都一样，所以只需要分析一条，拿最后一条来分析，因为最后一条保护了结尾符。

------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1
Content-Disposition: form-data; name="cm"

100672
------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1--

第一行

其格式是 “–” + boundary + “\r\n”。”-“是数据开始标志，boundary是为http实体头定义的数据分割线，boundary可以为任意字符，只需要和————Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1中保持一致即可，

“\r\n”是回车换行

------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1

第二行

其格式是 “Content-Disposition: form-data; name=” + 参数名称 + “\r\n”。Content-Disposition是上传的内容特性， form-data是以表单形式上传

Content-Disposition: form-data; name="cm"

第三行

其格式是”\r\n”，回车换行

第四行

其格式是 value + “\r\n”。 value是参数的值，参数是由key和value组成

100672

第五行

其格式是“–”+boundary + “–” + “\r\n”

------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1--

说明：在所有的数据结束之后，需要有这个结尾标志。

如果有多个参数，则重复1、2、3、4，直至最后一个参数的最后加上结尾行。

一、创建表单参数实体类

这里对参数做一个封装，因为往往提交表单的时候，都需要提交多个参数

/**
* 表单实体类
* Created by Hlh on 2016/4/14.
*/
public class TextParams {
private String name;
private String value;

public String getName() {
return name;
}

public String getValue() {
return value;
}

public void setName(String name) {
this.name = name;
}

public void setValue(String value) {
this.value = value;
}
}

二、Volley 对数据的封装

/**
* Created by Hlh on 2016/4/14.
*/
public class PostFormRequest extends Request {

private ResponseListener mListener;
//用来解析 json 用的
private Gson mGson;
//在用 gson 解析 json 数据的时候，需要用到这个参数
private Type mClazz;
//请求 数据通过参数的形式传入
private List<TextParams> mListItem;
//数据分割线
private String BOUNDARY = "---------Hlh";
private String MULTIPART_FORM_DATA = "multipart/form-data";

public PostFormRequest(String url, List<TextParams> listItem, Type type, ResponseListener listener) {
super(Method.POST, url, listener);
this.mListener = listener;
mGson = new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create();
mClazz = type;
setShouldCache(false);
mListItem = listItem;
}

/**
* 这里开始解析数据
*
* @param response Response from the network
* @return
*/
@Override
protected Response<T> parseNetworkResponse(NetworkResponse response) {
try {
T result;
String jsonString =
new String(response.data, HttpHeaderParser.parseCharset(response.headers));
result = mGson.fromJson(jsonString, mClazz);
return Response.success(result,
HttpHeaderParser.parseCacheHeaders(response));
} catch (UnsupportedEncodingException e) {
return Response.error(new ParseError(e));
}
}

/**
* 回调正确的数据
*
* @param response The parsed response returned by
*/
@Override
protected void deliverResponse(T response) {
mListener.onResponse(response);
}

@Override
public byte[] getBody() throws AuthFailureError {
if (mListItem == null || mListItem.size() == 0) {
return super.getBody();
}
ByteArrayOutputStream bos = new ByteArrayOutputStream();
int N = mListItem.size();
TextParams TextParams;
for (int i = 0; i < N; i++) {
TextParams = mListItem.get(i);
StringBuffer sb = new StringBuffer();
/*第一行:"--" + boundary + "\r\n" ;*/
sb.append("--" + BOUNDARY);
sb.append("\r\n");
/*第二行:"Content-Disposition: form-data; name="参数的名称"" + "\r\n" ;*/
sb.append("Content-Disposition: form-data;");
sb.append("name=\"");
sb.append(TextParams.getName());
sb.append("\"");
sb.append("\r\n");
/*第三行:"\r\n" ;*/
sb.append("\r\n");
/*第四行:"参数的值" + "\r\n" ;*/
sb.append(TextParams.getValue());
sb.append("\r\n");
try {
bos.write(sb.toString().getBytes("utf-8"));
} catch (IOException e) {
e.printStackTrace();
}
}
/*结尾行:"--" + boundary + "--" + "\r\n" ;*/
String endLine = "--" + BOUNDARY + "--" + "\r\n";
try {
bos.write(endLine.toString().getBytes("utf-8"));
} catch (IOException e) {
e.printStackTrace();
}
return bos.toByteArray();
}

/*获取内容类型，这里为表单类型*/
@Override
public String getBodyContentType() {
return MULTIPART_FORM_DATA + "; boundary=" + BOUNDARY;
}
}

1、Volley定制 Request 的时候，需要重写获取实体的方法

public byte[] getBody() throws AuthFailureError {}

2、把参数通过二进制的形式传给服务器，当然就不需要重写获取参数的方法

protected Map<String, String> getParams() throws AuthFailureError {}

3、为了简化回调接口，这里把错误回调Response.ErrorListener 和正确的数据回调Response.Listener合并成一个ResponseListener

public interface ResponseListener<T> extends Response.ErrorListener,Response.Listener<T> {}

4、最核心的方法也就在getBody()中，这个方法的实现，如果对表单提交的数据格式很了解，实现起来非常简单，因为这个方法就是把参数拼接成我们所分析的数据格式；

@Override
public byte[] getBody() throws AuthFailureError {
if (mListItem == null || mListItem.size() == 0) {
return super.getBody();
}
ByteArrayOutputStream bos = new ByteArrayOutputStream();
int N = mListItem.size();
TextParams TextParams;
for (int i = 0; i < N; i++) {
TextParams = mListItem.get(i);
StringBuffer sb = new StringBuffer();
/*第一行:"--" + boundary + "\r\n" ;*/
sb.append("--" + BOUNDARY);
sb.append("\r\n");
/*第二行:"Content-Disposition: form-data; name="参数的名称"" + "\r\n" ;*/
sb.append("Content-Disposition: form-data;");
sb.append("name=\"");
sb.append(TextParams.getName());
sb.append("\"");
sb.append("\r\n");
/*第三行:"\r\n" ;*/
sb.append("\r\n");
/*第四行:"参数的值" + "\r\n" ;*/
sb.append(TextParams.getValue());
sb.append("\r\n");
try {
bos.write(sb.toString().getBytes("utf-8"));
} catch (IOException e) {
e.printStackTrace();
}
}
/*结尾行:"--" + boundary + "--" + "\r\n" ;*/
String endLine = "--" + BOUNDARY + "--" + "\r\n";
try {
bos.write(endLine.toString().getBytes("utf-8"));
} catch (IOException e) {
e.printStackTrace();
}
return bos.toByteArray();
}

可以看到，这个方法就是实现了对数据的封装

5、 Request 中还有一个关键的地方，需要在 http 头部中声明内容类型为表单数据

Content-Type: multipart/form-data; boundary=----------Hlh

所以的重写下面方法为

public String getBodyContentType() {
return MULTIPART_FORM_DATA+"; boundary="+BOUNDARY;
}

通过以上内容我们不难发现，表单提交就是把文本通过二进制的形式传给服务器，从而得到对应的响应，这篇 blog 其实也算是一篇过度的文章，因为一般我们不会这么提交文字数据，那什么时候我们需要用到表单提交呢，当表单中含有附件，如图片，视频等文件的的时候；这也就是我们下一篇 blog 要讲的：Android volley 文件上传（二）