类 AbstractBeanFactory

构造器详细资料

• AbstractBeanFactory

  public AbstractBeanFactory()

  Create a new AbstractBeanFactory.

• AbstractBeanFactory

  public AbstractBeanFactory​(BeanFactory parentBeanFactory)

  Create a new AbstractBeanFactory with the given parent.

  参数:

  parentBeanFactory - parent bean factory, or null if none

  另请参阅:

  getBean(java.lang.String)

方法详细资料

• getBean

  public Object getBean​(String name)
                 throws BeansException

  从接口复制的说明: BeanFactory
  Return an instance, which may be shared or independent, of the specified bean.

  This method allows a Spring BeanFactory to be used as a replacement for the Singleton or Prototype design pattern. Callers may retain references to returned objects in the case of Singleton beans.

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  getBean 在接口中 BeanFactory

  参数:

  name - the name of the bean to retrieve

  返回:

  an instance of the bean

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the specified name

  BeansException - if the bean could not be obtained

• getBean

  public <T> T getBean​(String name,
                       Class<T> requiredType)
                throws BeansException

  从接口复制的说明: BeanFactory
  Return an instance, which may be shared or independent, of the specified bean.

  Behaves the same as BeanFactory.getBean(String), but provides a measure of type safety by throwing a BeanNotOfRequiredTypeException if the bean is not of the required type. This means that ClassCastException can't be thrown on casting the result correctly, as can happen with BeanFactory.getBean(String).

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  getBean 在接口中 BeanFactory

  参数:

  name - the name of the bean to retrieve

  requiredType - type the bean must match. Can be an interface or superclass of the actual class, or null for any match. For example, if the value is Object.class, this method will succeed whatever the class of the returned instance.

  返回:

  an instance of the bean

  抛出:

  NoSuchBeanDefinitionException - if there is no such bean definition

  BeanNotOfRequiredTypeException - if the bean is not of the required type

  BeansException - if the bean could not be created

• getBean

  public Object getBean​(String name,
                        Object... args)
                 throws BeansException

  从接口复制的说明: BeanFactory
  Return an instance, which may be shared or independent, of the specified bean.

  Allows for specifying explicit constructor arguments / factory method arguments, overriding the specified default arguments (if any) in the bean definition.

  指定者:

  getBean 在接口中 BeanFactory

  参数:

  name - the name of the bean to retrieve

  args - arguments to use when creating a bean instance using explicit arguments (only applied when creating a new instance as opposed to retrieving an existing one)

  返回:

  an instance of the bean

  抛出:

  NoSuchBeanDefinitionException - if there is no such bean definition

  BeanDefinitionStoreException - if arguments have been given but the affected bean isn't a prototype

  BeansException - if the bean could not be created

• getBean

  public <T> T getBean​(String name,
                       Class<T> requiredType,
                       Object... args)
                throws BeansException

  Return an instance, which may be shared or independent, of the specified bean.

  参数:

  name - the name of the bean to retrieve

  requiredType - the required type of the bean to retrieve

  args - arguments to use when creating a bean instance using explicit arguments (only applied when creating a new instance as opposed to retrieving an existing one)

  返回:

  an instance of the bean

  抛出:

  BeansException - if the bean could not be created

• doGetBean

  protected <T> T doGetBean​(String name,
                            Class<T> requiredType,
                            Object[] args,
                            boolean typeCheckOnly)
                     throws BeansException

  Return an instance, which may be shared or independent, of the specified bean.

  参数:

  name - the name of the bean to retrieve

  requiredType - the required type of the bean to retrieve

  args - arguments to use when creating a bean instance using explicit arguments (only applied when creating a new instance as opposed to retrieving an existing one)

  typeCheckOnly - whether the instance is obtained for a type check, not for actual use

  返回:

  an instance of the bean

  抛出:

  BeansException - if the bean could not be created

• containsBean

  public boolean containsBean​(String name)

  从接口复制的说明: BeanFactory
  Does this bean factory contain a bean definition or externally registered singleton instance with the given name?

  If the given name is an alias, it will be translated back to the corresponding canonical bean name.

  If this factory is hierarchical, will ask any parent factory if the bean cannot be found in this factory instance.

  If a bean definition or singleton instance matching the given name is found, this method will return true whether the named bean definition is concrete or abstract, lazy or eager, in scope or not. Therefore, note that a true return value from this method does not necessarily indicate that BeanFactory.getBean(java.lang.String) will be able to obtain an instance for the same name.

  指定者:

  containsBean 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  返回:

  whether a bean with the given name is present

• isSingleton

  public boolean isSingleton​(String name)
                      throws NoSuchBeanDefinitionException

  从接口复制的说明: BeanFactory
  Is this bean a shared singleton? That is, will BeanFactory.getBean(java.lang.String) always return the same instance?

  Note: This method returning false does not clearly indicate independent instances. It indicates non-singleton instances, which may correspond to a scoped bean as well. Use the BeanFactory.isPrototype(java.lang.String) operation to explicitly check for independent instances.

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  isSingleton 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  返回:

  whether this bean corresponds to a singleton instance

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  另请参阅:

  BeanFactory.getBean(java.lang.String), BeanFactory.isPrototype(java.lang.String)

