Spring Beans 6.1.4 · org.springframework.beans.factory.support.DefaultSingletonBeanRegistry

Modifier and Type	Field and Description
private final Map<String, Set<String>>	containedBeanMap Map between containing bean names: bean name to Set of bean names that the bean contains.
private final Map<String, Set<String>>	dependenciesForBeanMap Map between depending bean names: bean name to Set of bean names for the bean's dependencies.
private final Map<String, Set<String>>	dependentBeanMap Map between dependent bean names: bean name to Set of dependent bean names.
private final Map<String, DisposableBean>	disposableBeans Disposable bean instances: bean name to disposable instance.
private final Map<String, Object>	earlySingletonObjects Cache of early singleton objects: bean name to bean instance.
private final Set<String>	inCreationCheckExclusions Names of beans currently excluded from in creation checks.
private final Set<String>	registeredSingletons Set of registered singletons, containing the bean names in registration order.
private final Map<String, ObjectFactory<?>>	singletonFactories Cache of singleton factories: bean name to ObjectFactory.
private final Map<String, Object>	singletonObjects Cache of singleton objects: bean name to bean instance.
private final Set<String>	singletonsCurrentlyInCreation Names of beans that are currently in creation.
private boolean	singletonsCurrentlyInDestruction Flag that indicates whether we're currently within destroySingletons.
private static final int	SUPPRESSED_EXCEPTIONS_LIMIT Maximum number of suppressed exceptions to preserve.
private Set<Exception>	suppressedExceptions Collection of suppressed Exceptions, available for associating related causes.

Access	Constructor and Description
public	DefaultSingletonBeanRegistry()

Method Summary

Modifier and Type	Method and Description
protected void	addSingleton(String the name of the bean beanName, Object the singleton object singletonObject) Add the given singleton object to the singleton cache of this factory.
protected void	addSingletonFactory(String the name of the bean beanName, ObjectFactory<?> the factory for the singleton object singletonFactory) Add the given singleton factory for building the specified singleton if necessary.
protected void	afterSingletonCreation(String the name of the singleton that has been created beanName) Callback after singleton creation.
protected void	beforeSingletonCreation(String the name of the singleton about to be created beanName) Callback before singleton creation.
protected void	clearSingletonCache() Clear all cached singleton instances in this registry.
public boolean	containsSingleton(String the name of the bean to look for beanName) Implements org.springframework.beans.factory.config.SingletonBeanRegistry.containsSingleton. Check if this registry contains a singleton instance with the given name.
protected void	destroyBean(String the name of the bean beanName, DisposableBean the bean instance to destroy bean) Destroy the given bean.
public void	destroySingleton(String the name of the bean beanName) Destroy the given bean.
public void	destroySingletons()
public String[]	Returns: the array of names of beans which the bean depends on, or an empty array if none getDependenciesForBean(String the name of the bean beanName) Return the names of all beans that the specified bean depends on, if any.
public String[]	Returns: the array of dependent bean names, or an empty array if none getDependentBeans(String the name of the bean beanName) Return the names of all beans which depend on the specified bean, if any.
public Object	getSingleton(String the name of the bean to look for beanName) Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingleton. Return the (raw) singleton object registered under the given name.
protected Object	Returns: the registered singleton object, or `null` if none found getSingleton(String the name of the bean to look for beanName, boolean whether early references should be created or not allowEarlyReference) Return the (raw) singleton object registered under the given name.
public Object	Returns: the registered singleton object getSingleton(String the name of the bean beanName, ObjectFactory<?> the ObjectFactory to lazily create the singleton with, if necessary singletonFactory) Return the (raw) singleton object registered under the given name, creating and registering a new one if none registered yet.
public int	getSingletonCount() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonCount. Return the number of singleton beans registered in this registry.
public final Object	getSingletonMutex() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonMutex. Exposes the singleton mutex to subclasses and external collaborators.
public String[]	getSingletonNames() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonNames. Return the names of singleton beans registered in this registry.
protected boolean	hasDependentBean(String the name of the bean to check beanName) Determine whether a dependent bean has been registered for the given name.
protected boolean	isActuallyInCreation(String beanName)
public boolean	isCurrentlyInCreation(String beanName)
protected boolean	isDependent(String the name of the bean to check beanName, String the name of the dependent bean dependentBeanName) Determine whether the specified dependent bean has been registered as dependent on the given bean or on any of its transitive dependencies.
private boolean	isDependent(String beanName, String dependentBeanName, Set<String> alreadySeen)
public boolean	isSingletonCurrentlyInCreation(String the name of the bean beanName) Return whether the specified singleton bean is currently in creation (within the entire factory).
protected void	onSuppressedException(Exception the Exception to register ex) Register an exception that happened to get suppressed during the creation of a singleton bean instance, e.g. a temporary circular reference resolution problem.
public void	registerContainedBean(String the name of the contained (inner) bean containedBeanName, String the name of the containing (outer) bean containingBeanName) Register a containment relationship between two beans, e.g. between an inner bean and its containing outer bean.
public void	registerDependentBean(String the name of the bean beanName, String the name of the dependent bean dependentBeanName) Register a dependent bean for the given bean, to be destroyed before the given bean is destroyed.
public void	registerDisposableBean(String the name of the bean beanName, DisposableBean the bean instance bean) Add the given bean to the list of disposable beans in this registry.
public void	registerSingleton(String the name of the bean beanName, Object the existing singleton object singletonObject) Implements org.springframework.beans.factory.config.SingletonBeanRegistry.registerSingleton. Register the given existing object as singleton in the bean registry, under the given bean name.
protected void	removeSingleton(String the name of the bean beanName) Remove the bean with the given name from the singleton cache of this factory, to be able to clean up eager registration of a singleton if creation failed.
public void	setCurrentlyInCreation(String beanName, boolean inCreation)

