.NET 帮助

Junit Java（开发人员指南）

坎那帕·乌东攀

2024年九月29日

JUnit 框架是一个广泛使用的 Java 应用程序单元测试框架。它提供了一种简单、优雅的方法来编写和运行可重复的测试。使用 JUnit Java，开发人员可以通过编写验证其软件不同方面的单元测试来确保其代码按预期运行。此外，开发人员还可以编写测试类来组织测试用例，并利用测试运行器来执行测试和获取反馈。单元测试框架不仅有助于识别漏洞，还促进更好的设计和可维护性。

在本文中，我们将讨论 Junit Java 测试执行，并查看不同的执行技术。我们还将为PDF创建编写一个测试用例，使用IronPDF用于 Java。

JUnit的历史和发展

JUnit测试框架由Kent Beck和Erich Gamma创建，他们是软件开发社区的两位领军人物。自二十世纪九十年代末问世以来，JUnit经历了多次迭代，每次都增加了更多功能并提高了易用性。当前的稳定版本 JUnit 5，也称为 JUnit Jupiter，相较于其前身引入了多项增强功能，使其更加健壮和灵活。

JUnit的关键特性

注解：JUnit使用注解来定义和配置测试。常见的注解包括：
- @Test：标记一个方法为测试方法。
- @BeforeEach：在每个测试之前运行。
- @AfterEach: 在每个测试之后运行。
- @BeforeAll：在所有测试之前运行一次。
- @AfterAll：在所有测试结束后运行一次。
断言：断言用于检查测试结果是否与预期结果匹配。一些常见的断言包括：
- 断言相等(预期, 实际)检查两个值是否相等。
  - 断言正确(条件)检查条件是否为真。
  - assertFalse(条件): 检查条件是否为假。
  - assertNull(反对)检查对象是否为 null。
  - assertNotNull(反对)检查一个对象是否不为空。

参数化测试：JUnit支持参数化测试，允许使用不同参数运行相同的测试，从而提高测试效率。
测试套件：可以将测试组合成测试套件，以便一起运行多个测试。
异常测试：JUnit可以测试方法是否抛出预期的异常。
与构建工具的集成：JUnit可以与Maven等广泛使用的构建工具无缝集成。这使您可以在构建过程中自动运行测试和测试代码，并在构建过程中如果有任何测试失败时通知开发人员。

与构建工具集成

JUnit可以与广泛使用的构建工具如Maven无缝集成。这使您能够在构建过程中自动运行测试。

要在Maven中使用JUnit，请在您的pom.xml文件中添加以下依赖项：

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.8.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.8.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<dependencies>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.8.1</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.8.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<dependencies> <dependency> <groupId> org.junit.jupiter</groupId> <artifactId> junit-jupiter-api</artifactId> <version>5.8.1</version> <scope> test</scope> </dependency> <dependency> <groupId> org.junit.jupiter</groupId> <artifactId> junit-jupiter-engine</artifactId> <version>5.8.1</version> <scope> test</scope> </dependency> </dependencies>

编写您的第一个JUnit测试

在深入研究更复杂的示例之前，让我们从一个简单的单元测试用例开始。我们将为一个基本的计算器类编写测试。

计算器类

// Calculator.java
public class Calculator {
    public int add(int a, int b) {
        return a + b;
    }
    public int subtract(int a, int b) {
        return a - b;
    }
}

// Calculator.java
public class Calculator {
    public int add(int a, int b) {
        return a + b;
    }
    public int subtract(int a, int b) {
        return a - b;
    }
}

' Calculator.java
Public Class Calculator
	Public Function add(ByVal a As Integer, ByVal b As Integer) As Integer
		Return a + b
	End Function
	Public Function subtract(ByVal a As Integer, ByVal b As Integer) As Integer
		Return a - b
	End Function
End Class

单元测试类

// CalculatorTest.java
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
public class CalculatorTest {
    @Test
    public void testAdd() {
        Calculator calculator = new Calculator();
        assertEquals(5, calculator.add(2, 3));
    }
    @Test
    public void testSubtract() {
        Calculator calculator = new Calculator();
        assertEquals(1, calculator.subtract(3, 2));
    }
}

