NServiceBus es un bus de servicio poderoso y adaptable diseñado para .NET Framework que simplifica el desarrollo de sistemas distribuidos. Los patrones de mensajería sólidos que ofrece garantizan el manejo y entrega confiables de mensajes a través de varios microservicios y aplicaciones. NServiceBus abstrae la arquitectura de mensajería subyacente, permitiendo a los desarrolladores concentrarse en la lógica de negocio en lugar de las complejidades de construir sistemas distribuidos.
En contraste, IronPDF es una biblioteca .NET muy popular para generar, ver y modificar archivos PDF. Es bien conocido por ser fácil de usar y muy eficiente en la creación de PDFs desde varias fuentes, como archivos ASPX y HTML.
Los desarrolladores pueden construir sistemas de software confiables, escalables y mantenibles que generen y gestionen documentos PDF como parte de sus operaciones comerciales combinando NServiceBus e IronPDF.
En este artículo, veremos cómo configurar un simple proyecto C# NServiceBus e integrarlo con IronPDF, para que puedas construir un flujo de trabajo optimizado para gestionar y producir documentos PDF en una arquitectura de aplicación distribuida. Después de leer este tutorial introductorio, deberías saber exactamente cómo estas dos tecnologías efectivas pueden cooperar para simplificar tus tareas relacionadas con PDF en un entorno distribuido.
NServiceBus es un marco poderoso y adaptable que facilita crear sistemas distribuidos y arquitecturas orientadas a servicios en .NET. Al utilizar NServiceBus, puedes gestionar fácilmente varios tipos de mensajes y asegurar una comunicación confiable. Esto es crucial, particularmente en una aplicación web y arquitecturas similares donde el enrutamiento y procesamiento sin inconvenientes de mensajes son esenciales. Los handlers de mensajes de NServiceBus manejan eficazmente la recepción de mensajes, asegurando que cada componente lógico interactúe sin problemas. NServiceBus tiene las siguientes características importantes:
NServiceBus fomenta la comunicación basada en mensajes entre diferentes servicios o componentes en un sistema. Al desacoplar componentes, este método crea diseños que son más fáciles de escalar y gestionar.
Al gestionar automáticamente reintentos, colas de mensajes muertos y otras técnicas de tolerancia a fallos, garantiza una entrega de mensajes confiable. En sistemas distribuidos, donde las interrupciones de red y otros problemas de fallos son frecuentes, esta confiabilidad es esencial.
El patrón de publicación/suscripción es compatible con NServiceBus, permitiendo a los servicios publicar eventos y permitir que otros servicios se suscriban a estos eventos. Esto hace posibles arquitecturas impulsadas por eventos, en las que las modificaciones realizadas en eventos en un componente del sistema pueden provocar respuestas en otros componentes.
Los procesos comerciales de larga duración pueden ser gestionados con NServiceBus gracias a su soporte integrado para sagas. Las sagas permiten que la plataforma de servicios maneje el estado y coordine operaciones complejas entre varios servicios.
Ofrece un nivel excepcional de extensibilidad, permitiendo a los desarrolladores personalizar la gestión, procesamiento y transporte de mensajes. Gracias a su adaptabilidad, puede utilizarse en una variedad de escenarios.
Numerosos sistemas de mensajería, incluidos MSMQ, RabbitMQ, Azure Service Bus, Amazon SQS, entre otros, pueden integrarse con NServiceBus. Esto permite a los desarrolladores seleccionar la solución de infraestructura de comunicaciones que mejor se adapte a sus requerimientos.
Primero debes configurar tu entorno de desarrollo, crear un proyecto básico y construir un servicio de mensajería y escenario básico antes de comenzar a usar NServiceBus en un proyecto C#. Aquí tienes una guía paso a paso para comenzar.
En Visual Studio, el proceso de crear un proyecto de consola es sencillo. Usa estos sencillos pasos en el entorno de Visual Studio para lanzar una Aplicación de Consola:
Asegúrese de haber instalado Visual Studio en su PC antes de usarlo.
Haz clic en Archivo, luego selecciona Nuevo, y finalmente Proyecto.
Puedes seleccionar la plantilla "Aplicación de Consola" o "Aplicación de Consola (.NET Core)" de la lista de referencias de plantillas de proyectos a continuación.
Proporciona un nombre para tu proyecto en el campo "Nombre".
Elige una ubicación de almacenamiento para el proyecto.
Hacer clic en "Crear" iniciará el proyecto de aplicación de consola.
Navega a Herramientas > Administrador de Paquetes NuGet > Consola del Administrador de Paquetes para abrir la Consola del Administrador de Paquetes NuGet.
Ejecuta el siguiente comando para instalar el paquete NuGet de NServiceBus.
El transporte es necesario para que NServiceBus reciba y envíe mensajes. Optaremos por el Transporte de Aprendizaje, ya que es fácil de usar y funciona bien para pruebas y desarrollo.
Instala el paquete para el Transporte de Aprendizaje ejecutando.
Configure la configuración del endpoint NServiceBus en su archivo Program.cs:
using NServiceBus;
using System;
using System.Threading.Tasks;
using Messages;
class Program
{
static async Task Main()
{
Console.Title = "Sender";
var endpointConfiguration = new EndpointConfiguration("SenderEndpoint");
// Use RabbitMQ Transport
var transport = endpointConfiguration.UseTransport<RabbitMQTransport>();
transport.ConnectionString("host=localhost");
// Set up error queue
endpointConfiguration.SendFailedMessagesTo("error");
// Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit");
// Start the endpoint
var endpointInstance = await Endpoint.Start(endpointConfiguration).ConfigureAwait(false);
Console.WriteLine("Press Enter to send a message...");
Console.ReadLine();
// Send a message
var message = new MyMessage
{
Content = "Hello, NServiceBus with RabbitMQ!"
};
await endpointInstance.Send("ReceiverEndpoint", message).ConfigureAwait(false);
Console.WriteLine("Message sent. Press Enter to exit...");
Console.ReadLine();
// Stop the endpoint
await endpointInstance.Stop().ConfigureAwait(false);
}
}Imports NServiceBus
Imports System
Imports System.Threading.Tasks
Imports Messages
Class Program
Shared Async Function Main() As Task
Console.Title = "Sender"
Dim endpointConfiguration = New EndpointConfiguration("SenderEndpoint")
' Use RabbitMQ Transport
Dim transport = endpointConfiguration.UseTransport(Of RabbitMQTransport)()
transport.ConnectionString("host=localhost")
' Set up error queue
endpointConfiguration.SendFailedMessagesTo("error")
' Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit")
' Start the endpoint
Dim endpointInstance = Await Endpoint.Start(endpointConfiguration).ConfigureAwait(False)
Console.WriteLine("Press Enter to send a message...")
Console.ReadLine()
' Send a message
Dim message = New MyMessage With {
.Content = "Hello, NServiceBus with RabbitMQ!"
}
Await endpointInstance.Send("ReceiverEndpoint", message).ConfigureAwait(False)
Console.WriteLine("Message sent. Press Enter to exit...")
Console.ReadLine()
' Stop the endpoint
Await endpointInstance.Stop().ConfigureAwait(False)
End Function
End Class
Para representar el mensaje, agrega una nueva clase.
public class MyMessage : IMessage
{
public string Content { get; set; }
}Public Class MyMessage
Implements IMessage
Public Property Content As String
End ClassPara manejar el mensaje, agrega una nueva clase.
using NServiceBus;
using System.Threading.Tasks;
public class MyMessageHandler : IHandleMessages<MyMessage>
{
public Task Handle(MyMessage message, IMessageHandlerContext context)
{
Console.WriteLine($"Received message: {message.Content}");
return Task.CompletedTask;
}
}Imports NServiceBus
Imports System.Threading.Tasks
Public Class MyMessageHandler
Implements IHandleMessages(Of MyMessage)
Public Function Handle(ByVal message As MyMessage, ByVal context As IMessageHandlerContext) As Task
Console.WriteLine($"Received message: {message.Content}")
Return Task.CompletedTask
End Function
End ClassEnvía un mensaje desde el Endpoint. Adapta tu método principal para transmitir un mensaje con la ayuda del handler.
using NServiceBus;
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
Console.Title = "Receiver";
var endpointConfiguration = new EndpointConfiguration("ReceiverEndpoint");
// Serialization configuration
endpointConfiguration.UseSerialization<NewtonsoftJsonSerializer>();
// Use RabbitMQ Transport
var transport = endpointConfiguration.UseTransport<RabbitMQTransport>();
transport.UseConventionalRoutingTopology(QueueType.Quorum);
transport.ConnectionString("host=localhost");
// Set up error queue
endpointConfiguration.SendFailedMessagesTo("error");
// Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit");
endpointConfiguration.EnableInstallers();
// Start the endpoint
var endpointInstance = await Endpoint.Start(endpointConfiguration).ConfigureAwait(false);
Console.WriteLine("Press Enter to exit...");
Console.ReadLine();
// Stop the endpoint
await endpointInstance.Stop().ConfigureAwait(false);
}
}Imports NServiceBus
Imports System
Imports System.Threading.Tasks
Module Program
Sub Main()
MainAsync().GetAwaiter().GetResult()
End Sub
Private Async Function MainAsync() As Task
Console.Title = "Receiver"
Dim endpointConfiguration = New EndpointConfiguration("ReceiverEndpoint")
' Serialization configuration
endpointConfiguration.UseSerialization(Of NewtonsoftJsonSerializer)()
' Use RabbitMQ Transport
Dim transport = endpointConfiguration.UseTransport(Of RabbitMQTransport)()
transport.UseConventionalRoutingTopology(QueueType.Quorum)
transport.ConnectionString("host=localhost")
' Set up error queue
endpointConfiguration.SendFailedMessagesTo("error")
' Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit")
endpointConfiguration.EnableInstallers()
' Start the endpoint
Dim endpointInstance = Await Endpoint.Start(endpointConfiguration).ConfigureAwait(False)
Console.WriteLine("Press Enter to exit...")
Console.ReadLine()
' Stop the endpoint
Await endpointInstance.Stop().ConfigureAwait(False)
End Function
End Module
Inicia la aplicación y construye el proyecto. La consola debería mostrar el mensaje "Mensaje recibido: ¡Hola, NServiceBus!"
En un proyecto de C#, integrar NServiceBus con RabbitMQ e IronPDF implica configurar mensajes entre NServiceBus y RabbitMQ, así como usar IronPDF para crear PDFs. Aquí tienes un cómo hacerlo detallado para comenzar:
IronPDF es una biblioteca .NET diseñada para crear, leer, editar y convertir archivos PDF. Con ella, los programadores pueden trabajar con archivos PDF en aplicaciones C# o VB.NET con una herramienta poderosa e intuitiva. Las características y capacidades de IronPDF se describen completamente a continuación:
Generación de PDF desde HTML
Convierte JavaScript, HTML y CSS a PDF. Soporta consultas de medios y diseño responsivo, dos estándares web contemporáneos. Útil para producir documentos PDF dinámicamente estilizados, facturas e informes usando HTML y CSS.
Edición de PDF
A PDFs ya existentes, añade texto, imágenes y otros materiales. Extrae texto e imágenes de archivos PDF. Combina varios PDFs en un archivo. Divide archivos PDF en varios documentos. Incluye anotaciones, pies de página, encabezados y marcas de agua.
Conversión de PDF
Convierte Word, Excel, imágenes y otros formatos de archivo a PDF. Conversión de PDF a imagen (PNG, JPEG, etc.).
Rendimiento y Fiabilidad
El alto rendimiento y la confiabilidad son los objetivos de diseño en entornos de producción. Administra eficientemente documentos grandes.
Instala IronPDF abriendo la Consola del Administrador de Paquetes NuGet.
Mensajes es un proyecto compartido (librería de clases) que el remitente y el destinatario utilizarán ambos. Define la clase de mensaje en el proyecto de Mensajes. Crea un nuevo proyecto de Librería de Clases llamado Mensajes y añádelo a la solución.
Definir el mensaje:
Dentro del proyecto Messages, cree una nueva clase llamada GeneratePdfMessage.cs:
using NServiceBus;
public class GeneratePdfMessage : IMessage
{
public string Content { get; set; }
public string OutputPath { get; set; }
}Imports NServiceBus
Public Class GeneratePdfMessage
Implements IMessage
Public Property Content() As String
Public Property OutputPath() As String
End ClassEn los proyectos tanto del Remitente como del Receptor, incluye una referencia al proyecto de Mensajes.
Configura el endpoint de NServiceBus en el proyecto del Remitente para usar RabbitMQ para la entrega de mensajes.
using NServiceBus;
using System;
using System.Threading.Tasks;
using Messages;
class Program
{
static async Task Main()
{
Console.Title = "Sender";
var endpointConfiguration = new EndpointConfiguration("SenderEndpoint");
// Use RabbitMQ Transport
var transport = endpointConfiguration.UseTransport<RabbitMQTransport>();
transport.ConnectionString("host=localhost");
// Set up error queue
endpointConfiguration.SendFailedMessagesTo("error");
// Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit");
endpointConfiguration.EnableInstallers();
// Start the endpoint
var endpointInstance = await Endpoint.Start(endpointConfiguration).ConfigureAwait(false);
Console.WriteLine("Press Enter to send a message...");
Console.ReadLine();
// Send a message
var message = new GeneratePdfMessage
{
Content = "<h1>Hello, NServiceBus with RabbitMQ and IronPDF!</h1>",
OutputPath = "output.pdf"
};
await endpointInstance.Send("ReceiverEndpoint", message).ConfigureAwait(false);
Console.WriteLine("Message sent. Press Enter to exit...");
Console.ReadLine();
// Stop the endpoint
await endpointInstance.Stop().ConfigureAwait(false);
}
}Imports NServiceBus
Imports System
Imports System.Threading.Tasks
Imports Messages
Friend Class Program
Shared Async Function Main() As Task
Console.Title = "Sender"
Dim endpointConfiguration As New EndpointConfiguration("SenderEndpoint")
' Use RabbitMQ Transport
Dim transport = endpointConfiguration.UseTransport(Of RabbitMQTransport)()
transport.ConnectionString("host=localhost")
' Set up error queue
endpointConfiguration.SendFailedMessagesTo("error")
' Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit")
endpointConfiguration.EnableInstallers()
' Start the endpoint
Dim endpointInstance = Await Endpoint.Start(endpointConfiguration).ConfigureAwait(False)
Console.WriteLine("Press Enter to send a message...")
Console.ReadLine()
' Send a message
Dim message = New GeneratePdfMessage With {
.Content = "<h1>Hello, NServiceBus with RabbitMQ and IronPDF!</h1>",
.OutputPath = "output.pdf"
}
Await endpointInstance.Send("ReceiverEndpoint", message).ConfigureAwait(False)
Console.WriteLine("Message sent. Press Enter to exit...")
Console.ReadLine()
' Stop the endpoint
Await endpointInstance.Stop().ConfigureAwait(False)
End Function
End ClassConfiguración del Endpoint: el endpoint se inicializa con el nombre "SenderEndpoint" llamando a new EndpointConfiguration("SenderEndpoint").
endpointConfiguration es la configuración de transporte. Conectándose a una instancia local de RabbitMQ, el método UseTransport() configura NServiceBus para usar RabbitMQ como el mecanismo de transporte.
Las colas de auditoría y errores donde enviar mensajes fallidos y auditar mensajes procesados se configuran utilizando SendFailedMessagesTo("error") y AuditProcessedMessagesTo("audit"), respectivamente.
Mensaje Enviado: endpointInstance.Send("ReceiverEndpoint", message) envía un GeneratePdfMessage al "ReceiverEndpoint".
Configura el endpoint de NServiceBus en el proyecto del Receptor para aceptar mensajes a través de RabbitMQ y producir PDFs usando IronPDF.
using NServiceBus;
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
Console.Title = "Receiver";
var endpointConfiguration = new EndpointConfiguration("ReceiverEndpoint");
// Use RabbitMQ Transport
var transport = endpointConfiguration.UseTransport<RabbitMQTransport>();
transport.ConnectionString("host=localhost");
// Set up error queue
endpointConfiguration.SendFailedMessagesTo("error");
// Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit");
// Start the endpoint
var endpointInstance = await Endpoint.Start(endpointConfiguration).ConfigureAwait(false);
Console.WriteLine("Press Enter to exit...");
Console.ReadLine();
// Stop the endpoint
await endpointInstance.Stop().ConfigureAwait(false);
}
}Imports NServiceBus
Imports System
Imports System.Threading.Tasks
Module Program
Async Function Main() As Task
Console.Title = "Receiver"
Dim endpointConfiguration = New EndpointConfiguration("ReceiverEndpoint")
' Use RabbitMQ Transport
Dim transport = endpointConfiguration.UseTransport(Of RabbitMQTransport)()
transport.ConnectionString("host=localhost")
' Set up error queue
endpointConfiguration.SendFailedMessagesTo("error")
' Set up audit queue
endpointConfiguration.AuditProcessedMessagesTo("audit")
' Start the endpoint
Dim endpointInstance = Await Endpoint.Start(endpointConfiguration).ConfigureAwait(False)
Console.WriteLine("Press Enter to exit...")
Console.ReadLine()
' Stop the endpoint
Await endpointInstance.Stop().ConfigureAwait(False)
End Function
End ModuleEsta configuración, para el endpoint receptor "ReceiverEndpoint", es comparable a la configuración del Remitente.
En el proyecto Receiver, cree una nueva clase llamada GeneratePdfMessageHandler.cs.
using NServiceBus;
using System;
using System.Threading.Tasks;
using Messages;
using IronPdf;
public class GeneratePdfMessageHandler : IHandleMessages<GeneratePdfMessage>
{
public Task Handle(GeneratePdfMessage message, IMessageHandlerContext context)
{
Console.WriteLine($"Received message to generate PDF with content: {message.Content}");
// Generate PDF
var renderer = new HtmlToPdf();
var pdf = renderer.RenderHtmlAsPdf(message.Content);
pdf.SaveAs(message.OutputPath);
Console.WriteLine($"PDF generated and saved to: {message.OutputPath}");
return Task.CompletedTask;
}
}Imports NServiceBus
Imports System
Imports System.Threading.Tasks
Imports Messages
Imports IronPdf
Public Class GeneratePdfMessageHandler
Implements IHandleMessages(Of GeneratePdfMessage)
Public Function Handle(message As GeneratePdfMessage, context As IMessageHandlerContext) As Task Implements IHandleMessages(Of GeneratePdfMessage).Handle
Console.WriteLine($"Received message to generate PDF with content: {message.Content}")
' Generate PDF
Dim renderer As New HtmlToPdf()
Dim pdf = renderer.RenderHtmlAsPdf(message.Content)
pdf.SaveAs(message.OutputPath)
Console.WriteLine($"PDF generated and saved to: {message.OutputPath}")
Return Task.CompletedTask
End Function
End ClassGeneratePdfMessageHandler utiliza la interfaz IHandleMessages para manejar mensajes del tipo GeneratePdfMessage.
Método Handle: Después de recibir el mensaje, la función Handle crea un PDF usando IronPDF. El contenido HTML en el mensaje se convierte en un PDF mediante el código del renderizador HtmlToPdf, que luego lo guarda en la ruta de salida designada.
NServiceBus puede integrarse con RabbitMQ e IronPDF en C# para proporcionar una solución escalable y estable para sistemas distribuidos que necesitan generar PDFs de manera dinámica y confiable. Esta combinación utiliza las capacidades de procesamiento de mensajes de NServiceBus, la fiabilidad y adaptabilidad de RabbitMQ como un broker de mensajes, y las robustas herramientas de edición de PDF de IronPDF. El desacoplamiento entre servicios se asegura con la arquitectura resultante, permitiendo una evolución autónoma y escalabilidad.
RabbitMQ también asegura la entrega de mensajes incluso en caso de fallos de red o bloqueos de la aplicación. NServiceBus hace que el enrutamiento y procesamiento de mensajes sea más sencillo, e IronPDF hace posible convertir texto HTML en documentos PDF de alta calidad. Esta integración ofrece un marco flexible para desarrollar aplicaciones sofisticadas a gran escala, además de mejorar la mantenibilidad y fiabilidad del sistema.
Por último, al añadir IronPDF e Iron Software a tu kit de herramientas para programación .NET, puedes trabajar eficazmente con códigos de barras, generar PDFs, realizar OCR y enlazar con Excel. Página de Licencias de IronPDF, que comienza en $999, combina sin problemas sus características y el rendimiento, compatibilidad y facilidad de uso de la página oficial de Iron Software flexible suite para proporcionar aplicaciones web adicionales y capacidades y un desarrollo más eficiente.
Si hay opciones de licencia bien definidas que están personalizadas a los requerimientos específicos del proyecto, los desarrolladores pueden seleccionar el modelo óptimo con confianza. Estos beneficios permiten a los desarrolladores manejar una variedad de dificultades de manera eficaz y transparente.
Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
