前言

最近在看接口文档, 和写项目的增删改查时, 老是搞不清楚HTTP 方法、参数传递方式 以及 Spring MVC Controller 层接收参数的常用注解之间的关系( 只是我经常看见的总结一下, 不一定对, 也很不完整哈 ).

一、HTTP 方法与增删改查( RESTful风格常用规范 )

记个口诀就好大概是这样: 增加用POST, 删除用DELETE, 修改用PUT, 查询用GET

二 HTTP 方法与参数传递方式( 只是我经常碰见的我自己总结的 )

HTTP 方法	典型用途	参数传递位置	是否有请求体（Body）
POST	新增数据	请求体（Body）（JSON / Form 表单）	✅ 有
DELETE	删除数据	URL 路径参数 或 查询参数	❌ 通常无
PUT	更新数据	请求体（Body	✅ 有
GET	查询数据	URL查询参数(后面带?key1=value1&key2=value2) 或者路径参数 (/user/{id})	❌ 一般没有（即使有也不被推荐/支持）

三 Spring MVC Controller 接收参数的常用注解与参数传递方式

1. @RequestParam —— 接收 URL查询参数(URL后面带?key1=value1&key2=value2)

• 适用场景：GET 查询参数、POST 表单（application/x-www-form-urlencoded）
• 参数来源：URL 中的 ?name=Tom 或 表单字段

@GetMapping("/search")
public String search(@RequestParam String keyword, 
                     @RequestParam(defaultValue = "1") int page) {
    // 请求: /search?keyword=Java&page=2
}

2. @PathVariable —— 接收 URL 路径中的变量

• 适用场景：RESTful 风格的路径参数
• 参数来源：URL 路径中的 {xxx} 占位符

@GetMapping("/user/{id}")
public User getUser(@PathVariable Long id) {
    // 请求: /user/123 → id = 123
}

// 多个路径变量
@GetMapping("/dept/{deptId}/user/{userId}")
public User getUserInDept(@PathVariable("deptId") Long did,
                          @PathVariable("userId") Long uid) { ... }

3. @RequestBody —— 接收 请求体中的 JSON/XML 数据

• 适用场景：前端发送 JSON（如 Axios、Fetch）
• 参数来源：HTTP 请求体（Body）
• 仅用于 POST/PUT/PATCH

@PostMapping("/user")
public Result save(@RequestBody UserDTO userDTO) {
    // 前端发送 JSON:
    // { "name": "Alice", "email": "alice@example.com" }
}

小白啊！！！写的不好轻喷啊🤯如果觉得写的不好，点个赞吧🤪（批评是我写作的动力）

…。。。。。。。。。。。…

…。。。。。。。。。。。…