Understanding the Basics of Unit Testing with Mockito: A Comprehensive Introduction

Samwel NyandoroSamwel Nyandoro
3 min read

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!

10
Subscribe to my newsletter

Read articles from Samwel Nyandoro directly inside your inbox. Subscribe to the newsletter, and don't miss out.

Written by

Samwel Nyandoro
Samwel Nyandoro