Repository navigation
recursos com estado
mobius1qwe edited this page Nov 16, 2026
·
1 revision
Home > Recursos com estado 🚧
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).
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); 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ãoralres;HttpOnly,SameSite=Lax,Securecom 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. -
OnCreateResourceeOnFreeResourceavisam 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.
| 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
|
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