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仕様を超えるボーナス機能が含まれています。

サービスクラスの作成

受信したデータから PDF を作成するメソッドをサービス クラス PdfService.cs に提供します。 例として：

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サーバーを設定する

ストリーム JSON-RPC 上で GeneratePdfAsync メソッドを提供するには、StreamJsonRpc のサーバー上のインターフェイスとして Program.cs を使用します。

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 のインスタンスを作成し、変換を実行して、RenderHtmlAsPdf(htmlContent) を含む PDF ドキュメントを生成します。 作成された PDF のバイナリ データは、メソッド (pdf.BinaryDataAsync()) によって非同期的に取得され、その後、データが byte[] 配列として返されます。

この方法は、高速かつ応答性のあるPDF生成を保証し、迅速に文書を作成する必要があるアプリケーションに適しています。 PDF 生成ロジックは PdfService.cs に含まれているため、開発者は StreamJsonRpc を介してこの機能を簡単に統合および公開できます。 これにより、遠隔クライアントがPDF生成ジョブをシームレスに呼び出しながら、サーバー側の設計のモジュール性と明確さを維持することができます。