메시지 아이콘
푸터 콘텐츠로 바로가기
  1. IronPDF
  2. IronPDF 블로그
  3. .NET 도움말
  4. NBuilder .NET
.NET 도움말

NBuilder .NET (개발자를 위한 작동 방식)

제이콥 멜러, 팀 아이언 최고기술책임자
제이콥 멜러
업데이트됨:

NBuilder는 테스트 데이터 생성을 간소화하는 .NET 라이브러리입니다. 개발자는 유창한 인터페이스를 통해 복잡한 객체 그래프를 손쉽게 생성할 수 있습니다. 이는 인기 있는 테스트 프레임워크와의 유연성, 효율성 및 원활한 통합을 제공합니다. 이 기사에서는 NBuilder의 기능, 설치 방법, 실제 코드 예제를 사용하여 그 기능을 시연하는 방법을 탐구할 것입니다.

NBuilder .NET (개발자를 위한 작동 방식): 그림 1 - NBuilder

NBuilder의 기능

  1. NBuilder는 테스트 및 모킹 목적으로 객체 생성을 단순화하기 위해 설계된 C# 오픈 소스 .NET 라이브러리입니다. 개발자는 다양한 데이터 유형을 기반으로 기본 제공 또는 사용자 정의 입력을 통해 객체를 신속하게 생성할 수 있습니다.
  2. 이는 단위 테스트, 기능 테스트 및 통합 테스트에 특히 유용합니다.
  3. 이는 .NET 내장 데이터 유형과 복잡한 객체를 테스트하는 필수 패키지 중 하나입니다.
  4. 무작위 데이터 생성을 위해 사용됩니다. 이 오픈 소스 프로젝트에 기여할 수 있습니다.
  5. NBuilder를 사용하면 기본 속성을 쉽게 재정의하고 사용자 정의 구성을 작성할 수 있습니다.

NBuilder 설치

NuGet 패키지 관리자 콘솔에서 NBuilder를 설치하려면 다음 명령을 사용하세요.

Install-Package NBuilder

위 명령은 모든 종속성을 포함하여 NBuilder를 설치할 것입니다.

NBuilder .NET (개발자를 위한 작동 방식): 그림 2 - NBuilder 설치

NBuilder 사용법

NBuilder는 실시간으로 객체를 생성하는 유창한 방법을 제공합니다. 객체를 생성하는 간단한 예제부터 시작해 보겠습니다.

여기에 Person 모델 클래스 소스 코드가 있습니다.

class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public bool IsMarried { get; set; }
}
class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public bool IsMarried { get; set; }
}
Friend Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property Email() As String
	Public Property IsMarried() As Boolean
End Class
$vbLabelText   $csharpLabel

예제 1: 기본 값으로 Person 객체 생성

// Create a new person object with default values using NBuilder
var person = Builder<Person>
                .CreateNew()
                .Build();
// By default, NBuilder can provide values like 
// Id = 1, Name = Name1, Email = Email1, IsMarried = false
// Create a new person object with default values using NBuilder
var person = Builder<Person>
                .CreateNew()
                .Build();
// By default, NBuilder can provide values like 
// Id = 1, Name = Name1, Email = Email1, IsMarried = false
' Create a new person object with default values using NBuilder
Dim person = Builder(Of Person) .CreateNew().Build()
' By default, NBuilder can provide values like 
' Id = 1, Name = Name1, Email = Email1, IsMarried = false
$vbLabelText   $csharpLabel

샘플 이미지

NBuilder .NET (개발자를 위한 작동 방식): 그림 3 - 값이 설정된 Person 객체

예제 2: 사용자 정의 빌더로 객체 생성

NBuilder를 사용하여 사용자 정의 속성이 있는 Person 객체를 생성하고 구성하는 방법의 예는 다음과 같습니다:

