单个接口添加超时时间_一种极简的异步超时处理机制设计与实现（C#版）

1.引言

当执行某些动作之后，会期待反馈。最终要么是得到了结果，要么就是超时了。当超时发生时，可能是期望得到通知，或是希望能自动重试，等等。于是设计了一种通用的异步超时的处理机制，以期通过简洁易理解的方式完成超时的处理过程。

2.对外接口设计

从使用的角度，调用方期望的是“指定超时时长，时间到自动执行指定过程”，由此可以得出外部的操作接口参数。从功能角度来看，对于未超时的情况，需要提供在超时时长内随时清除超时任务的功能。

2.1操作接口

在这里，我们把设计的机制称里“超时任务运行器”，从外部来看，其接口与功能结构如下：

(1)添加超时任务，带上对象标识用于回调时传参，指定超时时长和超时回调方法即可把超时处理交给超时任务运行器。返回一个任务标识，用于后续可删除该超时任务。

(2)删除超时任务，指定任务标识即可删除。同时，支持清除一个对象的所有超时任务。

2.2使用过程

发起异步操作的同时，添加超时任务，在异步操作成功时，删除超时任务。超时则运行器会自动执行超时任务。如下图，灰色部分由运行器完成：

3.超时任务运行器设计与实现

首先，时长的精确粒度设定为秒，这表示超时最低可支持秒级(废话)。设计的基本思路为：对于加入的超时任务，运行器建立清单，并以秒为单位对清单中的任务进行检测，对于时间已经到达或超过的将其移动至超时任务执行队列中，由独立的超时任务运行线程来执行队列中的任务。这里，移动任务至执行队列的检测者谓之“生产者”，任务执行线程谓之“消费者”。

3.1基本结构

运行器维护一个超时任务清单和一个执行队列，一个超时检测者，它使用