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

路由

Ocelot 功能的核心是其路由能力。 它依據開發人員指定的配置匹配傳入的請求到適當的服務路由，並且可以與服務發現機制整合。 這包括對通配符路由的支持，在處理不同版本的 API 或大量伺服器端點時特別有用。

中介軟體 / 委派處理器

Ocelot 允許開發者注入自定義中介軟體或處理器，可以在請求和回應在到達客戶端或服務之前進行處理。這對於新增標頭、請求日誌紀錄甚至在需要時修改回應結構非常有用。

負載平衡

Ocelot 支持多種現成的負載平衡策略，如輪詢、最少連接等，如果預先定義的策略都不合適，還有自定義提供者。 這個功能確保負載在可用服務之間均勻分配，提高應用程式的整體彈性和效率。

身份驗證和授權

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

速率限制和服務質量

速率限制對於防止濫用和確保公平使用服務至關重要，限制使用者在特定時間內可以發出的請求數量。 服務質量選項如設置超時和重試確保服務在不同的網路狀況和負載下保持可用和響應。

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

首先，建立一個新的 .NET Core Web API 專案。 您可以使用 .NET CLI 或 Visual Studio 來執行此操作。 using .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> 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 生成過程。