SpringMVC03 —— SpringMVC的请求和响应

往期文章

Spring01 —— Spring概念及快速入门
Spring02 —— Spring配置文件详解和依赖注入
Spring03 —— SpringAPI和在Spring中配置数据源
Spring04 —— Spring的注解开发
Spring05 —— Spring集成Junit
Spring06 —— Spring集成web环境
SpringMVC01 —— SpringMVC简介&快速入门
SpringMVC02 —— SpringMVC的各组件详解

---

---

SpringMVC的请求和响应

一、SpringMVC的数据响应

响应方式分为两种方式：

1、 页面跳转

​   直接返回字符串

​   通过ModelAndView对象返回

2、 回写数据

​   直接返回字符串

​   返回对象或集合

1.1、页面跳转

1.1.1、页面跳转——返回字符串形式

1.1.2、页面跳转——返回ModelAndView形式1

@RequestMapping("/quick2")
public ModelAndView save2(){

    /*
    * Model : 模型 封装数据
    * View：视图 展示数据
    * */
    ModelAndView modelAndView = new ModelAndView();

    // 设置模型数据
    modelAndView.addObject("username","zhangwuji");

    // 设置视图名称
    modelAndView.setViewName("success");

    return modelAndView;
}

修改success.jsp文件

运行项目：

1.1.3、页面跳转——返回ModelAndView形式2

在Controller中方法形参上直接声明ModelAndView，无需在方法中自己创建，在方法中直接使用该对象设置 视图，同样可以跳转页面

@RequestMapping("/quick3")
public ModelAndView save3(ModelAndView modelAndView){
    modelAndView.addObject("username","张无忌");
    modelAndView.setViewName("success");

    return modelAndView;
}

SpringMVC对方法的参数可以进行相应的注入，当解析该方法时发现需要一个ModelAndView 那么SpringMVC就会提供一个ModelAndView

还可以只设置模型model 返回字符串

@RequestMapping("/quick4")
public String save4(Model model){
    // 设置模型
    model.addAttribute("username","戴尔");
    // 返回逻辑视图名称
    return "success";
}

1.1.4、页面跳转——返回ModelAndView形式3

在Controller方法的形参上可以直接使用原生的HttpServeltRequest对象，只需声明即可

@RequestMapping("/quick5")
public String save4(HttpServletRequest request){
    request.setAttribute("username","赵敏");
    // 返回逻辑视图名称
    return "success";
}

1.2、回写数据

1.2.1、回写数据——直接回写字符串

1、通过SpringMVC框架注入的response对象，使用response.getWriter().print(“hello world”) 回写数据，此时不 需要视图跳转，业务方法返回值为void

2、将需要回写的字符串直接返回，但此时需要通过@ResponseBody注解告知SpringMVC框架，方法返回的字符 串不是跳转是直接在http响应体中返回

@RequestMapping("/quick6")
public void save6(HttpServletResponse response) throws IOException {
    response.setContentType("text/html;charset=utf-8");
    response.getWriter().write("你好！");
}

@RequestMapping("/quick7")
@ResponseBody  // 使用该注解 告知Spring框架直接返回字符串
public String save7() {
    return "hello world!";
}

1.2.2、回写数据——直接回写json数据

@RequestMapping(value = "/quick8")
@ResponseBody
public String save8() {
    return "{\"username\":\"zhangsan\",\"age\":18}";  // 里面的引号需要进行转义
}

手动拼接json格式字符串的方式很麻烦，开发中往往要将复杂的java对象转换成json格式的字符串，我们可以 使用web阶段学习过的json转换工具jackson进行转换,通过jackson转换json格式字符串，回写字符串

导入jackson相关坐标

<dependency>
    <groupId>com.fasterxml.jackson.coregroupId>
    <artifactId>jackson-coreartifactId>
    <version>2.9.0version>
dependency>
<dependency>
    <groupId>com.fasterxml.jackson.coregroupId>
    <artifactId>jackson-databindartifactId>
    <version>2.9.0version>
dependency>
<dependency>
    <groupId>com.fasterxml.jackson.coregroupId>
    <artifactId>jackson-annotationsartifactId>
    <version>2.9.0version>
dependency>

