|
39 | 39 | * mode</em> will be used. See {@link #ENCLOSING_CONFIGURATION_PROPERTY_NAME} for
|
40 | 40 | * details on how to change the default mode.
|
41 | 41 | *
|
42 |
| - * <p>By default, if {@code @NestedTestConfiguration} is not <em>present</em> or |
43 |
| - * <em>meta-present</em> on a test class, configuration from the test class will |
44 |
| - * propagate to inner test classes (see {@link EnclosingConfiguration#INHERIT}). |
45 |
| - * If {@code @NestedTestConfiguration(OVERRIDE)} is used to switch the mode, |
| 42 | + * <p>When the {@link EnclosingConfiguration#INHERIT INHERIT} mode is in use, |
| 43 | + * configuration from an enclosing test class will be inherited by inner test |
| 44 | + * classes, analogous to the semantics within a test class inheritance hierarchy. |
| 45 | + * When the {@link EnclosingConfiguration#OVERRIDE OVERRIDE} mode is in use, |
46 | 46 | * inner test classes will have to declare their own Spring test configuration
|
47 | 47 | * annotations. If you wish to explicitly configure the mode, annotate either
|
48 |
| - * the inner test class or an enclosing class with |
49 |
| - * {@code @NestedTestConfiguration(...}. Note that a |
| 48 | + * the inner test class or one of its enclosing classes with |
| 49 | + * {@code @NestedTestConfiguration(...)}. Note that a |
50 | 50 | * {@code @NestedTestConfiguration(...)} declaration is inherited within the
|
51 | 51 | * superclass hierarchy as well as within the enclosing class hierarchy. Thus,
|
52 | 52 | * there is no need to redeclare the annotation unless you wish to switch the
|
|
57 | 57 | *
|
58 | 58 | * <p>As of Spring Framework 5.3, the use of this annotation typically only makes
|
59 | 59 | * sense in conjunction with {@link org.junit.jupiter.api.Nested @Nested} test
|
60 |
| - * classes in JUnit Jupiter. |
| 60 | + * classes in JUnit Jupiter; however, there may be other testing frameworks with |
| 61 | + * support for nested test classes that could also make use of this annotation. |
61 | 62 | *
|
62 | 63 | * @author Sam Brannen
|
63 | 64 | * @since 5.3
|
|
0 commit comments