ZH
RU
EN
ES
FR
DE
PT
AR
HI
引言：REST API 比想象中更简单
许多初级开发者认为用Java编写REST API是一项复杂的任务，需要深厚的知识和长时间的工作。实际上，借助Spring Boot等现代工具，你可以在短短30分钟内创建一个完整的RESTful服务。在本文中，我们将通过实践讲解如何使用最少的工具集用Java编写REST API。你将获得一个现成的模板，可以根据自己的项目进行调整。
REST（表述性状态转移）是一种架构风格，允许客户端和服务器通过HTTP交换数据。我们将创建一个用于管理任务列表（To-Do）的简单API。到文章结束时，你将拥有一个能够创建、读取、更新和删除任务（CRUD）的工作服务器。
步骤1：准备环境并创建项目
首先，我们需要以下工具：
- Java开发工具包（JDK） 17或更高版本。
- IntelliJ IDEA（社区版）或任何其他IDE。
- Maven 用于管理依赖。
- Postman 或浏览器用于测试。
使用Spring Initializr（start.spring.io）创建项目。选择以下设置：
- Project: Maven
- Language: Java
- Spring Boot: 3.2.x
- Dependencies: Spring Web, Spring Data JPA, H2 Database
下载ZIP压缩包并解压。在IDE中打开项目。结构将如下所示：
src/ └── main/ ├── java/com/example/restapi/ │ ├── RestapiApplication.java │ ├── controller/ │ ├── model/ │ └── repository/ └── resources/ └── application.properties这是我们开始的基础。准备工作只花了大约2分钟。
步骤2：创建数据模型和仓库
从模型开始。在model文件夹中创建Task.java类。这将是一个表示任务的实体：
package com.example.restapi.model;
import jakarta.persistence.*;
@Entity@Table(name = "tasks")public class Task { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id;
@Column(nullable = false) private String title;
private boolean completed;
// 构造函数 public Task() {}
public Task(String title, boolean completed) { this.title = title; this.completed = completed; }
// Getter和Setter方法 public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public boolean isCompleted() { return completed; } public void setCompleted(boolean completed) { this.completed = completed; }}现在创建仓库。在repository文件夹中创建接口TaskRepository.java：
package com.example.restapi.repository;
import com.example.restapi.model.Task;import org.springframework.data.jpa.repository.JpaRepository;import org.springframework.stereotype.Repository;
@Repositorypublic interface TaskRepository extends JpaRepository<Task, Long> { // JpaRepository已经提供了所有基本的CRUD方法}在这一步，我们描述了数据结构以及与数据库交互的方式。Spring Data JPA会自动在H2中创建表，并提供findAll()、save()、deleteById()等方法。这将节省数小时的手动编码时间。
步骤3：创建带有REST端点的控制器
现在是最有趣的部分——控制器。在controller文件夹中创建TaskController.java类。它将处理HTTP请求：
博客
书籍推荐
推荐阅读
