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的组合