Class ChildBeanDefinition

java.lang.Object

org.springframework.core.AttributeAccessorSupport

org.springframework.beans.BeanMetadataAttributeAccessor

org.springframework.beans.factory.support.AbstractBeanDefinition

org.springframework.beans.factory.support.ChildBeanDefinition

All Implemented Interfaces:

Serializable, Cloneable, BeanMetadataElement, BeanDefinition, AttributeAccessor

public class ChildBeanDefinition
extends AbstractBeanDefinition

Bean definition for beans which inherit settings from their parent. Child bean definitions have a fixed dependency on a parent bean definition.

A child bean definition will inherit constructor argument values, property values and method overrides from the parent, with the option to add new values. If init method, destroy method and/or static factory method are specified, they will override the corresponding parent settings. The remaining settings will always be taken from the child definition: depends on, autowire mode, dependency check, singleton, lazy init.

NOTE: Since Spring 2.5, the preferred way to register bean definitions programmatically is the GenericBeanDefinition class, which allows to dynamically define parent dependencies through the GenericBeanDefinition.setParentName(String) method. This effectively supersedes the ChildBeanDefinition class for most use cases.

Author:

Rod Johnson, Juergen Hoeller

See Also:

• GenericBeanDefinition
• RootBeanDefinition
• Serialized Form

Field Summary

Fields inherited from class AbstractBeanDefinition

AUTOWIRE_AUTODETECT, AUTOWIRE_BY_NAME, AUTOWIRE_BY_TYPE, AUTOWIRE_CONSTRUCTOR, AUTOWIRE_NO, DEPENDENCY_CHECK_ALL, DEPENDENCY_CHECK_NONE, DEPENDENCY_CHECK_OBJECTS, DEPENDENCY_CHECK_SIMPLE, INFER_METHOD, ORDER_ATTRIBUTE, PREFERRED_CONSTRUCTORS_ATTRIBUTE, SCOPE_DEFAULT

Fields inherited from interface BeanDefinition

ROLE_APPLICATION, ROLE_INFRASTRUCTURE, ROLE_SUPPORT, SCOPE_PROTOTYPE, SCOPE_SINGLETON

Constructor Summary

Constructors

Constructor	Description
ChildBeanDefinition(String parentName)	Create a new ChildBeanDefinition for the given parent, to be configured through its bean properties and configuration methods.
ChildBeanDefinition(String parentName, Class<?> beanClass, ConstructorArgumentValues cargs, MutablePropertyValues pvs)	Create a new ChildBeanDefinition for the given parent, providing constructor arguments and property values.
ChildBeanDefinition(String parentName, String beanClassName, ConstructorArgumentValues cargs, MutablePropertyValues pvs)	Create a new ChildBeanDefinition for the given parent, providing constructor arguments and property values.
ChildBeanDefinition(String parentName, ConstructorArgumentValues cargs, MutablePropertyValues pvs)	Create a new ChildBeanDefinition for the given parent.
ChildBeanDefinition(String parentName, MutablePropertyValues pvs)	Create a new ChildBeanDefinition for the given parent.
ChildBeanDefinition(ChildBeanDefinition original)	Create a new ChildBeanDefinition as deep copy of the given bean definition.

Method Summary

Modifier and Type	Method	Description
AbstractBeanDefinition	cloneBeanDefinition()	Clone this bean definition.
boolean	equals(@Nullable Object other)
@Nullable String	getParentName()	Return the name of the parent definition of this bean definition, if any.
int	hashCode()
void	setParentName(@Nullable String parentName)	Set the name of the parent definition of this bean definition, if any.
String	toString()
void	validate()	Validate this bean definition.

Methods inherited from class AbstractBeanDefinition

addQualifier, applyDefaults, clone, copyQualifiersFrom, getAutowireMode, getBeanClass, getBeanClassName, getConstructorArgumentValues, getDependencyCheck, getDependsOn, getDescription, getDestroyMethodName, getDestroyMethodNames, getFactoryBeanName, getFactoryMethodName, getInitMethodName, getInitMethodNames, getInstanceSupplier, getLazyInit, getMethodOverrides, getOriginatingBeanDefinition, getPropertyValues, getQualifier, getQualifiers, getResolvableType, getResolvedAutowireMode, getResource, getResourceDescription, getRole, getScope, hasBeanClass, hasConstructorArgumentValues, hasMethodOverrides, hasPropertyValues, hasQualifier, isAbstract, isAutowireCandidate, isBackgroundInit, isDefaultCandidate, isEnforceDestroyMethod, isEnforceInitMethod, isFallback, isLazyInit, isLenientConstructorResolution, isNonPublicAccessAllowed, isPrimary, isPrototype, isSingleton, isSynthetic, overrideFrom, prepareMethodOverride, prepareMethodOverrides, resolveBeanClass, setAbstract, setAutowireCandidate, setAutowireMode, setBackgroundInit, setBeanClass, setBeanClassName, setConstructorArgumentValues, setDefaultCandidate, setDependencyCheck, setDependsOn, setDescription, setDestroyMethodName, setDestroyMethodNames, setEnforceDestroyMethod, setEnforceInitMethod, setFactoryBeanName, setFactoryMethodName, setFallback, setInitMethodName, setInitMethodNames, setInstanceSupplier, setLazyInit, setLenientConstructorResolution, setMethodOverrides, setNonPublicAccessAllowed, setOriginatingBeanDefinition, setPrimary, setPropertyValues, setResource, setResourceDescription, setRole, setScope, setSynthetic