• isPrototype

  public boolean isPrototype​(String name)
                      throws NoSuchBeanDefinitionException

  从接口复制的说明: BeanFactory
  Is this bean a prototype? That is, will BeanFactory.getBean(java.lang.String) always return independent instances?

  Note: This method returning false does not clearly indicate a singleton object. It indicates non-independent instances, which may correspond to a scoped bean as well. Use the BeanFactory.isSingleton(java.lang.String) operation to explicitly check for a shared singleton instance.

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  isPrototype 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  返回:

  whether this bean will always deliver independent instances

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  另请参阅:

  BeanFactory.getBean(java.lang.String), BeanFactory.isSingleton(java.lang.String)

• isTypeMatch

  public boolean isTypeMatch​(String name,
                             ResolvableType typeToMatch)
                      throws NoSuchBeanDefinitionException

  从接口复制的说明: BeanFactory
  Check whether the bean with the given name matches the specified type. More specifically, check whether a BeanFactory.getBean(java.lang.String) call for the given name would return an object that is assignable to the specified target type.

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  isTypeMatch 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  typeToMatch - the type to match against (as a ResolvableType)

  返回:

  true if the bean type matches, false if it doesn't match or cannot be determined yet

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  另请参阅:

  BeanFactory.getBean(java.lang.String), BeanFactory.getType(java.lang.String)

• isTypeMatch

  public boolean isTypeMatch​(String name,
                             Class<?> typeToMatch)
                      throws NoSuchBeanDefinitionException

  从接口复制的说明: BeanFactory
  Check whether the bean with the given name matches the specified type. More specifically, check whether a BeanFactory.getBean(java.lang.String) call for the given name would return an object that is assignable to the specified target type.

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  isTypeMatch 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  typeToMatch - the type to match against (as a Class)

  返回:

  true if the bean type matches, false if it doesn't match or cannot be determined yet

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  另请参阅:

  BeanFactory.getBean(java.lang.String), BeanFactory.getType(java.lang.String)

• getType

  public Class<?> getType​(String name)
                   throws NoSuchBeanDefinitionException

  从接口复制的说明: BeanFactory
  Determine the type of the bean with the given name. More specifically, determine the type of object that BeanFactory.getBean(java.lang.String) would return for the given name.

  For a FactoryBean, return the type of object that the FactoryBean creates, as exposed by FactoryBean.getObjectType().

  Translates aliases back to the corresponding canonical bean name. Will ask the parent factory if the bean cannot be found in this factory instance.

  指定者:

  getType 在接口中 BeanFactory

  参数:

  name - the name of the bean to query

  返回:

  the type of the bean, or null if not determinable

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  另请参阅:

  BeanFactory.getBean(java.lang.String), BeanFactory.isTypeMatch(java.lang.String, org.springframework.core.ResolvableType)

• getAliases

  public String[] getAliases​(String name)

  从接口复制的说明: AliasRegistry
  Return the aliases for the given name, if defined.

  指定者:

  getAliases 在接口中 AliasRegistry

  指定者:

  getAliases 在接口中 BeanFactory

  覆盖:

  getAliases 在类中 SimpleAliasRegistry

  参数:

  name - the name to check for aliases

  返回:

  the aliases, or an empty array if none

  另请参阅:

  BeanFactory.getBean(java.lang.String)

• getParentBeanFactory

  public BeanFactory getParentBeanFactory()

  从接口复制的说明: HierarchicalBeanFactory
  Return the parent bean factory, or null if there is none.

  指定者:

  getParentBeanFactory 在接口中 HierarchicalBeanFactory

• containsLocalBean

  public boolean containsLocalBean​(String name)

  从接口复制的说明: HierarchicalBeanFactory
  Return whether the local bean factory contains a bean of the given name, ignoring beans defined in ancestor contexts.

  This is an alternative to containsBean, ignoring a bean of the given name from an ancestor bean factory.

  指定者:

  containsLocalBean 在接口中 HierarchicalBeanFactory

  参数:

  name - the name of the bean to query

  返回:

  whether a bean with the given name is defined in the local factory

  另请参阅:

  BeanFactory.containsBean(java.lang.String)

• setParentBeanFactory

  public void setParentBeanFactory​(BeanFactory parentBeanFactory)

  从接口复制的说明: ConfigurableBeanFactory
  Set the parent of this bean factory.

  Note that the parent cannot be changed: It should only be set outside a constructor if it isn't available at the time of factory instantiation.

  指定者:

  setParentBeanFactory 在接口中 ConfigurableBeanFactory

  参数:

  parentBeanFactory - the parent BeanFactory

  另请参阅:

  HierarchicalBeanFactory.getParentBeanFactory()

