Moq C# (Geliştiriciler İçin Nasıl Çalışır)

Yeni Bir C# Projesi Oluşturun

Yeni bir proje oluşturmak için aşağıdaki adımları izleyin:

1. Visual Studio'yu açın, "Dosya" > "Yeni" > "Proje..." yolunu izleyin.
2. Bir proje şablonu seçin, ayarları yapılandırın ve "Oluştur" düğmesine tıklayın.

Diyelim ki bir ATM (Otomatik Vezne Makinesi) için yazılım geliştiriyorsunuz ve kimlik doğrulama ve para çekme işlevselliğini test etmeniz gerekiyor. ATM iki arayüze bağlıdır: IHostBank ve IHSMModule. ATM'nin nakit çekme işlevselliğini temsil eden ATMCashWithdrawal sınıfını test etmek istiyoruz.

ATM sisteminin bağımlılıklarını temsil eden IHostBank ve IHSMModule olmak üzere iki arayüz oluşturun. AuthenticateAmount ve ValidatePIN gibi ilgili yöntemleri tanımlayın.

// IHostBank.cs
public interface IHostBank
{
    bool AuthenticateAmount(string accountNumber, int amount);
}

// IHSMModule.cs
public interface IHSMModule
{
    bool ValidatePIN(string cardNumber, int pin);
}

// IHostBank.cs
public interface IHostBank
{
    bool AuthenticateAmount(string accountNumber, int amount);
}

// IHSMModule.cs
public interface IHSMModule
{
    bool ValidatePIN(string cardNumber, int pin);
}

' IHostBank.cs
Public Interface IHostBank
	Function AuthenticateAmount(ByVal accountNumber As String, ByVal amount As Integer) As Boolean
End Interface

' IHSMModule.cs
Public Interface IHSMModule
	Function ValidatePIN(ByVal cardNumber As String, ByVal pin As Integer) As Boolean
End Interface

ATM işlemlerini gerçekleştirmek için yukarıda belirtilen bağımlılıkları kullanan ATMCashWithdrawal sınıfını oluşturun. Bu sınıfta WithdrawAmount gibi belirli bir yöntemi uygulayacaksınız.

// ATMCashWithdrawal.cs
public class ATMCashWithdrawal
{
    private readonly IHSMModule hsmModule;
    private readonly IHostBank hostBank;

    public ATMCashWithdrawal(IHSMModule hsmModule, IHostBank hostBank)
    {
        this.hsmModule = hsmModule;
        this.hostBank = hostBank;
    }

    // Withdraw amount after validating PIN and balance
    public bool WithdrawAmount(string cardNumber, int pin, int amount)
    {
        if (!hsmModule.ValidatePIN(cardNumber, pin))
        {
            return false;
        }

        if (!hostBank.AuthenticateAmount(cardNumber, amount))
        {
            return false;
        }

        // Withdraw the specified amount and perform other operations
        return true;
    }
}

// ATMCashWithdrawal.cs
public class ATMCashWithdrawal
{
    private readonly IHSMModule hsmModule;
    private readonly IHostBank hostBank;

    public ATMCashWithdrawal(IHSMModule hsmModule, IHostBank hostBank)
    {
        this.hsmModule = hsmModule;
        this.hostBank = hostBank;
    }

    // Withdraw amount after validating PIN and balance
    public bool WithdrawAmount(string cardNumber, int pin, int amount)
    {
        if (!hsmModule.ValidatePIN(cardNumber, pin))
        {
            return false;
        }

        if (!hostBank.AuthenticateAmount(cardNumber, amount))
        {
            return false;
        }

        // Withdraw the specified amount and perform other operations
        return true;
    }
}

' ATMCashWithdrawal.cs
Public Class ATMCashWithdrawal
	Private ReadOnly hsmModule As IHSMModule
	Private ReadOnly hostBank As IHostBank

	Public Sub New(ByVal hsmModule As IHSMModule, ByVal hostBank As IHostBank)
		Me.hsmModule = hsmModule
		Me.hostBank = hostBank
	End Sub

	' Withdraw amount after validating PIN and balance
	Public Function WithdrawAmount(ByVal cardNumber As String, ByVal pin As Integer, ByVal amount As Integer) As Boolean
		If Not hsmModule.ValidatePIN(cardNumber, pin) Then
			Return False
		End If

		If Not hostBank.AuthenticateAmount(cardNumber, amount) Then
			Return False
		End If

		' Withdraw the specified amount and perform other operations
		Return True
	End Function
