content-type与responseType

Content-Type

Content-Type（MediaType），即是Internet Media Type，互联网媒体类型，也叫做MIME类型。在互联网中有成百上千中不同的数据类型，HTTP在传输数据对象时会为他们打上称为MIME的数据格式标签，用于区分数据类型。最初MIME是用于电子邮件系统的，后来HTTP也采用了这一方案。

在HTTP协议消息头中，使用Content-Type来表示请求和响应中的媒体类型信息。它用来告诉服务端如何处理请求的数据，以及告诉客户端（一般是浏览器）如何解析响应的数据，比如显示图片，解析并展示html等等。

Content-Type的格式：

Content-Type：type/subtype ;parameter

1. type：主类型，任意的字符串，如text，如果是*号代表所有；
2. subtype：子类型，任意的字符串，如html，如果是*号代表所有，用“/”与主类型隔开；
3. parameter：可选参数，如charset，boundary等。

例如：
Content-Type: text/html;
Content-Type: application/json;charset:utf-8;

常见Content-Type

常见的Content-Type有数百个，下面例举了一些

• HTML文档标记：text/html;
• 普通ASCII文档标记：text/html;
• JPEG图片标记：image/jpeg;
• GIF图片标记：image/gif;
• js文档标记：application/javascript;
• xml文件标记：application/xml;
  更多具体内容可参考《图解HTTP》- 附录D

上面的Content-Type，我们只认得就好，但是下面有4种是需要我们清楚他们的区别及牢记在心的。

application/x-www-form-urlencoded

HTTP会将请求参数用key1=val1&key2=val2的方式进行组织，并放到请求实体里面，注意如果是中文或特殊字符如"/"、","、“:" 等会自动进行URL转码。不支持文件，一般用于表单提交。
下面是一个例子：

• 请求参数

• http 请求报文

multipart/form-data

与application/x-www-form-urlencoded不同，这是一个多部分多媒体类型。首先生成了一个 boundary 用于分割不同的字段，在请求实体里每个参数以------boundary开始，然后是附加信息和参数名，然后是空行，最后是参数内容。多个参数将会有多个boundary块。如果参数是文件会有特别的文件域。最后以------boundary–为结束标识。multipart/form-data支持文件上传的格式，一般需要上传文件的表单则用该类型。
下面是一个例子：

• 请求参数

• http 请求报文

application/json

JSON 是一种轻量级的数据格式，以“键-值”对的方式组织的数据。这个使用这个类型，需要参数本身就是json格式的数据，参数会被直接放到请求实体里，不进行任何处理。服务端/客户端会按json格式解析数据（约定好的情况下）。

• 请求参数
• http 请求报文

application/xml 和 text/xml

与application/json类似，这里用的是xml格式的数据，text/xml的话，将忽略xml数据里的编码格式，

Content-Type的使用

request 的Content-Type

一般我们在开发的过程中需要注意客户端发送请求（Request）时的Content-Type设置，特别是使用ajax的时候，如果设置得不准确，很有可能导致请求失败。比如在spring中，如果接口使用了@RequestBody，spring强大的自动解析功能，会将请求实体的内容自动转换为Bean，但前提是请求的Content-Type必须设置为application/json，否正就会返回415错误。

注：415 错误是 Unsupported media type，即不支持的媒体类型。
建议：

1. 如果是一个restful接口（json格式），一般将Content-Type设置为application/json; charset=UTF-8；
2. 如果是文件上传，一般Content-Type设置为multipart/form-data
3. 如果普通表单提交，一般Content-Type设置为application/x-www-form-urlencoded

responseType

XMLHttpRequest 属性 responseType 是一个枚举字符串值，用于指定响应中包含的数据类型。

它还允许作者更改响应类型。如果将 responseType 的值设置为空字符串，则会使用 text 作为默认值。

var type = XMLHttpRequest.responseType;

XMLHttpRequest.responseType = type;

值

Global_Objects/String 类型的值，指定响应包含的数据类型。它可以采用以下值：

• ""

  空的 responseType 字符串与默认类型 "text" 相同。

• "arraybuffer"

  response 是一个包含二进制数据的 JavaScript ArrayBuffer。

• "blob"

  response 是一个包含二进制数据的 Blob 对象。

• "document"

  response 是一个 HTML Document 或 XML XMLDocument，根据接收到的数据的 MIME 类型而定。请参阅 XMLHttpRequest 中的 HTML，了解有关使用 XHR 获取 HTML 内容的更多信息。

• "json"

  response 是通过将接收到的数据内容解析为 JSON 而创建的 JavaScript 对象。

• "text"

  response 是 DOMString 对象中的文本。

• "ms-stream" 非标准

  response 是流式下载的一部分；此响应类型仅允许用于下载请求，并且仅受 Internet Explorer 支持。

备注：  将 responseType 设置为特定值时，作者应确保服务器实际发送的响应与该格式兼容。如果服务器返回的数据与设置的 responseType 不兼容，则 response 的值将为null .