八、Spring Boot：RESTful API 应用

创建第一个 Spring Boot RESTful API 应用

在现代 Web 开发中，RESTful API 是一种非常流行的设计风格，它基于 HTTP 协议，提供了简单、灵活的方式来构建网络应用。Spring Boot 作为一款强大的微服务框架，提供了丰富的工具和支持，使得开发 RESTful API 变得更加便捷。本文将详细介绍如何创建第一个 Spring Boot RESTful API 应用，包括创建项目、编写代码、启动项目以及测试 API。

---

1. 创建 Spring Boot 项目

1.1 使用 Spring Initializr 快速生成项目

Spring Initializr 是一个在线工具，可以帮助我们快速生成 Spring Boot 项目的骨架代码。以下是具体步骤：

1. 打开 Spring Initializr。
2. 选择以下配置：
   • Project：Maven Project
   • Language：Java
   • Spring Boot：选择最新版本
   • Project Metadata：
     • Group：com.example
     • Artifact：demo
     • Name：demo
     • Description：Demo project for Spring Boot
     • Package name：com.example.demo
     • Packaging：Jar
     • Java：8 或更高版本
3. 在 Dependencies 中选择：
   • Spring Web（用于构建 RESTful API）
4. 点击 Generate，下载生成的 ZIP 文件并解压。
5. 使用你喜欢的 IDE（如 IntelliJ IDEA 或 Eclipse）打开项目。

---

2. 编写代码：创建 RESTful API

2.1 创建主应用类

在项目中创建一个主应用类，标记为 Spring Boot 应用的入口点。

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

2.2 创建 RESTful 控制器

在 src/main/java/com/example/demo/controller 目录下创建一个新的 Java 类 HelloController.java。

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }
}

2.3 定义 RESTful API

在 HelloController 中，我们定义了一个简单的 RESTful API，使用 @GetMapping 注解将 /hello 路径映射到 sayHello 方法。当用户访问 http://localhost:8080/hello 时，将返回字符串 "Hello, Spring Boot!"。

---

3. 启动项目

3.1 通过 IDE 运行

确保 Maven 依赖已经加载完成，可以在 IntelliJ IDEA 中点击 DemoApplication 类右上角的运行按钮，或者右键选择 “Run ‘DemoApplication.main()’”。

3.2 通过命令行启动

在项目根目录下，使用以下命令启动项目：

./mvnw spring-boot:run

---

4. 测试 API

启动成功后，打开浏览器并访问 http://localhost:8080/hello，你将看到返回的 "Hello, Spring Boot!" 消息。

4.1 使用 Postman 测试

除了浏览器，你还可以使用 Postman 等工具来测试你的 RESTful API。Postman 提供了更强大的功能，如发送不同类型的 HTTP 请求（GET、POST、PUT、DELETE 等）。

---

5. 总结

通过本文，我们详细介绍了如何创建第一个 Spring Boot RESTful API 应用。我们使用了 Spring Initializr 快速生成项目骨架，编写了简单的 RESTful 控制器，并通过 IDE 或命令行启动了项目。最后，我们通过浏览器和 Postman 测试了我们的 API。

希望本文能帮助你快速上手 Spring Boot 和 RESTful API 的开发。如果你有任何问题或需要进一步的帮助，欢迎随时交流！