来自 技术 2019-04-17 的文章

http Content-Type 知多少 - 潇湘待雨

前言

作为前端开发,工作中少不了与接口请求打交道。对于常见的content-type,也能说上来几个,感觉还算了解。直到有一天,我要在查看google的批量接口合并时发现Content-Type: multipart/mixed以及Content-Type: application/http时,有点措手不及。赶紧深入研究下Content-Type相关内容来弥补下自己的不足,从前端的角度来看看Content-Type。

Content-Type

Content-Type:实体头部用于指示资源的MIME类型。如果未指定 ContentType,默认为text/html有两种场景:在请求中 (如POST 或 PUT),客户端告诉服务器实际发送的数据类型。

在响应中,Content-Type标头告诉客户端实际返回的内容的内容类型。浏览器会在某些情况下进行MIME查找,并不一定遵循此标题的值; 为了防止这种行为,可以将标题 X-Content-Type-Options 设置为 nosniff。

简而言之就是标识资源或者所需资源的MIME类型。

句法如下:

Content-Type: text/html; charset=utf-8Content-Type: multipart/form-data; boundary=something

参数一般media-type、charset、boundary三种。我们的关注点在于media-type的取值以及其适用场景。

media-type

更多的是作为MIME type( Multipurpose Internet Mail Extensions)出现,即多用途Internet邮件扩展。其目的是用一种标准化的方式来标识文档的性质和格式。浏览器通常使用MIME类型(而不是文件扩展名)来确定如何处理文档;因此服务器设置正确以将正确的MIME类型附加到响应对象的头部是非常重要的。

结构

MIME 组成结构如下:由类型与子类型两个字符串中间用'/'分隔而组成。不允许空格存在。对大小写不敏感,但传统都是小写。允许额外参数,如后面所示:

type/subtype;parameter=value

其中:

type对应通用类目,例如:text/video等。subtype对应准确的子类,例如text下面细分为plain(纯文本)、html(html源码)、calendar(.ics)文件等。parameter可选一般是charset或者bundaary等。

Types

类目包括两种类型:独立类型和Multipart类型。

独立类型

独立类型指只代表一个单独的文件或者媒体的类型,表明了对文件的分类。常见类型和实例如下:

text文本数据包括一些人类可读的内容或者源码。例如:text/plain, text/csv, text/html.application数据为二进制的一种,例如application/octet-stream,application/pdf,application/pkcs8,application/zip.audio音频或者音乐数据,例如audio/mpeg, audio/vorbisvideo视频数据或者文件,例如video/mp4image图像或图形数据,包括位图和矢量静止图像以及静止图像格式的动画版本。例如image/gif, image/png, image/jpeg, image/bmp, image/webp, image/x-icon

Multipart类型

Multipart类型指明被分为几部分的一种文档的类目,且经常有不同的MIME类型。也可以用来表示属于相同事物的多个且独立的文件,这些独立的文件构成一个复杂的文档。在电子邮件场景中常见。有两种Multipart类型:message和multipart。

message一个包括其他信息的消息,常用于下面的场景,例如指明一个邮件包含转发信息或者在多种信息的情况下,允许以chunk的形式发送数据量很大的信息。包括message/rfc822和message/partialmultipart由多个不同MIME类型组件构成的数据,例如 multipart/form-data(使用FormData API生成的数据)

看完了基本定义,下面看看常见的类型及使用场景。

常见类型及使用场景

静态资源、图片、媒体类

对于静态资源、图片和媒体类,也就是text、image、video等比较清晰明了,不再详细描述。

application类

application/json

随着json这种轻量级的数据交互格式的流行,特别是和脚本交互的便利,使得在前后接口中,越来越多采用json格式。对于http协议来说,最终传输的还是字符。这里不再多进行描述。

application/x-www-form-urlencoded作为表单提交中默认的类型,其表明数据以标准的编码格式被编码为键值对。数据被编码成以 '&' 分隔的键-值对, 同时以 '=' 分隔键和值. 非字母或数字的字符会被 percent-encoding: 这也就是为什么这种类型不支持二进制数据的原因 (应使用 multipart/form-data 代替).我们以新浪为例,可以看到其请求报文(formdata那里选择,view source可以看得比较清楚):

multipart/form-data这里为了对比,就也放到这里来说了。一般用于涉及文件的表单提交,用于post请求,其格式如下:

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

其中boundary指明了请求体中每部分的分割符(对于multipart的类目,都会存在该字段,以区分请求体中数据的分割),其请求体中则是对应表单每部分的内容。每部分都会有自己的请求体和相关内容。例如如下的文档结构:

<form action="http://localhost:8000/" method="post" enctype="multipart/form-data"> <input type="text" name="myTextField"> <input type="checkbox" name="myCheckBox">Check</input> <input type="file" name="myFile"> <button>Send the file</button></form>

其请求信息如下:

