.NET 帮助

Moq C#(适用于开发者的工作原理)

发布 2023年十月29日
分享:

在软件开发领域,测试是一个不可或缺的过程。它能确保代码按预期运行,并有助于在生产之前捕捉错误。测试的一个重要方面就是模拟,而在 C# 测试中,MOQ 是开发人员的一个强大工具。它支持 lambda 表达式。MOQ 是 "Mock Object Framework for .NET"(.NET 模拟对象框架)的简称,它简化了为单元测试创建模拟对象的过程。本文将深入介绍 C&num 中的 MOQ;

什么是 MOQ?

订购数量 是.NET 应用程序的模拟框架,允许开发人员快速高效地创建模拟对象。模拟对象是模拟应用程序中真实对象行为的对象,可以更轻松地隔离和测试代码的特定部分。MOQ 简化了创建和使用这些模拟对象的过程。

MOQ 的主要特点

  • 流畅的接口: MOQ 为设置期望值和验证提供了一个流畅而富有表现力的应用程序接口。这使您的测试代码更具可读性,更易于理解。
  • 强类型: MOQ 利用 C# 语言特性,在定义模拟和预期时提供强类型和智能提示支持。这降低了测试中出现运行时错误的几率。
  • 松散模拟: MOQ 支持严格模拟和松散模拟。松散模拟允许您创建响应任何方法调用的模拟对象,而严格模拟则强制要求只调用预期方法。
  • 可验证行为: MOQ 允许您验证模拟对象上的特定方法是否以预期的参数和正确的顺序被调用。

  • 回调和返回值: 你可以定义回调,以便在调用模拟方法时执行自定义代码,并为模拟方法指定返回值。

MOQ 入门

在本教程中,我们将探讨如何使用 MOQ(一种流行的 C# 模拟框架)来促进单元测试。我们将通过一个示例,使用 MOQ 模拟依赖关系,创建并测试一个简单的 ATM 交易场景。

创建一个新的 C#

按照以下步骤创建新项目

1.开放 Visual Studio,转到 "文件">"新建">"项目..."

2.选择项目模板,配置设置,然后点击 "创建"。

图 1 - 在 Visual Studio 2022 中创建新的控制台应用程序

假设您正在为自动取款机开发软件 (自动柜员机),您需要测试身份验证和取款功能。ATM 依赖于两个接口:IHostBankIHSMModule。我们要测试 ATMCashWithdrawal类,它代表 ATM 的取款功能。

创建两个接口 IHostBankIHSMModule,它们代表 ATM 系统的依赖关系。定义相关方法,如authenticateAmountvalidatePIN

// 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
VB   C#

创建 ATMCashWithdrawal 类,该类使用上述依赖关系来执行 ATM 操作。在该类中,您将实现某个方法,如 WithdrawAmount

// 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;
    }
// non static method
    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;
    }
// non static method
    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
' non static method
	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
VB   C#

创建单元测试项目

现在,让我们使用 MOQ 模拟依赖关系,为 ATMCashWithdrawal 类创建单元测试。

在解决方案中创建一个新的单元测试项目,并将其命名为 ATMSystem.Tests

要在 Visual Studio 解决方案中添加 NUnit 测试项目,请按以下步骤操作:

  1. 右键单击解决方案: 在解决方案资源管理器中 (通常在右边),右键单击解决方案名称。

  2. 添加 > 新项目: 从右键菜单中选择 "添加",然后选择 "新项目..."

  3. 创建新项目: 在 "添加新项目 "对话框中,可以搜索 "NUnit",找到可用的 NUnit 模板。选择 NUnit 测试项目,如下图所示。

    Moq C#(如何为开发人员工作) 图 2 - 在解决方案中添加一个新的 NUnit 测试项目。

  4. 配置项目: 根据需要配置项目设置,包括项目名称和位置。

  5. 点击确定: 点击 "创建 "或 "确定 "按钮,将 NUnit 测试项目添加到解决方案中。

现在,您的解决方案中有了一个独立的 NUnit 测试项目,您可以在其中编写和管理单元测试。您还可以为要测试的项目添加引用,并开始在该项目中编写 NUnit 测试用例。

