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

What Are Discriminated Unions in C#?

차별화된 합집합, 태그가 붙은 합집합 또는 합집합 타입으로도 알려져 있으며, 변수에 제한된 옵션 집합에서 하나의 값을 보유하게 하고 각 옵션은 고유한 케이스 식별자와 연관됩니다.

F#과 같은 다른 언어에서는 union 키워드를 사용하여 이를 정의할 수 있습니다. C#은 이 기능을 기본적으로 제공하지 않지만, 개발자는 record, 클래스 및 switch 표현식의 똑똑한 조합을 사용하여 이를 모방할 수 있습니다.

예를 들어:

public abstract record PdfAction;
public record GenerateReport(string ReportName) : PdfAction;
public record LogError(string Message) : PdfAction;
public record ExportToExcel(string FilePath) : PdfAction;

public abstract record PdfAction;
public record GenerateReport(string ReportName) : PdfAction;
public record LogError(string Message) : PdfAction;
public record ExportToExcel(string FilePath) : PdfAction;

Public MustOverride ReadOnly Property PdfAction() As record
public record GenerateReport(String ReportName) : PdfAction
public record LogError(String Message) : PdfAction
public record ExportToExcel(String FilePath) : PdfAction

위의 각 record는 합집합의 단일 케이스를 나타냅니다. 기본 PdfAction 타입이 구분자입니다.

IronPDF 워크플로우에서 차별화된 합집합이 중요한 이유

IronPDF를 사용하여 PDF 보고서 생성기를 구축하고 있으며, 사용자의 입력에 따라 다른 작업을 수행해야 하는 상황을 상상해 보십시오—PDF 생성, 오류 로그 기록, 데이터 내보내기 등이 있을 수 있습니다.

C#에서 차별화된 합집합을 사용하면 이러한 옵션 타입을 깔끔하게 표현할 수 있으며, 컴파일 타임 안전성, 버그 감소, 더 명확한 로직을 갖게 됩니다.

IronPDF와 함께 사용할 수 있는 방법은 다음과 같습니다.

void HandlePdfAction(PdfAction action)
{
    switch (action)
    {
        case GenerateReport r:
            var pdf = new IronPdf.HtmlToPdf().RenderHtmlAsPdf("<h1>" + r.ReportName + "</h1>");
            pdf.SaveAs(r.ReportName + ".pdf");
            break;
        case LogError e:
            Console.WriteLine("Logging Error: " + e.Message);
            break;
        case ExportToExcel x:
            Console.WriteLine("Exporting to Excel at " + x.FilePath);
            break;
        default:
            throw new NotSupportedException("Unknown action");
    }
}

void HandlePdfAction(PdfAction action)
{
    switch (action)
    {
        case GenerateReport r:
            var pdf = new IronPdf.HtmlToPdf().RenderHtmlAsPdf("<h1>" + r.ReportName + "</h1>");
            pdf.SaveAs(r.ReportName + ".pdf");
            break;
        case LogError e:
            Console.WriteLine("Logging Error: " + e.Message);
            break;
        case ExportToExcel x:
            Console.WriteLine("Exporting to Excel at " + x.FilePath);
            break;
        default:
            throw new NotSupportedException("Unknown action");
    }
}

Private Sub HandlePdfAction(ByVal action As PdfAction)
	Select Case action
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case GenerateReport r:
		Case GenerateReport r
			Dim pdf = (New IronPdf.HtmlToPdf()).RenderHtmlAsPdf("<h1>" & r.ReportName & "</h1>")
			pdf.SaveAs(r.ReportName & ".pdf")
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case LogError e:
		Case LogError e
			Console.WriteLine("Logging Error: " & e.Message)
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case ExportToExcel x:
		Case ExportToExcel x
			Console.WriteLine("Exporting to Excel at " & x.FilePath)
		Case Else
			Throw New NotSupportedException("Unknown action")
	End Select
End Sub

이 접근 방식은 코드의 정리 및 강화를 유지하고, 모든 가능한 옵션을 한 곳에서 이해하기 쉽게 만들어 줍니다.

Simulating Discriminated Unions in C# – Struct vs. Record vs. Class

C#에는 union 키워드가 없지만, 차별화된 합집합을 다음과 같이 시뮬레이션할 수 있습니다:

• record: 불변 데이터에 이상적이며, 패턴 매칭을 깔끔하게 지원합니다.
• 클래스: 상속 및 참조 의미론에 유연성이 더 높습니다.
• 구조체: 값 타입에 유용하지만, 참조 타입 및 상속을 다룰 때 덜 유연합니다.

성능 및 메모리 레이아웃이 중요한 경우—예를 들어, 높은 처리량의 PDF 로그에—구조체 차별화된 합집합을 신중하게 사용하는 것을 고려할 수 있습니다:

public interface IAction { }
public readonly struct SaveAction : IAction
{
    public string FileName { get; }
    public SaveAction(string fileName) => FileName = fileName;
}

public interface IAction { }
public readonly struct SaveAction : IAction
{
    public string FileName { get; }
    public SaveAction(string fileName) => FileName = fileName;
}

Public Interface IAction
End Interface
'INSTANT VB WARNING: VB has no equivalent to the C# readonly struct:
'ORIGINAL LINE: public readonly struct SaveAction : IAction
Public Structure SaveAction
	Implements IAction

	Public ReadOnly Property FileName() As String
	Public Sub New(ByVal fileName As String)
		Me.FileName = fileName
	End Sub
