上一篇文章中,讲了 Volley 的 get 和 post 请求,并且对 volley 的基本使用和基本分析做了讲解,而这篇 blog 将讲解用 volley 实现表单的提交,在看这篇文章之前,如果对 Volley 基本知识不够了解的朋友,可以移驾前往Android Volley解析(一)之GET、POST请求篇
表单提交的数据格式
要实现表单的提交,就要知道表单提交的数据格式是怎么样,这里我从某知名网站抓了一条数据,先来分析别人提交表单的数据格式。
数据包:
Connection: keep-aliveContent-Length: 123X-Requested-With: ShockwaveFlash/16.0.0.296User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.93 Safari/537.36Content-Type: multipart/form-data; boundary=----------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1Accept: */*Accept-Encoding: gzip, deflateAccept-Language: zh-CN,zh;q=0.8Cookie: bdshare_firstime=1409052493497------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1Content-Disposition: form-data; name="position"1425264476444------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1Content-Disposition: form-data; name="editorIndex"ue_con_1425264252856------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1Content-Disposition: form-data; name="cm"100672------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1--
看到上面的数据包,我们不需要全部分析,我们主要关心的是数据如何封装,因为http请求头,在网络请求中已经为我们封装好了;可以看到这里总共是提交了三条数据,每一条数据的格式都是一样的,所以我们只需要分析一条数据即可,这里拿最后一条数据来说,因为在所有的数据之后还有一个结尾的标志。
------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1Content-Disposition: form-data; name="cm"100672------------Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1--
这条数据一共有四行组成,加上结尾标志共有五行
1、第一行:
"--" + boundary + "\r\n" ;
说明:”–”为数据开始标志,boundary为http实体头定义的边界分割线,boundary可以是任意的字符串,只要和Content-Type: multipart/form-data; boundary=———-Ij5ei4KM7KM7ae0KM7cH2ae0Ij5Ef1中保持一直即可,”\r\n”为回车换行;
2、第二行:
"Content-Disposition: form-data; name="参数的名称"" + "\r\n" ;
说明:Content-Disposition表示上传的内容特性,form-data上传内容特性为表单的形式;
3、第三行:
"\r\n" ;
4、说明:这是一个空行,只有一个回车换行 ;
第四行:
"参数的值" + "\r\n" ;
说明:每个参数都是由一个key和value组成,而这一行就是value跟回车换行符
结尾行:
"--" + boundary + "--" + "\r\n" ;
说明:在所有的数据结束之后,需要有这个结尾标志。
如果有多个参数,则重复1、2、3、4,直至最后一个参数的最后加上结尾行。
参数实体类
这里对参数做一个封装,因为往往提交表单的时候,都需要提交多个参数
/** * Created by gyzhong on 15/3/2. *//*表单提交的参数*/public class FormText { /*参数的名称*/ private String mName ; /*参数的值*/ private String mValue ; public FormText(String mName, String mValue) { this.mName = mName; this.mValue = mValue; } public String getName() { return mName; } public String getValue() { return mValue; }}
Volley 对数据的封装
在上一篇文章中我们讲了如何定制自己的 Request,在这里同样需要用到。在定制 Request 的时候,需要重写获取实体的方法
public byte[] getBody() throws AuthFailureError {}
把参数通过二进制的形式传给服务器,当然就不需要重写获取参数的方法
protected Map<String, String> getParams() throws AuthFailureError {}
最核心的方法也就在getBody()中,这个方法的实现,如果对表单提交的数据格式很了解,实现起来非常简单,因为这个方法就是把参数拼接成我们所分析的数据格式;
@Override public byte[] getBody() throws AuthFailureError { if (mListItem == null||mListItem.size() == 0){ return super.getBody() ; } ByteArrayOutputStream bos = new ByteArrayOutputStream() ; int N = mListItem.size() ; FormText formText ; for (int i = 0; i < N ;i++){ formText = 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(formText.getName()) ; sb.append("\"") ; sb.append("\r\n") ; /*第三行:"\r\n" ;*/ sb.append("\r\n") ; /*第四行:"参数的值" + "\r\n" ;*/ sb.append(formText.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(); } Log.v("zgy","=====formText====\n"+bos.toString()) ; return bos.toByteArray(); }
可以看到,这个方法的实现,就是对数据按照我们所分析的格式组装。
在 Request 中还有一个关键的地方,需要在 http 头部中声明内容类型为表单数据
Content-Type: multipart/form-data; boundary=----------8888888888888
所以的重写下面方法为
public String getBodyContentType() { return MULTIPART_FORM_DATA+"; boundary="+BOUNDARY; }
同样,我们还是前面我们blog 中讲到的接口http://www.minongbang.com/test.php?test=minongbang来测试,所以解析数据那一块跟 前面我们将的一样,具体实现如下:
/** * Created by gyzhong on 15/3/2. */public class PostFormRequest<T> extends Request<T> { /** * 正确数据的时候回掉用 */ private ResponseListener mListener ; /*用来解析 json 用的*/ private Gson mGson ; /*在用 gson 解析 json 数据的时候,需要用到这个参数*/ private Type mClazz ; /*请求 数据通过参数的形式传入*/ private List<FormText> mListItem ; private String BOUNDARY = "---------8888888888888"; //数据分隔线 private String MULTIPART_FORM_DATA = "multipart/form-data"; public PostFormRequest(String url, List<FormText> 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)); Log.v("zgy", "====SearchResult===" + jsonString); 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() ; FormText formText ; for (int i = 0; i < N ;i++){ formText = 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(formText.getName()) ; sb.append("\"") ; sb.append("\r\n") ; /*第三行:"\r\n" ;*/ sb.append("\r\n") ; /*第四行:"参数的值" + "\r\n" ;*/ sb.append(formText.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(); } Log.v("zgy","=====formText====\n"+bos.toString()) ; return bos.toByteArray(); } /*获取内容类型,这里为表单类型*/ @Override public String getBodyContentType() { return MULTIPART_FORM_DATA+"; boundary="+BOUNDARY; }}
表单提交接口
接口我们在上一篇博文中也做了比较详细的讲解,这里就不累赘了。
/** * minong 测试post表单提交接口 * @param value 测试数据 * @param listener 回调接口,包含错误回调和正确的数据回调 */ public static void postFormMiNongApi(String value,ResponseListener listener){ List<FormText> formTextList = new ArrayList<FormText>() ; formTextList.add(new FormText(" test",value)); Request request = new PostFormRequest(Constant.MiNonghost,formTextList,new TypeToken<SearchResult>(){}.getType(),listener) ; VolleyUtil.getRequestQueue().add(request) ; }
测试
PostFormActivity.java的测试代码如下
public class PostFormActivity extends ActionBarActivity { private ListView mListView ; private SongAdapter mAdapter ; private List<SongDetail> mSongList ; private ProgressDialog mDialog ; private View mHeaderView ; private TextView mShowPostData ; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_post_form); mSongList = new ArrayList<SongDetail>() ; mListView = (ListView) findViewById(R.id.id_list_view); mAdapter = new SongAdapter(this,mSongList) ; mHeaderView = getLayoutInflater().inflate(R.layout.list_header_item,null) ; mShowPostData = (TextView) mHeaderView.findViewById(R.id.id_post_data) ; mListView.addHeaderView(mHeaderView); mListView.setAdapter(mAdapter); mDialog = new ProgressDialog(this) ; mDialog.setMessage("数据提交中..."); mDialog.show() ; /*请求网络获取数据*/ MiNongApi.postFormMiNongApi(" minongbang",new DataResponseListener<SearchResult>() { @Override public void onErrorResponse(VolleyError error) { Log.v("zgy","======onErrorResponse====="+error); mDialog.dismiss(); } @Override public void onResponse(SearchResult response) { Log.v("zgy","======onResponse====="+response); mSongList.addAll(response.getData().getInfo()) ; mAdapter.notifyDataSetChanged(); mDialog.dismiss(); } @Override public void postData(String data) { mShowPostData.setText(data); } }); }
通过以上内容我们不难发现,表单提交就是把文本通过二进制的形式传给服务器,从而得到对应的响应,这篇 blog 其实也算是一篇过度的文章,因为一般我们不会这么提交文字数据,而是通过我们上一篇 blog 中的post 请求的方式,那什么时候我们需要用到表单提交呢,当表单中含有附件,如图片,视频等文件的的时候;这也就是我们下一篇 blog 要讲的:volley 解析(三)文件上传篇。
下载源码