// CalculatorTest.java
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
public class CalculatorTest {
    @Test
    public void testAdd() {
        Calculator calculator = new Calculator();
        assertEquals(5, calculator.add(2, 3));
    }
    @Test
    public void testSubtract() {
        Calculator calculator = new Calculator();
        assertEquals(1, calculator.subtract(3, 2));
    }
}

' CalculatorTest.java
Private org As import
Private Shared As import
Public Class CalculatorTest
	Test Public Sub testAdd()
		Dim calculator As New Calculator()
		assertEquals(5, calculator.add(2, 3))
	End Sub
	Test Public Sub testSubtract()
		Dim calculator As New Calculator()
		assertEquals(1, calculator.subtract(3, 2))
	End Sub
End Class

CalculatorTest 示例包含两个测试方法，一个用于测试加法：testAdd，一个用于测试减法：testSubtract。每个方法都会创建一个计算器类的实例，并使用断言来验证加法和减法方法的正确性。

输出

Junit Java（对开发人员的工作原理）：图2 - 运行Junit测试的输出

高级 JUnit 功能

参数化测试

参数化测试允许您使用不同的参数集运行相同的测试。这对于使用广泛输入范围来测试方法非常有用。

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import static org.junit.jupiter.api.Assertions.*;
public class CalculatorParameterizedTest {
    @ParameterizedTest
    @CsvSource({
        "1, 1, 2",
        "2, 3, 5",
        "10, 20, 30"
    })
    public void testAdd(int a, int b, int expected) {
        Calculator calculator = new Calculator();
        assertEquals(expected, calculator.add(a, b));
    }
}

import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import static org.junit.jupiter.api.Assertions.*;
public class CalculatorParameterizedTest {
    @ParameterizedTest
    @CsvSource({
        "1, 1, 2",
        "2, 3, 5",
        "10, 20, 30"
    })
    public void testAdd(int a, int b, int expected) {
        Calculator calculator = new Calculator();
        assertEquals(expected, calculator.add(a, b));
    }
}

Private org As import
Private org As import
Private Shared As import
Public Class CalculatorParameterizedTest
	ParameterizedTest CsvSource({ "1, 1, 2", "2, 3, 5", "10, 20, 30" }) Public Sub testAdd(ByVal a As Integer, ByVal b As Integer, ByVal expected As Integer)
		Dim calculator As New Calculator()
		assertEquals(expected, calculator.add(a, b))
	End Sub
End Class

在此示例中，testAdd 方法根据 CsvSource 指定的不同输入集运行三次。

异常测试

有时，您需要验证某个方法是否抛出预期的异常。

将以下方法添加到您的计算器类中。

public float divide(int a, int b) {
        return a / b;
    }

public float divide(int a, int b) {
        return a / b;
    }

Public Function divide(ByVal a As Integer, ByVal b As Integer) As Single
		Return a \ b
End Function

测试类：

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class CalculatorExceptionTest {
    @Test
    public void testDivisionByZero() {
        Calculator calculator = new Calculator();
        assertThrows(ArithmeticException.class, () -> calculator.divide(1, 0));
    }
}

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class CalculatorExceptionTest {
    @Test
    public void testDivisionByZero() {
        Calculator calculator = new Calculator();
        assertThrows(ArithmeticException.class, () -> calculator.divide(1, 0));
    }
}

Private org As import
Private Shared As import
Friend Class CalculatorExceptionTest
	Test Public Sub testDivisionByZero()
		Dim calculator As New Calculator()
		assertThrows(ArithmeticException.class, () -> calculator.divide(1, 0))
	End Sub
End Class

输出

Junit Java（开发人员如何使用）：图 3 - 运行 Junit 测试的输出结果

将IronPDF与JUnit集成到Java中

IronPDF是一个用于在 Java 应用程序中生成 PDF 文档的强大库。将IronPDF与JUnit集成可以自动化测试PDF生成功能，确保文档准确生成并符合所需规格。

Junit Java（对开发者的作用）：图4 - IronPDF主页：Java PDF库

要将IronPDF集成到JUnit中，首先需要在项目依赖项中包含IronPDF库。

<dependencies>
<!--Adds IronPDF Java. Use the latest version in the version tag.-->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>
<!--Adds the slf4j logger which IronPDF Java uses.-->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>

<dependencies>
<!--Adds IronPDF Java. Use the latest version in the version tag.-->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>
<!--Adds the slf4j logger which IronPDF Java uses.-->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<dependencies> <!--Adds IronPDF Java.Use the latest version in the version tag.-- > <dependency> <groupId> com.ironsoftware</groupId> <artifactId> ironpdf</artifactId> <version>20xx.xx.xxxx</version> </dependency> <!--Adds the slf4j logger which IronPDF Java uses.-- > <dependency> <groupId> org.slf4j</groupId> <artifactId> slf4j-simple</artifactId> <version>2.0.3</version> </dependency> </dependencies>

完成后，您可以编写测试用例来验证使用IronPDF的API生成PDF的逻辑。以下是如何使用JUnit测试IronPDF的PDF生成的示例：

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
import com.ironsoftware.ironpdf.*;
import java.io.File;
import java.io.IOException;
class PdfGenerationTest {
    @Test
    public void testPdfGeneration() throws IOException {
        // Define HTML content
        String htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        // Convert HTML to PDF
        PdfDocument pdfDocument = PdfDocument.renderHtmlAsPdf(htmlContent);
        // Save PDF to file
        pdfDocument.saveAs("output.pdf");
        // Assert PDF generation
        assertTrue(new File("output.pdf").exists());
    }
}

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
import com.ironsoftware.ironpdf.*;
import java.io.File;
import java.io.IOException;
class PdfGenerationTest {
    @Test
    public void testPdfGeneration() throws IOException {
        // Define HTML content
        String htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
        // Convert HTML to PDF
        PdfDocument pdfDocument = PdfDocument.renderHtmlAsPdf(htmlContent);
        // Save PDF to file
        pdfDocument.saveAs("output.pdf");
        // Assert PDF generation
        assertTrue(new File("output.pdf").exists());
    }
}

Private org As import
Private Shared As import
Private com As import
Private java As import
Private java As import
Friend Class PdfGenerationTest
	Test Public Sub testPdfGeneration()
		' Define HTML content
		Dim htmlContent As String = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
		' Convert HTML to PDF
		Dim pdfDocument As PdfDocument = PdfDocument.renderHtmlAsPdf(htmlContent)
		' Save PDF to file
		pdfDocument.saveAs("output.pdf")
		' Assert PDF generation
		assertTrue((New File("output.pdf")).exists())
	End Sub
End Class

在此示例中，我们创建一个测试用例 testPdfGeneration()使用IronPDF将HTML内容转换为PDF文档。然后，测试通过检查文件系统上的PDF文件是否存在来验证其是否已成功生成。

Junit Java（对开发人员的作用）：图 5 - 运行上述 Junit 测试的控制台输出，检查 PDF 创建成功

结论

JUnit 是一个多功能的 Java 测试框架，可以简化编写和执行自动化测试的过程。通过利用其功能，例如参数化测试、异常处理和注释，开发人员可以确保其代码库的可靠性和健壮性。

集成IronPDF通过JUnit可以在Java应用程序中全面测试PDF生成功能，确保生成的文档符合质量标准并遵循规范。通过结合JUnit和IronPDF的强大功能，开发人员可以精简测试过程，并自信地交付高质量的软件。

要了解更多关于如何将HTML字符串渲染为PDF的信息，请访问以下网站链接.

坎那帕·乌东攀

立即与工程团队聊天

软件工程师

在成为软件工程师之前，Kannapat 从日本北海道大学完成了环境资源博士学位。在攻读学位期间，Kannapat 还成为了生物生产工程系车辆机器人实验室的成员。2022年，他利用自己的 C# 技能加入了 Iron Software 的工程团队，专注于 IronPDF。Kannapat 珍视他的工作，因为他能直接向编写 IronPDF 大部分代码的开发者学习。除了同伴学习，Kannapat 还享受在 Iron Software 工作的社交方面。不写代码或文档时，Kannapat 通常在 PS5 上玩游戏或重看《最后生还者》。

< 前一页
Socket io .NET（其对开发人员的工作原理）

下一步 >
Microsoft.Extensions.DependencyInjection .NET 9（使用 PDF）