java-spring-boot

name	java-spring-boot
description	Build production Spring Boot applications - REST APIs, Security, Data, Actuator
sasmp_version	1.3.0
version	3.0.0
bonded_agent	03-java-spring
bond_type	PRIMARY_BOND
allowed-tools	Read, Write, Bash, Glob, Grep
parameters	{"spring_version":{"type":"string","default":"3.2","description":"Spring Boot version"},"module":{"type":"string","enum":["web","security","data","actuator","cloud"],"description":"Spring module focus"}}

Java Spring Boot Skill

Build production-ready Spring Boot applications with modern best practices.

Overview

This skill covers Spring Boot development including REST APIs, security configuration, data access, actuator monitoring, and cloud integration. Follows Spring Boot 3.x patterns with emphasis on production readiness.

When to Use This Skill

Use when you need to:

• Create REST APIs with Spring MVC/WebFlux
• Configure Spring Security (OAuth2, JWT)
• Set up database access with Spring Data
• Enable monitoring with Actuator
• Integrate with Spring Cloud

Topics Covered

Spring Boot Core

• Auto-configuration and starters
• Application properties and profiles
• Bean lifecycle and configuration
• DevTools and hot reload

REST API Development

• @RestController and @RequestMapping
• Request/response handling
• Validation with Bean Validation
• Exception handling with @ControllerAdvice

Spring Security

• SecurityFilterChain configuration
• OAuth2 and JWT authentication
• Method security (@PreAuthorize)
• CORS and CSRF configuration

Spring Data JPA

• Repository pattern
• Query methods and @Query
• Pagination and sorting
• Auditing and transactions

Actuator & Monitoring

• Health checks and probes
• Metrics with Micrometer
• Custom endpoints
• Prometheus integration

Quick Reference

// REST Controller
@RestController
@RequestMapping("/api/users")
@Validated
public class UserController {

    @GetMapping("/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        return userService.findById(id)
            .map(ResponseEntity::ok)
            .orElse(ResponseEntity.notFound().build());
    }

    @PostMapping
    public ResponseEntity<User> createUser(@Valid @RequestBody UserRequest request) {
        User user = userService.create(request);
        URI location = URI.create("/api/users/" + user.getId());
        return ResponseEntity.created(location).body(user);
    }
}

// Security Configuration
@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        return http
            .csrf(csrf -> csrf.disable())
            .sessionManagement(s -> s.sessionCreationPolicy(STATELESS))
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/actuator/health/**").permitAll()
                .requestMatchers("/api/public/**").permitAll()
                .anyRequest().authenticated())
            .oauth2ResourceServer(oauth2 -> oauth2.jwt(Customizer.withDefaults()))
            .build();
    }
}

// Exception Handler
@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(EntityNotFoundException.class)
    public ProblemDetail handleNotFound(EntityNotFoundException ex) {
        return ProblemDetail.forStatusAndDetail(NOT_FOUND, ex.getMessage());
    }
}

Configuration Templates

# application.yml
spring:
  application:
    name: ${APP_NAME:my-service}
  profiles:
    active: ${SPRING_PROFILES_ACTIVE:local}
  jpa:
    open-in-view: false
    properties:
      hibernate:
        jdbc.batch_size: 50

management:
  endpoints:
    web:
      exposure:
        include: health,info,metrics,prometheus
  endpoint:
    health:
      probes:
        enabled: true

server:
  error:
    include-stacktrace: never

Common Patterns

Layer Architecture

Controller → Service → Repository → Database
     ↓           ↓          ↓
   DTOs      Entities    Entities

Validation Patterns

public record CreateUserRequest(
    @NotBlank @Size(max = 100) String name,
    @Email @NotBlank String email,
    @NotNull @Min(18) Integer age
) {}

Troubleshooting

Common Issues

Problem	Cause	Solution
Bean not found	Missing @Component	Add annotation or @Bean
Circular dependency	Constructor injection	Use @Lazy or refactor
401 Unauthorized	Security config	Check permitAll paths
Slow startup	Heavy auto-config	Exclude unused starters

Debug Properties

debug=true
logging.level.org.springframework.security=DEBUG
spring.jpa.show-sql=true

Debug Checklist

□ Check /actuator/conditions
□ Verify active profiles
□ Review security filter chain
□ Check bean definitions
□ Test health endpoints

Usage

Skill("java-spring-boot")

Related Skills

• java-testing - Spring test patterns
• java-jpa-hibernate - Data access