Spring MVC 与 REST

这一课你将能做到

1. 独立实现一套 RESTful 任务 CRUD 接口（列表 / 详情 / 新增 / 修改 / 删除），并用 curl 全流程验证
2. 正确使用 @PathVariable、@RequestParam、@RequestBody 三种参数接收方式，并说清各自对应的 HTTP 位置
3. 用 ResponseEntity 精确控制状态码（201/204/404），并落地一套统一响应结构

为什么要学

前端页面、小程序、App、第三方系统，全部通过 HTTP 接口消费你的后端能力。Spring MVC 就是把「一个 Java 方法」变成「一个 HTTP 接口」的翻译官：URL 映射到方法、JSON 自动转对象、对象自动转 JSON。本站前端的每次点击，背后都打到这样一组接口上。

REST 是目前最主流的接口设计风格：用 URL 表示资源，用 HTTP 方法表示动作——GET /api/tasks 是查列表，DELETE /api/tasks/5 是删 5 号任务。看 URL 就知道在操作什么，这套「动词 + 名词」的默契，是你和前端协作的共同语言。

先建立图像

一个 POST 请求的完整旅程：

POST /api/tasks  body: {"title":"学习AOP","priority":2}
   ↓
内嵌 Tomcat 接收，交给 DispatcherServlet（前端控制器，MVC 的总调度）
   ↓
HandlerMapping：根据 URL + HTTP 方法找到 TaskController.create()
   ↓
HandlerAdapter：执行方法前完成三件翻译——
   路径变量 → @PathVariable 参数
   查询串   → @RequestParam 参数
   JSON体   → Jackson 反序列化 → @RequestBody 参数
   ↓
你的方法执行，返回 Task 对象
   ↓
Jackson 序列化成 JSON + HTTP 状态码 → 响应给调用方

记住 DispatcherServlet 这个名字：所有请求的总入口，后面排查「为什么映射到这个方法」「参数为什么没绑上」都以它为起点。

HTTP 方法	语义	对应操作
GET	读取，幂等且安全	查列表、查详情
POST	创建非幂等资源	新增
PUT	整体替换，幂等	全量更新
DELETE	删除，幂等	删除

跟着做

步骤 1：领域模型与内存存储

先用内存 Map 代替数据库（第 9、10 课再换成真数据库），保证本课代码零依赖可跑：

package com.example.taskflow.model;

import java.time.LocalDateTime;

public record Task(
        Long id,
        String title,
        int priority,                 // 1 最高
        String status,                // TODO / DOING / DONE
        LocalDateTime createdAt
) {
    public Task withStatus(String newStatus) {
        return new Task(id, title, priority, newStatus, createdAt);
    }
}

package com.example.taskflow.service;

import com.example.taskflow.model.Task;
import org.springframework.stereotype.Service;

import java.time.LocalDateTime;
import java.util.Comparator;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicLong;

@Service
public class TaskService {

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

    public List<Task> list(String status) {
        return store.values().stream()
                .filter(t -> status == null || status.equals(t.status()))
                .sorted(Comparator.comparingInt(Task::priority)
                        .thenComparing(Task::id))
                .toList();
    }

    public Optional<Task> findById(long id) { return Optional.ofNullable(store.get(id)); }

    public Task create(String title, int priority) {
        long id = idGen.incrementAndGet();
        Task task = new Task(id, title, priority, "TODO", LocalDateTime.now());
        store.put(id, task);
        return task;
    }

    public Optional<Task> updateStatus(long id, String status) {
        return Optional.ofNullable(store.computeIfPresent(id,
                (k, old) -> old.withStatus(status)));
    }

    public boolean delete(long id) { return store.remove(id) != null; }
}