@RequestMapping(value = "/quick9")
@ResponseBody
public String save9() throws IOException {
    User user = new User("张三",20,"东莞");
    // 使用json转换工具将对象转换为json字符串
    ObjectMapper mapper = new ObjectMapper();
    String json = mapper.writeValueAsString(user);

    return json;
}

测试：

上述每个对象都要自己转成json 造成代码重复太多 ，那么SpringMVC框架就提供了帮我们转json字符串的功能，但是需要我们进行相关配置

1.2.3、回写数据——返回对象或集合

    @RequestMapping(value = "/quick10")
    @ResponseBody
    // 期望SpringMVC框架自动将user对象转换为json格式字符串并返回
    public User save10() {
        User user = new User("zhansan",20,"newyork");

        return user;
    }

通过SpringMVC帮助我们对对象或集合进行json字符串的转换并回写，为处理器适配器配置消息转换参数，指 定使用jackson进行对象或集合的转换，因此需要在spring-mvc.xml中进行如下配置：

配置处理器适配器：

<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>

测试：

在方法上添加@ResponseBody就可以返回json格式的字符串，但是这样配置比较麻烦，配置的代码比较多， 因此，我们可以使用mvc的注解驱动代替上述配置

在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件

使用 自动加载 RequestMappingHandlerMapping（处理映射器）和

RequestMappingHandlerAdapter（ 处 理 适 配 器 ），可用在Spring-xml.xml配置文件中使用

替代注解处理器和适配器的配置。

同时使用 默认底层就会集成jackson进行对象或集合的json格式字符串的转换

所以我们只需要在spring-mvc.xml文件中配置SpringMVC的注解驱动·即可

首先引入mvc的命名空间和约束路径：

<mvc:annotation-driven />

测试：

1.3、知识小结

1） 页面跳转

  直接返回字符串

  通过ModelAndView对象返回

2） 回写数据

  直接返回字符串

HttpServletResponse 对象直接写回数据，HttpServletRequest对象带回数据，Model对象带回数据或者
@ResponseBody将字符串数据写回

  返回对象或集合

@ResponseBody+

二、SpringMVC的请求

请求参数的类型有哪些：

客户端请求参数的格式是：name=value&name=value……

服务器端要获得请求的参数，有时还需要进行数据的封装

SpringMVC可以接受的参数类型：

• 基本类型参数
• POJO类型参数 (实体bean)
• 数组类型参数
• 集合类型参数

2.1、获得请求参数

2.1.1、获得基本类型参数

Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。并且能自动做类型 转换；

自动的类型转换是指从String向其他类型的转换

@Controller
@RequestMapping("/person")
public class PersonController {


    @RequestMapping("/p1")
    @ResponseBody // 表示不进行页面跳转 回写的数据为空
    public void test1(String username,int age){
        System.out.println(username);
        System.out.println(age); // SpringMVC框架会自动将获取到的string类型的age转换为int类型的age
    }
}

访问路径 携带参数：http://localhost:8080/spring_mvc/person/p1?username=zhangsan&age=20

观察控制台打印：

2.1.2、获得POJO类型参数

客户端发送的数据到达服务端之后，SpringMVC要将这些参数封装到一个实体当中。原先我们要将请求参数封装到实体当中是怎样做的？通过getParamterMap获取参数map集合，然后通过beanUtils进行实体封装。

但是这些操作在SpringMVC框架中都已经进行了封装，我们只需要保证：

Controller中的业务方法的POJO参数的属性名与请求参数的name一致，参数值会自动映射匹配。

首先创建一个实体类Person

public class Person {
    private String name;
    private int age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

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

@RequestMapping("/p2")
@ResponseBody
public void test2(Person person){
    System.out.println(person);
}

测试: 携带参数?name=xxx&age=xx

2.1.3、获得数组类型的参数

Controller中的业务方法数组名称与请求参数的name一致，参数值会自动映射匹配。

@RequestMapping("/p3")
@ResponseBody
public void test3(String[] strs){
    // 数组默认打印的是地址 所以我们需要将数组转为list集合进行打印
    System.out.println(Arrays.asList(strs));
}

访问需要携带参数 且参数名都叫strs
http://localhost:8080/spring_mvc/person/p3?strs=a&strs=b&strs=c

2.1.4、获得集合类型参数1

获得集合参数时，要将集合参数包装到一个POJO中才可以。

所以需要先创建一个实体VO

public class VO {
    private List<Person> personList;

