The Spring Framework

org.springframework.aop.aspectj
Class AbstractAspectJAdvice

java.lang.Object
  extended by org.springframework.aop.aspectj.AbstractAspectJAdvice
All Implemented Interfaces:
Advice, AspectJPrecedenceInformation, InitializingBean, Ordered
Direct Known Subclasses:
AspectJAfterAdvice, AspectJAfterReturningAdvice, AspectJAfterThrowingAdvice, AspectJAroundAdvice, AspectJMethodBeforeAdvice

public abstract class AbstractAspectJAdvice
extends Object
implements Advice, AspectJPrecedenceInformation, InitializingBean

Superclass for Spring Advices wrapping an AspectJ aspect or annotated advice method.

Since:
2.0
Author:
Rod Johnson, Adrian Colyer, Juergen Hoeller

Field Summary
protected  Method aspectJAdviceMethod
           
protected static String JOIN_POINT_KEY
          Key used in ReflectiveMethodInvocation userAtributes map for the current joinpoint.
 
Fields inherited from interface org.springframework.core.Ordered
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE
 
Constructor Summary
AbstractAspectJAdvice(Method aspectJAdviceMethod, AspectJExpressionPointcut pointcut, AspectInstanceFactory aspectInstanceFactory)
          Create a new AbstractAspectJAdvice for the given advice method.
 
Method Summary
 void afterPropertiesSet()
          Argument names have to be discovered and set on the associated pointcut expression, and we also calculate argument bindings for advice invocation so that actual dispatch can be as fast as possible.
protected  Object[] argBinding(org.aspectj.lang.JoinPoint jp, org.aspectj.weaver.tools.JoinPointMatch jpMatch, Object returnValue, Throwable t)
          Take the arguments at the method execution join point and output a set of arguments to the advice method
 Pointcut buildSafePointcut()
          Build a 'safe' pointcut that excludes the AspectJ advice method itself.
protected  ParameterNameDiscoverer createParameterNameDiscoverer()
          Create a ParameterNameDiscoverer to be used for argument binding.
static org.aspectj.lang.JoinPoint currentJoinPoint()
          Lazily instantiate joinpoint for the current invocation.
 AspectInstanceFactory getAspectInstanceFactory()
          Return the factory for aspect instances.
 Method getAspectJAdviceMethod()
          Return the AspectJ-style advice method.
 String getAspectName()
          The name of the aspect (bean) in which the advice was declared.
 int getDeclarationOrder()
          The declaration order of the advice member within the aspect.
protected  Class getDiscoveredReturningType()
           
protected  Class getDiscoveredThrowingType()
           
protected  org.aspectj.lang.JoinPoint getJoinPoint()
          Overridden in around advice to return proceeding join point.
protected  org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch()
          Get the current join point match at the join point we are being dispatched on.
protected  org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch(ProxyMethodInvocation rmi)
           
 int getOrder()
          Return the order value of this object, with a higher value meaning greater in terms of sorting.
 AspectJExpressionPointcut getPointcut()
          Return the AspectJ expression pointcut.
protected  Object invokeAdviceMethod(org.aspectj.lang.JoinPoint jp, org.aspectj.weaver.tools.JoinPointMatch jpMatch, Object returnValue, Throwable t)
           
protected  Object invokeAdviceMethod(org.aspectj.weaver.tools.JoinPointMatch jpMatch, Object returnValue, Throwable ex)
          Invoke the advice method.
protected  Object invokeAdviceMethodWithGivenArgs(Object[] args)
           
 void setArgumentNames(String argNames)
          Set by creator of this advice object if the argument names are known.
 void setArgumentNamesFromStringArray(String[] args)
           
 void setAspectName(String name)
           
 void setDeclarationOrder(int order)
          Sets the declaration order of this advice within the aspect
 void setReturningName(String name)
           
protected  void setReturningNameNoCheck(String name)
          We need to hold the returning name at this level for argument binding calculations, this method allows the afterReturning advice subclass to set the name.
 void setThrowingName(String name)
           
protected  void setThrowingNameNoCheck(String name)
          We need to hold the throwing name at this level for argument binding calculations, this method allows the afterThrowing advice subclass to set the name.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.springframework.aop.aspectj.AspectJPrecedenceInformation
isAfterAdvice, isBeforeAdvice
 

Field Detail

JOIN_POINT_KEY

protected static final String JOIN_POINT_KEY
Key used in ReflectiveMethodInvocation userAtributes map for the current joinpoint.


aspectJAdviceMethod

protected final Method aspectJAdviceMethod
Constructor Detail

AbstractAspectJAdvice

public AbstractAspectJAdvice(Method aspectJAdviceMethod,
                             AspectJExpressionPointcut pointcut,
                             AspectInstanceFactory aspectInstanceFactory)
Create a new AbstractAspectJAdvice for the given advice method.

Parameters:
aspectJAdviceMethod - the AspectJ-style advice method
pointcut - the AspectJ expression pointcut
aspectInstanceFactory - the factory for aspect instances
Method Detail

currentJoinPoint

public static org.aspectj.lang.JoinPoint currentJoinPoint()
Lazily instantiate joinpoint for the current invocation. Requires MethodInvocation to be bound with ExposeInvocationInterceptor.

Do not use if access is available to the current ReflectiveMethodInvocation (in an around advice).

Returns:
current AspectJ joinpoint, or through an exception if we're not in a Spring AOP invocation.

