方法与语义

这一课你将能做到

1. 说出 GET / POST / PUT / PATCH / DELETE 各自「对资源做什么」，并为本站 /api/tracks、/admin/tracks 一类路径配上正确方法
2. 用自己的话区分安全方法与幂等，并判断「连点两次提交按钮」会不会重复创建数据
3. 用 curl 对同一 URL 发错方法，观察 405 Method Not Allowed，并说出重试策略与方法幂等性的关系

为什么要学

前端把「查列表」写成 fetch(url, { method: 'POST' })、后端只开了 @GetMapping，就会出现「接口文档能看、实际 405」。REST 与主流框架的约定是：URL 点名资源，方法点名动作。方法选错，连锁反应在后面：网关不敢缓存你的 POST、重试机制可能重复下单、爬虫和浏览器预取可能误触副作用——把「扣积分」做成 GET 是真实存在过的生产事故模式。

面试中「GET 和 POST 的区别」几乎是必考题，答「一个获取一个提交」只能及格，答出安全性与幂等性才算懂行。本课对齐 MDN / RFC 9110 的日常语义，不背全书。

先建立图像

方法	人话	幂等？	安全？	典型 body
GET	只读拿资源	是	是	通常无
HEAD	只要头、不要 body	是	是	无
POST	创建资源或触发一次动作	否	否	常有 JSON
PUT	用这份内容整体替换资源	是	否	有
PATCH	改一部分字段	视设计	否	有
DELETE	删掉资源	是	否	常无
OPTIONS	问「允许哪些方法/CORS」	是	是	常无

安全  ≈ 「只读，不改服务器状态」（GET/HEAD/OPTIONS）
幂等  ≈ 「同样请求做 N 次，资源终态和做 1 次一样」

GET 两次     → 还是同一份课表（幂等）
POST 创建两次 → 两条记录（非幂等！）
PUT 替换两次  → 还是同一份内容（幂等）
DELETE 两次   → 第二次常 404，但资源终态仍是「已删除」（视为幂等）

跟着做

步骤 1：把上一课的 Spring Boot 接口补全

在 HelloController 同级加一个演示用的资源控制器（用内存 Map 代替 MySQL，语义与真实 CRUD 一致）：

@RestController
@RequestMapping("/api/notes")
public class NoteController {

    private final Map<Long, String> store = new ConcurrentHashMap<>();
    private final AtomicLong idGen = new AtomicLong();

    @GetMapping                 // 读集合
    public Map<Long, String> list() { return store; }

    @GetMapping("/{id}")        // 读单个
    public ResponseEntity<String> get(@PathVariable Long id) {
        return store.containsKey(id)
            ? ResponseEntity.ok(store.get(id))
            : ResponseEntity.notFound().build();
    }

    @PostMapping                // 创建
    public ResponseEntity<Long> create(@RequestBody String content) {
        Long id = idGen.incrementAndGet();
        store.put(id, content);
        return ResponseEntity.created(URI.create("/api/notes/" + id)).body(id);
    }

    @PutMapping("/{id}")        // 整体替换
    public String replace(@PathVariable Long id, @RequestBody String content) {
        store.put(id, content);
        return "replaced";
    }

    @DeleteMapping("/{id}")     // 删除
    public ResponseEntity<Void> remove(@PathVariable Long id) {
        store.remove(id);
        return ResponseEntity.noContent().build();
    }
}