streamjsonrpc c#（對開發者如何理解的工作）

C#的StreamJsonRpc提供了一套全面的功能，旨在促進和改善基於JSON-RPC協定的客戶端-服務端應用程式通信。

遠端程序呼叫（RPC）

StreamJsonRpc允許客戶端通過遠端程序呼叫在伺服器上調用方法，如同它們是本地功能調用一樣。 此抽象屏蔽了網路通信的複雜性，讓分布式應用程式的創建變得更加簡便。

雙向通信

程式庫支持雙向的客戶端-服務端通信。 客戶端能向伺服器提交請求，而伺服器則能以通知或結果回應，這使得即時通信與更新成為可能。

傳輸層不可知性

由於它對傳輸層不可知，StreamJsonRpc可以在多種傳輸協定上運行，包括HTTP、命名管道和TCP/IP。這種適應性讓開發者可以根據應用和網路設定需求選擇最好的傳輸方法。

序列化與反序列化

它管理JSON-RPC消息的序列化和反序列化，確保跨多平台和支持JSON的計算機語言的順暢通信。

進度報告

StreamJsonRpc支持長期運行活動的進度報告技術。 這功能透過允許伺服器更新客戶端當前進程的狀態，以提高用戶體驗和透明度。

錯誤處理

程式庫具有廣泛的錯誤處理功能以應對遠端方法調用期間發生的例外和問題。 這確保分布式系統的彈性和可靠性。

擴展點

開發者可擴展StreamJsonRpc來改變其功能或將之與現有的應用架構整合。 由於其多樣性，它可以根據不同的整合需求和應用場景進行調整。

性能優化

透過有效的自定義消息處理和傳輸層管理，StreamJsonRpc在客戶端-服務端通信中最大化吞吐量，同時確保低開銷。

異步支持

透過使用異步作業，它使應用程序達成改善的響應能力和可擴展性。 它完全支持異步通信模式。

互通性

透過順應JSON-RPC標準，StreamJsonRpc促進了多樣的上下文整合，促進C#應用程序與其他支援JSON語言構建的服務的互通性。

除了這些主要功能之外，還包含一些越過JSON-RPC規則的附加功能，例如對緊湊的二進制序列化和動態客戶代理的支持。

創建服務類

提供在服務類中PdfService.cs的方法，將從接收到的數據生成PDF。 作為例證：

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();
    }
}

配置StreamJsonRpc伺服器

在伺服器上使用GeneratePdfAsync方法在流JSON-RPC上：

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();
    }
}

創建IronPDF客戶端

要連接到伺服器並請求創建PDF，實現StreamJsonRpc客戶端(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();
    }
}

PdfService.cs類是StreamJsonRpc伺服器實現的基本組成部分，方便C#應用程式使用IronPDF來生成PDF文檔。 藉由利用IronPDF的RenderHtmlAsPdf，此服務類包含處理HTML素材轉換為PDF格式的方法。 透過async Task<byte[]> GeneratePdfAsync(string htmlContent))。

這方法創建一個RenderHtmlAsPdf(htmlContent)的PDF文檔。 生成的PDF的二進制數據然後被方法以異步方式(byte[]數組。

此方法保證了快速和響應的PDF生成，適用於需要快速生成文檔的應用。 與PdfService.cs內的PDF生成邏輯，讓開發者得以簡便的將此功能整合進去並通過StreamJsonRpc展示。 這使得遠端客戶端能夠在保持其伺服器端設計模組化和清晰的情況下，流暢地調用PDF生成工作。