参考整理自元宝的回答。
一、Bean声明和管理
| 注解 | 核心作用 | 简要说明 |
|---|---|---|
**@Component** |
通用组件标识 | 最基础的注解,标记一个类为 Spring 组件(Bean),将由 Spring 容器管理其生命周期 |
**@Service** |
业务逻辑层标识 | 特化于服务层(Service Layer),是 @Component的一种,用于标识业务逻辑组件 |
**@Repository** |
数据访问层标识 | 特化于数据访问层(DAO Layer),是 @Component的一种。它还有一个额外好处,会自动转换特定数据访问异常为 Spring 的统一数据访问异常 |
**@Controller** / **@RestController** |
Web 控制层标识 | @Controller用于标记 Spring MVC 的控制器。@RestController是 @Controller和 @ResponseBody的组合,专为 RESTful Web 服务设计,其所有方法的返回值都会直接写入 HTTP 响应体 |
**@Configuration** |
声明配置类 | 标记一个类为配置类,该类内部会包含使用 @Bean注解的方法,用于定义 Bean |
**@Bean** |
方法级别定义Bean | 在配置类的方法上使用,方法的返回值将被注册为 Spring 容器中的一个 Bean |
**@Scope** |
定义Bean的作用域 | 指定 Bean 的作用域,例如单例(singleton)、原型(prototype,每次注入新实例)、请求(request)、会话(session)等 |
**@Lazy** |
延迟初始化 | 标记 Bean 是否应该延迟初始化。设置为 true时,Bean 会在第一次被使用时才创建,而不是在容器启动时 |
**@Primary** |
首选Bean | 当存在多个相同类型的 Bean 候选时,被此注解标记的 Bean 将作为自动注入时的首选 |
| @PostConstruct | 初始化函数 | 自定义初始化函数 |
| @PreDestroy | 销毁函数 | 自定义销毁函数 |
二、依赖注入
| 注解 | 核心作用 | 简要说明 |
|---|---|---|
**@Autowired** |
按类型自动装配 | Spring 提供的注解,用于自动按照类型(byType)注入依赖。可以用在字段、setter 方法或构造函数上 |
**@Qualifier** |
按名称细化装配 | 当有多个同一类型的 Bean 时,配合 @Autowired使用,通过指定 Bean 的名称(byName)来消除歧义 |
**@Resource** |
按名称装配 (JSR-250) | Java 标准注解(JSR-250),默认按名称(byName)进行装配。如果找不到匹配的名称,则会回退到按类型装配 |
**@Value** |
注入简单值/配置 | 用于注入基本数据类型、String、SpEL 表达式结果,或者从配置文件(如 application.properties)中读取属性值 |
三、web
| 注解 | 核心作用 | 简要说明 |
|---|---|---|
**@RequestMapping** |
映射Web请求 | 用于将 HTTP 请求映射到控制器方法上。可以简化其特定 HTTP 方法的变体,如 @GetMapping, @PostMapping等 |
**@RequestBody** |
绑定请求体 | 指示方法参数应该从 HTTP 请求体中绑定,通常用于接收 JSON 或 XML 格式的数据并转换为 Java 对象 |
**@ResponseBody** |
返回值直接作为响应体 | 标记一个方法,其返回值应直接写入 HTTP 响应体,而不是解析为视图名称 |
**@PathVariable** |
提取URL路径变量 | 用于从请求 URI 模板中提取变量值,绑定到方法参数上。例如,URI 模板 /users/{id}中的 {id} |
**@RequestParam** |
提取请求参数 | 用于从 URL 查询字符串或表单数据中提取请求参数,绑定到方法参数上 |
| @RequestHeader | 提取请求头 | 取出请求头中的数据并绑定到参数上 |
**@ControllerAdvice** / **@RestControllerAdvice** |
全局控制器增强 | 用于编写跨所有控制器的全局代码,如全局异常处理(@ExceptionHandler)、数据绑定(@InitBinder) |
四、配置
| 解 | 核心作用 | 简要说明 |
|---|---|---|
**@SpringBootApplication** |
Spring Boot核心注解 | 这是一个组合注解,包含了 @SpringBootConfiguration(允许在上下文中注册额外的 bean 或导入其他配置类)、@EnableAutoConfiguration(启用自动配置)和 @ComponentScan(组件扫描) |
**@EnableAutoConfiguration** |
启用自动配置 | Spring Boot 自动配置机制的核心。它会根据项目的类路径、已存在的 Bean 定义和各种属性设置,尝试自动配置你的应用程序 |
**@Conditional系列** |
条件化配置Bean | 这是一族注解(如 @ConditionalOnClass, @ConditionalOnProperty等),它们根据特定条件(如某个类是否存在、某个属性是否被设置)来决定是否注册 Bean |
**@ConfigurationProperties** |
批量绑定配置属性 | 将配置文件(如 application.properties)中的属性批量绑定到一个带有前缀的 Java Bean 上,实现类型安全的配置 |
**@Profile** |
环境特定配置 | 指定某个 Bean 或配置类仅在特定的环境(Profile,如 "dev", "prod")被激活时才会被注册到容器中 |
**@PropertySource** |
加载属性文件 | 指定要加载的外部属性文件(.properties),将其中的属性添加到 Spring 的 Environment中 |
@Import |
导入类 | 将外部类导入到IOC容器中 |
| @ImportResource | 导入配置文件 | 将xml文件中的配置导入到配置环境中 |
五、AOP、事务与异步
| 注解 | 核心作用 | 简要说明 |
|---|---|---|
**@Transactional** |
声明式事务管理 | 声明一个方法或类需要事务管理。可以配置事务的传播行为、隔离级别、回滚规则等属性 |
**@Aspect** |
声明切面 | 标记一个类为切面,该类包含了通知(Advice)和切点(Pointcut)的定义 |
**@Before/ @After/ @Around等** |
声明通知 | 在切面中定义通知类型,例如 @Before在目标方法执行前执行,@Around环绕目标方法执行 |
**@EnableAsync** |
启用异步执行 | 在配置类上使用,开启对异步任务的支持 |
**@Async** |
标记异步方法 | 标记一个方法为异步执行,该方法将在调用时在一个独立的线程中运行 |