一、背景介绍

在现代桌面应用开发中，网络通信是不可或缺的能力。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弹性策略库