• setBeanClassLoader

  public void setBeanClassLoader​(ClassLoader beanClassLoader)

  从接口复制的说明: ConfigurableBeanFactory
  Set the class loader to use for loading bean classes. Default is the thread context class loader.

  Note that this class loader will only apply to bean definitions that do not carry a resolved bean class yet. This is the case as of Spring 2.0 by default: Bean definitions only carry bean class names, to be resolved once the factory processes the bean definition.

  指定者:

  setBeanClassLoader 在接口中 ConfigurableBeanFactory

  参数:

  beanClassLoader - the class loader to use, or null to suggest the default class loader

• getBeanClassLoader

  public ClassLoader getBeanClassLoader()

  从接口复制的说明: ConfigurableBeanFactory
  Return this factory's class loader for loading bean classes.

  指定者:

  getBeanClassLoader 在接口中 ConfigurableBeanFactory

• setTempClassLoader

  public void setTempClassLoader​(ClassLoader tempClassLoader)

  从接口复制的说明: ConfigurableBeanFactory
  Specify a temporary ClassLoader to use for type matching purposes. Default is none, simply using the standard bean ClassLoader.

  A temporary ClassLoader is usually just specified if load-time weaving is involved, to make sure that actual bean classes are loaded as lazily as possible. The temporary loader is then removed once the BeanFactory completes its bootstrap phase.

  指定者:

  setTempClassLoader 在接口中 ConfigurableBeanFactory

• getTempClassLoader

  public ClassLoader getTempClassLoader()

  从接口复制的说明: ConfigurableBeanFactory
  Return the temporary ClassLoader to use for type matching purposes, if any.

  指定者:

  getTempClassLoader 在接口中 ConfigurableBeanFactory

• setCacheBeanMetadata

  public void setCacheBeanMetadata​(boolean cacheBeanMetadata)

  从接口复制的说明: ConfigurableBeanFactory
  Set whether to cache bean metadata such as given bean definitions (in merged fashion) and resolved bean classes. Default is on.

  Turn this flag off to enable hot-refreshing of bean definition objects and in particular bean classes. If this flag is off, any creation of a bean instance will re-query the bean class loader for newly resolved classes.

  指定者:

  setCacheBeanMetadata 在接口中 ConfigurableBeanFactory

• isCacheBeanMetadata

  public boolean isCacheBeanMetadata()

  从接口复制的说明: ConfigurableBeanFactory
  Return whether to cache bean metadata such as given bean definitions (in merged fashion) and resolved bean classes.

  指定者:

  isCacheBeanMetadata 在接口中 ConfigurableBeanFactory

• setBeanExpressionResolver

  public void setBeanExpressionResolver​(BeanExpressionResolver resolver)

  从接口复制的说明: ConfigurableBeanFactory
  Specify the resolution strategy for expressions in bean definition values.

  There is no expression support active in a BeanFactory by default. An ApplicationContext will typically set a standard expression strategy here, supporting "#{...}" expressions in a Unified EL compatible style.

  指定者:

  setBeanExpressionResolver 在接口中 ConfigurableBeanFactory

• getBeanExpressionResolver

  public BeanExpressionResolver getBeanExpressionResolver()

  从接口复制的说明: ConfigurableBeanFactory
  Return the resolution strategy for expressions in bean definition values.

  指定者:

  getBeanExpressionResolver 在接口中 ConfigurableBeanFactory

• setConversionService

  public void setConversionService​(ConversionService conversionService)

  从接口复制的说明: ConfigurableBeanFactory
  Specify a Spring 3.0 ConversionService to use for converting property values, as an alternative to JavaBeans PropertyEditors.

  指定者:

  setConversionService 在接口中 ConfigurableBeanFactory

• getConversionService

  public ConversionService getConversionService()

  从接口复制的说明: ConfigurableBeanFactory
  Return the associated ConversionService, if any.

  指定者:

  getConversionService 在接口中 ConfigurableBeanFactory

• addPropertyEditorRegistrar

  public void addPropertyEditorRegistrar​(PropertyEditorRegistrar registrar)

  从接口复制的说明: ConfigurableBeanFactory
  Add a PropertyEditorRegistrar to be applied to all bean creation processes.

  Such a registrar creates new PropertyEditor instances and registers them on the given registry, fresh for each bean creation attempt. This avoids the need for synchronization on custom editors; hence, it is generally preferable to use this method instead of ConfigurableBeanFactory.registerCustomEditor(java.lang.Class<?>, java.lang.Class<? extends java.beans.PropertyEditor>).

  指定者:

  addPropertyEditorRegistrar 在接口中 ConfigurableBeanFactory

  参数:

  registrar - the PropertyEditorRegistrar to register

• getPropertyEditorRegistrars

  public Set<PropertyEditorRegistrar> getPropertyEditorRegistrars()

  Return the set of PropertyEditorRegistrars.

