Http协议中的数据传送之多重表单提交--multipart/form-data

RFC 2188: Returning Values from Forms: multipart/form-data,这份文件说明了在 HTTP POST 讯息中使用多种格式信息的作法,它可以用在许多 REST-based API 的系统,它可以混合多种资料格式并一次传送,当然非文字的资料必须要编码为二进制字符串。

在 RFC 2387 文件中,指出若要传输多种参数,多种资料型态混合的信息时,要先将 HTTP 要求的 Content-Type 设为 multipart/form-data,而且要设定一个 boundary 参数,这个参数是由应用程序自行产生,它会用来识别每一份资料的边界 (boundary),用以产生多重信息部份 (message part),而 HTTP 服务器可以抓取 HTTP POST 的信息,并且以惯用的对象模型来暴露给服务器读取 (ex: ASP.NET 的 Request.Form)。

下面是一个多重参数的 multipart/form-data 的讯息 (source: RFC 2388):

Content-Type: multipart/form-data; boundary=MYBOUNDARY
…
--MYBOUNDARY
Content-Disposition: form-data; name="[PARAMETER-NAME]"
<NEWLINE>
<NEWLINE>
<Data goes here>
--MYBOUNDARY
Content-Disposition: form-data; name="[PARAMETER-NAME]"
<NEWLINE>
<NEWLINE>
<Data goes here>
--MYBOUNDARY
Content-Disposition: form-data; name="[PARAMETER-NAME]"
Content-Type: image/jpeg
<NEWLINE>
<NEWLINE>
<Image data goes here>
--MYBOUNDARY

上面的信息看起来还蛮难懂的,不过它的几个基本概念是:

1. 每个信息部份都要用 --[BOUNDARY_NAME] 来包装,以分隔出信息的每个部份,而最后要再加上一个 --[BOUNDARY_NAME] 来表示结束。

2. 每个信息部份都要有一个 Content-Disposition: form-data; name="",而 name 设定的就是 HTTP POST 的键值 (key)。

3. 声明区和值区中间要隔两个新行符号 (以 .NET 来说,就是 Environment.NewLine)。

4. 中间可以夹入二进制资料,但二进制资料必须要格式化为二进制字符串,这个工作会由 HttpWebRequest 在使用 NetworkStream.Write() 写入上传资料时自动由系统去掉。

5. 若要设定不同信息段的资料型别 (Content-Type),则要在信息段内的声明区设定。

只要了解了资料格式,就能够写程序来生成它:

public static byte[] BuildMultipartPostData(string Boundary, Dictionary<string, string> HttpPostData, PostFileData FileUploadData)   
{    
    StringBuilder sb = new StringBuilder();
    // append access token.   
    sb.AppendLine("--" + Boundary);    
    sb.Append(Environment.NewLine);  
    // append form part.   
    if (HttpPostData != null && HttpPostData.Count > 0)    
    {    
        foreach (KeyValuePair<string, string> HttpPostDataItem in HttpPostData)    
        {    
            sb.AppendLine("--" + Boundary);    
            sb.AppendLine(string.Format("Content-Disposition: form-data;name=\"{0}\"", HttpPostDataItem.Key));    
            sb.Append(Environment.NewLine);    
            sb.AppendLine(HttpPostDataItem.Value);    
        }    
    }
    // handle file upload.   
    if (FileUploadData != null)    
    {    
        sb.AppendLine("--" + Boundary);    
        sb.AppendLine(string.Format("Content-Disposition: form-data;name=\"{0}\"; filename=\"{1}\"", FileUploadData.Name, FileUploadData.FileName));    
        sb.AppendLine(string.Format("Content-Type: {0}", FileUploadData.ContentType));    
        sb.Append(Environment.NewLine);    
    }
    MemoryStream ms = new MemoryStream();   
    BinaryWriter bw = new BinaryWriter(ms);    
    bw.Write(Encoding.Default.GetBytes(sb.ToString()));    
    bw.Write(FileUploadData.FileData);    
    bw.Write(Encoding.Default.GetBytes(Environment.NewLine));    
    bw.Write(Encoding.Default.GetBytes("--" + Boundary));    
    ms.Flush();    
    ms.Position = 0;
    byte[] result = ms.ToArray();
    bw.Close();
    return result;   
}

而实际发送的程序就无需特别的修改,但唯一要注意的是要加上 boundary 参数,否则多个信息部份的能力会无法使用。

