当前位置：首页 > article >正文

八、Spring Boot：RESTful API 应用

article 2025/2/27 7:56:24

创建第一个 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!"。