Spring Boot TDD ワークフロー は何をしますか？
Spring Boot サービス向けの TDD ガイダンス（単体テスト + 統合テストで 80% 以上のカバレッジを目標）。
使用すべきタイミング
- 新機能やエンドポイントの追加
- バグ修正やリファクタリング
- データアクセスロジックやセキュリティルールの追加
ワークフロー
- テストを先に書く（失敗することを確認）
- テストを通すための最小限のコードを実装
- テストがグリーンの状態でリファクタリング
- カバレッジを強化する（JaCoCo）
単体テスト（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());
}
}
パターン:
- Arrange-Act-Assert
- 部分的なモックは避け、明示的なスタブを優先
- バリエーションには
@ParameterizedTestを使用
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());
}
}
統合テスト（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());
}
}
永続化テスト（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
- Postgres/Redis には再利用可能なコンテナを使用し、本番環境を模倣
@DynamicPropertySourceを介して JDBC URL を Spring コンテキストに注入
カバレッジ（JaCoCo）
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>
アサーション
- 可読性のために AssertJ（
assertThat）を推奨 - JSON レスポンスには
jsonPathを使用 - 例外に対しては
assertThatThrownBy(...)を使用
テストデータビルダー
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
注意: テストは高速で、独立しており、決定論的に保ってください。実装の詳細ではなく、振る舞いをテストしてください。