本篇主要介绍一个发送请求的工具—postman,然后对请求中的参数进行介绍,例如简单参数、实体参数、数组参数、集合参数、日期类型参数以及json类型参数,对这些参数接收进行总结。最后对响应数据进行介绍,使用统一响应结果返回浏览器数据。
目录 :
目录
一、发送请求工具——postman
二、注解的介绍:
三、请求参数的接收
1、简单参数:
2、实体参数
简单实体参数:
复杂实体参数:
3、数组类型参数:
4、集合类型参数:
5、日期类型参数:
6、JSON格式参数:
四、响应数据:
一、发送请求工具——postman
postman是发送请求的工具,访问操作类中的方法,然后在这个方法return一个数据,就是响应数据,返回到postman;
请求响应的工具:打开postman,然后创建一个workspaces,可以在输入框内输入请求链接,并且可以选择请求方式:上面有save,可以将请求进行保存,需要先创建一个集合,然后保存到里面即可;(可以直接在这个软件中输入进行测试即可)
二、注解的介绍:
RestController注解:
这个注解中包含两个注解:@Controller和@ResponseBody注解,@ResponseBody注解是将返回的数据结构转换为 Json 格式。
@RequestMapping注解:
将请求和处理请求的控制器方法关联起来,建立映射关系。SpringMVC中接收到指定的请求,就会来找到在映射关系中对应的控制器方法来处理这个请求。
@RequestParam注解:如果方法形参名和请求参数名不匹配,可以使用该注解完成映射。
三、请求参数的接收
项目层级结构:
1、简单参数:
springboot方式下获取get请求的参数,先编写好请求类,然后运行启动类,然后在postman中输入请求链接,然后在后面输入?+参数以及参数的值,就可以在idea中获取到对应的参数并在postman中得到响应结果;注意controller类中的方法参数要和postman中请求链接后面的参数名要相同;
//传统方式接受简单参数:
// @RequestMapping("/simpleTest")
// public String params_test(HttpServletRequest request){
// String name=request.getParameter("name");
// String age = request.getParameter("age");
// int age1 = Integer.parseInt(age);
// System.out.println(name+":"+age1);
// return "OK";
//springboot方式接收简单参数:@RequestMapping("/simpleTest")public String params_test(String name, Integer age) {System.out.println(name + ":" + age);return "OK";}
在postman中进行测试:
后端也会得到响应数据:
2、实体参数
-
简单实体参数:
请求参数名与形参对象属性名相同,定义一个实体类来接收:
例如,前端发送的参数为name和age,此时可以定义一个实体类User:
package com.web_test.pojo;public class User {private String name;private Integer age;private Address address;public String getName() {return name;}public Integer getAge() {return age;}@Overridepublic String toString() {return "User{" +"name='" + name + '\'' +", age=" + age +", address=" + address +'}';}public void setAddress(Address address) {this.address = address;}public Address getAddress() {return address;}public void setName(String name) {this.name = name;}public void setAge(Integer age) {this.age = age;}
}
然后在controller中写好接收方法:
@RequestMapping("/gettest")public String shitilei(User user){System.out.println(user);return "OK";}
接下来在postman中进行测试:这样就可以将结果保存到对象的属性中。
-
复杂实体参数:
如果一个类中的属性是另一个类的对象,这个类又包含另外的属性,如何封装:注意前端发送的请求中的连接后的参数输入方式,以及重新定义一个新的类并且重写get set以及toString方法即可;
3、数组类型参数:
对于多选框,可以选择多个选项,因此一般用数组进行接收;注意数组的名称要与参数名称相同;
前端发送的请求中的参数为fruits=草莓&fruits=苹果,此时可以在controller方法形参定义一个String[] fruits数组来接收即可,注意,请求参数名为fruits,数组的名称也要为fruits。
@RequestMapping("/arrayparam")public String arraytest(String[] hobby){System.out.println(Arrays.toString(hobby));return "OK";}
4、集合类型参数:
同样,如果想用集合来接收fruits参数,需要使用@RequestParam注解来绑定参数关系。
@RequestMapping("/listparam")public String listtest(@RequestParam List<String> hobby){System.out.println(hobby);return "OK";}
5、日期类型参数:
如果前端发送的请求中的参数为time=2024-01-01 12:00:00,需要先规定格式,使用@DateTimeFormat注解完成日期参数格式转换,与请求参数相同的格式。
@RequestMapping("/dateParam")public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){System.out.println(updateTime);return "OK";}
postman中测试:
6、JSON格式参数:
json数据键名与形参对象属性名相同,定义一个实体类来进行接收,并且需要使用@RequestBody注解将json格式转化为实体类格式进行接收,与前面讲的注解中@ResponseBody注解类似,@ResponseBody是将实体类格式转化为json格式发送给前端。
//6.json参数:@RequestMapping("/jsonParam")public String jsonParam(@RequestBody User user){System.out.println(user);return "OK";}
postman中测试:
四、响应数据:
可以发现返回的响应的数据类型很多,字符串列表对象等,一会这样解析,一会那样解析,很复杂,所以为了方便起见,采用统一的响应结果;返回一个result对象,用一个result类然后里面包含三个属性以及set和get方法,并且重载了静态的success方法;controller类中的方法可以直接return调用的静态方法然后传进去参数即可;最后返回的对象会解析成json格式展现;注意需要使用@ResponseBody注解进行转换,将实体类对象格式转化为json格式发送到前端如下:
package com.web_test.controller;import com.web_test.pojo.Address;
import com.web_test.pojo.Result;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
//以下是响应部分:
//可以直接使用统一结果封装类接收参数:
@RestController
public class responseConntroller {//最初的方式:返回值为字符串:
// @RequestMapping("/hello")
// public String hello(){
// System.out.println("hello World");
// return "OK";
// }//使用统一结果封装类接收参数:@RequestMapping("/hello")public Result hello(){System.out.println("hello World");return new Result(1,"success","Hello World!");}//最初的方式:返回值为对象:
// @RequestMapping("/getAdr")
// public Address getAdr(){
// Address address=new Address();
// address.setProvince("山东省");
// address.setCity("济南");
// return address;
// }//使用统一结果封装类:返回值为对象:@RequestMapping("/getAdr")public Result getAdr(){Address address=new Address();address.setProvince("山东省");address.setCity("济南");return Result.success(address);}}
实体类Result为:
package com.web_test.pojo;/*** 统一响应结果封装类*/
public class Result {private Integer code ;//1 成功 , 0 失败private String msg; //提示信息private Object data; //数据 datapublic Result() {}public Result(Integer code, String msg, Object data) {this.code = code;this.msg = msg;this.data = data;}public Integer getCode() {return code;}public void setCode(Integer code) {this.code = code;}public String getMsg() {return msg;}public void setMsg(String msg) {this.msg = msg;}public Object getData() {return data;}public void setData(Object data) {this.data = data;}public static Result success(Object data){return new Result(1, "success", data);}public static Result success(){return new Result(1, "success", null);}public static Result error(String msg){return new Result(0, msg, null);}@Overridepublic String toString() {return "Result{" +"code=" + code +", msg='" + msg + '\'' +", data=" + data +'}';}
}