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

C#에서 Flunt를 사용하는 방법

1. 새로운 C# 콘솔 프로젝트를 만듭니다.
2. NuGet에서 Flunt 패키지를 설치합니다.
3. 네임스페이스를 가져오고 클래스를 상속합니다.
4. 데이터 모델에 유효성 검사를 추가합니다.
5. 유효성 검사를 수행하고 결과를 표시합니다.

Flunt C# 이해하기

다목적이며 가벼운 .NET Framework인 Flunt는 C# 애플리케이션에서 유창한 유효성 검사 및 알림 패턴 개발을 촉진하기 위해 만들어졌습니다. 개발자는 Flunt를 사용하여 유효성 검사 규칙과 비즈니스 로직을 유체적이고 표현력 있는 방식으로 구성할 때 코드가 더 읽기 쉽게 되고 유지 관리됩니다. Flunt의 광범위한 내장 유효성 검사 기법과 확장을 통해 개발자는 객체 및 컬렉션과 같은 복잡한 데이터 구조를 쉽게 검증할 수 있습니다.

더욱이 Flunt는 기존 코드베이스 및 프레임워크와 쉽게 통합되기 때문에 .NET 라이브러리 애플리케이션의 신뢰성과 견고성을 높이는 유용한 도구입니다. 전반적으로 Flunt는 개발자가 더 깨끗하고 견고한 코드를 작성할 수 있도록 유효성 검사와 오류 처리에 선언적 접근 방식을 장려합니다.

Flunt C# 시작하기

Flunt C# 예제

Flunt가 설치되면 다음 코드를 사용할 수 있습니다. 이것은 Flunt를 사용하여 유효성 검사 규칙을 구축하는 방법을 보여주는 간단한 예입니다:

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

using System;
using Flunt.Validations;

