ReflectiveMethodInvocation (Spring Framework 4.3.12.RELEASE API)

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 Alliance MethodInvocation interface, implementing the extended ProxyMethodInvocation interface.
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 the invocableClone() method. It is also possible to attach custom attributes to the invocation, using the setUserAttribute(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 ProxyMethodInvocation interface instead.

Author:

Rod Johnson, Juergen Hoeller, Adrian Colyer

See Also:

invokeJoinpoint(), proceed(), invocableClone(), setUserAttribute(java.lang.String, java.lang.Object), getUserAttribute(java.lang.String)

Field Summary

Fields
Modifier and Type	Field and Description
`protected Object[]`	`arguments`
`protected List<?>`	`interceptorsAndDynamicMethodMatchers` List of MethodInterceptor and InterceptorAndDynamicMethodMatcher that need dynamic checks.
`protected Method`	`method`
`protected Object`	`proxy`
`protected Object`	`target`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`ReflectiveMethodInvocation(Object proxy, Object target, Method method, Object[] arguments, Class<?> targetClass, List<Object> interceptorsAndDynamicMethodMatchers)` Construct a new ReflectiveMethodInvocation with the given arguments.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Object[]`	`getArguments()` Get the arguments as an array object.
`Method`	`getMethod()` Return the method invoked on the proxied interface.
`Object`	`getProxy()` Return the proxy that this method invocation was made through.
`AccessibleObject`	`getStaticPart()` Return the static part of this joinpoint.
`Object`	`getThis()` Return the object that holds the current joinpoint's static part.
`Object`	`getUserAttribute(String key)` Return the value of the specified user attribute.
`Map<String,Object>`	`getUserAttributes()` Return user attributes associated with this invocation.
`MethodInvocation`	`invocableClone()` This implementation returns a shallow copy of this invocation object, including an independent copy of the original arguments array.
`MethodInvocation`	`invocableClone(Object... arguments)` This implementation returns a shallow copy of this invocation object, using the given arguments array for the clone.
`protected Object`	`invokeJoinpoint()` Invoke the joinpoint using reflection.
`Object`	`proceed()` Proceed to the next interceptor in the chain.
`void`	`setArguments(Object... arguments)` Set the arguments to be used on subsequent invocations in the any advice in this chain.
`void`	`setUserAttribute(String key, Object value)` Add the specified user attribute with the given value to this invocation.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - proxy
```
protected final Object proxy
```
  - target
```
protected final Object target
```
  - method
```
protected final Method method
```
  - arguments
```
protected Object[] arguments
```
  - 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 on
    
    target - the target object to invoke
    
    method - the method to invoke
    
    arguments - the arguments to invoke the method with
    
    targetClass - the target class, for MethodMatcher invocations
    
    interceptorsAndDynamicMethodMatchers - 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: ProxyMethodInvocation
    
    Return the proxy that this method invocation was made through.
    
    Specified by:
    
    getProxy in interface ProxyMethodInvocation
    
    Returns:
    
    the original proxy object
  - getThis
```
public final Object getThis()
```
    Description copied from interface: Joinpoint
    
    Return the object that holds the current joinpoint's static part.
    For instance, the target object for an invocation.
    
    Specified by:
    
    getThis in interface Joinpoint
    
    Returns:
    
    the object (can be null if the accessible object is static)
  - getStaticPart
```
public final AccessibleObject getStaticPart()
```
    Description copied from interface: Joinpoint
    
    Return the static part of this joinpoint.
    The static part is an accessible object on which a chain of interceptors are installed.
    
    Specified by:
    
    getStaticPart in interface Joinpoint
  - 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:
    
    getMethod in interface MethodInvocation
    
    Returns:
    
    the method being called
  - getArguments
```
public final Object[] getArguments()
```
    Description copied from interface: Invocation
    
    Get the arguments as an array object. It is possible to change element values within this array to change the arguments.
    
    Specified by:
    
    getArguments in interface Invocation
    
    Returns:
    
    the argument of the invocation
  - setArguments
```
public void setArguments(Object... arguments)
```
    Description copied from interface: ProxyMethodInvocation
    
    Set the arguments to be used on subsequent invocations in the any advice in this chain.
    
    Specified by:
    
    setArguments in interface ProxyMethodInvocation
    
    Parameters:
    
    arguments - the argument array
  - proceed
```
public Object proceed()
               throws Throwable
```
    Description copied from interface: Joinpoint
    
    Proceed 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).
    
    Specified by:
    
    proceed in interface Joinpoint
    
    Returns:
    
    see the children interfaces' proceed definition
    
    Throws:
    
    Throwable - if the joinpoint throws an exception
  - 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:
    
    invocableClone in interface ProxyMethodInvocation
    
    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:
    
    invocableClone in interface ProxyMethodInvocation
    
    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: ProxyMethodInvocation
    
    Add 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:
    
    setUserAttribute in interface ProxyMethodInvocation
    
    Parameters:
    
    key - the name of the attribute
    
    value - the value of the attribute, or null to reset it
  - getUserAttribute
```
public Object getUserAttribute(String key)
```
    Description copied from interface: ProxyMethodInvocation
    
    Return the value of the specified user attribute.
    
    Specified by:
    
    getUserAttribute in interface ProxyMethodInvocation
    
    Parameters:
    
    key - the name of the attribute
    
    Returns:
    
    the value of the attribute, or null if 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)
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class ReflectiveMethodInvocation

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

proxy

target

method

arguments

interceptorsAndDynamicMethodMatchers

Constructor Detail

ReflectiveMethodInvocation

Method Detail

getProxy

getThis

getStaticPart

getMethod

getArguments

setArguments

proceed

invokeJoinpoint

invocableClone

invocableClone

setUserAttribute

getUserAttribute

getUserAttributes

toString