SpringMVC 请求与响应 -- SpringMVC快速入门保姆级教程（三）

---

前言

为了巩固所学的知识，作者尝试着开始发布一些学习笔记类的博客，方便日后回顾。当然，如果能帮到一些萌新进行新技术的学习那也是极好的。作者菜菜一枚，文章中如果有记录错误，欢迎读者朋友们批评指正。
（博客的参考源码可以在我主页的资源里找到，如果在学习的过程中有什么疑问欢迎大家在评论区向我提出）

三、SpringMVC 请求与响应

1.postman工具简介

1. postman是什么

3. postman基本使用

• 下载地址

https://www.postman.com/https://www.postman.com/

• 注册登录

2. 创建工作空间

• 切换工作空间

• 新建请求

• 保存请求

• 放大缩小窗口内容

• 编辑路径参数

2.设置请求映射路径

1. 问题描述：团队多人开发，每人设置不同的请求路径（不同的模块，相同的请求路径），冲突问题如何解决

@Controller
public class UserController {
    
    
    @RequestMapping("/save")
    @ResponseBody
    public String save(){
    
    
        System.out.println("user save ...");
        return "{'info':'springmvc'}";
    }
}   

@Controller
public class BookController {
    
    
    //请求路径映射
    @RequestMapping("/book/save")
    @ResponseBody
    public String save(){
    
    
        System.out.println("book save ...");
        return "{'module':'book save'}";
    }
}

2. 解决方案：设置模块名作为请求路径前缀

• 当模块中方法较少的时候，可以直接在请求路径中加入模块名前缀

• 当模块中方法名较多的时候，在模块上统一加模块名访问前缀

3. @RequestMapping详解

1.名称:@RequestMapping
2.类型:方法注解类注解
3.位置SpringMVC控制器方法定义上方
4.作用:设置当前控制器方法请求访问路径，如果设置在类上统一设置当前控制器方法请求访问路径前缀
5.属性：value(默认)，请求访问路径，或访问路径前缀
6.范例:

3.编码环境准备

• pom.xml配置文件导坐标和tomcat插件

    //servlet技术
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>
    
    //webmvc技术
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.2.10.RELEASE</version>
    </dependency>

 <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <port>80</port>
          <path>/</path>
        </configuration>
 </plugin>

• SpringMvc全局配置类

@Configuration
@ComponentScan("org.example.controller")
public class SpringMvcConfig {
    
    
}

• 初始化SpringMVC环境(同Spring环境)，设定SpringMVC加载对应的bean

 //加载springmvc配置类，产生springmvc容器（本质还是spring容器）
public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    
    
   
    protected Class<?>[] getRootConfigClasses() {
    
    
        return new Class[0];
    }

    //加载指定配置类
    protected Class<?>[] getServletConfigClasses() {
    
    
        return new Class[]{
    
    SpringMvcConfig.class};
    }

     //设置由springmvc控制器处理的请求映射路径
    protected String[] getServletMappings() {
    
    
        return new String[]{
    
    "/"};
    }

}

• 编写User实体类

//此处省略getter、setter和toString方法
public class User {
    
    
    private String name;
    private int age;
    private Address address;
}

• 编写Address实体类

//此处省略getter、setter和toString方法
public class Address {
    
    
    private String province;
    private String city;
}

• 编写UserController

//请求参数
@Controller
public class UserController {
    
    
    @RequestMapping("/commonParam")
    @ResponseBody
    public String commonParam(){
    
    
        return "{'module':'common param'}";
    }
}

• 配置tomcat启动运行

• 在postman中发送请求访问 localhost/commonparam

• 文件结构参考

4.get与post请求发送普通参数

1. get请求发送普通参数

普通参数：请求参数与形参名称对应即可完成参数传递

• 请求示例

    @RequestMapping("/commonParam")
    @ResponseBody
    public String commonParam(String name ,int age){
    
    
        System.out.println("普通参数传递 name ==> "+name);
        System.out.println("普通参数传递 age ==> "+age);
        return "{'module':'common param'}";
    }

• 运行示例

2. post请求发送普通参数

1.SpringMvc中post请求与get请求代码写法统一，区别于Servlet中的doGet方法和doPost方法
2.post请求的参数不在路径中，而是在方法体中,所以在请求体Body中用x-www-form-urlencoded方式编辑参数
3.form-data方式不仅能传递表单还能传递文件

3. POST请求过滤器解决中文乱码问题

• 过滤器解决POST请求中文乱码示例

public class ServletContainersInitConfig extends AbstractAnnotationConfigDispatcherServletInitializer {
    
    
    ...
    //乱码处理
    @Override
    protected Filter[] getServletFilters() {
    
    
        //创建过滤器
        CharacterEncodingFilter filter = new CharacterEncodingFilter();
        //设置过滤器过滤字符
        filter.setEncoding("UTF-8");
        //返回过滤器数组
        return new Filter[]{
    
    filter};
    }
}

• postman发送带中文参数的post请求示例

