八、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 项目的骨架代码。以下是具体步骤：

打开 Spring Initializr。
选择以下配置：
- 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 或更高版本
在 Dependencies 中选择：
- Spring Web（用于构建 RESTful API）
点击 Generate，下载生成的 ZIP 文件并解压。
使用你喜欢的 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 的开发。如果你有任何问题或需要进一步的帮助，欢迎随时交流！