Spring 快速入门指南

2024-04-28 22:16| 来源: 网络整理| 查看: 265

本入门指南将会引导你如何从零开始建立一个 Spring 应用，并提供经典的“Hello World!”端点，可供任何浏览器都访问。

环境预备

你需要在本地安装好 Java™ 开发工具包（JDK），以及一个 IDE，如 IntelliJ IDEA、Spring Tools、Visual Studio Code 或 Eclipse。

第 1 步：创建新的 Spring Boot 项目

通过 start.springboot.io 来创建一个“web”项目。在“Dependencies”对话框中搜索并添加 “web”依赖项，如截图所示。点击“Generate”按钮，下载压缩包，并将其解压到电脑上的一个文件夹。

start.springboot.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" 这个词拼接起来。这意味着，如果你在请求中把 name 设为 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 Boot :: (v3.1.1) 2023-07-10T15:12:15.599+08:00 INFO 14360 --- [ main] com.example.demo.DemoApplication : Starting DemoApplication using Java 17 with PID 14360 (C:\Users\KevinBlandy\Downloads\demo\demo\build\classes\java\main started by KevinBlandy in C:\Users\KevinBlandy\Downloads\demo\demo) 2023-07-10T15:12:15.603+08:00 INFO 14360 --- [ main] com.example.demo.DemoApplication : No active profile set, falling back to 1 default profile: "default" 2023-07-10T15:12:16.472+08:00 INFO 14360 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http) 2023-07-10T15:12:16.486+08:00 INFO 14360 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat] 2023-07-10T15:12:16.486+08:00 INFO 14360 --- [ main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/10.1.10] 2023-07-10T15:12:16.600+08:00 INFO 14360 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext 2023-07-10T15:12:16.602+08:00 INFO 14360 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 928 ms 2023-07-10T15:12:16.894+08:00 INFO 14360 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path '' 2023-07-10T15:12:16.901+08:00 INFO 14360 --- [ main] com.example.demo.DemoApplication : Started DemoApplication in 1.727 seconds (process running for 2.049)

最后几行告诉我们，Spring 已经启动。Spring Boot 使用嵌入式的 Apache Tomcat Server 作为 web 服务器，正在监听 localhost 8080 端口的请求。打开你的浏览器，访问 http://localhost:8080/hello 。你应该得到一个如下的响应：

🎉️ 恭喜你，一切OK，应用已经成功运行。现在你可以尝试在请求URL中添加一个查询参数 name（例如：http://localhost:8080/hello?name=Spring），看看是否会输出你期待的内容。

【本文地址】

公司简介

联系我们