設置POST命令：Tim Corey的深入分析

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的字串內容轉換為StringContent，後者繼承自HTTP內容。 他將編碼設置為UTF8，內容類型設置為application/json，這適合於向伺服器傳送結構化數據。

這一步確保請求主體在發送之前已正確格式化。 Tim強調這種關注點分離允許開發者使用POST命令而不必擔心UI中的HTTP標頭、編碼或內容轉換。

更新介面和測試POST請求

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

{
  "title": "This is my title",
  "body": "This is my body text",
  "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互動的強大實用範例。