Ocelot .NET (Geliştiriciler için Nasıl Çalışır)

Yönlendirme

Ocelot'un işlevselliğinin merkezinde yer alan yönlendirme yeteneğidir. Geliştiriciler tarafından belirlenen yapılandırmaya dayanarak gelen istekleri uygun hizmet yollarına eşleştirir ve hizmet keşif mekanizmaları ile entegre edilebilir. Bu, özellikle değişen API sürümleri veya çok sayıda hizmet uç noktası ile uğraşırken yararlı olan joker yönlendirme desteğini içerir.

Orta katman / Yetkilendirme İşleyicileri

Ocelot, geliştiricilerin özelleştirilmiş orta katman veya işleyiciler ekleyerek, isteklerin ve yanıtların müşteriye veya hizmete ulaşmadan önce işlenmesini sağlamalarına imkan tanır. Bu, başlık eklemek, istekleri kaydetmek veya gerekirse yanıt yapısını değiştirmek için kullanışlıdır.

Yük Dengeleme

Ocelot, kutudan çıktığı haliyle, Round Robin, En Az Bağlantı ve önceden tanımlanmış stratejilerden uygun olmayanlar için bir özel sağlayıcı gibi çeşitli yük dengeleme stratejilerini destekler. Bu özellik, yükün mevcut servisler arasında eşit şekilde dağıtılmasını sağlayarak uygulamanın genel dayanıklılığını ve verimliliğini artırır.

Kimlik Doğrulama ve Yetkilendirme

API uç noktalarının güvenliğini sağlamak önemlidir ve Ocelot, Kimlik Sunucusu gibi mevcut kimlik doğrulama sağlayıcıları ile entegrasyonu destekler. JWT ve OAuth2 gibi popüler kimlik doğrulama şemalarını desteklemektedir; kullanıcıların servislere erişimi üzerinde ince ayar kontrolü sağlar.

Oran Sınırlaması ve Hizmet Kalitesi

Kullanıcının belirli bir süre içinde yapabileceği isteklerin sayısını sınırlandırarak hizmetlerin kötüye kullanılmasını önlemek ve adil kullanımını sağlamak için oran sınırlaması esastır. Zaman aşımı ve tekrar deneme gibi Hizmet Kalitesi (QoS) seçenekleri, çeşitli ağ koşulları ve yükler altında hizmetlerin kullanılabilir ve duyarlı kalmasını sağlar.

Adım 1: .NET Core Web Uygulamasını Kurma

Öncelikle, yeni bir .NET Core Web API projesi oluşturun. .NET CLI veya Visual Studio kullanarak bunu yapabilirsiniz.

.NET CLI kullanılarak:

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

dotnet new webapi -n OcelotWithIronPDF
cd OcelotWithIronPDF

Adım 2: Gerekli Paketleri Ekleyin

Ocelot ve IronPDF'i yüklemeniz gerekiyor. Bu paketleri NuGet üzerinden ekleyebilirsiniz.

dotnet add package Ocelot
dotnet add package IronPdf

dotnet add package Ocelot
dotnet add package IronPdf

Adım 3: Ocelot'u Yapılandırın

Ocelot'un yönlendirmesini yapılandırmak için projenizin köküne şu içeriğe sahip bir ocelot.json dosyası ekleyin. Bu kurulum, Ocelot'un PDF oluşturma isteklerini aynı uygulama içerisinde IronPDF'e yönlendirmek istediğinizi varsayar.

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

Adım 4: Startup.cs'yi Yapılandırın

Startup.cs dosyanızda Ocelot'un ara yazılımını ekleyecek şekilde güncelleyin. IronPDF'in yerel dosya sisteminden varlıkları yüklemesi gerekebileceği için, statik dosyaları kullanmak amacıyla uygulamanızı da yapılandırın.

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

Adım 5: IronPDF ile PDF Oluşturmayı Gerçekleştirin

Kontrolörler klasörünüzde yeni bir PdfController.cs kontrolörü oluşturun. Bu kontrolör PDF oluşturma isteklerini işleyecektir.

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

Adım 6: Uygulamayı Çalıştırın

Uygulamanızın, ocelot.json dosyasında belirtilen portlarda dinlemek üzere doğru bir şekilde yapılandırıldığından emin olun. Bunu Properties/launchSettings.json dosyasında ayarlayabilirsiniz.

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

Şimdi uygulamanızı çalıştırın, HTML içeriğini http://localhost:5000/generatepdf'e gönderebilmelisiniz ve yanıt olarak bir PDF alabilirsiniz.

Bu örnek, aynı uygulama içinde Ocelot ve IronPDF'in temel bir uygulamasını sergilemektedir. Üretim senaryoları için, uç noktalarınızı güvence altına almayı, hata senaryolarını ele almayı ve PDF oluşturma sürecini, özel gereksinimlerinize göre optimize etmeyi değerlendirin.