springboot-tdd

Fluxo de Trabalho TDD para Spring Boot

Orientações de TDD para serviços Spring Boot com cobertura acima de 80% (unitário + integração).

Quando Usar

• Novas funcionalidades ou endpoints
• Correções de bugs ou refatorações
• Adicionar lógica de acesso a dados ou regras de segurança

Fluxo de Trabalho

1. Escreva os testes primeiro (eles devem falhar)
2. Implemente o código mínimo para passar
3. Refatore com os testes verdes
4. Reforce a cobertura (JaCoCo)

Testes Unitários (JUnit 5 + Mockito)

@ExtendWith(MockitoExtension.class)
class MarketServiceTest {
  @Mock MarketRepository repo;
  @InjectMocks MarketService service;

  @Test
  void createsMarket() {
    CreateMarketRequest req = new CreateMarketRequest("nome", "desc", Instant.now(), List.of("cat"));
    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));

    Market result = service.create(req);

    assertThat(result.name()).isEqualTo("nome");
    verify(repo).save(any());
  }
}

Padrões:

• Arrange-Act-Assert (Organizar-Agir-Afirmar)
• Evite mocks parciais; prefira stubbing explícito
• Use @ParameterizedTest para variantes

Testes da Camada Web (MockMvc)

@WebMvcTest(MarketController.class)
class MarketControllerTest {
  @Autowired MockMvc mockMvc;
  @MockBean MarketService marketService;

  @Test
  void returnsMarkets() throws Exception {
    when(marketService.list(any())).thenReturn(Page.empty());

    mockMvc.perform(get("/api/markets"))
        .andExpect(status().isOk())
        .andExpect(jsonPath("$.content").isArray());
  }
}

Testes de Integração (SpringBootTest)

@SpringBootTest
@AutoConfigureMockMvc
@ActiveProfiles("test")
class MarketIntegrationTest {
  @Autowired MockMvc mockMvc;

  @Test
  void createsMarket() throws Exception {
    mockMvc.perform(post("/api/markets")
        .contentType(MediaType.APPLICATION_JSON)
        .content("""
          {"name":"Teste","description":"Descrição","endDate":"2030-01-01T00:00:00Z","categories":["geral"]}
        """))
      .andExpect(status().isCreated());
  }
}

Testes de Persistência (DataJpaTest)

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@Import(TestContainersConfig.class)
class MarketRepositoryTest {
  @Autowired MarketRepository repo;

  @Test
  void savesAndFinds() {
    MarketEntity entity = new MarketEntity();
    entity.setName("Teste");
    repo.save(entity);

    Optional<MarketEntity> found = repo.findByName("Teste");
    assertThat(found).isPresent();
  }
}

Testcontainers

• Use containers reutilizáveis para Postgres/Redis para espelhar a produção
• Conecte via @DynamicPropertySource para injetar URLs JDBC no contexto do Spring

Cobertura (JaCoCo)

Trecho Maven:

<plugin>
  <groupId>org.jacoco</groupId>
  <artifactId>jacoco-maven-plugin</artifactId>
  <version>0.8.14</version>
  <executions>
    <execution>
      <goals><goal>prepare-agent</goal></goals>
    </execution>
    <execution>
      <id>report</id>
      <phase>verify</phase>
      <goals><goal>report</goal></goals>
    </execution>
  </executions>
</plugin>

Asserções

• Prefira AssertJ (assertThat) para legibilidade
• Para respostas JSON, use jsonPath
• Para exceções: assertThatThrownBy(...)

Construtores de Dados de Teste

class MarketBuilder {
  private String name = "Teste";
  MarketBuilder withName(String name) { this.name = name; return this; }
  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }
}

Comandos de CI

• Maven: mvn -T 4 test ou mvn verify
• Gradle: ./gradlew test jacocoTestReport

Lembre-se: Mantenha os testes rápidos, isolados e determinísticos. Teste comportamento, não detalhes de implementação.