Melhores Práticas do JUnit 5+

Seu objetivo é me ajudar a escrever testes unitários eficazes com JUnit 5, cobrindo abordagens de testes padrão e orientados por dados.

Configuração do Projeto

• Use uma estrutura de projeto Maven ou Gradle padrão.
• Coloque o código fonte de teste em src/test/java.
• Inclua dependências para junit-jupiter-api, junit-jupiter-engine e junit-jupiter-params para testes parametrizados.
• Use comandos da ferramenta de build para executar testes: mvn test ou gradle test.

Estrutura de Teste

• As classes de teste devem ter o sufixo Test, por exemplo, CalculatorTest para uma classe Calculator.
• Use @Test para métodos de teste.
• Siga o padrão Arrange-Act-Assert (AAA).
• Nomeie os testes usando uma convenção descritiva, como methodName_should_expectedBehavior_when_scenario.
• Use @BeforeEach e @AfterEach para configuração e limpeza por teste.
• Use @BeforeAll e @AfterAll para configuração e limpeza por classe (devem ser métodos estáticos).
• Use @DisplayName para fornecer um nome legível para classes e métodos de teste.

Testes Padrão

• Mantenha os testes focados em um único comportamento.
• Evite testar múltiplas condições em um único método de teste.
• Torne os testes independentes e idempotentes (podem ser executados em qualquer ordem).
• Evite interdependências de testes.

Testes Orientados por Dados (Parametrizados)

• Use @ParameterizedTest para marcar um método como um teste parametrizado.
• Use @ValueSource para valores literais simples (strings, inteiros, etc.).
• Use @MethodSource para se referir a um método fábrica que fornece argumentos de teste como um Stream, Collection, etc.
• Use @CsvSource para valores inline separados por vírgula.
• Use @CsvFileSource para usar um arquivo CSV do classpath.
• Use @EnumSource para usar constantes de enumeração.

Asserções

• Use os métodos estáticos de org.junit.jupiter.api.Assertions (por exemplo, assertEquals, assertTrue, assertNotNull).
• Para asserções mais fluentes e legíveis, considere usar uma biblioteca como AssertJ (assertThat(...).is...).
• Use assertThrows ou assertDoesNotThrow para testar exceções.
• Agrupe asserções relacionadas com assertAll para garantir que todas as asserções sejam verificadas antes que o teste falhe.
• Use mensagens descritivas nas asserções para fornecer clareza em caso de falha.

Mocking e Isolamento

• Use um framework de mocking como Mockito para criar objetos mock para dependências.
• Use as anotações @Mock e @InjectMocks do Mockito para simplificar a criação e injeção de mocks.
• Use interfaces para facilitar o mocking.

Organização de Testes

• Agrupe testes por funcionalidade ou componente usando pacotes.
• Use @Tag para categorizar testes (por exemplo, @Tag("fast"), @Tag("integration")).
• Use @TestMethodOrder(MethodOrderer.OrderAnnotation.class) e @Order para controlar a ordem de execução dos testes quando estritamente necessário.
• Use @Disabled para pular temporariamente um método ou classe de teste, fornecendo um motivo.
• Use @Nested para agrupar testes em uma classe interna aninhada para melhor organização e estrutura.