@GetMapping @PutMapping

<think>我们正在讨论SpringBoot中的@GetMapping和@PutMapping注解的用法和区别。根据SpringWebMVC框架，这两个注解都是用于处理HTTP请求的，但分别对应不同的HTTP方法。引用[2]提到：SpringWebFlux是SpringFramework5.0引入的新的响应式web框架。与SpringMVC不同，它不需要servletAPI，是完全异步和非阻塞的，并且通过Reactor项目实现了ReactiveStreams规范。但这里我们讨论的是SpringMVC的注解，它们同样适用于SpringWebFlux（在WebFlux中也有对应的注解）。不过，用户的问题是关于SpringBoot中的注解，而SpringBoot的Web模块默认使用SpringMVC（也可以使用WebFlux）。因此，我们主要基于SpringMVC来解释。@GetMapping和@PutMapping都是SpringMVC中用于映射HTTP请求的注解，它们是从Spring4.3版本开始引入的，作为@RequestMapping的变体，具有更明确的语义。1.@GetMapping:-用于处理HTTPGET请求。-通常用于获取资源，不应该改变服务器状态（幂等操作）。-示例：获取用户信息、显示页面等。2.@PutMapping:-用于处理HTTPPUT请求。-通常用于更新整个资源（替换现有资源），或者当资源不存在时创建资源（根据实现而定）。PUT操作是幂等的。-示例：更新一个用户的全部信息。区别：-HTTP方法不同：GETvsPUT。-用途不同：GET用于读取，PUT用于更新（或创建）。-安全性：GET是安全的（不改变资源状态），PUT是不安全的（会改变资源状态）但幂等。示例代码：使用@GetMapping：```java@RestControllerpublicclassMyController{@GetMapping("/users/{id}")publicUsergetUser(@PathVariableLongid){//从数据库或其他数据源获取用户returnuserService.findUserById(id);}}```使用@PutMapping：```java@RestControllerpublicclassMyController{@PutMapping("/users/{id}")publicUserupdateUser(@PathVariableLongid,@RequestBodyUseruser){//更新用户信息returnuserService.updateUser(id,user);}}```注意：在RESTful架构中，我们通常这样设计：-GET/users/{id}->获取指定id的用户-PUT/users/{id}->更新指定id的用户（请求体中包含完整的用户信息）另外，@GetMapping和@PutMapping都是组合注解，它们内部使用了@RequestMapping并指定了method属性。例如，@GetMapping等同于@RequestMapping(method=RequestMethod.GET)。引用[3]中提到了SpringBoot和SpringCloud在微服务架构中的应用，这些注解在微服务中也是常用的。引用[1]和[4]与当前问题关联不大，因此不直接使用。根据以上，我们生成相关问题：1.@PostMapping和@DeleteMapping的用法是什么？2.在RESTfulAPI设计中，除了GET和PUT，还有哪些常用的HTTP方法？3.SpringMVC中如何处理路径变量（@PathVariable）？4.在SpringBoot中，如何全局处理不同HTTP方法的异常？</think>### Spring Boot中@GetMapping与@PutMapping的用法与区别 #### 1. **基础定义** - **`@GetMapping`** 处理HTTP **GET**请求，用于**获取资源**。 特点： - 幂等操作（多次请求结果相同） - 请求参数通过URL传递（如`/users?id=1`） - 不应修改服务器状态（只读操作） 示例： ```java @GetMapping("/users/{id}") public User getUser(@PathVariable Long id) { return userService.findById(id); // 查询用户信息 } ``` - **`@PutMapping`** 处理HTTP **PUT**请求，用于**完整更新资源**。 特点： - 幂等操作（多次更新结果一致） - 请求参数通过请求体（Body）传递 - 需提供资源的完整新状态（替换旧资源） 示例： ```java @PutMapping("/users/{id}") public User updateUser(@PathVariable Long id, @RequestBody User user) { return userService.update(id, user); // 替换整个用户对象 } ``` --- #### 2. **核心区别** | **特性** | `@GetMapping` | `@PutMapping` | |-------------------|----------------------------------------|----------------------------------------| | **HTTP方法** | GET | PUT | | **语义** | 读取数据（安全操作） | 替换资源（非安全操作） | | **参数传递** | URL路径或查询参数（`@RequestParam`） | 请求体（`@RequestBody`） | | **幂等性** | 是 | 是 | | **请求体使用** | 通常无请求体 | 必须有请求体（JSON/XML等） | | **典型场景** | 查询数据、加载页面 | 更新整个资源（如用户配置全量覆盖） | --- #### 3. **设计规范与注意事项** - **RESTful原则** - `GET`：对应数据库的`SELECT`操作 - `PUT`：对应`UPDATE`操作（全量替换） > 例如更新用户信息： > `PUT /users/1` 需提交完整的用户JSON，未提供的字段会被置为`null`。 - **安全性** - `@GetMapping`不应修改数据（违反REST约束）[^2] - `@PutMapping`需验证权限（防止未授权覆盖资源）[^3] - **与`@PatchMapping`的区别** `@PutMapping`更新**整个资源**，而`@PatchMapping`仅更新**部分字段**（部分更新）。 --- #### 4. **实际应用场景** 1. **`@GetMapping`用例** - 分页查询：`GET /products?page=1&size=10` - 下载文件：`GET /files/{filename}` ```java @GetMapping(value = "/files/{name}", produces = MediaType.APPLICATION_OCTET_STREAM_VALUE) public byte[] downloadFile(@PathVariable String name) { ... } ``` 2. **`@PutMapping`用例** - 替换配置：`PUT /settings`（提交完整配置JSON） - 重置资源状态：`PUT /orders/{id}/cancel` ```java @PutMapping("/orders/{id}/cancel") public Order cancelOrder(@PathVariable Long id) { return orderService.cancelOrder(id); // 将订单状态更新为"已取消" } ``` --- #### 5. **常见错误** - **误用`GET`修改数据** ```java // 错误！GET不应修改状态 @GetMapping("/users/delete/{id}") public void deleteUser(@PathVariable Long id) { ... } // 应改用@DeleteMapping ``` - **`PUT`未提供完整资源** ```java // 错误！PUT需提交完整对象 @PutMapping("/users/{id}") public void updateName(@PathVariable Long id, @RequestParam String name) { ... } // 应改用@PatchMapping或提交完整User对象 ``` ---