VAGAS DE EMPREGO

balta.io balta.io
  • Cursos
  • Carreiras
  • Para sua Empresa
  • Livros
    • Background Services
    • Blazor com .NET 8
    • Segurança em APIs
    • Futuro do C# 12
    • Nullable Types
    • Clean Code
  • Blog

Seja Premium
balta.io

  • Cursos
  • Carreiras
  • Para sua Empresa
  • Agenda
  • Livros
    • Background Services
    • Blazor com .NET 8
    • Segurança em APIs
    • Futuro do C# 12
    • Nullable Types
    • Clean Code
  • Blog
  • Player
Seja Premium

Entre ou Cadastre-se

  • Home
  • Artigos
  • ASP.NET Minimal SignalR


👉 Temos uma versão mais atualizada deste artigo no nosso novo Blog

ASP.NET Minimal SignalR

No artigo anterior, vimos um pouco sobre Minimal APIs e o novo template Web do ASP.NET. Neste artigo vamos conferir as principais mudanças do SignalR.

Antes de começar

Se você ainda não viu o novo template do ASP.NET Minimal APIs, clique aqui e confira este artigo.

O que é o SignalR?

SignalR é a tecnologia da Microsoft, que roda sob o ASP.NET e encapsula chamadas ao WebSocket provendo comunicação em tempo real para seu Frontend (Client) e servidor.

Iniciando o projeto

Vamos começar criando nosso servidor, usando o comando abaixo:

dotnet new web -o SignalServer
cd SignalServer
dotnet add package Microsoft.AspNetCore.SignalR

O pacote Microsoft.AspNetCore.SignalR é tudo que precisamos para trabalhar com SignalR no servidor.

Criando um Hub

Diferente dos projetos ASP.NET MVC, o SignalR utiliza Hub ao invés de controladores.

Os Hubs são responsáveis por receber e distribuir mensagens em tempo real. Por sua vez, um Hub nada mais é do que uma classe que herda da classe base Hub.

class MyHub : Hub
{
    ...
}

IAsyncEnumerable

Se estamos falando em Tempo Real, em ficar conectado ao servidor, estamos falando sobre Streaming de dados (Na maioria dos casos), e o C# incluiu nas últimas versões um tipo chamado IAsyncEnumerable.

Desta forma, podemos especificar nosso retorno como um enumerador assíncrono, de modo que possamos fazer streaming dos dados enquanto houverem conexões a este endpoint.

public async IAsyncEnumerable<DateTime> Streaming(CancellationToken cancellationToken)
{
    while (true)
    {
        yield return DateTime.UtcNow;
        await Task.Delay(1000, cancellationToken);
    }
}

É importante notar o uso do CancelationToken, que permite que a ação seja cancelada a qualquer momento.

Em adicional, usamos o yield (Produtor) para definir que o retorno é um iterador. Desta forma o cliente pode consumir direto nosso conteúdo, sem necessitar de uma classe para armazenar o estado.

Adicionando SignalR

Para adicionar suporte ao SignalR na nossa aplicação precisamos do builder.Services.AddSignalR(); e do app.MapHub<SeuHub>("ENDPOINT").

using Microsoft.AspNetCore.SignalR;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSignalR();

var app = builder.Build();
app.MapHub<MyHub>("/chat");
app.Run();

Resultado final

O código final. completo do nosso App com SignalR fica assim.

using Microsoft.AspNetCore.SignalR;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSignalR();

var app = builder.Build();
app.MapHub<MyHub>("/chat");
app.Run();


class MyHub : Hub
{
    public async IAsyncEnumerable<DateTime> Streaming(CancellationToken cancellationToken)
    {
        while (true)
        {
            yield return DateTime.UtcNow;
            await Task.Delay(1000, cancellationToken);
        }
    }
}

Executando

Agora basta executar o programa usando o comando:

dotnet watch run

Não esqueça de anotar a URL na qual seu servidor está rodando. Vamos precisar dela para nos conectar no cliente a seguir.

Trabalhando no Client

Para se conectar ao servidor, vamos criar um Console Application.

dotnet new console -o SignalClient
cd SignalClient
dotnet add package Microsoft.AspNetCore.SignalR.Client

Novamente, tudo o que precisamos para consumir um serviço SignalR é o pacote Microsoft.AspNetCore.SignalR.Client.

Conectando ao servidor

Para se conectar ao servidor precisamos do HubConnectionBuilder apenas.

using Microsoft.AspNetCore.SignalR.Client;

var uri = "https://localhost:7182/chat";

await using var connection = new HubConnectionBuilder().WithUrl(uri).Build();

Em seguida, podemos iniciar a conexão.

await connection.StartAsync();

Recebendo dados

Como utilizamos o IAsyncEnumerable, para receber os dados, podemos chamar a função StreamAsync<TIPO>("STREAM").

await foreach (var date in connection.StreamAsync<DateTime>("Streaming"))
{
    Console.WriteLine(date);
}

Como resultado final, temos o seguinte código:

using Microsoft.AspNetCore.SignalR.Client;

var uri = "https://localhost:7182/chat";

await using var connection = new HubConnectionBuilder().WithUrl(uri).Build();

await connection.StartAsync();

await foreach (var date in connection.StreamAsync<DateTime>("Streaming"))
{
    Console.WriteLine(date);
}

