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 açın, "Dosya" > "Yeni" > "Proje..." gidin.
2. Bir proje şablonu seçin, ayarları yapılandırın ve "Oluştur" üzerine tıklayın.

Diyelim ki bir ATM (Otomatik Vezne Makinası) 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 iki arayüz oluşturun, IHostBank ve IHSMModule. 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 Test Projesi Oluşturun

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

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

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ının üzerine sağ tıklayın.
2. Ekle > Yeni Proje: Bağlam menüsünden "Ekle" ve ardından "Yeni Proje..." yi seçin.
3. Yeni Bir Proje Oluşturun: "Yeni Proje Ekle" iletişim kutusunda, mevcut NUnit şablonlarını bulmak için "NUnit" arayabilirsiniz. Aşağıda gösterildiği gibi NUnit Test Projesi'ni seçin.

4. Projeyi Yapılandırın: Proje adını ve yerini de dahil olmak üzere ihtiyaç duyduğunuz şekilde proje ayarlarını 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 projeniz var ve bu projede birim testlerinizi yazabilir ve yönetebilirsiniz. Test etmek istediğiniz projelere referanslar ekleyebilir ve bu proje içinde NUnit test davalarınızı yazmaya başlayabilirsiniz.

Test projesinde MOQ'u kullanmaya başlamak için, çözümünüze MOQ NuGet paketini eklemeniz gerekecek. 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 tüm gerekli bağımlılıkları ekleyecektir.

NUnit ve MOQ kullanarak ATMCashWithdrawal sınıfının bağımlılıklarını (IHostBank ve IHSMModule) taklit etmek için 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, MOQ kullanarak IHSMModule ve IHostBank için maket nesneler oluşturuyoruz ve test sırasında çağrıldıklarında nasıl davranacaklarını belirtiyoruz.

Yukarıdaki kod örneğinde, C#'ta MOQ kullanarak nesneleri sahtelemenin kavramını gösterdik. Birim testi sırasında davranışlarını simüle ederek IHSMModule ve IHostBank arayüzleri için maket nesneler oluşturuyoruz. Bu, maket nesnelerin tepkilerini kontrol ederek ATMCashWithdrawal sınıfını izole ve kapsamlı bir şekilde test etmemizi sağlar. Mocking (taklit) ile, kodumuzun bu bağımlılıklarla doğru bir şekilde etkileşimde bulunduğunu ve testlerimizin odaklanmış, tahmin edilebilir ve belirli kod birimi içinde ortaya çıkabilecek sorunları etkili bir şekilde tespit ettiğini sağlayabiliriz. Bu uygulama, genel güvenilirliği, sürdürülebilirliği ve test kodu kalitesini artırır.

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

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

Bu şekilde, test etmek istediğimiz kodu izole edebilir ve bağımlılıkları etkin bir şekilde sahteleyerek çeşitli senaryolar altında beklendiği gibi davrandığını garanti edebiliriz. Bu uygulama, yazılımınızın güvenilirliğini ve sürdürülebilirliğini artırır, geliştirme sürecinin erken aşamalarında sorunları tespit etmeyi ve düzeltmeyi kolaylaştırır.

PDF'ler Oluşturmak için Sahte Nesneler Oluşturma

Diyelim ki finansal raporlar üreten bir uygulama geliştiriyorsunuz ve bu raporlar PDF belgeleri olarak kaydedilmeli ve dağıtılmalıdır. Bu senaryoda, PDF oluşturmayı test etmek ve içerik ve formatlamanın doğru olduğundan emin olmak isteyebilirsiniz.

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

Install-Package IronPdf

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

IronPDF'nin birim test sürecine nasıl entegre edilebileceğini göreceksiniz:

Sahte PDF'ler Oluşturma

IronPDF'yi kullanarak, gerçek finansal raporları taklit etmek için belirli içerik ve stil ile sahte PDF belgeleri oluşturabilirsiniz. Bu sahte PDF'ler, aşağıdaki kod kesitinde gösterildiği gibi birim testleriniz için test sabitleri olarak hizmet edebilir:

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

Sahte PDF'lerle Birim Testi

IronPDF kullanarak çeşitli rapor senaryolarını temsil eden sahte PDF'ler oluşturmak için testler yazacağız. Ardından, kodumuz tarafından üretilen gerçek PDF'leri bu sahte PDF'lerle karşılaştırarak içerik, format ve yapının beklendiği gibi olup olmadığını kontrol 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 maket bir PDF (expectedPdf) oluşturup, PDFGenerator tarafından üretilen PDF (actualPdf) ile karşılaştırıyoruz. Her iki PDF'nin de aynı içeriğe sahip olup olmadığını doğrulamak için içeriğini çıkardık.