Spring学习之路-注解

时间:2022-05-10 07:59:28

  Spring的注解总结。

  地址:https://docs.spring.io/spring/docs/4.3.12.RELEASE/spring-framework-reference/htmlsingle/

1、标记注解

@Configuration

定义:标记该类作为一个特殊配置类,可以理解为xml文件中的<beans></beans>

Tip:内部@bean注解方法返回的实例为完全体

原文:Annotating a class with @Configuration indicates that its primary purpose is as a source of bean definitions.

@ComponentScan

定义:与@Configuration配合使用,默认将此类的包作为根,自动扫描目录下所有注解,可以理解为<context:component-scan/>

Tip:<context:component-scan>隐式的声明了<context:annotation-config>,所以只需声明一个

原文:To autodetect these classes and register the corresponding beans, you need to add @ComponentScan to your @Configuration class

@EnableAutoConfiguration

定义:让SpringBoot根据引入的jar包,决定用对应方式来进行初始化操作

原文:This annotation tells Spring Boot to “guess” how you will want to configure Spring, based on the jar dependencies that you have added.

@Profile

定义:描述性注解,仅当条件满足时激活类

原文:The @Profile annotation allows you to indicate that a component is eligible for registration when one or more specified profiles are active.

2、类注解

@Component

定义:注明该类会被Spring管理,属于一般性注解

原文:@Component is a generic stereotype for any Spring-managed component.

@Service、@Controller、@Repository

定义:与@Component作用相同,区别在于语义化

原文:@Repository@Service, and @Controller are specializations of @Component for more specific use cases

@Named、@ManagedBean

定义:分别来自于JS-R330、JSR-250,作用与Component类似,可以自定义名字

Tip:JSR-330注解不支持组合注解

@scope

定义:辅助注解,指定类的作用域

Tip:JSR-330的类注解默认scope为'prototype',为了保持一致,Spring将其默认设置为'singleton'

@Qualifier

定义:辅助注解,指定类的id(name)

@ImportResource

定义:引入外部配置文件,配合@Value可以进行配置初始化

3、实例方法注解

@Bean

定义:该注解作用于一个方法,方法必须实例化一个类并交给IOC容器管理,功能类似于xml配置文件中的<bean/>

Tip:若方法所在的类未被注解为@configuration,则返回lite状态的类,此时不允许实例化中引用其他类

原文:The @Bean annotation is used to indicate that a method instantiates, configures and initializes a new object to be managed by the Spring IoC container.

@Description

定义:对@Bean的描述

原文:it is helpful to provide a more detailed textual description of a bean.

@value

定义:用于对类中实例变量进行初始化赋值

4、基于依赖的方法注解

@Resource

定义:来源于JSR-250,默认通过name注入,失败退化为type

@Inject

定义:来源于JSR-330,默认通过type注入,失败退化为name

Tip:可用Java8的optional,等价于required

@Autowired

定义:Spring自定义注解,功能类似于@inject

Tip:可用required表示该依赖是否必须赋值

5、组合注解

@SpringBootApplication

定义:该注解等价于@Configuration、@EnableAutoConfiguration、@ComponentScan三个注解的组合

原文:The @SpringBootApplication annotation is equivalent to using @Configuration@EnableAutoConfiguration and @ComponentScan with their default attributes.

@RestController

定义:该注解等价于@ResponseBody、@Controller的组合