    public List<Person> getPersonList() {
        return personList;
    }

    public void setPersonList(List<Person> personList) {
        this.personList = personList;
    }

    @Override
    public String toString() {
        return "VO{" +
                "personList=" + personList +
                '}';
    }
}

后端代码：

@RequestMapping(value = "/p4")
@ResponseBody
public void test4(VO vo){
    System.out.println(vo);
}

前端代码：

<%--
  User: it春和
  Date: 2022/4/2 19:21
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    



    <%--  表名第一个Person对象的name age  --%>
    

    

    

    

    

2.1.5、获得集合类型参数2

当使用ajax提交时，可以指定contentType为json形式，那么在方法参数位置使用@RequestBody可以直接接 收集合数据而无需使用POJO进行包装

前端代码：

引入jquery

<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    
    
    



    点击发送请求

后端代码：

@RequestMapping("/p5")
@ResponseBody
public void test5(@RequestBody List<Person> personList){
    System.out.println(personList);
}

这里可能会报错 jquery文件不能获取需要放行静态资源

在spring-mvc.xml文件中指定资源进行放行

重新部署项目进行测试:

2.1.6、静态资源访问的开启

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

解决方法：

1、在spring-mvc.xml配置文件中指定放行的资源

2、使用 标签

2.1.7、配置全局乱码过滤器

当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。

配置全局的filter CharacterEncodingFilter

<filter>
    <filter-name>characterEncodingFilterfilter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
    <init-param>
        <param-name>encodingparam-name>
        <param-value>utf-8param-value>
    init-param>
filter>
<filter-mapping>
    <filter-name>characterEncodingFilterfilter-name>
    <url-pattern>/*url-pattern>
filter-mapping>

配置全局乱码过滤器之前：

访问form.jsp

配置全局乱码过滤器：

2.1.8、参数绑定注解@RequestParam

当请求的参数名称与Controller的业务方法参数名称不一致时，就需要通过@RequestParam注解显示的绑定

后端代码：

@RequestMapping("/p6")
@ResponseBody
public void test6(@RequestParam(value = "name",required = false,defaultValue = "张三") String username){
    System.out.println(username);
}

@RequestParam注解的三个属性：

1、value 参数绑定

2、required 默认值为true 表示是否必须要携带该参数

3、defaultValue 默认值，当设置了默认值那么required就会失效

2.1.9、Restful风格参数的获取

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

GET：用于获取资源

POST：用于新建资源

PUT：用于更新资源

DELETE：用于删除资源

例如：

/user/1 GET ： 得到 id = 1 的 user

/user/1 DELETE： 删除 id = 1 的 user

/user/1 PUT： 更新 id = 1 的 user

/user POST： 新增 user

上述url地址/user/1中的1就是要获得的请求参数，在SpringMVC中可以使用占位符进行参数绑定。地 址/user/1可以写成/user/{id}，占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行 占位符的匹配获取工作。

后端代码：

// localhost:8080/person/zhangwuji
@RequestMapping("/p7/{name}")
@ResponseBody
public void test7(@PathVariable(value = "name") String username){
    System.out.println(username);
}

测试：

2.1.10、自定义类型转换器

SpringMVC 默认已经提供了一些常用的类型转换器，例如客户端提交的字符串转换成int型进行参数设置。

但是不是所有的数据类型都提供了转换器，没有提供的就需要自定义转换器，例如：日期类型的数据就需要自 定义转换器。

自定义类型转换器步骤：

1、定义转换器类实现Converter接口

2、在配置文件中声明转换器

3、在中引用转换器

后端代码：

@RequestMapping("/p8")
@ResponseBody
public void test8(Date date){
    System.out.println(date);
}

当Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配。并且能自动做类型转换，显然这里要将字符串形式的时间转换为日期格式：

访问：http://localhost:8080/spring_mvc/person/p8?date=2022/4/6

但是换种格式访问

所以我们自定义日期类型转换器：

【1】自定义转换器类实现Converter接口

package com.zhou.mvc.converter;

import org.springframework.core.convert.converter.Converter;

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

/**
 * @author it春和
 * @create 2022-04-06 11:26
 */
public class DateConverter implements Converter<String, Date> {
    public Date convert(String source) {
        // 将日期字符串转换成日期对象并返回
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
        Date date = null;
        try {
            date = simpleDateFormat.parse(source);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }
}

【2】声明自定义转换器

  
    <bean id="conversionService2" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <list>
                <bean class="com.zhou.mvc.converter.DateConverter" />
            list>
        property>
    bean>

【3】在annotation-driven中引用转换器

<mvc:annotation-driven conversion-service="conversionService2"/>

【4】部署测试：

在开发中自定义类型转换器用的比较少，但是一些特殊需求的时候会用的，所以还是要掌握这个知识点！

2.1.11、获得Servlet相关API

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

HttpServletRequest

HttpServletResponse

HttpSession

@RequestMapping("/p9")
@ResponseBody
public void test9(HttpServletRequest request, HttpServletResponse response, HttpSession session){
    System.out.println(request);
    System.out.println(response);
    System.out.println(session);
}

2.1.12、获得请求头消息

使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name)

@RequestHeader注解的属性如下：

value：请求头的名称

required：是否必须携带此请求头

@RequestMapping("/p10")
@ResponseBody
public void test10(@RequestHeader(value = "User-Agent",required = false) String user_agent){
    System.out.println(user_agent);
}

使用@CookieValue可以获得指定Cookie的值

@CookieValue注解的属性如下：

value：指定cookie的名称

required：是否必须携带此cookie

@RequestMapping("/p11")
    @ResponseBody
    public void test11(@CookieValue(value = "JSESSIONID") String jsessionID){
        System.out.println(jsessionID);
    }

2.2、文件上传

2.2.1、客户端表单实现

文件上传客户端表单需要满足： 文件上传三要素

表单项type=“file”

表单的提交方式是post

表单的enctype属性是多部分表单形式，即enctype=“multipart/form-data”

新建一个jsp

<%--
  User: it春和
  Date: 2022/4/6 11:53
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    



