streamjsonrpc c# (Geliştiriciler İçin Nasıl Çalışır)

C#'un StreamJsonRpc'si, JSON-RPC protokol temelli istemci-sunucu uygulama iletişimini kolaylaştırma ve iyileştirme amacına yönelik kapsamlı bir işlevsellik koleksiyonu sunar.

Uzak Yöntem Çağrıları (RPC)

StreamJsonRpc, istemcilerin uzaktaki bir sunucuda, uzak yöntem çağrıları vasıtasıyla yöntemleri çağırmalarını sağlar. Uzak işlemleri yerel fonksiyon çağrıları olarak ele alır. Ağ iletişimi ince noktalarını maskeler, bu soyutlama dağıtık uygulamalar oluşturmayı kolaylaştırır.

Çift Yönlü İletişim

Kütüphane, çift yönlü istemci-sunucu iletişimini destekler. Gerçek zamanlı iletişim ve güncellemeler, istemcilerin sunuculara istek göndermelerini ve sunucuların yanıt olarak bildirimlerde veya sonuçlarda bulunmalarına olanak tanır.

Taşıma Katmanı Agnostiği

StreamJsonRpc'nin taşıma katmanı agnostiği olması, HTTP, Named Pipes ve TCP/IP dahil olmak üzere çeşitli taşıma protokolleri üzerinde çalışabilmesini sağlar. Bu uyarlanabilirlik sayesinde, geliştiriciler uygulama gereksinimlerine ve ağ ayarlarına göre en iyi taşıma yöntemini seçebilir.

Serileştirme ve Serisini Destekleme

JSON-RPC mesajlarının serileştirilmesini ve serisini yönetir, farklı platformlar ve JSON yetenekli bilgisayar dilleri arasında sorunsuz iletişimi garantiler.

İlerleme Raporlaması

StreamJsonRpc, uzun süreli etkinlikler için ilerleme raporlama tekniklerini destekler. Bu özellik, kullanıcı deneyimini ve şeffaflığı artırır ve sunucuların devam eden süreçlerin durumu hakkında istemcileri bilgilendirmesine olanak sağlar.

Hata Yönetimi

Uzaktan yöntemlerin çağrılması sırasında ortaya çıkan istisnalar ve sorunlar için kapsamlı hata işleme özelliklerine sahiptir. Bu, dağıtılmış sistemlerin dayanıklılığını ve güvenilirliğini garantiler.

Genişleme Noktaları

StreamJsonRpc, geliştiriciler tarafından işlevselliğini değiştirmek veya mevcut uygulama mimarileriyle birleştirmek için genişletilebilir. Esnek yapısı sayesinde çeşitli entegrasyon gereksinimlerine ve uygulama senaryolarına uyarlanabilir.

Performans Optimizasyonu

Verimli özel mesaj işleme ve taşıma katmanı yönetimi aracılığıyla, StreamJsonRpc, istemci-sunucu iletişiminde verimliliği en üst düzeye çıkarır ve düşük yük garantiler.

Asenkron Destek

Asenkron işlemleri kullanarak, uygulamaların iyileştirilmiş yanıt verme ve ölçeklenebilirlik kazanmalarını sağlar. Asenkron iletişim paternlerini tamamen destekler.

İşler Arası Çalışabilirlik

JSON-RPC standardına uyum sağlayarak, StreamJsonRpc, JSON'u destekleyen diğer dillerdeki hizmetlerle birlikte çalışarak, farklı bağlamlarda sorunsuz entegrasyona yol açar.

JSON-RPC spesifikasyonunun ötesinde, sıkı ikili seri yazımı ve dinamik istemci proxy gibi özellikler içerir.

Bir Hizmet Sınıfı Oluşturun

Alınan verilerden PDF oluşturacak yöntemleri hizmet sınıfı PdfService.cs'da sağlayın. Bir örnek olarak:

using IronPdf;
using System.IO;
using System.Threading.Tasks;

public class PdfService
{
    // Asynchronously generates a PDF from HTML content
    public async Task<byte[]> GeneratePdfAsync(string htmlContent)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        return await pdf.BinaryDataAsync();
    }
}