Inherited from org.springframework.core.SimpleAliasRegistry:: allowAliasOverriding canonicalName checkForAliasCircle getAliases hasAlias isAlias registerAlias removeAlias resolveAliases

containedBeanMap	back to summary
private final Map<String, Set<String>> containedBeanMap Map between containing bean names: bean name to Set of bean names that the bean contains.

dependenciesForBeanMap	back to summary
private final Map<String, Set<String>> dependenciesForBeanMap Map between depending bean names: bean name to Set of bean names for the bean's dependencies.

dependentBeanMap	back to summary
private final Map<String, Set<String>> dependentBeanMap Map between dependent bean names: bean name to Set of dependent bean names.

disposableBeans	back to summary
private final Map<String, DisposableBean> disposableBeans Disposable bean instances: bean name to disposable instance.

earlySingletonObjects	back to summary
private final Map<String, Object> earlySingletonObjects Cache of early singleton objects: bean name to bean instance.

inCreationCheckExclusions	back to summary
private final Set<String> inCreationCheckExclusions Names of beans currently excluded from in creation checks.

registeredSingletons	back to summary
private final Set<String> registeredSingletons Set of registered singletons, containing the bean names in registration order.

singletonFactories	back to summary
private final Map<String, ObjectFactory<?>> singletonFactories Cache of singleton factories: bean name to ObjectFactory.

singletonObjects	back to summary
private final Map<String, Object> singletonObjects Cache of singleton objects: bean name to bean instance.

singletonsCurrentlyInCreation	back to summary
private final Set<String> singletonsCurrentlyInCreation Names of beans that are currently in creation.

singletonsCurrentlyInDestruction	back to summary
private boolean singletonsCurrentlyInDestruction Flag that indicates whether we're currently within destroySingletons.

SUPPRESSED_EXCEPTIONS_LIMIT	back to summary
private static final int SUPPRESSED_EXCEPTIONS_LIMIT Maximum number of suppressed exceptions to preserve.

