1. O que é EasyNetQ e por que usar?

EasyNetQ é uma biblioteca cliente de alto nível e amigável para desenvolvedores que trabalham com RabbitMQ no ecossistema .NET (C#, F#, VB.NET). RabbitMQ é um popular message broker que implementa o protocolo AMQP (Advanced Message Queuing Protocol). Ele permite que diferentes partes de uma aplicação (microsserviços, tarefas em segundo plano, aplicações web) se comuniquem de forma assíncrona, confiável e com garantia de entrega.

Por que usar EasyNetQ se já existe o cliente oficial RabbitMQ para .NET (RabbitMQ.Client)? O cliente oficial é uma biblioteca de baixo nível. Ela fornece canais "brutos", exchanges, queues e exige que o desenvolvedor gerencie manualmente conexões, tópicos, serialização e tratamento de erros. Isso é poderoso, mas complexo e propenso a erros. EasyNetQ cuida de toda essa parte repetitiva, oferecendo uma API simples e intuitiva baseada em assinatura de eventos e envio de mensagens como objetos .NET comuns.

Principais vantagens do EasyNetQ:

• Simplicidade: Configuração mínima. Basta conectar e começar a enviar/receber mensagens.
• Automação: Gerencia automaticamente conexões, filas, exchanges e bindings.
• Pub/Sub nativo: Implementa os padrões "Publisher-Subscriber" (Publish/Subscribe) e "Work Queue" sem código extra.
• Serialização: Usa JSON (Newtonsoft.Json) para serialização de mensagens "pronta para uso".
• Gerenciamento de erros: Oferece mecanismos integrados de retry, tratamento de erros e Dead Letter Queue (DLQ).
• Mensagens tipadas: Você trabalha com objetos POCO, não com arrays de bytes.

EasyNetQ é a escolha ideal para a maioria dos projetos que precisam de comunicação assíncrona confiável, sem a necessidade ou vontade de mergulhar nos detalhes do protocolo AMQP. É perfeita para arquiteturas de microsserviços, processadores de tarefas em segundo plano, sistemas de notificação e integração entre aplicações.

2. Instalação

EasyNetQ é distribuído através do gerenciador de pacotes NuGet. Para instalar no seu projeto, use um dos seguintes comandos no Console do Gerenciador de Pacotes (Package Manager Console) ou no .NET CLI.

Via .NET CLI:

dotnet add package EasyNetQ

Via Package Manager Console (Visual Studio):

Install-Package EasyNetQ

Após instalar a biblioteca, certifique-se de que o servidor RabbitMQ está em execução. Se você usa Docker, a maneira mais fácil é executá-lo com o comando:

docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management

Isso inicia o RabbitMQ com a interface web de gerenciamento (acessível em http://localhost:15672, usuário/senha padrão: guest/guest).

3. Início rápido: exemplo mínimo funcional

Vamos criar uma aplicação console simples que envia e recebe uma mensagem.

using System;
using System.Threading.Tasks;
using EasyNetQ;

// 1. Definindo o tipo da mensagem
public class TextMessage
{
    public string Text { get; set; }
}

class Program
{