org.springframework.aop.framework.AopProxyFactory 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
*
* 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.aop.framework;
/**
* Interface to be implemented by factories that are able to create
* AOP proxies based on {@link AdvisedSupport} configuration objects.
*
* Proxies should observe the following contract:
*
* - They should implement all interfaces that the configuration
* indicates should be proxied.
*
- They should implement the {@link Advised} interface.
*
- They should implement the equals method to compare proxied
* interfaces, advice, and target.
*
- They should be serializable if all advisors and target
* are serializable.
*
- They should be thread-safe if advisors and target
* are thread-safe.
*
*
* Proxies may or may not allow advice changes to be made.
* If they do not permit advice changes (for example, because
* the configuration was frozen) a proxy should throw an
* {@link AopConfigException} on an attempted advice change.
*
* @author Rod Johnson
* @author Juergen Hoeller
*/
public interface AopProxyFactory {
/**
* Create an {@link AopProxy} for the given AOP configuration.
* @param config the AOP configuration in the form of an
* AdvisedSupport object
* @return the corresponding AOP proxy
* @throws AopConfigException if the configuration is invalid
*/
AopProxy createAopProxy(AdvisedSupport config) throws AopConfigException;
}