Content-Type与SpringMVC

阅读文本大概需要6分钟。

0x01：Content-Type介绍

在Http请求中，使用Content-Type来指定不同格式的请求信息，全面了解Content-Type中允许的值是什么，有时对开发非常有好处，这里将讲解Content-Type的可用值，以及在Spring MVC中如何使用它们来映射请求信息。

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

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

常见的媒体格式类型如下：

text/html ：HTML格式

text/plain ：纯文本格式

text/xml ： XML格式

image/gif ：gif图片格式

image/jpeg ：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 ：<form encType="">中默认的encType，form表单数据被编码为key/value格式发送到服务器（表单默认的提交数据的格式）

multipart/form-data ：需要在表单中进行文件上传时，就需要使用multipart/form-data 格式

以上就是在开发中经常会用到的Content-Type的内容格式。

0x02: Spring MVC中关于关于Content-Type类型信息的使用

首先看看RequestMapping的定义

@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: 指定请求的实际地址， 如 /user/details/info

method： 指定请求的method类型， 如GET、POST、PUT、DELETE等

consumes： 指定处理请求的提交内容类型（Content-Type），例如application/json、text/html等

produces: 指定返回的内容类型，仅当request请求头中的(Accept)类型中包含该指定类型才返回

params： 指定request中必须包含某些参数值是，才让该方法处理请求

headers： 指定request中必须包含某些指定的header值，才能让该方法处理请求

consumes和produces使用Content-Type进行过滤信息；headers中可以使用Content-Type进行过滤和判断。

例子：

    @Controller  
    @RequestMapping(value = "/addUser", 
        method = RequestMethod.POST, 
        consumes="application/json", 
        produces="application/json")  
    @ResponseBody
    public String addUser(@RequestBody User user) {      
        // TODO
        Map<String, String>  result = new HashMap<String, String>();
        result.put("errCode", "200");
        result.put("msg", "success");
        return result;
}

addUser方法仅处理request Content-Type为application/json类型的请求。produces标识处理request请求中Accept头中包含了application/json的请求；同时consumes暗示了返回的数据的类型为application/json。

常见的请求头包含哪些，最简单的方法就是，打开一个浏览器的开发者工具，然后请求一个页面，看看接口的请求。例如打开csdn的首页