public class BeanDefinitionParserDelegate extends Object
BeanDefinitionParsers
or
BeanDefinitionDecorators
.ParserContext
,
DefaultBeanDefinitionDocumentReader
Constructor and Description |
---|
BeanDefinitionParserDelegate(XmlReaderContext readerContext)
Create a new BeanDefinitionParserDelegate associated with the supplied
XmlReaderContext . |
Modifier and Type | Method and Description |
---|---|
protected TypedStringValue |
buildTypedStringValue(String value,
String targetTypeName)
Build a typed String value Object for the given raw value.
|
protected Object |
buildTypedStringValueForMap(String value,
String defaultTypeName,
Element entryEle)
Build a typed String value Object for the given raw value.
|
protected void |
checkNameUniqueness(String beanName,
List<String> aliases,
Element beanElement)
Validate that the specified bean name and aliases have not been used already
within the current level of beans element nesting.
|
protected AbstractBeanDefinition |
createBeanDefinition(String className,
String parentName)
Create a bean definition for the given class name and parent name.
|
BeanDefinitionHolder |
decorateBeanDefinitionIfRequired(Element ele,
BeanDefinitionHolder originalDef)
Decorate the given bean definition through a namespace handler, if applicable.
|
BeanDefinitionHolder |
decorateBeanDefinitionIfRequired(Element ele,
BeanDefinitionHolder originalDef,
BeanDefinition containingBd)
Decorate the given bean definition through a namespace handler, if applicable.
|
BeanDefinitionHolder |
decorateIfRequired(Node node,
BeanDefinitionHolder originalDef,
BeanDefinition containingBd)
Decorate the given bean definition through a namespace handler,
if applicable.
|
protected void |
error(String message,
Element source)
Report an error with the given message for the given source element.
|
protected void |
error(String message,
Element source,
Throwable cause)
Report an error with the given message for the given source element.
|
protected void |
error(String message,
Node source)
Report an error with the given message for the given source element.
|
protected Object |
extractSource(Element ele)
Invoke the
SourceExtractor
to pull the source metadata from the supplied Element . |
String[] |
getAutowireCandidatePatterns()
Return any patterns provided in the 'default-autowire-candidates'
attribute of the top-level
<beans/> element. |
int |
getAutowireMode(String attrValue)
Parse the given autowire attribute value into
AbstractBeanDefinition autowire constants. |
BeanDefinitionDefaults |
getBeanDefinitionDefaults()
Return the default settings for bean definitions as indicated within
the attributes of the top-level
<beans/> element. |
DocumentDefaultsDefinition |
getDefaults()
Return the defaults definition object.
|
String |
getLocalName(Node node)
Get the local name for the supplied
Node . |
String |
getNamespaceURI(Node node)
Get the namespace URI for the supplied node.
|
XmlReaderContext |
getReaderContext()
Get the
XmlReaderContext associated with this helper instance. |
void |
initDefaults(Element root)
Initialize the default settings assuming a
null parent delegate. |
void |
initDefaults(Element root,
BeanDefinitionParserDelegate parent)
Initialize the default lazy-init, autowire, dependency check settings,
init-method, destroy-method and merge settings.
|
boolean |
isDefaultNamespace(Node node)
Determine whether the given node indicates the default namespace.
|
boolean |
isDefaultNamespace(String namespaceUri)
Determine whether the given URI indicates the default namespace.
|
boolean |
nodeNameEquals(Node node,
String desiredName)
Determine whether the name of the supplied node is equal to the supplied name.
|
Object |
parseArrayElement(Element arrayEle,
BeanDefinition bd)
Parse an array element.
|
AbstractBeanDefinition |
parseBeanDefinitionAttributes(Element ele,
String beanName,
BeanDefinition containingBean,
AbstractBeanDefinition bd)
Apply the attributes of the given bean element to the given bean * definition.
|
BeanDefinitionHolder |
parseBeanDefinitionElement(Element ele)
Parses the supplied
<bean> element. |
BeanDefinitionHolder |
parseBeanDefinitionElement(Element ele,
BeanDefinition containingBean)
Parses the supplied
<bean> element. |
AbstractBeanDefinition |
parseBeanDefinitionElement(Element ele,
String beanName,
BeanDefinition containingBean)
Parse the bean definition itself, without regard to name or aliases.
|
protected void |
parseCollectionElements(NodeList elementNodes,
Collection<Object> target,
BeanDefinition bd,
String defaultElementType) |
void |
parseConstructorArgElement(Element ele,
BeanDefinition bd)
Parse a constructor-arg element.
|
void |
parseConstructorArgElements(Element beanEle,
BeanDefinition bd)
Parse constructor-arg sub-elements of the given bean element.
|
BeanDefinition |
parseCustomElement(Element ele)
Parse a custom element (outside of the default namespace).
|
BeanDefinition |
parseCustomElement(Element ele,
BeanDefinition containingBd)
Parse a custom element (outside of the default namespace).
|
Object |
parseIdRefElement(Element ele)
Return a typed String value Object for the given 'idref' element.
|
protected Object |
parseKeyElement(Element keyEle,
BeanDefinition bd,
String defaultKeyTypeName)
Parse a key sub-element of a map element.
|
List<Object> |
parseListElement(Element collectionEle,
BeanDefinition bd)
Parse a list element.
|
void |
parseLookupOverrideSubElements(Element beanEle,
MethodOverrides overrides)
Parse lookup-override sub-elements of the given bean element.
|
Map<Object,Object> |
parseMapElement(Element mapEle,
BeanDefinition bd)
Parse a map element.
|
boolean |
parseMergeAttribute(Element collectionElement)
Parse the merge attribute of a collection element, if any.
|
void |
parseMetaElements(Element ele,
BeanMetadataAttributeAccessor attributeAccessor)
Parse the meta elements underneath the given element, if any.
|
void |
parsePropertyElement(Element ele,
BeanDefinition bd)
Parse a property element.
|
void |
parsePropertyElements(Element beanEle,
BeanDefinition bd)
Parse property sub-elements of the given bean element.
|
Object |
parsePropertySubElement(Element ele,
BeanDefinition bd)
Parse a value, ref or collection sub-element of a property or
constructor-arg element.
|
Object |
parsePropertySubElement(Element ele,
BeanDefinition bd,
String defaultValueType)
Parse a value, ref or collection sub-element of a property or
constructor-arg element.
|
Object |
parsePropertyValue(Element ele,
BeanDefinition bd,
String propertyName)
Get the value of a property element.
|
Properties |
parsePropsElement(Element propsEle)
Parse a props element.
|
void |
parseQualifierElement(Element ele,
AbstractBeanDefinition bd)
Parse a qualifier element.
|
void |
parseQualifierElements(Element beanEle,
AbstractBeanDefinition bd)
Parse qualifier sub-elements of the given bean element.
|
void |
parseReplacedMethodSubElements(Element beanEle,
MethodOverrides overrides)
Parse replaced-method sub-elements of the given bean element.
|
Set<Object> |
parseSetElement(Element collectionEle,
BeanDefinition bd)
Parse a set element.
|
Object |
parseValueElement(Element ele,
String defaultTypeName)
Return a typed String value Object for the given value element.
|
protected void |
populateDefaults(DocumentDefaultsDefinition defaults,
DocumentDefaultsDefinition parentDefaults,
Element root)
Populate the given DocumentDefaultsDefinition instance with the default lazy-init,
autowire, dependency check settings, init-method, destroy-method and merge settings.
|
public static final String BEANS_NAMESPACE_URI
public static final String MULTI_VALUE_ATTRIBUTE_DELIMITERS
public static final String TRUE_VALUE
public static final String FALSE_VALUE
public static final String DEFAULT_VALUE
public static final String DESCRIPTION_ELEMENT
public static final String AUTOWIRE_NO_VALUE
public static final String AUTOWIRE_BY_NAME_VALUE
public static final String AUTOWIRE_BY_TYPE_VALUE
public static final String AUTOWIRE_CONSTRUCTOR_VALUE
public static final String AUTOWIRE_AUTODETECT_VALUE
public static final String NAME_ATTRIBUTE
public static final String BEAN_ELEMENT
public static final String META_ELEMENT
public static final String ID_ATTRIBUTE
public static final String PARENT_ATTRIBUTE
public static final String CLASS_ATTRIBUTE
public static final String ABSTRACT_ATTRIBUTE
public static final String SCOPE_ATTRIBUTE
public static final String LAZY_INIT_ATTRIBUTE
public static final String AUTOWIRE_ATTRIBUTE
public static final String AUTOWIRE_CANDIDATE_ATTRIBUTE
public static final String PRIMARY_ATTRIBUTE
public static final String DEPENDS_ON_ATTRIBUTE
public static final String INIT_METHOD_ATTRIBUTE
public static final String DESTROY_METHOD_ATTRIBUTE
public static final String FACTORY_METHOD_ATTRIBUTE
public static final String FACTORY_BEAN_ATTRIBUTE
public static final String CONSTRUCTOR_ARG_ELEMENT
public static final String INDEX_ATTRIBUTE
public static final String TYPE_ATTRIBUTE
public static final String VALUE_TYPE_ATTRIBUTE
public static final String KEY_TYPE_ATTRIBUTE
public static final String PROPERTY_ELEMENT
public static final String REF_ATTRIBUTE
public static final String VALUE_ATTRIBUTE
public static final String LOOKUP_METHOD_ELEMENT
public static final String REPLACED_METHOD_ELEMENT
public static final String REPLACER_ATTRIBUTE
public static final String ARG_TYPE_ELEMENT
public static final String ARG_TYPE_MATCH_ATTRIBUTE
public static final String REF_ELEMENT
public static final String IDREF_ELEMENT
public static final String BEAN_REF_ATTRIBUTE
public static final String PARENT_REF_ATTRIBUTE
public static final String VALUE_ELEMENT
public static final String NULL_ELEMENT
public static final String ARRAY_ELEMENT
public static final String LIST_ELEMENT
public static final String SET_ELEMENT
public static final String MAP_ELEMENT
public static final String ENTRY_ELEMENT
public static final String KEY_ELEMENT
public static final String KEY_ATTRIBUTE
public static final String KEY_REF_ATTRIBUTE
public static final String VALUE_REF_ATTRIBUTE
public static final String PROPS_ELEMENT
public static final String PROP_ELEMENT
public static final String MERGE_ATTRIBUTE
public static final String QUALIFIER_ELEMENT
public static final String QUALIFIER_ATTRIBUTE_ELEMENT
public static final String DEFAULT_LAZY_INIT_ATTRIBUTE
public static final String DEFAULT_MERGE_ATTRIBUTE
public static final String DEFAULT_AUTOWIRE_ATTRIBUTE
public static final String DEFAULT_AUTOWIRE_CANDIDATES_ATTRIBUTE
public static final String DEFAULT_INIT_METHOD_ATTRIBUTE
public static final String DEFAULT_DESTROY_METHOD_ATTRIBUTE
protected final Log logger
public BeanDefinitionParserDelegate(XmlReaderContext readerContext)
XmlReaderContext
.public final XmlReaderContext getReaderContext()
XmlReaderContext
associated with this helper instance.@Nullable protected Object extractSource(Element ele)
SourceExtractor
to pull the source metadata from the supplied Element
.protected void error(String message, Node source)
protected void error(String message, Element source)
protected void error(String message, Element source, Throwable cause)
public void initDefaults(Element root)
null
parent delegate.public void initDefaults(Element root, @Nullable BeanDefinitionParserDelegate parent)
protected void populateDefaults(DocumentDefaultsDefinition defaults, @Nullable DocumentDefaultsDefinition parentDefaults, Element root)
parentDefaults
in case the defaults are not explicitly set locally.defaults
- the defaults to populateparentDefaults
- the parent BeanDefinitionParserDelegate (if any) defaults to fall back toroot
- the root element of the current bean definition document (or nested beans element)public DocumentDefaultsDefinition getDefaults()
public BeanDefinitionDefaults getBeanDefinitionDefaults()
<beans/>
element.@Nullable public String[] getAutowireCandidatePatterns()
<beans/>
element.@Nullable public BeanDefinitionHolder parseBeanDefinitionElement(Element ele)
<bean>
element. May return null
if there were errors during parse. Errors are reported to the
ProblemReporter
.@Nullable public BeanDefinitionHolder parseBeanDefinitionElement(Element ele, @Nullable BeanDefinition containingBean)
<bean>
element. May return null
if there were errors during parse. Errors are reported to the
ProblemReporter
.protected void checkNameUniqueness(String beanName, List<String> aliases, Element beanElement)
@Nullable public AbstractBeanDefinition parseBeanDefinitionElement(Element ele, String beanName, @Nullable BeanDefinition containingBean)
null
if problems occurred during the parsing of the bean definition.public AbstractBeanDefinition parseBeanDefinitionAttributes(Element ele, String beanName, @Nullable BeanDefinition containingBean, AbstractBeanDefinition bd)
ele
- bean declaration elementbeanName
- bean namecontainingBean
- containing bean definitionprotected AbstractBeanDefinition createBeanDefinition(@Nullable String className, @Nullable String parentName) throws ClassNotFoundException
className
- the name of the bean classparentName
- the name of the bean's parent beanClassNotFoundException
- if bean class resolution was attempted but failedpublic void parseMetaElements(Element ele, BeanMetadataAttributeAccessor attributeAccessor)
public int getAutowireMode(String attrValue)
AbstractBeanDefinition
autowire constants.public void parseConstructorArgElements(Element beanEle, BeanDefinition bd)
public void parsePropertyElements(Element beanEle, BeanDefinition bd)
public void parseQualifierElements(Element beanEle, AbstractBeanDefinition bd)
public void parseLookupOverrideSubElements(Element beanEle, MethodOverrides overrides)
public void parseReplacedMethodSubElements(Element beanEle, MethodOverrides overrides)
public void parseConstructorArgElement(Element ele, BeanDefinition bd)
public void parsePropertyElement(Element ele, BeanDefinition bd)
public void parseQualifierElement(Element ele, AbstractBeanDefinition bd)
@Nullable public Object parsePropertyValue(Element ele, BeanDefinition bd, @Nullable String propertyName)
@Nullable public Object parsePropertySubElement(Element ele, @Nullable BeanDefinition bd)
ele
- subelement of property element; we don't know which yetbd
- the current bean definition (if any)@Nullable public Object parsePropertySubElement(Element ele, @Nullable BeanDefinition bd, @Nullable String defaultValueType)
ele
- subelement of property element; we don't know which yetbd
- the current bean definition (if any)defaultValueType
- the default type (class name) for any
<value>
tag that might be created@Nullable public Object parseIdRefElement(Element ele)
public Object parseValueElement(Element ele, @Nullable String defaultTypeName)
protected TypedStringValue buildTypedStringValue(String value, @Nullable String targetTypeName) throws ClassNotFoundException
ClassNotFoundException
TypedStringValue
public Object parseArrayElement(Element arrayEle, @Nullable BeanDefinition bd)
public List<Object> parseListElement(Element collectionEle, @Nullable BeanDefinition bd)
public Set<Object> parseSetElement(Element collectionEle, @Nullable BeanDefinition bd)
protected void parseCollectionElements(NodeList elementNodes, Collection<Object> target, @Nullable BeanDefinition bd, String defaultElementType)
public Map<Object,Object> parseMapElement(Element mapEle, @Nullable BeanDefinition bd)
protected final Object buildTypedStringValueForMap(String value, String defaultTypeName, Element entryEle)
TypedStringValue
@Nullable protected Object parseKeyElement(Element keyEle, @Nullable BeanDefinition bd, String defaultKeyTypeName)
public Properties parsePropsElement(Element propsEle)
public boolean parseMergeAttribute(Element collectionElement)
@Nullable public BeanDefinition parseCustomElement(Element ele)
ele
- the element to parse@Nullable public BeanDefinition parseCustomElement(Element ele, @Nullable BeanDefinition containingBd)
ele
- the element to parsecontainingBd
- the containing bean definition (if any)public BeanDefinitionHolder decorateBeanDefinitionIfRequired(Element ele, BeanDefinitionHolder originalDef)
ele
- the current elementoriginalDef
- the current bean definitionpublic BeanDefinitionHolder decorateBeanDefinitionIfRequired(Element ele, BeanDefinitionHolder originalDef, @Nullable BeanDefinition containingBd)
ele
- the current elementoriginalDef
- the current bean definitioncontainingBd
- the containing bean definition (if any)public BeanDefinitionHolder decorateIfRequired(Node node, BeanDefinitionHolder originalDef, @Nullable BeanDefinition containingBd)
node
- the current child nodeoriginalDef
- the current bean definitioncontainingBd
- the containing bean definition (if any)@Nullable public String getNamespaceURI(Node node)
The default implementation uses Node.getNamespaceURI()
.
Subclasses may override the default implementation to provide a
different namespace identification mechanism.
node
- the nodepublic String getLocalName(Node node)
Node
.
The default implementation calls Node.getLocalName()
.
Subclasses may override the default implementation to provide a
different mechanism for getting the local name.
node
- the Node
public boolean nodeNameEquals(Node node, String desiredName)
The default implementation checks the supplied desired name against both
Node.getNodeName()
and Node.getLocalName()
.
Subclasses may override the default implementation to provide a different mechanism for comparing node names.
node
- the node to comparedesiredName
- the name to check forpublic boolean isDefaultNamespace(@Nullable String namespaceUri)
public boolean isDefaultNamespace(Node node)