Mediatr C# (Cómo Funciona para Desarrolladores)

Introducción al patrón mediador y MediatR

El patrón mediador es un patrón de diseño de software que facilita la interacción entre objetos de una manera que reduce las dependencias directas entre ellos, promoviendo un acoplamiento débil. MediatR proporciona una implementación de mediador sin pretensiones, centrándose en la simplicidad y la eficiencia en facilitar la comunicación entre objetos.

En el corazón de la biblioteca MediatR está el concepto de solicitudes y múltiples manejadores. En el punto de solicitud, un objeto encapsula los detalles de la operación o acción, esperando ser procesado por el mecanismo de MediatR. Cada solicitud es manejada por un manejador o método de manejo correspondiente, que contiene la lógica de negocio para ejecutar la solicitud. Esta estructura es particularmente útil para implementar el patrón de Separación de Responsabilidades de Consultas y Comandos (CQRS), donde la separación de operaciones de lectura y escritura puede llevar a arquitecturas de software más mantenibles y escalables.

Instalación de MediatR en un proyecto .NET Core mediante la consola del gestor de paquetes

Para comenzar a usar MediatR en un proyecto ASP.NET Core, primero necesitas instalar el paquete MediatR. Esto se puede hacer a través de la Consola del Administrador de Paquetes en Visual Studio con el siguiente comando:

Install-Package MediatR

Después de instalar el paquete, es necesario agregar MediatR al contenedor de inyección de dependencia de ASP.NET Core. Esto se hace típicamente en el archivo Program.cs o Startup.cs de tu proyecto de aplicación web, dependiendo de la versión de ASP.NET Core que estés utilizando. Aquí te mostramos cómo hacerlo en un programa con una capa de presentación de API mínima.

// Initialize a new web application
var builder = WebApplication.CreateBuilder(args);

// Add MediatR to the service container
builder.Services.AddMediatR(typeof(Program).Assembly);

// Build the web application
var app = builder.Build();

// Initialize a new web application
var builder = WebApplication.CreateBuilder(args);

// Add MediatR to the service container
builder.Services.AddMediatR(typeof(Program).Assembly);

// Build the web application
var app = builder.Build();

En la clase del programa, var builder = WebApplication.CreateBuilder(args); inicializa la aplicación web, preparando el escenario para la integración con MediatR.

Crear su primera solicitud y gestor de MediatR

Las solicitudes de MediatR son clases simples que representan los datos necesarios para realizar una operación específica. Aquí tienes un ejemplo de una clase de solicitud que representa un comando para crear un nuevo usuario.

public class CreateUserCommand : IRequest<int>
{
    public string Name { get; set; }
    public string Email { get; set; }
    public int Id { get; set; }
}

public class CreateUserCommand : IRequest<int>
{
    public string Name { get; set; }
    public string Email { get; set; }
    public int Id { get; set; }
}

En este ejemplo, la clase CreateUserCommand implementa la interfaz IRequest, indicando que esta solicitud espera una respuesta entera, que podría representar la ID del usuario creado.

A continuación, necesitas crear un manejador para esta solicitud. Dentro de cada manejador, el método Handle es donde se ejecuta la lógica de la solicitud:

public class CreateUserHandler : IRequestHandler<CreateUserCommand, int>
{
    public async Task<int> Handle(CreateUserCommand command, CancellationToken token)
    {
        // Implement logic to create a user here
        // For this example, let's pretend we create a user and return the ID
        return await Task.FromResult(1); // Assume the user's ID is 1
    }
}

public class CreateUserHandler : IRequestHandler<CreateUserCommand, int>
{
    public async Task<int> Handle(CreateUserCommand command, CancellationToken token)
    {
        // Implement logic to create a user here
        // For this example, let's pretend we create a user and return the ID
        return await Task.FromResult(1); // Assume the user's ID is 1
    }
}

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsersController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<int>> Create(CreateUserCommand command)
    {
        var userId = await _mediator.Send(command);
        return CreatedAtRoute("GetUser", new { id = userId }, command);
    }
}

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMediator _mediator;

    public UsersController(IMediator mediator)
    {
        _mediator = mediator;
    }

    [HttpPost]
    public async Task<ActionResult<int>> Create(CreateUserCommand command)
    {
        var userId = await _mediator.Send(command);
        return CreatedAtRoute("GetUser", new { id = userId }, command);
    }
}