public class Program
{
    static void Main(string[] args)
    {
        var person = new Person { Name = "Jack", Age = -25 };
        var contract = new PersonContract(person);

        // Perform validation checks
        if (contract.IsValid)
        {
            Console.WriteLine("Person is valid!");
        }
        else
        {
            Console.WriteLine("Validation failed:");
            foreach (var notification in contract.Notifications)
            {
                Console.WriteLine($"- {notification.Key}: {notification.Message}");
            }
        }
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class PersonContract : Contract<Person>
{
    public PersonContract(Person person)
    {
        // Ensure the correct format of the object
        Requires()
            .IsNotNull(person, nameof(person))
            .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
            .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
    }
}

Imports System
Imports Flunt.Validations

Public Class Program
	Shared Sub Main(ByVal args() As String)
		Dim person As New Person With {
			.Name = "Jack",
			.Age = -25
		}
		Dim contract = New PersonContract(person)

		' Perform validation checks
		If contract.IsValid Then
			Console.WriteLine("Person is valid!")
		Else
			Console.WriteLine("Validation failed:")
			For Each notification In contract.Notifications
				Console.WriteLine($"- {notification.Key}: {notification.Message}")
			Next notification
		End If
	End Sub
End Class

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
End Class

Public Class PersonContract
	Inherits Contract(Of Person)

	Public Sub New(ByVal person As Person)
		' Ensure the correct format of the object
		Requires().IsNotNull(person, NameOf(person)).IsNotEmpty(person.Name, NameOf(person.Name), "Name is required").IsGreaterThan(person.Age, 0, NameOf(person.Age), "Age must be a positive number")
	End Sub
End Class

클래스: 엔터티를 나타내며 Name 및 Age 속성을 갖습니다.

PersonContract: 이 클래스는 Flunt의 기본 개념인 Contract<t>에서 파생됩니다. Requires 메서드를 사용하여 생성자는 Person 객체를 받아 이를 위한 유효성 검증 규칙을 제공합니다. Requires은 여러 검증을 정의하는 체인 방식의 메서드를 제공합니다. 검증은 IsNotNull, IsNotEmpty, IsGreaterThan 같은 메서드에 의해 수행됩니다. 각 유효성 검사 규칙에는 관련된 사용자 정의 오류 메시지가 있습니다.

검증: FluentValidation 예제와 유사하게, 이는 PersonContract 및 Person 객체 인스턴스를 생성합니다. 검증 결과는 계약의 IsValid 속성에 의해 표시됩니다. 유효성 검사 결과에 따라 성공 또는 실패 알림, 구체적인 오류 메시지가 표시됩니다.

Flunt 작업

C# 애플리케이션에서 유효성 검사 및 알림 관리를 위해 Flunt는 다음과 같은 작업을 제공합니다:

유효성 검사 규칙 생성: 필수 필드, 데이터 유형, 값 범위, 최대 길이, 최소 길이와 같은 속성에 대한 유효성 검사 규칙을 만들기 위해 유창한 인터페이스를 사용하세요.

유효성 검사 실행: 데이터 무결성과 비즈니스 로직 준수를 보장하기 위해 객체를 사전 정의된 규칙에 대해 검증하세요.

유효성 검사 오류 관리: 유효성 검사 오류를 알림으로 기록하고, 사용자에게 오류 메시지를 제공하거나 문제 해결을 위해 오류를 기록함으로써 정중하게 응답하세요.

사용자 정의 유효성 검사 로직: 복잡한 유효성 검사 상황이나 특정 도메인 요구에 대응하기 위해 Flunt를 확장하는 독특한 유효성 검사 규칙을 사용하세요.

프레임워크와의 통합: 현재 응용 프로그램에서 유효성 검증 기능을 개선하기 위해 Flunt는 Entity Framework, ASP.NET Core를 포함한 많은 잘 알려진 .NET Framework 및 라이브러리에 원활하게 통합될 수 있습니다.

IronPDF와 Flunt 통합

개발자는 Flunt와 IronPDF를 통합하여 C# 응용 프로그램에서 비즈니스 로직 유효성 검증 및 문서 생성을 가속화할 수 있습니다. IronPDF를 사용하여 입력 데이터를 Flunt로 유효성 검사를 진행한 후, PDF 문서를 생성함으로써 개발자들은 응용 프로그램을 더 신뢰할 수 있고 사용자 친화적으로 만들 수 있습니다.

IronPDF 설치

• Visual Studio 프로젝트를 시작하세요.
• '도구' > 'NuGet 패키지 관리' > '패키지 관리자 콘솔'을 선택하세요.
• 이 명령을 패키지 관리자 콘솔에 입력하세요:

Install-Package IronPdf

• 대안으로, 솔루션의 NuGet 패키지 관리자를 사용하여 IronPDF 및 필수 NuGet 패키지를 설치할 수 있습니다.
• 검색 결과에서 IronPDF 패키지를 찾아 선택한 후 '설치' 버튼을 클릭하세요. 설치 및 다운로드는 Visual Studio가 처리합니다.

• 프로젝트에 필요한 종속성을 포함하여 IronPDF Install-Package는 NuGet이 처리할 것입니다.
• 설치 후, IronPDF는 프로젝트에서 사용할 수 있습니다.

논리 구현

IronPDF를 사용한 PDF 생성 및 Flunt를 이용한 데이터 유효성 검사를 포함하는 기본적인 C# 응용 프로그램을 만들어 봅시다. 이 예제에서는 등록 양식을 위한 사용자 입력을 Flunt로 유효성 검사하고, 검증된 사용자 데이터 요약으로 PDF 문서를 IronPDF로 생성합니다.

1. Person 클래스: 이름과 나이 속성을 가진 Person 클래스를 정의합니다. 생성자에서 Flunt의 플루언트 인터페이스를 사용하여 미리 정의된 유효성 검사 규칙에 대해 Person 데이터를 검증합니다.
2. PDF 생성: 사용자 객체를 입력으로 받는 RenderHtmlAsPdf라는 메서드가 정의됩니다. 이 함수는 사용자 등록 요약을 나타내는 HTML 텍스트를 IronPDF의 HtmlToPdf 클래스를 사용하여 PDF 문서로 렌더링합니다.
3. 메인 메소드: 샘플 Person 데이터를 사용하여 메인 메소드에서 User 클래스의 인스턴스를 생성합니다. 다음으로, 우리는 Person 데이터가 유효한지 판단하기 위해 Flunt의 IsValid 속성을 사용합니다. 데이터가 맞다면 IronPdf 메소드를 호출하여 PDF 문서를 생성합니다. 그렇지 않다면, 유효성 검사 문제는 콘솔에 표시됩니다.

IronPDF를 통해 PDF를 생성하고 Flunt로 데이터 유효성을 검사하여 사용자 입력을 평가하고 PDF 문서를 생성하는 빠른 워크플로우를 개발했습니다. 이 방법은 데이터 무결성을 보장하고 전문적인 품질의 문서를 생성하며 명확하고 읽기 쉬우며 유지 관리가 쉬운 코드를 쓰도록 장려합니다. IronPDF의 기능에 대해 더 읽으려면 문서 페이지를 참조하세요. 아래는 샘플 코드 조각입니다.

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

using IronPdf;
using System;
using System.Linq;
using System.Text;
using Flunt.Validations;

namespace ConsoleApp
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // StringBuilder for HTML content
            StringBuilder sb = new StringBuilder();
            var person = new Person { Name = "Jack", Age = -25 };
            var contract = new PersonContract(person);

            if (contract.IsValid)
            {
                Console.WriteLine("Person is valid!");
                sb.Append("<p>Person is valid!</p>");
            }
            else
            {
                sb.Append("<p>Validation failed: </p>");
                foreach (var notification in contract.Notifications)
                {
                    sb.Append($"- {notification.Key}: {notification.Message}<br>");
                }
            }

            var renderer = new HtmlToPdf();
            // Set HTML content for the page
            var pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString());
            // Save the document
            pdfDocument.SaveAs("output.pdf");
            // Dispose the renderer object
            renderer.Dispose();
            // Display a message
            Console.WriteLine("Report generated successfully!");
        }
    }

    public class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    public class PersonContract : Contract<Person>
    {
        public PersonContract(Person person)
        {
            Requires()
                .IsNotNull(person, nameof(person))
                .IsNotEmpty(person.Name, nameof(person.Name), "Name is required")
                .IsGreaterThan(person.Age, 0, nameof(person.Age), "Age must be a positive number");
        }
    }
}

