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 사양을 넘는 몇 가지 추가 기능이 있습니다.

서비스 클래스 생성

받은 데이터를 기반으로 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();
    }
}

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 서버 설정

서버의 인터페이스로 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();
    }
}

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 클라이언트 생성

서버에 연결하고 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();
    }
}

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

C# 애플리케이션이 IronPDF를 사용하여 PDF 문서를 생성하기 쉽게 만들어 주는 StreamJsonRpc 서버 구현의 기본적인 부분인 PdfService.cs 클래스입니다. IronPDF의 RenderHtmlAsPdf을(를) 활용하여 이 서비스 클래스는 HTML 자료를 PDF 형식으로 변환하는 처리 메서드를 포함하고 있습니다. HTML 콘텐츠는 비동기로 지정된 (async Task<byte[]> GeneratePdfAsync(string htmlContent)) GeneratePdfAsync 메서드를 통해 입력으로 허용됩니다.

이는 ChromePdfRenderer 인스턴스를 생성하여 변환을 수행하고, RenderHtmlAsPdf(htmlContent)와 함께 PDF 문서를 생성합니다. 생성된 PDF의 바이너리 데이터는 그 다음에 메서드(pdf.BinaryDataAsync())에서 비동기적으로 검색되며, 이후 byte[] 배열로 데이터를 반환합니다.

이 메서드는 빠르고 반응성 있는 PDF 생성을 보장하여 문서를 빠르게 생성해야 하는 응용 프로그램에 적합합니다. PDF 생성 로직은 PdfService.cs에 포함되어 있어 개발자들이 이 기능을 StreamJsonRpc를 통해 쉽게 통합하고 공개할 수 있도록 합니다. 이는 원격 클라이언트가 서버 측 설계의 모듈성 및 명확성을 유지하면서 PDF 생성 작업을 원활하게 호출할 수 있도록 합니다.