• registerCustomEditor

  public void registerCustomEditor​(Class<?> requiredType,
                                   Class<? extends PropertyEditor> propertyEditorClass)

  从接口复制的说明: ConfigurableBeanFactory
  Register the given custom property editor for all properties of the given type. To be invoked during factory configuration.

  Note that this method will register a shared custom editor instance; access to that instance will be synchronized for thread-safety. It is generally preferable to use ConfigurableBeanFactory.addPropertyEditorRegistrar(org.springframework.beans.PropertyEditorRegistrar) instead of this method, to avoid for the need for synchronization on custom editors.

  指定者:

  registerCustomEditor 在接口中 ConfigurableBeanFactory

  参数:

  requiredType - type of the property

  propertyEditorClass - the PropertyEditor class to register

• copyRegisteredEditorsTo

  public void copyRegisteredEditorsTo​(PropertyEditorRegistry registry)

  从接口复制的说明: ConfigurableBeanFactory
  Initialize the given PropertyEditorRegistry with the custom editors that have been registered with this BeanFactory.

  指定者:

  copyRegisteredEditorsTo 在接口中 ConfigurableBeanFactory

  参数:

  registry - the PropertyEditorRegistry to initialize

• getCustomEditors

  public Map<Class<?>,​Class<? extends PropertyEditor>> getCustomEditors()

  Return the map of custom editors, with Classes as keys and PropertyEditor classes as values.

• setTypeConverter

  public void setTypeConverter​(TypeConverter typeConverter)

  从接口复制的说明: ConfigurableBeanFactory
  Set a custom type converter that this BeanFactory should use for converting bean property values, constructor argument values, etc.

  This will override the default PropertyEditor mechanism and hence make any custom editors or custom editor registrars irrelevant.

  指定者:

  setTypeConverter 在接口中 ConfigurableBeanFactory

  另请参阅:

  ConfigurableBeanFactory.addPropertyEditorRegistrar(org.springframework.beans.PropertyEditorRegistrar), ConfigurableBeanFactory.registerCustomEditor(java.lang.Class<?>, java.lang.Class<? extends java.beans.PropertyEditor>)

• getCustomTypeConverter

  protected TypeConverter getCustomTypeConverter()

  Return the custom TypeConverter to use, if any.

  返回:

  the custom TypeConverter, or null if none specified

• getTypeConverter

  public TypeConverter getTypeConverter()

  从接口复制的说明: ConfigurableBeanFactory
  Obtain a type converter as used by this BeanFactory. This may be a fresh instance for each call, since TypeConverters are usually not thread-safe.

  If the default PropertyEditor mechanism is active, the returned TypeConverter will be aware of all custom editors that have been registered.

  指定者:

  getTypeConverter 在接口中 ConfigurableBeanFactory

• addEmbeddedValueResolver

  public void addEmbeddedValueResolver​(StringValueResolver valueResolver)

  从接口复制的说明: ConfigurableBeanFactory
  Add a String resolver for embedded values such as annotation attributes.

  指定者:

  addEmbeddedValueResolver 在接口中 ConfigurableBeanFactory

  参数:

  valueResolver - the String resolver to apply to embedded values

• hasEmbeddedValueResolver

  public boolean hasEmbeddedValueResolver()

  从接口复制的说明: ConfigurableBeanFactory
  Determine whether an embedded value resolver has been registered with this bean factory, to be applied through ConfigurableBeanFactory.resolveEmbeddedValue(String).

  指定者:

  hasEmbeddedValueResolver 在接口中 ConfigurableBeanFactory

• resolveEmbeddedValue

  public String resolveEmbeddedValue​(String value)

  从接口复制的说明: ConfigurableBeanFactory
  Resolve the given embedded value, e.g. an annotation attribute.

  指定者:

  resolveEmbeddedValue 在接口中 ConfigurableBeanFactory

  参数:

  value - the value to resolve

  返回:

  the resolved value (may be the original value as-is)

• addBeanPostProcessor

  public void addBeanPostProcessor​(BeanPostProcessor beanPostProcessor)

  从接口复制的说明: ConfigurableBeanFactory
  Add a new BeanPostProcessor that will get applied to beans created by this factory. To be invoked during factory configuration.

  Note: Post-processors submitted here will be applied in the order of registration; any ordering semantics expressed through implementing the Ordered interface will be ignored. Note that autodetected post-processors (e.g. as beans in an ApplicationContext) will always be applied after programmatically registered ones.

  指定者:

  addBeanPostProcessor 在接口中 ConfigurableBeanFactory

  参数:

  beanPostProcessor - the post-processor to register

• getBeanPostProcessorCount

  public int getBeanPostProcessorCount()

  从接口复制的说明: ConfigurableBeanFactory
  Return the current number of registered BeanPostProcessors, if any.

  指定者:

  getBeanPostProcessorCount 在接口中 ConfigurableBeanFactory

• getBeanPostProcessors

  public List<BeanPostProcessor> getBeanPostProcessors()

  Return the list of BeanPostProcessors that will get applied to beans created with this factory.

