Springboot Tdd

affaan-m/ECC/docs/ja-JP/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 工作流:先编写失败的测试,再实现最小代码,然后重构,并用 JaCoCo 强制覆盖率。它给出多种测试示例模式,包括 JUnit 5 与 Mockito 的单元测试、MockMvc 的 Web 层测试、SpringBootTest 的集成测试,以及 DataJpaTest 与 Testcontainers 的持久化测试。内容还涉及断言风格、测试数据构建器以及 Maven 或 Gradle 的 CI 命令。
适用场景
适用于在 Spring Boot 服务中新增功能或端点、修复缺陷、重构,或添加数据访问与安全规则逻辑时。面向希望在实现之前先写测试、并以至少 80% 覆盖率为目标的团队。
运行要求
需要带有 JUnit 5、Mockito、MockMvc、Testcontainers 和 JaCoCo 的 Spring Boot 项目,以及 Maven 或 Gradle。Testcontainers 需要 Docker 等容器运行时。该技能不附带脚本,仅为说明与代码示例。

Spring Boot TDD ワークフロー

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

いつ使用するか

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

ワークフロー

  1. テストを最初に書く(失敗すべき)
  2. テストを通すための最小限のコードを実装
  3. テストをグリーンに保ちながらリファクタリング
  4. カバレッジを強制(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());  }}

パターン:

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

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

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

  • 本番環境を反映するために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>

アサーション

  • 可読性のために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); }}

CIコマンド

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

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

来源与署名

来源:affaan-m/ECC位于docs/ja-JP/skills/springboot-tdd提交ef648e0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架