第一个 Spring Boot 应用：创建一个简单的 RESTful API！

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

前言 📜

大家好！你是否刚刚接触 Spring Boot，或者听说过它是开发现代 Java Web 应用的利器，但一直没有踏出第一步呢？别担心！今天，我们来一步步构建一个简单的 Spring Boot 应用，创建一个 RESTful API 接口，并且启动应用访问它。这篇文章绝对适合刚刚接触 Spring Boot 的小伙伴们，当然，即使你已经有了一些基础，也能在其中找到一些有用的提示哦！

Spring Boot 是一个基于 Spring 框架的快速开发框架，能帮助我们快速构建独立的、生产级别的应用，免去了大量繁琐的配置。在这个教程中，我们将用 Spring Boot 快速搭建一个简单的 RESTful API，让你轻松入门。

🛠️ 1. 准备工作

首先，在开始编码之前，我们需要确保一些基础工作做好了。你需要安装以下工具：

1. Java 8 或更高版本：Spring Boot 是基于 Java 开发的，所以需要安装 JDK。
2. IDE：建议使用 IntelliJ IDEA、Eclipse 或 Visual Studio Code，这些 IDE 对 Spring Boot 项目的支持都非常好。
3. Maven 或 Gradle：这些构建工具帮助我们管理项目依赖，Spring Boot 官方推荐 Maven。
4. Postman 或浏览器：我们将在应用启动后测试我们的 API。

如果你还没有安装这些工具，可以参考相关的文档进行安装。安装好后，我们就可以开始啦！

🔧 2. 创建 Spring Boot 项目

首先，我们要通过 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 文件并解压。

然后，你可以使用你喜欢的 IDE 打开这个项目。

🖥️ 3. 编写代码：创建 RESTful API

在创建的 Spring Boot 项目中，我们需要创建一个控制器（Controller），这个控制器会提供我们的 RESTful API 接口。我们将在 src/main/java/com/example/demo 目录下创建一个新的 Java 类 HelloController.java。

HelloController.java

package com.example.demo;

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

@RestController
@RequestMapping("/api")
public class HelloController {

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

在这个代码中，我们做了几件事：

• 使用了 @RestController 注解，这样 Spring 会自动将这个类的返回值转为 JSON 格式。
• 使用 @RequestMapping("/api") 注解，设置了公共的 URL 路径前缀。
• 定义了一个 GET 请求接口，路径为 /hello，当用户访问时，返回一个字符串 "Hello, Spring Boot!"。

🚀 4. 启动应用

代码编写完后，我们就可以启动应用了。你可以通过运行 DemoApplication.java 这个启动类来启动 Spring Boot 应用。

DemoApplication.java

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);
    }
}

在这个类中，@SpringBootApplication 注解标志着这是一个 Spring Boot 应用的入口，SpringApplication.run 方法会启动应用。

现在，回到 IDE 或命令行中，运行这个类。

通过 IDE 启动：

• 在 IDE 中点击运行按钮，选择 DemoApplication.java 作为启动类。

通过命令行启动：

• 打开终端，导航到项目根目录，运行以下命令：

  mvn spring-boot:run
  

🌐 5. 访问接口

一切顺利的话，应用现在已经启动了！默认情况下，Spring Boot 会在本地的 8080 端口上运行。现在，我们可以用浏览器或者 Postman 来访问我们的 RESTful API。

打开浏览器，输入以下 URL：

http://localhost:8080/api/hello

如果一切正常，你应该能看到页面显示：

Hello, Spring Boot!

如果你使用 Postman，发送一个 GET 请求到 http://localhost:8080/api/hello，同样会得到这个响应。

🏁 6. 总结

恭喜你！你已经成功创建了一个简单的 Spring Boot 应用，并且实现了一个基本的 RESTful API 接口。通过这个简单的示例，你不仅学会了如何使用 Spring Boot 创建一个 RESTful 服务，还了解了 Spring Boot 的基本结构和如何快速启动一个 Web 应用。

当然，这只是一个入门级的示例，Spring Boot 功能非常强大，未来你可以通过添加数据库支持、用户认证、异常处理等功能，进一步扩展和优化这个应用。

希望你在这篇文章中找到了乐趣并获得了新的知识！现在，是时候开始更多的 Spring Boot 探险啦！🎉

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-