• hasInstantiationAwareBeanPostProcessors

  protected boolean hasInstantiationAwareBeanPostProcessors()

  Return whether this factory holds a InstantiationAwareBeanPostProcessor that will get applied to singleton beans on creation.

  另请参阅:

  addBeanPostProcessor(org.springframework.beans.factory.config.BeanPostProcessor), InstantiationAwareBeanPostProcessor

• hasDestructionAwareBeanPostProcessors

  protected boolean hasDestructionAwareBeanPostProcessors()

  Return whether this factory holds a DestructionAwareBeanPostProcessor that will get applied to singleton beans on shutdown.

  另请参阅:

  addBeanPostProcessor(org.springframework.beans.factory.config.BeanPostProcessor), DestructionAwareBeanPostProcessor

• registerScope

  public void registerScope​(String scopeName,
                            Scope scope)

  从接口复制的说明: ConfigurableBeanFactory
  Register the given scope, backed by the given Scope implementation.

  指定者:

  registerScope 在接口中 ConfigurableBeanFactory

  参数:

  scopeName - the scope identifier

  scope - the backing Scope implementation

• getRegisteredScopeNames

  public String[] getRegisteredScopeNames()

  从接口复制的说明: ConfigurableBeanFactory
  Return the names of all currently registered scopes.

  This will only return the names of explicitly registered scopes. Built-in scopes such as "singleton" and "prototype" won't be exposed.

  指定者:

  getRegisteredScopeNames 在接口中 ConfigurableBeanFactory

  返回:

  the array of scope names, or an empty array if none

  另请参阅:

  ConfigurableBeanFactory.registerScope(java.lang.String, org.springframework.beans.factory.config.Scope)

• getRegisteredScope

  public Scope getRegisteredScope​(String scopeName)

  从接口复制的说明: ConfigurableBeanFactory
  Return the Scope implementation for the given scope name, if any.

  This will only return explicitly registered scopes. Built-in scopes such as "singleton" and "prototype" won't be exposed.

  指定者:

  getRegisteredScope 在接口中 ConfigurableBeanFactory

  参数:

  scopeName - the name of the scope

  返回:

  the registered Scope implementation, or null if none

  另请参阅:

  ConfigurableBeanFactory.registerScope(java.lang.String, org.springframework.beans.factory.config.Scope)

• setSecurityContextProvider

  public void setSecurityContextProvider​(SecurityContextProvider securityProvider)

  Set the security context provider for this bean factory. If a security manager is set, interaction with the user code will be executed using the privileged of the provided security context.

• getAccessControlContext

  public AccessControlContext getAccessControlContext()

  Delegate the creation of the access control context to the SecurityContextProvider.

  指定者:

  getAccessControlContext 在接口中 ConfigurableBeanFactory

  覆盖:

  getAccessControlContext 在类中 FactoryBeanRegistrySupport

  返回:

  the applicable AccessControlContext (never null)

  另请参阅:

  AccessController.getContext()

• copyConfigurationFrom

  public void copyConfigurationFrom​(ConfigurableBeanFactory otherFactory)

  从接口复制的说明: ConfigurableBeanFactory
  Copy all relevant configuration from the given other factory.

  Should include all standard configuration settings as well as BeanPostProcessors, Scopes, and factory-specific internal settings. Should not include any metadata of actual bean definitions, such as BeanDefinition objects and bean name aliases.

  指定者:

  copyConfigurationFrom 在接口中 ConfigurableBeanFactory

  参数:

  otherFactory - the other BeanFactory to copy from

• getMergedBeanDefinition

  public BeanDefinition getMergedBeanDefinition​(String name)
                                         throws BeansException

  Return a 'merged' BeanDefinition for the given bean name, merging a child bean definition with its parent if necessary.

  This getMergedBeanDefinition considers bean definition in ancestors as well.

  指定者:

  getMergedBeanDefinition 在接口中 ConfigurableBeanFactory

  参数:

  name - the name of the bean to retrieve the merged definition for (may be an alias)

  返回:

  a (potentially merged) RootBeanDefinition for the given bean

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  BeanDefinitionStoreException - in case of an invalid bean definition

  NoSuchBeanDefinitionException - if there is no bean definition with the given name

  BeansException

• isFactoryBean

  public boolean isFactoryBean​(String name)
                        throws NoSuchBeanDefinitionException

  从接口复制的说明: ConfigurableBeanFactory
  Determine whether the bean with the given name is a FactoryBean.

  指定者:

  isFactoryBean 在接口中 ConfigurableBeanFactory

  参数:

  name - the name of the bean to check

  返回:

  whether the bean is a FactoryBean (false means the bean exists but is not a FactoryBean)

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

• isActuallyInCreation

  public boolean isActuallyInCreation​(String beanName)

  覆盖:

  isActuallyInCreation 在类中 DefaultSingletonBeanRegistry

• isPrototypeCurrentlyInCreation

  protected boolean isPrototypeCurrentlyInCreation​(String beanName)

  Return whether the specified prototype bean is currently in creation (within the current thread).

  参数:

  beanName - the name of the bean

