本文讲解如何通过依赖抽象、时间可控制和 mockito 模拟等手段，对静态日期工具方法（如返回 xmlgregoriancalendar 或格式化字符串）进行可靠、可重复的单元测试。
本文讲解如何通过依赖抽象、时间可控制和 mockito 模拟等手段，对静态日期工具方法（如返回 xmlgregoriancalendar 或格式化字符串）进行可靠、可重复的单元测试。
在 Java 单元测试中，直接测试依赖系统当前时间（如 new Date()、LocalDateTime.now() 或 DateUtils.currentDate()）的工具方法是极具挑战性的——因为每次运行结果都不同，违反了测试的可重复性和确定性原则。你提供的 getCalendar() 和 getDateNowYyMm() 方法正是典型场景：它们静态调用 DateUtils.currentDate()，内部又经 SimpleDateFormat 和 DatatypeFactory 构造 XMLGregorianCalendar，导致难以断言、难以覆盖边界用例（如闰年、时区、格式异常等）。
✅ 正确解法：面向测试重构 + 时间抽象
核心原则：将“获取当前时间”这一副作用行为抽象为可注入、可模拟的依赖。 静态工具类本身不利于测试，因此推荐以下渐进式改进：
1. 引入时间供应接口（推荐）
public interface Clock {
Instant now();
}
改造 DateUtils 为非静态、可注入依赖的类：
public class DateUtils {
private final Clock clock;
public DateUtils(Clock clock) {
this.clock = clock;
}
public XMLGregorianCalendar getCalendar() throws DatatypeConfigurationException {
LocalDateTime now = LocalDateTime.ofInstant(clock.now(), ZoneId.systemDefault());
String formatted = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss"));
return DatatypeFactory.newInstance()
.newXMLGregorianCalendar(formatted);
}
public String getDateNowYyMm() throws DatatypeConfigurationException {
LocalDateTime now = LocalDateTime.ofInstant(clock.now(), ZoneId.systemDefault());
String formatted = now.format(DateTimeFormatter.ofPattern("yyMM"));
return DatatypeFactory.newInstance()
.newXMLGregorianCalendar(formatted)
.toString();
}
}
2. 测试代码（使用 JUnit 5 + Mockito）
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;
class DateUtilsTest {
@Test
void getCalendar_returnsValidXMLGregorianCalendar() throws Exception {
// 给定：固定时间为 2024-03-15T14:30:45
Clock mockClock = () -> Instant.parse("2024-03-15T14:30:45Z");
DateUtils utils = new DateUtils(mockClock);
// 当：调用方法
XMLGregorianCalendar result = utils.getCalendar();
// 那么：校验结果（注意：XMLGregorianCalendar.toString() 格式为 yyyy-MM-dd'T'HH:mm:ss）
assertNotNull(result);
assertEquals(2024, result.getYear());
assertEquals(3, result.getMonth());
assertEquals(15, result.getDay());
assertEquals(14, result.getHour());
assertEquals(30, result.getMinute());
assertEquals(45, result.getSecond());
}
@Test
void getDateNowYyMm_returnsFormattedString() throws Exception {
Clock mockClock = () -> Instant.parse("2023-12-01T09:15:22Z");
DateUtils utils = new DateUtils(mockClock);
String result = utils.getDateNowYyMm();
assertEquals("2312", result); // yyMM → "2312"
}
}
3. 若必须保留静态 API（兼容旧代码）
可提供一个默认实例 + 可替换的测试钩子：
public class DateUtils {
private static Clock defaultClock = Clock.systemDefaultZone();
// 仅用于测试：允许注入模拟时钟
public static void setTestClock(Clock testClock) {
defaultClock = testClock;
}
public static XMLGregorianCalendar getCalendar() throws DatatypeConfigurationException {
LocalDateTime now = LocalDateTime.ofInstant(defaultClock.now(), ZoneId.systemDefault());
String formatted = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss"));
return DatatypeFactory.newInstance().newXMLGregorianCalendar(formatted);
}
}
对应测试：
@Test
void getCalendar_withTestClock() throws Exception {
DateUtils.setTestClock(() -> Instant.parse("2025-01-01T00:00:00Z"));
try {
XMLGregorianCalendar cal = DateUtils.getCalendar();
assertEquals(2025, cal.getYear());
assertEquals(1, cal.getMonth());
assertEquals(1, cal.getDay());
} finally {
// 恢复默认，避免污染其他测试
DateUtils.setTestClock(Clock.systemDefaultZone());
}
}
⚠️ 注意事项与最佳实践
- 避免 new Date() / System.currentTimeMillis() 直接调用：它们是测试毒药，务必封装。
- 慎用 SimpleDateFormat：它是线程不安全的，建议改用 DateTimeFormatter（不可变、线程安全）。
- XMLGregorianCalendar 的断言要具体：不要只断言 toString()，应验证 getYear()、getMonth() 等字段，因其格式可能受时区影响。
- 异常测试不可少：例如传入非法格式或 null 时，确保 DatatypeConfigurationException 被正确抛出（可用 assertThrows）。
- 时区显式指定：ZoneId.systemDefault() 在 CI 环境中可能不稳定，建议统一使用 ZoneOffset.UTC 并在测试中明确声明。
通过将“时间”建模为一等公民（Clock 接口），你的日期工具类就从“不可测的静态黑盒”转变为“高内聚、低耦合、易验证”的可维护组件——这才是面向测试设计（Test-Driven Design）的真正价值所在。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
