Diferenças entre o ASP.NET SignalR e o ASP.NET Core SignalR

O ASP.NET Core SignalR não é compatível com clientes ou servidores para ASP.NET SignalR. Este artigo detalha os recursos que foram removidos ou alterados no ASP.NET Core SignalR.

Como identificar a versão do SignalR

Diferenças de recursos

Reconexões automáticas

HubConnection connection = new HubConnectionBuilder()
    .WithUrl(new Uri("http://127.0.0.1:5000/chathub"))
    .WithAutomaticReconnect()
    .Build();

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/chathub")
    .withAutomaticReconnect()
    .build();

Suporte a protocolo

O ASP.NET Core SignalR é compatível com JSON, bem como com um novo protocolo binário baseado no MessagePack. Além disso, protocolos personalizados podem ser criados.

Transportes

O transporte do Forever Frame não tem suporte no ASP.NET Core SignalR.

Diferenças no servidor

As bibliotecas ASP.NET Core SignalR do lado do servidor são incluídas no Microsoft.AspNetCore.App, que é usado no modelo de Aplicativo Web do ASP.NET Core para projetos MVC e Razor.

O ASP.NET Core SignalR é um middleware do ASP.NET Core. Ele deve ser configurado chamando AddSignalR em Startup.ConfigureServices.

services.AddSignalR()

app.UseRouting();

app.UseEndpoints(endpoints =>
{
    endpoints.MapHub<ChatHub>("/hub");
});

app.UseSignalR(routes =>
{
    routes.MapHub<ChatHub>("/hub");
});

Sessões persistentes

O modelo de expansão para ASP.NET SignalR permite que os clientes se reconectem e enviem mensagens para qualquer servidor no farm. No ASP.NET Core SignalR, o cliente deve interagir com o mesmo servidor durante a conexão. Para expandir horizontalmente usando Redis, isso significa que sessões persistentes são necessárias. Para expansão usando o Serviço de do Azure SignalR, as sessões persistentes não são necessárias porque o serviço lida com conexões com clientes.

Hub único por conexão

No ASP.NET Core SignalR, o modelo de conexão foi simplificado. As conexões são feitas diretamente com um único hub, em vez de uma única conexão sendo usada para compartilhar o acesso a vários hubs.

Streaming

O ASP.NET Core SignalR dá suporte ao streaming de dados do hub para o cliente.

State

A capacidade de passar um estado arbitrário entre os clientes e o hub (geralmente chamado de HubState) foi removida, bem como o suporte para mensagens de progresso. Não há nenhum equivalente de proxies de hub no momento.

Remoção de PersistentConnection

No ASP.NET Core SignalR, a classe PersistentConnection foi removida.

GlobalHost

O ASP.NET Core tem DI (injeção de dependência) incorporada à estrutura. Os serviços podem usar a DI para acessar o HubContext. O objeto GlobalHost usado no ASP.NET SignalR para obter um HubContext não existe no ASP.NET Core SignalR.

HubPipeline

O ASP.NET Core SignalR não tem suporte para módulos do HubPipeline.

Diferenças no cliente

TypeScript

O cliente ASP.NET Core SignalR é escrito em TypeScript. Você pode escrever em JavaScript ou TypeScript ao usar o cliente JavaScript.

O cliente JavaScript é hospedado no npm

npm init -y
npm install @microsoft/signalr

npm init -y
npm install @aspnet/signalr

jQuery

A dependência no jQuery foi removida, no entanto, os projetos ainda podem usar o jQuery.

Suporte ao Internet Explorer

O ASP.NET Core SignalR não dá suporte ao Microsoft Internet Explorer, enquanto o ASP.NET SignalR dá suporte ao Microsoft Internet Explorer 8 ou posterior. Para obter mais informações, confira Plataformas com suporte do ASP.NET Core SignalR.

Sintaxe do método de cliente JavaScript

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/hub")
    .build();

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/hub")
    .build();

connection.on("ReceiveMessage", (user, message) => {
    const msg = message.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
    const encodedMsg = `${user} says ${msg}`;
    console.log(encodedMsg);
});

Depois de criar o método de cliente, inicie a conexão do hub. Encadeie um método catch para registrar ou manipular erros.

connection.start().catch(err => console.error(err));

Proxies do hub

.NET e outros clientes

O pacote NuGet Microsoft.AspNetCore.SignalR.Client contém as bibliotecas do cliente .NET para ASP.NET Core SignalR.

Use o HubConnectionBuilder para criar e compilar uma instância de uma conexão com um hub.

connection = new HubConnectionBuilder()
    .WithUrl("url")
    .Build();

Diferenças de expansão

O ASP.NET SignalR dá suporte ao SQL Server e Redis. O ASP.NET Core SignalR dá suporte ao Serviço do Azure SignalR e Redis.

ASP.NET

• Expansão do SignalR com o Barramento de Serviço do Azure
• Expansão do SignalR com Redis
• Expansão do SignalR com o SQL Server

ASP.NET Core

• Serviço do Azure SignalR
• Backplane do Redis

Recursos adicionais

• Hubs
• Cliente JavaScript
• Cliente .NET
• Plataformas com suporte