org.springframework.beans.factory.xml.BeanDefinitionDecorator Maven / Gradle / Ivy
/*
* Copyright 2002-2012 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
*
* https://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 DefaultBeanDefinitionDocumentReader}
* to handle custom, nested (directly under a {@code }) tags.
*
* Decoration may also occur based on custom attributes applied to the
* {@code } 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
* {@code } 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);
}