如何在30分钟内用Java编写REST API：初学者指南

如何在30分钟内用Java编写REST API：初学者指南

创建REST API是现代开发者的关键技能之一。如果你刚开始学习Java，并希望快速创建自己的第一个Web服务，本指南就是为你准备的。我们将从安装工具开始，一直到创建一个可在浏览器或Postman中测试的可用API。整个过程不超过30分钟。

在本文中，我们将使用Spring Boot——最流行的Java Web应用程序框架。它负责处理所有繁琐的配置，让你专注于业务逻辑。最终，你将获得一个用于管理任务列表（Todo List）的简单API。

什么是REST API，为什么需要它？

REST（Representational State Transfer）是一种用于构建Web服务的架构风格。REST API基于HTTP协议运行，并使用标准方法：

• GET — 获取数据
• POST — 创建新记录
• PUT — 更新现有记录
• DELETE — 删除记录

数据通常以JSON格式传输。REST API被广泛应用于从移动应用到微服务架构的各个领域。掌握它后，你将能够为任何客户端创建后端服务。

步骤1：环境准备

我们需要三样东西。请确保它们已安装在你的计算机上。

1.1. JDK（Java开发工具包）

从Oracle官方网站下载并安装JDK 17或更高版本，或者使用OpenJDK。在终端中使用以下命令检查安装：

java -version

1.2. IntelliJ IDEA（社区版）

这是一款免费的开发环境，非常适合Java开发。请从官方网站下载。

1.3. Postman（可选）

用于测试API的工具。可以从postman.com下载。初期也可以使用浏览器代替。

步骤2：创建Spring Boot项目

最快的方法是使用Spring Initializr。这是一个Web工具，可以生成项目模板。

1. 访问 start.spring.io。
2. 选择：Project: Maven，Language: Java，Spring Boot: 3.x.x。
3. 在Group字段中输入com.example，在Artifact字段中输入todoapi。
4. 点击Add Dependencies并添加Spring Web。
5. 点击Generate — 将下载一个包含项目的ZIP压缩包。
6. 解压压缩包，并在IntelliJ IDEA中打开该文件夹。

项目结构如下：

• src/main/java/com/example/todoapi/ — 主要代码
• src/main/resources/application.properties — 配置文件
• pom.xml — Maven构建文件

步骤3：创建数据模型和控制器

现在我们来编写代码。首先创建一个简单的模型——TodoItem类。

3.1. 模型类

在包com.example.todoapi中创建一个新的Java类，命名为TodoItem.java：

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // 默认构造函数    public TodoItem() {}

    // 带参数的构造函数    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // Getter和Setter方法    public L