Flurl C# (개발자를 위한 작동 방식)

유창한 인터페이스

Flurl이 제공하는 유창하고 연결 가능한 구문은 프로그램의 가독성과 유지 관리를 향상시킵니다. 개발자는 URL, 쿼리 매개변수, 헤더 및 페이로드와 함께 간단하고 표현력 있는 HTTP 요청을 생성할 수 있습니다.

HTTP 메소드 지원

GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS를 포함한 모든 표준 HTTP 메서드가 지원됩니다. 이 포괄적인 지원 접근 방식을 통해 개발자는 웹 API 작업 시 다양한 작업을 수행할 수 있습니다.

쿼리 매개변수 처리

Flurl은 URL 내 쿼리 매개변수를 수정, 추가 및 제거하는 쉬운 방법을 제공합니다. 사용자 입력이나 런타임 상황에 따라 동적 URL을 생성하기 쉽게 만듭니다.

JSON 지원

Flurl은 JSON 데이터 처리를 기본적으로 지원합니다. JSON 응답을 C# 객체로 쉽게 역직렬화하고 객체를 요청 페이로드를 위한 JSON으로 직렬화할 수 있습니다. 이로 인해 JSON 기반 API를 사용하는 것이 간단하고 용이합니다.

양식 데이터 및 멀티파트 지원

멀티파트 요청 및 양식 데이터 관리가 더 쉬워집니다. Flurl은 개발자가 HTTP 요청에 멀티파트/양식 데이터 페이로드 또는 양식 인코딩 데이터를 포함시키는 것을 간단하게 만듭니다.

오류 처리 및 재시도 정책

Flurl은 모든 HTTP 호출에 대한 재시도 정책 정의 및 오류 처리 기능을 제공합니다. 고유한 오류 처리 논리나 재시도 기법을 정의하여 개발자는 API 호출 및 상호 작용의 복원력과 신뢰성을 더 높일 수 있습니다. 이는 또한 응답에서 익명의 객체 오류를 방지하고 개발자가 이를 피할 수 있도록 돕습니다.

인증

OAuth, 사용자 정의 인증 체계, 기본 인증, API 키를 포함한 여러 인기 있는 웹 API 인증 방법을 지원합니다. 이는 인증이 필요한 API와의 안전한 통신을 보장합니다.

테스트 지원

HTTP 관련 논리를 관심사의 명확한 분리를 가진 재사용 가능한 구성 요소로 분리하여 Flurl은 테스트 가능성을 장려합니다. 이로 인해 API 상호 작용에 대한 단위 테스트 작성이 간단해지며, 실제 네트워크 호출 없이 테스트할 수 있습니다.

구성 유연성

HTTP 클라이언트 및 요청 매개변수에 대한 구성 유연성을 제공합니다. 개발자는 특정 애플리케이션이나 API 제한의 요구에 맞게 클라이언트 동작, 타임아웃, 오류 응답 수량, 헤더 및 기타 설정을 변경할 수 있습니다.

확장성

플러그인 프레임워크 덕분에 Flurl은 매우 확장 가능합니다. 개발자는 고유한 확장 기능을 만들거나 타사 플러그인을 통합하여 플랫폼의 기능을 증가시킬 수 있습니다.

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

IronPDF란 무엇입니까?

.NET 라이브러리인 IronPDF는 C# 프로그램에서 PDF 문서를 생성, 읽고 수정할 수 있습니다. 이 도구는 개발자가 HTML, CSS 및 JavaScript 콘텐츠에서 인쇄 가능한 고품질 PDF를 빠르게 생성할 수 있도록 도와줍니다. 일부 필수 기능에는 워터마킹, 헤더 및 풋터 생성, PDF 분할 및 결합, HTML을 PDF로 변환하는 기능이 포함됩니다. IronPDF는 .NET Framework와 .NET Core를 지원하며 다양한 애플리케이션에서 유용합니다.

PDF는 간단한 통합 및 풍부한 문서를 제공하기 때문에 개발자는 애플리케이션에서 쉽게 사용할 수 있습니다. IronPDF는 복잡한 레이아웃과 스타일을 효율적으로 처리하여 생성된 PDF가 소스 HTML 콘텐츠와 매우 유사한 것을 보장합니다.

IronPDF는 웹 페이지, URL 및 HTML을 고품질 PDF로 쉽게 변환하여 원본 콘텐츠와 똑같이 보입니다. 온라인 보고서, 송장 등을 PDF로 생성하기에 적합합니다. HTML을 PDF로 변환하는 방법을 찾고 있다면, IronPDF가 해결책을 제공합니다!

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 의 특징

HTML에서 PDF 생성

JavaScript, HTML, CSS 파일을 PDF로 변환합니다. 미디어 쿼리와 반응형 디자인이라는 현대적 웹 표준을 지원합니다. HTML 및 CSS로 PDF 보고서, 송장 및 문서를 동적으로 장식하는 데 유용합니다.

PDF 편집

텍스트, 사진 및 기타 콘텐츠를 기존 PDF에 추가할 수 있습니다. PDF 파일에서 텍스트와 사진을 제거할 수 있습니다. 많은 PDF를 하나의 파일로 결합할 수 있습니다. PDF 파일은 여러 개의 개별 문서로 나눌 수 있습니다. 워터마크, 주석, 헤더 및 풋터를 포함할 수 있습니다.

PDF 변환

Word, Excel, 이미지 파일 등을 포함한 여러 파일 유형을 PDF 형식으로 변환합니다. PDF를 이미지(PNG, JPEG 등)로 변환합니다.

성능 및 신뢰성

고성능과 신뢰성은 산업 환경에서 넓은 문서 컬렉션을 효과적으로 관리할 수 있는 원하는 설계 품질입니다.

IronPDF를 설치하세요

.NET 프로젝트에서 PDF를 다루는 데 필요한 도구를 얻으려면 IronPDF 패키지를 설치하십시오.

Install-Package IronPdf

PDF를 생성하기 위해 Flurl을 사용하여 데이터 가져오기

HTTP 쿼리를 수행하고 API에서 데이터를 가져오기 위해 Flurl의 유연한 API를 사용하세요. 이것은 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

이 예에서 Flurl의 .GetJsonAsync() 함수는 GET 요청을 보내고 JSON 데이터를 가져오는 데 사용됩니다. User를 API 응답 구조를 나타내는 모델 클래스로 교체하고 "URL"을 실제 API 엔드포인트로 교체하세요. HTML 템플릿 htmlTemplate은 IronPDF의 ChromePdfRenderer 클래스를 사용하여 PDF 문서로 렌더링될 수 있습니다. 여기서 API에서 가져온 제목과 본문 데이터가 HTML 템플릿을 동적으로 구성하는 데 사용됩니다. 생성된 PDF 문서 pdfDocument는 파일 시스템의 지정된 위치("document.pdf")에 저장됩니다. 경로를 필요한 대로 수정하십시오.

데이터 가져오기나 PDF 생성 중 네트워크 오류 FlurlHttpException와 같은 문제나 일반 예외 Exception에 대해 강력한 오류 처리를 제공하세요. IronPDF를 사용하여 페이지 크기, 여백, 헤더, 풋터 및 기타 PDF 설정을 변경할 수 있습니다. 보다 발전된 사용자 지정 가능성에 대해서는 IronPDF의 공식 문서를 참조하십시오. API로 HTTP 쿼리를 전송할 때는 민감한 데이터와 액세스 토큰이 안전하게 처리되도록 보장해야 합니다. API가 요구하는 적절한 인증 방법을 사용하세요.