一、背景介紹

在現代桌面應用開發中，網絡通信是不可或缺的能力。WPF作為.NET平臺下的桌面開發框架，可通過HttpClient輕松實現與后端API的交互。本文將以一個實際的HttpsMessages工具類為例，講解如何在WPF中安全高效地封裝HTTP通信模塊。

---

二、關鍵技術點

1. HttpClient的封裝與復用

代碼中通過構造函數初始化HttpClient并配置默認請求頭，這種做法避免了頻繁創建實例導致的TCP端口耗盡問題。建議在單例或靜態類中復用HttpClient：

// 推薦通過IHttpClientFactory管理（需配置DI容器）
services.AddHttpClient<HttpsMessages>();

2. 異步編程(async/await)

所有網絡請求方法均采用異步模式，確保UI線程不被阻塞：

public async Task<string> GetTokenAsync<T>(string username, string password)
{// 使用await避免阻塞HttpResponseMessage response = await httpClient.PostAsync(...);
}

3. 網絡安全與錯誤處理

• 網絡狀態檢查：通過Ping類實現異步網絡可達性檢測。
• 異常捕獲：統一處理HttpRequestException，避免應用崩潰。

try {// 網絡請求邏輯
} catch (HttpRequestException hre) {MessageBox.Show($"Error: {hre.Message}");
}

---

三、代碼解析與優化建議

1. 登錄請求的安全增強

原始代碼直接將用戶名密碼拼接為JSON字符串，存在注入風險。建議使用強類型對象序列化：

var loginRequest = new { username = username, password = password };
var json = new StringContent(JsonConvert.SerializeObject(loginRequest), Encoding.UTF8, "application/json"
);

2. Bearer令牌管理

代碼通過方法參數傳遞令牌，實際開發建議結合SecureString或專用Token管理服務：

// 使用SecureString存儲敏感信息
var secureToken = new SecureString();
foreach (char c in bearerToken) secureToken.AppendChar(c);

3. 響應處理的改進

直接返回JSON字符串可能不夠靈活，推薦泛型反序列化：

public async Task<T> GetAsync<T>(string path, string bearerToken)
{string json = await httpClient.GetStringAsync(...);return JsonConvert.DeserializeObject<T>(json);
}

---

四、最佳實踐

1. 遵循MVVM模式

避免在HTTP工具類中直接調用MessageBox，改為通過事件或回調通知ViewModel：

// 定義事件
public event Action<string> RequestFailed; // 觸發事件
RequestFailed?.Invoke($"Error: {response.StatusCode}");

2. 添加請求重試機制

使用Polly庫實現彈性策略：

var retryPolicy = Policy.Handle<HttpRequestException>().WaitAndRetryAsync(3, retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));

3. 配置超時與取消

通過CancellationToken支持用戶主動取消請求：

public async Task<string> GetAsync<T>(..., CancellationToken ct)
{return await httpClient.GetAsync(..., ct);
}

---

五、總結

通過封裝HttpsMessages類，我們實現了以下目標：

• 統一管理HTTP請求頭與認證信息
• 提供異步非阻塞的網絡通信能力
• 增強錯誤處理與網絡狀態檢測

注意事項：

• 敏感信息應通過SecureString或配置中心管理
• 生產環境建議啟用HTTPS證書校驗
• 使用性能分析工具監控網絡請求

---

延伸閱讀

• 微軟官方HttpClient指南
• Polly：.NET彈性策略庫