HttpMessageConverter

HttpMessageConverter

HttpMessageConverter，报文信息转换器，将请求报文转换为Java对象，或将Java对象转换为响应报文。

HttpMessageConverter提供了两个注解和两个类型：@RequestBody，@ResponseBody，RequestEntity，ResponseEntity。

1、@RequestBody

@RequestBody可以获取请求体，需要在控制器方法设置一个形参，使用@RequestBody进行标识，当前请求的请求体就会为当前注解所标识的形参赋值。

在主页写一个表单来测试

<form th:action="@{/testRequestBody}" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="password" name="password"><br>
    <input type="submit">
</form>

controller方法

@RequestMapping("/testRequestBody")
public String testRequestBody(@RequestBody String requestBody){
    System.out.println("requestBody:"+requestBody);
    return "success";
}

运行后输出

requestBody:username=admin&password=111111

2、RequestEntity

RequestEntity是封装请求报文的一种类型，需要在控制器方法的形参中设置该类型的形参，当前请求的请求报文就会赋值给该形参，可以通过getHeaders()获取请求头信息，通过getBody()获取请求体信息

注意：请求报文包括请求头和请求体

@RequestMapping("/testRequestEntity")
public String testRequestEntity(RequestEntity<String> requestEntity){
    System.out.println("requestHeader:"+requestEntity.getHeaders());
    System.out.println("requestBody:"+requestEntity.getBody());
    return "success";
}

requestHeader:[host:“localhost:8080”, connection:“keep-alive”, content-length:“30”, cache-control:“max-age=0”, sec-ch-ua:“” Not A;Brand";v=“99”, “Chromium”;v=“101”, “Google Chrome”;v=“101"”, sec-ch-ua-mobile:“?0”, sec-ch-ua-platform:““Windows””, upgrade-insecure-requests:“1”, origin:“http://localhost:8080”, user-agent:“Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.67 Safari/537.36”, accept:“text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9”, sec-fetch-site:“same-origin”, sec-fetch-mode:“navigate”, sec-fetch-user:“?1”, sec-fetch-dest:“document”, referer:“http://localhost:8080/SpringMVC_demo4/”, accept-encoding:“gzip, deflate, br”, accept-language:“zh-CN,zh;q=0.9”, cookie:“Idea-1f0026ac=99af37a6-1d78-48ba-9006-968b5201f719”, Content-Type:“application/x-www-form-urlencoded;charset=UTF-8”]
requestBody:username=admin&password=111111

可以看到输出了这么长的请求头信息

3、@ResponseBody

@ResponseBody用于标识一个控制器方法，可以将该方法的返回值直接作为响应报文的响应体响应到浏览器

先看看原生ServletAPI怎么实现

@RequestMapping("/testResponse")
public void testResponse(HttpServletResponse response) throws IOException {
    response.getWriter().println("hello,response");
}

在SpringMVC中我们需要一个@ResponseBody注解也可以做到这个。

@ResponseBody
@RequestMapping("/testResponseBody")
public String testResponseBody() {
    return "hello,responsBody";
}

可以看到响应的是字符串，因为控制器方法中的返回值是字符串。那如果需要响应的是一个对象呢？

敲下试试，先来个User类

package springMVC.bean;

public class User {
    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private String sex;

    public User() {
    }

    public User(Integer id, String username, String password, Integer age, String sex) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
        this.sex = sex;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }
}

然后是控制器方法

@ResponseBody
@RequestMapping("/testResponseUser")
public User UsertestResponseBody() {
    return new User(1001,"admin","111111",15,"男");
}

可以看到报406了

这是我们就需要引入jackson的一个依赖，使项目在部署时自动将对象转换为json数组

4、SpringMVC处理json数据

@ResponseBody处理json的步骤：

导入jackson的依赖

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.2</version>
</dependency>

在SpringMVC的核心配置文件中开启mvc的注解驱动，此时在HandlerAdaptor中会自动装配一个消息转换器：MappingJackson2HttpMessageConverter，可以将响应到浏览器的Java对象转换为Json格式的字符串

<mvc:annotation-driven />

在处理器方法上使用@ResponseBody注解进行标识

此时将Java对象直接作为控制器方法的返回值返回，就会自动转换为Json格式的字符串

@RequestMapping("/testResponseUser")
@ResponseBody
public User UsertestResponseBody() {
    return new User(1001,"admin","111111",15,"男");
}

重新部署后可以看到浏览器不报406了，直接输出了一个json对象

{“id”:1001,“username”:“admin”,“password”:“111111”,“age”:15,“sex”:“男”}

5、SpringMVC处理ajax

@RequestMapping("testAxios")
@ResponseBody
public String testAxios(String username, String password){
    System.out.println(username+","+password);
    return "hello,axios";
}

<div id="app">
    <a @click="testAxios" th:href="@{/testAxios}">SpringMVC处理ajax</a>
</div>

<script type="text/javascript">
    const app = {
        methods:{
            testAxios:function (event) {
                axios({
                    method:'post',
                    url:'/testAxios',
                    data:{
                        username:"admin",
                        password:"123456"
                    }
                }).then(function (response) {
                    alert(response.data);
                });
                event.preventDefault();
            },
            mounted(){

            }
        }
    }
    Vue.createApp(app).mount("#app");
</script>

6、@RestController注解

@RestController注解是springMVC提供的一个复合注解，标识在控制器的类上，就相当于为类添加了@Controller注解，并且为其中的每个方法添加了@ResponseBody注解

7、ResponseEntity

ResponseEntity用于控制器方法的返回值类型，该控制器方法的返回值就是响应到浏览器的响应报文