IRON SUITE 사용하기

비동기 처리 익히기: 스케일러블 앱 for .NET 10에서의 C# async/await의 필수 가이드

업데이트됨:

비동기/대기 C#

현대 소프트웨어 개발은 속도, 반응성 및 뛰어난 확장성을 요구합니다. 웹 앱과 Enterprise 솔루션의 세계에서 UI 스레드를 차단하거나 서버 자원을 독점하는 것은 단순히 용납할 수 없습니다. 비동기 프로그래밍은 강력한 C#의 async 및 await 키워드로 구동되어 기능을 넘어 필수적인 아키텍처 기반이 됩니다.

고성능 라이브러리를 활용하는 개발자에게 Iron Software Suite의 PDF 생성, 이미지 조작 및 OCR 등은 비동기 코드를 작성하는 방법을 이해하는 것이 중요한데, 이는 .NET Task 병렬 라이브러리의 전체 기능을 활용한 효율적인 코드 작성에 필수적입니다.

우리는 비동기/대기 C#의 메커니즘을 깊이 파고들어 이 패러다임 전환이 느린 동기 프로그래밍을 고처리량 비동기 작업으로 어떻게 변형시키는지 탐구하고, Iron Software가 기업이 최대의 성능을 달성하도록 돕는 방법을 이러한 중요한 개념과 관련지을 것입니다.

비동기 프로그래밍의 기초

async와 await 이전에, 비동기 작업은 번거로운 콜백과 수동 Task 클래스 작업을 통해 관리되어 복잡하고 오류가 발생하기 쉬운 코드를 초래했습니다. C#에서 비동기 프로그래밍은 개발자가 동기 코드처럼 보이지만 비동기로 동작하는 코드를 작성할 수 있도록 하여 이를 단순화하였습니다.

두 가지 핵심 요소는:

  1. async 키워드: async 수정자는 메서드를 await 표현식을 포함할 수 있는 비동기 메서드로 표시합니다. 결정적으로, 메서드를 async로 표시한다고 해서 자동으로 백그라운드 스레드에서 실행되는 것은 아닙니다. 이는 단순히 컴파일러가 코드의 연속성을 관리하는 복잡한 상태 기계를 생성할 수 있도록 해줍니다. 비동기 메서드는 일반적으로 진행 중인 비동기 작업을 나타내기 위해 Task 객체(Task 또는 Task)를 반환합니다.

  2. await 키워드: await 키워드는 마법 같은 구성 요소입니다. await 표현식을 만나면 메서드는 대기 중인 작업이 완료되었는지 확인합니다. 그렇지 않으면, 메서드는 즉시 실행을 중지하고 호출 메서드(또는 호출자)로 제어를 반환합니다. 이것은 현재 스레드(종종 메인 스레드 혹은 스레드 풀 스레드)를 다른 요청이나 다른 작업을 처리할 수 있도록 합니다. 작업이 완료되면 메서드의 나머지 부분이 지속으로 등록되고 다시 실행되도록 예약됩니다.

다음은 기본적인 코드 예제입니다:

public static async Task<string> DownloadDataAsync(string url)
{
    // The async keyword allows us to use await
    using var client = new HttpClient();

    // await task: Control returns to the caller while the HTTP call happens
    string data = await client.GetStringAsync(url); // I/O-bound 

    // The code after the await expression runs once the task finishes
    return $"Data length: {data.Length}";
}

// Modern entry point for console apps
public static async Task Main(string[] args) 
{
    // This is the static async task main entry point
    var result = await DownloadDataAsync("https://api.example.com/data");
    Console.WriteLine(result);
}
public static async Task<string> DownloadDataAsync(string url)
{
    // The async keyword allows us to use await
    using var client = new HttpClient();

    // await task: Control returns to the caller while the HTTP call happens
    string data = await client.GetStringAsync(url); // I/O-bound 

    // The code after the await expression runs once the task finishes
    return $"Data length: {data.Length}";
}

// Modern entry point for console apps
public static async Task Main(string[] args) 
{
    // This is the static async task main entry point
    var result = await DownloadDataAsync("https://api.example.com/data");
    Console.WriteLine(result);
}
Imports System
Imports System.Net.Http
Imports System.Threading.Tasks

Public Module Program
    Public Async Function DownloadDataAsync(url As String) As Task(Of String)
        ' The async keyword allows us to use await
        Using client As New HttpClient()
            ' await task: Control returns to the caller while the HTTP call happens
            Dim data As String = Await client.GetStringAsync(url) ' I/O-bound 

            ' The code after the await expression runs once the task finishes
            Return $"Data length: {data.Length}"
        End Using
    End Function

    ' Modern entry point for console apps
    Public Async Function Main(args As String()) As Task
        ' This is the static async task main entry point
        Dim result As String = Await DownloadDataAsync("https://api.example.com/data")
        Console.WriteLine(result)
    End Function
