org.springframework.aop.interceptor
Class ExposeInvocationInterceptor

java.lang.Object
  org.springframework.aop.interceptor.ExposeInvocationInterceptor

All Implemented Interfaces:

Serializable, Advice, Interceptor, MethodInterceptor

public class ExposeInvocationInterceptor
extends Object
implements MethodInterceptor, 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.

Author:

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

Method Summary

static MethodInvocation	currentInvocation() Return the AOP Alliance MethodInvocation object associated with the current invocation.
Object	invoke(MethodInvocation mi)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INSTANCE

public static final ExposeInvocationInterceptor INSTANCE

Singleton instance of this class

ADVISOR

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

currentInvocation

public static MethodInvocation currentInvocation()
                                          throws IllegalStateException

Return the AOP Alliance MethodInvocation object associated with the current invocation.

Returns:

the invocation object associated with the current invocation

Throws:

IllegalStateException - if there is no AOP invocation in progress, or if the ExposeInvocationInterceptor was not added to this interceptor chain

invoke

public Object invoke(MethodInvocation mi)
              throws Throwable

Specified by:

invoke in interface MethodInterceptor

Throws:

Throwable