@RequestParam和@PutMapping

### 请求映射注解解析

在Spring Boot应用程序中，`@RequestParam` 和 `@PutMapping` 是用于处理HTTP请求的不同类型的注解。

#### @RequestParam 注解详解

`@RequestParam` 主要用来获取GET或POST请求中的参数。此注解可以应用于方法参数，以便将特定的URL查询字符串参数绑定到该参数上。当客户端发送带有查询参数的请求时，这些参数可以通过`@RequestParam`捕获并传递给控制器的方法[^3]。

@GetMapping("/search")
public String searchUser(@RequestParam("name") String userName) {
    // 处理逻辑...
}

在这个例子中，如果访问路径为 `/search?name=JohnDoe` ，那么`userName`变量将会被赋值为 `"JohnDoe"`。

#### @PutMapping 注解详解

另一方面，`@PutMapping` 则是用来指定一个处理器方法仅响应PUT HTTP请求。通常情况下，它会与RESTful API一起工作，在更新资源的时候非常有用。通过定义具体的URI模板模式，可以让服务器知道哪个端点应该接收这种类型的请求[^2]。

@PutMapping("/update/{id}")
public ResponseEntity<String> updateUser(
        @PathVariable("id") Long userId,
        @RequestBody User updatedUserDetails){
    userService.updateUser(userId,updatedUserDetails);
    return new ResponseEntity<>("User has been updated successfully.", HttpStatus.OK);
}

这里展示了如何利用 PUT 方法来更新具有特定 ID 的用户记录。请注意，除了`@PutMapping`外，还使用了`@PathVariable`和`@RequestBody`两个辅助性的注解分别用于提取 URL 中的部分以及读取请求体的内容。

#### 关键差异对比

- **目的不同**: `@RequestParam`主要用于从URL中抓取查询参数；而`@PutMapping`则是为了限定某个方法只接受PUT方式的数据提交。
- **适用场景有别**: 前者常出现在表单提交、搜索框输入等场合下作为数据源；后者更多关联于CRUD操作里的修改动作。
- **默认行为相异**: 如果不提供任何额外配置，默认情况下`@RequestParam`是可选的（即如果没有传入对应名称的参数也不会报错），但是`@PutMapping`总是期望有一个完整的实体对象存在于请求体内。