/*
* Copyright 2002-2006 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.beans.factory.xml;
import org.w3c.dom.Node;
import org.springframework.beans.factory.config.BeanDefinitionHolder;
/**
* Interface used by the {@link org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader}
* to handle custom, nested (directly under a <bean>
) tags.
*
*
Decoration may also occur based on custom attributes applied to the
* <bean>
tag. Implementations are free to turn the metadata in the
* custom tag into as many
* {@link org.springframework.beans.factory.config.BeanDefinition BeanDefinitions} as
* required and to transform the
* {@link org.springframework.beans.factory.config.BeanDefinition} of the enclosing
* <bean>
tag, potentially even returning a completely different
* {@link org.springframework.beans.factory.config.BeanDefinition} to replace the
* original.
*
*
{@link BeanDefinitionDecorator BeanDefinitionDecorators} should be aware that * they may be part of a chain. In particular, a {@link BeanDefinitionDecorator} should * be aware that a previous {@link BeanDefinitionDecorator} may have replaced the * original {@link org.springframework.beans.factory.config.BeanDefinition} with a * {@link org.springframework.aop.framework.ProxyFactoryBean} definition allowing for * custom {@link org.aopalliance.intercept.MethodInterceptor interceptors} to be added. * *
{@link BeanDefinitionDecorator BeanDefinitionDecorators} that wish to add an * interceptor to the enclosing bean should extend * {@link org.springframework.aop.config.AbstractInterceptorDrivenBeanDefinitionDecorator} * which handles the chaining ensuring that only one proxy is created and that it * contains all interceptors from the chain. * *
The parser locates a {@link BeanDefinitionDecorator} from the * {@link NamespaceHandler} for the namespace in which the custom tag resides. * * @author Rob Harrop * @since 2.0 * @see NamespaceHandler * @see BeanDefinitionParser */ public interface BeanDefinitionDecorator { /** * Parse the specified {@link Node} (either an element or an attribute) and decorate * the supplied {@link org.springframework.beans.factory.config.BeanDefinition}, * returning the decorated definition. *
Implementations may choose to return a completely new definition, which will * replace the original definition in the resulting * {@link org.springframework.beans.factory.BeanFactory}. *
The supplied {@link ParserContext} can be used to register any additional * beans needed to support the main definition. */ BeanDefinitionHolder decorate(Node node, BeanDefinitionHolder definition, ParserContext parserContext); }