Class ReflectiveMethodInvocation
- java.lang.Object
- org.springframework.aop.framework.ReflectiveMethodInvocation
- All Implemented Interfaces:
Cloneable,Invocation,Joinpoint,MethodInvocation,ProxyMethodInvocation
public class ReflectiveMethodInvocation extends Object implements ProxyMethodInvocation, Cloneable
Spring's implementation of the AOP AllianceMethodInvocationinterface, implementing the extendedProxyMethodInvocationinterface.Invokes the target object using reflection. Subclasses can override the
invokeJoinpoint()method to change this behavior, so this is also a useful base class for more specialized MethodInvocation implementations.It is possible to clone an invocation, to invoke
proceed()repeatedly (once per clone), using theinvocableClone()method. It is also possible to attach custom attributes to the invocation, using thesetUserAttribute(java.lang.String, java.lang.Object)/getUserAttribute(java.lang.String)methods.NOTE: This class is considered internal and should not be directly accessed. The sole reason for it being public is compatibility with existing framework integrations (e.g. Pitchfork). For any other purposes, use the
ProxyMethodInvocationinterface instead.- Author:
- Rod Johnson, Juergen Hoeller, Adrian Colyer
- See Also:
invokeJoinpoint(),proceed(),invocableClone(),setUserAttribute(java.lang.String, java.lang.Object),getUserAttribute(java.lang.String)
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Object[]getArguments()Get the arguments as an array object.MethodgetMethod()Return the method invoked on the proxied interface.ObjectgetProxy()Return the proxy that this method invocation was made through.AccessibleObjectgetStaticPart()Return the static part of this joinpoint.ObjectgetThis()Return the object that holds the current joinpoint's static part.ObjectgetUserAttribute(String key)Return the value of the specified user attribute.Map<String,Object>getUserAttributes()Return user attributes associated with this invocation.MethodInvocationinvocableClone()This implementation returns a shallow copy of this invocation object, including an independent copy of the original arguments array.MethodInvocationinvocableClone(Object... arguments)This implementation returns a shallow copy of this invocation object, using the given arguments array for the clone.protected ObjectinvokeJoinpoint()Invoke the joinpoint using reflection.Objectproceed()Proceed to the next interceptor in the chain.voidsetArguments(Object... arguments)Set the arguments to be used on subsequent invocations in the any advice in this chain.voidsetUserAttribute(String key, Object value)Add the specified user attribute with the given value to this invocation.StringtoString()
Field Detail
interceptorsAndDynamicMethodMatchers
protected final List<?> interceptorsAndDynamicMethodMatchers
List of MethodInterceptor and InterceptorAndDynamicMethodMatcher that need dynamic checks.
Constructor Detail
ReflectiveMethodInvocation
protected ReflectiveMethodInvocation(Object proxy, Object target, Method method, Object[] arguments, Class<?> targetClass, List<Object> interceptorsAndDynamicMethodMatchers)
Construct a new ReflectiveMethodInvocation with the given arguments.- Parameters:
proxy- the proxy object that the invocation was made ontarget- the target object to invokemethod- the method to invokearguments- the arguments to invoke the method withtargetClass- the target class, for MethodMatcher invocationsinterceptorsAndDynamicMethodMatchers- interceptors that should be applied, along with any InterceptorAndDynamicMethodMatchers that need evaluation at runtime. MethodMatchers included in this struct must already have been found to have matched as far as was possibly statically. Passing an array might be about 10% faster, but would complicate the code. And it would work only for static pointcuts.
Method Detail
getProxy
public final Object getProxy()
Description copied from interface:ProxyMethodInvocationReturn the proxy that this method invocation was made through.- Specified by:
getProxyin interfaceProxyMethodInvocation- Returns:
- the original proxy object
getThis
public final Object getThis()
Description copied from interface:JoinpointReturn the object that holds the current joinpoint's static part.For instance, the target object for an invocation.
getStaticPart
public final AccessibleObject getStaticPart()
Description copied from interface:JoinpointReturn the static part of this joinpoint.The static part is an accessible object on which a chain of interceptors are installed.
- Specified by:
getStaticPartin interfaceJoinpoint
getMethod
public final Method getMethod()
Return the method invoked on the proxied interface. May or may not correspond with a method invoked on an underlying implementation of that interface.- Specified by:
getMethodin interfaceMethodInvocation- Returns:
- the method being called
getArguments
public final Object[] getArguments()
Description copied from interface:InvocationGet the arguments as an array object. It is possible to change element values within this array to change the arguments.- Specified by:
getArgumentsin interfaceInvocation- Returns:
- the argument of the invocation
setArguments
public void setArguments(Object... arguments)
Description copied from interface:ProxyMethodInvocationSet the arguments to be used on subsequent invocations in the any advice in this chain.- Specified by:
setArgumentsin interfaceProxyMethodInvocation- Parameters:
arguments- the argument array
proceed
public Object proceed() throws Throwable
Description copied from interface:JoinpointProceed to the next interceptor in the chain.The implementation and the semantics of this method depends on the actual joinpoint type (see the children interfaces).
invokeJoinpoint
protected Object invokeJoinpoint() throws Throwable
Invoke the joinpoint using reflection. Subclasses can override this to use custom invocation.- Returns:
- the return value of the joinpoint
- Throws:
Throwable- if invoking the joinpoint resulted in an exception
invocableClone
public MethodInvocation invocableClone()
This implementation returns a shallow copy of this invocation object, including an independent copy of the original arguments array.We want a shallow copy in this case: We want to use the same interceptor chain and other object references, but we want an independent value for the current interceptor index.
- Specified by:
invocableClonein interfaceProxyMethodInvocation- Returns:
- an invocable clone of this invocation.
proceed()can be called once per clone. - See Also:
Object.clone()
invocableClone
public MethodInvocation invocableClone(Object... arguments)
This implementation returns a shallow copy of this invocation object, using the given arguments array for the clone.We want a shallow copy in this case: We want to use the same interceptor chain and other object references, but we want an independent value for the current interceptor index.
- Specified by:
invocableClonein interfaceProxyMethodInvocation- Parameters:
arguments- the arguments that the cloned invocation is supposed to use, overriding the original arguments- Returns:
- an invocable clone of this invocation.
proceed()can be called once per clone. - See Also:
Object.clone()
setUserAttribute
public void setUserAttribute(String key, Object value)
Description copied from interface:ProxyMethodInvocationAdd the specified user attribute with the given value to this invocation.Such attributes are not used within the AOP framework itself. They are just kept as part of the invocation object, for use in special interceptors.
- Specified by:
setUserAttributein interfaceProxyMethodInvocation- Parameters:
key- the name of the attributevalue- the value of the attribute, ornullto reset it
getUserAttribute
public Object getUserAttribute(String key)
Description copied from interface:ProxyMethodInvocationReturn the value of the specified user attribute.- Specified by:
getUserAttributein interfaceProxyMethodInvocation- Parameters:
key- the name of the attribute- Returns:
- the value of the attribute, or
nullif not set - See Also:
ProxyMethodInvocation.setUserAttribute(java.lang.String, java.lang.Object)
getUserAttributes
public Map<String,Object> getUserAttributes()
Return user attributes associated with this invocation. This method provides an invocation-bound alternative to a ThreadLocal.This map is initialized lazily and is not used in the AOP framework itself.
- Returns:
- any user attributes associated with this invocation (never
null)