Springboot Tdd

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

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

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

AI 產生的概覽

指導 Spring Boot 服務的測試驅動開發,使用 JUnit 5、Mockito、MockMvc、Testcontainers 與 JaCoCo。

功能
此技能為 Spring Boot 服務提供 TDD 工作流程,涵蓋先撰寫失敗測試、實作最小程式碼、重構,以及強制覆蓋率。它提供單元測試(JUnit 5 與 Mockito)、Web 層測試(MockMvc)、整合測試(SpringBootTest)與持久化測試(DataJpaTest 與 Testcontainers)的範例測試模式。它也包含 JaCoCo 的 Maven 設定、斷言建議、測試資料建構器,以及 Maven 與 Gradle 的 CI 指令。
適用情境
適用於在 Spring Boot 專案中新增功能或端點、修正錯誤、重構,或加入資料存取邏輯與安全規則時。它適合希望採用結構化 TDD 方法並達到 80% 以上單元與整合覆蓋率的開發者。
執行需求
需要一個 Spring Boot 專案,包含 Java、JUnit 5、Mockito、MockMvc、Testcontainers、JaCoCo,以及 Maven 或 Gradle 等建置工具。以 Testcontainers 為基礎的持久化測試需要容器執行環境。此技能不附帶指令碼,僅為說明文件。

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

  1. Önce testleri yazın (başarısız olmalılar)
  2. Geçmek için minimal kod uygulayın
  3. Testleri yeşil tutarken refactor edin
  4. 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());  }}

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

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

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

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>

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

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.

來源與署名

來源:affaan-m/ECC位於docs/tr/skills/springboot-tdd提交ef648e0

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架