suppressedExceptions	back to summary
private Set<Exception> suppressedExceptions Collection of suppressed Exceptions, available for associating related causes. Annotations @Nullable

DefaultSingletonBeanRegistry	back to summary
public DefaultSingletonBeanRegistry()

Method Detail

addSingleton	back to summary
protected void addSingleton(String beanName, Object singletonObject) Add the given singleton object to the singleton cache of this factory. To be called for eager registration of singletons. Parameters beanName:String the name of the bean singletonObject:Object the singleton object

addSingleton

back to summary

protected void addSingleton(String beanName, Object singletonObject)

Add the given singleton object to the singleton cache of this factory.

To be called for eager registration of singletons.

Parameters

beanName:String: the name of the bean
singletonObject:Object: the singleton object

addSingletonFactory	back to summary
protected void addSingletonFactory(String beanName, ObjectFactory<?> singletonFactory) Add the given singleton factory for building the specified singleton if necessary. To be called for eager registration of singletons, e.g. to be able to resolve circular references. Parameters beanName:String the name of the bean singletonFactory:ObjectFactory<?> the factory for the singleton object

addSingletonFactory

back to summary

protected void addSingletonFactory(String beanName, ObjectFactory<?> singletonFactory)

Add the given singleton factory for building the specified singleton if necessary.

To be called for eager registration of singletons, e.g. to be able to resolve circular references.

Parameters

beanName:String: the name of the bean
singletonFactory:ObjectFactory<?>: the factory for the singleton object

afterSingletonCreation back to summary

afterSingletonCreation	back to summary
protected void afterSingletonCreation(String beanName) Callback after singleton creation. The default implementation marks the singleton as not in creation anymore. Parameters beanName:String the name of the singleton that has been created See Also `isSingletonCurrentlyInCreation`

protected void afterSingletonCreation(String beanName)

Callback after singleton creation.

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

Parameters

beanName:String: the name of the singleton that has been created

See Also

isSingletonCurrentlyInCreation

beforeSingletonCreation back to summary

beforeSingletonCreation	back to summary
protected void beforeSingletonCreation(String beanName) Callback before singleton creation. The default implementation register the singleton as currently in creation. Parameters beanName:String the name of the singleton about to be created See Also `isSingletonCurrentlyInCreation`

protected void beforeSingletonCreation(String beanName)

Callback before singleton creation.

The default implementation register the singleton as currently in creation.

Parameters

beanName:String: the name of the singleton about to be created

See Also

isSingletonCurrentlyInCreation

clearSingletonCache	back to summary
protected void clearSingletonCache() Clear all cached singleton instances in this registry. Since 4.3.15

clearSingletonCache

back to summary

protected void clearSingletonCache()

Clear all cached singleton instances in this registry.

Since: 4.3.15

containsSingleton back to summary

containsSingleton	back to summary
public boolean containsSingleton(String beanName) Implements org.springframework.beans.factory.config.SingletonBeanRegistry.containsSingleton. Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.containsSingleton. Check if this registry contains a singleton instance with the given name. Only checks already instantiated singletons; does not return `true` for singleton bean definitions which have not been instantiated yet. The main purpose of this method is to check manually registered singletons (see `registerSingleton`). Can also be used to check whether a singleton defined by a bean definition has already been created. To check whether a bean factory contains a bean definition with a given name, use ListableBeanFactory's `containsBeanDefinition`. Calling both `containsBeanDefinition` and `containsSingleton` answers whether a specific bean factory contains a local bean instance with the given name. Use BeanFactory's `containsBean` for general checks whether the factory knows about a bean with a given name (whether manually registered singleton instance or created by bean definition), also checking ancestor factories. Note This lookup method is not aware of FactoryBean prefixes or aliases. You need to resolve the canonical bean name first before checking the singleton status. Parameters beanName:String the name of the bean to look for Returns:boolean if this bean factory contains a singleton instance with the given name Annotations @Override

public boolean containsSingleton(String beanName)

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.containsSingleton.

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.containsSingleton.

Check if this registry contains a singleton instance with the given name.

Only checks already instantiated singletons; does not return true for singleton bean definitions which have not been instantiated yet.

The main purpose of this method is to check manually registered singletons (see registerSingleton). Can also be used to check whether a singleton defined by a bean definition has already been created.

To check whether a bean factory contains a bean definition with a given name, use ListableBeanFactory's containsBeanDefinition. Calling both containsBeanDefinition and containsSingleton answers whether a specific bean factory contains a local bean instance with the given name.

Use BeanFactory's containsBean for general checks whether the factory knows about a bean with a given name (whether manually registered singleton instance or created by bean definition), also checking ancestor factories.

Note

This lookup method is not aware of FactoryBean prefixes or aliases. You need to resolve the canonical bean name first before checking the singleton status.

Parameters

beanName:String: the name of the bean to look for

Returns:boolean

if this bean factory contains a singleton instance with the given name

Annotations

@Override

destroyBean	back to summary
protected void destroyBean(String beanName, DisposableBean bean) Destroy the given bean. Must destroy beans that depend on the given bean before the bean itself. Should not throw any exceptions. Parameters beanName:String the name of the bean bean:DisposableBean the bean instance to destroy

destroyBean

back to summary

protected void destroyBean(String beanName, DisposableBean bean)

Destroy the given bean. Must destroy beans that depend on the given bean before the bean itself. Should not throw any exceptions.

Parameters

beanName:String: the name of the bean
bean:DisposableBean: the bean instance to destroy

destroySingleton back to summary

destroySingleton	back to summary
public void destroySingleton(String beanName) Destroy the given bean. Delegates to `destroyBean` if a corresponding disposable bean instance is found. Parameters beanName:String the name of the bean See Also `destroyBean`

public void destroySingleton(String beanName)

Destroy the given bean. Delegates to destroyBean if a corresponding disposable bean instance is found.

Parameters

beanName:String: the name of the bean

See Also

destroyBean

destroySingletons	back to summary
public void destroySingletons()

getDependenciesForBean	back to summary
public String[] getDependenciesForBean(String beanName) Return the names of all beans that the specified bean depends on, if any. Parameters beanName:String the name of the bean Returns:String[] the array of names of beans which the bean depends on, or an empty array if none

getDependenciesForBean

back to summary

public String[] getDependenciesForBean(String beanName)

Return the names of all beans that the specified bean depends on, if any.

Parameters

beanName:String: the name of the bean

Returns:String[]

the array of names of beans which the bean depends on, or an empty array if none

getDependentBeans	back to summary
public String[] getDependentBeans(String beanName) Return the names of all beans which depend on the specified bean, if any. Parameters beanName:String the name of the bean Returns:String[] the array of dependent bean names, or an empty array if none

getDependentBeans

back to summary

public String[] getDependentBeans(String beanName)

Return the names of all beans which depend on the specified bean, if any.

Parameters

beanName:String: the name of the bean

Returns:String[]

the array of dependent bean names, or an empty array if none

getSingleton back to summary

getSingleton	back to summary
public Object getSingleton(String beanName) Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingleton. Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingleton. Return the (raw) singleton object registered under the given name. Only checks already instantiated singletons; does not return an Object for singleton bean definitions which have not been instantiated yet. The main purpose of this method is to access manually registered singletons (see `registerSingleton`). Can also be used to access a singleton defined by a bean definition that already been created, in a raw fashion. Note This lookup method is not aware of FactoryBean prefixes or aliases. You need to resolve the canonical bean name first before obtaining the singleton instance. Parameters beanName:String the name of the bean to look for Returns:Object the registered singleton object, or `null` if none found Annotations @Override @Nullable

public Object getSingleton(String beanName)

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingleton.

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingleton.

Return the (raw) singleton object registered under the given name.

Only checks already instantiated singletons; does not return an Object for singleton bean definitions which have not been instantiated yet.

