Android Retrofit 实现文字(参数)和多张图片一起上传

背景

在有心课堂《自己动手写HTTP框架》课程中有下列课程:

自拍要发朋友圈如何实现 http://stay4it.com/course/4/l...

通过自己写的HTTP框架实现将图片和文字等内容在一个接口中提交到后台。

如果你对http请求不是很熟悉,参考:在 Android 上通过模拟 HTTP multipart/form-data 请求协议信息实现图片上传

分析

课程中上传图片相关代码如下图所示:

Android Retrofit 实现文字(参数)和多张图片一起上传_第1张图片

从上面的代码中可以看出,把图片放在了列表中,图片描述放在了request.content中。

通过对该方法运行时的网络请求抓包分析如下:

--7d4a6d158c9
Content-Disposition: form-data; name="data"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

stay4it
--7d4a6d158c9
Content-Disposition: form-data; name="file0"; filename="test.png"
Content-Type: image/png

返回结果抓包分析如下:

Android Retrofit 实现文字(参数)和多张图片一起上传_第2张图片

从上图Contents项中可以看到有两个关键字段,分别是data和file0字段。

这两个字段是怎么产生的呢?

通过查看《自己动手写HTTP框架》相关代码,有如下方法:

public static void upload(OutputStream out, String filePath) throws AppException {
        String BOUNDARY = "7d4a6d158c9"; // 数据分隔线
        DataOutputStream outStream = new DataOutputStream(out);
        try {
            outStream.writeBytes("--" + BOUNDARY + "\r\n");
            outStream.writeBytes("Content-Disposition: form-data; name=\"file0\"; filename=\""
                    + filePath.substring(filePath.lastIndexOf("/") + 1) + "\"" + "\r\n");
            outStream.writeBytes("\r\n");
            byte[] buffer = new byte[1024];
            FileInputStream fis = new FileInputStream(filePath);
            while (fis.read(buffer, 0, 1024) != -1) {
                outStream.write(buffer, 0, buffer.length);
            }
            fis.close();
            outStream.write("\r\n".getBytes());
            byte[] end_data = ("--" + BOUNDARY + "--\r\n").getBytes();// 数据结束标志
            outStream.write(end_data);
            outStream.flush();
        } catch (Exception e) {
            throw new AppException(AppException.ErrorType.UPLOAD, e.getMessage());
        }
    }

这个是单张图片上传,紧接着看多张图片上传,代码如下:

   /**
     * @param out
     * @param postContent
     * @param entities
     */
    public static void upload(OutputStream out, String postContent, ArrayList entities) throws AppException {
        String BOUNDARY = "7d4a6d158c9"; // 数据分隔线
        String PREFIX = "--", LINEND = "\r\n";
        String CHARSET = "UTF-8";
        DataOutputStream outStream = new DataOutputStream(out);
        try {
            StringBuilder sb = new StringBuilder();
            sb.append(PREFIX);
            sb.append(BOUNDARY);
            sb.append(LINEND);
            sb.append("Content-Disposition: form-data; name=\"" + "data" + "\"" + LINEND);
            sb.append("Content-Type: text/plain; charset=" + CHARSET + LINEND);
            sb.append("Content-Transfer-Encoding: 8bit" + LINEND);
            sb.append(LINEND);
//            post content
            sb.append(postContent);
            sb.append(LINEND);
            outStream.write(sb.toString().getBytes());
            int i = 0;
            for (FileEntity entity : entities) {
                StringBuilder sb1 = new StringBuilder();
                sb1.append(PREFIX);
                sb1.append(BOUNDARY);
                sb1.append(LINEND);
                sb1.append("Content-Disposition: form-data; name=\"file" + (i++) + "\"; filename=\"" + entity.getFileName() + "\""
                        + LINEND);
                sb1.append("Content-Type: " + entity.getFileType() + LINEND);
                sb1.append(LINEND);
                outStream.write(sb1.toString().getBytes());

                InputStream is = new FileInputStream(entity.getFilePath());
                byte[] buffer = new byte[1024];
                int len = 0;
                while ((len = is.read(buffer)) != -1) {

                    outStream.write(buffer, 0, len);
                }

                is.close();
                outStream.write(LINEND.getBytes());
            }
            byte[] end_data = (PREFIX + BOUNDARY + PREFIX + LINEND).getBytes();
            outStream.write(end_data);
            outStream.flush();
        } catch (Exception e) {
            throw new AppException(AppException.ErrorType.UPLOAD, e.getMessage());
        }
    }

通过对上面两段代码的比较,发现主区别在这个地方:

这里写图片描述

这个地方也是我们使用Retrofit上传的关键点所在,后面我们会再提到。

上面分析了这么多,我们来看看怎么使用retrofit来实现。

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

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

定义接口

在码小白的博客 Retrofit 2.0 超能实践,轻松实现多文件/图片上传 中有下面内容:

图片和字符串同时上报

@Multipart
@POST("upload/")
Call register(
                                   @Query("name") String cardName,
                                   @Query("phone") String callphone,
                                   @Query("address") String address,
                                   @Part("avatar\\"; filename=\\"avatar.jpg") RequestBody avatar,
                                   );

这种接口应该也是可以的,具体要怎么实现,都要与服务器接口保持一致,所以不能照搬照抄了。

根据对有心课堂提供的上传图片接口的大量抓包和测试总结,接口定义如下:

@Multipart
@POST("v1/public/core/?service=user.updateAvatar")
Observable>> uploadMultipleTypeFile(@Part("data") String des, @PartMap Map params);

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

准备图片

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

代码实现

这里就不贴代码了,截图如下(如果看不清,鼠标右键在新窗口打开就可以看到原图了):
Android Retrofit 实现文字(参数)和多张图片一起上传_第3张图片

关键代码在于:

bodyMap.put("file"+i+"\"; filename=\""+file.getName(), RequestBody.create(MediaType.parse("image/png"),file));

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

sb1.append("Content-Disposition: form-data; name=\"file" + (i++) + "\"; filename=\"" + entity.getFileName() + "\""
                        + LINEND);

只要将对应的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"这个一般是指(你希望)保存在服务器的文件名字。

举例说明

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

bodyMap.put("name=\"file"+i+"\"; filename=\""+file.getName()+"\"", RequestBody.create(MediaType.parse("image/png"),file));

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

Android Retrofit 实现文字(参数)和多张图片一起上传_第4张图片

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

{
    "ret": 403,
    "data": [],
    "msg": "\u975e\u6cd5\u8bf7\u6c42\uff1a\u6587\u4ef6\u4e0a\u4f20\u51fa\u9519"
}

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

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

Android Retrofit 实现文字(参数)和多张图片一起上传_第5张图片

关于文字类参数上传

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

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

代码托管地址:https://github.com/stay4it/st...

2016.8.19 凌晨

你可能感兴趣的:(Android Retrofit 实现文字(参数)和多张图片一起上传)