# 单元测试实用程序类和静态方法 ## 概述该技能提供了使用 JUnit 5 测试实用程序类和静态方法的综合模式。它涵盖了测试无副作用的纯函数、边缘情况处理、边界条件以及常见的实用程序模式，例如字符串操作、计算、集合和数据验证。 ## 何时使用在以下情况下使用此技能： * 使用静态辅助方法测试实用程序类 * 测试没有状态或副作用的纯函数 * 测试字符串操作和格式化实用程序 * 测试计算和转换实用程序 * 测试集合和数组实用程序 * 想要简单、快速的测试而不模拟复杂性 * 测试数据转换和验证助手 ## 说明请按照以下步骤测试实用程序类和静态方法： ### 1\.创建测试类创建一个以被测试的实用程序类命名的 JUnit 5 测试类（例如 StringUtilsTest）。 ### 2\.测试快乐之路使用有效输入为典型用例编写测试，以验证正确的行为。 ### 3\.测试边缘情况测试空输入、空字符串、零值和边界条件。 ### 4\.测试错误案例如果适用，验证无效输入是否正确引发异常。 ### 5\.使用描述性测试名称命名测试以清楚地表明正在测试什么场景（例如，shouldCapitalizeFirstLetter）。 ### 6\.使用 AssertJ 断言利用 AssertJ 的可读断言方法来获得清晰的测试代码。 ### 7\.考虑参数化测试使用 @ParameterizedTest 测试具有不同输入的多个类似场景。 ## 示例 ## 基本模式：静态实用程序测试 ### 简单字符串实用程序导入 org.junit.jupiter.api.Test; 导入静态 org.assertj.core.api.Assertions.*; 类 StringUtilsTest { @测试无效shouldCapitalizeFirstLetter() { 字符串结果 = StringUtils.capitalize("hello"); 断言（结果）.isEqualTo（“你好”）; } @测试无效shouldHandleEmptyString（）{ 字符串结果 = StringUtils.capitalize(""); 断言（结果）.isEmpty（）; } @测试无效shouldHandleNullInput（）{ 字符串结果 = StringUtils.capitalize(null); 断言（结果）.isNull（）; } @测试无效shouldHandleSingleCharacter（）{ 字符串结果 = StringUtils.capitalize("a"); assertThat(结果).isEqualTo("A"); } @测试无效shouldNotChangePascalCase() { 字符串结果 = StringUtils.capitalize("Hello"); 断言（结果）.isEqualTo（“你好”）; } } ## 测试空处理 ### 空安全实用方法类 NullSafeUtilsTest { @测试无效shouldReturnDefaultValueWhenNull() { 对象结果 = NullSafeUtils.getOrDefault(null, "default"); assertThat(结果).isEqualTo(“默认”); } @测试无效shouldReturnValueWhenNotNull() { 对象结果 = NullSafeUtils.getOrDefault("值", "默认"); assertThat(结果).isEqualTo(“值”); } @测试无效shouldReturnFalseWhenStringIsNull() { 布尔结果 = NullSafeUtils.isNotBlank(null); 断言（结果）.isFalse（）; } @测试无效shouldReturnTrueWhenStringHasContent（）{ 布尔结果 = NullSafeUtils.isNotBlank(" 文本 "); 断言（结果）.isTrue（）; } } ## 测试计算和转换 ### 数学实用程序类 MathUtilsTest { @测试无效应该计算百分比（）{ 双精度结果 = MathUtils.percentage(25, 100); assertThat(结果).isEqualTo(25.0); } @测试无效shouldHandleZeroDivisor（）{ 双精度结果 = MathUtils.percentage(50, 0); 断言（结果）.isZero（）; } @测试无效shouldRoundToTwoDecimalPlaces（）{ 双精度结果 = MathUtils.round(3.14159, 2); assertThat(结果).isEqualTo(3.14); } @测试无效shouldHandleNegativeNumbers（）{ int 结果 = MathUtils.absoluteValue(-42); assertThat(结果).isEqualTo(42); } } ## 测试集合实用程序 ### 列表/集合/映射操作类 CollectionUtilsTest { @测试无效shouldFilterList（）{ List 数字 = List.of(1, 2, 3, 4, 5); List EvenNumbers = CollectionUtils.filter(numbers, n -> n % 2 == 0); assertThat(evenNumbers).containsExactly(2, 4); } @测试无效shouldReturnEmptyListWhenNoMatches() { List 数字 = List.of(1, 3, 5); List EvenNumbers = CollectionUtils.filter(numbers, n -> n % 2 == 0); assertThat(evenNumbers).isEmpty(); } @测试无效shouldHandleNullList（）{ List 结果 = CollectionUtils.filter(null, n -> true); 断言（结果）.isEmpty（）; } @测试无效shouldJoinStringsWithSeparator（）{ String result = CollectionUtils.join(List.of("a", "b", "c"), "-"); assertThat(结果).isEqualTo("a-b-c"); } @测试无效shouldHandleEmptyList（）{ 字符串结果 = CollectionUtils.join(List.of(), "-"); 断言（结果）.isEmpty（）; } @测试无效shouldDeduplicateList（）{ List input = List.of("苹果", "香蕉", "苹果", "樱桃", "香蕉"); Set unique = CollectionUtils.deduplicate(input); assertThat(unique).containsExactlyInAnyOrder("苹果", "香蕉", "樱桃"); } } ## 测试字符串转换 ### 格式化和解析实用程序类 FormatUtilsTest { @测试无效 shouldFormatCurrencyWithSymbol() { 字符串结果 = FormatUtils.formatCurrency(1234.56); assertThat(结果).isEqualTo("$1,234.56"); } @测试无效shouldHandleNegativeCurrency（）{ 字符串结果 = FormatUtils.formatCurrency(-100.00); assertThat(结果).isEqualTo("-$100.00"); } @测试无效shouldParsePhoneNumber（）{ 字符串结果 = FormatUtils.parsePhoneNumber("5551234567"); assertThat(结果).isEqualTo("(555) 123-4567"); } @测试无效shouldFormatDate() { LocalDate 日期 = LocalDate.of(2024, 1, 15); 字符串结果 = FormatUtils.formatDate(日期, "yyyy-MM-dd"); assertThat(结果).isEqualTo("2024-01-15"); } @测试无效shouldSluggifyString（）{ String result = FormatUtils.sluggify("Hello World!123"); assertThat(结果).isEqualTo("hello-world-123"); } } ## 测试数据验证 ### 验证器实用程序类 ValidatorUtilsTest { @测试无效shouldValidateEmailFormat（）{ 布尔有效 = ValidatorUtils.isValidEmail("user@example.com"); 断言（有效）.isTrue（）; boolean invalid = ValidatorUtils.isValidEmail("无效电子邮件"); 断言（无效）.isFalse（）; } @测试无效shouldValidatePhoneNumber（）{ 布尔有效 = ValidatorUtils.isValidPhone("555-123-4567"); 断言（有效）.isTrue（）; 布尔无效 = ValidatorUtils.isValidPhone("12345"); 断言（无效）.isFalse（）; } @测试无效shouldValidateUrlFormat() { 布尔有效 = ValidatorUtils.isValidUrl("https://example.com"); 断言（有效）.isTrue（）; boolean invalid = ValidatorUtils.isValidUrl("不是网址"); 断言（无效）.isFalse（）; } @测试无效 shouldValidateCreditCardNumber() { 布尔有效 = ValidatorUtils.isValidCreditCard("4532015112830366"); 断言（有效）.isTrue（）; 布尔无效 = ValidatorUtils.isValidCreditCard("1234567890123456"); 断言（无效）.isFalse（）; } } ## 测试参数化场景 ### 使用@ParameterizedTest 进行多个测试用例导入 org.junit.jupiter.params.ParameterizedTest; 导入 org.junit.jupiter.params.provider.ValueSource; 导入 org.junit.jupiter.params.provider.CsvSource; 类 StringUtilsParametrizedTest { @参数化测试 @ValueSource(字符串 = {"", " ", "null", "未定义"}) 无效shouldConsiderFalsyValuesAsEmpty（字符串输入）{ 布尔结果 = StringUtils.isEmpty(input); 断言（结果）.isTrue（）; } @参数化测试 @CsvSource({ “你好，你好”， “世界，世界”， “JavaScript，JAVASCRIPT”， “123ABC，123ABC” }) void shouldConvertToUpperCase(字符串输入，预期字符串) { 字符串结果 = StringUtils.toUpperCase(input); assertThat(结果).isEqualTo(预期); } } ## 使用 Mockito 测试外部依赖项 ### 具有依赖关系的实用程序（罕见情况）导入 org.junit.jupiter.api.extension.ExtendWith; 导入 org.mockito.Mock; 导入 org.mockito.junit.jupiter.MockitoExtension; 导入静态 org.mockito.Mockito.when; @ExtendWith(MockitoExtension.class) 类 DateUtilsTest { @模拟私人时钟； @测试无效shouldGetCurrentDateFromClock（）{ 即时fixedTime = Instant.parse("2024-01-15T10:30:00Z"); when(clock.instant()).thenReturn(fixedTime); LocalDate 结果 = DateUtils.today(时钟); assertThat(结果).isEqualTo(LocalDate.of(2024, 1, 15)); } } ## 边缘情况和边界测试类 MathUtilsEdgeCaseTest { @测试无效shouldHandleMaxIntegerValue（）{ int 结果 = MathUtils.increment(Integer.MAX_VALUE); assertThat(结果).isEqualTo(Integer.MAX_VALUE); } @测试无效shouldHandleMinIntegerValue（）{ int 结果 = MathUtils.decrement(Integer.MIN_VALUE); assertThat(结果).isEqualTo(Integer.MIN_VALUE); } @测试无效shouldHandleVeryLargeNumbers（）{ BigDecimal 结果 = MathUtils.add( 新的 BigDecimal("999999999999.99"), 新的 BigDecimal("0.01") ）； assertThat(结果).isEqualTo(new BigDecimal("1000000000000.00")); } @测试无效shouldHandleFloatingPointPrecision（）{ 双精度结果 = MathUtils.multiply(0.1, 0.2); assertThat(结果).isCloseTo(0.02, 在(0.0001)); } } ## 最佳实践 * **专门测试纯函数** \- 无副作用或状态 * **覆盖快乐路径和边缘情况** \- null、空、极值 * **使用描述性测试名称** \- 清楚地说明正在测试的内容 * **保持测试简单和简短** \- 实用程序测试应该能够快速理解 * **使用@ParameterizedTest**来测试多个类似的场景 * **不需要时避免模拟** \- 仅模拟外部依赖项 * **测试边界条件** \- 最小/最大值、空集合、空输入 ## 常见陷阱 * 测试框架行为而不是实用程序逻辑 * 当纯函数不需要模拟时过度模拟 * 不测试空/空边缘情况 * 不测试负数和极值 * 测试方法太大——分割复杂场景 ## 限制和警告 * **不能模拟静态方法** ：仅在绝对必要时才使用基于反射的实用程序（例如 PowerMock） * **纯函数要求**：实用方法应该是纯函数；测试有状态的实用程序很困难 * **浮点精度** ：切勿使用精确相等进行浮点比较；使用耐受性 * **Null 处理一致性** ：决定实用程序是否返回 null 或针对无效输入抛出异常 * **不可变输入** ：清楚地记录实用程序方法是否修改输入参数 * **线程安全** ：静态实用程序必须是线程安全的；并发访问下验证 * **外部依赖**：最小化实用程序类中的外部依赖以方便测试 ## 示例 ### 输入：无需测试的实用方法公共类 StringUtils { 公共静态布尔 isEmpty(String str) { 返回 str == null || str.trim().isEmpty(); } } ### 输出：完整的测试覆盖率类 StringUtilsTest { @测试无效shouldReturnTrueForNullString（）{ assertThat(StringUtils.isEmpty(null)).isTrue(); } @测试无效shouldReturnTrueForEmptyString（）{ assertThat(StringUtils.isEmpty("")).isTrue(); } @测试无效shouldReturnTrueForWhitespaceOnly() { assertThat(StringUtils.isEmpty(" ")).isTrue(); } @测试无效shouldReturnFalseForNonEmptyString（）{ assertThat(StringUtils.isEmpty("hello")).isFalse(); } } ### 输入：没有边缘情况测试的计算公共静态双百分比（int值，int总计）{ 返回（值/总计）* 100.0； } ### 输出：覆盖边缘情况的测试类 MathUtilsTest { @测试无效应该计算正常百分比（）{ assertThat(MathUtils.percentage(25, 100)).isEqualTo(25.0); } @测试无效shouldHandleZeroDivisor（）{ assertThat(MathUtils.percentage(50, 0)).isEqualTo(0.0); } @测试无效shouldHandleZeroValue（）{ assertThat(MathUtils.percentage(0, 100)).isEqualTo(0.0); } } ## 限制和警告 **浮点精度问题**：使用带有 delta 的 `isCloseTo()` 而不是完全相等。 **空处理不一致**：决定实用程序是否返回空或引发异常，然后进行一致的测试。 **复杂的实用程序逻辑属于其他地方**：考虑重构为可测试的单元。 ## 参考文献 * [JUnit 5 参数化测试]() * [AssertJ 断言]() * [测试边缘情况和边界]()

单元测试实用方法

包含技能