Repository navigation
signalr
Home > SignalR 🚧
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 TRALSignalRModule fala o protocolo do ASP.NET Core SignalR, então
os clientes oficiais (@microsoft/signalr no navegador e no Node,
Microsoft.AspNetCore.SignalR.Client no .NET) conectam num servidor RAL, chamam os
métodos dele e recebem as chamadas que o servidor faz.
Você vai precisar: os pacotes RALModuleSignalRPackage (componente
TRALSignalRModule, paleta RAL - Modules), RALModuleWebSocketPackage e
RALNetPackage, e um motor com WebSocket (Indy, fpHTTP, mORMot2 smThreads/smAsync;
ver WebSocket).
uses RALSignalR;
Hub := TRALSignalRModule.Create(Self);
Hub.Path := '/chat';
Hub.Methods.AddMethod('SendMessage', SendMessage);
Hub.Methods.AddMethod('Echo', Echo);
Hub.Server := Servidor;
procedure TForm1.SendMessage(ACall: TRALSignalRCall);
begin
// todos os clientes recebem ReceiveMessage(user, text)
Hub.Send('ReceiveMessage', '[' + RALHubQuote(ACall.ArgAsString(0)) + ',' +
RALHubQuote(ACall.ArgAsString(1)) + ']');
end;
procedure TForm1.Echo(ACall: TRALSignalRCall);
begin
ACall.ReturnText('echo: ' + ACall.ArgAsString(0)); // o resultado do invoke
end;const c = new signalR.HubConnectionBuilder().withUrl("/chat").build();
c.on("ReceiveMessage", (user, text) => console.log(user, text));
await c.start();
await c.invoke("SendMessage", "ana", "oi");
console.log(await c.invoke("Echo", "teste"));No .NET é o mesmo: HubConnectionBuilder().WithUrl(...), On<string,string>(...),
InvokeAsync<string>("Echo", "teste").
| no cliente | no RAL |
|---|---|
invoke("M", ...) |
o método M de Methods (sem diferença de maiúsculas); ReturnText, ReturnJSON ou nada (void) |
send("M", ...) (sem esperar) |
o mesmo método; nada volta |
stream("M", ...) |
o método manda os itens com ACall.SendItem e termina ao sair |
| erro |
ACall.Fail('...') chega como está; uma exceção chega como mensagem genérica (DetailedErrors mostra a dela) |
on("Evento", ...) |
Hub.Send('Evento', '[args]') para todos, hsConnection (um ID), hsUser, hsGroup; SendOthers para todos menos quem chamou |
| grupos |
Hub.Join(ACall.Connection, 'sala'), Hub.Leave(...)
|
-
OnConnecteOnDisconnectavisam quando um cliente termina o handshake e quando sai. - Só recebe chamadas quem já terminou o handshake.
-
KeepAliveInterval(15 s) manda um ping a quem ficou esse tempo sem ouvir nada: os clientes desistem depois de 30 s de silêncio. -
negotiate(versões 0 e 1) entrega um token de uso único, válido porTokenLifetime(60 s).AllowSkipNegotiation(ligado) aceita o cliente comskipNegotiation. - Ao parar o servidor, os clientes recebem o aviso de fechamento com
allowReconnect: owithAutomaticReconnect()volta sozinho.
Só o transporte WebSockets e só o protocolo JSON: nada de MessagePack, server-sent events ou long polling (o cliente oficial usa WebSockets por padrão), nem stream do cliente para o servidor, nem reconexão com estado. Num stream, um cancelamento só chega depois que o método termina.
Autenticação: os plugins do servidor julgam o negotiate e o pedido do WebSocket como
qualquer pedido. Com o accessTokenFactory, o cliente manda o token no cabeçalho
Authorization do negotiate, mas no WebSocket do navegador ele vai em access_token
na query, que os autenticadores do RAL ainda não leem: por ora, proteja o hub por
cookie de sessão ou por lista de IPs.
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 🚧
- GraphQL 🚧
- Servidor MCP (IA) 🚧
-
Protocol Buffers 🚧
- gRPC 🚧
- WebSocket 🚧
- Hubs (WebSocket) 🚧
- SignalR 🚧
- 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 🚧
- Enviar por REST e ação 🚧
- 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