Springboot Tdd

affaan-m/ECC/docs/tr/skills/springboot-tdd

by affaan-mef648e01899ba3e8dc6371642deaaf64b4477775No license275K starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 4 days ago

Test-driven development for Spring Boot using JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo. Use when adding features, fixing bugs, or refactoring.

Instructions onlySoftware Development

AI-generated overview

Guides test-driven development for Spring Boot services using JUnit 5, Mockito, MockMvc, Testcontainers and JaCoCo.

What it does: This skill provides a TDD workflow for Spring Boot services, covering writing failing tests first, implementing minimal code, refactoring, and enforcing coverage. It supplies example test patterns for unit tests with JUnit 5 and Mockito, web layer tests with MockMvc, integration tests with SpringBootTest, and persistence tests with DataJpaTest and Testcontainers. It also includes JaCoCo Maven configuration, assertion guidance, test data builders, and CI commands for Maven and Gradle.
When to use it: Use it when adding new features or endpoints, fixing bugs, refactoring, or adding data access logic and security rules in a Spring Boot project. It is intended for developers who want a structured TDD approach with 80% or higher unit and integration coverage.
Requirements: Requires a Spring Boot project with Java, JUnit 5, Mockito, MockMvc, Testcontainers, JaCoCo, and a build tool such as Maven or Gradle. Container runtime is needed for Testcontainers-based persistence tests. It ships no scripts; it is instructions only.

Spring Boot TDD İş Akışı

80%+ kapsam (unit + integration) ile Spring Boot servisleri için TDD rehberi.

Ne Zaman Kullanılır

Yeni özellikler veya endpoint'ler
Bug düzeltmeleri veya refactoring'ler
Veri erişim mantığı veya güvenlik kuralları ekleme

İş Akışı

Önce testleri yazın (başarısız olmalılar)
Geçmek için minimal kod uygulayın
Testleri yeşil tutarken refactor edin
Kapsamı zorlayın (JaCoCo)

Unit Testler (JUnit 5 + Mockito)

java

@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());  }}

@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());  }}

Desenler:

Arrange-Act-Assert
Kısmi mock'lardan kaçının; açık stubbing tercih edin
Varyantlar için @ParameterizedTest kullanın

Web Katmanı Testleri (MockMvc)

java

@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());  }}

@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());  }}

Entegrasyon Testleri (SpringBootTest)

java

@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());  }}

@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());  }}

Persistence Testleri (DataJpaTest)

java

@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();  }}

@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

Production'ı yansıtmak için Postgres/Redis için yeniden kullanılabilir container'lar kullanın
JDBC URL'lerini Spring context'e enjekte etmek için @DynamicPropertySource ile bağlayın

Kapsam (JaCoCo)

Maven snippet:

xml

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

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

Assertion'lar

Okunabilirlik için AssertJ'yi (assertThat) tercih edin
JSON yanıtları için jsonPath kullanın
Exception'lar için: assertThatThrownBy(...)

Test Veri Builder'ları

java

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

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

CI Komutları

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

Unutmayın: Testleri hızlı, izole ve deterministik tutun. Uygulama detaylarını değil, davranışı test edin.

Source and attribution

Source:affaan-m/ECCindocs/tr/skills/springboot-tddat commitef648e0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Springboot Tdd

Spring Boot TDD İş Akışı

Ne Zaman Kullanılır

İş Akışı

Unit Testler (JUnit 5 + Mockito)

Web Katmanı Testleri (MockMvc)

Entegrasyon Testleri (SpringBootTest)

Persistence Testleri (DataJpaTest)

Testcontainers

Kapsam (JaCoCo)

Assertion'lar

Test Veri Builder'ları

CI Komutları

Source and attribution

More from affaan-m/ECC

Unified Notifications Ops

Verification Loop

Ui To Vue

Unified Memory

Visa Doc Translate

Team Builder

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices