Flurl C# (Cómo Funciona para Desarrolladores)

Interfaz fluida

La sintaxis encadenable y fluida proporcionada por Flurl mejora la legibilidad y mantenibilidad del programa. Los desarrolladores pueden crear solicitudes HTTP simples y expresivas y trabajar con URLs, parámetros de consulta, encabezados y cargas útiles.

Soporte de métodos HTTP

Se admiten todos los métodos estándares HTTP, incluidos GET, POST, PUT, DELETE, PATCH, HEAD y OPTIONS. Los desarrolladores pueden realizar varias tareas al trabajar con APIs web gracias a este enfoque de soporte integral.

Manejo de parámetros de consulta

Flurl ofrece formas fáciles de modificar, agregar y eliminar parámetros de consulta dentro de URLs. Facilita la creación de URLs dinámicas basadas en la entrada del usuario o situaciones de ejecución.

Soporte JSON

El manejo de datos JSON es admitido de manera nativa por Flurl. Puede deserializar fácilmente respuestas JSON en objetos C# y serializar objetos a JSON para cargas útiles de solicitudes. Debido a esto, utilizar APIs basadas en JSON es sencillo y fácil.

Soporte de datos de formulario y multiparte

Facilita la gestión de solicitudes multipartes y datos de formularios. Flurl hace que sea simple para los desarrolladores incluir cargas útiles multipart/form-data o datos codificados por formularios en solicitudes HTTP.

Manejo de errores y políticas de reintento

Flurl ofrece capacidades de manejo de errores y definición de políticas de reintento para todas las llamadas HTTP. Al definir lógicas de manejo de errores únicas o técnicas de reintento, los desarrolladores pueden mejorar la resiliencia y la fiabilidad de las llamadas e interacciones de API. Esto también salvaguarda y ayuda a los desarrolladores a prevenir errores de objetos anónimos en las respuestas.

Autenticación

Soporta varios métodos de autenticación populares para APIs web, incluidos OAuth, esquemas de autenticación personalizados, Autenticación Básica y claves de API. Esto asegura comunicaciones seguras con APIs que requieren autenticación.

Soporte para pruebas

Al aislar la lógica relacionada con HTTP en componentes reutilizables con una separación clara de preocupaciones, Flurl fomenta la prueba. Esto hace que escribir pruebas unitarias para las interacciones API sea más simple, ya que no se requieren llamadas a redes reales para probarlas.

Flexibilidad de configuración

Proporciona flexibilidad de configuración para clientes HTTP y parámetros de solicitud. Los desarrolladores pueden cambiar comportamientos del cliente, tiempos de espera, cantidades de respuesta de error, encabezados y otras configuraciones para satisfacer las necesidades de aplicaciones particulares o limitaciones de API.

Extensibilidad

Debido a su marco para plugins, Flurl es muy extendible. Los desarrolladores pueden aumentar la funcionalidad de la plataforma construyendo extensiones únicas o incorporando plugins de terceros para obtener más funciones.

Crear un nuevo proyecto de Visual Studio

Install-Package Flurl.Http

using Flurl;
using Flurl.Http;

// Configure a FlurlClient instance with base URL and headers
FlurlClient flurlClient = new FlurlClient("https://api.example.com/");
flurlClient.WithHeader("Authorization", "Bearer YourAccessTokenHere");

using Flurl;
using Flurl.Http;

// Configure a FlurlClient instance with base URL and headers
FlurlClient flurlClient = new FlurlClient("https://api.example.com/");
flurlClient.WithHeader("Authorization", "Bearer YourAccessTokenHere");

var response = await "http://localhost:5013/users".GetAsync();
Console.WriteLine(response.ToString());

