spring中 HTTP 请求常见格式

Spring MVC（或 Spring Boot）中，处理 HTTP 请求（如 POST、GET、DELETE、PUT 等）时，可以使用不同的注解来绑定请求中的数据到控制器方法的参数上。

@RestController
@RequestMapping("/api/users")
public class UserController {

    // GET /api/users
    @GetMapping
    public List<User> getAllUsers() {
        // 返回所有用户
    }

    // GET /api/users/123
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        // 根据 ID 查询
    }

    // POST /api/users
    @PostMapping
    public User createUser(@RequestBody User user) {
        // 保存新用户，返回带 ID 的对象
    }

    // PUT /api/users/123
    @PutMapping("/{id}")
    public User updateUser(@PathVariable Long id, @RequestBody User user) {
        // 全量更新用户
    }

    // PATCH /api/users/123
    @PatchMapping("/{id}")
    public User patchUser(@PathVariable Long id, @RequestBody Map<String, Object> updates) {
        // 部分更新（如只改 email）
    }

    // DELETE /api/users/123
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        // 删除用户
        return ResponseEntity.noContent().build(); // 204
    }

    // GET /api/users?username=alice
    @GetMapping(params = {"username"}) // 可选：限定必须带 username
    public List<User> searchByUsername(@RequestParam String username) {
        // 按用户名模糊查询
    }
}

方法参数不写注解默认是@RequestParam