Skip to content
mobius1qwe edited this page Nov 16, 2026 · 1 revision

Home > SignalR 🚧

SignalR: os clientes da Microsoft num servidor RAL

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).

O servidor

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;

O cliente (JavaScript)

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").

O que o hub faz

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(...)
  • OnConnect e OnDisconnect avisam 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 por TokenLifetime (60 s). AllowSkipNegotiation (ligado) aceita o cliente com skipNegotiation.
  • Ao parar o servidor, os clientes recebem o aviso de fechamento com allowReconnect: o withAutomaticReconnect() volta sozinho.

O que não tem

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.

Veja também

  • WebSocket e Hubs: o protocolo próprio do RAL, mais simples
  • Exemplo: SignalRExample (Delphi e Lazarus), com uma página que usa o cliente oficial

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally