javaweb中的请求与响应--基于postman工具的应用（附带postman的详细安装步骤）

@VON

发布于 2025-12-17 09:36:18

800

一、前言

后端的第一天感觉难度就上来了，可能是基础太过薄弱了吧。目前看视频已经有点跟不上了，果然15天想要拿下还是太勉强了点。30天还差不多。不知道读者们有没有好好的去学这方面的知识，没有什么是学不会的，关键是坚持。

Postman这款应用一定要好好的去熟悉一下，挺重要的。

明天试着做一下综合案例，ヾ(◍°∇°◍)ﾉﾞ。

二、Postman简介

Postman 是一个流行的 API 开发工具，主要用于测试、调试和管理 API。它提供了一个用户友好的界面，使开发者能够轻松地发送 HTTP 请求、查看响应以及分析请求的结果。以下是 Postman 的主要特点和功能：

发送 HTTP 请求：

Postman 允许用户发送各种类型的 HTTP 请求，如 GET、POST、PUT、DELETE 等，可以设置请求头、请求体、参数等。

组织和管理请求：

用户可以创建多个请求集合，每个集合可以包含多个请求，方便组织和管理不同的 API 请求。

自动化测试：

Postman 支持创建测试脚本，可以自动化执行 API 的测试，验证响应的正确性和性能。

环境和变量：

可以设置环境变量和全局变量，用于在不同的环境中管理 API 的请求和测试。

实时调试：

提供实时的响应预览和格式化，方便开发者查看 API 返回的数据，支持多种数据格式，如 JSON、XML、HTML 等。

协作与分享：

Postman 允许用户分享请求和集合，方便团队成员协作，还可以导出和导入请求集合以便备份或分享给其他开发者。

集成其他工具：

支持与其他开发工具和服务集成，如 Swagger、GitHub、Jenkins 等，扩展了其功能和应用场景。

三、postman的安装

第一步：访问官网

Postman API Platform | Sign Up for Free

https://www.postman.com/

第二步：下载

四、各种类型的请求

温馨提示：此部分只进行代码上的讲解，方法部分在全套源代码中。

1. 简单实体参数

//1.简单实体参数
    @RequestMapping("/simpleParam")
    public String simpleParam(String name,int age) {
        System.out.println(name+":"+age);
        return "OK";
    }

分析：

注解 @RequestMapping：

@RequestMapping("/simpleParam") 指定了处理的 URL 路径为 "/simpleParam"。当有请求到达这个路径时，Spring MVC 将调用 simpleParam 方法来处理请求。

方法签名：

public String simpleParam(String name, int age) 是控制器方法的签名。它接收两个参数：name（String 类型）和 age（int 类型）。

方法体：

方法体内首先使用 System.out.println(name+":"+age); 打印接收到的 name 和 age 参数值到控制台。
然后方法返回字符串 "OK"。

参数绑定：

Spring MVC 会根据请求中的参数名字和方法的参数名字进行自动绑定。例如，如果有一个 HTTP GET 请求发送到 /simpleParam，并且请求参数为 name=John 和 age=30，那么 Spring MVC 将自动将 name 绑定为 "John"，将 age 绑定为整数 30。

返回值：

控制器方法的返回值为一个字符串 "OK"。在 Spring MVC 中，这个字符串通常表示请求处理成功，并返回给客户端。

结果展示：

2. 复杂实体参数

//2.复杂实体参数
    @RequestMapping("/complacePojo")
    public String complacePojo(user user){
        System.out.println(user);
        return "OK";
    }

代码分析：

1.@RequestMapping("/complacePojo") 指定了处理的 URL 路径为 "/complacePojo"。当有请求到达这个路径时，Spring MVC 将调用 complacePojo 方法来处理请求。
2.public String complacePojo(user user) 是控制器方法的签名。它接收一个名为 user 的参数，类型为 user。这里的 user 可能是一个自定义的 Java Bean 类，用于封装用户提交的数据。
3.方法体内首先使用 System.out.println(user); 打印接收到的 user 对象到控制台。

然后方法返回字符串 "OK"。

4.Spring MVC 将尝试将 HTTP 请求中的参数与 user 类的属性进行自动绑定。例如，如果请求提交了 user 对象的属性 name 和 age，Spring MVC 将会尝试将这些值设置到 user 对象的对应属性上。
5.控制器方法的返回值为一个字符串 "OK"。在 Spring MVC 中，这个字符串通常表示请求处理成功，并返回给客户端。

结果展示：

3. 数组参数

