Microsoft.Extensions.DependencyInjection .NET 9 (Trabajando con PDF)

Contenedor de inyección de dependencias

1. Registro de Servicios: Las dependencias se registran en un contenedor DI, típicamente en la raíz de composición de la aplicación. Estos registros especifican cómo el contenedor debe crear y gestionar las dependencias.

2. Resolución de Dependencias: Cuando un componente solicita una dependencia, el contenedor DI resuelve la dependencia creando una instancia de un tipo registrado que utiliza un método de extensión.

Tipos de inyección de dependencia

• Inyección de Constructor: Los servicios registrados se proporcionan a una clase a través de su constructor, que es la forma más común y recomendada de DI.
• Inyección de Método: Los servicios se resuelven y pasan como parámetros a un método.
• Inyección de Propiedades: Los servicios singleton o servicios con un tiempo de vida limitado pueden asignarse a las propiedades de una clase. Sin embargo, este enfoque es menos común y a menudo se considera inferior a la inyección de constructor porque puede introducir dependencias ocultas.

Comprensión de los tiempos de vida en la inyección de dependencia (DI): Scoped, Transient, and Singleton

1. Limitado: Las dependencias limitadas se crean una vez por solicitud o ámbito de vida, lo que significa que el contenedor proporciona la misma instancia dentro de una sola solicitud u operación. Esta consistencia es particularmente útil en aplicaciones web, donde las dependencias limitadas ayudan a mantener una dependencia estable a lo largo de una solicitud web.
2. Transitorio: Las dependencias transitorias se instancian cada vez que se solicitan desde el contenedor. Esto implica que se genera una nueva instancia de una dependencia transitoria cada vez que se necesita. Típicamente, las dependencias transitorias se usan para servicios livianos, sin estado o componentes.
3. Singleton: Las dependencias singleton se instancian solo una vez y se comparten a lo largo de toda la vida de la aplicación. Esto asegura que se use la misma instancia de una dependencia singleton para todas las solicitudes a lo largo de la duración de la aplicación. Las dependencias singleton se emplean típicamente para servicios con estado o componentes que necesitan ser accesibles de manera universal en toda la aplicación.

Instalación del paquete Microsoft.Extensions.DependencyInjection

Install-Package Microsoft.Extensions.DependencyInjection

Ejemplo: Inyección de dependencia básica

En este ejemplo, vamos a crear una aplicación de muestra (aplicación de consola) en la que utilizaremos un proveedor de servicios para resolver servicios e inyectarlos en nuestro programa.

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

El fragmento de código crea una interfaz IMessageService para enviar mensajes, como un contrato sobre cómo deben enviarse los mensajes. La clase ConsoleMessageService implementa esta interfaz usando Console.WriteLine para enviar mensajes. Esta separación permite que el concepto de enviar mensajes se cambie independientemente de cómo se envían, haciendo que el sistema sea flexible y manejable.

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

Este código configura un serviceProvider para gestionar los servicios. Registra ConsoleMessageService como la implementación para IMessageService, haciéndolo disponible para ser inyectado donde sea necesario. El método Main luego recupera una instancia de IMessageService del serviceProvider y la usa para enviar un mensaje a la consola.

Salida: El programa imprime el mensaje de cadena "¡Hola, desde la Inversión de Dependencias!"

IronPDF: Biblioteca PDF C

IronPDF es una potente biblioteca para C# que simplifica el complejo proceso de generación de PDF, ofreciendo una amplia gama de características para la manipulación de PDF, incluyendo la capacidad de generar PDFs desde HTML, operar agregando texto a PDFs y editar PDFs con imágenes, crear documentos seguros, y mucho más.

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

builder.Services.AddSingleton<IPdfService, IronPdfService>();

builder.Services.AddSingleton<IPdfService, IronPdfService>();

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

Conclusión

Microsoft.Extensions.DependencyInjection es una herramienta poderosa en .NET 6 para implementar la inyección de dependencias, que promueve el acoplamiento flexible y mejora la testabilidad en las aplicaciones. Al integrar IronPDF, una biblioteca de C# rica en características, los desarrolladores pueden generar fácilmente documentos PDF integrales con un esfuerzo mínimo. La licencia para IronPDF está disponible.