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メソッドを提供するために、サーバーのインターフェースとして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クラスは、IronPDFを使用してPDF文書を生成するC#アプリケーションのStreamJsonRpcサーバー実装の基本的な部分です。 IronPDFのRenderHtmlAsPdfを利用することで、このサービスクラスはHTML素材をPDF形式に変換するためのメソッドを含んでいます。 GeneratePdfAsyncメソッドは、入力としてHTMLコンテンツを受け入れ、非同期として指定されています(async Task<byte[]> GeneratePdfAsync(string htmlContent))。

このメソッドは、変換を実行するためにChromePdfRendererのインスタンスを作成し、RenderHtmlAsPdf(htmlContent)でPDF文書を生成します。 生成されたPDFのバイナリデータは、その後メソッドによって非同期で取得され(pdf.BinaryDataAsync())、そのデータをbyte[]配列として返します。

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