Spring MVC（五）HttpMessageConverter和文件的上传与下载

HttpMessageConverter

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

HttpMessageConverter提供了两个注解和两个类型：

• @RequestBody
• @ResponseBody
• RequestEntity
• ResponseEntity

@RequestBody

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

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

    @RequestMapping(value = "/testRequestBody",method = RequestMethod.POST)
    public String testRequestBody(@RequestBody String requestBody){
        System.out.println(requestBody);
        return "newSuccess";
    }

输出结果：requestBody:username=admin&password=123456

RequestEntity

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

@RequestMapping(value = "/testRequestEntity",method = RequestMethod.POST)
public String testRequestEntity(RequestEntity<String> requestEntity) throws UnsupportedEncodingException {
    System.out.println(requestEntity.getHeaders());
    System.out.println(URLDecoder.decode(requestEntity.getBody(),"UTF-8"));
    return "newSuccess";
}

@ResponseBody

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

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

在方法前加上@ResponseBody注解，此时返回的字符串不会被视图解析器所解析，而是作为响应报文的响应体响应到浏览器。

Spring MVC处理json

@ResponseBody处理json的步骤：

引入Jaskson的依赖

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

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

<mvc:annotation-driven></mvc:annotation-driven>

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

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

@RequestMapping("/testResponseUser")
@ResponseBody
public User testResponseUser(){
    return new User(1001,"admin","123456","男","admin@168.com");
}

SpringMVC处理ajax

请求超链接

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

通过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">
        let app = 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>

控制器方法

    @RequestMapping("/testAxios")
    @ResponseBody
    public String testAxios(String username,String password){
        System.out.println("用户名：" + username + "密码：" + password);
        return "hello,axios";
    }

@RestController注解

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

ResponseEntity

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

文件的上传与下载

文件的下载

    @RequestMapping("/testDown")
    public ResponseEntity<byte[]> testResponseEntity(HttpSession session) throws
            IOException {
		//获取ServletContext对象
        ServletContext servletContext = session.getServletContext();

        //获取服务器中文件的真实路径
        String realPath = servletContext.getRealPath("/static/img/a.jpg");
        //创建输入流
        InputStream is = new FileInputStream(realPath);
        //创建字节数组
        byte[] bytes = new byte[is.available()];
        //将流读到字节数组中
        is.read(bytes);
        //创建HttpHeaders对象设置响应头信息
        MultiValueMap<String, String> headers = new HttpHeaders();
        //设置要下载方式以及下载文件的名字
        headers.add("Content-Disposition", "attachment;filename=a.jpg");
        //设置响应状态码
        HttpStatus statusCode = HttpStatus.OK;
        //创建ResponseEntity对象
        ResponseEntity<byte[]> responseEntity = new ResponseEntity<>(bytes, headers,
                statusCode);
        //关闭输入流
        is.close();
        return responseEntity;
    }

文件的上传

文件上传要求form表单的请求方式必须为post，并且添加属性enctype=“multipart/form-data”，SpringMVC中将上传的文件封装到MultipartFile对象中，通过此对象可以获取文件相关信息。

添加依赖

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.1</version>
</dependency>

在springMVC.xml文件中添加配置

<!--配置文件上传解析器，将上传的文件封装成MultipartFile-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"></bean>

控制器方法

    @PostMapping("/testUp")
    public String testUp(MultipartFile photo,HttpSession session) throws IOException {
        // 获取上传文件的文件名
        String filename = photo.getOriginalFilename();
        System.out.println(filename);
        // 处理文件重名问题
        String suffix = filename.substring(filename.lastIndexOf("."));
        filename = UUID.randomUUID().toString() + suffix;
        // 获取服务器中photo目录的路径
        ServletContext servletContext = session.getServletContext();
        String photoPath = servletContext.getRealPath("photo");
        File file = new File(photoPath);
        if (!file.exists()){
            file.mkdir();
        }
        String finalPath = photoPath + File.separator + filename;
        // 实现上传
        photo.transferTo(new File(finalPath));
        System.out.println(finalPath);
        return "newSuccess";
    }