Skip to content

recursos com estado

mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > Recursos com estado 🚧

Recursos com estado (uma instância por sessão)

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: com o TRALStatefulModule você escreve as rotas como métodos de uma classe e guarda o estado do usuário (o carrinho, o passo de um assistente) em campos comuns: cada sessão tem a sua instância, e as chamadas a uma instância nunca rodam ao mesmo tempo, então não há trava para escrever.

Você vai precisar: o pacote RALModuleStatefulPackage (só requer PascalRAL).

A classe do recurso

uses RALStatefulModule;

type
  TCarrinho = class(TRALStatefulResource)
  private
    FItens: TStringList;
    procedure Adicionar(ARequest: TRALRequest; AResponse: TRALResponse);
    procedure Ver(ARequest: TRALRequest; AResponse: TRALResponse);
  protected
    procedure DefineRoutes; override;
  public
    constructor Create(AOwner: TComponent); override;
    destructor Destroy; override;
  end;

procedure TCarrinho.DefineRoutes;
begin
  Route('carrinho/adicionar', Adicionar);
  Route('carrinho', Ver);
end;

procedure TCarrinho.Adicionar(ARequest: TRALRequest; AResponse: TRALResponse);
begin
  FItens.Add(ARequest.ParamByName('item').AsString);   // campo comum, sem trava
  AResponse.Answer(200, IntToStr(FItens.Count) + ' itens', rctTEXTPLAIN);
end;

initialization
  RALRegisterResource(TCarrinho);

O módulo

  FCarrinhos := TRALStatefulModule.Create(Self);
  FCarrinhos.ResourceClass := 'TCarrinho';
  FCarrinhos.Lifetime := mlPerSession;
  FCarrinhos.Server := FServidor;
Lifetime quanto vive a instância
mlShared uma só, para todos os pedidos, criada quando o servidor sobe
mlPerSession (padrão) uma por sessão de usuário; liberada SessionTimeout segundos (padrão 1200) depois do último pedido dela
mlPerRequest uma nova a cada pedido, liberada no fim dele
  • A sessão é um cookie próprio (CookieName, padrão ralres; HttpOnly, SameSite=Lax, Secure com HTTPS). Um cookie desconhecido ou vencido começa uma sessão nova.
  • MaxSessions (padrão 10000) limita as sessões vivas; no limite, sai a que está parada há mais tempo.
  • OnCreateResource e OnFreeResource avisam quando uma instância nasce e quando vai ser liberada (para gravar o carrinho num banco, por exemplo).
  • Pedidos da mesma sessão ao mesmo tempo (duas abas) esperam um pelo outro; sessões diferentes rodam em paralelo.

Erros comuns

sintoma causa o que fazer
"não está registrada (RALRegisterResource)" falta registrar a classe RALRegisterResource na initialization
o carrinho some a cada pedido o cliente não devolve o cookie confira o cliente (um navegador devolve; num programa, guarde e mande o cookie)
estado some depois de um tempo parado SessionTimeout aumente, ou grave no OnFreeResource

Veja também

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally