springboot-前后端分离——第二篇

本篇主要介绍一个发送请求的工具—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;
    }

    @Override
    public 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; //数据 data

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

    @Override
    public String toString() {
        return "Result{" +
                "code=" + code +
                ", msg='" + msg + '\'' +
                ", data=" + data +
                '}';
    }
}