Content-Type 详解

Posted 2023-04-19

参考技术A

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

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

Content-Type：type/subtype ;parameter

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

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

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

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

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

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

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

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

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

服务端响应（Response）的Content-Type最好也保持准确，虽然一般web开发中，前端解析响应的数据不会根据Content-Type，并且服务端一般能自动设置准确的Content-Type，但是如果乱设置某些情况下可能会有问题，比如导出文件，打开图片等。如果在spring项目里使用@ResponseBody，spring会将响应的Content-Type设置为application/json;charset=UTF-8;，可能会导致文件无法导出，需要注意下。

response的Content-Type设置建议：

下面的一个设置response的Content-Type的例子：

参考
《HTTP 权威指南》
什么是json
常见的Content-Type
application/xml 和 text/xml的区别
postman里的Content-Type

详解get与post请求方式content-type与responseType@Requestbody与@Requestparam的使用场景

一. get与post请求方式

post：一般用来提交表单，请求数据被包装在body体中，是安全的；
get：一般用来获取数据信息，当然也可以用来获取表单，请求参数在url中，是不安全的；

---

二. content-type与responseType

1. content-type

contype-Type用来指定不同格式上传参数的请求信息（页面——>服务器）。

content-Type常用数据类型：

1. application/json：把它作为请求头，则传递的消息主体是序列化后的 JSON 字符串。格式如下图所示：
   

2. application/x-www-form-urlencoded：form表单默认的数据格式，提交的数据按照 key1=val1 & key2=val2 的方式进行编码，key 和 val 都进行了 URL 转码（ajax默认的Content-Type类型）。格式示例如下图所示：

2. responseType

responseType用来指定后台返回响应数据的类型（服务器——>页面）。

---

三. @Requestbody与@Requestparam

1. @RequestParam

@RequestParam接收的参数是来自requestHeader中，即请求头。通常用于GET请求，像POST、DELETE等其它类型的请求也可以使用。

2. @RequestBody

@RequestBody接收的参数是来自requestBody中，即请求体。一般用于处理非 Content-Type: application/x-www-form-urlencoded编码格式的数据，比如：application/json、application/xml等类型的数据。通常用于接收POST、DELETE等类型的请求数据，GET类型也可以适用。

注意点：

• 项目中要加入处理json字符串的依赖（jar包），如jackson
• @RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)，所以只能发送POST请求
• jQuery中，$.ajax()默认发送的参数类型及编码为：application/x-www-form-urlcoded，而@RequestBody处理的参数类型及编码为：aplication/json或者是application/xml，通过contentType属性来指定
• 在传递之前，对JSON对象要使用JSON.stringify()，JSON.stringify() 方法将一个 JavaScript 值(对象或者数组)转换为一个 JSON 字符串
• 一个请求，只有一个RequestBody