1. ¿Qué es EasyNetQ y por qué usarla?

EasyNetQ es una librería cliente de alto nivel y fácil de usar para trabajar con RabbitMQ en el ecosistema .NET (C#, F#, VB.NET). RabbitMQ es un popular broker de mensajes que implementa el protocolo AMQP (Advanced Message Queuing Protocol). Permite que diferentes partes de una aplicación (microservicios, tareas en segundo plano, aplicaciones web) se comuniquen entre sí de forma asíncrona, confiable y con garantía de entrega.

¿Por qué usar EasyNetQ si ya existe el cliente oficial de RabbitMQ para .NET (RabbitMQ.Client)? El cliente oficial es una librería de bajo nivel. Proporciona canales "crudos", exchanges, queues y requiere que el desarrollador gestione manualmente las conexiones, tópicos, serialización y manejo de errores. Es potente, pero complejo y propenso a errores. EasyNetQ se encarga de toda esa rutina, ofreciendo una API simple e intuitiva basada en la suscripción a eventos y el envío de mensajes como objetos .NET comunes.

Ventajas clave de EasyNetQ:

• Simplicidad: Mínima configuración. Solo te conectas y empiezas a enviar/recibir mensajes.
• Automatización: Gestiona automáticamente conexiones, colas, exchanges y bindings.
• Pub/Sub listo para usar: Implementa los patrones "Publicar/Suscribir" (Publish/Subscribe) y "Cola de trabajo" (Work Queue) sin código adicional.
• Serialización: Usa JSON (Newtonsoft.Json) para serializar mensajes de forma predeterminada.
• Manejo de errores: Proporciona mecanismos integrados de reintentos, manejo de errores y cola de mensajes fallidos (Dead Letter Queue).
• Mensajes tipados: Trabajas con objetos POCO, no con arreglos de bytes.

EasyNetQ es la opción ideal para la mayoría de proyectos que necesitan una comunicación asíncrona confiable, sin la necesidad o el deseo de profundizar en los detalles del protocolo AMQP. Es perfecta para arquitecturas de microservicios, procesadores de tareas en segundo plano, sistemas de notificaciones e integración entre aplicaciones.

2. Instalación

EasyNetQ se distribuye a través del administrador de paquetes NuGet. Para instalarlo en tu proyecto, usa uno de los siguientes comandos en la Consola del Administrador de Paquetes (Package Manager Console) o en la CLI de .NET.

Mediante .NET CLI:

dotnet add package EasyNetQ

Mediante Package Manager Console (Visual Studio):

Install-Package EasyNetQ

Después de instalar la librería, asegúrate de tener un servidor RabbitMQ en ejecución. Si usas Docker, la forma más sencilla de iniciarlo es con el siguiente comando:

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

Esto inicia RabbitMQ con una interfaz web de administración (accesible en http://localhost:15672, usuario/contraseña por defecto: guest/guest).

3. Inicio rápido: ejemplo mínimo funcional

Vamos a crear una aplicación de consola simple que envía y recibe un mensaje.

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

// 1. Definimos el tipo de mensaje
public class TextMessage
{
    public string Text { get; set; }
}

class Program
{