Flurl C# (jak to działa dla programistów)

Interfejs płynny

Płynna, łańcuchowa składnia zapewniana przez Flurl poprawia czytelność i łatwość utrzymania kodu. Programiści mogą tworzyć proste i wyraziste żądania HTTP oraz pracować z adresami URL, parametrami zapytania, nagłówkami i danymi.

Obsługa metod HTTP

Obsługiwane są wszystkie standardowe metody HTTP, w tym GET, POST, PUT, DELETE, PATCH, HEAD i OPTIONS. Dzięki takiemu kompleksowemu podejściu do wsparcia programiści mogą realizować różne zadania podczas pracy z interfejsami API sieci Web.

Obsługa parametrów zapytania

Flurl oferuje proste sposoby modyfikowania, dodawania i usuwania parametrów zapytania w adresach URL. Ułatwia to tworzenie dynamicznych adresów URL na podstawie danych wprowadzonych przez użytkownika lub sytuacji w czasie wykonywania.

Obsługa JSON

Obsługa danych JSON jest natywnie obsługiwana przez Flurl. Może z łatwością deserializować odpowiedzi JSON do obiektów C# oraz serializować obiekty do formatu JSON na potrzeby ładunków żądań. Dzięki temu korzystanie z interfejsów API opartych na JSON jest proste i łatwe.

Obsługa danych formularzy i przesyłania wieloczęściowego

Ułatwia to zarządzanie żądaniami wieloczęściowymi i danymi formularzy. Flurl ułatwia programistom dołączanie ładunków typu multipart/form-data lub danych zakodowanych w formularzach do żądań HTTP.

Obsługa błędów i zasady ponawiania prób

Flurl oferuje definiowanie zasad ponawiania prób oraz funkcje obsługi błędów dla wszystkich wywołań HTTP. Definiując unikalną logikę obsługi błędów lub techniki ponawiania prób, programiści mogą zwiększyć odporność i niezawodność wywołań API oraz interakcji. Zapewnia to również ochronę i pomaga programistom zapobiegać błędom anonimowych obiektów w odpowiedziach.

Uwierzytelnianie

Obsługuje kilka popularnych metod uwierzytelniania dla interfejsów API, w tym OAuth, niestandardowe schematy uwierzytelniania, uwierzytelnianie podstawowe oraz klucze API. Zapewnia to bezpieczną komunikację z interfejsami API wymagającymi uwierzytelnienia.

Wsparcie dla testów

Poprzez izolowanie logiki związanej z HTTP do komponentów wielokrotnego użytku z wyraźnym podziałem odpowiedzialności, Flurl wspiera testowalność. To sprawia, że pisanie testów jednostkowych dla interakcji z API jest prostsze, ponieważ nie są wymagane rzeczywiste wywołania sieciowe do ich przetestowania.

Elastyczność konfiguracji

Zapewnia elastyczność konfiguracji dla klientów HTTP i parametrów żądań. Deweloperzy mogą zmieniać zachowania klientów, czas oczekiwania, ilość odpowiedzi błędów, nagłówki i inne ustawienia, aby dostosować je do potrzeb konkretnych aplikacji lub ograniczeń API.

Rozszerzalność

Dzięki swojemu systemowi wtyczek, Flurl jest bardzo rozbudowywalny. Deweloperzy mogą zwiększać funkcjonalność platformy poprzez budowanie unikalnych rozszerzeń lub włączanie wtyczek zewnętrznych dla dodatkowych funkcji.

Tworzenie nowego projektu w 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");

Imports Flurl
Imports Flurl.Http

' Configure a FlurlClient instance with base URL and headers
Private flurlClient As 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}");
}

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

If response.ResponseMessage.IsSuccessStatusCode Then
	Dim result = Await response.ResponseMessage.Content.ReadAsStringAsync()
	Console.WriteLine(result)
Else
	Console.WriteLine($"Error: {response.StatusCode}")
End If

// 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}");

Imports System
Imports Flurl.Http

' Handling JSON response
Dim responseObject As ResponseType = Await "https://api.example.com/resource" _
    .WithClient(flurlClient) _
    .GetJsonAsync(Of ResponseType)()
' Assuming ResponseType is a class representing the expected JSON structure
Console.WriteLine($"Response: {responseObject.Property}")

Czym jest IronPDF?

IronPDF jest bogatą w funkcje biblioteką .NET, dostępną w programach C#, która pozwala na tworzenie, odczyt i modyfikację dokumentów PDF. Dzięki temu narzędziu, deweloperzy mogą szybko generować gotowe do druku, wysokiej jakości dokumenty PDF z zawartości HTML, CSS i JavaScript. Niektóre z podstawowych funkcji obejmują możliwość dodawania znaków wodnych, tworzenia nagłówków i stopek, dzielenia i łączenia plików PDF oraz konwertowania HTML do PDF. IronPDF obsługuje .NET Framework oraz .NET Core, co czyni ją przydatną dla różnorodnych aplikacji.