End Module
$vbLabelText   $csharpLabel

static async task main의 사용은 현대 표준으로, .Wait()이나 .Result와 같은 레거시 메서드를 사용하여 주 스레드를 차단할 필요를 제거합니다.

성능 및 Iron Software 통합

Task는 비동기 코드의 표준 반환 유형이지만, .NET 10에서의 고급 비동기 프로그래밍에서는 동기적 완료 가능성이 높은 "핫 패스"에서 중요한 성능 향상을 위해 빈번하게 ValueTask를 사용합니다 (예: 캐시된 값 가져오기). ValueTask는 메모리 할당을 피하여 높은 처리량 애플리케이션에 중요합니다.

Iron Software에 비동기 작업 적용

Iron Software 제품은 IronOCR (광학 문자 인식) 및 IronPDF (PDF 생성)와 같이 비동기 호출을 활용하기에 완벽한 후보입니다. 대형 HTML 문서를 PDF로 변환하거나 수백 페이지의 이미지에서 텍스트 인식하는 작업은 종종 CPU 기반 작업이거나 파일 시스템 I/O를 수반하여 비동기 메서드에서 큰 이득을 얻습니다.

Iron Software에서 제공하는 동기 및 비동기 메서드를 사용하면 애플리케이션이 높은 반응성을 유지할 수 있습니다.

IronPDF를 사용하여 지정된 URL에서 문서를 생성하는 것을 고려해보세요:

public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
    // 1. Initialize the renderer
    var renderer = new IronPdf.ChromePdfRenderer();

    // Optional: Set rendering options if needed (e.g., margins, headers)
    renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

    // 2. The core asynchronous operation: Fetch and render the URL content
    // This is an I/O-bound task that releases the calling thread.
    var pdf = await renderer.RenderUrlAsPdfAsync(url);

    // 3. Save the PDF file asynchronously
    await Task.Run(() =>
    {
        // This is the synchronous method you confirmed exists
        pdf.SaveAs(outputFileName);
    });
}
public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
    // 1. Initialize the renderer
    var renderer = new IronPdf.ChromePdfRenderer();

    // Optional: Set rendering options if needed (e.g., margins, headers)
    renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

    // 2. The core asynchronous operation: Fetch and render the URL content
    // This is an I/O-bound task that releases the calling thread.
    var pdf = await renderer.RenderUrlAsPdfAsync(url);

    // 3. Save the PDF file asynchronously
    await Task.Run(() =>
    {
        // This is the synchronous method you confirmed exists
        pdf.SaveAs(outputFileName);
    });
}
Imports System.Threading.Tasks
Imports IronPdf

Public Module PdfGenerator
    Public Async Function GeneratePdfFromUrlAsync(url As String, outputFileName As String) As Task
        ' 1. Initialize the renderer
        Dim renderer As New ChromePdfRenderer()

        ' Optional: Set rendering options if needed (e.g., margins, headers)
        renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4

        ' 2. The core asynchronous operation: Fetch and render the URL content
        ' This is an I/O-bound task that releases the calling thread.
        Dim pdf = Await renderer.RenderUrlAsPdfAsync(url)

        ' 3. Save the PDF file asynchronously
        Await Task.Run(Sub()
                           ' This is the synchronous method you confirmed exists
                           pdf.SaveAs(outputFileName)
                       End Sub)
    End Function
End Module
$vbLabelText   $csharpLabel

비동기 메서드를 사용하여 생성한 PDF

PDF 비동기적으로 렌더링됨

RenderHtmlAsPdfAsync() 비동기 메서드를 사용함으로써 대량 문서 처리 시 애플리케이션이 멈추거나 차단되는 것을 방지합니다. 이는 복잡한 처리에 대해 비동기 코드를 효율적으로 작성하는 방법을 증명합니다.

최고의 실천 방법 및 엣지 케이스

1. 다수의 작업 및 I/O 처리

효율성을 극대화하려면 원격 서버에서 데이터를 가져오거나 데이터베이스 쿼리 수행과 같은 독립적인 I/O 기반 작업을 기다릴 때 여러 작업을 동시에 시작해야 합니다.

public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
    // Creating tasks starts the async operation immediately
    Task<string> taskA = DownloadDataAsync(url1); 
    Task<string> taskB = DownloadDataAsync(url2);

    // Wait for all the tasks to complete simultaneously
    string[] results = await Task.WhenAll(taskA, taskB);
    return results;
}
public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
    // Creating tasks starts the async operation immediately
    Task<string> taskA = DownloadDataAsync(url1); 
    Task<string> taskB = DownloadDataAsync(url2);

    // Wait for all the tasks to complete simultaneously
    string[] results = await Task.WhenAll(taskA, taskB);
    return results;
}
Option Strict On