using IronPdf;
using System.IO;
using System.Threading.Tasks;

public class PdfService
{
    // Asynchronously generates a PDF from HTML content
    public async Task<byte[]> GeneratePdfAsync(string htmlContent)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        return await pdf.BinaryDataAsync();
    }
}

Imports IronPdf
Imports System.IO
Imports System.Threading.Tasks

Public Class PdfService
	' Asynchronously generates a PDF from HTML content
	Public Async Function GeneratePdfAsync(ByVal htmlContent As String) As Task(Of Byte())
		Dim renderer = New ChromePdfRenderer()
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		Return Await pdf.BinaryDataAsync()
	End Function
End Class

StreamJsonRpc Sunucusunu Yapılandırın

StreamJsonRpc için, GeneratePdfAsync yöntemini bir akış JSON-RPC üzerinden sunmak için sunucuda arayüz olarak Program.cs kullanın:

using StreamJsonRpc;
using System;
using System.Net.WebSockets;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialize PdfService which generates PDFs
        var service = new PdfService();

        // Create JSON-RPC server listening on websockets
        var jsonRpc = new JsonRpc(new WebSocketRpcServerMessageHandler(new Uri("ws://localhost:8080")));

        // Add the PdfService as an RPC target
        jsonRpc.AddLocalRpcTarget(service);

        // Start listening for incoming JSON-RPC requests
        jsonRpc.StartListening();

        Console.WriteLine("JsonRpc server listening on ws://localhost:8080");
        Console.WriteLine("Press any key to stop the server...");

        // Wait for user input to stop the server
        Console.ReadKey();

        // Gracefully stop listening and dispose resources when done
        await jsonRpc.StopListeningAsync();
        jsonRpc.Dispose();
    }
}

using StreamJsonRpc;
using System;
using System.Net.WebSockets;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Initialize PdfService which generates PDFs
        var service = new PdfService();

        // Create JSON-RPC server listening on websockets
        var jsonRpc = new JsonRpc(new WebSocketRpcServerMessageHandler(new Uri("ws://localhost:8080")));

        // Add the PdfService as an RPC target
        jsonRpc.AddLocalRpcTarget(service);

        // Start listening for incoming JSON-RPC requests
        jsonRpc.StartListening();

        Console.WriteLine("JsonRpc server listening on ws://localhost:8080");
        Console.WriteLine("Press any key to stop the server...");

        // Wait for user input to stop the server
        Console.ReadKey();

        // Gracefully stop listening and dispose resources when done
        await jsonRpc.StopListeningAsync();
        jsonRpc.Dispose();
    }
}

Imports StreamJsonRpc
Imports System
Imports System.Net.WebSockets
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Initialize PdfService which generates PDFs
		Dim service = New PdfService()

		' Create JSON-RPC server listening on websockets
		Dim jsonRpc As New JsonRpc(New WebSocketRpcServerMessageHandler(New Uri("ws://localhost:8080")))

		' Add the PdfService as an RPC target
		jsonRpc.AddLocalRpcTarget(service)

		' Start listening for incoming JSON-RPC requests
		jsonRpc.StartListening()

		Console.WriteLine("JsonRpc server listening on ws://localhost:8080")
		Console.WriteLine("Press any key to stop the server...")

		' Wait for user input to stop the server
		Console.ReadKey()

		' Gracefully stop listening and dispose resources when done
		Await jsonRpc.StopListeningAsync()
		jsonRpc.Dispose()
	End Function
End Class

IronPDF İstemcisi Oluştur

Sunucuya bağlanmak ve bir PDF oluşturma talebinde bulunmak için StreamJsonRpc istemcisini uygulayın (ClientProgram.cs):

using StreamJsonRpc;
using System;
using System.Net.WebSockets;
using System.Text;
using System.Threading.Tasks;
using System.IO;

