Back to Details

301-frameworks-spring-boot-core

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Spring Boot Core Guidelines

Spring Boot 核心指南

Apply Spring Boot Core guidelines for annotations, bean management, configuration, and dependency injection.
What is covered in this Skill?
  • @SpringBootApplication and main application class
  • Component annotations: @RestController, @Service, @Repository
  • Bean definition, scoping, lifecycle
  • Configuration classes and @ConfigurationProperties (with @Validated for fail-fast startup)
  • Component scanning and package organization
  • Conditional configuration and profiles (@Profile, @ConditionalOn*)
  • Constructor dependency injection
  • @Primary and @Qualifier for disambiguation when multiple beans share a type
  • Bean minimization and composition
  • Graceful shutdown for in-flight work
  • Virtual threads on supported stacks for concurrency-bound workloads
  • Jakarta EE namespace consistency (jakarta.* preferred; avoid mixing legacy javax.annotation / javax.validation)
  • Scheduled tasks and background processing
Scope: Apply recommendations based on the reference rules and good/bad code examples.
应用Spring Boot核心指南，涵盖注解、Bean管理、配置和依赖注入。
本技能包含哪些内容？
  • @SpringBootApplication与主应用类
  • 组件注解：@RestController、@Service、@Repository
  • Bean定义、作用域、生命周期
  • 配置类与@ConfigurationProperties（结合@Validated实现启动快速失败）
  • 组件扫描与包结构组织
  • 条件配置与Profiles（@Profile、@ConditionalOn*）
  • 构造函数依赖注入
  • 同类型多Bean歧义消除的@Primary与@Qualifier
  • Bean最小化与组合
  • 针对进行中任务的优雅停机
  • 针对并发绑定工作负载，在支持的栈上使用虚拟线程
  • Jakarta EE命名空间一致性（优先使用jakarta.*；避免混合使用旧版javax.annotation / javax.validation）
  • 定时任务与后台处理
范围： 基于参考规则和代码示例的优劣来应用建议。

Constraints

约束条件

Before applying any Spring Boot changes, ensure the project compiles. If compilation fails, stop immediately. After applying improvements, run full verification.
  • MANDATORY: Run 
    ./mvnw compile
    or 
    mvn compile
    before applying any change
  • SAFETY: If compilation fails, stop immediately — compilation failure is a blocking condition
  • VERIFY: Run 
    ./mvnw clean verify
    or 
    mvn clean verify
    after applying improvements
  • BEFORE APPLYING: Read the reference for detailed rules, good/bad patterns, and constraints
在进行任何Spring Boot修改之前，确保项目可以编译。如果编译失败，立即停止。在应用改进后，运行完整验证。
  • 强制要求：在进行任何修改前运行
    ./mvnw compile
    或
    mvn compile
  • 安全要求：如果编译失败，立即停止——编译失败是阻塞性条件
  • 验证要求：在应用改进后运行
    ./mvnw clean verify
    或
    mvn clean verify
  • 应用前须知：阅读参考文档以了解详细规则、优劣模式和约束条件

When to use this skill

何时使用本技能

  • Review Java code for Spring Boot application
  • Apply best practices for Spring Boot application in Java code
  • 审查Spring Boot应用的Java代码
  • 在Java代码中应用Spring Boot应用的最佳实践

Reference

参考资料

For detailed guidance, examples, and constraints, see references/301-frameworks-spring-boot-core.md.
如需详细指导、示例和约束条件，请查看references/301-frameworks-spring-boot-core.md。