朋友圈上传图片+文字怎么破?

需求

Retrofit普及后,最近好多人都在问,如何实现Retrofit上传多文件+文字需求(朋友圈发图片+文字)

解决方案

google: retrofit upload multiple files

说重点

与其直接说答案,不如我们花点时间说说多文件上传的原理,这样,以后就算出了其他的http框架,你也能快速实现。

HTTP协议就不讲了吧?反正copy一段过来也不会有人看。我们就直接跳到文件上传去。想看也可以,传送门

post form 表单



上图是不是很常见,在网页里选一个文件,点击上传。上传到哪里?服务器咯。web和移动端本质上有区别嘛?木有啊,就是一个前端展示的client。那服务器会为移动端创造一套独立的API嘛?显然他没那么傻。

这个文件上传经常会伴随着其他fields一起上传。可以简单理解为表单上传。

先来看下,如果没有文件,也不用json,单独上传一些key value怎么做?在Postman里可以这样模拟。

朋友圈上传图片+文字怎么破?_第1张图片


表单上传要注意的是

content-type设为application/x-www-form-urlencoded

form表单在streaming时是"weibo=stay4it&wechat=stay4it&qq=104816053"


多文件上传

实际上,多文件上传与form表单是一回事,一个key对应一个value。文件上传就是文件名key对应文件byte[] value,如下图postman模拟请求

朋友圈上传图片+文字怎么破?_第2张图片


只是如何标记一个key value的开始结束呢?用&分割肯定不够用啦。那就得用个特殊的boudary来做为分隔符。

另外,这个content-type得为multiple/form-data

好了。科普到此结束。简单理解HTTP协议以及form表单概念,相信接下来的代码你就不只是会调用,还能明白为什么。

最原始的上传方式

以前大家都用HttpUrlConnection,Stay在自己动手写HTTP框架-19课时详细讲过如何上传多文件以及进度更新。这里贴下核心代码:

朋友圈上传图片+文字怎么破?_第3张图片

以上这个UploadUtil,拿到outputstream,分别写入postContent以及List,代码不多,相信大家都能看明白。

抓个包看看

请求数据抓包

朋友圈上传图片+文字怎么破?_第4张图片


上传的有两个form,
一个content-typetext/plain key为data, value为stay4it
一个content-typeimage/png key为file0, value为文件的bytes

服务器如何接收的?(PHP版)

朋友圈上传图片+文字怎么破?_第5张图片


代码还算好懂,$_FILES就是请求上传的多文件,只要content-type设置为multiple/form-data,服务器接收是就会将其当成文件处理,将文件接收在$_FILES中,等待处理(存数据库,存硬盘或转七牛云等等),$this->data是表单中key为data所对应的valuestay4it。(以后再有服务器er告诉你分两个API上传,你就可以这么怼他了: )

返回结果抓包

朋友圈上传图片+文字怎么破?_第6张图片


好了,原始的方式聊的差不多了,虽然代码看起来很多,但已经是个util类了,倒不是那么难用。但是我们还是希望在写代码时能尽可能少的去关注内部实现啊。什么multiple/form-data,什么boundary。真是很麻烦嘛。

鸟枪换大炮吧

以下Retrofit多文件上传内容由一叶飘舟大神提供。

Retrofit实现文件和图片一起上传

如果对retrofit不是很了解,参考:初识Retrofit

定义接口

根据对Stay自己动手写HTTP框架-19课时提供的上传图片接口的大量抓包和测试总结,接口定义如下:



这里用到了@Partmap注解,将图片文件信息放入map中。

准备图片

在sdcard根目录存放两张图片,分别为test.png和test.jpg(不要是gif图片啊,服务器不支持)

代码实现

这里就不贴代码了,截图如下(如果看不清,鼠标右键在新窗口打开就可以看到原图了):

朋友圈上传图片+文字怎么破?_第7张图片


关键代码在于:


看到这个是不是想起了上面我们提到的关键代码呢?下面再贴出来我们对比下。


只要将对应的http请求头信息填写正确,就能上传成功。

那么问题又来了,怎么分析和正确拼写这个请求头呢?

在文章开头的时候有个抓包信息:

Content-Disposition: form-data; name="file0"; filename="test.png"

实质上上传文件Requestbody对应的请求头就是 name="file0"; filename="test.png",只要拼对了就没有问题了。

注意:

  1. name="file0"; filename="test.png"这个请求头是根据有心课堂提供的上传接口写的,不适用其他上传接口,但原理是类似的;

  2. 单张图片上传通用的请求头是:name="file"; filename="test.png"

  3. filename="test.png"这个一般是指(你希望)保存在服务器的文件名字。

举例说明

比如我们这样写请求头信息,如下代码所示:



运行请求抓包请求头信息如下图所示:

朋友圈上传图片+文字怎么破?_第8张图片


出现了name="name="file1"这样的字段,拼接错误(不用加name字段),服务器也毫不留情的返回了错误:

朋友圈上传图片+文字怎么破?_第9张图片


这个问题我当初没有发现,后来还是请教了Stay才搞明白了。

好了,不知道我讲的大家明白了没有,最后来个成功运行的请求抓包截图吧:

朋友圈上传图片+文字怎么破?_第10张图片


关于文字类参数上传

写到最后忘了说文字参数了,文字参数相对文件来说容易些。

在接口中,我们有一个文字参数 @Part("data") String des,如果你需要多个,增加就行了。需要注意的是这个参数的名字比如"data",不是前端自定义,而是后台定义的。

代码托管地址:

https://github.com/stay4it/RetrofitTutorial

2016.8.19 凌晨


你可能感兴趣的:(Android)