【SpringMVC】SpringMVC的请求与响应

文章目录

[0. Tomcat环境的配置](#0. Tomcat环境的配置)
[1. PostMan工具介绍](#1. PostMan工具介绍)
- 创建WorkSpace
- 建立新的请求
[2. 请求映射路径](#2. 请求映射路径)
[3. Get请求与Post请求](#3. Get请求与Post请求)
[4. 五种类型参数传递](#4. 五种类型参数传递)
[5. JSON数据](#5. JSON数据)
[6. 日期型参数传递](#6. 日期型参数传递)
- 参数传递方法
- 类型转换器
[7. 响应](#7. 响应)

0. Tomcat环境的配置

这里重新推荐下载安装Tomcat进行配置的方法：

第一步：安装Tomcat，可以不用看里面安装JDK的部分，毕竟都学到SpringMVC了，JDK肯定也安装了：Tomcat安装和配置，超详细（附JDK安装及配置环境变量）

第二步：在IDEA里面配置Tomcat运行环境：SpringMVC------配置tomcat

第三步：修改一下下面两个位置，使得我们通过/就可以访问，否则如果这个链接后面带了一堆乱七八糟的东西，我们访问localhost/会报404的错误：

注意，启动端口设置成了80，localhost等价于localhost:80

1. PostMan工具介绍

PostMan的作用就是模仿浏览器发出一些请求，比如Get请求、Post请求，如果在Post请求我们还需要自己写一个表单去提交，ajax请求的时候还需要些json，通过PostMan就可以解决以下这些问题

创建WorkSpace

创建了WorkSpace后我们也可以随时切换不同的WorkSpace：

建立新的请求

输入请求地址，得到响应内容：

点击preview的话就可以看到网页预览的结果，比如我们请求一下百度：

其他的话就是点击右上角的save可以将请求保存到左侧，方便后续测试使用

2. 请求映射路径

案例结构与代码

案例结构

案例代码

config/SpringMvcConfig.java

java 复制代码

package com.demo.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan("com.demo.controller")
public class SpringMvcConfig {
}

config/ServletContainerInitConfig.java

java 复制代码

package com.demo.config;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

controller/BookController.java

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class BookController {

    @RequestMapping("/save")
    @ResponseBody
    public String save(){
        System.out.println("book save ...");
        return "{'module': 'book save'}";
    }
}

controller/UserController.java

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class UserController {

    @RequestMapping("/save")
    @ResponseBody
    public String save(){
        System.out.println("User save...");
        return "{'module': 'springmvc'}";
    }

    @RequestMapping("/delete")
    @ResponseBody
    public String delete(){
        System.out.println("User delete...");
        return "{'module': 'springmvc'}";
    }
}

案例存在问题

运行项目，会发现报错：

因为在BookController和UserController下有相同的路径，就会导致报错

团队多人开发，每个人设置不同的请求路径，应该怎么解决？

解决方案

方法

各个Controller用不同的路径

在UserController.java中带上/user前缀：

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class UserController {

    @RequestMapping("/user/save")
    @ResponseBody
    public String save(){
        System.out.println("User save...");
        return "{'module': 'user save'}";
    }

    @RequestMapping("/user/delete")
    @ResponseBody
    public String delete(){
        System.out.println("User delete...");
        return "{'module': 'user delete'}";
    }
}

在BookController.java中带上/book前缀：

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class BookController {

    @RequestMapping("/book/save")
    @ResponseBody
    public String save(){
        System.out.println("book save ...");
        return "{'module': 'book save'}";
    }
}

再次启动，问题解决，测试一下/user/save和/book/save：

方法升级版------配置请求路径前缀

在Controller上定义请求模块的前缀，在每一个Controller上加上对应的前缀，如下

在UserController.java模块顶部加上/user前缀：

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/save")
    @ResponseBody
    public String save(){
        System.out.println("User save...");
        return "{'module': 'user save'}";
    }

    @RequestMapping("/delete")
    @ResponseBody
    public String delete(){
        System.out.println("User delete...");
        return "{'module': 'user delete'}";
    }
}

在BookController.java模块顶部加上/book前缀：

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/book")
public class BookController {

    @RequestMapping("/save")
    @ResponseBody
    public String save(){
        System.out.println("book save ...");
        return "{'module': 'book save'}";
    }
}

重新启动并测试，发现仍然可用：

注解总结

注解：@RequestMapping

类型：方法注解、类注解

位置：Spring控制器方法定义上方

作用：设置当前控制器方法请求访问路径，如果设置在类上统一设置当前控制器方法请求访问路径前缀

3. Get请求与Post请求

两种请求的传参方式是不一样的，在这里理解在Get请求和Post请求中如何传参

案例结构与案例代码

案例结构

案例代码

config/ServletContainerInitConfig.java

java 复制代码

package com.demo.config;

import org.apache.ibatis.jdbc.Null;
import org.springframework.web.context.WebApplicationContext;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
import org.springframework.web.servlet.support.AbstractDispatcherServletInitializer;

public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

config/SpringMvcConfig.java

java 复制代码

package com.demo.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan("com.demo.controller")
public class SpringMvcConfig {
}

controller/UserController.java

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class UserController {

    @RequestMapping("/commonParam")
    @ResponseBody
    public String commonParam(){
        return "{'module': 'common param'}";
    }
}

domain/User.java：

java 复制代码

package com.demo.domain;

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

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + 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;
    }
}

domain/Address.java：

java 复制代码

package com.demo.domain;

public class Address {
    private String province;
    private String city;

    @Override
    public String toString() {
        return "Address{" +
                "province='" + province + '\'' +
                ", city='" + city + '\'' +
                '}';
    }

    public String getProvince() {
        return province;
    }

    public void setProvince(String province) {
        this.province = province;
    }

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }
}

启动一下，看看是否能够跑通：

Get请求

一般Get请求是通过在链接后面接上?，然后再写具体的参数名称和内容，例如：localhost/commonParam?name=aaa

接收参数的方法就是在方法上加上对应的形参：

java 复制代码

package com.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class UserController {

    @RequestMapping("/commonParam")
    @ResponseBody
    public String commonParam(String name){
        System.out.println("接收到的参数name==>" + name);
        return "{'module': 'common param'}";
    }
}

此时除了可以看到返回的结果，还可以在控制台看到打印的参数：

如果是多个参数，就修改上面代码的方法处，用多个参数进行接收即可：
public String commonParam(String name, int age)

再测试，结果如下：

PS: PostMan小技巧：如果不需要这个参数，就把前面的勾去掉，若彻底不再需要这个参数，在参数那一栏上的最右侧会有一个小垃圾桶，点击去除

Post请求

无论是Get请求还是Post请求，对于后台请求的代码来说没有变化，这里和Servlet不一样，Servlet中区分doGet和doPost，在这里合二为一了

在Postman中，我们如下测试，注意，在Post请求中不是在Param中写参数，而是在Body中写参数，Body下的x-www-form-urlencoded位置加上参数：

接收中文时的乱码问题

Post请求，通过过滤器解决

假如我们在Post请求中给name参数的是中文，在运行时候会发现接收到的参数乱码：
为了解决这个问题，我们就需要在ServletContainerInitConfig中设置一个过滤器：

java 复制代码

package com.demo.config;

import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

import javax.servlet.Filter;

public class ServletContainerInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{SpringMvcConfig.class};
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }

    @Override
    protected Filter[] getServletFilters() {
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        filter.setEncoding("UTF-8");
        return new Filter[]{filter};
    }
}

此时就可以解决中文乱码的问题：

Get请求，通过配置解决

如果是Get请求，如上配置后出来的还会是乱码（看弹幕有人说Tomcat8及以上设置了过滤器后Get请求出来的会是中文而不是乱码，如果使用本篇文章第0点中的方式来配置Tomcat，确实不会出现乱码的问题）

但是之前我是使用在pom.xml中通过配置来进行启动服务的配置，那时候我是参考了这一篇博客来设置GET请求不乱码：SpringMVC 中如何解决POST和GET请求中文乱码问题？（面试题）

修改pom.xml中的build配置如下，加上了uriEncoding的配置：

xml 复制代码

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.tomcat.maven</groupId>
      <artifactId>tomcat7-maven-plugin</artifactId>
      <version>2.1</version>
      <configuration>
        <port>80</port>
        <path>/</path>
        <uriEncoding>UTF-8</uriEncoding>
      </configuration>
    </plugin>
  </plugins>
</build>

再次执行GET请求，结果如下：

注意：只设置下面这种而不写过滤器，是不能保证Post请求不乱码的

大概查了一下网上的资料，我认为一个请求不能满足两种需求的原因是：因为Post请求会把数据放到正文中传递，然后过滤器是针对于这个正文来设定的，然后我们配置的build是针对于得到的链接来进行设定的

4. 五种类型参数传递

第一种：具有不同名称的普通参数

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/commonParamDifferentName")
@ResponseBody
public String commonParamDifferentName(String username, int age){
    System.out.println("接收到的参数name==>" + username);
    System.out.println("接收到的参数age==>" + age);
    return "{'module': 'common param different name'}";
}

使用不同名称的参数，则username就无法接收到：

如果想要使方法能够接收不同名称的参数，就使用注解：@RequestParam，如下：

java 复制代码

@RequestMapping("/commonParamDifferentName")
@ResponseBody
public String commonParamDifferentName(@RequestParam("name") String username, int age){
    System.out.println("接收到的参数name==>" + username);
    System.out.println("接收到的参数age==>" + age);
    return "{'module': 'common param different name'}";
}

再进行测试，结果如下：

第二种：实体类(POJO参数)

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/pojoParam")
@ResponseBody
public String pojoParam(User user){
    System.out.println("接收带的参数user==>" + user);
    return "{'module': 'pojo param'}";
}

在测试的时候带上name和age属性，框架可以帮我们自动封装到实体类中：

第三种：嵌套POJO参数

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/pojoContainPojoParam")
@ResponseBody
public String pojoContainPojoParam(User user){
    System.out.println("pojo嵌套pojo参数传递 user ==> " + user);
    return "{'module': 'pojo contain pojo param'}";
}

在domain/User.java中加上一个Address属性，加上getter和setter方法，更新toString()方法：

java 复制代码

package com.demo.domain;

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

    Address address;

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", address=" + address +
                '}';
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

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

传参的时候，只需要通过属性名.属性来加上就可以了：

第四种：数组参数

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/arrayParam")
@ResponseBody
public String stringParam(String[] likes){
    System.out.println("数组参数传递 likes ==> " + Arrays.toString(likes));
    return "{'module': 'array param'}";
}

数组只需要使用同一个参数接收就可以了，如下：

第五种：集合参数

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/listParam")
@ResponseBody
public String listParam(List<String> likes){
    System.out.println("集合参数传递 likes ==> " + likes);
    return "{'module': 'list param'}";
}

如果使用像第四种那样的方式来进行传参，会报错java.lang.NoSuchMethodException: java.util.List.<init>()，显示没有这样的init方法

这是因为List<String>被当成pojo参数处理了。因为List<String>被视作了一个引用类型对象，而框架对于引用类型对象的处理是：先通过构造方法构造一个对象，然后通过set方法将属性set到这个对象里面去，所以这里会报错。

为了避免这个问题，我们需要修改这个方法中的参数，简单地加一下@RequestParam，让框架将其作为一个参数进行处理，而不是作为一个引用对象：

java 复制代码

public String listParam(@RequestParam List<String> likes)

再运行，得到结果如下：

5. JSON数据

导入json相关坐标

xml 复制代码

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

开启SpringMVC将JSON数据转换成对象的功能

在controller/SpringMvcConfig.java 中加上一个注解@EnableWebMvc

当然，这个注解能够实现的不止这个功能，该注解整合了多个功能，不止解析JSON这一个功能

java 复制代码

package com.demo.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;

@Configuration
@ComponentScan("com.demo.controller")
@EnableWebMvc
public class SpringMvcConfig {
}

PostMan中发JSON的位置

第一种：JSON数组

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/listParamForJson")
@ResponseBody
public String listParamForJson(List<String> likes){
    System.out.println("list common(json)参数传递 list ==> " + likes);
    return "{'module': list common for json param}";
}

对于被封装起来的JSON，我们在这里换一个注解：@RequestBody即可：public String listParamForJson(@RequestBody List<String> likes)，测试如下：

第二种：JSON对象（POJO）

在controller/UserController.java 中加上一个方法，同理，为了解析JSON，需要加上@RequestBody：

java 复制代码

@RequestMapping("/pojoParamForJson")
@ResponseBody
public String pojoParamForJson(@RequestBody User user){
    System.out.println("pojo(json)参数传递 user ==> " + user);
    return "{'module': pojo for json param}";
}

结果如下：

因为没有给address的信息，所以address=null，进一步改进一下：

第三种：JSON数组（POJO）

在controller/UserController.java中加上一个方法，类似的：

java 复制代码

@RequestMapping("/listPojoParamForJson")
@ResponseBody
public String listPojoParamForJson(@RequestBody List<User> list){
    System.out.println("list pojo(json)参数传递 user ==> " + list);
    return "{'module': list pojo for json param}";
}

关于@RequestBody

类型：这个参数是一个形参注解

位置：定义位置在SpringMVC控制器方法形参定义前面

作用：将请求中请求体所包含的数据传递给请求参数，此注解一个处理器方法只能使用一次

@RequestBody和@ResponseParam的区别

区别

@RequestParam用于接收url地址传参，表单传参【application/x-www-form-urlencoded】

@RequestBody用于接收json数据【application/json】
应用

后期开发中，发送json格式数据为主，@RequestBody应用较广

如果发送非json格式数据，选用@RequestParam接收请求参数

6. 日期型参数传递

参数传递方法

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/dataParam")
@ResponseBody
public String dataParam(Date date){
    System.out.println("参数传递 date ==> " + date);
    return "{'module': data param}";
}

测试一下，使用2088/08/08这种斜杠式是可以被解析的

在参数里面加上date1，打开上图的date1数据再测试，会报错无法解析这种格式：

这里应该使用注解@DateTimeFormat注解来指定格式：

java 复制代码

@RequestMapping("/dataParam")
@ResponseBody
public String dataParam(Date date, @DateTimeFormat(pattern = "yyyy-MM-dd") Date date1){
    System.out.println("参数传递 date ==> " + date);
    System.out.println("参数传递 date1 ==> " + date1);
    return "{'module': data param}";
}

测试如下：

如果需要加上时间，就使用格式：@DateTimeFormat(pattern="yyyy/MM/dd HH:mm:ss)"即可：

类型转换器

Converter接口（其实我没找到这个）

java 复制代码

public interface Converter<S, T>{
	@Nullable
	T convert(S var1);
}

请求参数年龄数据（String→Integer）

日期格式转换（String→Date）

7. 响应

响应页面

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping("/toJumpPage")
public String toJumpPage(){
    System.out.println("跳转页面");
    return "index.jsp";
}

则会自动跳转到如下的页面：

响应数据

页面数据

在controller/UserController.java中加上一个方法：

java 复制代码

@RequestMapping(path="/toJumpPage")
public String toJumpPage(){
    System.out.println("跳转页面");
    return "index.jsp";
}

webapp/index.jsp中的内容：

html 复制代码

<html>
<body>
<h2>Hello Spring MVC!</h2>
</body>
</html>

在浏览器中输入localhost/toJumpPage

得到以下结果：

这说明Controller中写方法，会自动帮我们找返回的这个String所对应的页面。

文本数据

在controller/UserController.java 中加上一个方法，如果不用@ResponseBody，则方法会尝试去找一个叫做/response text的页面：

java 复制代码

@RequestMapping("/toText")
@ResponseBody
public String toText(){
    System.out.println("返回纯文本数据");
    return "response text";
}

JSON数据

默认返回的是一个String，我们想让框架帮我们把User转换成JSON传递过去，其实就是需要修改响应的内容，响应的不再是页面，而需要我们自定义，则需要加上@ResponseBody注解

java 复制代码

@RequestMapping("/toJsonPOJO")
@ResponseBody
public User toJsonPOJO(){
    System.out.println("返回json对象数据");
    User user = new User();
    user.setName("啊啊啊");
    user.setAge(15);
    return user;
}

List数据：JSON集合对象

java 复制代码

@RequestMapping("/toJsonPOJOList")
@ResponseBody
public List<User> toJsonList(){
    System.out.println("返回JSON集合数据");
    User user1 = new User();
    user1.setName("aaa");
    user1.setAge(33);
    
    User user2 = new User();
    user2.setName("bbb");
    user2.setAge(22);
    
    List<User> userList = new ArrayList<>();
    userList.add(user1);
    userList.add(user2);
    return userList;
}

@ResponseBody注解介绍

这是一个方法注解，位置位于SpringMVC控制器方法定义上方

作用：设置当前控制器返回值 作为响应体