// Initialize a custom builder for the Person object with specific values
var customPersonBuilder = Builder<Person>.CreateNew()
                .With(p => p.Name = "Tom")
                .With(p => p.Email = "Tom@email.com");
// Build the custom person object with the specified properties
var objTom = customPersonBuilder.Build();
// Initialize a custom builder for the Person object with specific values
var customPersonBuilder = Builder<Person>.CreateNew()
                .With(p => p.Name = "Tom")
                .With(p => p.Email = "Tom@email.com");
// Build the custom person object with the specified properties
var objTom = customPersonBuilder.Build();
' Initialize a custom builder for the Person object with specific values
Dim customPersonBuilder = Builder(Of Person).CreateNew().With(Sub(p) p.Name = "Tom").With(Sub(p) p.Email = "Tom@email.com")
' Build the custom person object with the specified properties
Dim objTom = customPersonBuilder.Build()
$vbLabelText   $csharpLabel

위 코드는 사용자 정의 속성이 있는 새 Person 객체를 생성합니다. Person 객체에 대한 customPersonBuilder를 초기화하여 Name을 "Tom", Email을 "Tom@email.com"으로 설정합니다. 마지막으로 객체를 빌드하여 objTom에 할당합니다.

예제 3: 기본 값으로 Person 객체 목록 생성

// Create a list of 10 Person objects with default values using NBuilder
var personList = Builder<Person>
                                     .CreateListOfSize(10)
                                     .Build();
// Create a list of 10 Person objects with default values using NBuilder
var personList = Builder<Person>
                                     .CreateListOfSize(10)
                                     .Build();
' Create a list of 10 Person objects with default values using NBuilder
Dim personList = Builder(Of Person) .CreateListOfSize(10).Build()
$vbLabelText   $csharpLabel

샘플 이미지

NBuilder .NET (개발자를 위한 작동 방식): 그림 4 - Person 객체 목록

여기에 personList는 기본값이 있는 10개의 객체가 있으며 이를 출력합니다.

// Creating a list of 10 Person objects with default values
var personList = Builder<Person>
                                            .CreateListOfSize(10)
                                            .Build();

// Print details of each Person object in the list
foreach (var person in personList)
{
    Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}");
}
// Creating a list of 10 Person objects with default values
var personList = Builder<Person>
                                            .CreateListOfSize(10)
                                            .Build();

// Print details of each Person object in the list
foreach (var person in personList)
{
    Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}");
}
' Creating a list of 10 Person objects with default values
Dim personList = Builder(Of Person) .CreateListOfSize(10).Build()

' Print details of each Person object in the list
For Each person In personList
	Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}")
Next person
$vbLabelText   $csharpLabel

NBuilder .NET (개발자를 위한 작동 방식): 그림 5 - 자동으로 값 할당

예제 4: 생성된 객체 사용자 정의

가끔 생성되는 객체를 사용자 정의해야 할 수도 있습니다. 또한 With() 메서드를 사용하여 객체의 값을 사용자 정의할 수 있습니다.

// Customize properties for all Person objects in the list
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = "Kim")
                .With(p => p.Email = "abc@email.com")
                .With(p => p.IsMarried = false)
                .Build();
// Customize properties for all Person objects in the list
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = "Kim")
                .With(p => p.Email = "abc@email.com")
                .With(p => p.IsMarried = false)
                .Build();
' Customize properties for all Person objects in the list
Dim personList = Builder(Of Person) .CreateListOfSize(10).All().With(Sub(p) p.Name = "Kim").With(Sub(p) p.Email = "abc@email.com").With(Sub(p) p.IsMarried = False).Build()
$vbLabelText   $csharpLabel

이것은 각 객체에 기본 값을 Name = "Kim", Email = "abc@email.com", IsMarried = false로 덮어쓰는 personList을 생성합니다.

예제 5: 현실적인 무작위 데이터로 Person 객체 목록 생성

Person 목록에서 현실적인 데이터 값을 얻기 위해 Faker Library .NET을 사용하여 현실적인 데이터를 생성할 수 있습니다.