public static string MakeHttpPost(string RequestUrl, Dictionary<string, string> HttpPostData, PostFileData FileUploadData)   
{    
    HttpWebRequest request = WebRequest.Create(RequestUrl) as HttpWebRequest;    
    HttpWebResponse response = null;
    StreamReader sr = null;   
    string boundary = "FBGraphAPIClient" + DateTime.Now.Ticks.ToString();
    try   
    {    
        request.Method = "POST";    
request.ContentType = "multipart/form-data; boundary=" + boundary;
        byte[] multipartPostData = Helpers.BuildMultipartPostData(boundary, HttpPostData, FileUploadData);
        BinaryWriter bw = new BinaryWriter(request.GetRequestStream());   
        bw.Write(multipartPostData);    
        bw.Close();
        response = request.GetResponse() as HttpWebResponse;
        sr = new StreamReader(response.GetResponseStream());   
        string responseData = sr.ReadToEnd();    
        sr.Close();
        response.Close();
        return responseData;   
    }    
    catch (WebException we)    
    {    
        throw new APIException((we.Response as HttpWebResponse));    
    }    
    catch (Exception)    
    {    
        throw;    
    }    
}

Reference:

1. RFC 2388

2、http://code.msdn.microsoft.com/ASPNET-Web-API-File-Upload-a8c0fb0d

3、http://stackoverflow.com/questions/12593001/web-api-model-binding-with-multipart-formdata

4、http://lonetechie.com/2012/09/23/web-api-generic-mediatypeformatter-for-file-upload/

5、http://www.cnblogs.com/hun_dan/archive/2012/04/09/2438709.html

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏一只程序汪的自我修养

ASP.NET MVC 微信JS-SDK认证

32130
来自专栏跟着阿笨一起玩NET

ASP.NET datable导出excel

本文转载:http://www.cnblogs.com/chwkai/archive/2005/10/08/250426.html

10820
来自专栏知识分享

51采集PCF8591数据通过ESP8266上传C#上位机android 之TCP客户端编程ESP8266使用详解NodeMCU初探ESP8266刷AT固件与nodemcu固件ESP8266使用详解-

这两天测试程序还发现一个bug就是如果客户端断开了,应该检测一下哪个断开了,数据就不应该发向那个连接,,,否则就会报错,然后模块会复位重启 所以加上这段代码 c...

63650
来自专栏向治洪

android-async-http框架源码分析

async-http使用地址 android-async-http仓库:git clone https://github.com/loopj/android...

24950
来自专栏菩提树下的杨过

Office Open XML学习(1)-创建excel文档,并向单元格中插入字符串

做企业级应用,跟office打交道是少不了的。这里的Office不仅仅局限于微软的Office,还有第三方的Open Office之类。.Net传统的Offic...

393100
来自专栏Ryan Miao

在PowerShell中使用curl(Invoke-WebRequest)

前言 习惯了windows的界面模式就很难转去命令行,甚至以命令行发家的git也涌现出各种界面tool。然而命令行真的会比界面快的多,如果你是一个码农。 sit...

55660
来自专栏老付的网络博客

多线程如何排队执行

有一个这样场景,程序会有一个非常耗时的操作,但要求耗时的操作完成后,再顺序的执行一个不耗时的操作,而且这个程序的调用,可能存在同时调用的情况。

24020
来自专栏一个爱瞎折腾的程序猿

mvc一对多模型表单的快速构建

Q:在实际的开发中,经常会遇到一个模型中包含有多个条目的表单。如何将数据提交到后台? A: 以数组的形式提交到后台就Ok了(真的那么简单么,如果再嵌套一层呢?...

32820
来自专栏码农阿宇

.Net Core中利用TPL(任务并行库)构建Pipeline处理Dataflow

在学习的过程中,看一些一线的技术文档很吃力,而且考虑到国内那些技术牛人英语都不差的,要向他们看齐,所以每天下班都在疯狂地背单词,博客有些日子没有更新了,见谅见谅...

28510
来自专栏Java架构师学习

Zookeeper-watcher机制源码分析(一)Watcher的基本流程

ZooKeeper 的 Watcher 机制,总的来说可以分为三个过程:客户端注册 Watcher、服务器处理 Watcher 和客户端回调 Watcher

12320

扫码关注云+社区

领取腾讯云代金券