Repository navigation
tarefas
Home > 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.
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, escreveOutput.OnComplete,OnErroreOnCanceldizem como terminou. -
Nextsó 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
SynchronizeEventsvão para a thread principal (num programa de console, chameCheckSynchronize). - Todas as tarefas do programa dividem um pool de threads (
RALTaskPoolSize, padrão duas por processador).
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;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 acrescentouNo Lazarus/FPC 3.2 a unit fica vazia: use os eventos.
| 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 |
Começar
Servidor
- Rotas e parâmetros
- Rotas avançadas: tipos, grupos, versões 🚧
- Ler o pedido e responder
- Objetos no corpo 🚧
- Resposta em fluxo 🚧
- Plugins 🚧
- Serviços (contêiner de dependências) 🚧
- Barramento de eventos 🚧
- Tarefas em segundo plano 🚧
- Recursos com estado 🚧
- Autenticação
- Banco de dados (DBWare)
- Servir site e arquivos
- JSON-RPC 2.0 🚧
- Servidor MCP (IA) 🚧
-
Protocol Buffers 🚧
- gRPC 🚧
- WebSocket 🚧
- Hubs (WebSocket) 🚧
- Swagger e Postman
- Servidor SOAP 🚧
- WS-Security 🚧
- HTTPS
- Criptografia ponto a ponto
- Segurança para produção
- Colocar no ar
- Desempenho
- Testes em memória 🚧
MQTT 🚧
- O que é e quando usar 🚧
- Cliente MQTT 🚧
- Broker MQTT 🚧
- MQTT-SN 🚧
- Ponte REST 🚧
- Segurança 🚧
- Rede ruim 🚧
E-mail 🚧
- Mensagens 🚧
- Enviar 🚧
- Receber 🚧
- Ler a caixa postal 🚧
- Verificar o que chega 🚧
- Servir caixas postais 🚧
- S/MIME 🚧
- OpenPGP 🚧
Chatbot 🚧
- O robô e os canais 🚧
- Telegram 🚧
- Gateways REST (WhatsApp não oficial) 🚧
- Discord 🚧
- Slack 🚧
- Microsoft Teams 🚧
- Conversa em etapas 🚧
Cliente
Motores
- Qual motor escolher?
- Compatibilidade
- Recursos
- QUIC
- Motor NgHttp2 (HTTP/2) 🚧
- Motor XSocket 🚧
- Motor AdvancedHTTP (experimental) 🚧
Avançado
Ajuda
- Problemas comuns
- Atualizar o Indy
- Várias versões do Delphi
- Vídeos e guias
- Módulos de terceiros
- Licenças
- Contribuir
- Roadmap e changelog
🚧 = em desenvolvimento, pode mudar