//3.数组参数
    @RequestMapping("/arrayParam")
    public String arrayParam(String[]hobby){
        System.out.println(Arrays.toString(hobby));
        return "OK";
    }

代码分析：

public String arrayParam(String[] hobby) 是控制器方法的签名。它接收一个名为 hobby 的参数，类型为 String[]。这表示它可以接收一个名为 hobby 的数组作为 HTTP 请求的参数。
System.out.println(Arrays.toString(hobby)); 打印接收到的 hobby 数组内容到控制台。这行代码将数组转换为字符串形式并输出，以便查看实际接收到的数据。
Spring MVC 将尝试将 HTTP 请求中的参数绑定到 hobby 数组上。例如，如果请求中包含多个名为 hobby 的参数（如 hobby=reading、hobby=traveling），Spring MVC 将会将这些值存储在 hobby 数组中。
这种方法适用于接收客户端传递的数组形式的数据，例如多选框选择、多个复选框的值等。通过定义方法参数为数组，Spring MVC 能够直接将这些值绑定到数组元素中。

注意事项：

确保请求中的参数命名正确，并且与方法参数的名称相匹配。Spring MVC 将根据参数名进行自动绑定，因此名称不匹配可能导致绑定失败或错误的数据处理。

结果展示：

4. 集合参数

//4.集合传参
    @RequestMapping("/ListParam")
    public String ListParam(@RequestParam List<String>hobby){
        System.out.println(hobby);
        return "OK";
    }

代码分析：

public String ListParam(@RequestParam List<String> hobby) 是控制器方法的签名。它接收一个名为 hobby 的参数，类型为 List<String>。使用 @RequestParam 注解明确指定了要从请求中获取的参数名为 hobby。
Spring MVC 将尝试将 HTTP 请求中名为 hobby 的参数的多个值绑定到 hobby 列表中。例如，如果请求中包含多个 hobby 参数（如 hobby=reading&hobby=traveling），Spring MVC 将这些值存储在 hobby 列表中。
这种方法适用于需要接收多个同名参数的情况，例如多选框选择、多个复选框的值等。通过定义方法参数为 List<String> 类型，Spring MVC 能够直接将这些值绑定到列表中。

结果展示：

5. 日期和时间参数

//5.日期时间传参
    @RequestMapping("/dateParam")
    public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){
        System.out.println(updateTime);
        return "OK";
    }

代码分析：

public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime) 是控制器方法的签名。它接收一个名为 updateTime 的参数，类型为 LocalDateTime。使用 @DateTimeFormat 注解指定了日期时间的格式为 "yyyy-MM-dd HH:mm:ss"，以便正确解析请求中的日期时间字符串。
Spring MVC 将尝试将 HTTP 请求中的日期时间参数按照指定的格式 "yyyy-MM-dd HH:mm:ss" 解析为 LocalDateTime 对象，并将其传递给 updateTime 参数。
这种方法适用于需要接收特定格式的日期时间参数的情况，例如记录最后更新时间、指定某个事件发生的时间等。

注意事项：

确保请求中的日期时间字符串格式与指定的 @DateTimeFormat 注解中的格式相匹配，否则会导致解析失败或者获得不正确的数据。

结果展示：

6. Json参数

//6.Json参数
    @RequestMapping("/jsonParam")
    public String jsonParam(@RequestBody user user){
        System.out.println(user);
        return "OK";
    }

代码分析：

public String jsonParam(@RequestBody user user) 是控制器方法的签名。它使用 @RequestBody 注解来指示 Spring MVC 从请求体中获取 JSON 数据，并尝试将其转换为 user 对象。这里的 user 类型是自定义的，通常应该包含与请求体 JSON 结构相匹配的字段。
@RequestBody 注解告诉 Spring MVC 从 HTTP 请求的主体中提取数据，并尝试将其转换为 user 对象。Spring MVC 使用默认的 JSON 转换器（通常是 Jackson）来完成从 JSON 到 Java 对象的反序列化过程。
这种方法适用于需要接收复杂结构的 JSON 数据的情况，例如通过 REST API 提交用户信息、创建资源等操作。

注意事项：

确保请求的 JSON 结构与 user 对象的字段名和类型相匹配，否则反序列化可能会失败或者得到不正确的数据。

user 类型必须有默认的无参构造函数，以便 JSON 反序列化库可以实例化对象。

结果展示：

7. 单个路径参数

//7.单个路径参数
    @RequestMapping("/pathParam/{id}")
    public String pathParam(@PathVariable int id){
        System.out.println(id);
        return "OK";
    }

代码分析：