End Class

Bir Birim Testi Projesi Oluşturun

Şimdi, bağımlılıkları taklit etmek için MOQ kullanarak ATMCashWithdrawal sınıfı için birim testleri oluşturalım.

Çözümünüzde yeni bir Birim Test Projesi oluşturun ve adını ATMSystem.Tests koyun.

Visual Studio çözümünüze bir NUnit test projesi eklemek için şu adımları izleyin:

1. Çözüme sağ tıklayın: Çözüm Gezgini'nde (genellikle sağ tarafta), çözüm adına sağ tıklayın.
2. Ekle > Yeni Proje: Bağlam menüsünden 'Ekle' seçeneğini ve ardından 'Yeni Proje...' seçeneğini seçin.
3. Yeni Bir Proje Oluşturun: 'Yeni Proje Ekle' diyalog kutusunda, mevcut NUnit şablonlarını bulmak için 'NUnit' araması yapabilirsiniz. Aşağıda gösterildiği gibi NUnit Test Projesi'ni seçin.

4. Projeyi Yapılandırın: Proje adını ve konumunu içeren proje ayarlarını gerektiği gibi yapılandırın.
5. Tamam'a Tıklayın: NUnit test projesini çözümünüze eklemek için 'Oluştur' veya 'Tamam' düğmesine tıklayın.

Artık çözümünüz içinde bir NUnit test projesi var, burada birim testlerinizi yazabilir ve yönetebilirsiniz. Projelerinizin referanslarını test etmek istediğiniz projelere ekleyebilir ve bu projede NUnit test vakalarınızı yazmaya başlayabilirsiniz.

Test projesinde MOQ kullanmaya başlamak için çözümünüze MOQ NuGet paketini eklemeniz gerekecek. Bunu Visual Studio'daki NuGet Paket Yöneticisi'ni kullanarak veya Paket Yöneticisi Konsolu'nda aşağıdaki komutu çalıştırarak yapabilirsiniz:

Install-Package Moq

Bu komut, paketi yükleyecek ve projeye gerekli tüm bağımlılıkları ekleyecektir.

NUnit ve MOQ kullanarak, ATMCashWithdrawal sınıfının bağımlılıklarını (IHostBank ve IHSMModule) taklit eden birim testleri yazın.

using Moq;
using NUnit.Framework;

namespace ATMSystem.Tests
{
    public class ATMTests
    {
        private ATMCashWithdrawal atmCash;

        [SetUp]
        public void Setup()
        {
            // Arrange - Setup mock objects
            var hsmModuleMock = new Mock<IHSMModule>();
            hsmModuleMock.Setup(h => h.ValidatePIN("123456781234", 1234)).Returns(true);

            var hostBankMock = new Mock<IHostBank>();
            hostBankMock.Setup(h => h.AuthenticateAmount("123456781234", 500)).Returns(true);

            atmCash = new ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object);
        }

        [Test]
        public void WithdrawAmount_ValidTransaction_ReturnsTrue()
        {
            // Act - Execute the method under test
            bool result = atmCash.WithdrawAmount("123456781234", 1234, 500);

            // Assert - Verify the result
            Assert.IsTrue(result);
        }

        // More test cases for different scenarios (e.g., invalid PIN, insufficient funds)
    }
}

using Moq;
using NUnit.Framework;

namespace ATMSystem.Tests
{
    public class ATMTests
    {
        private ATMCashWithdrawal atmCash;

        [SetUp]
        public void Setup()
        {
            // Arrange - Setup mock objects
            var hsmModuleMock = new Mock<IHSMModule>();
            hsmModuleMock.Setup(h => h.ValidatePIN("123456781234", 1234)).Returns(true);

            var hostBankMock = new Mock<IHostBank>();
            hostBankMock.Setup(h => h.AuthenticateAmount("123456781234", 500)).Returns(true);

            atmCash = new ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object);
        }

        [Test]
        public void WithdrawAmount_ValidTransaction_ReturnsTrue()
        {
            // Act - Execute the method under test
            bool result = atmCash.WithdrawAmount("123456781234", 1234, 500);

            // Assert - Verify the result
            Assert.IsTrue(result);
        }

        // More test cases for different scenarios (e.g., invalid PIN, insufficient funds)
    }
}

Imports Moq
Imports NUnit.Framework

