用postman传JSON字符串的@requestParam

在使用Postman时，通常@requestParam用于接收URL中的参数，而不是请求正文中的JSON字符串。如果您的目的是在请求正文中传递JSON字符串，则可以使用@RequestBody注释来接收JSON字符串。

在Spring Boot中，使用@RequestBody注释来接收JSON字符串的请求正文。您可以按照以下步骤执行：

1. 在您的Spring Boot控制器方法中，使用@RequestBody注释来接收JSON字符串。例如：

@PostMapping("/example")
public void example(@RequestBody String json) {
    // 处理接收到的JSON字符串请求正文
}

2. 在Postman中创建一个新的POST请求。
3. 在请求的body选项卡中，选择"raw"选项，并选择"JSON"类型。
4. 在文本框中输入JSON字符串请求正文。
5. 在请求的URL中添加任何必需的参数。
6. 点击"Send"按钮发送请求。

注意：如果你的JSON字符串包含复杂的嵌套对象或者数组，你可能需要定义一个Java对象来映射这个JSON字符串。在这种情况下，您可以使用@RequestBody注释和@JsonDeserialize注释来接收和反序列化JSON字符串。

相关问题

postman测试上传文件功能@RequestParam

### 如何在Postman中测试带有`@RequestParam`注解的文件上传功能

为了实现这一目标，需配置Postman发送一个多部分表单数据(`multipart/form-data`)类型的HTTP POST请求。服务器端应使用Spring框架处理该类请求，并通过`@RequestParam`来绑定前端传递过来的具体参数。

#### 配置Postman环境

确保选择了POST方法并指定了接收文件的目标URL。切换到Body标签页下选择`form-data`选项[^2]。此时界面允许添加键值对形式的数据项，在这里可以指定普通字段以及文件字段：

对于文件字段而言，
- 键名应当匹配控制器方法里标注有`@RequestParam`注释的方法形参名称；
- 值则指向本地计算机上的实际文件路径，点击右侧的选择按钮即可浏览选取要上传的文件[^1]。

{
    "key": "file", 
    "value": "<selected file path>", 
    "type": "file"
}

针对非文件类型的其他输入框，则按照常规方式填写对应的字符串或其他基本类型的数据作为其值[^3]。

#### Spring Boot服务端设置

假设存在如下所示的一个简单的RESTful API接口定义，它接受客户端提交上来的图片资源以及其他附加信息：

@PostMapping("/uploadFile")
public ResponseEntity<String> uploadFile(
        @RequestParam("description") String description,
        @RequestParam("file") MultipartFile file) {
    
    // 处理逻辑...
    
    return ResponseEntity.ok("Success");
}

上述代码片段展示了如何利用`MultipartFile`对象代表待保存至服务器磁盘或数据库中的二进制流；而描述性的文本消息则是普通的String类型变量。

当一切准备就绪之后就可以发起调用了——只需按下Send按钮观察响应状态码及返回的消息体内容便知操作是否成功完成。

@RequestParam在postman中是怎么传递的

### 如何在 Postman 中传递 `@RequestParam` 参数

#### 使用 GET 方法传递单个参数
当使用GET方法时，在URL中直接附加查询字符串来传递参数。例如，对于一个简单的获取用户信息的操作：

假设有一个API端点 `/api/user/getUserInfo` 需要传入用户的ID作为请求参数，则可以在Postman中的地址栏输入如下形式的URL并发送请求：

http://localhost:8080/api/user/getUserInfo?id=12345

这里 `id` 就是一个通过 `@RequestParam` 接收的参数[^1]。

#### 使用 POST 或其他HTTP动词传递多个简单类型的参数
对于POST或者其他非幂等性的操作来说，可以通过表单数据的形式提交多组键值对给服务器处理。比如有这样一个创建订单的服务接口 `/order/createOrder`, 它接受两个整数型商品数量和价格以及一个布尔标志位表示是否立即支付:

此时可以设置Postman为form-data模式，并依次添加三行记录分别代表这三个变量名及其对应的期望值:
| Key | Value |
| --- | ----- |
| quantity | 7 |
| price | 99.99|
| payNow | true |

这些都会被Spring框架识别并通过相应的控制器方法内的形参捕获到。

#### 处理复杂对象或集合类参数
针对更复杂的场景如上传文件或是接收一系列同类型项组成的列表，应当采用不同的策略。以接收一组编号为例，如果希望客户端能够一次性提供若干条目构成的一维数组或者列表结构化信息的话，那么就可以利用逗号分隔符连接各个成员形成单一串流再由后台解析重组为目标容器实例；或者是重复定义相同的key多次携带不同value的方式实现同样的效果[^4]:

http://localhost:18081/api/content/queryNewMoviePath?ids=1&ids=2

另外值得注意的是，如果是涉及到JSON格式实体体序列化的场合下（即整个消息体内封装了一个完整的业务逻辑单元），则应该选用 `@RequestBody` 来标注目标属性而非本话题讨论范围内的 `@RequestParam` [^2].

#### 文件上传案例
最后来看一下有关于文件上载的情况。为了使服务端能正常接收到从前台发出的大容量二进制资料包，通常会在前端构建multipart/form-data编码方式下的HTML控件以便选取本地磁盘上的资源文件路径，与此同时配合Java平台特有的 `MultipartFile` 类型完成实际读写动作。具体来讲就是像下面这样声明处理器函数签名[^3]:

@PostMapping("/uploadFile")
public ResponseEntity<String> handleFileUpload(@RequestParam("file") MultipartFile file){
    ...
}