TestExecutionListener.java (spring-framework-5.3.23) | : | TestExecutionListener.java (spring-framework-5.3.24) | ||
---|---|---|---|---|
/* | /* | |||
* Copyright 2002-2021 the original author or authors. | * Copyright 2002-2022 the original author or authors. | |||
* | * | |||
* Licensed under the Apache License, Version 2.0 (the "License"); | * Licensed under the Apache License, Version 2.0 (the "License"); | |||
* you may not use this file except in compliance with the License. | * you may not use this file except in compliance with the License. | |||
* You may obtain a copy of the License at | * You may obtain a copy of the License at | |||
* | * | |||
* https://www.apache.org/licenses/LICENSE-2.0 | * https://www.apache.org/licenses/LICENSE-2.0 | |||
* | * | |||
* Unless required by applicable law or agreed to in writing, software | * Unless required by applicable law or agreed to in writing, software | |||
* distributed under the License is distributed on an "AS IS" BASIS, | * distributed under the License is distributed on an "AS IS" BASIS, | |||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |||
skipping to change at line 44 | skipping to change at line 44 | |||
* <p>Concrete implementations must provide a {@code public} no-args constructor , | * <p>Concrete implementations must provide a {@code public} no-args constructor , | |||
* so that listeners can be instantiated transparently by tools and configuratio n | * so that listeners can be instantiated transparently by tools and configuratio n | |||
* mechanisms. | * mechanisms. | |||
* | * | |||
* <p>Implementations may optionally declare the position in which they should | * <p>Implementations may optionally declare the position in which they should | |||
* be ordered among the chain of default listeners via the | * be ordered among the chain of default listeners via the | |||
* {@link org.springframework.core.Ordered Ordered} interface or | * {@link org.springframework.core.Ordered Ordered} interface or | |||
* {@link org.springframework.core.annotation.Order @Order} annotation. See | * {@link org.springframework.core.annotation.Order @Order} annotation. See | |||
* {@link TestContextBootstrapper#getTestExecutionListeners()} for details. | * {@link TestContextBootstrapper#getTestExecutionListeners()} for details. | |||
* | * | |||
* <p>Spring provides the following out-of-the-box implementations (all of | * <h3>Registering TestExecutionListener Implementations</h3> | |||
* which implement {@code Ordered}): | * | |||
* <p>A {@code TestExecutionListener} can be registered explicitly for a test cl | ||||
ass, | ||||
* its subclasses, and its nested classes by using the | ||||
* {@link TestExecutionListeners @TestExecutionListeners} annotation. Explicit | ||||
* registration is suitable for custom listeners that are used in limited testin | ||||
g | ||||
* scenarios. However, it can become cumbersome if a custom listener needs to be | ||||
* used across an entire test suite. This issue is addressed through support for | ||||
* automatic discovery of <em>default</em> {@code TestExecutionListener} | ||||
* implementations through the | ||||
* {@link org.springframework.core.io.support.SpringFactoriesLoader SpringFactor | ||||
iesLoader} | ||||
* mechanism. Specifically, default {@code TestExecutionListener} implementation | ||||
s | ||||
* can be registered under the {@code org.springframework.test.context.TestExecu | ||||
tionListener} | ||||
* key in a {@code META-INF/spring.factories} properties file. | ||||
* | ||||
* <p>Spring provides the following implementations. Each of these implements | ||||
* {@code Ordered} and is registered automatically by default. | ||||
* | ||||
* <ul> | * <ul> | |||
* <li>{@link org.springframework.test.context.web.ServletTestExecutionListener | * <li>{@link org.springframework.test.context.web.ServletTestExecutionListener | |||
* ServletTestExecutionListener}</li> | * ServletTestExecutionListener}</li> | |||
* <li>{@link org.springframework.test.context.support.DirtiesContextBeforeModes TestExecutionListener | * <li>{@link org.springframework.test.context.support.DirtiesContextBeforeModes TestExecutionListener | |||
* DirtiesContextBeforeModesTestExecutionListener}</li> | * DirtiesContextBeforeModesTestExecutionListener}</li> | |||
* <li>{@link org.springframework.test.context.event.ApplicationEventsTestExecut ionListener | * <li>{@link org.springframework.test.context.event.ApplicationEventsTestExecut ionListener | |||
* ApplicationEventsTestExecutionListener}</li> | * ApplicationEventsTestExecutionListener}</li> | |||
* <li>{@link org.springframework.test.context.support.DependencyInjectionTestEx ecutionListener | * <li>{@link org.springframework.test.context.support.DependencyInjectionTestEx ecutionListener | |||
* DependencyInjectionTestExecutionListener}</li> | * DependencyInjectionTestExecutionListener}</li> | |||
* <li>{@link org.springframework.test.context.support.DirtiesContextTestExecuti onListener | * <li>{@link org.springframework.test.context.support.DirtiesContextTestExecuti onListener | |||
End of changes. 2 change blocks. | ||||
3 lines changed or deleted | 24 lines changed or added |