要开始在测试项目中使用 MOQ,您需要将 MOQ NuGet 包添加到解决方案中。您可以使用 Visual Studio 中的 NuGet 包管理器或在包管理器控制台中运行以下命令来完成此操作:

Install-package moq

该命令将安装软件包,并在项目中添加所有必需的依赖项。

使用 NUnit 和 MOQ 编写单元测试以模拟依赖项 (主机银行 "和 "IHSMModule) 类中的 "ATMCashWithdrawal"。

using Moq;
using MOQTestProject;

namespace UnitTest
{
    public class Tests
    {
        ATMCashWithdrawal atmCash;
        [SetUp]
        public void Setup()
        {
            // Arrange
            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);
            var atmCash = new ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object); // Object property
        }

        [Test]
        public void WithdrawAmount_ValidTransaction_ReturnsTrue()
        {
            // Act
            bool result = atmCash.WithdrawAmount("123456781234", 1234, 500);

            // Assert
            Assert.IsTrue(result); // Verify method 
        }

        // Add more test cases for different scenarios (e.g., invalid PIN, insufficient funds, etc.)
    }
}
using Moq;
using MOQTestProject;

namespace UnitTest
{
    public class Tests
    {
        ATMCashWithdrawal atmCash;
        [SetUp]
        public void Setup()
        {
            // Arrange
            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);
            var atmCash = new ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object); // Object property
        }

        [Test]
        public void WithdrawAmount_ValidTransaction_ReturnsTrue()
        {
            // Act
            bool result = atmCash.WithdrawAmount("123456781234", 1234, 500);

            // Assert
            Assert.IsTrue(result); // Verify method 
        }

        // Add more test cases for different scenarios (e.g., invalid PIN, insufficient funds, etc.)
    }
}
Imports Moq
Imports MOQTestProject

Namespace UnitTest
	Public Class Tests
		Private atmCash As ATMCashWithdrawal
		<SetUp>
		Public Sub Setup()
			' Arrange
			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)
			Dim atmCash = New ATMCashWithdrawal(hsmModuleMock.Object, hostBankMock.Object) ' Object property
		End Sub

		<Test>
		Public Sub WithdrawAmount_ValidTransaction_ReturnsTrue()
			' Act
			Dim result As Boolean = atmCash.WithdrawAmount("123456781234", 1234, 500)

			' Assert
			Assert.IsTrue(result) ' Verify method
		End Sub

		' Add more test cases for different scenarios (e.g., invalid PIN, insufficient funds, etc.)
	End Class
End Namespace
VB   C#

在这段测试代码中,我们使用 MOQ 为 IHSMModuleIHostBank 创建 mock 对象,并指定它们在测试过程中被调用时的行为。

在上述代码示例中,我们演示了在 C# 中使用 MOQ 模拟对象的概念。我们为 IHSMModuleIHostBank 接口创建了模拟对象,在单元测试中模拟它们的行为。这样,我们就可以通过控制这些模拟对象的响应来隔离并彻底测试ATMCashWithdrawal类。通过模拟,我们可以确保代码与这些依赖关系正确交互,从而使我们的测试具有针对性和可预测性,并能有效地发现所测试的特定代码单元中存在的问题。这种做法提高了代码的整体可靠性和可维护性,并使测试代码变得更容易。

步骤 3 运行测试

1.构建解决方案,确保所有内容都是最新的。

2.在 Visual Studio 中打开测试资源管理器 (测试 > 测试资源管理器).

3.点击测试资源管理器中的 "全部运行 "按钮,执行单元测试。

4.查看测试结果。您应该能看到您编写的测试 (WithdrawAmount_ValidTransaction_ReturnsTrue) 通过。

图 3 - 要运行测试,首先要构建解决方案。构建成功后,打开 Visual Studio 中的 Test Explorer(测试资源管理器),点击 Run All(全部运行)按钮,开始执行单元测试。