    名称：

    文件：
    

2.2.2、文件上传原理

2.2.3、单文件上传

单文件上传步骤：

1、导入fileupload和io坐标

2、配置文件上传解析器

3、编写文件上传代码

【1】添加依赖

<dependency>
    <groupId>commons-fileuploadgroupId>
    <artifactId>commons-fileuploadartifactId>
    <version>1.3.1version>
dependency>
<dependency>
    <groupId>commons-iogroupId>
    <artifactId>commons-ioartifactId>
    <version>2.3version>
dependency>

【2】配置文件上传解析器spring-mvc.xml

   
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        
        <property name="defaultEncoding" value="UTF-8"/>
        
        <property name="maxUploadSize" value="5242800"/>
        
        <property name="maxUploadSizePerFile" value="5242800"/>
    bean>

【3】编写文件上传代码

@RequestMapping("/p12")
@ResponseBody
public void test12(String name, MultipartFile upload) throws IOException {
    System.out.println(name);
    // 获得文件名称
    String originalFilename = upload.getOriginalFilename();
    // 保存文件
    upload.transferTo(new File("d:\\upload\\"+originalFilename));
}

注意：

测试：

2.2.4、多文件上传

多文件上传，只需要将页面修改为多个文件上传项，将方法参数MultipartFile类型修改为MultipartFile[]即可

前端代码：

后台代码：

重新部署测试：

2.3、知识小结

SpringMVC实现数据请求方式：

​ 基本数据类型参数 参数名保持一致

​ POJO类型参数 实体的属性名和参数的名称保持一致即可

​ 数组类型参数 数组名称和请求参数名称保持一致

​ 集合类型参数 先封装实体 使用ajax请求&使用@RequestBody则不需要封装实体

SpringMVC获取数据的细节：

​ 中文乱码问题 CharacterEncodingFilter

​ @RequestParam和@PathVariable @RequestParam参数名的匹配，@PathVariable是参数占位符

​ 自定义类型转换器

​ 获得Servlet相关API

​ @RequestHeader和@CookieValue

​ 文件上传