• beforePrototypeCreation

  protected void beforePrototypeCreation​(String beanName)

  Callback before prototype creation.

  The default implementation register the prototype as currently in creation.

  参数:

  beanName - the name of the prototype about to be created

  另请参阅:

  isPrototypeCurrentlyInCreation(java.lang.String)

• afterPrototypeCreation

  protected void afterPrototypeCreation​(String beanName)

  Callback after prototype creation.

  The default implementation marks the prototype as not in creation anymore.

  参数:

  beanName - the name of the prototype that has been created

  另请参阅:

  isPrototypeCurrentlyInCreation(java.lang.String)

• destroyBean

  public void destroyBean​(String beanName,
                          Object beanInstance)

  从接口复制的说明: ConfigurableBeanFactory
  Destroy the given bean instance (usually a prototype instance obtained from this factory) according to its bean definition.

  Any exception that arises during destruction should be caught and logged instead of propagated to the caller of this method.

  指定者:

  destroyBean 在接口中 ConfigurableBeanFactory

  参数:

  beanName - the name of the bean definition

  beanInstance - the bean instance to destroy

• destroyBean

  protected void destroyBean​(String beanName,
                             Object bean,
                             RootBeanDefinition mbd)

  Destroy the given bean instance (usually a prototype instance obtained from this factory) according to the given bean definition.

  参数:

  beanName - the name of the bean definition

  bean - the bean instance to destroy

  mbd - the merged bean definition

• destroyScopedBean

  public void destroyScopedBean​(String beanName)

  从接口复制的说明: ConfigurableBeanFactory
  Destroy the specified scoped bean in the current target scope, if any.

  Any exception that arises during destruction should be caught and logged instead of propagated to the caller of this method.

  指定者:

  destroyScopedBean 在接口中 ConfigurableBeanFactory

  参数:

  beanName - the name of the scoped bean

• transformedBeanName

  protected String transformedBeanName​(String name)

  Return the bean name, stripping out the factory dereference prefix if necessary, and resolving aliases to canonical names.

  参数:

  name - the user-specified name

  返回:

  the transformed bean name

• originalBeanName

  protected String originalBeanName​(String name)

  Determine the original bean name, resolving locally defined aliases to canonical names.

  参数:

  name - the user-specified name

  返回:

  the original bean name

• initBeanWrapper

  protected void initBeanWrapper​(BeanWrapper bw)

  Initialize the given BeanWrapper with the custom editors registered with this factory. To be called for BeanWrappers that will create and populate bean instances.

  The default implementation delegates to registerCustomEditors(org.springframework.beans.PropertyEditorRegistry). Can be overridden in subclasses.

  参数:

  bw - the BeanWrapper to initialize

• registerCustomEditors

  protected void registerCustomEditors​(PropertyEditorRegistry registry)

  Initialize the given PropertyEditorRegistry with the custom editors that have been registered with this BeanFactory.

  To be called for BeanWrappers that will create and populate bean instances, and for SimpleTypeConverter used for constructor argument and factory method type conversion.

  参数:

  registry - the PropertyEditorRegistry to initialize

• getMergedLocalBeanDefinition

  protected RootBeanDefinition getMergedLocalBeanDefinition​(String beanName)
                                                     throws BeansException

  Return a merged RootBeanDefinition, traversing the parent bean definition if the specified bean corresponds to a child bean definition.

  参数:

  beanName - the name of the bean to retrieve the merged definition for

  返回:

  a (potentially merged) RootBeanDefinition for the given bean

  抛出:

  NoSuchBeanDefinitionException - if there is no bean with the given name

  BeanDefinitionStoreException - in case of an invalid bean definition

  BeansException

• getMergedBeanDefinition

  protected RootBeanDefinition getMergedBeanDefinition​(String beanName,
                                                       BeanDefinition bd)
                                                throws BeanDefinitionStoreException

  Return a RootBeanDefinition for the given top-level bean, by merging with the parent if the given bean's definition is a child bean definition.

  参数:

  beanName - the name of the bean definition

  bd - the original bean definition (Root/ChildBeanDefinition)

  返回:

  a (potentially merged) RootBeanDefinition for the given bean

  抛出:

  BeanDefinitionStoreException - in case of an invalid bean definition

• getMergedBeanDefinition

  protected RootBeanDefinition getMergedBeanDefinition​(String beanName,
                                                       BeanDefinition bd,
                                                       BeanDefinition containingBd)
                                                throws BeanDefinitionStoreException

  Return a RootBeanDefinition for the given bean, by merging with the parent if the given bean's definition is a child bean definition.

  参数:

  beanName - the name of the bean definition

  bd - the original bean definition (Root/ChildBeanDefinition)

  containingBd - the containing bean definition in case of inner bean, or null in case of a top-level bean

  返回:

  a (potentially merged) RootBeanDefinition for the given bean

  抛出:

  BeanDefinitionStoreException - in case of an invalid bean definition

