Ocelot .NET（對於開發者的運行原理）

路由

Ocelot 的功能核心是其路由能力。 它根據開發人員指定的配置，將來自客戶端的請求匹配到相應的服務路由，並可以與服務發現機制整合。 這包括對通配符路由的支持，這在處理不同 API 版本或眾多服務端點時特別有用。

中介層 / 委託處理程序

Ocelot 允許開發人員注入自定義中介層或處理程序，這可以在請求和響應到達客戶端或服務之前處理它們。這對於添加標頭、記錄請求或根據需要修改響應結構非常有用。

負載均衡

Ocelot 支持多種負載均衡策略，例如輪詢、最小連接和自訂提供者，若預定義策略都不適合需求。 此功能確保負載在可用服務之間均勻分配，增強了應用程式的整體彈性和效率。

身份驗證和授權

保護 API 端點至關重要，而 Ocelot 提供了與現有身份驗證提供者（如 Identity Server）整合的支持。 它支持流行的身份驗證方案，包括 JWT 和 OAuth2，允許對用戶訪問服務進行細粒度控制。

速率限制和質量保證

速率限制對於防止濫用和確保服務的公平使用至關重要，限製用戶在給定時間內可以發出的請求數量。 服務質量（QoS）選項如設置超時和重試，確保服務在各種網路條件和負載下保持可用和響應。

步驟 1：設置 .NET Core 網頁應用程式

首先，創建一個新的 .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 生成過程。