[QWorker] Delay 函数新增 ARepeat 参数用来实现重复延迟作业

QWorker 提供了多种重复作业的支持，但是，如果一个作业执行的时间超过了重复间隔，下一次作业不会等待上一次作业结束就会执行，这在某些需求场景下会造成不便。以前我建议大家用人工调用 Delay 的方式来解决这一问题，现在不需要了，QWorker 的 Delay 函数增加了这样一个参数，来简化您的编程：

先看一下函数声明：

function Delay(AProc: TQJobProc; ADelay: Int64; AData: Pointer;ARunInMainThread: Boolean = False;AFreeType: TQJobDataFreeType = jdfFreeByUser; ARepeat: Boolean = False): IntPtr; overload;
function Delay(AProc: TQJobProcA; ADelay: Int64; AData: Pointer;ARunInMainThread: Boolean = False;AFreeType: TQJobDataFreeType = jdfFreeByUser; ARepeat: Boolean = False): IntPtr; overload;
function Delay(AProc: TQJobProcG; ADelay: Int64; AData: Pointer;ARunInMainThread: Boolean = False;AFreeType: TQJobDataFreeType = jdfFreeByUser; ARepeat: Boolean = False): IntPtr; overload;

为了保证以前代码的兼容性，ARepeat 参数放在了最后。参数默认为 False，即单次延迟作业。如果设置为 True，则作业会在上一次完成后，延迟 ADelay 时长，然后再次触发新的作业。如下面的示例代码：

procedure TForm4.Button2Click(Sender: TObject);
begin
  Workers.Delay(
    procedure(AJob: PQJob)
    begin
      Memo1.Lines.Add(FormatDateTime('hh:nn:ss.zzz', Now) + ' Job started');
      Sleep(2000);
    end, Q1Second, nil, True,jdfFreeByUser,True);
  Memo1.Lines.Add(FormatDateTime('hh:nn:ss.zzz', Now) + ' Job posted.')
end;

作业要求重复延迟 1 秒后执行，但由于作业内部耗时超过了 1 秒（ Sleep 了2秒），所以作业的实际时间间隔就会是第一次是延迟1秒后执行，以后每隔3秒执行一次。我们看一下实际的运行效果截图：

从第一行 Job posted 提示到作业开始执行间隔是1秒，而后面的间隔就是3秒，正好符合我们的预期。

一般情况下，我们要求的延迟时间是固定的。如果要动态修改下次的延迟间隔，可以直接修改 AJob.Source.FirstDelay 的值实现。

好了，我们可以看到它和 Post/At/Plan 一个重复作业的区别就在这里了，Delay 会等待上一次作业完成才计划下一次作业，如果上一次作业始终未完成，下一次也就始终不会开始，而其它类型的重复作业不会管你上次是否完成，没完成到了时间也会开始新的作业。

登录