getAspectJAdviceMethod

public final Method getAspectJAdviceMethod()
Return the AspectJ-style advice method.


getPointcut

public final AspectJExpressionPointcut getPointcut()
Return the AspectJ expression pointcut.


buildSafePointcut

public final Pointcut buildSafePointcut()
Build a 'safe' pointcut that excludes the AspectJ advice method itself.

Returns:
a composable pointcut that builds on the original AspectJ expression pointcut
See Also:
getPointcut()

getAspectInstanceFactory

public final AspectInstanceFactory getAspectInstanceFactory()
Return the factory for aspect instances.


getOrder

public int getOrder()
Description copied from interface: Ordered
Return the order value of this object, with a higher value meaning greater in terms of sorting.

Normally starting with 0 or 1, with Ordered.LOWEST_PRECEDENCE indicating greatest. Same order values will result in arbitrary positions for the affected objects.

Higher value can be interpreted as lower priority, consequently the first object has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Note that order values below 0 are reserved for framework purposes. Application-specified values should always be 0 or greater, with only framework components (internal or third-party) supposed to use lower values.

Specified by:
getOrder in interface Ordered
Returns:
the order value
See Also:
Ordered.LOWEST_PRECEDENCE

setAspectName

public void setAspectName(String name)

getAspectName

public String getAspectName()
Description copied from interface: AspectJPrecedenceInformation
The name of the aspect (bean) in which the advice was declared.

Specified by:
getAspectName in interface AspectJPrecedenceInformation

setDeclarationOrder

public void setDeclarationOrder(int order)
Sets the declaration order of this advice within the aspect


getDeclarationOrder

public int getDeclarationOrder()
Description copied from interface: AspectJPrecedenceInformation
The declaration order of the advice member within the aspect.

Specified by:
getDeclarationOrder in interface AspectJPrecedenceInformation

setArgumentNames

public void setArgumentNames(String argNames)
Set by creator of this advice object if the argument names are known.

This could be for example because they have been explicitly specified in XML, or in an advice annotation.

Parameters:
argNames - comma delimited list of arg names

setArgumentNamesFromStringArray

public void setArgumentNamesFromStringArray(String[] args)

setReturningName

public void setReturningName(String name)

setReturningNameNoCheck

protected void setReturningNameNoCheck(String name)
We need to hold the returning name at this level for argument binding calculations, this method allows the afterReturning advice subclass to set the name.


getDiscoveredReturningType

protected Class getDiscoveredReturningType()

setThrowingName

public void setThrowingName(String name)

setThrowingNameNoCheck

protected void setThrowingNameNoCheck(String name)
We need to hold the throwing name at this level for argument binding calculations, this method allows the afterThrowing advice subclass to set the name.


getDiscoveredThrowingType

protected Class getDiscoveredThrowingType()

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception
Argument names have to be discovered and set on the associated pointcut expression, and we also calculate argument bindings for advice invocation so that actual dispatch can be as fast as possible.

Specified by:
afterPropertiesSet in interface InitializingBean
Throws:
Exception - in the event of misconfiguration (such as failure to set an essential property) or if initialization fails.

createParameterNameDiscoverer

protected ParameterNameDiscoverer createParameterNameDiscoverer()
Create a ParameterNameDiscoverer to be used for argument binding.

The default implementation creates a PrioritizedParameterNameDiscoverer containing a LocalVariableTableParameterNameDiscoverer and an AspectJAdviceParameterNameDiscoverer.


argBinding

protected Object[] argBinding(org.aspectj.lang.JoinPoint jp,
                              org.aspectj.weaver.tools.JoinPointMatch jpMatch,
                              Object returnValue,
                              Throwable t)
Take the arguments at the method execution join point and output a set of arguments to the advice method

Parameters:
jpMatch - the join point match that matched this execution join point
returnValue - the return value from the method execution (may be null)
t - the exception thrown by the method execution (may be null)
Returns:
the empty array if there are no arguments

invokeAdviceMethod

protected Object invokeAdviceMethod(org.aspectj.weaver.tools.JoinPointMatch jpMatch,
                                    Object returnValue,
                                    Throwable ex)
                             throws Throwable
Invoke the advice method.

Parameters:
jpMatch - the JoinPointMatch that matched this execution join point
returnValue - the return value from the method execution (may be null)
ex - the exception thrown by the method execution (may be null)
Returns:
the invocation result
Throws:
Throwable - in case of invocation failure

invokeAdviceMethod

protected Object invokeAdviceMethod(org.aspectj.lang.JoinPoint jp,
                                    org.aspectj.weaver.tools.JoinPointMatch jpMatch,
                                    Object returnValue,
                                    Throwable t)
                             throws Throwable
Throws:
Throwable

invokeAdviceMethodWithGivenArgs

protected Object invokeAdviceMethodWithGivenArgs(Object[] args)
                                          throws Throwable
Throws:
Throwable

getJoinPoint

protected org.aspectj.lang.JoinPoint getJoinPoint()
Overridden in around advice to return proceeding join point.


getJoinPointMatch

protected org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch()
Get the current join point match at the join point we are being dispatched on.


getJoinPointMatch

protected org.aspectj.weaver.tools.JoinPointMatch getJoinPointMatch(ProxyMethodInvocation rmi)

toString

public String toString()
Overrides:
toString in class Object

The Spring Framework

Copyright © 2002-2007 The Spring Framework.