if (response.ResponseMessage.IsSuccessStatusCode)
{
    var result = await response.ResponseMessage.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

var response = await "http://localhost:5013/users".GetAsync();
Console.WriteLine(response.ToString());

if (response.ResponseMessage.IsSuccessStatusCode)
{
    var result = await response.ResponseMessage.Content.ReadAsStringAsync();
    Console.WriteLine(result);
}
else
{
    Console.WriteLine($"Error: {response.StatusCode}");
}

// Handling JSON response
var responseObject = await "https://api.example.com/resource"
    .WithClient(flurlClient)
    .GetJsonAsync<ResponseType>();
// Assuming ResponseType is a class representing the expected JSON structure
Console.WriteLine($"Response: {responseObject.Property}");

// Handling JSON response
var responseObject = await "https://api.example.com/resource"
    .WithClient(flurlClient)
    .GetJsonAsync<ResponseType>();
// Assuming ResponseType is a class representing the expected JSON structure
Console.WriteLine($"Response: {responseObject.Property}");

¿Qué es IronPDF?

Una biblioteca .NET rica en funciones llamada IronPDF está disponible en programas C# para crear, leer y modificar documentos PDF. Con la ayuda de esta herramienta, los desarrolladores pueden generar rápidamente PDFs listos para imprimir y de alta calidad a partir de contenido HTML, CSS y JavaScript. Algunas capacidades esenciales incluyen la capacidad de marcar agua, crear encabezados y pies de página, dividir y combinar PDFs, y convertir HTML a PDF. IronPDF admite el .NET Framework y el .NET Core, lo que lo hace útil para varias aplicaciones.

Debido a que los PDFs son sencillos de integrar y cuentan con una amplia documentación detallada, los desarrolladores pueden emplearlos fácilmente en sus aplicaciones. IronPDF asegura que los PDFs generados se asemejen estrechamente al contenido HTML de origen al manejar eficientemente diseños complejos y estilos.

IronPDF simplifica mucho la conversión de páginas web, URLs y HTML en PDFs de alta calidad que se ven igual que el contenido original. Es perfecto para crear PDFs de informes en línea, facturas y más. Si has estado buscando una forma de convertir HTML a PDF, ¡IronPDF te cubre!

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Características de IronPDF

Generación de PDF desde HTML

Convierte JavaScript, HTML y CSS a PDF. Admite consultas de medios y diseño responsivo, dos estándares web contemporáneos. Es útil para decorar dinámicamente informes PDF, facturas y documentos con HTML y CSS.

Edición de PDF

Se pueden añadir texto, fotos y otros contenidos a PDFs preexistentes. Se pueden eliminar texto e imágenes de archivos PDF. Numerosos PDFs pueden combinarse en un solo archivo. Los archivos PDF pueden dividirse en múltiples documentos separados. Se pueden incluir marcas de agua, anotaciones, encabezados y pies de página.

Conversión de PDF

Convierte varios tipos de archivos, incluidos los archivos de Word, Excel y de imagen, al formato PDF. Conversión de PDF a imagen (PNG, JPEG, etc.).

Rendimiento y Fiabilidad

Un alto rendimiento y fiabilidad son cualidades de diseño deseadas en entornos industriales, ya que pueden gestionar extensas colecciones de documentos de manera efectiva.

Instalar IronPDF

Para obtener las herramientas que necesitas para trabajar con PDFs en proyectos .NET, instala el paquete IronPDF.

Install-Package IronPdf

Obtener datos con Flurl para generar un PDF

Para hacer consultas HTTP y obtener datos de tu API, utiliza la API fluida de Flurl. Este es un ejemplo de recuperación de datos JSON:

using Flurl;
using Flurl.Http;
using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            var response = await "http://localhost:5013/users/1".GetJsonAsync<User>();
            var id = response?.Id;
            var name = response?.Name;
            Console.WriteLine($"Data fetched successfully: {name}");

            // Generate PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            string htmlTemplate = $@"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>";

            // Generate PDF document from HTML template
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);

            // Save or stream the PDF document
            pdfDocument.SaveAs(@"document.pdf");
            Console.WriteLine("PDF document generated successfully.");
        }
        catch (FlurlHttpException ex)
        {
            Console.WriteLine($"HTTP Error: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

// Example model class for JSON deserialization
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

using Flurl;
using Flurl.Http;
using IronPdf;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        try
        {
            var response = await "http://localhost:5013/users/1".GetJsonAsync<User>();
            var id = response?.Id;
            var name = response?.Name;
            Console.WriteLine($"Data fetched successfully: {name}");

            // Generate PDF using IronPDF
            var renderer = new ChromePdfRenderer();
            string htmlTemplate = $@"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>";

            // Generate PDF document from HTML template
            var pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate);

            // Save or stream the PDF document
            pdfDocument.SaveAs(@"document.pdf");
            Console.WriteLine("PDF document generated successfully.");
        }
        catch (FlurlHttpException ex)
        {
            Console.WriteLine($"HTTP Error: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

// Example model class for JSON deserialization
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

En este ejemplo, se utiliza la función .GetJsonAsync() de Flurl para enviar una petición GET y obtener datos JSON. Reemplaza User con tu clase modelo, que representa la estructura de la respuesta de la API, y "URL" con el punto final real de tu API. Una plantilla HTML (htmlTemplate) puede renderizarse en un documento PDF utilizando la clase ChromePdfRenderer de IronPDF. Aquí, el título y los datos del cuerpo recuperados de la API se usan para construir dinámicamente la plantilla HTML. El documento PDF creado (pdfDocument) se guarda en la ubicación especificada ("document.pdf") en el sistema de archivos. Modifica la ruta según sea necesario.

Proporciona un manejo de errores robusto para problemas como fallos de red (FlurlHttpException) o excepciones generales (Exception) durante la obtención de datos o producción de PDF. Puedes cambiar el tamaño de la página, los márgenes, los encabezados, los pies de página y otras configuraciones de PDF utilizando IronPDF. Para obtener más posibilidades de personalización avanzadas, consulta el manual de IronPDF. Al enviar consultas HTTP a APIs, asegúrate de que los datos sensibles y los tokens de acceso se manejen de manera segura. Usa los métodos de autenticación adecuados que requiera tu API.