对于初学者,此方法可以简化为:
public IAsyncEnumerable<Job> GetByPipeline(int pipelineId)
{
return context.Jobs
.Where(job => job.Pipeline.Id == pipelineId)
.AsAsyncEnumerable();
}
甚至
public IAsyncEnumerable<Job> GetByPipeline(int pipelineId)
=> context.Jobs
.Where(job => job.Pipeline.Id == pipelineId)
.AsAsyncEnumerable();
该方法不做任何事情,job
因此不需要对其进行迭代。
消除
如果实际使用的方法job
,应该在哪里使用取消令牌?
让我们稍微清理一下方法。等效的是:
public async IAsyncEnumerable<Job> GetByPipeline(
int pipelineId,
[EnumeratorCancellation] CancellationToken ct = default)
{
//Just a query, doesn't execute anything
var query =context.Jobs.Where(job => job.Pipeline.Id == pipelineId);
//Executes the query and returns the *results* as soon as they arrive in an async stream
var jobStream=query.AsAsyncEnumerable();
//Process the results from the async stream as they arrive
await foreach (var job in jobStream.WithCancellation(ct).ConfigureAwait(false))
{
//Does *that* need cancelling?
DoSometingExpensive(job);
}
}
IQueryablequery
不运行任何东西,它代表查询。它不需要取消。
AsAsyncEnumerable()
, AsEnumerable()
,ToList()
等执行查询并返回一些结果。ToList()
等消耗所有结果,而As...Enumerable()
方法仅在请求时产生结果。查询无法取消,As_Enumerable()
除非要求,否则方法不会返回任何内容,因此它们不需要取消。
await foreach
将遍历整个异步流,因此如果我们希望能够中止它,我们确实需要传递取消令牌。
最后,DoSometingExpensive(job);
需要取消吗?如果花费太长时间,我们是否希望能够摆脱它?或者我们可以等到它完成后再退出循环吗?如果它需要取消,它也需要 CancellationToken。
配置等待
最后,ConfigureAwait(false)
不参与取消,并且可能根本不需要。没有它,每次await
执行后都会返回到原来的同步上下文。在桌面应用程序中,这意味着 UI 线程。这就是允许我们在异步事件处理程序中修改 UI 的原因。
如果GetByPipeline
在桌面应用程序上运行并想要修改 UI,则必须删除ConfugureAwait
:
await foreach (var job in jobStream.WithCancellation(ct))
{
//Update the UI
toolStripProgressBar.Increment(1);
toolStripStatusLabel.Text=job.Name;
//Do the actual job
DoSometingExpensive(job);
}
使用ConfigureAwait(false)
,在线程池线程上继续执行,我们无法触摸 UI。
库代码不应影响执行恢复的方式,因此大多数库使用ConfigureAwait(false)
并将最终决定权留给 UI 开发人员。
如果GetByPipeline
是库方法,请使用ConfigureAwait(false)
.