// Creating a list of Person objects with random yet realistic values using Faker
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = Faker.Name.FullName())
                .With(p => p.Id = Faker.RandomNumber.Next(20, 60))
                .Build();
// Creating a list of Person objects with random yet realistic values using Faker
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = Faker.Name.FullName())
                .With(p => p.Id = Faker.RandomNumber.Next(20, 60))
                .Build();
' Creating a list of Person objects with random yet realistic values using Faker
Dim personList = Builder(Of Person) .CreateListOfSize(10).All().With(Sub(p) p.Name = Faker.Name.FullName()).With(Sub(p) p.Id = Faker.RandomNumber.Next(20, 60)).Build()
$vbLabelText   $csharpLabel

예제 6: 순차 데이터로 Person 객체 목록 생성

순차적인 데이터로 객체를 생성해야 할 때가 있습니다. NBuilder .NET은 Do 메서드를 사용하여 이를 촉진합니다.

// Creating a list of 10 sequential Person objects using NBuilder
var personList = Builder<Person>.CreateListOfSize(10)
                .All()
                .Do((p, i) => p.Id = 501 + i)
                .Do((p, i) => p.Name = $"Person {i + 1}")
                .Build();
// Creating a list of 10 sequential Person objects using NBuilder
var personList = Builder<Person>.CreateListOfSize(10)
                .All()
                .Do((p, i) => p.Id = 501 + i)
                .Do((p, i) => p.Name = $"Person {i + 1}")
                .Build();
' Creating a list of 10 sequential Person objects using NBuilder
Dim personList = Builder(Of Person).CreateListOfSize(10).All().Do(Sub(p, i) p.Id = 501 + i).Do(Sub(p, i) p.Name = $"Person {i + 1}").Build()
$vbLabelText   $csharpLabel

여기서 All() 메서드는 메모리에 생성된 10개의 Person 객체 모두에 후속 작업이 적용되도록 보장합니다. Do() 메서드는 각 Person 객체에 대해 Action 대리자를 실행합니다. 이 설정은 501부터 순차적으로 Id 속성을 할당하며, 또한 각 사람을 "Person 1"부터 "Person 10"까지 순차적으로 이름 짓습니다.

NBuilder .NET (개발자를 위한 작동 방식): 그림 6 - 순차 데이터

예제 7: Xunit를 사용하여 단위 테스트와 NBuilder

NBuilder는 .NET에서 테스트 환경에서 크게 사용되며, 개발자가 테스트를 위해 현실적이고 다양한 데이터 세트를 생성할 필요가 있습니다. 이것은 복잡한 객체로 테스트를 쉽게 유지 관리할 수 있으며, 효율적이고 유연한 테스트 데이터 생성을 원하는 분들을 위해 람다 표현식과 대리자 함수를 사용하여 사용자 정의 초기화 논리를 정의할 수 있습니다.

단위 테스트를 위한 모델 클래스와 서비스

class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public bool IsMarried { get; set; }
}

class PersonService
{
    public string GetPersonEmail(Person person)
    {
        return person.Email;
    }
}
class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public bool IsMarried { get; set; }
}

class PersonService
{
    public string GetPersonEmail(Person person)
    {
        return person.Email;
    }
}
Friend Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property Email() As String
	Public Property IsMarried() As Boolean
End Class

Friend Class PersonService
	Public Function GetPersonEmail(ByVal person As Person) As String
		Return person.Email
	End Function
End Class
$vbLabelText   $csharpLabel

여기서 Person 클래스는 여러 속성을 가지고 있으며, 이러한 속성으로는 Id, Name, Email, IsMarried가 있습니다. 반면, PersonService는 주어진 Person의 이메일을 반환하는 GetPersonEmail() 메서드를 포함합니다.

테스트 클래스와 테스트 데이터

using Xunit;

