Microsoft.Extensions .DependencyInjection .NET 9 (PDF ile Çalışma)

Bağımlılık Enjeksiyonu Kabı

1. Servis Kaydı: Bağımlılıklar, genellikle uygulamanın bileşim kökünde bir DI konteynerine kaydedilir. Bu kayıtlar, kapsülün bağımlılıkları nasıl oluşturup yönetmesi gerektiğini belirtir.

2. Bağımlılığın Çözülmesi: Bir bileşen bir bağımlılık talebinde bulunduğunda, DI kapsülleyicisi bir uzantı metodu kullanan kayıtlı bir tipin bir örneğini oluşturarak bağımlılığı çözer.

Bağımlılık Enjeksiyonu Türleri

Yapıcı İnjeksiyonu: Kayıtlı hizmetler, bir sınıfa yapıcısı aracılığıyla sağlanır ve bu, en yaygın ve önerilen Bağımlılık İnjeksiyonu (DI) biçimidir. Yöntem Enjeksiyonu: Servisler çözülür ve bir metoda parametre olarak aktarılır. Özellik Enjeksiyonu: Singleton servisler veya belirli bir yaşam döngüsüne sahip servisler sınıf özelliklerine atanabilir. Ancak, bu yaklaşım daha az yaygındır ve genellikle yapıcı enjeksiyonuna göre daha düşük olarak değerlendirilir çünkü gizli bağımlılıklara neden olabilir.

Dependency Injection (DI) Ömrünü Anlama: Scoped, Transient ve Singleton

1. Scoped: "Scoped" bağımlılıklar, her bir istekte veya yaşam ömrü kapsamı boyunca bir kez oluşturulur; yani kapsayıcı aynı istekte veya işlemde aynı örneği sağlar. Bu tutarlılık, kapsamlı bağımlılıkların bir web isteği boyunca kararlı bir bağımlılığı sürdürmeye yardımcı olduğu web uygulamalarında özellikle kullanışlıdır.
2. Geçici: Geçici bağımlılıklar, konteynerdan her istendiğinde yeniden oluşturulurlar. Bu, geçici bir bağımlılığın her ihtiyaç duyulduğunda yeni bir örneğinin oluşturulduğunu ima eder. Genellikle, geçici bağımlılıklar hafif, durumsuz hizmetler veya bileşenler için kullanılır.
3. Singleton: Singleton bağımlılıkları, yalnızca bir kez oluşturulur ve uygulamanın tüm ömrü boyunca paylaşılır. Bu, uygulamanın süresi boyunca tüm istekler için singleton bağımlılığın aynı örneğinin kullanılmasını sağlar. Singleton bağımlılıkları, genellikle tüm uygulama genelinde evrensel olarak erişilebilir olması gereken durumsal hizmetler veya bileşenler için kullanılır.

Microsoft.Extensions.DependencyInjection paketi Yükleme

Install-Package Microsoft.Extensions.DependencyInjection

Örnek: Temel Bağımlılık Enjeksiyonu

Bu örnekte, bir hizmet sağlayıcısı kullanarak servisleri çözeceğimiz ve programımıza enjekte edeceğimiz bir örnek uygulama (konsol uygulaması) oluşturalım.

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

using Microsoft.Extensions.DependencyInjection;
using System;

// Define a service interface
public interface IMessageService
{
    void SendMessage(string message);
}

// Implement the service interface
public class ConsoleMessageService : IMessageService
{
    public void SendMessage(string message)
    {
        Console.WriteLine(message); // Output the message to the console
    }
}

Imports Microsoft.Extensions.DependencyInjection
Imports System

' Define a service interface
Public Interface IMessageService
	Sub SendMessage(ByVal message As String)
End Interface

' Implement the service interface
Public Class ConsoleMessageService
	Implements IMessageService

	Public Sub SendMessage(ByVal message As String) Implements IMessageService.SendMessage
		Console.WriteLine(message) ' Output the message to the console
	End Sub
End Class

Kod parçacığı, bir arayüz IMessageService oluşturur, mesaj gönderme konusunda nasıl bir sözleşme yapılacağı gibi. ConsoleMessageService sınıfı, mesajları göndermek için Console.WriteLine kullanarak bu arayüzü uygular. Bu ayrım, mesajların nasıl iletildiğinden bağımsız olarak gönderme konseptinin değiştirilmesine olanak tanır, böylece sistemi esnek ve yönetilebilir hale getirir.

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