End Structure

참고: 특히 switch 표현식에 의존할 때, 구조체로 인해 패턴 매칭의 일부 이점을 잃을 수 있습니다.

Benefits of Using Discriminated Unions in C

이 소프트웨어 엔지니어링 패턴을 채택하는 데에는 몇 가지 중요한 장점이 있습니다:

• 컴파일 타임 안전성: 런타임 전에 switch 표현식에서 누락된 케이스를 발견할 수 있습니다.
• 더 명확한 로직: 케이스에 이름이 붙어 있어 동작을 작성, 주석 처리, 그리고 이유를 쉽게 이해할 수 있습니다.
• 관심사의 분리: 타입 계층보다는 데이터에 기반한 동작을 분리합니다.
• 리팩토링의 용이성: 케이스를 추가하거나 제거하는 것이 더 단순해집니다.

IronPDF와 함께 사용할 때, 이는 사용자 입력 관리, 렌더링 로직 또는 다양한 값 파이프라인을 통해 동적 템플릿을 작성하는 것을 더 쉽게 만들어 줍니다.

IronPDF와 함께 차별화된 합집합을 사용할 때

이 패턴이 우수한 성과를 거두는 몇 가지 실용적인 시나리오가 있습니다:

• PDF 생성 워크플로우: 문서 수명 주기의 다른 단계 (생성, 저장, 이메일).
• 권한 모델: 다양한 사용자 접근 수준을 나타냅니다.
• 로깅 시스템: 로그 수준(정보, 오류, 디버그)을 위해 구별된 유니언 타입을 사용합니다.
• 단위 테스트: 유지 가능한 논리 트리를 위한 테스트 작업을 유니언 타입으로 정의합니다.
• 내보내기 옵션: PDF, Excel, Word와 같은 출력 대상을 유니언 인스턴스로 나타냅니다.

예제 – UI 이벤트에서 PDF 작업 처리하기

UI 이벤트를 캡처하고 이를 구별된 유니언을 사용하여 IronPDF 작업으로 라우팅하고자 한다고 가정해 봅시다:

public abstract record UserAction;
public record GeneratePdf(string HtmlContent, string FileName) : UserAction;
public record ShowMessage(string Text) : UserAction;
public record ExitApplication() : UserAction;
void OnUserEvent(UserAction action)
{
    switch (action)
    {
        case GeneratePdf pdf:
            var renderer = new IronPdf.HtmlToPdf();
            var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
            document.SaveAs(pdf.FileName);
            break;
        case ShowMessage msg:
            MessageBox.Show(msg.Text);
            break;
        case ExitApplication:
            Application.Exit();
            break;
    }
}

public abstract record UserAction;
public record GeneratePdf(string HtmlContent, string FileName) : UserAction;
public record ShowMessage(string Text) : UserAction;
public record ExitApplication() : UserAction;
void OnUserEvent(UserAction action)
{
    switch (action)
    {
        case GeneratePdf pdf:
            var renderer = new IronPdf.HtmlToPdf();
            var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
            document.SaveAs(pdf.FileName);
            break;
        case ShowMessage msg:
            MessageBox.Show(msg.Text);
            break;
        case ExitApplication:
            Application.Exit();
            break;
    }
}

Public MustOverride ReadOnly Property UserAction() As record
public record GeneratePdf(String HtmlContent, String FileName) : UserAction
public record ShowMessage(String Text) : UserAction
public record ExitApplication() : UserAction
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'void OnUserEvent(UserAction action)
'{
'	switch (action)
'	{
'		case GeneratePdf pdf:
'			var renderer = New IronPdf.HtmlToPdf();
'			var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
'			document.SaveAs(pdf.FileName);
'			break;
'		case ShowMessage msg:
'			MessageBox.Show(msg.Text);
'			break;
'		case ExitApplication:
'			Application.@Exit();
'			break;
'	}
'}

이렇게 하면 이벤트를 명확한 논리로 표현할 수 있으며, 공개 오브젝트 타입이나 과도한 동적 처리에 대한 의존도를 줄일 수 있습니다.

Future Outlook – Will C# Ever Support Native Discriminated Unions?

더 많은 표현력 있는 타입 시스템에 대한 수요가 증가함에 따라 C#에서 구별된 유니언에 대한 네이티브 지원을 추가하자는 제안이 이미 나왔습니다. 언어는 아직 진정한 유니언 키워드를 도입하지 않았지만, C#은 점점 발전하고 있으며 레코드, 패턴 매칭, 스위치 식과 같은 기능이 구별된 유니언 기능에 더 가까워지고 있습니다.

최신 기능 친화적인 언어 구성에 관심이 있는 .NET 개발자는 이 공간을 주목해야 합니다.

마지막으로

네이티브 지원이 없더라도 C#에서 구별된 유니언을 사용하면 IronPDF 애플리케이션에서 논리 구조와 표현 방식을 크게 향상시킬 수 있습니다. 레코드, 스위치 식 및 기본 클래스를 활용함으로써 코드베이스를 더 읽기 쉽고 유지 관리하며, 오류에 강한 상태로 만들 수 있으며, 더 선언적이고 표현적인 방식으로 PDF 관련 작업을 처리할 수 있습니다.

현대적이고 유연한 .NET 애플리케이션을 구축하는 소프트웨어 엔지니어라면, 이 패턴은 도구 키트의 필수품입니다.