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

JSON-RPC protokolüne dayalı istemci-sunucu uygulama iletişimini kolaylaştırmak ve iyileştirmek için tasarlanmış olan C#'ın StreamJsonRpc'i kapsamlı bir işlevsellik kümesi sağlar.

Uzak Prosedür Çağrıları (RPC)

StreamJsonRpc, uzak işlemleri yerel fonksiyon çağrıları gibi düşünerek, istemcilerin sunucuda metodları uzaktaki prosedür çağrıları aracılığıyla çağırmasına olanak tanır. Ağ iletişiminin karmaşıklıklarını gizleyerek, bu soyutlama dağıtılmış uygulamaların oluşturulmasını kolaylaştırır.

Çift Yönlü İletişim

Kitaplık, çift taraflı istemci-sunucu iletişimini destekler. Gerçek zamanlı iletişim ve güncellemeler, istemcilerin sunuculara istekler gönderebilmesi ve bunların bildirimler veya sonuçlarla yanıtlayabilmesi sayesinde mümkün olur.

Taşıma Katmanı Agnostisizmi

Taşıma katmanına karşı agnostik olduğundan, StreamJsonRpc, HTTP, Adlandırılmış Borular ve TCP/IP gibi çeşitli taşıma protokolleri üzerinde çalışabilir. Bu uyarlanabilirlik, geliştiricilerin uygulamalarının ihtiyaçlarına ve ağ ayarlarına göre en iyi taşıma yöntemini seçmelerine olanak tanır.

Serileştirme ve Seri Geri Açma

Çeşitli platformlar ve JSON destekleyen bilgisayar dilleri arasında sorunsuz iletişimi garanti eden JSON-RPC mesaj serileştirme ve seri geri açma işlemlerini yönetir.

İlerleme Raporlama

Uzun süren etkinlikler için StreamJsonRpc ilerleme raporlama tekniklerini destekler. Bu özellik, sunucuların mevcut süreçlerin durumu hakkında istemcileri güncelleyebilmesini sağlayarak kullanıcı deneyimini ve şeffaflığı artırır.

Hata Yönetimi

Kütüphane, uzaktan yöntemlerin çağrılması sırasında ortaya çıkan istisna ve problemleri yönetmek için kapsamlı hata işleme özelliklerine sahiptir. Bu, dağıtılmış sistemlerin dayanıklılığını ve güvenilirliğini garanti eder.

Genişletme Noktaları

Geliştiriciler, StreamJsonRpc'nin işlevselliğini değiştirmek veya zaten mevcut olan uygulama mimarileriyle entegre etmek için genişletebilirler. Çeşitli entegrasyon ihtiyaçlarını ve uygulama senaryolarını karşılayacak şekilde özelleştirilebilir olması sayesinde esneklik sağlanır.

Performans Optimizasyonu

Verimli özel mesaj işleme ve taşıma katmanı yönetimi yoluyla, StreamJsonRpc, istemci-sunucu iletişiminde verimi maksimize ederken düşük yüke garanti verir.

Asenkron Destek

Asenkron işlemler kullanarak, uygulamaların daha iyi yanıt verebilirlik ve ölçeklenebilirlik elde etmesine olanak tanır. Tamamen asenkron iletişim kalıplarını destekler.

Uyumluluk

JSON-RPC standardına uyum sağlayarak, StreamJsonRpc, JSON destekleyen diğer dillerde oluşturulmuş hizmetler ve C# uygulamaları arasında birlikte çalışabilirlik sağlayarak farklı ortamlarda sorunsuz entegrasyonu kolaylaştırır.

Ana özelliklerin yanı sıra, kompakt ikili serileştirme desteği ve dinamik istemci proxy gibi JSON-RPC spesifikasyonunun ötesinde bazı ek özellikler içerir.

Hizmet Sınıfı Oluşturma

Alınan verilerden PDF oluşturacak yöntemleri PdfService.cs hizmet sınıfında 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ırma

Program.cs'i StreamJsonRpc sunucusu üzerinde bir akış JSON-RPC aracılığıyla GeneratePdfAsync yöntemini sunmak için arayüz olarak 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şturma

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

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ı, bir C# uygulamasının IronPDF aracılığıyla PDF belgeleri üretmesini kolaylaştıran bir StreamJsonRpc sunucu uygulamasının temel bir parçasıdır. IronPDF'nin RenderHtmlAsPdf'ini kullanarak, bu hizmet sınıfı, HTML materyalini PDF formatına dönüştürme işlemini ele alan yöntemler içerir. HTML içeriği, asenkron olarak tanımlanan (async Task<byte[]> GeneratePdfAsync(string htmlContent)) GeneratePdfAsync yöntemi aracılığıyla girdi olarak kabul edilir.

Bu yöntem, bir ChromePdfRenderer örneği oluşturarak dönüşümü gerçekleştirmek ve RenderHtmlAsPdf(htmlContent) ile bir PDF belgesi üretmek için kullanılır. Oluşturulan PDF'nin ikili verileri daha sonra yöntem (pdf.BinaryDataAsync()) tarafından asenkron olarak alınır ve veriler bir byte[] dizisi olarak döndürülür.

Bu yöntem, hızlı ve tepki verebilir PDF oluşturulmasını garanti eder, böylece belgelerin hızlı bir şekilde üretilmesi gereken uygulamalar için uygundur. PDF oluşturma mantığı, geliştiricilerin bu işlevselliği StreamJsonRpc üzerinden entegre edip ortaya çıkarmasını basit hale getiren PdfService.cs içinde bulunur. Bu durum, uzak istemcilerin PDF oluşturma görevlerini sorunsuz bir şekilde yerine getirmelerine olanak tanırken, sunucu tarafı tasarımının modülerliği ve netliğini de korur.