Methods inherited from class BeanMetadataAttributeAccessor

addMetadataAttribute, getAttribute, getMetadataAttribute, getSource, removeAttribute, setAttribute, setSource

Methods inherited from class AttributeAccessorSupport

attributeNames, computeAttribute, copyAttributesFrom, hasAttribute

Methods inherited from class Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface AttributeAccessor

attributeNames, computeAttribute, getAttribute, hasAttribute, removeAttribute, setAttribute

Methods inherited from interface BeanMetadataElement

getSource

Constructor Details

ChildBeanDefinition

public ChildBeanDefinition(String parentName)

Create a new ChildBeanDefinition for the given parent, to be configured through its bean properties and configuration methods.

Parameters:

parentName - the name of the parent bean

See Also:

• AbstractBeanDefinition.setBeanClass(Class)
• AbstractBeanDefinition.setScope(String)
• AbstractBeanDefinition.setConstructorArgumentValues(ConstructorArgumentValues)
• AbstractBeanDefinition.setPropertyValues(MutablePropertyValues)

ChildBeanDefinition

public ChildBeanDefinition(String parentName,
 MutablePropertyValues pvs)

Create a new ChildBeanDefinition for the given parent.

Parameters:

parentName - the name of the parent bean

pvs - the additional property values of the child

ChildBeanDefinition

public ChildBeanDefinition(String parentName,
 ConstructorArgumentValues cargs,
 MutablePropertyValues pvs)

Create a new ChildBeanDefinition for the given parent.

Parameters:

parentName - the name of the parent bean

cargs - the constructor argument values to apply

pvs - the additional property values of the child

ChildBeanDefinition

public ChildBeanDefinition(String parentName,
 Class<?> beanClass,
 ConstructorArgumentValues cargs,
 MutablePropertyValues pvs)

Create a new ChildBeanDefinition for the given parent, providing constructor arguments and property values.

Parameters:

parentName - the name of the parent bean

beanClass - the class of the bean to instantiate

cargs - the constructor argument values to apply

pvs - the property values to apply

ChildBeanDefinition

public ChildBeanDefinition(String parentName,
 String beanClassName,
 ConstructorArgumentValues cargs,
 MutablePropertyValues pvs)

Create a new ChildBeanDefinition for the given parent, providing constructor arguments and property values. Takes a bean class name to avoid eager loading of the bean class.

Parameters:

parentName - the name of the parent bean

beanClassName - the name of the class to instantiate

cargs - the constructor argument values to apply

pvs - the property values to apply

ChildBeanDefinition

public ChildBeanDefinition(ChildBeanDefinition original)

Create a new ChildBeanDefinition as deep copy of the given bean definition.

Parameters:

original - the original bean definition to copy from

Method Details

setParentName

public void setParentName(@Nullable String parentName)

Description copied from interface: BeanDefinition

Set the name of the parent definition of this bean definition, if any.

getParentName

public @Nullable String getParentName()

Description copied from interface: BeanDefinition

Return the name of the parent definition of this bean definition, if any.

validate

public void validate()
              throws BeanDefinitionValidationException

Description copied from class: AbstractBeanDefinition

Validate this bean definition.

Overrides:

validate in class AbstractBeanDefinition

Throws:

BeanDefinitionValidationException - in case of validation failure

cloneBeanDefinition

public AbstractBeanDefinition cloneBeanDefinition()

Description copied from class: AbstractBeanDefinition

Clone this bean definition. To be implemented by concrete subclasses.

Specified by:

cloneBeanDefinition in class AbstractBeanDefinition

Returns:

the cloned bean definition object

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class AbstractBeanDefinition

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractBeanDefinition

toString

public String toString()

Overrides:

toString in class AbstractBeanDefinition