2021-09-23 SpringMVC的请求和响应

SpringMVC的请求和响应

1 SpringMVC的数据响应

​ @ResponseBody 表示该方法返回值不作为页面跳转的地址, 作为响应数据

1.1 页面跳转

1. 直接返回字符串: 此种方式返回的字符串会与视图解析器配置的前后缀拼接后跳转

   视图解析器配置

    <!--
    配置内部资源视图解析器
    对controller返回字符串进行配置前后缀,例
    不配置:return "/jsp/success.jsp";
    配置后:return "success";
    -->
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
      <property name="prefix" value="/jsp/"/>
      <property name="suffix" value=".jsp"/>
</bean>-->

​ 测试

    /**
     * 页面跳转:
     * @return
     */
    //params = {"userName"} :表示请求参数必须有userName
    @RequestMapping(value = "/quick",method = RequestMethod.GET,params = {"userName"})
    public String save(){
        System.out.println("Controller save running...");
        //请求转发(不加前缀"../success.jsp"默认作为请求转发地址,且访问地址为相对于该类/user目录下的资源 )
//        return "/html/success.jsp";
        //重定向
//        return "redirect:../success.jsp";
        //与prefix和suffix拼接后返回
        return "success";
    }
    /**
    * 页面跳转:
    * 使用域对象(不常用)
    * @return
    */
    @RequestMapping(value = "request")
    public String request(HttpServletRequest request){
       System.out.println("注入request域对象");
       request.setAttribute("userName","raphus");
       return "index";
    }

2. 通过ModelAndView对象返回

   /**
    * 页面跳转:
    * 模型与视图:使用方式 1
    * @return
    */
    @RequestMapping(value = "modelAndView")
    public ModelAndView model(){
       System.out.println("返回模型与视图(new)");
       ModelAndView modelAndView = new ModelAndView();
       //设置视图名称 效果同上 return "success";
       modelAndView.setViewName("index");
       //设置模型数据
       modelAndView.addObject("userName","raphuscucullatus");
       return modelAndView;
    }
    /**
    * 页面跳转:
    * 模型与视图:使用方式 2
    * @return
    */
    @RequestMapping(value = "modelAndViewParam")
    public ModelAndView modelAndView(ModelAndView modelAndView){
       System.out.println("返回模型与视图(形参)");
       modelAndView.setViewName("index");
       modelAndView.addObject("userName","raphuscucullatus");
       return modelAndView;
    }

   /**
    * 页面跳转:
    * 模型
    * @return
    */
    @RequestMapping(value = "model")
    public String model(Model model){
       System.out.println("设置模型:");
       model.addAttribute("userName","raphuscucullatus");
       return "index";
    }

1.2 回写数据

1. 直接返回字符串

