org.springframework.test.util

Class AopTestUtils

java.lang.Object

org.springframework.test.util.AopTestUtils

public class AopTestUtils
extends java.lang.Object

AopTestUtils is a collection of AOP-related utility methods for use in unit and integration testing scenarios.

For Spring's core AOP utilities, see AopUtils and AopProxyUtils.

Since:

4.2

Author:

Sam Brannen

See Also:

AopUtils, AopProxyUtils

Constructor Summary

Constructors

Constructor and Description
AopTestUtils()

Method Summary

Modifier and Type	Method and Description
static <T> T	getTargetObject(java.lang.Object candidate) Get the target object of the supplied candidate object.
static <T> T	getUltimateTargetObject(java.lang.Object candidate) Get the ultimate target object of the supplied candidate object, unwrapping not only a top-level proxy but also any number of nested proxies.

Methods inherited from class java.lang.Object

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

Constructor Detail

AopTestUtils

public AopTestUtils()

Method Detail

getTargetObject

public static <T> T getTargetObject(java.lang.Object candidate)

Get the target object of the supplied candidate object.

If the supplied candidate is a Spring proxy, the target of the proxy will be returned; otherwise, the candidate will be returned as is.

Parameters:

candidate - the instance to check (potentially a Spring AOP proxy); never null

Returns:

the target object or the candidate; never null

Throws:

java.lang.IllegalStateException - if an error occurs while unwrapping a proxy

See Also:

Advised.getTargetSource(), getUltimateTargetObject(java.lang.Object)

getUltimateTargetObject

public static <T> T getUltimateTargetObject(java.lang.Object candidate)

Get the ultimate target object of the supplied candidate object, unwrapping not only a top-level proxy but also any number of nested proxies.

If the supplied candidate is a Spring proxy, the ultimate target of all nested proxies will be returned; otherwise, the candidate will be returned as is.

Parameters:

candidate - the instance to check (potentially a Spring AOP proxy); never null

Returns:

the ultimate target object or the candidate; never null

Throws:

java.lang.IllegalStateException - if an error occurs while unwrapping a proxy

See Also:

Advised.getTargetSource(), AopProxyUtils.ultimateTargetClass(java.lang.Object)