Springboot Tdd

affaan-m/ECC/docs/ja-JP/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: Provides a TDD workflow for Spring Boot: write a failing test first, implement minimal code, refactor, and enforce coverage with JaCoCo. 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 covers assertion style, test data builders, and Maven or Gradle CI commands.
When to use it: Use it when adding new features or endpoints, fixing bugs, refactoring, or adding data-access and security-rule logic in a Spring Boot service. It targets teams wanting tests written before implementation with a coverage target of at least 80%.
Requirements: A Spring Boot project with JUnit 5, Mockito, MockMvc, Testcontainers and JaCoCo, plus Maven or Gradle. Testcontainers requires a container runtime such as Docker. No scripts ship with the skill; it is instructions and code examples only.

Spring Boot TDD ワークフロー

80%以上のカバレッジ（ユニット+統合）を持つSpring Bootサービスのためのテスト駆動開発ガイダンス。

いつ使用するか

新機能やエンドポイント
バグ修正やリファクタリング
データアクセスロジックやセキュリティルールの追加

ワークフロー

テストを最初に書く（失敗すべき）
テストを通すための最小限のコードを実装
テストをグリーンに保ちながらリファクタリング
カバレッジを強制（JaCoCo）

ユニットテスト（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());  }}

パターン:

Arrange-Act-Assert
部分モックを避ける。明示的なスタビングを優先
バリエーションに@ParameterizedTestを使用

Webレイヤーテスト（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());  }}

統合テスト（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());  }}

永続化テスト（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

本番環境を反映するためにPostgres/Redis用の再利用可能なコンテナを使用
@DynamicPropertySource経由でJDBC URLをSpringコンテキストに注入

カバレッジ（JaCoCo）

Mavenスニペット:

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>

アサーション

可読性のためにAssertJ（assertThat）を優先
JSONレスポンスにはjsonPathを使用
例外には: assertThatThrownBy(...)

テストデータビルダー

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コマンド

Maven: mvn -T 4 test または mvn verify
Gradle: ./gradlew test jacocoTestReport

覚えておいてください: テストは高速で、分離され、決定論的に保ちます。実装の詳細ではなく、動作をテストします。

Source and attribution

Source:affaan-m/ECCindocs/ja-JP/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 ワークフロー

いつ使用するか

ワークフロー

ユニットテスト（JUnit 5 + Mockito）

Webレイヤーテスト（MockMvc）

統合テスト（SpringBootTest）

永続化テスト（DataJpaTest）

Testcontainers

カバレッジ（JaCoCo）

アサーション

テストデータビルダー

CIコマンド

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