TestExecutionListeners.java (spring-framework-5.3.23) | : | TestExecutionListeners.java (spring-framework-5.3.24) | ||
---|---|---|---|---|
skipping to change at line 33 | skipping to change at line 33 | |||
import java.lang.annotation.RetentionPolicy; | import java.lang.annotation.RetentionPolicy; | |||
import java.lang.annotation.Target; | import java.lang.annotation.Target; | |||
import org.springframework.core.annotation.AliasFor; | import org.springframework.core.annotation.AliasFor; | |||
/** | /** | |||
* {@code TestExecutionListeners} defines class-level metadata for configuring | * {@code TestExecutionListeners} defines class-level metadata for configuring | |||
* which {@link TestExecutionListener TestExecutionListeners} should be | * which {@link TestExecutionListener TestExecutionListeners} should be | |||
* registered with a {@link TestContextManager}. | * registered with a {@link TestContextManager}. | |||
* | * | |||
* <p>Typically, {@code @TestExecutionListeners} will be used in conjunction | * <p>{@code @TestExecutionListeners} is used to register listeners for a | |||
* with {@link ContextConfiguration @ContextConfiguration}. | * particular test class, its subclasses, and its nested classes. If you wish to | |||
* register a listener globally, you should register it via the automatic discov | ||||
ery | ||||
* mechanism described in {@link TestExecutionListener}. | ||||
* | * | |||
* <p>This annotation may be used as a <em>meta-annotation</em> to create custom | * <p>This annotation may be used as a <em>meta-annotation</em> to create custom | |||
* <em>composed annotations</em>. | * <em>composed annotations</em>. As of Spring Framework 5.3, this annotation wi | |||
* | ll | |||
* <p>As of Spring Framework 5.3, this annotation will be inherited from an | * be inherited from an enclosing test class by default. See | |||
* enclosing test class by default. See | ||||
* {@link NestedTestConfiguration @NestedTestConfiguration} for details. | * {@link NestedTestConfiguration @NestedTestConfiguration} for details. | |||
* | * | |||
* <h3>Switching to default {@code TestExecutionListener} implementations</h3> | ||||
* | ||||
* <p>If you extend a class that is annotated with {@code @TestExecutionListener | ||||
s} | ||||
* and you need to switch to using the <em>default</em> set of listeners, you | ||||
* can annotate your class with the following. | ||||
* | ||||
* <pre class="code"> | ||||
* // Switch to default listeners | ||||
* @TestExecutionListeners(listeners = {}, inheritListeners = false, mergeM | ||||
ode = MERGE_WITH_DEFAULTS) | ||||
* class MyTests extends BaseTests { | ||||
* // ... | ||||
* } | ||||
* </pre> | ||||
* | ||||
* @author Sam Brannen | * @author Sam Brannen | |||
* @since 2.5 | * @since 2.5 | |||
* @see TestExecutionListener | * @see TestExecutionListener | |||
* @see TestContextManager | * @see TestContextManager | |||
* @see ContextConfiguration | * @see ContextConfiguration | |||
*/ | */ | |||
@Target(ElementType.TYPE) | @Target(ElementType.TYPE) | |||
@Retention(RetentionPolicy.RUNTIME) | @Retention(RetentionPolicy.RUNTIME) | |||
@Documented | @Documented | |||
@Inherited | @Inherited | |||
End of changes. 3 change blocks. | ||||
6 lines changed or deleted | 24 lines changed or added |