Namespace ATMSystem.Tests
	Public Class ATMTests
		Private atmCash As ATMCashWithdrawal

		<SetUp>
		Public Sub Setup()
			' Arrange - Setup mock objects
			Dim hsmModuleMock = New Mock(Of IHSMModule)()
			hsmModuleMock.Setup(Function(h) h.ValidatePIN("123456781234", 1234)).Returns(True)

			Dim hostBankMock = New Mock(Of IHostBank)()
			hostBankMock.Setup(Function(h) h.AuthenticateAmount("123456781234", 500)).Returns(True)

			atmCash = New ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object)
		End Sub

		<Test>
		Public Sub WithdrawAmount_ValidTransaction_ReturnsTrue()
			' Act - Execute the method under test
			Dim result As Boolean = atmCash.WithdrawAmount("123456781234", 1234, 500)

			' Assert - Verify the result
			Assert.IsTrue(result)
		End Sub

		' More test cases for different scenarios (e.g., invalid PIN, insufficient funds)
	End Class
End Namespace

Bu test kodunda, test sırasında çağrıldıklarında davranışlarını belirlemek için IHSMModule ve IHostBank için taklit nesneler oluşturmak üzere MOQ kullanıyoruz.

Yukarıdaki kod örneğinde, C# içinde MOQ kullanarak nesneleri taklit etme kavramını gösterdik. IHSMModule ve IHostBank arayüzleri için taklit nesneler oluşturarak, birim testleri sırasında davranışlarını simüle ederiz. Bu, bu taklit nesnelerin yanıtlarını kontrol ederek ATMCashWithdrawal sınıfını izole edip kapsamlı bir şekilde test etmemizi sağlar. Yapay nesneler kullanarak, kodumuzun bu bağımlılıklarla doğru şekilde etkileşime girdiğinden emin olabiliriz, böylece testlerimiz odaklı, öngörülebilir ve incelenen kod birimindeki sorunları tanımlamada etkili hale gelir. Bu uygulama, genel güvenilirliği, sürdürülebilirliği ve test kodu kalitesini artırır.

Adım 3 Testleri Çalıştırma

1. Her şeyin güncel olduğundan emin olmak için çözümünüzü oluşturun.
2. Visual Studio'da Test Gezgini'ni açın (Test > Test Gezgini).
3. Test Gezgini'ndeki 'Tümünü Çalıştır' düğmesine tıklayarak birim testlerinizi çalıştırın.
4. Test sonuçlarını gözden geçirin. Yazdığınız testi (WithdrawAmount_ValidTransaction_ReturnsTrue) geçtiğini görmelisiniz.

Bu şekilde, test etmek istediğimiz kod parçalarını izole edebilir ve bağımlılıkları etkili bir şekilde taklit ederek çeşitli senaryolar altında doğru davrandığını garanti edebiliriz. Bu uygulama, yazılımınızın güvenilirliğini ve sürdürülebilirliğini arttırarak, geliştirme sürecinin erken aşamalarında sorunları tanımlamayı ve düzeltmeyi kolaylaştırır.

PDF Üretimi için Yapay Nesneler Oluşturma

Diyelim ki mali raporlar üreten bir uygulama geliştiriyorsunuz ve bu raporların PDF belgeleri olarak kaydedilmesi ve dağıtılması gerekiyor. Bu senaryoda, PDF üretimini test etmek ve içeriğin ve formatın doğru olduğundan emin olmak isteyebilirsiniz.

Öncelikle, projemize IronPDF eklememiz gerekiyor. NuGet Paket Yöneticisi Konsolu'nda IronPDF yüklemek için aşağıdaki komutu yazın.

Install-Package IronPdf

Bu komut, projemize gerekli bağımlılıkları yükleyecek ve ekleyecektir.

IronPDF'in birim testi sürecine nasıl entegre edilebileceği aşağıda açıklanmaktadır:

Yapay PDF'ler Oluşturma

IronPDF'i kullanarak gerçek mali raporları taklit eden belirli içerik ve stilde yapay PDF belgeleri oluşturabilirsiniz. Bu yapay PDF'ler, birim testleriniz için test senaryoları olarak hizmet edebilir, aşağıdaki kod parçasında gösterildiği gibi:

public class PDFGenerator
{
    public void GenerateFinancialReport(string reportData)
    {
        var renderer = new ChromePdfRenderer();

        // Generate the report HTML
        string reportHtml = GenerateReportHtml(reportData);
        PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(reportHtml);

        // Save the PDF to a file or memory stream
        pdfDocument.SaveAs("FinancialReport.pdf");
    }

