Spring源码之IOC（四）BeanFactory派生类

1 概述

从前面的文章（Spring源码之IOC（三）BeanFactory源码分析）我们学习到BeanFactory提供了Spring bean容器的基础入口，也就是我们可以通过BeanFactory来获取到bean。而其子类通过扩展BeanFactory来提供了更加丰富的功能，接下来我们就来看一看子类到底提供了哪些功能。

2 UML类图

3 派生类详解

3.1 HierarchicalBeanFactory

接口是BeanFactory继承层次结构中的一部分，包含两个函数。

/**
 * 返回父bean工厂.
 */
@Nullable
BeanFactory getParentBeanFactory();

/**
 * 返回当前bean工厂是否有指定名称的bean。
 * 注意：这里仅仅是当前bean工厂，不包含父bean工厂。
 */
boolean containsLocalBean(String name);

3.2 ListableBeanFactory

这个接口可以用于枚举出bean工厂的所有bean实例，而不是根据客户端的需要按照名称查找。
预加载所有bean定义(如基于xml的工厂)的BeanFactory实现可以实现此接口。
我们来看一下这个bean工厂接口包含那些具体的函数。

/**
 * 检测bean工厂是否包含指定名称的bean.这里需要注意的是：不考虑bean工厂参与的任何层次结构，并且忽略通过bean定义以外的其他方式注册的单列bean。
 */
boolean containsBeanDefinition(String beanName);

/**
 * 返回bean工厂中的bean定义的数量，这里需要排除的内容和上面的函数一样。
 */
int getBeanDefinitionCount();

/**
 * 返回bean工厂下所有bean定义的名称，这里需要排除的内容和上面的函数一样。
 */
String[] getBeanDefinitionNames();

/**
 * 返回匹配类型（包括子类）的bean的名称，从bean定义或FactoryBeans中{@code getObjectType}的值判断。
 */
String[] getBeanNamesForType(ResolvableType type);

/**
 * 返回匹配类型（包括子类）的bean的名称，从bean定义或FactoryBeans中{@code getObjectType}的值判断。
 */
String[] getBeanNamesForType(@Nullable Class<?> type);

 /**
 * 返回匹配类型（包括子类）的bean的名称，从bean定义或FactoryBeans中{@code getObjectType}的值判断。
 */
String[] getBeanNamesForType(@Nullable Class<?> type, boolean includeNonSingletons, boolean allowEagerInit);

 /**
 * 返回匹配类型（包括子类）的bean，从bean定义或FactoryBeans中{@code getObjectType}的值判断。
 */
<T> Map<String, T> getBeansOfType(@Nullable Class<T> type) throws BeansException;

/**
 * 返回匹配类型（包括子类）的bean，从bean定义或FactoryBeans中{@code getObjectType}的值判断。
 */
<T> Map<String, T> getBeansOfType(@Nullable Class<T> type, boolean includeNonSingletons, boolean allowEagerInit)
		throws BeansException;

/**
 * 查询所有类上使用了指定注释的bean名称，并且这些bean没有创建任何实例
 */
String[] getBeanNamesForAnnotation(Class<? extends Annotation> annotationType);

/**
 * 查询所有类上使用了指定注释的bean。返回的是一个bean的实例和名称的键值对
 * 
 */
Map<String, Object> getBeansWithAnnotation(Class<? extends Annotation> annotationType) throws BeansException;

 /**
  * 返回bean上指定类型的类注释，如果没有就遍历其实现的接口或者父类。
  */
@Nullable
<A extends Annotation> A findAnnotationOnBean(String beanName, Class<A> annotationType)
		throws NoSuchBeanDefinitionException;