spring-context注解系列四——@Configuration

注解说明

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;
		}
	}