The main purpose of this method is to access manually registered singletons (see registerSingleton). Can also be used to access a singleton defined by a bean definition that already been created, in a raw fashion.

Note

This lookup method is not aware of FactoryBean prefixes or aliases. You need to resolve the canonical bean name first before obtaining the singleton instance.

Parameters

beanName:String: the name of the bean to look for

Returns:Object

the registered singleton object, or null if none found

Annotations

@Override
@Nullable

getSingleton back to summary

getSingleton	back to summary
protected Object getSingleton(String beanName, boolean allowEarlyReference) Return the (raw) singleton object registered under the given name. Checks already instantiated singletons and also allows for an early reference to a currently created singleton (resolving a circular reference). Parameters beanName:String the name of the bean to look for allowEarlyReference:boolean whether early references should be created or not Returns:Object the registered singleton object, or `null` if none found Annotations @Nullable

protected Object getSingleton(String beanName, boolean allowEarlyReference)

Return the (raw) singleton object registered under the given name.

Checks already instantiated singletons and also allows for an early reference to a currently created singleton (resolving a circular reference).

Parameters

beanName:String: the name of the bean to look for
allowEarlyReference:boolean: whether early references should be created or not

Returns:Object

the registered singleton object, or null if none found

Annotations

@Nullable

getSingleton	back to summary
public Object getSingleton(String beanName, ObjectFactory<?> singletonFactory) Return the (raw) singleton object registered under the given name, creating and registering a new one if none registered yet. Parameters beanName:String the name of the bean singletonFactory:ObjectFactory<?> the ObjectFactory to lazily create the singleton with, if necessary Returns:Object the registered singleton object

getSingleton

back to summary

public Object getSingleton(String beanName, ObjectFactory<?> singletonFactory)

Return the (raw) singleton object registered under the given name, creating and registering a new one if none registered yet.

Parameters

beanName:String: the name of the bean
singletonFactory:ObjectFactory<?>: the ObjectFactory to lazily create the singleton with, if necessary

Returns:Object

the registered singleton object

getSingletonCount back to summary

getSingletonCount	back to summary
public int getSingletonCount() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonCount. Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonCount. Return the number of singleton beans registered in this registry. Only checks already instantiated singletons; does not count singleton bean definitions which have not been instantiated yet. The main purpose of this method is to check manually registered singletons (see `registerSingleton`). Can also be used to count the number of singletons defined by a bean definition that have already been created. Returns:int the number of singleton beans Annotations @Override

public int getSingletonCount()

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonCount.

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonCount.

Return the number of singleton beans registered in this registry.

Only checks already instantiated singletons; does not count singleton bean definitions which have not been instantiated yet.

The main purpose of this method is to check manually registered singletons (see registerSingleton). Can also be used to count the number of singletons defined by a bean definition that have already been created.

Returns:int

the number of singleton beans

Annotations

@Override

getSingletonMutex back to summary

getSingletonMutex	back to summary
public final Object getSingletonMutex() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonMutex. Exposes the singleton mutex to subclasses and external collaborators. Subclasses should synchronize on the given Object if they perform any sort of extended singleton creation phase. In particular, subclasses should not have their own mutexes involved in singleton creation, to avoid the potential for deadlocks in lazy-init situations. Returns:Object Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonMutex. the mutex object (never `null`) Annotations @Override

public final Object getSingletonMutex()

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonMutex.

Exposes the singleton mutex to subclasses and external collaborators.

Subclasses should synchronize on the given Object if they perform any sort of extended singleton creation phase. In particular, subclasses should not have their own mutexes involved in singleton creation, to avoid the potential for deadlocks in lazy-init situations.

Returns:Object

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonMutex.

the mutex object (never null)

Annotations

@Override

getSingletonNames back to summary

