Ocelot .NET (Cómo Funciona para Desarrolladores)

Enrutamiento

En el núcleo de la funcionalidad de Ocelot está su capacidad de enrutamiento. Coincide las solicitudes entrantes con las rutas de servicio adecuadas según la configuración especificada por los desarrolladores y puede integrarse con mecanismos de descubrimiento de servicios. Esto incluye soporte para enrutamiento de comodín, que es particularmente útil al tratar con versiones de API variables o numerosos puntos finales de servicio.

Middleware / Manejadores delegados

Ocelot permite a los desarrolladores inyectar middleware o manejadores personalizados que pueden procesar solicitudes y respuestas antes de que lleguen al cliente o al servicio. Esto es útil para agregar encabezados, registrar solicitudes o incluso modificar la estructura de la respuesta según sea necesario.

Equilibrio de carga

Ocelot admite una variedad de estrategias de balanceo de carga de forma predeterminada, como Round Robin, Conexión Mínima y un proveedor personalizado si ninguna de las estrategias predefinidas se ajusta a los requisitos. Esta característica garantiza que la carga se distribuya equitativamente entre los servicios disponibles, mejorando la resiliencia y eficiencia general de la aplicación.

Autenticación y autorización

Asegurar los puntos finales de la API es crítico, y Ocelot proporciona soporte para integrarse con los proveedores de autenticación existentes, como Identity Server. Admite esquemas de autenticación populares, incluyendo JWT y OAuth2, y permite un control detallado sobre el acceso de los usuarios a los servicios.

Limitación de velocidad y calidad de servicio

La limitación de tasa es esencial para prevenir el abuso y asegurar el uso adecuado de los servicios al limitar la cantidad de solicitudes que un usuario puede hacer en un período determinado. Las opciones de Calidad de Servicio (QoS) como el establecimiento de límites de tiempo y reintentos aseguran que los servicios permanezcan disponibles y respondan bajo diversas condiciones de red y cargas.

Paso 1: Configurar la aplicación web .NET Core

Primero, crea un nuevo proyecto de API Web .NET Core. Puedes hacerlo usando la CLI de .NET o Visual Studio.

Usando la CLI de .NET:

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

Paso 2: Añadir los paquetes necesarios

Necesitas instalar Ocelot e IronPDF. Puedes agregar estos paquetes vía NuGet.

dotnet add package Ocelot
dotnet add package IronPdf

dotnet add package Ocelot
dotnet add package IronPdf

Paso 3: Configurar Ocelot

Agrega un archivo ocelot.json a la raíz de tu proyecto con el siguiente contenido para configurar el enrutamiento de Ocelot. Esta configuración asume que quieres que Ocelot enroute las solicitudes de generación de PDF a un camino específico que será manejado por IronPDF dentro de la misma aplicación.

{
    "ReRoutes": [
        {
            "DownstreamPathTemplate": "/api/pdf",
            "DownstreamScheme": "https",
            "DownstreamHostAndPorts": [
                {
                    "Host": "localhost",
                    "Port": 5001
                }
            ],
            "UpstreamPathTemplate": "/generatepdf",
            "UpstreamHttpMethod": ["Post"]
        }
    ],
    "GlobalConfiguration": {
        "BaseUrl": "http://localhost:5000"
    }
}

Paso 4: Configurar Startup.cs

Actualiza Startup.cs para incluir el middleware de Ocelot. Asegúrate de configurar también tu aplicación para usar archivos estáticos, ya que IronPDF puede necesitar cargar archivos desde el sistema de archivos local.

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddOcelot();
    }

    public async void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });

        await app.UseOcelot();
    }
}

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        services.AddOcelot();
    }

    public async void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });

        await app.UseOcelot();
    }
}

Paso 5: Implementar la generación de PDF con IronPDF

Crea un nuevo controlador PdfController.cs en tu carpeta de Controllers. Este controlador manejará las solicitudes de generación de PDF.

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace OcelotWithIronPDF.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost]
        public IActionResult CreatePdfFromHtml([FromBody] string htmlContent)
        {
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            var output = pdf.BinaryData;

            // Return the PDF as a file result
            return File(output, "application/pdf", "generated.pdf");
        }
    }
}

using Microsoft.AspNetCore.Mvc;
using IronPdf;

namespace OcelotWithIronPDF.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost]
        public IActionResult CreatePdfFromHtml([FromBody] string htmlContent)
        {
            var renderer = new ChromePdfRenderer();
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            var output = pdf.BinaryData;

            // Return the PDF as a file result
            return File(output, "application/pdf", "generated.pdf");
        }
    }
}

Paso 6: Ejecutar la aplicación

Asegúrate de que tu aplicación esté correctamente configurada para escuchar en los puertos especificados en ocelot.json. Puedes establecer esto en Properties/launchSettings.json.

{
  "profiles": {
    "OcelotWithIronPDF": {
      "commandName": "Project",
      "launchBrowser": false,
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

Ahora, ejecuta tu aplicación y deberías poder enviar contenido HTML a http://localhost:5000/generatepdf y recibir un PDF como respuesta.

Este ejemplo muestra una implementación básica de Ocelot con IronPDF dentro de la misma aplicación. Para escenarios de producción, considera asegurar tus puntos finales, manejar escenarios de error y optimizar el proceso de generación de PDF según tus necesidades específicas.