• 发送请求接收返回结果示例

4. 解决请求参数与形参名称不一致的问题

普通参数：请求参数名与形参名不同时，使用@RequestParam注解关联请求参数名称与形参名称之间的关系

    @RequestMapping("/commonParamDifferentName")
    @ResponseBody
    public String commonParamDifferentName(@RequestParam("name") String userName , int age){
    
    
        System.out.println("普通参数传递 userName ==> "+userName);
        System.out.println("普通参数传递 age ==> "+age);
        return "{'module':'common param different name'}";
    }

5.其他类型的请求参数传递

1. 实体类对象POJO

POJO参数：请求参数与形参对象中的属性对应即可完成参数传递

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

• postman发送请求请求示例

• 运行结果示例

2. 嵌套POJO参数

在上面的案例中我们发现pojo对象中的address属性并没有被赋值，它属于嵌套的POJO参数，在传参的时候需要单独对它进行赋值

嵌套POJO参数：嵌套属性按照层次结构设定名称即可完成参数传递

• postman传参示例

• 程序运行示例

3. 数组参数

数组参数：同名请求参数可以直接映射到对应名称的形参数组对象中

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

• postman发送请求示例（相同名称）

• 程序运行示例

4. 集合参数

集合参数：同名请求参数可以使用@RequestParam注解映射到对应名称的集合对象中作为数据

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

• postman发送请求示例

• 程序运行示例

5. json数据参数–转集合

• 导入json转换技术坐标

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

• 在SpringMvc全局配置类中开启json数据类型自动转换注解

1.名称：@EnableWebMvc
2.类型：配置类注解
3.功能：EnablewebMvc注解功能强大，该注解整合了多个功能，此处仅使用其中一部分功能，即json数据进行自动类型转换
4.位置:SpringMVC配置类定义上方作用:开启SpringMVC多项辅助功能
5.范例:

@Configuration
@ComponentScan("org.example.controller")
//开启json数据类型自动转换
@EnableWebMvc
public class SpringMvcConfig {
    
    
}

• 集合参数：json格式

1.开启json数据格式的自动转换，在配置类中开启@EnableWebMvc
2.使用@RequestBody注解将外部传递的json数组数据映射到形参的集合对象中作为数据

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

• postman发送请求示例

• 程序运行示例

6. json数据参数–转对象

1.开启json数据格式的自动转换，在配置类中开启@EnableWebMvc
2.使用@RequestBody注解将外部传递的json数据映射到形参的实体类对象中，要求属性名称一一对应

1.名称: @RequestBody
2.类型：形参注解
3.位置：SpringMVC控制器方法形参定义前面
4.作用：将请求中请求体所包含的数据传递给请求参数，此注解一个处理器方法只能使用一次
5.范例:

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

• postman传参示例

• 程序运行示例

7. 日期参数

使用@DateTimeFormat注解设置日期类型数据格式，默认格式yyyy/MM/dd

1.名称: @DateTimeFormat
2.类型:形参注解
3.位置: SpringMVC控制器方法形参前面作用:设定日期时间型数据格式
4.范例:

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

• postman传参示例

• 程序运行示例

8. @RequestBody与@RequestParam区别

1.区别
@RequestParam用于接收urI地址传参，表单传参(application/x-www-formurlencoded
@RequestBody用于接收json数据[application/json]
2.应用
后期开发中，发送json格式数据为主，@RequestBody应用较广
如果发送非json格式数据，选用@RequestParam接收请求参数

6.响应

1. 响应页面

响应页面/跳转页面
返回值为String类型，设置返回值为页面名称，即可实现页面跳转

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

2. 响应文本

返回值为String类型，设置返回值为任意字符串信息，即可实现返回指定字符串信息，需要依赖@ResponseBody注解

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

3. 响应pojo对象

返回值为实体类对象，设置返回值为实体类类型，即可实现返回对应对象的json数据，需要依赖@ResponseBody注解和@EnableWebMvc注解

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

4. 响应pojo集合对象

返回值为集合对象，设置返回值为集合类型，即可实现返回对应集合的json数组数据，需要依赖@ResponseBody注解和@EnableWebMvc注解

    @RequestMapping("/toJsonList")
    @ResponseBody
    public List<User> toJsonList(){
    
    
        System.out.println("返回json集合数据");
        User user1 = new User();
        user1.setName("传智播客");
        user1.setAge(15);

        User user2 = new User();
        user2.setName("程序员");
        user2.setAge(12);

        List<User> userList = new ArrayList<User>();
        userList.add(user1);
        userList.add(user2);

        return userList;
    }

总结

欢迎各位留言交流以及批评指正，如果文章对您有帮助或者觉得作者写的还不错可以点一下关注,点赞，收藏支持一下作者，后续还会更新mybatis, springboot，maven高级，微信小程序，等前后端内容的学习笔记。
（博客的参考源码可以在我主页的资源里找到，如果在学习的过程中有什么疑问欢迎大家在评论区向我提出）