Public Async Function FetchAllDataAsync(url1 As String, url2 As String) As Task(Of String())
    ' Creating tasks starts the async operation immediately
    Dim taskA As Task(Of String) = DownloadDataAsync(url1)
    Dim taskB As Task(Of String) = DownloadDataAsync(url2)

    ' Wait for all the tasks to complete simultaneously
    Dim results As String() = Await Task.WhenAll(taskA, taskB)
    Return results
End Function
$vbLabelText   $csharpLabel

이는 동시에 실행되는 작업을 생성하여 비차단 비동기 작업을 통해 애플리케이션의 응답 시간을 극적으로 개선하는 표준 패턴입니다.

2. 동기화 컨텍스트 및 ConfigureAwait(false)

기본 동작은 대기 중인 작업이 완료되면 동기화 컨텍스트를 캡쳐하고 지속이 동일한 스레드(예: UI 스레드)에서 실행되도록 보장합니다. 이는 UI 애플리케이션에 필수적이지만 서버 측 또는 라이브러리 코드에서는 불필요한 오버헤드를 유발합니다.

ConfigureAwait(false)를 사용하면 await 호출 이후의 코드가 가능한 스레드 풀 백그라운드 스레드에서 재개될 수 있음을 런타임에 알립니다. 이는 라이브러리 개발자들에게 비동기 작업에 대한 최대 성능을 보장하는 중요한 실천입니다:

// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false); 
// This code continues on any thread, improving resource usage.
// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false); 
// This code continues on any thread, improving resource usage.
' Critical for shared libraries to avoid deadlocks and improve throughput
Dim data = Await GetVarDataFromRemoteServer().ConfigureAwait(False)
' This code continues on any thread, improving resource usage.
$vbLabelText   $csharpLabel

3. async void의 위험성

비동기 프로그래밍에서 가장 중요한 규칙 중 하나는 비동기 이벤트 처리기 외에 async void를 절대 사용하지 않는 것입니다. 예를 들어, 버튼 클릭 이벤트 핸들러 메서드는 일반적으로 async void를 사용합니다:

private async void Button_Click(object sender, EventArgs e) // event handler
{
    // This is one of the few places async void is acceptable
    await GenerateReportAsync(html);
}
private async void Button_Click(object sender, EventArgs e) // event handler
{
    // This is one of the few places async void is acceptable
    await GenerateReportAsync(html);
}
Private Async Sub Button_Click(sender As Object, e As EventArgs) Handles Button.Click ' event handler
    ' This is one of the few places async void is acceptable
    Await GenerateReportAsync(html)
End Sub
$vbLabelText   $csharpLabel

다른 용도의 async void 메서드 사용은 강력히 권장되지 않습니다. 비동기 void 메서드는 기다릴 수 없으므로, 호출 스레드는 완료를 추적하거나 예외를 신뢰할 수 있게 처리할 수 없어 오류 처리가 문제가 됩니다. 모든 다른 비동기 메서드에 대해 항상 Task 또는 Task를 반환하세요.

4. 예외 처리

견고한 예외 처리는 매우 중요합니다. 비동기 작업이 실패할 때(예: 웹 서비스 호출 시 오류 발생), 예외는 작업 객체에 저장됩니다. 작업을 기다릴 때 await 표현식은 현재 스레드(연속성을 다시 시작하는 스레드)에 예외를 다시 던져, 표준 try...catch 블록이 예외 처리에 효과적으로 작동하도록 합니다.

결론

C#의 async 및 await 패턴은 개발자를 견고하지 못한 동기 프로그래밍에서 내구성 있고 확장 가능한 비동기 메서드로 이동시키는 패러다임 시프트 기능입니다. 기초 상태 기계를 이해하고, 비동기 void보다 Task를 우선시하며, 라이브러리에서 ConfigureAwait(false)를 사용하고, 예외 처리를 정확하게 구현하는 등의 모범 사례를 준수함으로써 개발자는 Iron Software의 제품군과 같은 복잡한 처리 작업을 뛰어난 성능으로 처리하는 애플리케이션을 만들 수 있습니다.

Iron Software는 고성능 비동기 프로그래밍을 핵심으로 하는 제품 개발에 전념하고 있으며, 사용자 코드 작성 방식이 최대 처리량을 결과로 가져옵니다. Iron Software의 세계를 탐험하고 비동기 작업 처리가 귀하의 애플리케이션의 속도와 응답성을 획기적으로 향상시킬 수 있는 방법을 확인해보세요.