getSingletonNames	back to summary
public String[] getSingletonNames() Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonNames. Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonNames. Return the names of singleton beans registered in this registry. Only checks already instantiated singletons; does not return names for singleton bean definitions which have not been instantiated yet. The main purpose of this method is to check manually registered singletons (see `registerSingleton`). Can also be used to check which singletons defined by a bean definition have already been created. Returns:String[] the list of names as a String array (never `null`) Annotations @Override

public String[] getSingletonNames()

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonNames.

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.getSingletonNames.

Return the names of singleton beans registered in this registry.

Only checks already instantiated singletons; does not return names for singleton bean definitions which have not been instantiated yet.

The main purpose of this method is to check manually registered singletons (see registerSingleton). Can also be used to check which singletons defined by a bean definition have already been created.

Returns:String[]

the list of names as a String array (never null)

Annotations

@Override

hasDependentBean	back to summary
protected boolean hasDependentBean(String beanName) Determine whether a dependent bean has been registered for the given name. Parameters beanName:String the name of the bean to check

hasDependentBean

back to summary

protected boolean hasDependentBean(String beanName)

Determine whether a dependent bean has been registered for the given name.

Parameters

beanName:String: the name of the bean to check

isActuallyInCreation	back to summary
protected boolean isActuallyInCreation(String beanName)

isCurrentlyInCreation	back to summary
public boolean isCurrentlyInCreation(String beanName)

isDependent	back to summary
protected boolean isDependent(String beanName, String dependentBeanName) Determine whether the specified dependent bean has been registered as dependent on the given bean or on any of its transitive dependencies. Parameters beanName:String the name of the bean to check dependentBeanName:String the name of the dependent bean Since 4.0

isDependent

back to summary

protected boolean isDependent(String beanName, String dependentBeanName)

Determine whether the specified dependent bean has been registered as dependent on the given bean or on any of its transitive dependencies.

Parameters

beanName:String: the name of the bean to check
dependentBeanName:String: the name of the dependent bean

Since

4.0

isDependent	back to summary
private boolean isDependent(String beanName, String dependentBeanName, Set<String> alreadySeen)

isSingletonCurrentlyInCreation	back to summary
public boolean isSingletonCurrentlyInCreation(String beanName) Return whether the specified singleton bean is currently in creation (within the entire factory). Parameters beanName:String the name of the bean

isSingletonCurrentlyInCreation

back to summary

public boolean isSingletonCurrentlyInCreation(String beanName)

Return whether the specified singleton bean is currently in creation (within the entire factory).

Parameters

beanName:String: the name of the bean

onSuppressedException back to summary

onSuppressedException	back to summary
protected void onSuppressedException(Exception ex) Register an exception that happened to get suppressed during the creation of a singleton bean instance, e.g. a temporary circular reference resolution problem. The default implementation preserves any given exception in this registry's collection of suppressed exceptions, up to a limit of 100 exceptions, adding them as related causes to an eventual top-level `BeanCreationException`. Parameters ex:Exception the Exception to register See Also `BeanCreationException#getRelatedCauses()`

protected void onSuppressedException(Exception ex)

Register an exception that happened to get suppressed during the creation of a singleton bean instance, e.g. a temporary circular reference resolution problem.

The default implementation preserves any given exception in this registry's collection of suppressed exceptions, up to a limit of 100 exceptions, adding them as related causes to an eventual top-level BeanCreationException.

Parameters

ex:Exception: the Exception to register

registerContainedBean back to summary

registerContainedBean	back to summary
public void registerContainedBean(String containedBeanName, String containingBeanName) Register a containment relationship between two beans, e.g. between an inner bean and its containing outer bean. Also registers the containing bean as dependent on the contained bean in terms of destruction order. Parameters containedBeanName:String the name of the contained (inner) bean containingBeanName:String the name of the containing (outer) bean See Also `registerDependentBean`

public void registerContainedBean(String containedBeanName, String containingBeanName)

Also registers the containing bean as dependent on the contained bean in terms of destruction order.

Parameters

containedBeanName:String: the name of the contained (inner) bean
containingBeanName:String: the name of the containing (outer) bean