    private string GenerateReportHtml(string reportData)
    {
        // Generate the report HTML based on the provided data
        // (e.g., using Razor views or any HTML templating mechanism)
        // Return the HTML as a string
        return "<h1>my Report</h1>";
    }
}

public class PDFGenerator
{
    public void GenerateFinancialReport(string reportData)
    {
        var renderer = new ChromePdfRenderer();

        // Generate the report HTML
        string reportHtml = GenerateReportHtml(reportData);
        PdfDocument pdfDocument = renderer.RenderHtmlAsPdf(reportHtml);

        // Save the PDF to a file or memory stream
        pdfDocument.SaveAs("FinancialReport.pdf");
    }

    private string GenerateReportHtml(string reportData)
    {
        // Generate the report HTML based on the provided data
        // (e.g., using Razor views or any HTML templating mechanism)
        // Return the HTML as a string
        return "<h1>my Report</h1>";
    }
}

Public Class PDFGenerator
	Public Sub GenerateFinancialReport(ByVal reportData As String)
		Dim renderer = New ChromePdfRenderer()

		' Generate the report HTML
		Dim reportHtml As String = GenerateReportHtml(reportData)
		Dim pdfDocument As PdfDocument = renderer.RenderHtmlAsPdf(reportHtml)

		' Save the PDF to a file or memory stream
		pdfDocument.SaveAs("FinancialReport.pdf")
	End Sub

	Private Function GenerateReportHtml(ByVal reportData As String) As String
		' Generate the report HTML based on the provided data
		' (e.g., using Razor views or any HTML templating mechanism)
		' Return the HTML as a string
		Return "<h1>my Report</h1>"
	End Function
End Class

Yapay PDF'lerle Birim Testi

IronPDF'i kullanarak çeşitli rapor senaryolarını temsil eden yapay PDF'ler oluşturmak için testler yazacağız. Daha sonra, kodumuz tarafından oluşturulan gerçek PDF'leri bu yapay PDF'ler ile karşılaştırarak içeriğin, formatlanmanın ve yapının beklendiği gibi olduğunu garanti edeceğiz.

using IronPdf;
using NUnit.Framework;

internal class PDFGeneratorTests
{
    [Test]
    public void GenerateFinancialReport_CreatesCorrectPDF()
    {
        // Arrange
        var pdfGenerator = new PDFGenerator();
        var expectedPdf = PdfDocument.FromFile("ExpectedFinancialReport.pdf"); // Load a mock PDF

        // Act
        pdfGenerator.GenerateFinancialReport("Sample report data");
        var actualPdf = PdfDocument.FromFile("FinancialReport.pdf");

        // Assert
        Assert.AreEqual(actualPdf.ExtractAllText(), expectedPdf.ExtractAllText());
    }
}

using IronPdf;
using NUnit.Framework;

internal class PDFGeneratorTests
{
    [Test]
    public void GenerateFinancialReport_CreatesCorrectPDF()
    {
        // Arrange
        var pdfGenerator = new PDFGenerator();
        var expectedPdf = PdfDocument.FromFile("ExpectedFinancialReport.pdf"); // Load a mock PDF

        // Act
        pdfGenerator.GenerateFinancialReport("Sample report data");
        var actualPdf = PdfDocument.FromFile("FinancialReport.pdf");

        // Assert
        Assert.AreEqual(actualPdf.ExtractAllText(), expectedPdf.ExtractAllText());
    }
}

Imports IronPdf
Imports NUnit.Framework

Friend Class PDFGeneratorTests
	<Test>
	Public Sub GenerateFinancialReport_CreatesCorrectPDF()
		' Arrange
		Dim pdfGenerator As New PDFGenerator()
		Dim expectedPdf = PdfDocument.FromFile("ExpectedFinancialReport.pdf") ' Load a mock PDF

		' Act
		pdfGenerator.GenerateFinancialReport("Sample report data")
		Dim actualPdf = PdfDocument.FromFile("FinancialReport.pdf")

		' Assert
		Assert.AreEqual(actualPdf.ExtractAllText(), expectedPdf.ExtractAllText())
	End Sub
End Class

Bu test kodunda, beklenen çıktıyı temsil eden taklit bir PDF (expectedPdf) üretiyoruz ve bunu PDFGenerator tarafından üretilen PDF (actualPdf) ile karşılaştırıyoruz. Her iki PDF'nin içeriğini de aynı içeriğe sahip olup olmadıklarını doğrulamak için çıkardık.