@RequestMapping("/pathParam/{id}") 指定了处理的 URL 路径为 "/pathParam/{id}"。{id} 是一个占位符，表示这个路径可以接受一个名为 id 的变量作为参数。当有符合这个路径的 GET 请求到达时，Spring MVC 将调用 pathParam 方法来处理请求。
@PathVariable int id 注解在方法参数上，指示 Spring MVC 将 URL 中的 {id} 值映射到方法的 id 参数上。在这个例子中，Spring MVC 将提取路径中的 id 值，并将其转换为 int 类型，然后传递给方法 pathParam。
Spring MVC 能够根据 URL 路径中的占位符 {id}，将其解析为方法参数 id。这使得我们可以在路径中传递参数，而不是在请求体或查询参数中传递。
这种方法适用于需要从 URL 中获取特定信息的情况，例如获取资源的详细信息，根据 ID 查询特定记录等操作。

注意事项：

确保路径中的变量名 {id} 与 @PathVariable 注解中的参数名 id 保持一致，以确保正确的参数绑定。

如果路径参数类型不匹配（例如路径中是数字，但方法参数是字符串），Spring MVC 可能会抛出类型转换错误或者返回 404 错误。

结果展示：

8. 多个路径参数

//8.多个路径参数
    @RequestMapping("pathParam2/{id}/{name}")
    public String pathParam2(@PathVariable int id,@PathVariable String name){
        System.out.println(id+":"+name);
        return "OK";
    }

代码分析：

基本原理和单个路径大致相同

注意事项：

确保路径中的变量名 {id} 和 {name} 与 @PathVariable 注解中的参数名 id 和 name 保持一致，以确保正确的参数绑定。

结果展示：

五、响应

一般应用的时候为了防止太过混乱，会有一个统一的标准，因为只是认识，所以在这里就不介绍了，想要了解的读者可以去看源代码。里面包含这一部分。

1. 响应-字符串

//9.字符串
    @RequestMapping("/strParam")
    public String strParam(){
        System.out.println("Hello World");
        return "OK";
    }

System.out.println("Hello World"); 这行代码会在控制台打印输出 "Hello World"。它用于在方法被调用时输出一条消息到控制台，这在调试和跟踪代码执行流程时非常有用。
这种方法适用于需要执行某些逻辑或操作，但不需要返回动态生成的内容或者模板渲染的情况。例如，可以在这里执行一些后台任务、记录日志或者简单的逻辑处理。
如果方法的返回值是 "OK"，Spring MVC 将会尝试查找与请求对应的视图或者处理下一个处理程序，具体取决于应用程序的配置和处理链的设置。

2. 响应-数组

//10.数组
    @RequestMapping("/arrParam")
    public Address arrParam(){
        Address address = new Address();
        address.setProvince("河南");
        address.setCity("郑州");
        return address;
    }

Address address = new Address(); 创建了一个 Address 对象，假设这是一个自定义的 Java 类，用来表示地址信息。
address.setProvince("河南"); 设置地址对象的省份为 "河南"。
address.setCity("郑州"); 设置地址对象的城市为 "郑州"。
return address; 返回这个填充了省份和城市信息的 Address 对象。
控制器方法返回的是一个 Address 对象。在 Spring MVC 中，如果方法返回的是一个对象，Spring MVC 会自动将其转换为 JSON 格式（默认情况下），并作为 HTTP 响应体返回给客户端。
这种方法适用于需要从服务器端返回某个 Java 对象的情况，比如获取用户地址信息、商品信息等。客户端可以通过 HTTP GET 请求访问 /arrParam 路径，并获取到 JSON 格式的地址信息。
Address 类必须是可序列化的，并且通常需要正确实现 toString()、equals() 和 hashCode() 方法，以便在转换为 JSON 格式时能够正确工作。
在实际应用中，可以使用更复杂的对象结构，例如包含多个属性的对象，甚至嵌套对象，Spring MVC 会自动处理这些情况并将其转换为相应的 JSON 格式。

3. 响应-集合

//11.集合
    @RequestMapping("/listParam")
    public List<Address> listParam(){
        List<Address> list = new ArrayList<>();

        Address address = new Address();
        address.setProvince("山东");
        address.setCity("菏泽");

        Address address1 = new Address();
        address1.setProvince("陕西");
        address1.setCity("西安");

        list.add(address);
        list.add(address1);

        return list;
    }