See Also

registerDependentBean

registerDependentBean	back to summary
public void registerDependentBean(String beanName, String dependentBeanName) Register a dependent bean for the given bean, to be destroyed before the given bean is destroyed. Parameters beanName:String the name of the bean dependentBeanName:String the name of the dependent bean

registerDependentBean

back to summary

public void registerDependentBean(String beanName, String dependentBeanName)

Parameters

beanName:String: the name of the bean
dependentBeanName:String: the name of the dependent bean

registerDisposableBean	back to summary
public void registerDisposableBean(String beanName, DisposableBean bean) Add the given bean to the list of disposable beans in this registry. Disposable beans usually correspond to registered singletons, matching the bean name but potentially being a different instance (for example, a DisposableBean adapter for a singleton that does not naturally implement Spring's DisposableBean interface). Parameters beanName:String the name of the bean bean:DisposableBean the bean instance

registerDisposableBean

back to summary

public void registerDisposableBean(String beanName, DisposableBean bean)

Add the given bean to the list of disposable beans in this registry.

Disposable beans usually correspond to registered singletons, matching the bean name but potentially being a different instance (for example, a DisposableBean adapter for a singleton that does not naturally implement Spring's DisposableBean interface).

Parameters

beanName:String: the name of the bean
bean:DisposableBean: the bean instance

registerSingleton back to summary

registerSingleton	back to summary
public void registerSingleton(String beanName, Object singletonObject) throws IllegalStateException Implements org.springframework.beans.factory.config.SingletonBeanRegistry.registerSingleton. Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.registerSingleton. Register the given existing object as singleton in the bean registry, under the given bean name. The given instance is supposed to be fully initialized; the registry will not perform any initialization callbacks (in particular, it won't call InitializingBean's `afterPropertiesSet` method). The given instance will not receive any destruction callbacks (like DisposableBean's `destroy` method) either. When running within a full BeanFactory: Register a bean definition instead of an existing instance if your bean is supposed to receive initialization and/or destruction callbacks. Typically invoked during registry configuration, but can also be used for runtime registration of singletons. As a consequence, a registry implementation should synchronize singleton access; it will have to do this anyway if it supports a BeanFactory's lazy initialization of singletons. Parameters beanName:String the name of the bean singletonObject:Object the existing singleton object Annotations @Override

public void registerSingleton(String beanName, Object singletonObject) throws IllegalStateException

Implements org.springframework.beans.factory.config.SingletonBeanRegistry.registerSingleton.

Doc from org.springframework.beans.factory.config.SingletonBeanRegistry.registerSingleton.

The given instance is supposed to be fully initialized; the registry will not perform any initialization callbacks (in particular, it won't call InitializingBean's afterPropertiesSet method). The given instance will not receive any destruction callbacks (like DisposableBean's destroy method) either.

When running within a full BeanFactory: Register a bean definition instead of an existing instance if your bean is supposed to receive initialization and/or destruction callbacks.

Typically invoked during registry configuration, but can also be used for runtime registration of singletons. As a consequence, a registry implementation should synchronize singleton access; it will have to do this anyway if it supports a BeanFactory's lazy initialization of singletons.

Parameters

beanName:String: the name of the bean
singletonObject:Object: the existing singleton object

Annotations

@Override

removeSingleton back to summary

removeSingleton	back to summary
protected void removeSingleton(String beanName) Remove the bean with the given name from the singleton cache of this factory, to be able to clean up eager registration of a singleton if creation failed. Parameters beanName:String the name of the bean See Also `getSingletonMutex()`

protected void removeSingleton(String beanName)

Remove the bean with the given name from the singleton cache of this factory, to be able to clean up eager registration of a singleton if creation failed.

Parameters

beanName:String: the name of the bean

See Also

getSingletonMutex()

setCurrentlyInCreation	back to summary
public void setCurrentlyInCreation(String beanName, boolean inCreation)

public Class DefaultSingletonBeanRegistry

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail