spring-boot-rest

Spring Boot REST API的模式与规范（控制器、DTO、校验、错误处理）。

SKILL.md

--- frontmatter

name: spring-boot-rest
description: Patterns and conventions for Spring Boot REST APIs (controllers, DTOs, validation, error handling).

When to use

Use this skill when implementing endpoints, request/response DTOs, validation, or exception handling.

Recommended patterns

•
Controllers:
- •@RestController, @RequestMapping("/orders")
- •Separate DTOs from entities (request/response models)
•
Validation:
- •Use @Valid and Jakarta annotations (@NotNull, @DecimalMin)
•
Error handling:
- •Centralized @RestControllerAdvice
- •Return stable JSON error contract
•
Time:
- •Prefer Instant / OffsetDateTime in domain and ISO-8601 in API

Project-specific rules

•API pagination is 1-based (page), internally convert to 0-based for Spring PageRequest
•Enforce limit <= 100
•Filters must be optional and combinable

Commands

•Run: ./gradlew bootRun
•Tests: ./gradlew test