NBuilder to biblioteka .NET upraszczająca generowanie danych testowych. Dzięki płynnemu interfejsowi programiści mogą bez wysiłku tworzyć złożone grafy obiektów. Zapewnia elastyczność, wydajność i płynną integrację z popularnymi frameworkami testowymi. W tym artykułe omówimy funkcje NBuilder, sposób jego instalacji oraz zademonstrujemy jego możliwości na praktycznych przykładach kodu.
Aby zainstalować NBuilder w konsoli menedżera pakietów NuGet, użyj następującego polecenia.
Powyższe polecenie zainstaluje NBuilder wraz ze wszystkimi jego zależnościami.
NBuilder zapewnia płynny sposób tworzenia obiektów w locie. Zacznijmy od prostego przykładu tworzenia obiektu.
Oto kod źródłowy klasy Person Model.
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// 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
Oto przykład wykorzystania NBuilder do utworzenia i skonfigurowania obiektu Person z niestandardowymi właściwościami:
// 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()Powyższy kod tworzy nowy obiekt Person z niestandardowymi właściwościami. Inicjuje obiekt customPersonBuilder dla obiektu Person, ustawiając imię na "Tom", a adres e-mail na "Tom@email.com". Na koniec tworzy obiekt i przypisuje go do objTom.
// 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()
W tym przypadku personList zawiera 10 obiektów z wartościami domyślnymi i PRINTuje je.
// 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
Czasami może zaistnieć potrzeba dostosowania tworzonych obiektów. Mozna rowniez dostosowac wartosc obiektu, uzywajac metody 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
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()To tworzy personList, w ktorym kazdy obiekt ma nadpisana wartosc domyslna na Name = "Kim", Email = "abc@email.com" i IsMarried = false.
Aby uzyskać realistyczne wartości danych w liście osób, można użyć biblioteki Faker Library .NET do generowania realistycznych danych.
// 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()Przykład 6: Tworzenie listy obiektów typu Person z danymi sekwencyjnymi
Czasami może zaistnieć potrzeba generowania obiektów zawierających dane sekwencyjne. NBuilder .NET ułatwia to dzięki metodzie 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
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()Tutaj metoda All() zapewnia, ze kolejne operacje beda stosowane do wszystkich 10 obiektow osoby utworzonych w pamieci. Metoda Do() wykonuje delegata Action na kazdym obiekcie Person. Ten konfiguracja przypisuje wlasciwosc Id sekwencyjnie, zaczynajac od 501, i podobnie nazywa kazda osobe sekwencyjnie jako "Person 1" do "Person 10".
Przykład 7: NBuilder z testowaniem jednostkowym przy użyciu Xunit
NBuilder w środowisku .NET jest szeroko stosowany w środowiskach testowych, gdzie programiści muszą generować realistyczny i zróżnicowany zestaw danych do testów. Ułatwia to testowanie i konserwację złożonych obiektów, które pozwalają programistom definiować niestandardową logikę inicjalizacji przy użyciu wyrażeń lambda i funkcji delegujących, co jest przydatne dla osób zainteresowanych wydajnym i elastycznym generowaniem danych testowych.
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 ClassTutaj klasa Person ma kilka wlasciwosci, takich jak Id, Name, Email, i IsMarried, podczas gdy PersonService zawiera metode GetPersonEmail(), ktora zwraca email danego Person.
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(Function(p) p.Name = "Tom") _
.With(Function(p) p.Email = "Tom@email.com") _
.Build()
' Act
Dim actualEmail = service.GetPersonEmail(person)
' Assert
Assert.Equal(expectedEmail, actualEmail)
End Sub
End ClassTen test jednostkowy weryfikuje, ze metoda GetPersonEmail klasy PersonService poprawnie zwraca adres email obiektu Person z oczekiwanym emailem "Tom@email.com". Wykorzystuje wzorzec Arrange-Act-Assert do skonfigurowania danych testowych, wykonania metody, a następnie sprawdzenia, czy rzeczywisty wynik jest zgodny z oczekiwanym.
Dowiedz się więcej o IronPDF – potężnej bibliotece C# przeznaczonej do tworzenia plików PDF z HTML w aplikacjach .NET. Dzięki intuicyjnemu interfejsowi API programiści mogą płynnie zintegrować funkcje PDF ze swoimi projektami, niezależnie od tego, czy generują faktury, raporty czy interaktywne formularze.
Otwórz konsolę NuGet Package Manager i uruchom następujące polecenie:
// 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()Ten kod ustawia klucz licencyjny IronPDF i generuje zawartość HTML na podstawie listy obiektów Person.
// 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 personUstawiono IronPdf.License.LicenseKey z okreslonym kluczem licencyjnym, aby aktywowac funkcje IronPDF. Zawartosc HTML jest dynamicznie konstruowana poprzez iteracje nad lista people, dodajac szczegoly kazdego obiektu Person (Id, Name, Email, IsMarried) do struktury HTML.
Ten kod konwertuje zawartość HTML na dokument PDF przy użyciu biblioteki ChromePdfRenderer firmy IronPDF.
// 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")ChromePdfRenderer jest tworzony, aby renderowac zawartosc HTML przechowywana w htmlContent na dokument PDF. Powstały dokument PDF jest zapisywany w systemie plików pod nazwą "PersonList.pdf".
Poniżej znajduje się wynik działania funkcji PersonList wygenerowany przez IronPDF. Zawiera pięć osób, z których każda ma wartości domyślne.
Podsumowując, NBuilder to solidne i elastyczne narzędzie do generowania danych testowych w środowisku .NET, usprawniające tworzenie złożonych grafów obiektów i zwiększające wydajność procesów testowania. Dzięki integracji z IronPDF programiści mogą w łatwy sposób rozszerzyć swoje aplikacje o funkcje generowania plików PDF dla tych, którzy uznają to za przydatne w swoich projektach. W połączeniu NBuilder i IronPDF mogą znacznie usprawnić procesy programistyczne, sprawiając, że testowanie i generowanie dokumentów przebiega płynnie i wydajnie.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
