Ocelot .NET（开发人员如何使用）

路由

Ocelot 功能的核心是其路由能力。 它根据开发者指定的配置将入站请求匹配到适当的服务路由，并可以与服务发现机制集成。 这包括对通配符路由的支持，这在处理不同的 API 版本或众多服务端点时特别有用。

中间件 / 委托处理程序

Ocelot 允许开发人员注入自定义中间件或处理程序，可以在请求到达客户端或服务之前处理请求和响应。这对于添加标头、记录请求或根据需要修改响应结构非常有用。

负载均衡

Ocelot 提供各种现成的负载均衡策略，如循环、最小连接数，以及自定义提供程序，如果没有预定义的策略适合需求。 此功能确保负载均匀分配给可用服务，从而提高应用程序的整体弹性和效率。

认证和授权

保护 API 端点至关重要，Ocelot 提供与现有认证提供程序（如 Identity Server）的集成支持。 它支持流行的认证方案，包括 JWT 和 OAuth2，并允许对用户访问服务进行细粒度控制。

速率限制和 QoS

速率限制对于防止滥用和确保公平使用服务至关重要，通过限制用户在给定时间段内可以发出的请求数量来实现。 服务质量（QoS）选项如设置超时和重试确保服务在各种网络条件和负载下保持可用和响应。

步骤 1：设置 .NET Core Web 应用程序

首先，创建一个新的 .NET Core Web API 项目。 您可以使用 .NET CLI 或 Visual Studio 进行此操作。

使用 .NET CLI：

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

步骤 2：添加必要的包

您需要安装 Ocelot 和 IronPDF。 您可以通过 NuGet 添加这些包。

dotnet add package Ocelot
dotnet add package IronPdf

dotnet add package Ocelot
dotnet add package IronPdf

步骤 3：配置 Ocelot

将一个 ocelot.json 文件添加到项目的根目录中，其中包含以下内容以配置 Ocelot 的路由。 此设置假定您希望 Ocelot 将 PDF 生成请求路由到将由 IronPDF 在同一应用程序中处理的特定路径。

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

步骤 4：配置 Startup.cs

更新 Startup.cs 以包括 Ocelot 的中间件。 确保您还配置应用程序使用静态文件，因为 IronPDF 可能需要从本地文件系统加载资源。

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();
    }
}

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddControllers()
		services.AddOcelot()
	End Sub

	Public Async Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		If env.IsDevelopment() Then
			app.UseDeveloperExceptionPage()
		End If

		app.UseRouting()
		app.UseAuthorization()

		app.UseEndpoints(Sub(endpoints)
			endpoints.MapControllers()
		End Sub)

		Await app.UseOcelot()
	End Sub
End Class

步骤 5：使用 IronPDF 实现 PDF 生成

在您的 Controllers 文件夹中创建一个新的控制器 PdfController.cs。 该控制器将处理 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");
        }
    }
}

Imports Microsoft.AspNetCore.Mvc
Imports IronPdf

Namespace OcelotWithIronPDF.Controllers
	<ApiController>
	<Route("api/[controller]")>
	Public Class PdfController
		Inherits ControllerBase

		<HttpPost>
		Public Function CreatePdfFromHtml(<FromBody> ByVal htmlContent As String) As IActionResult
			Dim renderer = New ChromePdfRenderer()
			Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
			Dim output = pdf.BinaryData

			' Return the PDF as a file result
			Return File(output, "application/pdf", "generated.pdf")
		End Function
	End Class
End Namespace

步骤 6：运行应用程序

确保您的应用程序已正确配置为侦听 ocelot.json 中指定的端口。 您可以在 Properties/launchSettings.json 中设置此项。

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

现在，运行您的应用程序，您应该能够将 HTML 内容发布到 http://localhost:5000/generatepdf 并接收 PDF 响应。

此示例展示了在同一应用程序中使用 Ocelot 和 IronPDF 的基本实现。 对于生产环境，请考虑保护您的端点、处理错误场景以及根据您的特定需求优化 PDF 生成过程。