streamjsonrpc C# (Cómo Funciona para Desarrolladores)

Una colección completa de funcionalidades es proporcionada por StreamJsonRpc de C#, que está diseñada para facilitar y mejorar la comunicación de aplicaciones cliente-servidor basadas en el protocolo JSON-RPC.

Llamadas a procedimientos remotos (RPC)

Al considerar operaciones remotas como si fueran llamadas a funciones locales, StreamJsonRpc permite a los clientes llamar a métodos en un servidor a través de llamadas a procedimientos remotos. Al disfrazar las complejidades de la comunicación de red, esta abstracción hace más fácil la creación de aplicaciones distribuidas.

Comunicación bidireccional

La comunicación cliente-servidor bidireccional es compatible con la biblioteca. La comunicación en tiempo real y las actualizaciones son posibles gracias a la capacidad de los clientes para enviar solicitudes a los servidores, que a su vez pueden responder con notificaciones o resultados.

Agnóstico de la capa de transporte

Debido a que es neutral en cuanto a la capa de transporte, StreamJsonRpc puede funcionar sobre una variedad de protocolos de transporte, incluidos HTTP, Pipes con Nombre y TCP/IP. Debido a esta adaptabilidad, los desarrolladores pueden seleccionar el mejor método de transporte de acuerdo con las necesidades de sus aplicaciones y los entornos de red.

Serialización y deserialización

Gestiona la serialización y deserialización de mensajes JSON-RPC, garantizando una comunicación fluida en diversas plataformas y lenguajes de computación capaces de usar JSON.

Informe de progreso

StreamJsonRpc admite técnicas de reporte de progreso para actividades de larga duración. Esta característica mejora la experiencia del usuario y la transparencia al permitir que los servidores actualicen a los clientes sobre el estado de los procesos actuales.

Manejo de errores

La biblioteca tiene amplias características de manejo de errores para abordar excepciones y problemas que surgen durante la invocación de métodos remotos. Esto garantiza la resiliencia y confiabilidad de los sistemas dispersos.

Puntos de ampliación

StreamJsonRpc puede ser extendido por desarrolladores para alterar su funcionalidad o incluirlo en arquitecturas de aplicación ya existentes. Debido a su versatilidad, puede adaptarse para cumplir con una variedad de necesidades de integración y escenarios de aplicación.

Optimización del rendimiento

A través del manejo efectivo de mensajes personalizados y la gestión de la capa de transporte, StreamJsonRpc maximiza el rendimiento en la comunicación cliente-servidor mientras garantiza un bajo overhead.

Soporte asíncrono

A través del uso de operaciones asincrónicas, permite a las aplicaciones lograr mayor capacidad de respuesta y escalabilidad. Admite completamente los patrones de comunicación asincrónica.

Interoperabilidad

A través de la conformidad con el estándar JSON-RPC, StreamJsonRpc facilita una integración sin problemas en diversos contextos al fomentar la interoperabilidad entre aplicaciones y servicios C# construidos en otros lenguajes que soportan JSON.

Junto con estas características principales, hay algunas características adicionales más allá de la especificación JSON-RPC que incluyen soporte para serialización binaria compacta y proxy dinámico del cliente.

Crear una clase de servicio

Proporcione métodos en la clase de servicio PdfService.cs que crearán PDFs a partir de los datos que se reciben. Como ilustración:

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

Configurar el servidor StreamJsonRpc

Use Program.cs como la interfaz en el servidor para StreamJsonRpc para ofrecer el método GeneratePdfAsync a través de un JSON-RPC de flujo:

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

Crear cliente IronPDF

Para conectarse al servidor y solicitar la creación de un PDF, implemente el cliente 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();
    }
}

La clase PdfService.cs es una parte fundamental de una implementación de servidor StreamJsonRpc que facilita a una aplicación C# generar documentos PDF utilizando IronPDF. Al utilizar el RenderHtmlAsPdf de IronPDF, esta clase de servicio contiene métodos para manejar la conversión del material HTML en formato PDF. El contenido HTML se acepta como entrada a través del método GeneratePdfAsync, que está designado como asincrónico (async Task<byte[]> GeneratePdfAsync(string htmlContent)).

Este método crea una instancia de ChromePdfRenderer para llevar a cabo la conversión, produciendo un documento PDF con RenderHtmlAsPdf(htmlContent). Los datos binarios del PDF creado son luego recuperados asincrónicamente por el método (pdf.BinaryDataAsync()), que posteriormente retorna los datos como un arreglo byte[].

Este método garantiza una rápida y receptiva generación de PDF, lo que lo hace apropiado para aplicaciones que necesitan crear documentos rápidamente. La lógica de generación de PDF está contenida en PdfService.cs, lo que facilita a los desarrolladores integrar y exponer esta funcionalidad sobre StreamJsonRpc. Esto permite a los clientes distantes invocar labores de generación de PDF de manera fluida, mientras preserva la modularidad y claridad de su diseño del lado del servidor.