springboot-patterns

此技能作为开发人员使用 Java Spring Boot 构建生产级服务时的综合架构蓝图与实现指南。它提供标准化模式以构建可扩展的后端，确保代码库遵循诸如 Controller-Service-Repository 分层架构等专业惯例。该代理人担任 Spring MVC 与 WebFlux 的技术顾问，协助开发人员将业务需求转化为强大且易于维护的 API 端点，同时遵守严格的验证与安全标准。

• 使用 @RestController、@Validated 与正确的 ResponseEntity 响应结构来设计标准化 REST API。

• Spring Data JPA 的存储库模式实现，包括自定义 @Query 定义与分页/排序配置。

• 强调 @Transactional 边界管理与 Service 到 Repository 编排的服务层设计模式。

• DTO 模式策略，包括映射逻辑、@Valid 注解用法以及使用 Java Records 进行不可变数据传输。

• 通过 @ControllerAdvice 进行全局例外处理，以标准化错误响应并提高 API 可靠性。

• 性能优化技术，包括用于分布式缓存的 @Cacheable/@CacheEvict，以及用于非阻塞异步任务执行的 @Async。

• 生产就绪的可观测性，通过 SLF4J 日志记录、诊断请求日志过滤器，以及用于外部集成调用的重试逻辑。

• 全面的输入处理，结合数据完整性约束、@FutureOrPresent 检查，以及针对内部服务故障的健全错误日志记录。

• 此技能适用于专注于企业级 Java 应用程序的后端工程师与架构师。

• 可用于重构单体服务、实现新微服务，或在团队之间建立一致的代码库风格。

• 在调用特定模式之前，请确保应用程序已具备 JPA、Validation 与 Caching 的必要依赖项目。

• 输入通常涉及领域实体、业务逻辑需求或 API 端点规格；输出为干净且可测试的 Java 代码片段。

• 约束包括需与使用的 Spring Boot 版本保持相容；在实现如 WebFlux 或响应式模式等进阶功能前，请务必确认 Spring Framework 旧版本的相容性。