第二章：BeanDefinition介绍

一：什么是BeanDefinition?为什么需要BeanDefinition？

BeanDefinition是一个描述Bean定义的顶层接口。例如Bean是单例还是多例、Bean对象的全类名、Bean是否是懒加载、创建对象需要的属性值等等信息。

但是我们为什么需要BeanDefinition这个顶层接口呢？
因为Bean定义的来源有xml配置文件、java配置类，在springboot时还增加了yml文件。这么一看以后可能还会增加其他定义Bean对象的方式。因此spring的对象工厂也不可能为每一种定义对象方式都去开发一套创建对象的技术。所以spring的开发者就抽象出BeanDefinition这样的顶层规范接口，对象工厂只需要根据BeanDefinition对象里的信息去创建对象。

二：详细介绍BeanDefinition接口

public interface BeanDefinition {

	/**
	 * 单例字符串singleton

	 */
	String SCOPE_SINGLETON = ConfigurableBeanFactory.SCOPE_SINGLETON;

	/**
	 * 原型字符串prototype
	 */
	String SCOPE_PROTOTYPE = ConfigurableBeanFactory.SCOPE_PROTOTYPE;


	/**
	 * 用户自定义bean的角色类型
	 */
	int ROLE_APPLICATION = 0;

	/**
	 * 某些复杂的配置类
	 */
	int ROLE_SUPPORT = 1;

	/**
	 * spring内部使用的bean角色
	 */
	int ROLE_INFRASTRUCTURE = 2;

	/**
	 * 设置父亲对象的名称。注意不能和java里的父类名称混为一谈。
	 */
	void setParentName(@Nullable String parentName);
	String getParentName();

	/**
	 * 设置bean对象的类名称
	 */
	void setBeanClassName(@Nullable String beanClassName);
	String getBeanClassName();

	/**
	 * 设置作用域，是单例还是原型
	 */
	void setScope(@Nullable String scope);
	String getScope();

	/**
	 * 设置是否是懒加载
	 */
	void setLazyInit(boolean lazyInit);
	boolean isLazyInit();

	/**
	 * 设置需要先加载的依赖的类名字数组
	 */
	void setDependsOn(@Nullable String... dependsOn);
	String[] getDependsOn();

	/**
	 * 设置是否适合给其他类做自动装配
	 */
	void setAutowireCandidate(boolean autowireCandidate);
	boolean isAutowireCandidate();

	/**
	 * 设置是否优先自动装配
	 */
	void setPrimary(boolean primary);
	boolean isPrimary();

	/**
	 * 设置FactoryBean的名字
	 */
	void setFactoryBeanName(@Nullable String factoryBeanName);
	
	String getFactoryBeanName();

	/**
	 *设置工厂方法的名称。该方式是使用工厂方法创建对象
	 */
	void setFactoryMethodName(@Nullable String factoryMethodName);
	
	String getFactoryMethodName();

	/**
	 * 获取创建的构造函数的参数
	 */
	ConstructorArgumentValues getConstructorArgumentValues();
	
	default boolean hasConstructorArgumentValues() {
		return !getConstructorArgumentValues().isEmpty();
	}

	/**
	 *获取创建对象的属性值
	 */
	MutablePropertyValues getPropertyValues();

	default boolean hasPropertyValues() {
		return !getPropertyValues().isEmpty();
	}

	/**
	 * 设置初始化方法，对应@PostConstruct
	 */
	void setInitMethodName(@Nullable String initMethodName);
	
	String getInitMethodName();

	/**
	 * 设置销毁方法的名称，对应@PreDestory
	 */
	void setDestroyMethodName(@Nullable String destroyMethodName);

	String getDestroyMethodName();

	/**
	*设置对象角色。可忽略。
	 */
	void setRole(int role);
	
	int getRole();

	ResolvableType getResolvableType();

	/**
	 * 对象是否是单例
	 */
	boolean isSingleton();

	/**
	 *对象是否是多列
	 */
	boolean isPrototype();

	/**
	 *对象是否是抽象类
	 */
	boolean isAbstract();
	
	
	@Nullable
	BeanDefinition getOriginatingBeanDefinition();
}

三：BeanDefinition子类实现介绍

对于bean定义只需要关注AbstractBeanDefinition和AnnotatedBeanDefinition就行。不要太注重与细节。

AbstractBeanDefinition：对BeanDefinition接口进行实现，并进行了扩展。
RootBeanDefinition、GenericBeanDefinition、ChildBeanDefinition是其子类。

AnnotatedBeanDefinition：注解类型的Bean定义。并扩展了注解相关的接口。

public interface AnnotatedBeanDefinition extends BeanDefinition {

	/**
	 * 获取注解的元数据
	 */
	AnnotationMetadata getMetadata();

	/*
	 * 获取工厂方法的元数据
	 */
	@Nullable
	MethodMetadata getFactoryMethodMetadata();
}