Document AopTestUtils in the reference manual

Issue: SPR-13006
master
Sam Brannen 9 years ago
parent 420e8ca833
commit 2dfa1804f4
  1. 17
      src/asciidoc/testing.adoc
  2. 1
      src/asciidoc/whats-new.adoc

@ -90,10 +90,12 @@ objects, targeted at usage with Spring's Portlet MVC framework.
[[unit-testing-utilities]] [[unit-testing-utilities]]
==== General utilities ==== General testing utilities
The `org.springframework.test.util` package contains `ReflectionTestUtils`, which is a The `org.springframework.test.util` package contains several general purpose utilities
collection of reflection-based utility methods. Developers use these methods in unit and for use in unit and integration testing.
integration testing scenarios in which they need to change the value of a constant, set
`ReflectionTestUtils` is a collection of reflection-based utility methods. Developers use
these methods in testing scenarios where they need to change the value of a constant, set
a non-++public++ field, invoke a non-++public++ setter method, or invoke a non-++public++ a non-++public++ field, invoke a non-++public++ setter method, or invoke a non-++public++
_configuration_ or _lifecycle_ callback method when testing application code involving _configuration_ or _lifecycle_ callback method when testing application code involving
use cases such as the following. use cases such as the following.
@ -106,6 +108,13 @@ use cases such as the following.
* Use of annotations such as `@PostConstruct` and `@PreDestroy` for lifecycle callback * Use of annotations such as `@PostConstruct` and `@PreDestroy` for lifecycle callback
methods. methods.
`AopTestUtils` is a collection of AOP-related utility methods. These methods can be used
to obtain a reference to the underlying target object hidden behind one or more Spring
proxies. For example, if you have configured a bean as a dynamic mock using a library
like EasyMock or Mockito and the mock is wrapped in a Spring proxy, you may need direct
access to the underlying mock in order to configure expectations on it and perform
verifications. For Spring's core AOP utilities, see `AopUtils` and `AopProxyUtils`.
[[unit-testing-spring-mvc]] [[unit-testing-spring-mvc]]

@ -564,6 +564,7 @@ public @interface MyTestConfig {
* `AopTestUtils` is a new testing utility that allows developers to * `AopTestUtils` is a new testing utility that allows developers to
obtain a reference to the underlying target object hidden behind one obtain a reference to the underlying target object hidden behind one
or more Spring proxies. or more Spring proxies.
** See <<unit-testing-utilities>> for details.
* `ReflectionTestUtils` now supports setting and getting `static` fields, * `ReflectionTestUtils` now supports setting and getting `static` fields,
including constants. including constants.
* The original ordering of bean definition profiles declared via * The original ordering of bean definition profiles declared via

Loading…
Cancel
Save