.NET Core使用 CancellationToken 取消API请求

  • .NET Core使用 CancellationToken 取消API请求已关闭评论
  • 118 次浏览
  • A+
所属分类:.NET技术
摘要

您是否曾经访问过一个网站,它需要很长时间加载,最终你敲击 F5 重新加载页面。

您是否曾经访问过一个网站,它需要很长时间加载,最终你敲击 F5 重新加载页面。

即使用户刷新了浏览器取消了原始请求,而对于服务器来说,API也不会知道它正在计算的值将在结束时被丢弃,刷新五次,服务器将触发 5 个请求。

为了解决这个问题,ASP.NET Core 为 Web 服务器提供了一种机制,就是CancellationToken.

用户取消请求时,你可以使用HttpContext.RequestAborted访问,您也可以使用依赖注入将其自动注入到您的操作中。

 

长时间运行的任务请求

现在我们假设您有一个 API 操作,在向用户发送响应之前可能需要一些时间才能完成。

在处理该操作时,用户可以直接取消请求,或刷新页面(这会有效地取消原始请求,并启动新请求)。

[HttpGet(Name = "get")] public async Task<string> GetAsync() {     try     {         _logger.LogInformation("request in");         await Task.Delay(5 * 1000);         _logger.LogInformation("request end");     }     catch (Exception ex)     {         _logger.LogInformation("request ex");     }     return "ok"; }

如果用户在请求中途刷新浏览器,那么浏览器永远不会收到第一个请求的响应,但在server端可以看到,操作方法执行完成两次。

.NET Core使用 CancellationToken 取消API请求

这是否是正确将取决于您的应用程序。

如果请求修改某些业务的状态,那么您可能不希望在方法中途停止执行。如果请求没有副作用,那么您可能希望尽快停止(可能很昂贵)操作。

用户取消请求时,你可以使用HttpContext.RequestAborted访问,您也可以使用依赖注入将其自动注入到您的操作中。

 

CancellationTokens取消不必要的请求

以下代码显示了如何通过将 CancellationTokenSource 注入到操作方法中,并通过其取消不必要的操作。

[HttpGet(Name = "get")] public async Task<string> GetAsync(CancellationToken cancellationToken) {     try     {         _logger.LogInformation("request in");         await Task.Delay(5 * 1000,cancellationToken);         _logger.LogInformation("request end");     }     catch (Exception ex)     {         _logger.LogInformation("request ex");     }     return "ok"; }

通过这个改变,我们可以再次测试我们的场景。

我们发出一个初始请求,然后我们重新加载页面。正如您从下面的日志中看到的,第一个请求不会继续执行。

.NET Core使用 CancellationToken 取消API请求

用户刷新浏览器取消请求后不久,原始请求就会中止,并TaskCancelledException通过 API 过滤器管道传播回来,并备份中间件管道。

根据您的场景,您可能能够依靠此类框架方法来检查 的状态CancellationToken,或者您可能需要自己监视取消请求。

 

过滤器捕获异常

您可以通过以上try catch 捕获,或者通过一个过滤器统一监视此异常。

public class OperationCancelledExceptionFilter : ExceptionFilterAttribute {     private readonly ILogger _logger;      public OperationCancelledExceptionFilter(ILoggerFactory loggerFactory)     {         _logger = loggerFactory.CreateLogger<OperationCancelledExceptionFilter>();     }     public override void OnException(ExceptionContext context)     {         if (context.Exception is OperationCanceledException)         {             _logger.LogInformation("Request was cancelled");             context.ExceptionHandled = true;             context.Result = new StatusCodeResult(400);         }     } }   builder.Services.AddControllers(options => {     options.Filters.Add<OperationCancelledExceptionFilter>(); }); 

.NET Core使用 CancellationToken 取消API请求