org.springframework.aop.support
Class AopUtils

java.lang.Object
  org.springframework.aop.support.AopUtils

public abstract class AopUtils
extends Object

Utility methods used by the AOP framework and by AOP proxy factories. Mainly for internal use within the framework.

See AopProxyUtils for a collection of framework-specific AOP utility methods which depend on internals of Spring's AOP framework implementation.

Author:

Rod Johnson, Juergen Hoeller, Rob Harrop

See Also:

AopProxyUtils

Constructor Summary

AopUtils()

Method Summary

static boolean	canApply(Advisor advisor, Class targetClass) Can the given advisor apply at all on the given class?
static boolean	canApply(Advisor advisor, Class targetClass, boolean hasIntroductions) Can the given advisor apply at all on the given class?
static boolean	canApply(Pointcut pc, Class targetClass) Can the given pointcut apply at all on the given class?
static boolean	canApply(Pointcut pc, Class targetClass, boolean hasIntroductions) Can the given pointcut apply at all on the given class?
static List	findAdvisorsThatCanApply(List candidateAdvisors, Class clazz) Determine the sublist of the candidateAdvisors list that is applicable to the given class.
static Method	getMostSpecificMethod(Method method, Class targetClass) Given a method, which may come from an interface, and a targetClass used in the current AOP invocation, find the most specific method if there is one.
static Object	invokeJoinpointUsingReflection(Object target, Method method, Object[] args) Invoke the target directly via reflection.
static boolean	isAopProxy(Object object) Return whether the given object is either a JDK dynamic proxy or a CGLIB proxy.
static boolean	isCglibProxy(Object object) Return whether the given object is a CGLIB proxy.
static boolean	isCglibProxyClass(Class clazz) Return whether the specified class is a CGLIB-generated class.
static boolean	isEqualsMethod(Method method) Return whether the given method is an "equals" method.
static boolean	isHashCodeMethod(Method method) Return whether the given method is a "hashCode" method.
static boolean	isJdkDynamicProxy(Object object) Return whether the given object is a JDK dynamic proxy.
static boolean	isToStringMethod(Method method) Return whether the given method is a "toString" method.

Methods inherited from class java.lang.Object

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

Constructor Detail

AopUtils

public AopUtils()

Method Detail

isAopProxy

public static boolean isAopProxy(Object object)

Return whether the given object is either a JDK dynamic proxy or a CGLIB proxy.

Parameters:

object - the object to check

See Also:

isJdkDynamicProxy(java.lang.Object), isCglibProxy(java.lang.Object)

isJdkDynamicProxy

public static boolean isJdkDynamicProxy(Object object)

Return whether the given object is a JDK dynamic proxy.

Parameters:

object - the object to check

See Also:

Proxy.isProxyClass(java.lang.Class)

isCglibProxy

public static boolean isCglibProxy(Object object)

Return whether the given object is a CGLIB proxy.

Parameters:

object - the object to check

isCglibProxyClass

public static boolean isCglibProxyClass(Class clazz)

Return whether the specified class is a CGLIB-generated class.

Parameters:

clazz - the class to check

isEqualsMethod

public static boolean isEqualsMethod(Method method)

Return whether the given method is an "equals" method.

See Also:

Object.equals(java.lang.Object)

isHashCodeMethod

public static boolean isHashCodeMethod(Method method)

Return whether the given method is a "hashCode" method.

See Also:

Object.hashCode()

isToStringMethod

public static boolean isToStringMethod(Method method)

Return whether the given method is a "toString" method.

See Also:

Object.toString()

getMostSpecificMethod

public static Method getMostSpecificMethod(Method method,
                                           Class targetClass)

Given a method, which may come from an interface, and a targetClass used in the current AOP invocation, find the most specific method if there is one. E.g. the method may be IFoo.bar() and the target class may be DefaultFoo. In this case, the method may be DefaultFoo.bar(). This enables attributes on that method to be found.

Parameters:

method - method to be invoked, which may come from an interface

targetClass - target class for the curren invocation. May be null or may not even implement the method.

Returns:

the more specific method, or the original method if the targetClass doesn't specialize it or implement it or is null

canApply

public static boolean canApply(Pointcut pc,
                               Class targetClass)

Can the given pointcut apply at all on the given class? This is an important test as it can be used to optimize out a pointcut for a class.

Parameters:

pc - pc static or dynamic pointcut to check

targetClass - class we're testing

Returns:

whether the pointcut can apply on any method

canApply

public static boolean canApply(Pointcut pc,
                               Class targetClass,
                               boolean hasIntroductions)

Can the given pointcut apply at all on the given class? This is an important test as it can be used to optimize out a pointcut for a class.

Parameters:

pc - pc static or dynamic pointcut to check

targetClass - class we're testing

hasIntroductions - whether or not the advisor chain for this bean includes any introductions

Returns:

whether the pointcut can apply on any method

canApply

public static boolean canApply(Advisor advisor,
                               Class targetClass)

Can the given advisor apply at all on the given class? This is an important test as it can be used to optimize out a advisor for a class.

Parameters:

advisor - the advisor to check

targetClass - class we're testing

Returns:

whether the pointcut can apply on any method

canApply

public static boolean canApply(Advisor advisor,
                               Class targetClass,
                               boolean hasIntroductions)

Can the given advisor apply at all on the given class? This is an important test as it can be used to optimize out a advisor for a class. This version also takes into account introductions, for IntroductionAwareMethodMatchers

Parameters:

advisor - the advisor to check

targetClass - class we're testing

hasIntroductions - whether or not the advisor chain for this bean includes any introductions

Returns:

whether the pointcut can apply on any method

findAdvisorsThatCanApply

public static List findAdvisorsThatCanApply(List candidateAdvisors,
                                            Class clazz)

Determine the sublist of the candidateAdvisors list that is applicable to the given class.

Parameters:

candidateAdvisors - Advisors to evaluate

clazz - the target class

Returns:

sublist of Advisors that can apply to an object of the given class

invokeJoinpointUsingReflection

public static Object invokeJoinpointUsingReflection(Object target,
                                                    Method method,
                                                    Object[] args)
                                             throws Throwable

Invoke the target directly via reflection.

Parameters:

target - the target object

method - the method to invoke

args - the arguments for the method

Throws:

Throwable - if thrown by the target method

AopInvocationException - in case of a reflection error