• checkMergedBeanDefinition

  protected void checkMergedBeanDefinition​(RootBeanDefinition mbd,
                                           String beanName,
                                           Object[] args)
                                    throws BeanDefinitionStoreException

  Check the given merged bean definition, potentially throwing validation exceptions.

  参数:

  mbd - the merged bean definition to check

  beanName - the name of the bean

  args - the arguments for bean creation, if any

  抛出:

  BeanDefinitionStoreException - in case of validation failure

• clearMergedBeanDefinition

  protected void clearMergedBeanDefinition​(String beanName)

  Remove the merged bean definition for the specified bean, recreating it on next access.

  参数:

  beanName - the bean name to clear the merged definition for

• clearMetadataCache

  public void clearMetadataCache()

  Clear the merged bean definition cache, removing entries for beans which are not considered eligible for full metadata caching yet.

  Typically triggered after changes to the original bean definitions, e.g. after applying a BeanFactoryPostProcessor. Note that metadata for beans which have already been created at this point will be kept around.

  从以下版本开始:

  4.2

• resolveBeanClass

  protected Class<?> resolveBeanClass​(RootBeanDefinition mbd,
                                      String beanName,
                                      Class<?>... typesToMatch)
                               throws CannotLoadBeanClassException

  Resolve the bean class for the specified bean definition, resolving a bean class name into a Class reference (if necessary) and storing the resolved Class in the bean definition for further use.

  参数:

  mbd - the merged bean definition to determine the class for

  beanName - the name of the bean (for error handling purposes)

  typesToMatch - the types to match in case of internal type matching purposes (also signals that the returned Class will never be exposed to application code)

  返回:

  the resolved bean class (or null if none)

  抛出:

  CannotLoadBeanClassException - if we failed to load the class

• evaluateBeanDefinitionString

  protected Object evaluateBeanDefinitionString​(String value,
                                                BeanDefinition beanDefinition)

  Evaluate the given String as contained in a bean definition, potentially resolving it as an expression.

  参数:

  value - the value to check

  beanDefinition - the bean definition that the value comes from

  返回:

  the resolved value

  另请参阅:

  setBeanExpressionResolver(org.springframework.beans.factory.config.BeanExpressionResolver)

• predictBeanType

  protected Class<?> predictBeanType​(String beanName,
                                     RootBeanDefinition mbd,
                                     Class<?>... typesToMatch)

  Predict the eventual bean type (of the processed bean instance) for the specified bean. Called by getType(java.lang.String) and isTypeMatch(java.lang.String, org.springframework.core.ResolvableType). Does not need to handle FactoryBeans specifically, since it is only supposed to operate on the raw bean type.

  This implementation is simplistic in that it is not able to handle factory methods and InstantiationAwareBeanPostProcessors. It only predicts the bean type correctly for a standard bean. To be overridden in subclasses, applying more sophisticated type detection.

  参数:

  beanName - the name of the bean

  mbd - the merged bean definition to determine the type for

  typesToMatch - the types to match in case of internal type matching purposes (also signals that the returned Class will never be exposed to application code)

  返回:

  the type of the bean, or null if not predictable

• isFactoryBean

  protected boolean isFactoryBean​(String beanName,
                                  RootBeanDefinition mbd)

  Check whether the given bean is defined as a FactoryBean.

  参数:

  beanName - the name of the bean

  mbd - the corresponding bean definition

• getTypeForFactoryBean

  protected Class<?> getTypeForFactoryBean​(String beanName,
                                           RootBeanDefinition mbd)

  Determine the bean type for the given FactoryBean definition, as far as possible. Only called if there is no singleton instance registered for the target bean already.

  The default implementation creates the FactoryBean via getBean to call its getObjectType method. Subclasses are encouraged to optimize this, typically by just instantiating the FactoryBean but not populating it yet, trying whether its getObjectType method already returns a type. If no type found, a full FactoryBean creation as performed by this implementation should be used as fallback.

  参数:

  beanName - the name of the bean

  mbd - the merged bean definition for the bean

  返回:

  the type for the bean if determinable, or null otherwise

  另请参阅:

  FactoryBean.getObjectType(), getBean(String)

• markBeanAsCreated

  protected void markBeanAsCreated​(String beanName)

  Mark the specified bean as already created (or about to be created).

  This allows the bean factory to optimize its caching for repeated creation of the specified bean.

  参数:

  beanName - the name of the bean

• cleanupAfterBeanCreationFailure

  protected void cleanupAfterBeanCreationFailure​(String beanName)

  Perform appropriate cleanup of cached metadata after bean creation failed.

  参数:

  beanName - the name of the bean

• isBeanEligibleForMetadataCaching

  protected boolean isBeanEligibleForMetadataCaching​(String beanName)

  Determine whether the specified bean is eligible for having its bean definition metadata cached.

  参数:

  beanName - the name of the bean

  返回:

  true if the bean's metadata may be cached at this point already

