创建第一个 SpringBoot 应用-零基础体验开箱即用的神奇魅力

创建第一个 SpringBoot 应用 - 零基础体验开箱即用的神奇魅力

摘要

创建第一个 SpringBoot 应用 - 零基础体验开箱即用的神奇魅力，从项目创建到 API 访问的完整实战指南，让小白也能快速上手企业级 Java 开发框架

适用水平

小白（零基础） - 无需任何 SpringBoot 经验，只需要基本的 Java 语法知识

学习目标

体验 SpringBoot 的 "开箱即用" 特性，感受企业级框架的便捷与强大

目录

• 1. 访问 Spring Initializr 创建项目
• 2. 导入项目到 IDE
• 3. ️ 编写简单的 @RestController
• 4. 运行应用并访问 API
• 5. 总结与鼓励

1. 访问 Spring Initializr 创建项目

什么是 Spring Initializr？

Spring Initializr 就像是一个 "项目工厂" ，它能够根据你的需求自动生成一个完整的 SpringBoot 项目骨架。想象一下，你只需要告诉工厂你想要什么，它就能给你一个现成的、可以直接使用的项目！

具体操作步骤

1. 打开浏览器，访问 start.spring.io/

2. 配置项目基本信息：

   • Project：选择 Maven Project（Maven 是 Java 项目的依赖管理工具）
   • Language：选择 Java
   • Spring Boot：选择最新的稳定版本（目前是 3.x 系列）
   • Project Metadata：
     • Group：输入 com.example（这就像你的公司域名）
     • Artifact：输入 my-first-springboot（这是你的项目名称）

3. 添加依赖：

   • 点击 Add Dependencies 按钮
   • 搜索并添加 Spring Web 依赖（这个依赖包含了创建 Web API 所需的所有组件）

4. 生成项目：

   • 确认所有信息无误后，点击 Generate 按钮
   • 下载生成的项目压缩包

2. 导入项目到 IDE

什么是 IDE？

IDE（Integrated Development Environment，集成开发环境）就像是程序员的 "工作台" ️，它集成了代码编辑、调试、运行等多种功能，让开发变得更加高效。

推荐 IDE

• IntelliJ IDEA（推荐）：功能强大，对 SpringBoot 支持最好
• Eclipse：免费开源，适合初学者
• VS Code：轻量级，适合简单项目

导入步骤

1. 解压项目：将下载的压缩包解压到你的工作目录
2. 打开 IDE：启动你选择的 IDE
3. 导入项目：
   • IntelliJ IDEA：选择 Open → 选择项目文件夹
   • Eclipse：选择 Import → Existing Maven Projects

3. ️ 编写简单的 @RestController

什么是 @RestController？

@RestController 就像是 Web 应用的 "接待员" ‍，它负责接收来自浏览器的请求，处理业务逻辑，然后返回响应给用户。

创建控制器类

在 src/main/java/com/example/myfirstspringboot 目录下创建 HelloController.java 文件：

package com.example.myfirstspringboot;

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

/**
 * Hello 控制器 - 处理问候相关的请求
 * @RestController 注解表示这是一个 REST 风格的控制器
 */
@RestController
@RequestMapping("/api")  // 基础路径为 /api
public class HelloController {

    /**
     * 处理 GET 请求 /api/hello
     * @GetMapping 注解表示这个方法处理 GET 请求
     * @return 返回问候信息
     */
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, SpringBoot! 欢迎来到 Java 企业级开发的世界！";
    }

    /**
     * 处理 GET 请求 /api/info
     * 返回项目信息
     */
    @GetMapping("/info")
    public String getInfo() {
        return "这是一个使用 SpringBoot 创建的 Web 应用！";
    }
}

代码解析

4. 运行应用并访问 API

运行应用

1. 找到主类：在 src/main/java 目录下找到 MyFirstSpringbootApplication.java（主类名称可能略有不同）

2. 运行应用：

   • IntelliJ IDEA：右键点击主类 → 选择 Run 'MyFirstSpringbootApplication'
   • Eclipse：右键点击主类 → 选择 Run As → Java Application

3. 观察控制台输出：

   Started MyFirstSpringbootApplication in 2.456 seconds (JVM running for 3.123)
   

   看到类似输出说明应用启动成功！

访问 API

应用启动后，打开浏览器访问以下地址：

• 问候接口：http://localhost:8080/api/hello
• 信息接口：http://localhost:8080/api/info

预期结果

访问 http://localhost:8080/api/hello 时，浏览器应该显示：

Hello, SpringBoot! 欢迎来到 Java 企业级开发的世界！

5. 总结与鼓励

核心收获

通过这个简单的实践，你已经成功：

1. 体验了 SpringBoot 的"开箱即用"特性 - 无需复杂配置，直接运行
2. 创建了第一个 Web API - 学会了使用 @RestController 注解
3. 理解了 REST 风格的服务 - 通过 HTTP 请求获取数据
4. 掌握了基本的项目结构 - 了解了 SpringBoot 项目的组织方式

技术亮点

• 零配置启动：SpringBoot 自动配置了 Web 服务器（Tomcat）
• 注解驱动：通过简单的注解就能创建功能完整的 Web 服务
• 热部署支持：修改代码后可以快速重启应用
• 企业级特性：内置了日志、监控、健康检查等功能

鼓励与展望

恭喜你！ 你已经成功踏入了 SpringBoot 的世界！虽然这只是一个简单的开始，但你已经体验到了企业级 Java 开发的魅力。

SpringBoot 就像是一个 "魔法工具箱" ，里面装满了各种强大的工具。今天你只是打开了工具箱，看到了其中一件工具。随着学习的深入，你会发现更多神奇的功能：

• 数据库集成：轻松连接各种数据库
• 安全认证：快速实现用户登录和权限控制
• 微服务架构：构建分布式系统
• 云原生部署：一键部署到云端

记住：每一个专家都是从零基础开始的。你已经迈出了最重要的一步，接下来就是不断实践和探索。相信用不了多久，你就能成为 SpringBoot 的高手！

继续加油，未来的 Java 架构师！

厦门工学院人工智能创作坊 -- 郑恩赐
2025 年 10 月 11 日