Spring 快速入门指南
您将构建什么
您将构建一个经典的“Hello World!”端点,任何浏览器都可以连接到它。您甚至可以告诉它您的名字,它会以更友好的方式回应。您需要什么
集成开发环境 (IDE)
流行的选择包括 IntelliJ IDEA、Visual Studio Code 搭配 Spring Boot 扩展包,或 Eclipse 搭配 Spring Tools,以及更多。
Java™ 开发工具包 (JDK)
我们推荐 BellSoft Liberica JDK 版本 17 或 21。
步骤 1: 启动一个新的 Spring Boot 项目
使用 start.spring.io 创建一个“web”项目。在“Dependencies”对话框中搜索并添加“web”依赖项,如截图所示。点击“Generate”按钮,下载 zip 文件,并将其解压到您计算机上的一个文件夹中。
start.spring.io 创建的项目包含 Spring Boot,这是一个使 Spring 能够在您的应用程序中工作的框架,但无需太多代码或配置。Spring Boot 是启动 Spring 项目最快、最流行的方式。
步骤 2: 添加您的代码
在您的 IDE 中打开项目,找到 src/main/java/com/example/demo 文件夹中的 DemoApplication.java 文件。现在,通过添加下面代码中所示的额外方法和注解来更改文件内容。您可以复制粘贴代码,也可以直接输入。
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
@GetMapping("/hello")
public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
return String.format("Hello %s!", name);
}
}
这就是在 Spring Boot 中创建简单“Hello World”Web 服务所需的所有代码。
我们添加的 hello() 方法旨在接收一个名为 name 的字符串参数,然后将该参数与代码中的单词 "Hello" 结合起来。这意味着如果您在请求中将您的名字设置为 "Amy",响应将是“Hello Amy”。
@RestController 注解告诉 Spring,此代码描述了一个应通过 Web 提供的端点。@GetMapping("/hello") 告诉 Spring 使用我们的 hello() 方法来响应发送到 https://:8080/hello 地址的请求。最后,@RequestParam 告诉 Spring 期望请求中有一个 name 值,但如果不存在,它将默认使用单词 "World"。
步骤 3: 尝试一下
让我们构建并运行程序。打开命令行(或终端),并导航到您项目文件所在的文件夹。我们可以通过发出以下命令来构建和运行应用程序
MacOS/Linux
./gradlew bootRun
Windows
.\gradlew.bat bootRun
您应该会看到非常相似的输出

最后几行告诉我们 Spring 已经启动。Spring Boot 的嵌入式 Apache Tomcat 服务器充当 Web 服务器,正在监听 localhost 端口 8080 上的请求。打开您的浏览器,并在顶部的地址栏中输入 https://:8080/hello。您应该会收到一个友好响应,如下所示

小测验
如果您在 URL 末尾添加 ?name=Amy,会发生什么?
接下来,尝试这些热门指南
您已经看到了 Spring 是多么简单,但它也非常灵活。您可以使用 Spring 做成千上万的事情,我们有许多指南可以引导您完成最流行的选择。为什么不继续学习并尝试以下附加指南呢?