POST / HTTP/1.1Host: localhost:8000User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:50.0) Gecko/20100101 Firefox/50.0Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8Accept-Language: en-US,en;q=0.5Accept-Encoding: gzip, deflateConnection: keep-aliveUpgrade-Insecure-Requests: 1// 以 ---------------------------8721656041911415653955004498 作为分割符Content-Type: multipart/form-data; boundary=---------------------------8721656041911415653955004498Content-Length: 465-----------------------------8721656041911415653955004498// 分段一 文本相关信息Content-Disposition: form-data; name="myTextField"// 对应valueTest-----------------------------8721656041911415653955004498// checkboxContent-Disposition: form-data; name="myCheckBox"on-----------------------------8721656041911415653955004498// 文件Content-Disposition: form-data; name="myFile"; filename="test.txt"Content-Type: text/plainSimple file.-----------------------------8721656041911415653955004498--

application/javascript application/x-javascript text/javascript对于js文件,常见MIME类型为text/javascript,但是前两种应该会有见到过。三者之间多少还是有点区别的。传统的js程序对应的MIME类型为text/javascript,其他的还有"application/x-javascript"(x前缀表示这是实验性类型), 因为text/javascript是最常见的类型,所以RFC4329定义了“text/javascript”。不过,js文件实际上并不是真正的文本类型,因此推出了application/javascript类型,不过现行的支持性并不好,所以常常会用application/x-javascript来代替。

application/zip application/gzipzip 对应zip压缩文件,gzip是若干种文件压缩程序的简称,通常指GNU计划的实现,此处的gzip代表GNU zip。

application/http这一种大家可能就不常见了,从类型可以知道,是http请求,但具体用途还是要翻下规范才能找到的。此类型包含的http请求包含在binary消息体中,在邮件协议传输中需要指明Content-Transfer-Encoding。在批量处理请求时会遇到,其表现如下:

--batch_0123456789Content-Type: application/httpContent-ID: // 必须的字段,表明传送内容的编码格式 即二进制流Content-Transfer-Encoding: binaryPOST https://www.googleapis.com/analytics/v3/management/accounts/XXXXXX/webproperties/UA-XXXXXX-1/customDimensionsContent-Type: application/jsonContent-Length: 68{ "name": "Campaign Group", "scope": "SESSION", "active": true}

multipart类型

正如上文所述,multipart一般对应单个消息头对应多个消息体。常见语法如下:

Content-Type: multipart/mixed; boundary=gc0p4Jq0M2Yt08jU534c0p

其中boundary字段是必须的,用于区分消息体中的数据边界,一般是两个'-'的格式作为该端的开头,例如:

--gc0p4Jq0M2Yt08jU534c0p

我们主要关注的也就是下面几种:

multipart/form-data见上面application部分。下面这几部分可能不是那么常见,不过还是可以了解一下,以免遇到的时候懵逼。

multipart/mixed该类型用于,消息体由多个独立的部分组成且想连续的展示。并且子数据类型有任一种无法被识别(此处指被浏览器直接识别的类型,例如text等)的类型时,都应该为mixed。概括而言就是该邮件有二进制内容,非可以直接识别的内容

例如:

POST /batch/farm/v1 HTTP/1.1Authorization: Bearer your_auth_tokenHost: www.googleapis.comContent-Type: multipart/mixed; boundary=batch_foobarbazContent-Length: total_content_length--batch_foobarbaz// 子内容为http请求 不过是boundary编码过的Content-Type: application/httpContent-ID: <item1:12930812@barnyard.example.com>GET /farm/v1/animals/pony--batch_foobarbazContent-Type: application/httpContent-ID: <item2:12930812@barnyard.example.com>PUT /farm/v1/animals/sheepContent-Type: application/jsonContent-Length: part_content_lengthIf-Match: "etag/sheep"{ "animalName": "sheep", "animalAge": "5" "peltColor": "green",}--batch_foobarbazContent-Type: application/httpContent-ID: <item3:12930812@barnyard.example.com>GET /farm/v1/animalsIf-None-Match: "etag/animals"--batch_foobarbaz--

这里消息体中的内容就是http请求,在google批量接口协议中用使用。

multipart/alternative该类型与mixed的语法相同,但语义不同。其表明,消息体中的不同部分应该是相同信息的不同版本。即内容相同传输类型不同,以适应不同的接受者。还是举例:

From: Nathaniel Borenstein <nsb@bellcore.com> To: Ned Freed <ned@innosoft.com> Subject: Formatted text mail MIME-Version: 1.0 Content-Type: multipart/alternative; boundary=boundary42 --boundary42 Content-Type: text/plain; charset=us-ascii ...plain text version of message goes here.... --boundary42 Content-Type: text/richtext .... richtext version of same message goes here ... --boundary42 Content-Type: text/x-whatever .... fanciest formatted version of same message goes here ... --boundary42--

假如用户的系统可以识别 text/x-whatever 类型,那么其将会只看到这一部分。不同的用户看到什么内容取决于其系统支持何种类型。

结束语

参考

https://developers.google.com/drive/api/v3/batch?hl=zh-cnhttps://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_typeshttps://www.w3.org/Protocols/rfc1341/7_2_Multipart.html

到这里常见的content-type就介绍完了,感谢以上参考文章,此外水平有限可能有错误之处欢迎指出。对于前端同学来说,网络请求也是我们需要关注的部分,提升深度的同时也要注意落款广度,希望对有需要的同学有所裨益。

标签:   aspnet多文件上传      云服务器绑定域名   
上一篇:没有了
下一篇:没有了