【小家Spring】Spring IoC容器中核心定义之------BeanDefinition深入分析（RootBeanDefinition、ChildBeanDefinition...）（上）

// 接口都比较简单  就是定义了对对象属性的一些访问方法
//说明它可以持有Bean元数据元素，作用是可以持有XML文件的一个bean标签对应的Object（或者@Configuration元配置对象）
public interface AttributeAccessor {
  void setAttribute(String name, @Nullable Object value);
  @Nullable
  Object getAttribute(String name);
  @Nullable
  Object removeAttribute(String name);
  boolean hasAttribute(String name);
  String[] attributeNames();
}

//接口提供了一个getResource()方法,用来传输一个可配置的源对象。
public interface BeanMetadataElement {
  /**
   * Return the configuration source {@code Object} for this metadata element
   * (may be {@code null}).
   * 返回元数据元素配置元对象
   */
  @Nullable
  Object getSource();
}

public interface BeanDefinition extends AttributeAccessor, BeanMetadataElement {
  // 单例Bean还是原型Bean
  String SCOPE_SINGLETON = ConfigurableBeanFactory.SCOPE_SINGLETON;
  String SCOPE_PROTOTYPE = ConfigurableBeanFactory.SCOPE_PROTOTYPE;
  // Bean角色
  int ROLE_APPLICATION = 0; //应用程序重要组成部分
  int ROLE_SUPPORT = 1; //做为大量配置的一部分（支持、扩展类）  实际上就是说，我这个Bean是用户的，是从配置文件中过来的。
  int ROLE_INFRASTRUCTURE = 2; //指内部工作的基础构造  实际上是说我这Bean是Spring自己的，和你用户没有一毛钱关系
  // Modifiable attributes
  //parent definition（若存在父类的话，就设置进去）
  void setParentName(@Nullable String parentName);
  @Nullable
  String getParentName();
  // 指定Class类型。需要注意的是该类型还有可能被改变在Bean post-processing阶段
  // 若是getFactoryBeanName  getFactoryMethodName这种情况下会改变
  void setBeanClassName(@Nullable String beanClassName);
  @Nullable
  String getBeanClassName();
  //SCOPE_SINGLETON或者SCOPE_PROTOTYPE两种
  void setScope(@Nullable String scope);
  @Nullable
  String getScope();
  // @Lazy 是否需要懒加载（默认都是立马加载的）
  void setLazyInit(boolean lazyInit);
  boolean isLazyInit();
  // 此Bean定义需要依赖的Bean（显然可以有多个）
  void setDependsOn(@Nullable String... dependsOn);
  @Nullable
  String[] getDependsOn();
  // 这个Bean是否允许被自动注入到别的地方去（默认都是被允许的）
  // 注意：此标志只影响按类型装配，不影响byName的注入方式的~~~~
  void setAutowireCandidate(boolean autowireCandidate);
  boolean isAutowireCandidate();
  // 是否是首选的  @Primary
  void setPrimary(boolean primary);
  boolean isPrimary();
  // 指定使用的工厂Bean（若存在）的名称~
  void setFactoryBeanName(@Nullable String factoryBeanName);
  @Nullable
  String getFactoryBeanName();
  //指定工厂方法~
  void setFactoryMethodName(@Nullable String factoryMethodName);
  @Nullable
  String getFactoryMethodName();
  // 获取此Bean的构造函数参数值们  ConstructorArgumentValues：持有构造函数们的 
  // 绝大多数情况下是空对象 new ConstructorArgumentValues出来的一个对象
  // 当我们Scan实例化Bean的时候，可能用到它的非空构造，这里就会有对应的值了，然后后面就会再依赖注入了
  ConstructorArgumentValues getConstructorArgumentValues();
  default boolean hasConstructorArgumentValues() {
    return !getConstructorArgumentValues().isEmpty();
  }
  // 获取普通属性集合~~~~
  MutablePropertyValues getPropertyValues();
  default boolean hasPropertyValues() {
    return !getPropertyValues().isEmpty();
  }
  // Read-only attributes
  boolean isSingleton();
  boolean isPrototype();
  boolean isAbstract();
  // 对应上面的role的值
  int getRole();
  //@Description
  @Nullable
  String getDescription();
  // 返回该Bean定义来自于的资源的描述（用于在出现错误时显示上下文）
  @Nullable
  String getResourceDescription();
  //返回原始BeanDefinition，如果没有则返回@null
  // 若这个Bean定义被代理、修饰过  这个方法可以返回原始的
  @Nullable
  BeanDefinition getOriginatingBeanDefinition();
}

public interface AnnotatedBeanDefinition extends BeanDefinition {
  //获取该bean definition的注解元数据
  AnnotationMetadata getMetadata();
  //@since 4.1.1
  //Obtain metadata for this bean definition's factory method（如果不存在就返回null）
  @Nullable
  MethodMetadata getFactoryMethodMetadata();
}