mcpField
3
322-frameworks-spring-boot-testing-integration-tests

322-frameworks-spring-boot-testing-integration-tests

github.com/jabrenaTesting & quality456363 installsUpdated 1d ago
Repository

About 322-frameworks-spring-boot-testing-integration-tests

A skill for applying Spring Boot 4.0.x integration testing practices in Java projects. It covers test scope, container-backed services, HTTP and persistence testing, and requires compilation before changes and full verification afterward.

Key features

  1. 01Testcontainers with @ServiceConnection
  2. 02@DynamicPropertySource as a fallback
  3. 03MockMvcTester and TestRestTemplate HTTP tests
  4. 04Persistence slices with @DataJdbcTest or @DataJpaTest
  5. 05Isolated test data and resource lifecycle guidance

Use cases

  1. 01Write @SpringBootTest tests with Testcontainers
  2. 02Test HTTP endpoints or the full HTTP stack
  3. 03Test persistence with focused Spring slices

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jabrena/plinth --skill 322-frameworks-spring-boot-testing-integration-tests

After installing, type/322-frameworks-spring-boot-testing-integration-testsin Claude Code to confirm it loaded.

Bundled filesreferences/322-frameworks-spring-boot-testing-integration-tests.md

Details

From the project README

Spring Boot Integration Testing

Apply Spring Boot integration testing guidelines for Spring Boot 4.0.x.

What is covered in this Skill?

  • Integration test scope and purpose (verify wiring and contracts, not unit-test duplication)
  • Testcontainers with @ServiceConnection for zero-config wiring (preferred)
  • @DynamicPropertySource as fallback for containers without built-in service connection support
  • Static @Container instances shared across test methods for performance
  • MockMvcTester for fluent AssertJ-based HTTP assertions (Spring Boot 4.0.x)
  • TestRestTemplate for full HTTP stack testing
  • @DataJdbcTest / @DataJpaTest persistence slices (load only persistence layer, start faster)
  • Data isolation: each test owns its scenario; no shared mutable state or ordering assumptions
  • @MockitoBean for mock registration (Spring Boot 4.0.x — @MockBean removed)
  • Resource lifecycle: Testcontainers JUnit integration for teardown; *IT / integration test separation

Scope: Apply recommendations based on the reference rules and good/bad code examples.

Constraints

Before applying any integration test changes, ensure the project compiles. If compilation fails, stop immediately. After applying improvements, run full verification.

  • MANDATORY: Run ./mvnw compile or mvn compile before applying any change
  • SAFETY: If compilation fails, stop immediately
  • VERIFY: Run ./mvnw clean verify or mvn clean verify after applying improvements
  • BEFORE APPLYING: Read the reference for detailed rules and good/bad patterns
  • EDGE CASE: If request scope is ambiguous, stop and ask a clarifying question before applying changes
  • EDGE CASE: If required inputs, files, or tooling are missing, report what is missing and ask whether to proceed with setup guidance

When to use this skill

  • Review Java code for Spring Boot integration tests
  • Apply best practices for Spring Boot integration tests in Java code
  • Write @SpringBootTest integration tests with Testcontainers
  • Configure dynamic properties for Spring integration tests
  • Review Spring Boot integration test profiles

Workflow

  1. Read reference and assess project context

Read references/322-frameworks-spring-boot-testing-integration-tests.md and inspect the current project setup before proposing changes.

  1. Gather scope and decide target improvements

Identify requested outcomes, constraints, and the minimum safe set of changes to apply.

  1. Apply framework-aligned changes

Implement or refactor configuration/code following the reference patterns and project conventions.

  1. Run verification and report results

Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.

Reference

For detailed guidance, examples, and constraints, see references/322-frameworks-spring-boot-testing-integration-tests.md.

Comments

Markdown supported