当前页面: 在线文档首页 > Spring Framework 2.1.0 API 文档英文版

ReflectiveMethodInvocation (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.springframework.aop.framework
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 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.

Author:

Rod Johnson, Juergen Hoeller

See Also:

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

---

Field Summary
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
ReflectiveMethodInvocation(Object proxy, Object target, Method method, Object[] arguments, Class targetClass, List interceptorsAndDynamicMethodMatchers)           Construct a new ReflectiveMethodInvocation with the given arguments.

 

Method Summary
Object[]	getArguments()
Method	getMethod()           Return the method invoked on the proxied interface.
Object	getProxy()           Return the proxy that this method invocation was made through.
AccessibleObject	getStaticPart()
Object	getThis()
Object	getUserAttribute(String key)           Return the value of the specified user attribute.
Map	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()
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

public ReflectiveMethodInvocation(Object proxy,
                                  Object target,
                                  Method method,
                                  Object[] arguments,
                                  Class targetClass,
                                  List 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()

Specified by:

getThis in interface Joinpoint

---

getStaticPart

public final AccessibleObject getStaticPart()

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

---

getArguments

public final Object[] getArguments()

Specified by:

getArguments in interface Invocation

---

proceed

public Object proceed()
               throws Throwable

Specified by:

proceed in interface Joinpoint

Throws:

Throwable

---

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 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

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Copyright © 2002-2007 The Spring Framework.