SpringMVC 请求与响应 -- SpringMVC快速入门保姆级教程（三）
@TOC
前言
为了巩固所学的知识，作者尝试着开始发布一些学习笔记类的博客，方便日后回顾。当然，如果能帮到一些萌新进行新技术的学习那也是极好的。作者菜菜一枚，文章中如果有记录错误，欢迎读者朋友们批评指正。
（博客的参考源码可以在我主页的资源里找到，如果在学习的过程中有什么疑问欢迎大家在评论区向我提出）
三、SpringMVC 请求与响应
1.postman工具简介
- postman是什么
- postman基本使用
- 下载地址
https://www.postman.com/https://www.postman.com/
- 注册登录
- 创建工作空间
- 切换工作空间
- 新建请求
- 保存请求
- 放大缩小窗口内容
- 编辑路径参数
2.设置请求映射路径
- 问题描述：团队多人开发，每人设置不同的请求路径（不同的模块，相同的请求路径），冲突问题如何解决
@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'}";
}
}
- 解决方案：设置模块名作为请求路径前缀
- 当模块中方法较少的时候，可以直接在请求路径中加入模块名前缀
- 当模块中方法名较多的时候，在模块上统一加模块名访问前缀
- @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请求发送普通参数
- 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'}";
}
- 运行示例
- post请求发送普通参数
1.SpringMvc中post请求与get请求代码写法统一，区别于Servlet中的doGet方法和doPost方法
2.post请求的参数不在路径中，而是在方法体中,所以在请求体Body中用x-www-form-urlencoded方式编辑参数
3.form-data方式不仅能传递表单还能传递文件
- 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请求示例
- 发送请求接收返回结果示例
- 解决请求参数与形参名称不一致的问题
普通参数：请求参数名与形参名不同时，使用@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.其他类型的请求参数传递
- 实体类对象POJO
POJO参数：请求参数与形参对象中的属性对应即可完成参数传递
@RequestMapping("/pojoParam")
@ResponseBody
public String pojoParam(User user){
System.out.println("pojo参数传递 user ==> "+user);
return "{'module':'pojo param'}";
}
- postman发送请求请求示例
- 运行结果示例
- 嵌套POJO参数
在上面的案例中我们发现pojo对象中的address属性并没有被赋值，它属于嵌套的POJO参数，在传参的时候需要单独对它进行赋值
嵌套POJO参数：嵌套属性按照层次结构设定名称即可完成参数传递
- postman传参示例
- 程序运行示例
- 数组参数
数组参数：同名请求参数可以直接映射到对应名称的形参数组对象中
@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发送请求示例
- 程序运行示例
- 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发送请求示例
- 程序运行示例
- 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传参示例
- 程序运行示例
- @RequestBody与@RequestParam区别
1.区别
@RequestParam用于接收urI地址传参，表单传参(application/x-www-formurlencoded
@RequestBody用于接收json数据[application/json]
2.应用
后期开发中，发送json格式数据为主，@RequestBody应用较广
如果发送非json格式数据，选用@RequestParam接收请求参数
6.响应
- 响应页面
响应页面/跳转页面
返回值为String类型，设置返回值为页面名称，即可实现页面跳转
@RequestMapping("/toJumpPage")
public String toJumpPage(){
System.out.println("跳转页面");
return "page.jsp";
}
- 响应文本
返回值为String类型，设置返回值为任意字符串信息，即可实现返回指定字符串信息，需要依赖@ResponseBody注解
@RequestMapping("/toText")
@ResponseBody
public String toText(){
System.out.println("返回纯文本数据");
return "response text";
}
- 响应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;
}
- 响应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;
}
总结
欢迎各位留言交流以及批评指正，如果文章对您有帮助或者觉得作者写的还不错可以点一下关注，点赞，收藏支持一下。
（博客的参考源码可以在我主页的资源里找到，如果在学习的过程中有什么疑问欢迎大家在评论区向我提出）
- 点赞
- 收藏
- 关注作者
评论（0）