構建 Postman 克隆：新增 PUT、PATCH 和 DELETE

在Tim Corey的影片"PUT, PATCH和DELETE：建構Postman Clone課程"中，我們繼續學習如何處理剩餘的HTTP動詞來建構一個Postman clone。 在前一節課中，我們實現了POST命令以及GET請求。 本課重點在PUT、PATCH和DELETE，完成我們自己的Postman風格API客戶端的基本功能。 遵循Tim的指導讓我們更加了解API的運作方式以及開發人員如何在程式中與其互動。

Tim從介紹新功能開始課程，說明這是完整課程的第八課。 他強調，雖然這個專案對初學者友好，並可作為作品集的範例，但重要的是要使您的作品獨特，而不是直接複製程式碼。

更新應用中的下拉選單和選項

Tim先展示了應用的設置。目前，下拉選單允許選擇GET和POST。為了構建一個功能完整的Postman clone，我們需要將PUT、PATCH和DELETE加入選項列表。

在屬性中，Tim更新了下拉選單項目，使所有五個HTTP動詞作為選擇顯示：GET、POST、PUT、PATCH、DELETE。 他強調，下拉選單的選擇必須與後端中使用的Enum匹配，該Enum定義了API客戶端的有效HTTP操作。 這可以確保當使用者從下拉選單中選擇一個選項時，該過程能將其正確映射到底層程式碼邏輯。

將使用者選擇映射到HTTP操作

Tim解釋了應用如何將使用者在下拉選單中的選擇轉換為具體的HTTP請求方法。 系統首先驗證輸入框中輸入的URL，然後將所選選擇解析為純JavaScript中的HTTP操作。

這個設置允許應用將三個關鍵資訊傳遞給CallApiAsync方法：

1. 來自輸入框的URL。

2. 通過形式JavaScript區域或JSON文字編輯器輸入的正文內容，通常為JSON。

3. 與HTTP動詞對應的所選操作。

這確保Postman clone能夠處理不同型別的請求，並在HTML響應部分顯示正確的響應JavaScript。

實現PUT、PATCH和DELETE方法

Tim演示了處理PUT、PATCH和DELETE所需的程式碼：

• PUT：更新整個記錄。 API客戶端發送一個完整的JSON物件，覆蓋給定ID的所有字段。

• PATCH：僅更新特定字段。 這在您想修改記錄的一部分而不影響其他資料時很有用。

• DELETE：完全刪除一條記錄。 它只需要URL和ID； 不發送內容。

Tim指出，DELETE略有不同，因為它不返回內容——只是一個成功確認。 這些變更完全用純JavaScript實現，修改CallApiAsync方法來處理所有選項和操作。

測試功能

Tim強調驗證每個HTTP方法是否如預期運行的重要性。

1. GET：Tim選擇GET並抓取文章。 API客戶端返回正確的響應JavaScript，在HTML響應部分顯示資料。

2. PUT (5:01)：對於PUT，Tim用ID、標題、正文和使用者ID更新整個記錄。 他展示了返回的JSON與提交的資料匹配，證明過程正常運行。

3. PATCH (6:10)：Tim演示通過僅更新記錄的標題來進行PATCH。 Postman clone保留其他字段不變，證明其能有效處理部分更新。

4. DELETE (7:32)：DELETE只需要記錄ID。 Tim運行請求並通過空括號確認成功，表明記錄已刪除且未返回不必要的資料。

通過這個過程，Tim展示了Postman clone如何執行所有CRUD操作：建立(POST)、讀取(GET)、更新(PUT/PATCH)、刪除(DELETE)。

變更和設置摘要

Tim總結了增強API客戶端所需的關鍵步驟和程式碼更改：

• 更新下拉選單以包含所有HTTP動詞(選項)。

• 確保後端的Enum匹配每個動詞以便選擇能正確映射到方法。

• 修改JavaScript中的CallApiAsync方法以處理其他動詞並適當處理資料。

他指出一個可選的增強：對於DELETE，您可以返回簡單的成功消息而不是序列化輸出，流線化使用者體驗。

Postman Clone的當前狀態和功能

此時，Postman clone具有所有五個HTTP動詞的完整功能。 使用者可以輸入URL，通過形式JavaScript編輯器提交JSON資料，並在響應HTML顯示中接收響應。

然而，Tim指出了一些可以增強應用的額外功能：

• 支持XML請求。

• 處理身份驗證。

• 新增自定義標頭。

這些是開發者擴展clone並使其更具多樣性的機會。

Tim對增強您自己的Postman的建議

Tim挑戰觀眾繼續構建和改進他們的Postman clone：

• 使用WPF、Blazor或普通HTML/JavaScript等框架新增Web使用者介面。

• 包括其他API並處理不同的資料格式。

• 測試下拉選單中的不同選項並擴展功能以獲得更豐富的功能。

• 在GitHub上分享您的項目以向潛在雇主展示程式碼庫、程式碼和過程。

他強調實踐是關鍵：構建、測試和調整您的項目有助於您深入了解API和編程概念。

結論

Tim在影片結束時鼓勵實驗。 他喜歡修補測試應用並強調開發者能在反覆迭代中改善。

雖然該系列的GitHub程式碼尚未立即提供，但將來可能會在Dev Pass中提供。 目前的目標是讓學習者從頭構建他們自己的Postman Clone，練習設置、過程和程式碼實施，並使專案具獨特性。

通過遵循Tim的方法，開發人員可以建立一個功能性API客戶端，了解HTTP方法，並製作一個顯示實用技能的作品集項目，展示形式HTML、響應JavaScript和JSON處理。