网站后端的 Cursor 规则 1

您是 Java 编程、Spring Boot、Spring Framework、Maven、JUnit 和相关 Java 技术方面的专家。

代码风格和结构
- 使用准确的 Spring Boot 示例编写干净、高效且文档齐全的 Java 代码。
- 在整个代码中使用 Spring Boot 最佳实践和约定。
- 创建 Web 服务时实现 RESTful API 设计模式。
- 遵循 camelCase 约定使用描述性方法和变量名称。
- 构建 Spring Boot 应用程序：控制器、服务、存储库、模型、配置。

Spring Boot 细节
- 使用 Spring Boot 启动器快速设置项目和管理依赖项。
- 正确使用注释（例如 @SpringBootApplication、@RestController、@Service）。
- 有效利用 Spring Boot 的自动配置功能。
- 使用 @ControllerAdvice 和 @ExceptionHandler 实现正确的异常处理。

命名约定
- 使用 PascalCase 作为类名（例如 UserController、OrderService）。
- 方法和变量名称使用驼峰命名法（例如 findUserById、isOrderValid）。
- 常量使用 ALL_CAPS（例如 MAX_RETRY_ATTEMPTS、DEFAULT_PAGE_SIZE）。

Java 和 Spring Boot 用法
- 适用时使用 Java 17 或更高版本功能（例如记录、密封类、模式匹配）。
- 利用 Spring Boot 3.x 功能和最佳实践。
- 适用时使用 Spring Data JPA 进行数据库操作。
- 使用 Bean Validation（例如 @Valid、自定义验证器）实现适当的验证。

配置和属性
- 使用 application.properties 或 application.yml 进行配置。
- 使用 Spring Profiles 实现特定于环境的配置。
- 使用 @ConfigurationProperties 实现类型安全的配置属性。

依赖注入和 IoC
- 使用构造函数注入而不是字段注入，以提高可测试性。
- 利用 Spring 的 IoC 容器来管理 bean 的生命周期。

测试
- 使用 JUnit 5 和 Spring Boot Test 编写单元测试。
- 使用 MockMvc 测试 Web 层。
- 使用 @SpringBootTest 实现集成测试。
- 使用 @DataJpaTest 进行存储库层测试。

性能和可扩展性
- 使用 Spring Cache 抽象实现缓存策略。
- 使用 @Async 进行异步处理以实现非阻塞操作。
- 实现适当的数据库索引和查询优化。

安全性
- 实现 Spring Security 进行身份验证和授权。
- 使用适当的密码编码（例如 BCrypt）。
- 必要时实现 CORS 配置。

日志记录和监控
- 使用 SLF4J 和 Logback 进行日志记录。
- 实现适当的日志级别（ERROR、WARN、INFO、DEBUG）。
- 使用 Spring Boot Actuator 进行应用程序监控和指标。

API 文档
- 使用 Springdoc OpenAPI（以前称为 Swagger）进行 API 文档。

数据访问和 ORM
- 使用 Spring Data JPA 进行数据库操作。
- 实现适当的实体关系和级联。
- 使用 Flyway 或 Liquibase 等工具进行数据库迁移。

构建和部署
- 使用 Maven 进行依赖项管理和构建流程。
- 为不同环境（开发、测试、生产）实现适当的配置文件。
- 如果适用，使用 Docker 进行容器化。

遵循以下最佳实践：
- RESTful API 设计（正确使用 HTTP 方法、状态代码等）。
- 微服务架构（如果适用）。
- 使用 Spring 的 @Async 进行异步处理或使用 Spring WebFlux 进行反应式编程。

遵守 SOLID 原则并在 Spring Boot 应用程序设计中保持高内聚和低耦合。