public class PersonTests
{
     [Fact]
     public void GetPersonEmail_ReturnCorrectEmail()
     {
         // Arrange
         var service = new PersonService();
         string expectedEmail = "Tom@email.com";

         // Create a person with specific name and email using NBuilder
         var person = Builder<Person>.CreateNew()
             .With(p => p.Name = "Tom")
             .With(p => p.Email = "Tom@email.com")
             .Build();

         // Act
         var actualEmail = service.GetPersonEmail(person);

         // Assert
         Assert.Equal(expectedEmail, actualEmail);
     }
}
using Xunit;

public class PersonTests
{
     [Fact]
     public void GetPersonEmail_ReturnCorrectEmail()
     {
         // Arrange
         var service = new PersonService();
         string expectedEmail = "Tom@email.com";

         // Create a person with specific name and email using NBuilder
         var person = Builder<Person>.CreateNew()
             .With(p => p.Name = "Tom")
             .With(p => p.Email = "Tom@email.com")
             .Build();

         // Act
         var actualEmail = service.GetPersonEmail(person);

         // Assert
         Assert.Equal(expectedEmail, actualEmail);
     }
}
Imports Xunit

Public Class PersonTests
	 <Fact>
	 Public Sub GetPersonEmail_ReturnCorrectEmail()
		 ' Arrange
		 Dim service = New PersonService()
		 Dim expectedEmail As String = "Tom@email.com"

		 ' Create a person with specific name and email using NBuilder
		 Dim person = Builder(Of Person).CreateNew().With(Sub(p) p.Name = "Tom").With(Sub(p) p.Email = "Tom@email.com").Build()

		 ' Act
		 Dim actualEmail = service.GetPersonEmail(person)

		 ' Assert
		 Assert.Equal(expectedEmail, actualEmail)
	 End Sub
End Class
$vbLabelText   $csharpLabel

이 단위 테스트는 PersonService 클래스의 GetPersonEmail 메서드가 예상 이메일 "Tom@email.com"을 가진 Person 객체의 이메일 주소를 올바르게 반환하는지 검증합니다. 테스트 데이터를 설정하고 메소드를 실행한 뒤 실제 결과가 예상 결과와 일치하는지 확인하기 위해 Arrange-Act-Assert 패턴을 사용합니다.

NBuilder와 IronPDF 통합

IronPDF 알아보기는 .NET 애플리케이션 내에서 HTML에서 PDF 생성을 위한 강력한 C# 라이브러리입니다. 직관적인 API 덕분에 개발자는 송장, 보고서 또는 인터랙티브 양식을 생성할 때 프로젝트에 PDF 기능을 원활하게 통합할 수 있습니다.

NBuilder .NET (개발자를 위한 작동 방식): 그림 7 - IronPDF

IronPDF 설치

NuGet 패키지 관리자 콘솔을 열고 다음 명령어를 실행하세요:

Install-Package IronPdf

5명의 Person 객체 리스트 채우기

// Generating instances of the Person class with NBuilder
var people = Builder<Person>.CreateListOfSize(5).Build();
// Generating instances of the Person class with NBuilder
var people = Builder<Person>.CreateListOfSize(5).Build();
' Generating instances of the Person class with NBuilder
Dim people = Builder(Of Person).CreateListOfSize(5).Build()
$vbLabelText   $csharpLabel

IronPDF를 사용하여 PDF 문서 생성

이 코드는 IronPDF 라이선스 키를 설정하고 Person 객체 목록에서 HTML 콘텐츠를 생성합니다.

// Setting the IronPDF license key
IronPdf.License.LicenseKey = "Your-License-Key";

// Building HTML content from Person object list
var htmlContent = "<h1>Person List</h1>";
foreach (var person in people)
{
    htmlContent += $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>";
}
// Setting the IronPDF license key
IronPdf.License.LicenseKey = "Your-License-Key";

