springboot-patterns

name	springboot-patterns
description	Spring Boot patterns for REST API design, layered controller-service-repository structure, Spring Data JPA, caching, async processing, and logging. USE WHEN building Java Spring Boot backends, structuring services, configuring data access or caching, or adding validation, exception handling, or event-driven patterns.
cluster	jvm
version	1.0.0

Spring Boot Development Patterns

Spring Boot architecture and API patterns for scalable, production-grade services.

When to Activate

• Building REST APIs with Spring MVC or WebFlux
• Structuring controller → service → repository layers
• Configuring Spring Data JPA, caching, or async processing
• Adding validation, exception handling, or pagination
• Setting up profiles for dev/staging/production environments
• Implementing event-driven patterns with Spring Events or Kafka

REST API Structure

@RestController
@RequestMapping("/api/markets")
@Validated
class MarketController {
  private final MarketService marketService;

  MarketController(MarketService marketService) {
    this.marketService = marketService;
  }

  
  ResponseEntity<Page<MarketResponse>>  {
    Page<Market> markets = marketService.list(PageRequest.of(page, size));
     ResponseEntity.ok(markets.map(MarketResponse::from));
  }

  
  ResponseEntity<MarketResponse>  {
       marketService.create(request);
     ResponseEntity.status(HttpStatus.CREATED).body(MarketResponse.from(market));
  }
}