async-api.md

API Assíncrona

Async/Await e programação assíncrona real para Delphi.

O que é TAsyncTask?

TAsyncTask é uma primitiva de alto nível para gerenciar operações assíncronas sem a complexidade de gerenciar threads manualmente. Ela permite o encadeamento de tarefas e o retorno automático para a thread principal (UI thread).

Executando uma Tarefa

uses
  Dext.Core.Async;

TAsyncTask.Run(procedure
  begin
    // Isso roda em uma thread separada (background)
    FazerTrabalhoPesado;
  end);

Encadeamento de Tarefas (Fluent Chaining)

Você pode encadear operações que dependem do resultado da anterior:

TAsyncTask.Run<TUserProfile>(
  function: TUserProfile
  begin
    Result := ApiService.GetProfile(UserId);
  end)
  .ThenBy<Boolean>(
    function(Profile: TUserProfile): Boolean
    begin
      Result := Profile.IsActive;
    end)
  .OnComplete(
    procedure(IsActive: Boolean)
    begin
      // Executado na UI Thread
      if IsActive then
        UpdateUI;
    end)
  .Start;

Tratamento de Exceções

TAsyncTask.Run(procedure
  begin
    raise EInvalidOperation.Create('Erro no background');
  end)
  .OnException(
    procedure(Ex: Exception)
    begin
      // Captura o erro na UI Thread
      ShowMessage('Erro: ' + Ex.Message);
    end)
  .Start;

Cancelamento

Use TCancellationToken para abortar tarefas em execução:

var CTS := TCancellationTokenSource.Create;

TAsyncTask.Run(procedure
  begin
    while not CTS.Token.IsCancellationRequested do
    begin
      // Processar...
    end;
  end)
  .Start;

// Mais tarde...
CTS.Cancel;

---

← Configuração | Próximo: Apêndice →