Spring Framework

Class ExposeInvocationInterceptor

  extended by org.springframework.aop.interceptor.ExposeInvocationInterceptor
All Implemented Interfaces:
java.io.Serializable, org.aopalliance.aop.Advice, org.aopalliance.intercept.Interceptor, org.aopalliance.intercept.MethodInterceptor, Ordered

public class ExposeInvocationInterceptor
extends java.lang.Object
implements org.aopalliance.intercept.MethodInterceptor, Ordered, java.io.Serializable

Interceptor that exposes the current MethodInvocation as a thread-local object. We occasionally need to do this; for example, when a pointcut (e.g. an AspectJ expression pointcut) needs to know the full invocation context.

Don't use this interceptor unless this is really necessary. Target objects should not normally know about Spring AOP, as this creates a dependency on Spring API. Target objects should be plain POJOs as far as possible.

If used, this interceptor will normally be the first in the interceptor chain.

Rod Johnson, Juergen Hoeller
See Also:
Serialized Form

Field Summary
static Advisor ADVISOR
          Singleton advisor for this class.
static ExposeInvocationInterceptor INSTANCE
          Singleton instance of this class
Fields inherited from interface org.springframework.core.Ordered
Method Summary
static org.aopalliance.intercept.MethodInvocation currentInvocation()
          Return the AOP Alliance MethodInvocation object associated with the current invocation.
 int getOrder()
          Return the order value of this object, with a higher value meaning greater in terms of sorting.
 java.lang.Object invoke(org.aopalliance.intercept.MethodInvocation mi)
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


public static final ExposeInvocationInterceptor INSTANCE
Singleton instance of this class


public static final Advisor ADVISOR
Singleton advisor for this class. Use in preference to INSTANCE when using Spring AOP, as it prevents the need to create a new Advisor to wrap the instance.

Method Detail


public static org.aopalliance.intercept.MethodInvocation currentInvocation()
                                                                    throws java.lang.IllegalStateException
Return the AOP Alliance MethodInvocation object associated with the current invocation.

the invocation object associated with the current invocation
java.lang.IllegalStateException - if there is no AOP invocation in progress, or if the ExposeInvocationInterceptor was not added to this interceptor chain


public java.lang.Object invoke(org.aopalliance.intercept.MethodInvocation mi)
                        throws java.lang.Throwable
Specified by:
invoke in interface org.aopalliance.intercept.MethodInterceptor


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, with Integer.MAX_VALUE indicating the greatest value. Same order values will result in arbitrary positions for the affected objects.

Higher values can be interpreted as lower priority. As a consequence, the object with the lowest value has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Specified by:
getOrder in interface Ordered
the order value

Spring Framework