// Building HTML content from Person object list
var htmlContent = "<h1>Person List</h1>";
foreach (var person in people)
{
    htmlContent += $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>";
}
' Setting the IronPDF license key
IronPdf.License.LicenseKey = "Your-License-Key"

' Building HTML content from Person object list
Dim htmlContent = "<h1>Person List</h1>"
For Each person In people
	htmlContent &= $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>"
Next person
$vbLabelText   $csharpLabel

IronPdf.License.LicenseKey는 IronPDF의 기능을 활성화하기 위해 특정 라이선스 키로 설정됩니다. HTML 콘텐츠는 people 목록에 대해 반복하면서 각 Person 객체의 세부사항(ID, Name, Email, IsMarried)을 HTML 구조에 추가하여 동적으로 구성됩니다.

IronPDF를 사용하여 PDF 문서로 Person 리스트 렌더링

이 코드는 IronPDF의 ChromePdfRenderer를 사용하여 HTML 콘텐츠를 PDF 문서로 변환합니다.

// Rendering HTML content into a PDF document using IronPDF
var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf(htmlContent);
pdfDoc.SaveAs("PersonList.pdf");
// Rendering HTML content into a PDF document using IronPDF
var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf(htmlContent);
pdfDoc.SaveAs("PersonList.pdf");
' Rendering HTML content into a PDF document using IronPDF
Dim renderer = New ChromePdfRenderer()
Dim pdfDoc = renderer.RenderHtmlAsPdf(htmlContent)
pdfDoc.SaveAs("PersonList.pdf")
$vbLabelText   $csharpLabel

ChromePdfRenderer는 htmlContent에 저장된 HTML 콘텐츠를 PDF 문서로 렌더링하기 위해 인스턴스화됩니다. 생성된 PDF 문서는 "PersonList.pdf"라는 이름으로 파일 시스템에 저장됩니다.

출력

아래는 IronPDF로 생성된 PersonList의 출력입니다. 기본값을 가진 다섯 명의 사람이 포함되어 있습니다.

NBuilder .NET (개발자를 위한 작동 방식): 그림 8 - PDF 출력

결론

결론적으로, NBuilder는 .NET에서 테스트 데이터를 생성하고 복잡한 객체 그래프를 만들며 테스트 프로세스의 효율성을 높이는 강력하고 유연한 도구입니다. IronPDF와 통합하여 개발자는 프로젝트에서 유용하다고 느끼는 사람들을 위해 PDF 생성 기능을 쉽게 확장할 수 있습니다. NBuilder와 IronPDF는 함께 개발 워크플로우를 크게 향상시켜, 테스트와 문서 생성을 원활하고 효율적으로 만듭니다.

자주 묻는 질문

NBuilder를 사용하여 .NET에서 테스트 데이터를 어떻게 생성할 수 있습니까?

NBuilder는 개발자가 복잡한 객체 그래프와 테스트 데이터를 손쉽게 생성할 수 있도록 하는 유창한 인터페이스를 제공합니다. CreateNew() 및 CreateListOfSize()와 같은 메서드를 사용하여 기본값 또는 사용자 정의 값을 가진 단일 객체나 객체 목록을 생성할 수 있습니다.

.NET 프로젝트에 NBuilder를 어떻게 설치하나요?

NBuilder를 설치하려면 NuGet 패키지 관리자 콘솔에서 Install-Package NBuilder 명령을 사용하면 됩니다. 이 명령은 NBuilder와 그에 필요한 종속성을 다운로드하여 설치합니다.

NBuilder를 사용하여 무작위 및 순차 데이터를 생성할 수 있습니까?

네, NBuilder는 무작위 및 순차 데이터 생성을 지원합니다. With() 메서드를 사용하여 무작위 값을 가진 객체 속성을 사용자 정의하거나 Do()를 사용하여 속성을 순차적으로 설정할 수 있습니다.

NBuilder를 IronPDF와 통합하는 이점은 무엇입니까?