Conclusão

Assim como os Minimal APIs, outras implementações como ASP.NET SignalR também podem se beneficiar destas mudanças, tornando o ambiente mais simples.

Fontes

  • David Fowler
  • Código Fonte

Populares

Priority Queue

Priority Queue ou fila prioritária é um tipo de lista inclusa no C# 10 que permite que seus itens...


Implicit Operators no C#

Implicit Operators permitem adicionar comportamentos de conversão a objetos Built In ou complexos...


ASP.NET 5 – Autenticação e Autorização com Bearer e JWT

Este artigo atualmente utiliza a versão 5.0.0-rc.1 do ASP.NET/.NET, o que significa que ainda não...


Clean Code - Guia e Exemplos

Saiba como manter seu código limpo (Clean Code) seguindo algumas práticas sugeridas pelo Robert C...


Git e GitHub - Instalação, Configuração e Primeiros Passos

Git é um sistema de controle de versões distribuídas, enquanto GitHub é uma plataforma que tem o ...


Compartilhe este artigo



Conheça o autor

André Baltieri

André Baltieri

Microsoft MVP

Me dedico ao desenvolvimento de software desde 2003, sendo minha maior especialidade o Desenvolvimento Web. Durante esta jornada pude trabalhar presencialmente aqui no Brasil e Estados Unidos, atender remotamente times da ?ndia, Inglaterra e Holanda, receber 8x Microsoft MVP e realizar diversas consultorias em empresas e projetos de todos os tamanhos.





3.119

Aulas disponíveis

291

horas de conteúdo

76.349

Alunos matriculados

52.918

Certificados emitidos





Comece de graça agora mesmo!

Temos mais de 21 cursos totalmente de graça e todos com certificado de conclusão.

Começar


Prefere algo mais Premium?

Conheça nossos planos



Premium anual

Compra única, parcelada em até
12x no cartão de crédito


12x R$

99

,79

=R$ 1.197,44
  • 1 ano de acesso
  • Acesso à todo conteúdo
  • Emissão de Certificado
  • Tira Dúvidas Online
  • 66 cursos disponíveis
  • 10 carreiras disponíveis
  • 161 temas de tecnologia
  • Conteúdo novo todo mês
  • Encontros Premium

Começar agora

Política de privacidade



Precisa de ajuda?

Dúvidas frequentes



  • Posso começar de graça?

    Sim! Basta criar sua conta gratuita no balta.io e começar seus estudos. Nós contamos com diversos cursos TOTALMENTE gratuitos e com certificado de conclusão.

  • Vou ter que pagar algo?

    Nós temos cursos gratuitos e pagos, porém você não precisa informar nenhum dado de pagamento para começar seus estudos gratuitamente conosco. Os cursos gratuitos são completos e com certificado de conclusão, você não paga nada por eles.

    Porém, caso queira algo mais Premium , você terá acesso à diversos benefícios que vão te ajudar ainda mais em sua carreira.

  • Por onde devo começar?

    Siga SEMPRE as nossas Carreiras , elas vão te orientar em todos os sentidos. Os cursos já estão organizados em categorias e carreiras para facilitar seu aprendizado.
    Nossa sugestão para aprendizado é começar pelo Backend e seguindo para Frontend e Mobile.

    • Backend
    • Frontend
    • Mobile

  • Os cursos ensinam tudo que preciso?

    Nenhum curso no mundo vai te ensinar tudo, desculpa ser sincero! Os cursos são uma base, eles fornecem por volta de 30% do que você precisa aprender, o resto é com você, com dedicação e MUITA prática.

  • O que eu devo estudar?

    Java ou .NET? Angular ou React? Xamarin ou Flutter? A resposta é simples e direta: "Você já sabe o básico?"

    Se você ainda não sabe BEM o básico, ou seja, os fundamentos, OOP, SOLID, Clean Code, está perdendo tempo estudando Frameworks ou até coisas mais avançadas como Docker. Foque nos seus objetivos primeiro.
    Agora se você está indeciso sobre qual Framework estudar, a boa notícia é que o mercado neste momento está bem aquecido e você tem várias oportunidade. Desta forma o que levaríamos em conta para tomar esta decisão seria:

    • Já sei o básico
    • O Framework/Tecnologia tem mercado onde eu estou (região)
    • O Framework/Tecnologia é utilizado em uma empresa onde quero atual
    • O Framework/Tecnologia resolve meu problema
    • Eu gosto de utilizar o Framework/Tecnologia

  • Estou pronto para estudar no balta.io?

    Com certeza! O primeiro passo é começar e você pode fazer isto agora mesmo!

    Começar de graça

Ainda tem dúvidas?





Assine nosso Newsletter

Receba em primeira mão todas as nossas novidades.

Cadastrar


balta.io

Sobre

  • Como funciona?
  • Seja Premium
  • Agenda
  • Blog
  • Todos os cursos

Cursos

  • Frontend
  • Backend
  • Mobile
  • Fullstack

Suporte

  • Termos de uso
  • Privacidade
  • Cancelamento
  • Central de ajuda

Redes Sociais

  • Telegram
  • Facebook
  • Instagram
  • YouTube
  • Twitch
  • LinkedIn
  • Discord