HTTP知多少——ContentType（内容类型）详解

HTTP知多少——Content-disposition（文件下载）
HTTP知多少——Content-Type（内容类型）详解

在Http请求中，我们每天都在使用Content-type来指定不同格式的请求信息。

链接：Postman资源下载。一款神器哟~
提取码：qmph

Content-type对照表

https://blog.csdn.net/wangjun5159/article/details/49644507

MediaType，即Internet Media Type，互联网媒体类型；也叫做MIME类型，在Http协议消息头中，使用Content-Type来表示具体请求中的媒体类型信息。

类型格式：type/subtype(;parameter)?type；
主类型：任意的字符串，如text，如果是*号代表所有；
subtype子类型：任意的字符串，如html，如果是*号代表所有；
parameter：（可选）一些参数，如Accept请求头的参数，Content-Type的charset参数。

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

（敲黑板，划重点）小伙伴们提出疑问，Content-Type和Accent有什么区别呢？

• Accept代表发送端（客户端）希望接受到的数据类型。比如：Accept：text/xml；代表客户端希望接受到的数据类型是xml。
• Content-type代表发送端（客户端|服务器）发送的实体的数据类型。比如：Content-Type：text/html；代表发送端发送的数据格式是html。
• 二者结合起来，request:Accept:text/xml;Content-Type:text/html，即代表希望接受到的数据类型是xml，本次请求发送的数据类型格式是html；

1.2 常见的媒体格式

• text/html：HTML格式
• text/plain：纯文本格式
• text/XML：XML格式
• image/gif：gif图片格式
• image/jped：jpg图片格式
• image/png：png图片格式

以application开头的媒体格式类型：

• application/xhtml+xml：XHTML格式
• application/xml：XML数据格式
• application/atom+xml：Atom XML聚合格式
• application/json：JSON数据格式【常用】
• application/pdf：pdf数据格式
• application/msword：Word文档格式
• application/octet-stream：二进制流格式（如常见的文件下载）
• application/x-www-form-urlencoded：中默认的encType，form表单数据编码为key/value格式发送到服务器（表单默认的提交数据格式）【常用】

另外一种常见的媒体格式是上传文件时使用的：【常用】

• multipart/form-data： [‘mʌlti:pɑ:t] 需要在表单进行文件上传时，就需要使用该格式。

1.2 SpringMVC中关于Content-Type类型的使用

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
    String name() default "";

    @AliasFor("path")
    String[] value() default {};

    @AliasFor("value")
    String[] path() default {};

    RequestMethod[] method() default {};
    String[] params() default {};
    String[] headers() default {};
    String[] consumes() default {};
    String[] produces() default {};
}

参数详情：

• value：指定请求的实际地址，比如/action/info之类。
• method：指定请求的method方法，GET、POST、PUT、DELETE、PATCH等。
• consumes：指定请求处理的提交内容类型（Content-Type），例如application/json，text/html；
• produces：指定返回的内容类型，仅当request请求头中的（Accept）类型包含该指定类型才返回。
• params：指定request中必须包含某些参数值，才让该方法处理请求。
• headers：指定request中必须包含某些指定的header值，才让该方法处理请求。

需要注意的是：consumes、produces使用content-type信息进行过滤信息；headers中使用content-type进行过滤和判断。

1.3 使用示例

1. headers的示例

//Referer表示http请求的来源
    @RequestMapping(value = "test/headers",method = RequestMethod.GET,
    headers = "Referer=http://www.baidu.com")
    public String testHeaders(){
        return "success";
    }

使用headers元素设置特定的请求头。http请求头中Referer的含义和作用

若不包含这个header则出现404的异常

2. params的示例

  @RequestMapping(value = "test/params",method = RequestMethod.GET,
            params = "myParam=myValue")
    public String testParams(){
        return "success";
    }

服务器仅理解请求中包含myParam，值为myValue的请求，起到一个过滤的作用。

若不包含时出现的异常

3. consumes的示例

consumes限定request中的Content-Type为application/json类型。即服务器只接受json格式！

    @RequestMapping(value = "test/consumes",method = RequestMethod.POST,
            cOnsumes= "application/json")
    public String testConsumes(String message){
        System.out.println("获取到的json："+message);
        return "success";
    }

consumes限定request的Content-Type

request修改headers后，返回成功

4. produces的示例

produces作用就是处理request请求中Accept头中包含application/json的请求，同时设置返回的Content-Type是application/json。

   @RequestMapping(value = "test/produces",method = RequestMethod.GET,
            produces = "application/json")
    public String testProduces(){
        return "success";
    }

produces设置返回的是json格式

1.5 Accept头的规则

我们在上面可以看到，Accept是客户端希望接受的格式，我们可以看到不仅一个格式，那么他们之间的区别是什么呢？

1. Accept:text/html;application/xml;application/json
   按照出现的顺序和produces进行匹配；
2. Accept：application/xml;q=0.5,application/json;q=0.9,text/html
   将按照如下顺序进行produces的匹配 ①text/html ②application/json ③application/xml参数为媒体类型的质量因子，越大则优先权越高(从0到1)
3. Accept：/,text/,text/html
   将按照如下顺序进行produces的匹配 ①text/html ②text/ ③/。即最明确的优先匹配。

参考文章：
Http请求中Content-Type讲解以及在Spring MVC注解中produce和consumes配置详解