通过这种方式,我们可以隔离要测试的代码,并通过有效地模拟依赖关系,确保代码在各种情况下的表现符合预期。这种做法可以提高软件的可靠性和可维护性,从而更容易在开发过程的早期发现并解决问题。

IronPDF 简介

IronPDF 是一个功能强大的 C# 库,允许开发人员在其应用程序中处理 PDF 文档。它提供了广泛的功能,包括从 HTML、图像和现有 PDF 等各种来源创建、修改和转换 PDF 文件。如果与上一教程中讨论的模拟对象概念相结合,IronPDF 将成为在单元测试中生成和处理 PDF 文档的重要工具。

IronPDF 的主要特点是它的 HTML 转 PDF 功能,确保布局和样式完好无损。它能将网页内容转化为 PDF,是报告、发票和文档的完美选择。该功能支持将 HTML 文件、URL 和 HTML 字符串转换为 PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class
VB   C#

例如,如果您有一个涉及 PDF 生成或处理的项目,您可以使用 IronPDF 创建模拟 PDF 文档,模仿真实世界的场景。这对于测试和验证代码如何与 PDF 文件交互特别有用。您可以生成具有特定内容、布局和属性的模拟 PDF,然后将其用作测试夹具,以确保您的代码能生成所需的 PDF 输出或正确处理与 PDF 相关的操作。

创建生成 PDF 的 MOCK 对象

假设您正在开发一个生成财务报告的应用程序,这些报告需要以 PDF 文档的形式保存和分发。在这种情况下,您可能需要测试 PDF 的生成,并确保内容和格式正确无误。

首先,我们需要将 IronPDF 添加到项目中,在 NuGet 软件包管理器控制台中编写以下命令安装 IronPDF。

Install-Package IronPdf

该命令将为我们的项目安装和添加必要的依赖项。

下面介绍如何将 IronPDF 纳入单元测试过程:

生成模拟 PDF

您可以使用 IronPDF 创建具有特定内容和样式的模拟 PDF 文档,以模仿真实的财务报告。这些模拟 PDF 可作为单元测试的测试夹具,如以下代码片段所示:

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.SaveAsPdfA("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.SaveAsPdfA("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.SaveAsPdfA("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
VB   C#

使用模拟 PDF 进行单元测试

我们将编写使用 IronPDF 的测试,以生成代表各种报告场景的模拟 PDF。然后,我们将把代码生成的实际 PDF 与这些模拟 PDF 进行比较,以确保内容、格式和结构符合预期。

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

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

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

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

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

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

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

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

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

End Class
VB   C#

在这段测试代码中,我们生成了一个模拟 PDF (预期 PDF) 代表预期输出,并将其与 PDF 进行比较 (实际 PDF) 生成器 "生成的。我们提取了两份 PDF 的内容,以验证它们是否具有相同的内容。

结论

总之,利用 MOQ 以及 IronPDF 在单元测试过程中,MOQ 使我们能够全面验证软件应用程序的行为。MOQ 使我们能够隔离特定的代码组件、控制依赖关系并模拟复杂的场景,从而使我们能够编写重点突出且可靠的测试。

同时 IronPDF 通过促进 PDF 文档的生成和操作,确保对 PDF 相关功能进行彻底检查,从而增强我们的测试能力。通过将这些工具集成到我们的测试工具包中,我们可以自信地开发出稳健、高质量的软件,满足对功能和性能的要求。将 MOQ 的强大单元测试和 IronPDF 的 PDF 验证结合起来,大大提高了我们应用程序的整体质量和可靠性。

值得注意的是,IronPDF 提供了 免费试用 测试其功能。如果您发现它符合您的需求,您可以选择购买一个 商业许可.这样,您就可以在您的项目中继续使用 IronPDF 的功能,充分享受授权版本所带来的优势和支持,确保将 PDF 相关功能顺利集成到您的应用程序中。

< 前一页
Entity Framework C#(它是如何为开发人员工作的)
下一步 >
C# Web 框架(它如何为开发者工作)

准备开始了吗? 版本: 2024.9 刚刚发布

免费NuGet下载 总下载量: 10,731,156 查看许可证 >