Flurl C# (Geliştiriciler İçin Nasıl Çalışır)

Akıcı Arayüz

Flurl tarafından sağlanan akıcı, zincirlenebilir sözdizimi, program çekilebilirliğini ve sürdürülebilirliğini artırır. Geliştiriciler, basit ve ifade edici HTTP istekleri oluşturabilir ve URL'ler, sorgu parametreleri, başlıklar ve yüklerle çalışabilirler.

HTTP Yöntem Desteği

GET, POST, PUT, DELETE, PATCH, HEAD ve OPTIONS gibi tüm standart HTTP yöntemleri desteklenmektedir. Bu kapsayıcı destek yaklaşımı, web API'leri ile çalışırken geliştiricilerin çeşitli görevleri yerine getirmesine izin verir.

Sorgu Parametresi İşleme

Flurl, URL'ler içindeki sorgu parametrelerini ekleme, değiştirme ve kaldırma yolları sunar. Kullanıcı girdisine veya runtime durumlarına bağlı olarak dinamik URL'ler oluşturmayı kolaylaştırır.

JSON Desteği

JSON veri işleme, Flurl tarafından yerel olarak desteklenir. C# nesnelerine JSON yanıtlarını kolayca çözebilir ve istek yükleri için nesneleri JSON'a serileştirebilir. Bu nedenle JSON tabanlı API'leri kullanmak basit ve kolaydır.

Form Verileri ve Çok Parçalı Destek

Çok parçalı isteklerin ve form verilerinin yönetimini kolaylaştırır. Flurl, geliştiricilere HTTP isteklerinde çok parçalı/form-veri içeriği veya form-kodlanmış veri eklemeyi kolaylaştırır.

Hata Yönetimi ve Yeniden Deneme Politikaları

Flurl, tüm HTTP çağrıları için hata yönetimi ve yeniden deneme politikası tanımlama yetenekleri sunar. Geliştiriciler, özel hata yönetimi mantığı veya yeniden deneme teknikleri tanımlayarak API çağrılarının ve etkileşimlerin verimliliğini ve güvenilirliğini artırabilirler. Bu aynı zamanda geliştiricilerin yanıtlar içinde anonim nesne hatalarını önlemelerine yardım eder ve onları korur.

Kimlik Doğrulama

OAuth, özel kimlik doğrulama şemaları, Temel Kimlik Doğrulaması ve API anahtarları gibi web API'leri için birçok popüler kimlik doğrulama yöntemi desteklenmektedir. Bu, kimlik doğrulaması gerektiren API'lerle güvenli iletişimi sağlar.

Test Desteği

HTTP ile ilgili mantığı ayrı bileşenlere ayırarak, Flurl test edilebilirliği teşvik eder. Bu durum, API etkileşimleri için birim testlerin yazılmasını kolaylaştırır, çünkü gerçek ağ çağrıları gerekli değildir.

Yapılandırma Esnekliği

HTTP istemcileri ve istek parametreleri için konfigürasyon esnekliği sağlar. Geliştiriciler, belirli uygulama gereksinimlerini veya API sınırlamalarını karşılamak için müşteri davranışlarını, zaman aşım sürelerini, hata yanıtı miktarlarını, başlıkları ve diğer ayarlarını değiştirebilirler.

Yayılabilirlik

Eklentiler için çerçevesi nedeniyle, Flurl oldukça genişletilebilirdir. Geliştiriciler, daha fazla işlevsellik için benzersiz uzantılar oluşturarak veya üçüncü taraf eklentiler ekleyerek platformun kapasitesini artırabilirler.

Yeni Bir Visual Studio Projesi Oluştur

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

IronPDF nedir?

IronPDF, C# programlarında PDF belgeleri oluşturmak, okumak ve değiştirmek için kullanılabilen özelliklerle dolu bir .NET kütüphanesidir. Bu araç sayesinde geliştiriciler, HTML, CSS ve JavaScript içeriğinden hızlıca baskıya hazır, yüksek kaliteli PDF'ler oluşturabilecekler. Suya damgası eklemek, başlıklar ve altbilgi oluşturmak, PDF'leri bölmek ve birleştirmek ve HTML'yi PDF'ye dönüştürmek gibi bazı önemli yetenekler içerir. IronPDF, .NET Framework ve .NET Core'u destekler, bu da onu çeşitli uygulamalar için kullanışlı hale getirir.