class ClientProgram
{
    static async Task Main(string[] args)
    {
        // Create JSON-RPC client connected to WebSocket server endpoint
        var proxy = new JsonRpc(new WebSocketRpcClientMessageHandler(new Uri("ws://localhost:8080")));

        // Start listening for incoming messages from the server
        await proxy.StartListeningAsync();

        // Example HTML content
        string htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

        // Invoke GeneratePdfAsync method on the server
        var pdfBytes = await proxy.InvokeAsync<byte[]>("GeneratePdfAsync", htmlContent);

        // Save the resulted PDF to a file
        File.WriteAllBytes("GeneratedPdf.pdf", pdfBytes);

        Console.WriteLine("PDF generated: GeneratedPdf.pdf");

        // Dispose the proxy when done
        proxy.Dispose();
    }
}

using StreamJsonRpc;
using System;
using System.Net.WebSockets;
using System.Text;
using System.Threading.Tasks;
using System.IO;

class ClientProgram
{
    static async Task Main(string[] args)
    {
        // Create JSON-RPC client connected to WebSocket server endpoint
        var proxy = new JsonRpc(new WebSocketRpcClientMessageHandler(new Uri("ws://localhost:8080")));

        // Start listening for incoming messages from the server
        await proxy.StartListeningAsync();

        // Example HTML content
        string htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

        // Invoke GeneratePdfAsync method on the server
        var pdfBytes = await proxy.InvokeAsync<byte[]>("GeneratePdfAsync", htmlContent);

        // Save the resulted PDF to a file
        File.WriteAllBytes("GeneratedPdf.pdf", pdfBytes);

        Console.WriteLine("PDF generated: GeneratedPdf.pdf");

        // Dispose the proxy when done
        proxy.Dispose();
    }
}

Imports StreamJsonRpc
Imports System
Imports System.Net.WebSockets
Imports System.Text
Imports System.Threading.Tasks
Imports System.IO

Friend Class ClientProgram
	Shared Async Function Main(ByVal args() As String) As Task
		' Create JSON-RPC client connected to WebSocket server endpoint
		Dim proxy = New JsonRpc(New WebSocketRpcClientMessageHandler(New Uri("ws://localhost:8080")))

		' Start listening for incoming messages from the server
		Await proxy.StartListeningAsync()

		' Example HTML content
		Dim htmlContent As String = "<html><body><h1>Hello, IronPDF!</h1></body></html>"

		' Invoke GeneratePdfAsync method on the server
		Dim pdfBytes = Await proxy.InvokeAsync(Of Byte())("GeneratePdfAsync", htmlContent)

		' Save the resulted PDF to a file
		File.WriteAllBytes("GeneratedPdf.pdf", pdfBytes)

		Console.WriteLine("PDF generated: GeneratedPdf.pdf")

		' Dispose the proxy when done
		proxy.Dispose()
	End Function
End Class

PdfService.cs sınıfı, IronPDF kullanarak bir C# uygulamasının PDF belgeleri oluşturmasını kolaylaştıran StreamJsonRpc sunucu uygulamasının temel bir parçasıdır. IronPDF'in RenderHtmlAsPdf kullanılarak, bu hizmet sınıfı HTML materyalini PDF formatına dönüştürme yöntemlerini içerir. HTML içeriği, asenkron olarak atanan (async Task<byte[]> GeneratePdfAsync(string htmlContent)) GeneratePdfAsync yöntemi üzerinden giriş olarak kabul edilir.

Bu yöntem, dönüşümü gerçekleştirmek için bir ChromePdfRenderer örneği oluşturur ve RenderHtmlAsPdf(htmlContent) içeren bir PDF belgesi üretir. Oluşturulan PDF'in ikili verisi, daha sonra asenkron olarak geri getirilir (pdf.BinaryDataAsync()) ve ardından veri byte[] dizisi olarak geri döndürülür.

Bu yöntem hızlı ve duyarlı PDF oluşturma garantiler ve belgelerin hızla üretilmesi gereken uygulamalar için uygun hale getirir. PDF oluşturma mantığı, geliştiricilerin bu işlevi StreamJsonRpc üzerinden entegre etmesini ve açığa çıkarmasını kolaylaştıran PdfService.cs içerisinde yer alır. Bu, uzak istemcilerin PDF oluşturma görevlerini modülerliği ve sunucu tarafı tasarımın netliğini koruyarak pürüzsüz bir şekilde çağırmalarını sağlar.