/**
     * 回写数据:
     * response
     * @param response
     * @return
     */
    @RequestMapping(value = "response")
    public void response(HttpServletResponse response){
        System.out.println("注入request域对象");
        try {
            response.getWriter().print("hello springmvc");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    /**
     * 回写数据:
     * 注解
     * @param
     * @return
     */
    @RequestMapping(value = "annotation")
    @ResponseBody//表示该方法返回的字符串作为响应数据
    public String annotation(){
        return "welcome raphuscucullatus";
    }
    /**
     * 回写数据:
     * 注解+json
     * @param
     * @return
     */
    @RequestMapping(value = "json")
    @ResponseBody//表示该方法返回的字符串作为响应数据
    public String json(){
        User user = new User();
        user.setAge(18);
        user.setName("zhangSan");
        ObjectMapper objectMapper = new ObjectMapper();
        String userJson = null;
        try {
            userJson = objectMapper.writeValueAsString(user);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
        System.out.println(userJson);
        return userJson;
    }
 

2. 返回对象或集合**(集合/对象–>json)**

   需要配置请求映射处理适配器(springmvc.xml)

    
<!--配置方式1-->
	<!--
    配置请求映射处理适配器
    将controller返回的类获集合转化为json
    -->
    <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
        <property name="messageConverters">
            <list>
                <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
            </list>
        </property>
    </bean>
<!--配置方式2(需要mvc命名空间)-->
    <!--    mvc的注解驱动    -->
    <mvc:annotation-driven/>

配置后,mvc会将users对象/userList转化为json后再响应给网页

  /**
     * 回写数据:
     * 注解+json
     * @param
     * @return 对象或者集合
     */
    @RequestMapping(value = "user2json")
    @ResponseBody//表示该方法返回值作为响应数据
    public List<User> user2json(){
        User user = new User();
        user.setAge(18);
        user.setName("zhangSan");
        List<User> users = new ArrayList<>();
        users.add(user);
        users.add(user);
        return users;
    }
}

2 SpringMVC获取的请求数据

2.1 获得请求参数

@RequestBody 将请求体封装到指定按参数

客户端请求参数的格式是： name=value&name=value… …
服务器端要获得请求的参数，有时还需要进行数据的封装， SpringMVC可以接收如下类型的参数：

基本类型参数
数组类型参数
POJO类型参数

    /**
     * 获得请求参数:
     * @param
     * @return 
     */
    @RequestMapping(value = "getParam")
    @ResponseBody
    public void getParam(String userName,int age){
        System.out.println("userName:"+userName+",age:"+age);
    }
    /**
     * 获得请求参数:数组
     * @param
     * @return 
     */
    @RequestMapping(value = "getArray")
    @ResponseBody
    public void getArray(int[] ints){
        System.out.println("ints:"+ Arrays.toString(ints));
    }
    /**
     * 获得请求参数:pojo类型
     * @param
     * @return 
     */
    @RequestMapping(value = "getPojo")
    @ResponseBody
    public void getPojo(User zhangSan){
        System.out.println("zhangSan:"+zhangSan);
    }

集合类型参数 (form–>集合)

/**
 * 获得请求参数:Collection_List
 * @param
 * @return
 */
@RequestMapping(value = "getList")
@ResponseBody
public void getList(UserListVO userListVO){
    System.out.println("userListVO:"+userListVO);
}

VO and pojo

package com.raphuscucullatus.domain;
//vo
import java.util.List;
/**
 * @author raphus cucullatus
 * @version 2021/9/22 5:55
 * @since JDK8
 */
public class UserListVO {
    private List<User> userListVO;

    public List<User> getUserListVO() {
        return userListVO;
    }

    public void setUserListVO(List<User> userListVO) {
        this.userListVO = userListVO;
    }

    @Override
    public String toString() {
        return "UserListVO{" +
                "userListVO=" + userListVO +
                '}';
    }
}
package com.raphuscucullatus.domain;
//pojo
import java.io.Serializable;
/**
 * 用户实体
 * @author raphus cucullatus
 * @version 2021/9/17 22:20
 * @since JDK8
 */
public class User implements Serializable {
    /**
     * 用户名
     */
    private String name;
    /**
     * 用户的年龄
     */
    private int age;

    public String getName() {
        return name;
    }
    public int getAge() {
        return age;
    }
    public void setName(String name) {
        this.name = name;
    }
    public void setAge(int age) {
        this.age = age;
    }
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

jsp

<%--
  Created by IntelliJ IDEA.
  User: pw
  Date: 2021/9/22
  Time: 5:57
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/user/getCollection" method="post">
    <input type="text" name="userListVO[0].name"><br/>
    <input type="text" name="userListVO[0].age"><br/>
    <input type="text" name="userListVO[1].name"><br/>
    <input type="text" name="userListVO[1].age"><br/>
    <input type="submit" value="提交">
</form>
</body>
</html>

获取集合类型参数 (Json–>集合)

/**
 * 获得请求参数:Collection_List from json
 * @param
 * @return
 */
@RequestMapping(value = "getFromJson")
@ResponseBody
			//@RequestBody  将请求体的信息封装到 userList				
public void getCollection(@RequestBody List<User> userList)throws IOException{
    System.out.println("userList:"+userList);

}

pojo

//pojo
import java.io.Serializable;
/**
 * 用户实体
 * @author raphus cucullatus
 * @version 2021/9/17 22:20
 * @since JDK8
 */
public class User implements Serializable {
    /**
     * 用户名
     */
    private String name;
    /**
     * 用户的年龄
     */
    private int age;

    public String getName() {
        return name;
    }
    public int getAge() {
        return age;
    }
    public void setName(String name) {
        this.name = name;
    }
    public void setAge(int age) {
        this.age = age;
    }
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

jsp(需要引入JQuery)

<%--
  Created by IntelliJ IDEA.
  User: pw
  Date: 2021/9/22
  Time: 6:15
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
    <script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
    <script>
        let userList = new Array()
        userList.push({name:"erGou",age:18});
        userList.push({name:"tieDan",age:19});
        console.log(userList);
        $.ajax({
            type:"POST",
            url:"${pageContext.request.contextPath}/user/getFromJson",
            data:JSON.stringify(userList),
            contentType:"application/json;charset=utf-8"
        });

    </script>
</head>
<body>
<h1>ajax</h1>

</body>
</html>

mvc配置文件

注意：通过谷歌开发者工具抓包发现，没有加载到jquery文件，原因是SpringMVC的前端控制器
DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作，我们可以通过以下两种
方式指定放行静态资源：

    <!--
配置方式1
      开放访问权限
      mapping 资源路径
      location 对springmvc开放权限的路径
    -->
    <mvc:resources mapping="/js/**" location="/js/"/>

    <!--
配置方式2
        将访问资源交给(Tomcat容器)来做
    -->
    <mvc:default-servlet-handler/>

2.2配置全局乱码过滤器

web.xml

<!--
    配置全局过滤器
-->
<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

2.3 参数绑定注解

@RequestParam注解

用于对 页面参数名与Controller参数名不一致时 进行绑定

    /**
     * 获得请求参数:
     * @param
     * @return
     */
    @RequestMapping(value = "getParam")
    @ResponseBody
    /*
    @RequestParam 参数绑定注解
    value="name" 绑定name参数
    required=false 是否为必须的(默认true)
    defaultValue="狗蛋" (name参数默认值为狗蛋)
    */
    public void getParam(@RequestParam(value="name",required=false,defaultValue="狗蛋") String userName, int age){
        System.out.println("userName:"+userName+",age:"+age);
    }

2.4 获取Restful风格的参数

使用@PathVariable(“userName”)**注解

Restful是一种软件架构风格、 设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务
器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式” 表示一次请求目的的， HTTP 协议里面四个表示操作方式的动词如下：
GET：用于获取资源 /user/1 GET ： 得到 id = 1 的 user
POST：用于新建资源 /user/1 DELETE： 删除 id = 1 的 user
PUT：用于更新资源 /user/1 PUT： 更新 id = 1 的 user
DELETE：用于删除资源 /user POST： 新增 user

/**
 * 获取Restful风格的参数
 *  @PathVariable("userName")
 *  http://localhost:8080/user/getRestful/张三
 *  非restful风格
 *  http://localhost:8080/user/getRestful?userName=张三
 *
 * @param
 * @return
 */
@RequestMapping(value = "getRestful/{userName}")
@ResponseBody
public void getRestfull(@PathVariable("userName") String userName)throws IOException{
    System.out.println("userName:"+userName);
}

2.5 自定义类型转换器

• SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。
• 但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自
定义转换器。
自定义类型转换器的开发步骤：
① 定义转换器类实现Converter接口
② 在配置文件中声明转换器
③ 在****中引用转换器

**① 定义转换器类实现Converter接口

package com.raphuscucullatus.converter;

import com.fasterxml.jackson.databind.JavaType;
import com.fasterxml.jackson.databind.type.TypeFactory;
import org.springframework.core.convert.converter.Converter;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

/**
 * 自定义日期类型装换器
 *
 * @author raphus cucullatus
 * @version 2021/9/22 21:52
 * @since JDK8
 */
public class DateConverter implements Converter<String, Date> {
    /**
     * 将日期字符串转为日期对象
     * @param s
     * @return
     */
    @Override
    public Date convert(String s) {
        SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        Date date = null;
        try {
            date = format.parse(s);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }

}

② 在配置文件中声明转换器,并 在**mvc:annotation-driven/中引用**转换器

<!--
    mvc的注解驱动(包含配置请求映射处理适配器)
-->
<mvc:annotation-driven conversion-service="CustomConversionService"/>


<!--  声明转换器  -->
<bean id="CustomConversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <list>
            <bean class="com.raphuscucullatus.converter.DateConverter"></bean>
        </list>
    </property>
</bean>

2.6 获得Servlet相关API

SpringMVC支持使用原始ServletAPI对象作为控制器方法的参数进行注入，常用的对象如下：
HttpServletRequest
HttpServletResponse
HttpSession

/**
 * 注入HttpServletResponse,并响应数据
 * response
 * @param response
 * @return
 */
@RequestMapping(value = "response")
public void response(HttpServletResponse response){
    System.out.println("注入request域对象");
    try {
        response.getWriter().print("hello springmvc");
    } catch (IOException e) {
        e.printStackTrace();
    }
}

2.7 获得请求头

使用**@RequestHeader**注解

使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name)
@RequestHeader注解的属性如下：
value：请求头的名称
required：是否必须携带此请求头

    /**
     * 获取请求头参数
     * 方法形参是Map<String, String> 、 MultiValueMap<String, String>
     *  或HttpHeaders则映射将填充所有标头名称和值。
     * @param
     * @return
     */
    @RequestMapping(value = "getRequestHeader")
    @ResponseBody
//    public void getRequestHeader(@RequestHeader("Cookie") String header)throws IOException{
//        System.out.println("header:"+header);
//    }
    public void getRequestHeader(@RequestHeader("Cookie")Map<String, String> map)throws IOException{
        System.out.println("header:"+map);
    }

使用@CookieValue可以获得指定Cookie的值
@CookieValue注解的属性如下：
value：指定cookie的名称
required：是否必须携带此cookie

/**
 * 获取请求头参数
 * 方法形参是Map<String, String> 、 MultiValueMap<String, String>
 *  或HttpHeaders则映射将填充所有标头名称和值。
 * @param
 * @return
 */
@RequestMapping(value = "getCookie")
@ResponseBody
public void getCookie(@CookieValue("Idea-f409d145") String cookie)throws IOException{
    System.out.println("header:"+cookie);
}

2.8 文件上传

1 文件上传客户端三要素

action属性 决定了往哪个服务器路径提交数据

method属性 决定提交数据方式, get或post

enctype属性 决定采用什么数据类型(数据格式)提交,如下图:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

2 单文件上传步骤

​ ① 导入fileupload和io坐标

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

② 配置文件上传解析器(spring-mvc.xml)	

<!--  配置上传文件解析器  -->
<bean id="multipartResolver"
      class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <property name="defaultEncoding" value="UTF-8"></property>
    <property name="maxUploadSize" value="5242800"></property>
    <property name="maxUploadSizePerFile" value="5242800"></property>
</bean>

​ ③ 编写文件上传代码

网页

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>上传文件</title>
</head>
<body>
<form action="../user/upload" method="post" enctype="multipart/form-data">
    名称<input type="text" name="name"><br/>
    文件<input type="file" name="img"><br/>
    <input type="submit" value="提交">
</form>

<script></script>
</body>
</html>

controller

/**
 * 上传文件
 * @param name, img 为上传表单的name属性值
 * @return
 */
@RequestMapping(value = "upload")
@ResponseBody
public void upload(String name, MultipartFile img)throws IOException{
    System.out.println("上传文件 "+name+":"+img);
    //获取上传文件名
    String originalFilename = img.getOriginalFilename();
    img.transferTo(new File("D:\\"+originalFilename));
    System.out.println(originalFilename+"文件已保存");
}

3 多个文件上传步骤

​ ① 导入fileupload和io坐标

​ ② 配置文件上传解析器(spring-mvc.xml)

​ ③ 编写文件上传代码

controller

/**
 * 上传多个文件
 * @param name 为上传表单的name属性值
 * @param imgs 为上传表单的name属性值
 * @throws IOException
 */
@RequestMapping(value = "uploads")
@ResponseBody
public void uploads(String name, MultipartFile[] imgs)throws IOException{
    System.out.println("上传文件 "+name);
    for (MultipartFile img : imgs) {
        String originalFilename = img.getOriginalFilename();
        img.transferTo(new File("D:\\img\\"+originalFilename));
        System.out.println(originalFilename+"文件已保存");
    }

}

html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>上传文件</title>
</head>
<body>
<form action="../user/uploads" method="post" enctype="multipart/form-data">
    名称<input type="text" name="name"><br/>
    头像<input type="file" name="imgs"><br/>
    证件照<input type="file" name="imgs"><br/>
    高清正面<input type="file" name="imgs"><br/>
    高清背面<input type="file" name="imgs"><br/>
    <input type="submit" value="提交">
</form>

<script></script>
</body>
</html>