List<Address> list = new ArrayList<>(); 创建了一个 ArrayList 对象 list，用来存储 Address 对象。
创建了两个 Address 对象 address 和 address1，分别代表不同的地址信息。
address 的省份设置为 "山东"，城市设置为 "菏泽"。
address1 的省份设置为 "陕西"，城市设置为 "西安"。
list.add(address); 将 address 对象添加到 list 列表中。
list.add(address1); 将 address1 对象添加到 list 列表中。
控制器方法返回的是一个 List<Address> 对象，即包含两个填充了省份和城市信息的 Address 对象的列表。在 Spring MVC 中，这些对象会被自动转换为 JSON 数组格式，并作为 HTTP 响应体返回给客户端。

六、全套源代码

text1代码

package com.von.demo5;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import pojo.Address;
import pojo.user;

import java.time.LocalDateTime;
import java.util.Arrays;
import java.util.List;

//请求处理类
@RestController
public class text1 {
    //springboot方式请求
    //1.简单实体参数
    @RequestMapping("/simpleParam")
    public String simpleParam(String name,int age) {
        System.out.println(name+":"+age);
        return "OK";
    }

    //2.复杂实体参数
    @RequestMapping("/complacePojo")
    public String complacePojo(user user){
        System.out.println(user);
        return "OK";
    }

    //3.数组参数
    @RequestMapping("/arrayParam")
    public String arrayParam(String[]hobby){
        System.out.println(Arrays.toString(hobby));
        return "OK";
    }

    //4.集合传参
    @RequestMapping("/ListParam")
    public String ListParam(@RequestParam List<String>hobby){
        System.out.println(hobby);
        return "OK";
    }

    //5.日期时间传参
    @RequestMapping("/dateParam")
    public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){
        System.out.println(updateTime);
        return "OK";
    }

    //6.Json参数
    @RequestMapping("/jsonParam")
    public String jsonParam(@RequestBody user user){
        System.out.println(user);
        return "OK";
    }

    //7.单个路径参数
    @RequestMapping("/pathParam/{id}")
    public String pathParam(@PathVariable int id){
        System.out.println(id);
        return "OK";
    }

    //8.多个路径参数
    @RequestMapping("pathParam2/{id}/{name}")
    public String pathParam2(@PathVariable int id,@PathVariable String name){
        System.out.println(id+":"+name);
        return "OK";
    }
}

text2代码

package com.von.demo5;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import pojo.Address;

import java.util.ArrayList;
import java.util.List;
@RestController
public class text2 {

    //测试响应数据
    //9.字符串
    @RequestMapping("/strParam")
    public String strParam(){
        System.out.println("Hello World");
        return "OK";
    }
    //10.数组
    @RequestMapping("/arrParam")
    public Address arrParam(){
        Address address = new Address();
        address.setProvince("河南");
        address.setCity("郑州");
        return address;
    }
    //11.集合
    @RequestMapping("/listParam")
    public List<Address> listParam(){
        List<Address> list = new ArrayList<>();

        Address address = new Address();
        address.setProvince("山东");
        address.setCity("菏泽");

        Address address1 = new Address();
        address1.setProvince("陕西");
        address1.setCity("西安");

        list.add(address);
        list.add(address1);

        return list;
    }
}

text3代码

package com.von.demo5;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import pojo.Address;
import pojo.Result;

import java.util.ArrayList;
import java.util.List;
@RestController
public class text3 {
    //使用result规范管理响应数据
    //9.字符串
    @RequestMapping("/strParam")
    public Result strParam(){
        System.out.println("Hello World");
        return Result.success("Hello World");
    }
    //10.数组
    @RequestMapping("/arrParam")
    public Result arrParam(){
        Address address = new Address();
        address.setProvince("河南");
        address.setCity("郑州");
        return Result.success(address);
    }
    //11.集合
    @RequestMapping("/listParam")
    public Result listParam(){
        List<Address> list = new ArrayList<>();

        Address address = new Address();
        address.setProvince("山东");
        address.setCity("菏泽");

        Address address1 = new Address();
        address1.setProvince("陕西");
        address1.setCity("西安");

        list.add(address);
        list.add(address1);

        return Result.success(list);
    }
}

Address方法

package pojo;

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

Result方法

package pojo;

public class Result {
    private int code;//1代表成功，0代表失败
    private String msg;//提示信息
    private Object data;//数据data
    public Result() {

    }

    public Result(int code, String msg, Object data) {
        this.code = code;
        this.msg = msg;
        this.data = data;
    }

    public int getCode() {
        return code;
    }

    public void setCode(int 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 +
                '}';
    }
}

user方法

package pojo;

public class user {
    private String name;
    private int age;
    private 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;
    }

    public Address getAddress() {
        return address;
    }

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

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

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2024-07-22，如有侵权请联系 cloudcommunity@tencent.com 删除

postman

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度