結束 TIM上的 POST 指令深入探討

Tim Corey

26m 16s

當處理API和網路服務時，了解POST命令對於向伺服器發送資料是至關重要的。 在這一課中，Tim Corey帶領我們通過新增POST命令到Postman Clone專案。 Tim解釋了HTTP請求方法之間的差異，並展示如何正確結構化POST請求、處理請求正文，以及在使用者介面（UI）和程式庫程式碼之間分割職責。

如果您希望獲得有關HTTP方法的實戰經驗，本課提供了一個實際範例，說明如何將資料發送到目標資源、管理HTTP標頭，並以清晰、可維護的方式處理響應。 讓我們深入了解Tim的逐步方法。

POST命令介紹

Tim首先回顧前一課的介面更新，指出系統當前僅支持GET請求。 他解釋說，本課著重於啟用POST請求，以便使用者可以將資料發送到伺服器，例如JSON輸出或表單資料。

他強調將UI程式碼與程式庫程式碼分離是關鍵。 UI應管理下拉選單、HTML表單和輸入欄位等元素，而程式庫則負責建立HTTP請求、格式化內容，並將資料發送到伺服器。

Tim還指出，此專案可以作為作品集範例，但開發者需要確保作品集是獨一無二的。 他提到他的Dev Pass timcorey.com是一個深入了解C#和HTTP請求方法的方式。

了解當前設置

在Visual Studio中，Tim展示了當前專案的設置。UI允許選擇請求方法（GET或POST）並輸入URL。 當前，點擊"Go"只執行GET請求，並在結果窗口中顯示響應。

他指出的一個小問題是GET請求後，結果窗口中的所有文字都被高亮顯示，這不太適合顯示資訊。 Tim通過將焦點設置在選項卡元素而非文字框來解決這個問題。 這防止了自動文字選擇，提高了使用者體驗。

讀取下拉選單並確定HTTP動作

為了實現POST命令，Tim首先解釋如何讀取下拉選擇以確定HTTP請求方法。 他建立了一個變數來儲存解析的請求方法，並使用TryParse將下拉字串值轉換為HTTP動作。

如果選擇的方法無效，系統會顯示錯誤資訊（"無效的HTTP動詞"），並不會嘗試請求。一旦驗證，請求方法可以用來確定是否執行GET請求、POST請求或其他HTTP方法，如DELETE或PATCH。

準備後端處理POST請求

下一步是更新程式庫以處理POST請求。 Tim解釋說，POST命令與GET請求不同，因為它們通常需要一個請求正文以將資料發送到目標資源。 這些資料可以是JSON、二進位資料或表單資料。

Tim強調將UI職責與程式庫程式碼分開。 UI將正文內容作為字串傳遞，而程式庫將其轉換為請求的正確HTTP內容型別。這種設計確保像格式化內容這樣的通用操作在程式庫中處理，而不是在UI中。

為POST請求建立一個重載

Tim為CallApiAsync建立了一個重載，接受三個參數：

1. URL – 目標資源的地址

2. Action – HTTP請求方法（GET, POST等）

3. Content – 請求正文作為字串

這允許開發者將JSON輸出、表單資料或其他編碼資料從UI直接傳遞到程式庫。 通過這種方式處理POST請求，相同的程式庫還可以支持未來的HTTP方法，如PUT、PATCH或DELETE。

將字串內容轉換為HTTP內容

Tim展示如何將UI中的字串內容轉換為繼承自HTTP內容的StringContent。 他將編碼設置為UTF8，內容型別設置為application/json，這適合向伺服器發送結構化資料。

這一步確保請求正文在發送前正確格式化。 Tim強調這種關注分離使開發者可以使用POST命令而不必擔心在UI中處理HTTP標頭、編碼或內容轉換。

更新介面和測試POST請求

一旦程式庫準備就緒，Tim更新UI以調用新的重載方法。 他使用JSONPlaceholder測試POST請求，手動格式化請求正文：

{
  "title": "這是我的標題",
  "body": "這是我的正文文本",
  "userId": 3
}

{
  "title": "這是我的標題",
  "body": "這是我的正文文本",
  "userId": 3
}

Tim解釋說，POST請求將這些資料發送到目標資源，響應表示成功。 最初發生錯誤，因為HTTP動作枚舉不包括POST。新增POST解決了這個問題，允許系統成功發送POST命令。

在程式庫中處理POST請求

Tim展示在程式庫中使用switch語句處理POST命令。 對於GET，系統使用GetAsync； 對於POST，它使用PostAsync與格式化的請求正文。

測試POST命令返回帶有ID的響應（在JSONPlaceholder中為101），確認請求有效。 Tim指出，雖然此測試API不將資料儲存在資料庫中，但它對驗證POST請求功能很有用。

關鍵要點和未來工作

Tim總結了這一課：

• 現在下拉選單支持GET和POST方法。

• UI將請求正文傳遞到程式庫。

• 程式庫將字串轉換為HTTP內容並執行正確的HTTP請求。

• POST命令返回有效的響應，可以顯示在結果窗口中。

他鼓勵學習者在未來的課程中實施PUT、PATCH和DELETE命令，並強調現有框架使新增新的HTTP方法變得簡單。

Tim還建議避免過度工程或新增未使用的程式碼，這可能導致斷開的功能或孤立的元素。

結論

Tim Corey的影片為在Postman Clone專案中使用POST命令提供了一個清晰、實用的方法。 通過將UI職責與程式庫程式碼分離、將字串資料轉換為HTTP內容以及有效處理響應，開發者可獲得有關HTTP請求方法的實際經驗。

這一課不僅展示了如何將資料發送到伺服器，還為處理其他HTTP方法、標頭和更複雜的請求奠定了基礎，成為學習C#中HTTP互動的一個強有力的實際範例。