Understanding the Basics of Unit Testing with Mockito: A Comprehensive Introduction
Unit testing is an important aspect of software development that aims to verify the correctness of individual units or components of a software system. This helps identify defects early in the development process and facilitates maintenance and rework. Mockito is a popular Java testing framework that allows you to easily create mock objects to isolate the unit under test from its dependencies.
Here's a comprehensive introduction to Mockito unit testing:
1. Setting up Mockito:
First, add the Mockito library to your Java project. You can do this by including the Mockito dependency in your build file (like Maven or Gradle).
Maven:
XML
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>3.12.4</version> <!-- Use the latest version available --> <scope>test</scope>
</dependency>
Gradle:
groovy
testImplementation 'org.mockito:mockito-core:3.12.4' // Use the latest version available
2. Writing a Test with Mockito:
Let's say you have a simple class to test:
java
public class Calculator {
public int add(int a, int b) {
return a + b; }
}
To create a test for this class using Mockito, follow these steps:
java
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.assertEquals;
// ...
@Test
public void testAdd() {
// Arrange
Calculator calculator = new Calculator();
// The class under test
int a = 5;
int b = 10;
// Act
int result = calculator.add(a, b);
// Assert
assertEquals(15, result); // The expected result
}
3. Using Mockito Mocks:
Classes often have external dependencies (eg databases, services) that make unit testing difficult. Mockito can help you create mock objects that mock these dependencies.
Suppose you have a DataService class on which a Calculator class depends:
java
public class DataService {
public int retrieveData() {
// Some complex logic here
return 100;
}
}
To test the Calculator class without relying on the actual DataService, use Mockito to mock the DataService:
java
import static org.mockito.Mockito.*;
// ...
@Test
public void testAddWithMockedDependency() {
// Arrange
DataService mockDataService = mock(DataService.class); when(mockDataService.retrieveData()).thenReturn(50); // Stub the method's return value
Calculator calculator = new Calculator();
// Act
int result = calculator.add(mockDataService.retrieveData(), 10);
// Assert
assertEquals(60, result);
}
4. Verifying Method Calls:
Mockito allows you to check if certain methods are called on mocked objects during testing. This is useful for ensuring proper interaction between components.
java
import static org.mockito.Mockito.*;
// ...
@Test
public void testAddWithMockedDependencyVerify() {
// Arrange
DataService mockDataService = mock(DataService.class); when(mockDataService.retrieveData()).thenReturn(50);
Calculator calculator = new Calculator();
// Act
calculator.add(mockDataService.retrieveData(), 10);
// Assert
verify(mockDataService).retrieveData(); // Verify that the method was called
}
These are some of the basics of unit testing with Mockito. Using Mockito's powerful features, you can write effective unit tests that help ensure the reliability and maintainability of your Java applications. Remember to always unit test separately, use mock objects to manage external dependencies. Good test!
Subscribe to my newsletter
Read articles from Samwel Nyandoro directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by