ReflectiveMethodInvocation (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

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
extends Object
implements ProxyMethodInvocation, Cloneable

Spring's implementation of AOP Alliance MethodInvocation 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 add custom attributes to the invocation (since 1.2.6) using the getUserAttributes() method.

Author:: Rod Johnson, Juergen Hoeller
See Also:: invokeJoinpoint(), proceed(), invocableClone()

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 MethodInvocation with given arguments

Method Summary

Object[] getArguments()


Method getMethod()
          Return the method invoked on the proxied interface.

Object getProxy()
          Return the proxy that this interception was made through.

AccessibleObject getStaticPart()


Object getThis()


Map getUserAttributes()
          Return user attributes associated with this invocation.

MethodInvocation invocableClone()
          Create a clone of this object.

protected Object invokeJoinpoint()
          Invoke the joinpoint using reflection.

Object proceed()


String toString()


Methods inherited from class java.lang.Object

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

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 MethodInvocation with given arguments

Method Summary
`Object[]`	`getArguments()`
`Method`	`getMethod()` Return the method invoked on the proxied interface.
`Object`	`getProxy()` Return the proxy that this interception was made through.
`AccessibleObject`	`getStaticPart()`
`Object`	`getThis()`
`Map`	`getUserAttributes()` Return user attributes associated with this invocation.
`MethodInvocation`	`invocableClone()` Create a clone of this object.
`protected Object`	`invokeJoinpoint()` Invoke the joinpoint using reflection.
`Object`	`proceed()`
`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 MethodInvocation with given arguments

Parameters:: 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()

Return the proxy that this interception was made through.

Specified by:: getProxy in interface ProxyMethodInvocation

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

getUserAttributes

public Map getUserAttributes()

Return user attributes associated with this invocation. This map is initialized lazily and is not used in the AOP framework itself. This method provides an invocation-bound alternative to a ThreadLocal.

Returns:: any user attributes associated with this invocation (never null)

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

Create a clone of this object. If cloning is done before proceed() is invoked on this object, proceed() can be invoked once per clone to invoke the joinpoint (and the rest of the advice chain) more than once.

This method returns a shallow copy, except for the argument array, which is deep-copied to allow for independent modification. 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.

Returns:: an invocable clone of this invocation. proceed() can be called once per clone.
See Also:: Object.clone()

toString

public String toString()

Overrides:: toString in class Object