Introducción a la biblioteca IronPDF

IronPDF es una biblioteca C# diseñada para desarrolladores .NET que necesitan una forma sencilla de crear, editar y trabajar con archivos PDF en sus aplicaciones sin preocupaciones de escritura. Los desarrolladores pueden generar PDFs sin participar con APIs complejas simplemente convirtiendo páginas web o código HTML directamente en formato PDF. IronPDF no se limita solo a crear PDFs; también ofrece características para editar PDFs, como añadir texto, imágenes y páginas, o incluso completar y editar formularios dentro de documentos PDF. Los desarrolladores pueden trabajar de manera exhaustiva con PDFs, incluyendo tareas como fusionar, dividir y asegurar archivos PDF con contraseñas y permisos.

IronPDF se especializa en la conversión de HTML a PDF preservando los diseños y estilos originales con precisión. Esto lo hace ideal para generar PDFs desde contenido basado en la web como informes, facturas y documentación. Admite la conversión de archivos HTML, URLs e incluso cadenas HTML en bruto a archivos PDF.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

public class PdfGenerator
{
    public void CreatePdfWithMediaInfo(string htmlContent)
    {
        // Insert your License Key here if required
        License.LicenseKey = "License-Key";

        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Create an HTML template with media information
        string htmlTemplate = $@"
            <html>
            <head>
                <title>Media Information</title>
            </head>
            <body>
                <h1>Media Details</h1>
                <!-- Insert your media information here -->
                {htmlContent}
            </body>
            </html>";

        // Convert the HTML string to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);
        pdfDocument.SaveAs("MediaInformation.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Example HTML content with MediatR information
        string htmlContent = @"
            <div>
                <h2>MediatR Information</h2>
                <p>MediatR is a media tracking system...</p>
            </div>";

        // Create an instance of PdfGenerator
        PdfGenerator pdfGenerator = new PdfGenerator();

        // Call the CreatePdfWithMediaInfo method to generate the PDF
        pdfGenerator.CreatePdfWithMediaInfo(htmlContent);

        Console.WriteLine("PDF generated successfully.");
    }
}

using IronPdf;

public class PdfGenerator
{
    public void CreatePdfWithMediaInfo(string htmlContent)
    {
        // Insert your License Key here if required
        License.LicenseKey = "License-Key";

        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Create an HTML template with media information
        string htmlTemplate = $@"
            <html>
            <head>
                <title>Media Information</title>
            </head>
            <body>
                <h1>Media Details</h1>
                <!-- Insert your media information here -->
                {htmlContent}
            </body>
            </html>";

        // Convert the HTML string to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);
        pdfDocument.SaveAs("MediaInformation.pdf");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Example HTML content with MediatR information
        string htmlContent = @"
            <div>
                <h2>MediatR Information</h2>
                <p>MediatR is a media tracking system...</p>
            </div>";

        // Create an instance of PdfGenerator
        PdfGenerator pdfGenerator = new PdfGenerator();

        // Call the CreatePdfWithMediaInfo method to generate the PDF
        pdfGenerator.CreatePdfWithMediaInfo(htmlContent);

        Console.WriteLine("PDF generated successfully.");
    }
}

Conclusión

Siguiendo los pasos descritos en este artículo, ahora deberías tener una base sólida para incorporar MediatR en tus proyectos, comenzando desde el manejo básico de comandos y consultas hasta el aprovechamiento de características avanzadas como notificaciones y comportamientos. A medida que tu aplicación crece y evoluciona, MediatR ofrece herramientas y patrones que pueden ayudar a mantener tu base de código limpia, mantenible y escalable.

Al concluir, vale la pena mencionar que explorar e integrar diferentes bibliotecas y herramientas, como IronPDF, puede mejorar aún más tus proyectos .NET. IronPDF ofrece una prueba gratuita de características avanzadas de PDF. Para proyectos que requieren características avanzadas de PDF, las licencias de IronPDF comienzan desde $799, ofreciendo una solución robusta para desarrolladores .NET que buscan ampliar las funcionalidades de su aplicación.