在现代软件开发中，异步轮询 Web API 是一种常见的做法，尤其是在需要定期从服务器获取数据更新的场景下。C# 作为一种功能强大的编程语言，提供了丰富的异步编程支持，使得实现异步轮询变得相对简单。本文将介绍如何使用 C# 快速实现异步轮询 Web API，并提供一个示例代码。
一、异步编程基础
在 C# 中，异步编程主要依赖于 async 和 await 关键字。这两个关键字允许你以非阻塞的方式执行异步操作，从而提高应用程序的响应性和性能。
二、HttpClient 类
HttpClient 类是 .NET 中用于发送 HTTP 请求和接收 HTTP 响应的主要类。它支持异步操作，非常适合用于异步轮询 Web API。
三、实现异步轮询
下面是一个简单的 C# 示例，展示了如何使用 HttpClient 类和异步编程技术来轮询一个 Web API：
using System; using System.Net.Http; using System.Threading.Tasks; using System.Timers; class Program { private static readonly HttpClient client = new HttpClient(); private static Timer timer; static async Task Main(string[] args) { // 设置定时器以定期轮询 Web API timer = new Timer(5000); // 5 秒轮询一次 timer.Elapsed += OnTimedEvent; timer.AutoReset = true; timer.Enabled = true; Console.WriteLine("开始异步轮询 Web API..."); Console.WriteLine("按任意键停止轮询..."); Console.ReadKey(); timer.Stop(); timer.Dispose(); } private static async void OnTimedEvent(Object source, ElapsedEventArgs e) { await PollWebApiAsync(); } private static async Task PollWebApiAsync() { try { // 假设你要轮询的 Web API URL 是 "https://api.example.com/data" HttpResponseMessage response = await client.GetAsync("https://api.example.com/data"); response.EnsureSuccessStatusCode(); // 确保响应状态码为 200-299 string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine($"轮询结果: {responseBody}"); } catch (HttpRequestException ex) { Console.WriteLine($"轮询失败: {ex.Message}"); } } }
在这个示例中，我们使用了一个 Timer 对象来定期触发轮询事件。在每次触发时，我们调用 PollWebApiAsync 方法来异步获取 Web API 的数据。这个方法使用 HttpClient 类的 GetAsync 方法来发送 GET 请求，并等待响应。一旦响应到达，我们读取响应内容并将其打印到控制台。
四、注意事项和优化
异常处理：在实际应用中，你需要确保妥善处理可能发生的异常，如网络错误、超时等。在上面的示例中，我们使用了 try-catch 块来捕获和处理 HttpRequestException。
HttpClient 实例管理：在上面的示例中，我们创建了一个静态的 HttpClient 实例。这是推荐的做法，因为频繁地创建和销毁 HttpClient 实例可能会导致资源耗尽和性能问题。通过重用 HttpClient 实例，你可以避免这些问题。
轮询间隔：根据你的需求调整轮询间隔。太短的间隔可能会导致服务器过载，而太长的间隔可能会导致数据更新不及时。
取消轮询：在上面的示例中，我们使用了 Console.ReadKey() 来等待用户输入，从而可以在用户按下任意键时停止轮询。在实际应用中，你可能需要实现更复杂的取消逻辑。
使用更高级的库：如果你需要处理更复杂的场景（如重试逻辑、熔断器等），可以考虑使用如 Polly 这样的第三方库来增强你的异步轮询实现。