NBuilder를 IronPDF와 통합하면 개발자가 복잡한 테스트 데이터를 만들고 이를 PDF로 출력할 수 있습니다. 이를 통해 테스트 데이터에서 동적 PDF 생성을 가능하게 하여 .NET 애플리케이션의 개발 워크플로우를 간소화할 수 있습니다.

NBuilder가 단위 테스트에서 어떻게 도움을 주나요?

NBuilder는 개발자가 현실적인 테스트 데이터를 신속하게 생성할 수 있도록 하여 단위 테스트에서 가치가 있습니다. 이를 통해 복잡한 객체 그래프가 있는 테스트 시나리오의 설정을 간소화하여 테스트를 더 유지 가능하고 효과적으로 만듭니다.

NBuilder에서 유창한 인터페이스를 사용하는 장점은 무엇입니까?

NBuilder의 유창한 인터페이스는 개발자가 읽기 쉽고 간결한 방식으로 복잡한 객체 그래프를 생성하기 위한 메서드 호출을 연쇄할 수 있도록 합니다. 이를 통해 테스트 데이터를 생성할 때 코드 명확성이 향상되고 보일러 플레이트 코드가 줄어듭니다.

NBuilder로 객체 목록을 어떻게 생성할 수 있나요?

NBuilder의 CreateListOfSize() 메소드를 사용하여 객체 목록을 생성할 수 있습니다. 예를 들어, Builder.CreateListOfSize(10).Build()는 10개의 Person 객체 목록을 생성합니다.

NBuilder 사용을 위한 몇 가지 문제 해결 팁은 무엇인가요?

NBuilder가 NuGet을 통해 올바르게 설치되었는지 확인하고 프로젝트 참조가 최신인지 검토하십시오. 문제가 발생하면, NBuilder GitHub 저장소나 커뮤니티 포럼을 확인하여 유용한 인사이트와 해결책을 찾을 수 있습니다.

제이콥 멜러, 팀 아이언 최고기술책임자
제이콥 멜러
  지금 바로 엔지니어링 팀과 채팅하세요
최고기술책임자

제이콥 멜러는 Iron Software의 최고 기술 책임자(CTO)이자 C# PDF 기술을 개척한 선구적인 엔지니어입니다. Iron Software의 핵심 코드베이스를 최초로 개발한 그는 창립 초기부터 회사의 제품 아키텍처를 설계해 왔으며, CEO인 캐머런 리밍턴과 함께 회사를 NASA, 테슬라, 그리고 전 세계 정부 기관에 서비스를 제공하는 50명 이상의 직원을 보유한 기업으로 성장시켰습니다.

제이콥은 맨체스터 대학교에서 토목공학 학사 학위(BEng)를 최우등으로 취득했습니다(1998~2001). 1999년 런던에서 첫 소프트웨어 회사를 설립하고 2005년 첫 .NET 컴포넌트를 개발한 후, 마이크로소프트 생태계 전반에 걸쳐 복잡한 문제를 해결하는 데 전문성을 발휘해 왔습니다.

그의 대표 제품인 IronPDF 및 Iron Suite .NET 라이브러리는 전 세계적으로 3천만 건 이상의 NuGet 설치 수를 기록했으며, 그의 핵심 코드는 전 세계 개발자들이 사용하는 다양한 도구에 지속적으로 활용되고 있습니다. 25년의 실무 경험과 41년의 코딩 전문성을 바탕으로, 제이콥은 차세대 기술 리더들을 양성하는 동시에 기업 수준의 C#, Java, Python PDF 기술 혁신을 주도하는 데 주력하고 있습니다.

관련 기사

30일 무료 체험 → 모든 기능 이용 가능. 제한 없음. 카드 정보 필요 없음. 무료 체험 시작하기

아이언 서포트 팀

저희는 주 5일, 24시간 온라인으로 운영합니다.
채팅
이메일
전화해