class Program
{
    static void Main(string[] args)
    {
        // Create a service provider
        var serviceProvider = new ServiceCollection()
            // Register the service implementation
            .AddTransient<IMessageService, ConsoleMessageService>()
            .BuildServiceProvider();

        // Resolve the service
        var messageService = serviceProvider.GetRequiredService<IMessageService>();

        // Use the service to send a message
        messageService.SendMessage("Hello, From Dependency Injection!");
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a service provider
		Dim serviceProvider = (New ServiceCollection()).AddTransient(Of IMessageService, ConsoleMessageService)().BuildServiceProvider()

		' Resolve the service
		Dim messageService = serviceProvider.GetRequiredService(Of IMessageService)()

		' Use the service to send a message
		messageService.SendMessage("Hello, From Dependency Injection!")
	End Sub
End Class

Bu kod, hizmetleri yönetmek için bir serviceProvider kurar. Bu, IMessageService için uygulama olarak ConsoleMessageService'yi kaydeder ve gereken her yere enjekte edilebilir hale getirir. Main yöntemi daha sonra IMessageService örneğini serviceProvider'dan alır ve bunu bir mesajı konsola göndermek için kullanır.

Çıktı: Program, "Hello, From Dependency Injection!" mesajını yazdırır.

IronPDF: C# PDF Kütüphanesi

IronPDF, PDF oluşturma işlemini basitleştiren ve PDF manipülasyonu için geniş bir özellik yelpazesi sunan güçlü bir C# kütüphanesidir. HTML'den PDF oluşturma, PDF'lere metin ekleme ve resimlerle PDF düzenleme, güvenli belgeler oluşturma ve çok daha fazlası gibi yetenekleri içerir.

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

public interface IPdfService
{
    void GeneratePdf(string baseUrl, string query, string filePath);
}

Public Interface IPdfService
    Sub GeneratePdf(baseUrl As String, query As String, filePath As String)
End Interface

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

using IronPdf;
using System;
using System.Web;

// Implement the PDF generation interface
public class IronPdfService : IPdfService
{
    public void GeneratePdf(string baseUrl, string query, string filePath)
    {
        License.LicenseKey = "Your-License-Key"; // Set the IronPDF license key
        string encodedQuery = HttpUtility.UrlEncode(query); // Encode the query string
        string fullUrl = $"{baseUrl}?query={encodedQuery}"; // Construct the full URL
        var renderer = new ChromePdfRenderer(); // Create a PDF renderer
        var pdf = renderer.RenderUrlAsPdf(fullUrl); // Render the PDF from the URL
        pdf.SaveAs(filePath); // Save the PDF to the specified file path
        Console.WriteLine($"PDF successfully created from: {fullUrl}");
        Console.WriteLine($"Saved to: {filePath}");
    }
}

Imports IronPdf
Imports System
Imports System.Web

' Implement the PDF generation interface
Public Class IronPdfService
	Implements IPdfService

	Public Sub GeneratePdf(ByVal baseUrl As String, ByVal query As String, ByVal filePath As String)
		License.LicenseKey = "Your-License-Key" ' Set the IronPDF license key
		Dim encodedQuery As String = HttpUtility.UrlEncode(query) ' Encode the query string
		Dim fullUrl As String = $"{baseUrl}?query={encodedQuery}" ' Construct the full URL
		Dim renderer = New ChromePdfRenderer() ' Create a PDF renderer
		Dim pdf = renderer.RenderUrlAsPdf(fullUrl) ' Render the PDF from the URL
		pdf.SaveAs(filePath) ' Save the PDF to the specified file path
		Console.WriteLine($"PDF successfully created from: {fullUrl}")
		Console.WriteLine($"Saved to: {filePath}")
	End Sub
End Class

builder.Services.AddSingleton<IPdfService, IronPdfService>();

builder.Services.AddSingleton<IPdfService, IronPdfService>();

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

public class MyController : Controller
{
    private readonly IPdfService _pdfService;

    public MyController(IPdfService pdfService)
    {
        _pdfService = pdfService;
    }

    public IActionResult GeneratePdf()
    {
        string baseUrl = "https://ironpdf.com/";
        string query = "Hello World from IronPDF !";
        string filePath = "Demo.pdf";

        // Use the injected PDF service to generate a PDF
        _pdfService.GeneratePdf(baseUrl, query, filePath);

        return View();
    }
}

Public Class MyController
	Inherits Controller

	Private ReadOnly _pdfService As IPdfService

	Public Sub New(ByVal pdfService As IPdfService)
		_pdfService = pdfService
	End Sub

	Public Function GeneratePdf() As IActionResult
		Dim baseUrl As String = "https://ironpdf.com/"
		Dim query As String = "Hello World from IronPDF !"
		Dim filePath As String = "Demo.pdf"

		' Use the injected PDF service to generate a PDF
		_pdfService.GeneratePdf(baseUrl, query, filePath)

		Return View()
	End Function
End Class

Sonuç

Microsoft.Extensions.DependencyInjection, bağımlılık enjeksiyonunu uygulamak için .NET 6'da güçlü bir araç olup yazılım uygulamalarında gevşek bağlılığı destekler ve test edilebilirliği artırır. IronPDF, zengin özelliklere sahip bir C# kütüphanesi olarak entegre edilerek, geliştiriciler az bir çabayla kolayca kapsamlı PDF belgeleri üretebilirler. IronPDF için Lisanslama mevcuttur.