springboot-tdd

Flujo de trabajo TDD para Spring Boot

Guía de TDD para servicios Spring Boot con cobertura superior al 80% (unidad + integración).

Cuándo usarlo

• Nuevas funcionalidades o endpoints
• Corrección de errores o refactorizaciones
• Adición de lógica de acceso a datos o reglas de seguridad

Flujo de trabajo

1. Escribir las pruebas primero (deben fallar)
2. Implementar el código mínimo necesario para que pasen
3. Refactorizar con las pruebas en verde
4. Hacer cumplir la cobertura (JaCoCo)

Pruebas unitarias (JUnit 5 + Mockito)

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

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

    Market result = service.create(req);

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

Patrones:

• Arrange-Act-Assert
• Evitar mocks parciales; preferir stubbing explícito
• Usar @ParameterizedTest para variantes

Pruebas de capa 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());
  }
}

Pruebas de integración (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":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}
        """))
      .andExpect(status().isCreated());
  }
}

Pruebas de persistencia (DataJpaTest)

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

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

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

Testcontainers

• Usar contenedores reutilizables para Postgres/Redis que reflejen el entorno de producción
• Conectarlos mediante @DynamicPropertySource para inyectar las URLs JDBC en el contexto de Spring

Cobertura (JaCoCo)

Fragmento de 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>

Aserciones

• Preferir AssertJ (assertThat) por legibilidad
• Para respuestas JSON, usar jsonPath
• Para excepciones: assertThatThrownBy(...)

Constructores de datos de prueba

class MarketBuilder {
  private String name = "Test";
  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 o mvn verify
• Gradle: ./gradlew test jacocoTestReport

Recuerda: Mantén las pruebas rápidas, aisladas y deterministas. Prueba el comportamiento, no los detalles de implementación.