• removeSingletonIfCreatedForTypeCheckOnly

  protected boolean removeSingletonIfCreatedForTypeCheckOnly​(String beanName)

  Remove the singleton instance (if any) for the given bean name, but only if it hasn't been used for other purposes than type checking.

  参数:

  beanName - the name of the bean

  返回:

  true if actually removed, false otherwise

• hasBeanCreationStarted

  protected boolean hasBeanCreationStarted()

  Check whether this factory's bean creation phase already started, i.e. whether any bean has been marked as created in the meantime.

  从以下版本开始:

  4.2.2

  另请参阅:

  markBeanAsCreated(java.lang.String)

• getObjectForBeanInstance

  protected Object getObjectForBeanInstance​(Object beanInstance,
                                            String name,
                                            String beanName,
                                            RootBeanDefinition mbd)

  Get the object for the given bean instance, either the bean instance itself or its created object in case of a FactoryBean.

  参数:

  beanInstance - the shared bean instance

  name - name that may include factory dereference prefix

  beanName - the canonical bean name

  mbd - the merged bean definition

  返回:

  the object to expose for the bean

• isBeanNameInUse

  public boolean isBeanNameInUse​(String beanName)

  Determine whether the given bean name is already in use within this factory, i.e. whether there is a local bean or alias registered under this name or an inner bean created with this name.

  参数:

  beanName - the name to check

• requiresDestruction

  protected boolean requiresDestruction​(Object bean,
                                        RootBeanDefinition mbd)

  Determine whether the given bean requires destruction on shutdown.

  The default implementation checks the DisposableBean interface as well as a specified destroy method and registered DestructionAwareBeanPostProcessors.

  参数:

  bean - the bean instance to check

  mbd - the corresponding bean definition

  另请参阅:

  DisposableBean, AbstractBeanDefinition.getDestroyMethodName(), DestructionAwareBeanPostProcessor

• registerDisposableBeanIfNecessary

  protected void registerDisposableBeanIfNecessary​(String beanName,
                                                   Object bean,
                                                   RootBeanDefinition mbd)

  Add the given bean to the list of disposable beans in this factory, registering its DisposableBean interface and/or the given destroy method to be called on factory shutdown (if applicable). Only applies to singletons.

  参数:

  beanName - the name of the bean

  bean - the bean instance

  mbd - the bean definition for the bean

  另请参阅:

  AbstractBeanDefinition.isSingleton(), AbstractBeanDefinition.getDependsOn(), DefaultSingletonBeanRegistry.registerDisposableBean(java.lang.String, org.springframework.beans.factory.DisposableBean), DefaultSingletonBeanRegistry.registerDependentBean(java.lang.String, java.lang.String)

• containsBeanDefinition

  protected abstract boolean containsBeanDefinition​(String beanName)

  Check if this bean factory contains a bean definition with the given name. Does not consider any hierarchy this factory may participate in. Invoked by containsBean when no cached singleton instance is found.

  Depending on the nature of the concrete bean factory implementation, this operation might be expensive (for example, because of directory lookups in external registries). However, for listable bean factories, this usually just amounts to a local hash lookup: The operation is therefore part of the public interface there. The same implementation can serve for both this template method and the public interface method in that case.

  参数:

  beanName - the name of the bean to look for

  返回:

  if this bean factory contains a bean definition with the given name

  另请参阅:

  containsBean(java.lang.String), ListableBeanFactory.containsBeanDefinition(java.lang.String)

• getBeanDefinition

  protected abstract BeanDefinition getBeanDefinition​(String beanName)
                                               throws BeansException

  Return the bean definition for the given bean name. Subclasses should normally implement caching, as this method is invoked by this class every time bean definition metadata is needed.

  Depending on the nature of the concrete bean factory implementation, this operation might be expensive (for example, because of directory lookups in external registries). However, for listable bean factories, this usually just amounts to a local hash lookup: The operation is therefore part of the public interface there. The same implementation can serve for both this template method and the public interface method in that case.

  参数:

  beanName - the name of the bean to find a definition for

  返回:

  the BeanDefinition for this prototype name (never null)

  抛出:

  NoSuchBeanDefinitionException - if the bean definition cannot be resolved

  BeansException - in case of errors

  另请参阅:

  RootBeanDefinition, ChildBeanDefinition, ConfigurableListableBeanFactory.getBeanDefinition(java.lang.String)

• createBean

  protected abstract Object createBean​(String beanName,
                                       RootBeanDefinition mbd,
                                       Object[] args)
                                throws BeanCreationException

  Create a bean instance for the given merged bean definition (and arguments). The bean definition will already have been merged with the parent definition in case of a child definition.

  All bean retrieval methods delegate to this method for actual bean creation.

  参数:

  beanName - the name of the bean

  mbd - the merged bean definition for the bean

  args - explicit arguments to use for constructor or factory method invocation

  返回:

  a new instance of the bean

  抛出:

  BeanCreationException - if the bean could not be created