org.springframework.aop.framework
Class AdvisedSupport

org.springframework.aop.framework.ProxyConfig
  |
  +--org.springframework.aop.framework.AdvisedSupport

Direct Known Subclasses:

ProxyFactory, ProxyFactoryBean

public class AdvisedSupport

extends ProxyConfig

implements Advised

Superclass for AOP Proxy configuration managers. These are not themselves AOP proxies, but subclasses of this class are normally factories from which AOP proxy instances are obtained directly.

This class frees subclasses of the housekeeping of Interceptors and Advisors, but doesn't actually implement proxy creation methods, which are provided by subclasses.

Author:

Rod Johnson

Version: $Id: AdvisedSupport.java,v 1.23 2004/01/25 19:44:25 johnsonr Exp $

See Also: AopProxy

Field Detail

EMPTY_TARGET_SOURCE

public static TargetSource EMPTY_TARGET_SOURCE

Canonical TargetSource when there's no target, and behaviour is supplied by the advisors.

public AdvisedSupport()

No arg constructor to allow use as a Java bean.

public AdvisedSupport(Class[] interfaces)

Create a DefaultProxyConfig with the given parameters.

Parameters:

interfaces - the proxied interfaces

public void addAdvisor(int pos, IntroductionAdvisor advisor)
                 throws AopConfigException

public void addAdvisor(int pos, Advisor advisor)

public void addAdvisor(Advisor advice)

public void addBeforeAdvice(MethodBeforeAdvice ba)

public void addInterceptor(Interceptor interceptor)

public void addInterceptor(int pos, Interceptor interceptor)

Cannot add IntroductionInterceptors this way.

public void addInterface(Class newInterface)

Add a new proxied interface.

Parameters:

newInterface - additional interface to proxy

public void addListener(AdvisedSupportListener l)

public void addThrowsAdvice(ThrowsAdvice throwsAdvice)

public final int countInterceptorsOfType(Class interceptorClass)

Count interceptors of the given class

Parameters:

interceptorClass - class of the interceptor to check

Returns: the count of the interceptors of this class or subclasses

public final AdvisorChainFactory getAdvisorChainFactory()

Return the AdvisorChainFactory associated with this ProxyConfig.

public final Advisor[] getAdvisors()

public final MethodInvocationFactory getMethodInvocationFactory()

Returns: Returns the methodInvocationFactory.

public final Class[] getProxiedInterfaces()

public final TargetSource getTargetSource()

Returns: the TargetSource. Never returns null

public int indexOf(Interceptor interceptor)

Return the index (from 0) of the given AOP Alliance interceptor, or -1 if no such interceptor is an advice for this proxy. The return value of this method can be used to index into the Advisors array.

Parameters:

interceptor - AOP Alliance interceptor to search for

Returns: index from 0 of this interceptor, or -1 if there's no such advice.

public int indexOf(Advisor advisor)

Return the index (from 0) of the given advisor, or -1 if no such advisor applies to this proxy. The return value of this method can be used to index into the Advisors array.

Parameters:

advisor - advisor to search for

Returns: index from 0 of this advisor, or -1 if there's no such advisor.

public final boolean interceptorIncluded(Interceptor mi)

Is this interceptor included in any advisor?

Parameters:

mi - interceptor to check inclusion of

Returns: whether this interceptor instance could be run in an invocation

public boolean isInterfaceProxied(Class intf)

public final boolean removeAdvisor(Advisor advisor)

public void removeAdvisor(int index)
                    throws AopConfigException

public final boolean removeInterceptor(Interceptor interceptor)

Convenience method to remove an interceptor

public boolean removeInterface(Class intf)

Remove a proxied interface. Does nothing if it isn't proxied.

public void removeListener(AdvisedSupportListener l)

public final boolean replaceAdvisor(Advisor a, Advisor b)

Replace the given advisor. NB:If the advisor is an IntroductionAdvisor and the replacement is not or implements different interfaces, the proxy will need to be re-obtained or the old interfaces won't be supported and the new interface won't be implemented.

Parameters:

a - advisor to replace

b - advisor to replace it with

Returns: whether it was replaced. If the advisor wasn't found in the list of advisors, this method returns false and does nothing.

public void setAdvisorChainFactory(AdvisorChainFactory advisorChainFactory)

public void setInterfaces(Class[] interfaces)

Set the interfaces to be proxied.

Parameters:

interfaces - the interfaces to set

public void setMethodInvocationFactory(MethodInvocationFactory methodInvocationFactory)

Parameters:

methodInvocationFactory - The methodInvocationFactory to set.

public void setTarget(Object target)

public void setTargetSource(TargetSource ts)

public String toProxyConfigString()

public String toString()

For debugging/diagnostic use.

Association Links

to Class org.springframework.aop.TargetSource

Canonical TargetSource when there's no target, and behaviour is supplied by the advisors.

to Class java.util.List

List of Advice. If an Interceptor is added, it will be wrapped in an Advice before being added to this List.

to Class org.springframework.aop.Advisor

Array updated on changes to the advisors list, which is easier to manipulate internally

to Class java.util.Set

Interfaces to be implemented by the proxy

to Class org.springframework.aop.TargetSource

to Class org.springframework.aop.framework.MethodInvocationFactory

to Class java.util.LinkedList

List of AdvisedSupportListener

to Class org.springframework.aop.framework.AdvisorChainFactory