Ponieważ pliki PDF są proste do integracji i mają bogatą dokumentację, deweloperzy mogą łatwo je stosować w swoich aplikacjach. IronPDF zapewnia, że generowane pliki PDF ściśle przypominają źródłową zawartość HTML poprzez efektywne zarządzanie skomplikowanymi układami i stylowaniem.

IronPDF sprawia, że to naprawdę proste przekształcić strony internetowe, URL-e i HTML w wysokiej jakości PDF-y, które wyglądają dokładnie jak oryginalna zawartość. Jest idealny do tworzenia PDF-ów z raportów online, faktur i innych. Jeśli szukałeś sposobu na przekształcenie HTML do PDF, IronPDF ma dla Ciebie rozwiązanie!

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

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

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

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

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Funkcje IronPDF

Generowanie plików PDF z HTML

Konwertuj JavaScript, HTML i CSS do formatu PDF. Obsługuje zapytania medialne i responsywny design, dwa współczesne standardy webowe. Przydatny do dynamicznego ozdabiania raportów PDF, faktur i dokumentów za pomocą HTML i CSS.

Edycja plików PDF

Tekst, zdjęcia i inna zawartość mogą być dodawane do istniejących plików PDF. Tekst i zdjęcia mogą być usuwane z plików PDF. Liczne pliki PDF można połączyć w jeden plik. Pliki PDF mogą być dzielone na wiele separate pól. Można dodać znaki wodne, adnotacje, nagłówki i stopki.

Konwersja plików PDF

Konwertuj kilka rodzajów plików, w tym dokumenty Word, Excel i pliki graficzne, do formatu PDF. Konwersja PDF na obraz (PNG, JPEG, itp.).

Wydajność i niezawodność

Wysoka wydajność i niezawodność to pożądane cechy projektowe w przemysłowych środowiskach, ponieważ mogą skutecznie zarządzać rozległymi zbiorami dokumentów.

Zainstaluj IronPDF

Aby uzyskać narzędzia potrzebne do pracy z plikami PDF w projektach .NET, zainstaluj pakiet IronPDF.

Install-Package IronPdf

Pobierz dane za pomocą Flurl, aby wygenerować PDF

Aby wykonywać zapytania HTTP i pobierać dane z Twojego API, użyj płynnego interfejsu API Flurl. Oto przykład pobierania danych 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; }
}

Imports Flurl
Imports Flurl.Http
Imports IronPdf
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Try
			Dim response = await "http://localhost:5013/users/1".GetJsonAsync(Of User)()
			Dim id = response?.Id
			Dim name = response?.Name
			Console.WriteLine($"Data fetched successfully: {name}")

			' Generate PDF using IronPDF
			Dim renderer = New ChromePdfRenderer()
			Dim htmlTemplate As String = $"
                <html>
                <body>
                    <h1>{id}</h1>
                    <p>{name}</p>
                </body>
                </html>"

			' Generate PDF document from HTML template
			Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlTemplate)

			' Save or stream the PDF document
			pdfDocument.SaveAs("document.pdf")
			Console.WriteLine("PDF document generated successfully.")
		Catch ex As FlurlHttpException
			Console.WriteLine($"HTTP Error: {ex.Message}")
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		End Try
	End Function
End Class

' Example model class for JSON deserialization
Public Class User
	Public Property Id() As Integer
	Public Property Name() As String
End Class

W tym przykładzie, funkcja .GetJsonAsync() Flurl jest używana do wysłania żądania GET i pobrania danych JSON. Zastąp User swoją klasą modelu, która reprezentuje strukturę odpowiedzi API, oraz "URL" swoim rzeczywistym punktem końcowym API. Szablon HTML (htmlTemplate) może być wyrenderowany do dokumentu PDF za pomocą klasy ChromePdfRenderer IronPDF. Tutaj, tytuł i dane treści pobrane z API są używane do dynamicznego konstruowania szablonu HTML. Utworzony dokument PDF (pdfDocument) jest zapisany w określonej lokalizacji ("document.pdf") w systemie plików. Dostosuj ścieżkę w razie potrzeby.

Zaprojektuj solidną obsługę błędów dla problemów takich jak awarie sieci (FlurlHttpException) lub ogólne wyjątki (Exception) podczas pobierania danych lub produkcji PDF. Możesz zmieniać rozmiar strony, marginesy, nagłówki, stopki i inne ustawienia PDF przy użyciu IronPDF. Dla bardziej zaawansowanych możliwości dostosowywania zobacz podręcznik IronPDF. Podczas wysyłania zapytań HTTP do API, upewnij się, że dane wrażliwe i tokeny dostępu są obsługiwane bezpiecznie. Używaj odpowiednich metod uwierzytelniania wymaganych przez Twoje API.