练习:用 Spring Boot 写一个 REST 待办接口

java基础 › 练习 01 · Spring Boot REST (第 1 章)
文章工具

Java 最常用的实战入口:把「类 + 注解 + HTTP」组合成一个能用的接口。

本练习要实现的模块(示意图)
图:本练习要实现的模块(示意图)

项目目标

用 Spring Boot 起一个服务,提供待办事项的增删改查 REST 接口,用浏览器或 curl 就能验证。

要做的功能

核心功能(必做)

  • 用 start.spring.io 生成工程并启动内嵌 Tomcat。
  • 定义 Todo 实体与 Controller,暴露 GET / POST / PUT / DELETE。
  • 先用内存 List 存数据,实现增删改查。
  • 做参数校验,非法请求返回 400,找不到返回 404。
  • 用 curl 验证每个接口。

进阶功能(选做)

  • 接入 H2 数据库与 JPA 持久化
  • 用 @Valid 做字段校验
  • 写一个接口的单元测试

会练到的知识点

  • 类与对象、接口
  • 注解基础
  • HTTP 方法与状态码
  • JSON 序列化
  • Maven 依赖管理

验收标准

  • 服务能启动、接口可访问
  • 增删改查结果正确
  • 错误路径返回合理状态码

难度与工期

难度:★★☆ · 建议工期:3–5 天 · 适合:学完 Java 基础语法、想上手框架

参考实现(GitHub)

先自己动手实现,卡住了再对照参考;也可以只看它的目录结构,别直接照抄。

spring-guides/gs-rest-service —— 官方「构建 REST 服务」引导项目,几十分钟能跑通第一个接口。

加分项

  • 加分页查询
  • 加统一响应包装类
  • 加 Swagger 文档

建议做法:先把「核心功能」列成本地待办,每完成一项就跑一次;做完再回头看参考实现,对比自己的设计差在哪。

⚠️ 版权声明

本文为免费文章,欢迎转载。转载请注明出处:一木科技(https://www.pingquan.vip/2026/10/14/practice-java-spring/),并保留原文链接。