PDF'ler basit bir şekilde entegre edilebildiğinden ve ayrıntılı dokümantasyonu bol olduğundan, geliştiriciler bunları uygulamalarında kolayca kullanabilirler. IronPDF, karmaşık düzenleri ve stilleri etkin bir şekilde çözerek, oluşturulan PDF'lerin orijinal HTML içeriğine yakından benzemesini sağlar.

IronPDF, web sayfalarını, URL'leri ve HTML'yi yüksek kaliteli PDF'lere dönüştürmeyi oldukça kolay hale getirir ve orijinal içeriğe tam olarak benzeyen PDF'ler oluşturur. Çevrimiçi raporlar, faturalar ve daha fazlası için PDF oluşturmada mükemmeldir. HTML'yi PDF'ye dönüştürme yöntemi arıyorsanız, IronPDF işinizi görecek!

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

IronPDF Özellikleri

HTML'den PDF Üretimi

JavaScript, HTML, ve CSS'i PDF'e dönüştür. Medya sorgularını ve duyarlı tasarımı destekler, iki modern web standardı. Dinamik olarak PDF raporlarını, faturalarını ve belgelerini HTML ve CSS ile dekore etmek için kullanışlıdır.

PDF Düzenleme

Mevcut PDF'lere metin, fotoğraflar ve diğer içerik eklenebilir. PDF dosyalarından metin ve resimler kaldırılabilir. Birden fazla PDF bir dosya içinde birleştirilebilir. PDF dosyaları, birden fazla ayrı belgeye bölünebilir. Suya damga, açıklamalar, başlıklar ve altbilgiler eklenebilir.

PDF Dönüşümü

Word, Excel ve resim dosyaları gibi birçok dosya türünü PDF formatına dönüştürün. PDF'den resme dönüştürme (PNG, JPEG, vb.).

Performans ve Güvenilirlik

Endüstriyel ortamlarda yüksek performans ve güvenilirlik istenilen tasarım nitelikleridir, çünkü geniş belge koleksiyonlarını etkili bir şekilde yönetebilirler.

IronPDF Kurulumu

PDF'lerle .NET projelerinde çalışmak için gerekli araçları elde etmek için IronPDF paketini yükleyin.

Install-Package IronPdf

PDF oluşturmak için Flurl'u kullanarak veri çekme

HTTP sorguları oluşturmak ve API'nizden veri almak için Flurl'un akıcı API'sini kullanın. Bu, JSON veri almanın bir örneğidir:

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

Bu örnekte, Flurl'ün .GetJsonAsync() fonksiyonu, GET isteği gönderip JSON verilerini almak için kullanılır. User yerine API yanıt yapısını temsil eden model sınıfınızı ve "URL" yerine gerçek API uç noktanızı yerleştirin. Bir HTML şablonu (htmlTemplate), IronPDF'in ChromePdfRenderer sınıfı kullanılarak bir PDF belgesine dönüştürülebilir. Burada API'den alınan başlık ve gövde verileri, dinamik olarak HTML şablonunu oluşturmak için kullanılır. Oluşturulan PDF belgesi (pdfDocument), dosya sisteminde belirtilen konuma ("document.pdf") kaydedilir. Gerekirse yolu değiştirin.

Veri alma veya PDF üretimi sırasında ağ hataları (FlurlHttpException) veya genel istisnalar (Exception) gibi sorunlar için sağlam hata yönetimi sağlayın. IronPDF kullanarak sayfa boyutunu, kenar boşluklarını, üst bilgileri, alt bilgileri ve diğer PDF ayarlarını değiştirebilirsiniz. Daha gelişmiş özelleştirme olanakları için IronPDF'in kullanım kılavuzuna bakın. API'lere HTTP sorguları gönderirken, hassas verilerin ve erişim belirteçlerinin güvenli bir şekilde işlendiğinden emin olun. API'nizin gerektirdiği uygun kimlik doğrulama yöntemlerini kullanın.