package org.springframework.beans.factory;
/**
spring ioc 的核心接口，从配置资源(eg: XML)中加载Bean定义并提供对Bean操作的基础方法
Bean：由一个String类型字符串唯一标识的java对象
Bean的作用域（scope)：
Protorype：对于某个Bean定义只有一个实例
Singleton：对于某个Bean定义存在多个实例

本接口中的方法支持分层结构，也就是说对于继承了HierarchicalBeanFactory的Factory，可以使用本接口
中的方法找到父工厂中的Bean，如Bean同名则覆盖

支持使用Aware接口
*/
public interface BeanFactory {
/**
    获取类型为FactoryBean的对象时，在BeanName前加上&会获取到该对象本身的引用，
    否则会获取调用该对象的getObject方法
*/
    String FACTORY_BEAN_PREFIX = "&";

/**
    返回指定BeanName（或别名）的Bean
    对Protorype：每次返回不同的实例
    对Singleton：每次返回相同的实例
*/
    Object getBean(String name) throws BeansException;

/**
    返回同时匹配指定BeanName（或别名）和类型的Bean
    对Protorype：每次返回不同的实例
    对Singleton：每次返回相同的实例
*/
    <T> T getBean(String name, Class<T> requiredType) throws BeansException;

/**
    返回指定BeanName（或别名）的Bean，并把所提供的参数作为构造函数参数或工厂方法参数初始化Bean
    对Protorype：每次返回不同的实例
    对Singleton：抛出BeanDefinitionStoreException异常
*/
    Object getBean(String name, Object... args) throws BeansException;

/**
    返回指定类型的Bean，如果存在多个bean定义有相同的类型，则抛NoUniqueBeanDefinitionException异常
    对Protorype：每次返回不同的实例
    对Singleton：每次返回相同的实例
        <不知道啥意思>This method goes into {@link ListableBeanFactory} by-type lookup territory
      but may also be translated into a conventional by-name lookup based on the name
      of the given type. For more extensive retrieval operations across sets of beans,
      use {@link ListableBeanFactory} and/or {@link BeanFactoryUtils}<?>
*/
    <T> T getBean(Class<T> requiredType) throws BeansException;

/**
    返回指定类型的Bean，并把所提供的参数作为构造函数参数或工厂方法参数初始化Bean
    对Protorype：每次返回不同的实例
    对Singleton：抛出BeanDefinitionStoreException异常
*/
    <T> T getBean(Class<T> requiredType, Object... args) throws BeansException;

/**
    返回一个ObjectProvider<T>该类型允许对Bean处于not available情况和not-unique情况时做处理
*/
    <T> ObjectProvider<T> getBeanProvider(Class<T> requiredType);

/**
    作用同上
*/
    <T> ObjectProvider<T> getBeanProvider(ResolvableType requiredType);

/**
    根据指定的BeanName或别名判断factory是否包含bean定义(concrete
     or abstract, lazy or eager, in scope or not)或由外部注册的单例，
    返回true时并不保证一定能通过getBean获取相应实例（eg: 抽象Bean）
*/
    boolean containsBean(String name);

/**
    根据指定的BeanName或别名判断factory中该Bean的scope是否是Singleton
    返回false时不代表scope是prototype(使用自定义的scope时）
*/
    boolean isSingleton(String name) throws NoSuchBeanDefinitionException;

/**
    根据指定的BeanName或别名判断factory中该Bean的scope是否是Prototype
    返回false时不代表scope是Singleton(使用自定义的scope时）
*/
    boolean isPrototype(String name) throws NoSuchBeanDefinitionException;

/**
    根据指定的BeanName或别名判断factory中该Bean的类型是否与提供的类型匹配
*/
    boolean isTypeMatch(String name, ResolvableType typeToMatch) throws NoSuchBeanDefinitionException;

/**
    根据指定的BeanName或别名判断factory中该Bean的类型是否与提供的类型匹配
*/
    boolean isTypeMatch(String name, Class<?> typeToMatch) throws NoSuchBeanDefinitionException;

/**
    根据指定的BeanName或别名获取factory中该Bean的类型，对于FactoryBean类型，将调用它的
    getObjectType()
*/
    @Nullable
    Class<?> getType(String name) throws NoSuchBeanDefinitionException;

/**
    根据指定的BeanName或别名返回factory中该Bean的别名，
    如果提供的时别名将返回BeanName和其他别名的数组，BeanName
    置与第一个元素
*/
    String[] getAliases(String name);

}