Como Implementar Testes Unitários em Java Usando JUnit e Mockito do Zero

Se você está começando com testes unitários em Java e quer aprender a usar JUnit e Mockito da maneira certa, este guia é para você.

Vou te mostrar como configurar o ambiente, criar seus primeiros testes e garantir que seu código seja mais confiável e livre de bugs.

Entenda Como Implementar Testes Unitários em Java Usando JUnit e Mockito

Testes unitários não são apenas uma boa prática—eles evitam dores de cabeça no futuro.

Afinal, quem nunca quebrou um código sem perceber? Então, bora entender como deixar seu código mais seguro e profissional com JUnit e Mockito!

O Que São Testes Unitários?

Antes de sair escrevendo código, é importante entender o que é um teste unitário.

Um teste unitário é um teste automatizado que verifica se uma unidade específica do código (como um método ou uma classe) funciona corretamente.

Ele ajuda a detectar erros mais cedo e facilita a manutenção do software.

Os principais benefícios dos testes unitários incluem:

✅ Identificar problemas rapidamente
✅ Garantir que novas mudanças não quebrem funcionalidades existentes
✅ Melhorar a qualidade do código
✅ Reduzir custos de manutenção

Agora que você já sabe por que os testes são importantes, vamos à prática!

🛠️ Configurando o Ambiente para Testes Unitários em Java Usando JUnit e Mockito

Antes de começar, você precisa configurar o ambiente para rodar JUnit e Mockito no seu projeto Java.

1. Criando um Projeto no IntelliJ IDEA ou Eclipse

Se você ainda não tem um projeto, crie um novo no IntelliJ IDEA ou Eclipse.

Se já tem, pode pular essa parte.

2. Adicionando Dependências no Maven ou Gradle

Se o seu projeto usa Maven, adicione as seguintes dependências no pom.xml:

<dependencies>
    <!-- JUnit 5 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <version>5.9.2</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <version>5.9.2</version>
    </dependency>

    <!-- Mockito -->
    <dependency>
        <groupId>org.mockito</groupId>
        <artifactId>mockito-core</artifactId>
        <version>4.5.1</version>
        <scope>test</scope>
    </dependency>
</dependencies>

Se usa Gradle, adicione ao build.gradle:

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter:5.9.2'
    testImplementation 'org.mockito:mockito-core:4.5.1'
}

Depois de adicionar as dependências, rode um Maven update (mvn clean install) ou Gradle build para garantir que está tudo certo.

Escrevendo Seu Primeiro Teste Unitário com JUnit: Testes Unitários em Java Usando JUnit e Mockito

Agora que seu ambiente está pronto, vamos criar um teste usando JUnit.

Suponha que temos a seguinte classe:

public class Calculadora {
    public int somar(int a, int b) {
        return a + b;
    }
}

Criamos um teste para verificar se o método somar() funciona corretamente.

Criando um Teste com JUnit

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculadoraTest {

    @Test
    public void testSomar() {
        Calculadora calc = new Calculadora();
        int resultado = calc.somar(2, 3);
        assertEquals(5, resultado);
    }
}

O que está acontecendo aqui?

🔹 @Test → Indica que esse método é um teste
🔹 assertEquals(5, resultado) → Compara se o resultado esperado (5) é igual ao valor retornado pelo método

Agora, basta rodar o teste! No IntelliJ ou Eclipse, clique com o botão direito na classe CalculadoraTest e selecione Run ‘CalculadoraTest’.

Se tudo estiver certo, o teste passará ✅.

🧪 Introduzindo Mockito: Simulando Dependências

Nem sempre podemos testar métodos isolados sem considerar suas dependências.

Às vezes, um método chama outro objeto, acessa um banco de dados ou faz uma requisição externa. E é aqui que entra o Mockito.

Com o Mockito, podemos criar mocks (objetos simulados) para testar apenas a parte do código que nos interessa.

Exemplo de Teste com Mockito: Testes Unitários em Java Usando JUnit e Mockito

Testes Unitários em Java Usando JUnit e Mockito: Vamos supor que temos uma classe ServicoPagamento que depende de ProcessadorPagamento.

public class ProcessadorPagamento {
    public boolean processar(double valor) {
        return valor > 0;
    }
}

Agora, criamos a classe ServicoPagamento, que usa ProcessadorPagamento:

public class ServicoPagamento {
    private final ProcessadorPagamento processador;

    public ServicoPagamento(ProcessadorPagamento processador) {
        this.processador = processador;
    }

    public boolean pagar(double valor) {
        return processador.processar(valor);
    }
}

Aqui, ServicoPagamento depende de ProcessadorPagamento, mas não queremos testar ProcessadorPagamento, apenas o comportamento de ServicoPagamento.

Para isso, usamos Mockito para simular ProcessadorPagamento:

import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class ServicoPagamentoTest {

    @Test
    public void testPagar() {
        // Criando o mock
        ProcessadorPagamento processadorMock = Mockito.mock(ProcessadorPagamento.class);
        
        // Definindo comportamento esperado
        Mockito.when(processadorMock.processar(100.0)).thenReturn(true);

        // Criando o serviço com o mock
        ServicoPagamento servico = new ServicoPagamento(processadorMock);

        // Executando o teste
        boolean resultado = servico.pagar(100.0);
        
        // Verificando o resultado
        assertTrue(resultado);
    }
}

O que acontece aqui?

✅ Criamos um mock de ProcessadorPagamento
✅ Definimos que, quando processar(100.0) for chamado, ele deve retornar true
✅ Testamos ServicoPagamento sem precisar testar ProcessadorPagamento diretamente

🔥 Dicas Extras para Escrever Testes Unitários Eficientes

1️⃣ Nomes descritivos → Use nomes claros nos métodos de teste (testPagarComValorValido)
2️⃣ Evite dependências desnecessárias → Use mocks sempre que possível
3️⃣ Teste casos extremos → E se o valor for negativo? Ou zero?
4️⃣ Mantenha os testes isolados → Cada teste deve testar apenas uma coisa

Conclusão: Testes Unitários em Java Usando JUnit e Mockito

Agora você já sabe como implementar testes unitários em Java do zero, usando JUnit e Mockito!

Com testes bem escritos, você evita problemas no futuro, melhora a qualidade do código e ganha confiança para fazer mudanças sem medo.

Que tal começar agora mesmo? Pegue um projeto e implemente alguns testes! 💡

Se este post te ajudou, compartilhe com seus amigos devs! 😉