单元测试是软件开发中不可或缺的重要环节,它用于验证软件中最小可测试单元的准确性。结合运用Spring Boot、JUnit、Mockito和分层架构,开发人员可以更便捷地编写可靠、可测试且高质量的单元测试代码,确保软件的正确性和质量。
本文将从与单元测试相关的技术主题开始,在技术部分之后,介绍使用Spring Boot、JUnit和Mockito进行单元测试的实践。
单元测试中的单元一词指的是软件中可以单独测试和处理的最小功能部分,通常是指函数、方法、类或模块等独立的代码片段。
用例描述了系统使用特定功能或特性的方式,用于理解、设计和测试软件系统的需求。通常包括用户如何与系统进行交互、对系统的期望以及应该实现的结果等详细信息。
边界情况指的是软件必须处理的特定场景,这些场景包括意外或边界条件,与典型情况有所不同或被认为是罕见的情况。边界情况可以包括意外用户登录、测试限制、异常输入或其他可能导致系统错误或异常行为的情况。在测试过程中,考虑和测试边界情况是非常重要的,因为它们可以帮助开发人员发现潜在的问题并确保系统的鲁棒性和稳定性。
单元测试涵盖了我们可以考虑并编写的所有可能性。每个单元必须至少有一个测试方法。测试不是为一个方法编写的,而是为一个单元编写的。
可以按照以下顺序编写单元测试:正常路径/用例、边界情况和异常情况。
这些步骤是必不可少的,这样做可以确保单元以正确的方式处理输入,并生成预期的输出,展现出预期的行为。单元测试是及早发现风险和修复错误的最佳方式。通过单元测试,我们可以预防潜在的意外情况,应对生产代码的变更,确保生产代码能够处理各种情况。简而言之,单元测试确保了生产代码的安全性。
关于单元测试的另一个重要事项是要测试业务逻辑,不是在单元测试中测试基础设施代码,基础设施代码可以在集成测试中进行测试。可以考虑使用一些架构模式(如洋葱架构、六边形架构等)来将业务逻辑与基础设施代码分离。
单元测试的另一个优点是速度快,因为它不需要依赖 Spring ApplicationContext。由于上下文的原因,与单元测试相比,同一测试金字塔中的集成测试速度要慢得多。
在分层架构项目中,业务代码主要位于服务层。这意味着服务层具有单元,需要进行测试。让我们聚焦于最关键的部分。
以下是一段示例代码:
@Override
public String saveUser(User user) {
validateUser(user);
try {
User savedUser = userRepository.save(user);
return savedUser.getEmAIl();
} catch (Exception exception) {
throw new IllegalArgumentException(E_GENERAL_SYSTEM);
}
}
private void validateUser(User user) {
if (Objects.isNull(user.getEmail())) {
throw new IllegalArgumentException(E_USER_EMAIL_MUST_NOT_BE_NULL);
}
if (findByEmail(user.getEmail()).isPresent()) {
throw new IllegalArgumentException(E_USER_ALREADY_REGISTERED);
}
}
@Override
public Optional<User> findByEmail(String email) {
return userRepository.findByEmail(email);
}
上述代码中有两个公共方法和一个私有方法,私有方法可以被视为公共方法的一部分。此外,由于代码的复杂性和功能需求,还存在许多可能的场景需要编写多个测试用例来覆盖各种情况,以确保代码的正确性。
@ExtendWith用于将Mockito库集成到JUnit测试中。@Test 标记一个方法,使其成为一个测试方法,测试方法包含指定的测试用例,并由 JUnit 自动运行。
在测试过程中,需要模拟正在测试的类的依赖项。之前提到的原因是,由于 Spring ApplicationContext 不会启动,我们无法将依赖项注入到上下文中。@Mock 用于创建一个模拟的依赖项,而 @InjectMocks 则用于将这些模拟的依赖项注入到被测试类中。
@BeforeEach和@AfterEach可用于在每个方法运行之前和之后执行相应的操作。
@ParameterizedTest 用于使用不同的参数值运行重复的测试用例。通过使用 @ValueSource,可以为方法提供不同的参数值,以便进行多次测试。
doReturn/when 用于确定在给定指定参数时方法的行为方式。但是,由于依赖项是 @Mock,并不会真正执行。
verify 用于检查被测试代码是否按照预期行为执行。如果要测试的方法是 public void 类型,可以使用 verify 进行验证。
断言用于验证预期结果。
@ExtendWith(MockitoExtension.class)
class UserServiceImplTest {
@InjectMocks
private UserServiceImpl userService;
@Mock
private UserRepository userRepository;
private User user;
public static final String MOCK_EMAIL = "mert@bahardogan.com";
@BeforeEach
void setUp() {
user = new User();
System.out.println("init");
}
@AfterEach
void teardown() {
System.out.println("teardown");
}
@ParameterizedTest
@ValueSource(strings = {"mert@bahardogan.com", "info@gmail.com"})
@DisplayName("Happy Path: save user use cases")
void givenCorrectUser_whenSaveUser_thenReturnUserEmail(String email) {
// given
user.setUserName("mertbahardogan").setEmail(email).setPassword("pass");
User savedUser = new User().setEmail(email);
doReturn(savedUser).when(userRepository).save(any());
// when
String savedUserEmail = userService.saveUser(user);
// then
verify(userRepository,times(1)).findByEmail(anyString());
verify(userRepository,times(1)).save(any());
assertEquals(email, savedUserEmail);
}
@Test
@DisplayName("Exception Test: user email must not be null case")
void givenNullUserEmail_whenSaveUser_thenThrowsEmailMustNotNullEx() {
// when
Exception exception = assertThrows(IllegalArgumentException.class, () -> userService.saveUser(user));
// then
assertNotNull(exception);
assertEquals(E_USER_EMAIL_MUST_NOT_BE_NULL, exception.getMessage());
}
@Test
@DisplayName("Exception Test: user is already registered case")
void givenRegisteredUser_whenSaveUser_thenThrowsUserAlreadyRegisteredEx() {
// given
user.setEmail(MOCK_EMAIL);
Optional<User> savedUser = Optional.of(new User().setEmail(MOCK_EMAIL));
doReturn(savedUser).when(userRepository).findByEmail(anyString());
// when
Exception exception = assertThrows(IllegalArgumentException.class, () -> userService.saveUser(user));
// then
assertNotNull(exception);
assertEquals(E_USER_ALREADY_REGISTERED, exception.getMessage());
}
@Test
@DisplayName("Exception Test: catch case")
void givenIncorrectDependencies_whenSaveUser_thenThrowsGeneralSystemEx() {
// given
user.setEmail(MOCK_EMAIL);
// when
Exception exception = assertThrows(IllegalArgumentException.class, () -> userService.saveUser(user));
// then
assertNotNull(exception);
assertEquals(E_GENERAL_SYSTEM, exception.getMessage());
}
@Test
@DisplayName("Happy Path: find user by email")
void givenCorrectUser_whenFindByEmail_thenReturnUserEmail() {
// given
Optional<User> savedUser = Optional.of(new User().setEmail(MOCK_EMAIL));
doReturn(savedUser).when(userRepository).findByEmail(anyString());
// when
Optional<User> user = userService.findByEmail(MOCK_EMAIL);
// then
verify(userRepository,times(1)).findByEmail(anyString());
assertEquals(savedUser, user);
}
}
UserServiceImpl测试类运行时长为1秒693毫秒。