Imports IronPdf
Imports System
Imports System.Linq
Imports System.Text
Imports Flunt.Validations

Namespace ConsoleApp
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' StringBuilder for HTML content
			Dim sb As New StringBuilder()
			Dim person As New Person With {
				.Name = "Jack",
				.Age = -25
			}
			Dim contract = New PersonContract(person)

			If contract.IsValid Then
				Console.WriteLine("Person is valid!")
				sb.Append("<p>Person is valid!</p>")
			Else
				sb.Append("<p>Validation failed: </p>")
				For Each notification In contract.Notifications
					sb.Append($"- {notification.Key}: {notification.Message}<br>")
				Next notification
			End If

			Dim renderer = New HtmlToPdf()
			' Set HTML content for the page
			Dim pdfDocument = renderer.RenderHtmlAsPdf(sb.ToString())
			' Save the document
			pdfDocument.SaveAs("output.pdf")
			' Dispose the renderer object
			renderer.Dispose()
			' Display a message
			Console.WriteLine("Report generated successfully!")
		End Sub
	End Class

	Public Class Person
		Public Property Name() As String
		Public Property Age() As Integer
	End Class

	Public Class PersonContract
		Inherits Contract(Of Person)

		Public Sub New(ByVal person As Person)
			Requires().IsNotNull(person, NameOf(person)).IsNotEmpty(person.Name, NameOf(person.Name), "Name is required").IsGreaterThan(person.Age, 0, NameOf(person.Age), "Age must be a positive number")
		End Sub
	End Class
End Namespace

위 코드를 실행한 결과는 다음과 같습니다:

Flunt C# (개발자를 위한 작동 원리): 그림 3 - Flunt 및 IronPDF를 모두 활용한 위 코드의 예시 출력

결론

IronPDF와 Flunt는 문서 생성 및 데이터 유효성 검사 워크플로우를 간소화하기 위해 잘 작동하는 두 가지 강력한 C# 라이브러리입니다. IronPDF의 정교한 PDF 제작 기능과 Flunt의 강력한 유효성 검사 기능을 통해 개발자는 다양한 응용 프로그램에 대해 신뢰성 있고 효과적이며 고품질의 솔루션을 제작할 수 있습니다. Flunt와 IronPDF는 개발자가 고품질 소프트웨어를 만들어 사용자 및 이해관계자의 요구를 충족시킬 수 있는 도구를 제공합니다. 이는 데스크탑 앱, 웹 애플리케이션 혹은 클라우드 기반 솔루션을 개발하는 경우에도 마찬가지입니다.

소프트웨어 지원 1년, 영구 라이선스, 라이브러리 업그레이드는 모두 $799 Lite 번들에 포함됩니다. IronPDF는 비용 및 라이선스 요구사항에 관한 추가 정보를 제공하기 위해 IronPDF의 무료 라이선스 세부 정보를 제공합니다. Iron Software 라이브러리에 대한 추가 정보는 Iron Software 공식 웹사이트를 방문하십시오.