注解说明
Indicates that a class declares one or more {@link Bean @Bean} methods and may be processed by the Spring container to generate bean definitions and service requests for those beans at runtime
被@Configuration标注的类是配置类,该情况下为full模式。
被@Component、@ComponentScan、@Import、@ImportResource 标注或者内有@Bean标注的方法也是配置类,该情况下为lite模式。
full模式:
1.该模式下,配置类会被CGLIB增强(生成代理对象),放进IoC容器内的是代理
2.该模式下,配置类内部可以通过方法调用来处理依赖,并且能够保证是同一个实例,都指向IoC内的那个单例
3.该模式下,@Bean方法不能被private/final等进行修饰,因为代理类需要重写这个方法
lite模式
1.该模式下,配置类本身不会被CGLIB增强,放进IoC容器内的就是类本身
2. 该模式下,配置类内部不能通过方法调用来处理依赖,否则每次生成的都是一个新实例而并非IoC容器内的单例
3. 该模式下,配置类就是一普通类,所以@Bean方法可以使用private/final等进行修饰
属性说明
/**
* 映射为Component的value属性
*/
@AliasFor(annotation = Component.class)
String value() default "";
使用示例
@Configuration
static class DatabaseConfig {
@Bean
DataSource dataSource() {
return new EmbeddedDatabaseBuilder().build();
}
}
相关源码
ConfigurationClassUtils
/** 判断一个类是不是配置类 */
public static boolean isConfigurationCandidate(AnnotationMetadata metadata) {
return (isFullConfigurationCandidate(metadata) || isLiteConfigurationCandidate(metadata));
}
/** 判断一个类是不是full模式的配置类 */
public static boolean isFullConfigurationCandidate(AnnotationMetadata metadata) {
return metadata.isAnnotated(Configuration.class.getName());
}
/** 判断一个类是不是lite模式的配置类 */
public static boolean isLiteConfigurationCandidate(AnnotationMetadata metadata) {
// Do not consider an interface or an annotation...
// 被标注的对象不能是接口
if (metadata.isInterface()) {
return false;
}
// Any of the typical annotations found?
// 标注的注解是否包含 Component、ComponentScan、Import、ImportResource 中的一个,如果是则认为是lite模式
for (String indicator : candidateIndicators) {
if (metadata.isAnnotated(indicator)) {
return true;
}
}
// Finally, let's look for @Bean methods...
// 如果没有被上述注解标注,但是内部有@Bean注解,那也是lite模式
try {
return metadata.hasAnnotatedMethods(Bean.class.getName());
}
catch (Throwable ex) {
if (logger.isDebugEnabled()) {
logger.debug("Failed to introspect @Bean methods on class [" + metadata.getClassName() + "]: " + ex);
}
return false;
}
}