iT邦幫忙

2023 iThome 鐵人賽

DAY 3
0
Mobile Development

Spring Boot+Android 30天 實戰開發 系列 第 3

【Day - 03】開始Spring Boot之旅:建立及測試環境

  • 分享至 

  • xImage
  •  

1、引言

本文將引導您進入Spring Boot的世界,演示如何創建一個簡單的Spring Boot應用,並使用Postman進行API測試。在現代應用程式開發中,構建可靠的開發和測試環境非常重要,它可以幫助您更高效地開發、測試和部署應用程式。在這篇文章中,我們將一步步地創建一個Spring Boot專案,然後使用Postman工具來測試我們的應用程式。

本文內容概覽

在本文中,我們將完成以下任務:

  1. 建立簡單的Spring Boot應用程式:我們將使用IntelliJ IDEA內建的Spring Initializer來建立一個全新的Spring Boot專案。這個專案將成為我們的起點,我們將構建一個RESTful Web應用程式。
  2. 使用Postman進行API測試:一旦我們的Spring Boot應用程式準備就緒,我們將介紹如何使用Postman進行API測試。我們將建立GET和POST請求,並確保我們的應用程式按預期運作。
  3. 實用的Postman技巧:在學習如何進行API測試時,我們還將分享一些Postman的實用技巧,包括如何使用環境變數來管理不同環境的請求配置,以及如何使用Postman的測試腳本功能來自動化測試案例的執行。

2、建立簡單的Spring Boot應用

步驟一:使用IntelliJ IDEA內建的Spring Initializer建立新的Spring Boot專案

IntelliJ IDEA是一個強大的整合開發環境,它內建了Spring Initializer,可以幫助我們輕鬆創建和配置Spring Boot項目。以下是創建新項目的步驟:

  1. 開啟IntelliJ IDEA,並選擇"Create New Project"。
  2. 在專案類型選擇視窗中,選擇"Spring Initializer"。
  3. 配置專案的基本設置,包括專案名稱、JDK版本、包名等。這些信息將用於生成專案的配置文件和程式碼結構。
  4. 點擊"Next"繼續。

    !!上圖 紅框是需要特別留意的部分!!

補充!

如果電腦沒有安裝 JDK 17 及以上版本可以使用Intellij IDEA內建的JDK管理器下載,可透過以下步驟:

  1. 在New Project視窗的Spring Initializr下點擊JDK屬性下拉式選單
  2. 選擇"Download JDK..."
  3. 下載您專案所需的JDK版本。

步驟二:設定專案的依賴

在這一步,我們需要添加專案所需的依賴。Spring Initializer允許我們選擇不同的依賴,以構建滿足我們需求的專案。

這裡我們選擇"Spring Web"作為依賴

添加完依賴後,點擊“Create”。

步驟三:建立一個簡單的Spring Boot應用程式

項目創建完畢後,我們將開始編寫一個簡單的Spring Boot應用程式。首先,讓我們創建一個REST Controller類,用於處理HTTP請求。這是一個示例的Controller程式碼:

@RestController
public class HelloWorldController {

    @GetMapping("/hello")
    public String helloWorld() {
        return "Hello, World!";
    }

    @PostMapping("/greet")
    public String greet(@RequestBody String name) {
        return "Hello, " + name + "!";
    }
}

在上面的程式碼中,我們創建了一個HelloWorldController類,它包含了兩個端點(/hello/greet)。/hello端點返回簡單的問候語,而/greet端點接受一個名字並返回個性化的問候。

現在,我們可以啟動我們的Spring Boot應用程式。在IntelliJ IDEA中,右鍵單擊專案資料夾,然後選擇“Run Ironman2023Application”以啟動應用程式。應用程式將在內建的Tomcat伺服器上運行,並監聽默認的埠(通常是8080)。

* 下圖為成功運行在8080埠的Spring Boot應用

下一節我將介紹如何使用Postman對我們創建的這兩個API端點進行測試。

3、使用 Postman 進行 API 測試

步驟一:建立一個新的 Postman 集合,用於組織測試請求

Postman 是一個流行的 API 測試工具,它允許您輕鬆創建和發送 HTTP 請求,並查看響應。首先,讓我們建立一個新的 Postman 集合,以便組織我們的測試請求。

  1. 開啟 Postman。
  2. 在左側導航欄中,選擇“Collections”。
  3. 點擊“+”按鈕 創建一個新的集合,然後為其命名。
  4. 點擊"Add a request"新增一個新的請求

步驟二:創建和發送 GET 和 POST 請求以測試 Spring Boot 應用

現在,我們將創建一些測試案例,並使用 Postman 來測試我們的 Spring Boot 應用程式。

  1. 測試[GET]請求的/hello端點
  2. 測試[POST]請求的/greet端點

介紹Postman的幾個實用小技巧

在使用Postman時,還有一些實用的功能和技巧:

  • 環境變數: Postman允許您設定和管理環境變數,以便在不同環境之間共享請求配置。這對於管理不同的伺服器或配置文件非常有用,以下是一個簡單的示例步驟:

    1. 添加環境變量
    2. 重新命名你的環境名稱
    3. 新增一個"base_url"環境變量,並設置初始值
    4. 按下"Ctrl+S"(這個很重要!!如果沒有儲存將無法使用這個環境變量)
    5. 選擇你的環境名稱
    6. 透過{{環境變量名稱}}這個表達式引入你要的變量,如下圖所示
  • 測試腳本: 您可以使用Postman的測試腳本功能來編寫自動化測試用例。測試腳本是基於JavaScript的,可以在請求發送後自動驗證響應內容。

以上只是一個簡單的小範例,如果想要深入研究可以參考以下連結:

https://learning.postman.com/docs/writing-scripts/intro-to-scripts/

4、總結

通過本文,您已經學會了如何創建一個簡單的Spring Boot應用程式,並使用Postman進行API測試。建立和測試環境對於應用程式開發至關重要,它有助於確保您的應用程式在不同環境中運行正常。

在接下來的文章中,我們將深入探討Spring Boot的更多功能和用法。請繼續關注,準備迎接Spring Boot之旅的下一步!


上一篇
【Day - 02】Spring Boot開發環境工具準備
下一篇
【Day - 04】Spring Boot中常用的參數傳遞方式(上)
系列文
Spring Boot+Android 30天 實戰開發 30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言