Automating Tests in Spring Boot with JUnit and Mockito

In software development, maintaining high-quality code is crucial, especially as systems grow in complexity. Automated testing plays a pivotal role in ensuring that new features do not break existing functionality and that code remains robust and reliable over time. For Spring Boot applications, JUnit and Mockito are two of the most popular tools for unit testing and mocking dependencies, respectively. In this post, we'll explore how to leverage these tools to create effective automated tests in Spring Boot, ensuring that your application remains stable and maintainable.

JUnit is a widely-used testing framework for Java that provides annotations and assertions to help structure and execute tests effectively. It allows developers to write repeatable tests and supports both unit and integration testing. On the other hand, Mockito is a powerful mocking framework that enables the creation of mock objects for testing purposes. It allows developers to simulate the behavior of complex dependencies, isolating the functionality under test. By using JUnit in combination with Mockito, we can thoroughly test the business logic of our Spring Boot applications without relying on actual database connections, external services, or complex configurations.

Let's dive into a practical example to see how JUnit and Mockito can be used together in a Spring Boot application. We'll create a simple service class and write tests for it using JUnit and Mockito.

Suppose we have a UserService class that depends on a UserRepository to fetch user data:

@Service
public class UserService {

    @Autowired private final UserRepository userRepository;

    public User getUserById(Long id) {
        return userRepository.findById(id)
                .orElseThrow(() -> new UserNotFoundException("User not found"));
    }
}

Here, UserService depends on UserRepository, which is a Spring Data JPA repository interface. To test the getUserByIdmethod without hitting the database, we can use Mockito to mock the UserRepositoryand JUnit to assert the behavior of UserService.

Here's how we can write a test for UserService:

@SpringBootTest
public class UserServiceTest {

    @Mock
    private UserRepository userRepository;

    @InjectMocks
    private UserService userService;

    @BeforeEach
    public void setUp() {
        MockitoAnnotations.openMocks(this);
    }

    @Test
    public void testGetUserById_Success() {
        // Arrange
        User user = new User(1L, "John Doe", "[e-mail]");
        when(userRepository.findById(1L)).thenReturn(Optional.of(user));

        // Act
        User result = userService.getUserById(1L);

        // Assert
        assertEquals("John Doe", result.getName());
        assertEquals("[e-mail]", result.getEmail());
    }

    @Test
    public void testGetUserById_UserNotFound() {
        // Arrange
        when(userRepository.findById(1L)).thenReturn(Optional.empty());

        // Act & Assert
        assertThrows(UserNotFoundException.class, () -> userService.getUserById(1L));
    }
}

In the UserServiceTest class, we use the @Mock annotation to create a mock instance of UserRepository and the @InjectMocks annotation to inject this mock into UserService. The setUp method initializes the mocks before each test.

We then define two tests:

testGetUserById_Success: This test verifies that when a user is found by the UserRepository, the UserService returns the correct user.
testGetUserById_UserNotFound: This test ensures that when the UserRepository returns an empty result, the UserService throws a UserNotFoundException.
These tests allow us to validate the behavior of UserService without having to rely on an actual database, making them faster and more reliable.

Automating tests with JUnit and Mockito in Spring Boot applications provides a powerful way to ensure code quality and application stability. By writing comprehensive unit tests, developers can catch bugs early in the development process, making it easier to refactor code and add new features with confidence. The combination of JUnit and Mockito allows for clear, concise tests that focus on the business logic of your application, free from the complexities of external dependencies.

Embracing automated testing as a core practice not only improves the reliability of your codebase but also enhances the overall development workflow. By integrating these tests into your CI/CD pipeline, you ensure that quality checks are automated and consistent, paving the way for a more agile and resilient development process. So, whether you’re starting a new project or enhancing an existing one, make automated testing with JUnit and Mockito a part of your development strategy.

Comments

[João Angelo]

Hi Matheus Martinello,
Top, very nice and helpful !
Thanks for sharing.

[Karl Heinz Marbaise]

The usage of the autowired annotation in your service class is superfluous...

[Matheus Martinello]

Got it, thanks for the comment!