Skip to content
mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > Tarefas em segundo plano 🚧

Tarefas em segundo plano

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Vale para a 2.0 · Delphi XE em diante e Lazarus/FPC 3.2 em diante · Nível: intermediário

Em uma frase: o TRALTask roda um trabalho fora da thread principal sem você escrever uma thread: avisa quando terminou ou falhou, passa o resultado para a próxima tarefa, pode ser cancelado e esperado sozinho ou em grupo.

Você vai precisar: o pacote RALHostingTaskPackage (só requer PascalRAL). Para trabalhos que precisam sobreviver a um reinício, use a fila de jobs.

No Object Inspector

Solte um TRALTask por etapa e escreva os eventos:

procedure TForm1.BaixarExecute(Sender: TRALTask);
begin
  Sender.Output := BaixarArquivo(Sender.Input);   // roda numa thread do pool
end;

procedure TForm1.BaixarError(Sender: TRALTask; AException: Exception);
begin
  Log('falhou: ' + AException.Message);
end;

  Baixar.Next := Processar;     // Processar recebe o Output de Baixar como Input
  Processar.Next := Gravar;
  Baixar.Run('https://exemplo.com/arquivo.csv');
  • OnExecute é o trabalho; lê Input, escreve Output. OnComplete, OnError e OnCancel dizem como terminou.
  • Next só roda se a anterior terminou bem; depois de um erro ou de um cancelamento, as seguintes da cadeia terminam como canceladas.
  • Os eventos rodam numa thread do pool; com SynchronizeEvents vão para a thread principal (num programa de console, chame CheckSynchronize).
  • Todas as tarefas do programa dividem um pool de threads (RALTaskPoolSize, padrão duas por processador).

Esperar e cancelar

  Gravar.WaitFor;                                  // a cadeia toda, até a última
  if not TRALTask.WaitAll([A, B, C], 10000) then   // as três, até 10 s
    Log('demorou');
  vPrimeira := TRALTask.WaitAny([A, B, C]);        // índice da primeira a terminar

  Baixar.Cancel;

Cancel impede de rodar uma tarefa que ainda está na fila; numa que já roda, o trabalho vê Cancelled e decide quando parar:

for vLinha := 0 to vTotal - 1 do
begin
  if Sender.Cancelled then
    Exit;
  ...
end;

Métodos anônimos (Delphi 2010 em diante)

uses RALTask, RALTaskAnon;

  vTarefa := TRALTask.FromProc(
    procedure(ATask: TRALTask)
    begin
      ATask.Output := Calcular(ATask.Input);
    end).ContinueWith(
    procedure(ATask: TRALTask)
    begin
      Gravar(ATask.Input);
    end);
  vTarefa.Run(42);
  ...
  vTarefa.Free;   // libera também as que ContinueWith acrescentou

No Lazarus/FPC 3.2 a unit fica vazia: use os eventos.

Erros comuns

sintoma causa o que fazer
"já está na fila ou rodando" Run de uma tarefa ocupada WaitFor antes, ou outra tarefa
a tela trava ou dá erro ao mexer num controle no OnComplete evento numa thread do pool SynchronizeEvents
OnComplete nunca chega no console com SynchronizeEvents ninguém processa a fila da thread principal CheckSynchronize no laço do programa

Veja também

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally