SpringMVC学习笔记（九）—— HttpMessageConverter

09、HttpMessageConverter

• HttpMessageConverter，报文信息转换器，将请求报文转换为Java对象，或将Java对象转换为响应报文
• HttpMessageConverter提供了两个注解和两个类型：@RequestBody，@ResponseBody， RequestEntity， ResponseEntity

9.1、@RequestBody

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

【index.html】

<form th:action="@{/testRequestBody}" method="post">
    <input type="text" name="username">
    <input type="password" name="password">
    <input type="submit" value="测试@RequestBody">
</form>

【HttpController.java】

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

运行结果：requestBodyusername=admin&password=123456

9.2、RequestEntity

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

【index.html】

<form th:action="@{/testRequestBody}" method="post">
    <input type="text" name="username">
    <input type="password" name="password">
    <input type="submit" value="测试@RequestBody">
</form>

【HttpController.java】

@Controller
public class HttpController {

    @RequestMapping("/testRequestEntity")
    public String testRequestEntity(RequestEntity<String> requestEntity) {
        //当前requestEntity表示整个请求报文的信息
        System.out.println("请求头："+requestEntity.getHeaders());
        System.out.println("请求体："+requestEntity.getBody());
        return "success";
    }
}

运行结果：

请求头：[host:“localhost:8080”, connection:“keep-alive”, content-length:“30”, cache-control:“max-age=0”, sec-ch-ua:“”.Not/A)Brand";v=“99”, “Google Chrome”;v=“103”, “Chromium”;v=“103"”, 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/103.0.0.0 Safari/537.36”]
请求体：username=admin&password=123456

9.3、@ResponseBody

9.3.1、通过servletAPI的response对象响应浏览器数据

【index.html】

<a th:href="@{/testResponse}">通过servletAPI的response对象响应浏览器数据</a>

【HttpController.java】

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

运行结果：

9.3.2、通过@ResponseBody响应浏览器数据

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

【index.html】

<a th:href="@{/testResponseBody}">通过@ResponseBody响应浏览器数据</a>

【HttpController.java】

@Controller
public class HttpController {
	@RequestMapping("/testResponseBody")
    @ResponseBody
    public String testResponseBody() {
        return "success";
    }
}

运行结果：

• 在使用@ResponseBody的情况下：

  则显示ResponseBody返回的内容

• 在未使用@ResponseBody的情况下：

  则显示success.html页面的内容

9.4、SpringMVC处理json

1、@ResponseBody处理json的步骤：

• 导入jackson的依赖

【pom.xml】

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

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

	<!--开启mvc的注解驱动-->
    <mvc:annotation-driven>
        <mvc:message-converters>
            <!--处理响应中文内容乱码-->
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <property name="defaultCharset" value="UTF-8"/>
                <property name="supportedMediaTypes">
                    <list>
                        <value>text/html</value>
                        <value>application/json</value>
                    </list>
                </property>
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>

• 在处理器方法上使用@ResponseBody注解进行标识
• 将Java对象直接作为控制器方法的返回值返回，就会自动转换为Json格式的字符串

【HttpController.java】

@Controller
public class HttpController {
	@RequestMapping("/testResponseUser")
    @ResponseBody
    public User testResponseUser() {
        return new User(1001,"admin","123456",23,"男");
    }
}

2、运行结果：

浏览器的页面中展示结果为：

{"id":1001,"username":"admin","password":"123456","age":23,"sex":"男"}

​ 1001

​ admin

​ password

​ 23

​ 男

9.5、SpringMVC处理ajax

1、请求超链接

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

2、通过vue和axios处理点击事件

<script type="text/javascript" th:src="@{/static/js/vue.js}"></script>
<script type="text/javascript" th:src="@{/static/js/axios.min.js}"></script>
<script type="text/javascript">
    new Vue({
        el:"#app",
        methods:{
            testAxios:function (event) {
                axios({
                    method:"post",
                    url:event.target.href,
                    params:{
                        username:"admin",
                        password:"123456"
                    }
                }).then(function (response){
                    alert(response.data);
                });
                event.preventDefault();
            }
        }
    });
</script>

3、控制器方法

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

9.6、@RestController注解

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

9.7、ResponseEntity

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

• 可实现文件下载