Spring 快速入門指南
您將建構的內容
您將建構一個經典的「Hello World!」端點,任何瀏覽器都可以連線。您甚至可以告訴它您的名字,它會以更友善的方式回應。您需要的東西
整合開發環境 (IDE)
熱門選擇包括 IntelliJ IDEA、Spring Tools、Visual Studio Code 或 Eclipse,以及更多。
Java™ 開發套件 (JDK)
我們推薦 BellSoft Liberica JDK 17 版。
步驟 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()
方法來回應傳送到 https://127.0.0.1:8080/hello
位址的請求。最後,@RequestParam
告訴 Spring 預期請求中有名稱值,但如果沒有,則預設會使用字詞 "World"
。
步驟 3: 試試看
讓我們建置並執行程式。開啟命令列 (或終端機) 並導覽至您存放專案檔案的資料夾。我們可以透過發出以下命令來建置並執行應用程式
MacOS/Linux
./gradlew bootRun
Windows
.\gradlew.bat bootRun
您應該會看到一些與此非常相似的輸出
此處最後幾行告訴我們 Spring 已啟動。Spring Boot 的內嵌 Apache Tomcat 伺服器充當 Web 伺服器,並在 localhost
埠 8080
上監聽請求。開啟您的瀏覽器,並在頂端的網址列中輸入 https://127.0.0.1:8080/hello
。您應該會收到像這樣友善的回應
隨堂測驗
如果您在 URL 結尾新增 ?name=Amy
,會發生什麼事?
接下來,試試這些熱門指南
您已經看到 Spring 可以多麼簡單,但它也非常靈活。您可以使用 Spring 完成數千件事,而且我們有許多指南可協助您了解最熱門的選擇。何不繼續學習並試試看這些額外指南之一?