Spring 快速入门指南
您将构建什么
您将构建一个经典的“Hello World!”端点,任何浏览器都可以连接。您甚至可以告诉它您的名字,它会以更友好的方式回应。您需要什么
集成开发环境 (IDE)
流行的选择包括 IntelliJ IDEA、安装了 Spring Boot 扩展包的 Visual Studio Code,或者安装了 Spring Tools 的 Eclipse 等等。
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
的 String 参数,然后将此参数与代码中的单词 "Hello"
结合。这意味着如果您在请求中将名称设置为 "Amy"
,响应将是“Hello Amy”。
@RestController
注解告诉 Spring 这段代码描述了一个应该通过 Web 提供的端点。@GetMapping(“/hello”)
告诉 Spring 使用我们的 hello()
方法来响应发送到 http://localhost:8080/hello
地址的请求。最后,@RequestParam
告诉 Spring 期望请求中包含一个 name
值,如果不存在,则默认使用单词 "World"
。
步骤 3:试用它
让我们构建并运行程序。打开命令行(或终端),导航到存放项目文件的文件夹。我们可以通过执行以下命令来构建并运行应用程序
MacOS/Linux
./gradlew bootRun
Windows
.\gradlew.bat bootRun
您应该会看到与此非常相似的输出
最后几行输出告诉我们 Spring 已经启动。Spring Boot 内嵌的 Apache Tomcat 服务器充当 Web 服务器,监听 localhost
的 8080
端口上的请求。打开您的浏览器,在顶部的地址栏中输入 http://localhost:8080/hello
。您应该会得到一个友好的回应,如下所示
小测验
如果您在 URL 的末尾添加 ?name=Amy
,会发生什么?
接下来,尝试这些热门指南
您已经看到了 Spring 可以有多简单,但它也非常灵活。您可以使用 Spring 完成数千种事情,我们提供了大量指南来引导您了解最流行的选择。为什么不继续学习并尝试这些额外的指南之一呢?
调用 RESTful Web 服务
RestTemplate
获取网页数据。