streamjsonrpc c#（開發者使用方法）

C# 的 StreamJsonRpc 提供了全面的功能集合，其目的是促進和改善基於 JSON-RPC 通訊協定的客戶端伺服器應用程式通訊。

遠端程序呼叫 (RPC)

StreamJsonRpc 將遠端操作視為本機函式呼叫，因此用戶端可以透過遠端程序呼叫來呼叫伺服器上的方法。 透過掩飾複雜的網路通訊，這種抽象化的方式讓分散式應用程式的建立變得更容易。

雙向溝通

函式庫支援雙向的客戶端與伺服器通訊。 即時通訊和更新是透過客戶端向伺服器提交要求的能力來實現的，而伺服器反過來又可以回覆通知或結果。

傳輸層不可知性

由於 StreamJsonRpc 與傳輸層無關，因此可以在各種傳輸通訊協定上運作，包括 HTTP、Named Pipes 和 TCP/IP。由於這種適應性，開發人員可以根據應用程式的需求和網路設定，選擇最佳的傳輸方式。

序列化和反序列化

它可以管理 JSON-RPC 訊息序列化和反序列化，保證在各種平台和支援 JSON 的電腦語言間進行順暢的通訊。

進度報告

StreamJsonRpc 支援長時間執行活動的進度報告技術。 此功能可讓伺服器向用戶端更新目前程序的狀態，從而改善使用者體驗與透明度。

錯誤處理

為了處理調用遠端方法時產生的異常和問題，函式庫具有廣泛的錯誤處理功能。 這樣才能保證分散式系統的彈性和可靠性。

延伸點

StreamJsonRpc 可以由開發人員擴充，以改變其功能或將其納入現有的應用程式架構中。 由於其多用途性，因此可針對各種整合需求和應用情境量身打造。

效能最佳化

透過有效的自訂訊息處理和傳輸層管理，StreamJsonRpc 在保證低開銷的同時，最大化了客戶端與伺服器通訊的吞吐量。

異步支援

透過使用異步操作，可讓應用程式達到更佳的回應能力和擴充性。 它完全支援異步通訊模式。

互操作性

StreamJsonRpc 符合 JSON-RPC 標準，可促進 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 伺服器

使用 Program.cs 作為 StreamJsonRpc 伺服器上的介面，以透過流 JSON-RPC 提供 GeneratePdfAsync 方法：

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 格式的方法。 HTML 內容透過 GeneratePdfAsync 方法接受輸入，該方法被指定為異步 (async Task<byte[]> GeneratePdfAsync(string htmlContent))。

此方法會建立一個 ChromePdfRenderer 的實例來執行轉換，產生一個 PDF 文件 RenderHtmlAsPdf(htmlContent) 。 建立的 PDF 的二進位資料會透過方法 (pdf.BinaryDataAsync()) 以異步方式擷取，隨後會以 byte[] 陣列的形式傳回資料。

此方法可保證快速且反應迅速地產生 PDF，因此適用於需要快速建立文件的應用程式。 PDF 生成邏輯包含在 PdfService.cs 中，讓開發人員可以簡單地透過 StreamJsonRpc 整合並揭露此功能。 這可讓遠方的客戶順利調用 PDF 生成工作，同時保留其伺服器端設計的模組化和清晰度。