Provide support for publishing TestContext lifecycle events

This commit introduces a new EventPublishingTestExecutionListener for
publishing events to the test ApplicationContext. These may be consumed
by @EventListener annotated methods to react to the TestContext
lifecycle. The listener is not registered by default.

Closes gh-18490

spring-test/src/main/java/org/springframework/test/context/TestExecutionListener.java

@@ -56,6 +56,8 @@ package org.springframework.test.context;
  * TransactionalTestExecutionListener}</li>
  * <li>{@link org.springframework.test.context.jdbc.SqlScriptsTestExecutionListener
  * SqlScriptsTestExecutionListener}</li>
+ * <li>{@link org.springframework.test.context.event.EventPublishingTestExecutionListener
+ * EventPublishingTestExecutionListener} (not registered by default)</li>
  * </ul>
  *
  * @author Sam Brannen

spring-test/src/main/java/org/springframework/test/context/TestExecutionListeners.java

@@ -66,6 +66,7 @@ public @interface TestExecutionListeners {
 	 * @see org.springframework.test.context.support.DirtiesContextTestExecutionListener
 	 * @see org.springframework.test.context.transaction.TransactionalTestExecutionListener
 	 * @see org.springframework.test.context.jdbc.SqlScriptsTestExecutionListener
+	 * @see org.springframework.test.context.event.EventPublishingTestExecutionListener
 	 */
 	@AliasFor("value")
 	Class<? extends TestExecutionListener>[] listeners() default {};

spring-test/src/main/java/org/springframework/test/context/event/AfterTestClassEvent.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#afterTestClass(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.AfterTestClass
+ */
+@SuppressWarnings("serial")
+public class AfterTestClassEvent extends TestContextEvent {
+
+    public AfterTestClassEvent(TestContext source) {
+        super(source);
+    }
+}

spring-test/src/main/java/org/springframework/test/context/event/AfterTestExecutionEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#afterTestExecution(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.AfterTestExecution
+ */
+@SuppressWarnings("serial")
+public class AfterTestExecutionEvent extends TestContextEvent {
+
+    public AfterTestExecutionEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/AfterTestMethodEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#afterTestMethod(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.AfterTestMethod
+ */
+@SuppressWarnings("serial")
+public class AfterTestMethodEvent extends TestContextEvent {
+
+    public AfterTestMethodEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/BeforeTestClassEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#beforeTestClass(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.BeforeTestClass
+ */
+@SuppressWarnings("serial")
+public class BeforeTestClassEvent extends TestContextEvent {
+
+    public BeforeTestClassEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/BeforeTestExecutionEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#beforeTestExecution(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.BeforeTestExecution
+ */
+@SuppressWarnings("serial")
+public class BeforeTestExecutionEvent extends TestContextEvent {
+
+    public BeforeTestExecutionEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/BeforeTestMethodEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#beforeTestMethod(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.BeforeTestMethod
+ */
+@SuppressWarnings("serial")
+public class BeforeTestMethodEvent extends TestContextEvent {
+
+    public BeforeTestMethodEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/EventPublishingTestExecutionListener.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+import org.springframework.test.context.support.AbstractTestExecutionListener;
+
+/**
+ * {@link org.springframework.test.context.TestExecutionListener} that may be used to publish test life-cycle event to
+ * the Spring test {@link org.springframework.context.ApplicationContext}.
+ *
+ * <p>These events may be consumed for various reasons, such as resetting {@em mock} beans or tracing test
+ * execution. Since these events may consumed as part of regular Spring beans, they can be shared among
+ * different test classes.
+ *
+ * <p>This {@link org.springframework.test.context.TestExecutionListener} is not active by default. Test classes
+ * should be annotated using {@link org.springframework.test.context.TestExecutionListeners}, if they want to use it.
+ * Alternatively, it may be added to {@code spring.factories}, if needed.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.BeforeTestClass
+ * @see org.springframework.test.context.event.annotation.PrepareTestInstance
+ * @see org.springframework.test.context.event.annotation.BeforeTestMethod
+ * @see org.springframework.test.context.event.annotation.BeforeTestExecution
+ * @see org.springframework.test.context.event.annotation.AfterTestExecution
+ * @see org.springframework.test.context.event.annotation.AfterTestMethod
+ * @see org.springframework.test.context.event.annotation.AfterTestClass
+ */
+public class EventPublishingTestExecutionListener extends AbstractTestExecutionListener {
+
+    @Override
+    public void beforeTestClass(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new BeforeTestClassEvent(testContext));
+    }
+
+    @Override
+    public void prepareTestInstance(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new PrepareTestInstanceEvent(testContext));
+    }
+
+    @Override
+    public void beforeTestMethod(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new BeforeTestMethodEvent(testContext));
+    }
+
+    @Override
+    public void beforeTestExecution(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new BeforeTestExecutionEvent(testContext));
+    }
+
+    @Override
+    public void afterTestExecution(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new AfterTestExecutionEvent(testContext));
+    }
+
+    @Override
+    public void afterTestMethod(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new AfterTestMethodEvent(testContext));
+    }
+
+    @Override
+    public void afterTestClass(TestContext testContext) {
+        testContext.getApplicationContext().publishEvent(
+                new AfterTestClassEvent(testContext));
+    }
+}

spring-test/src/main/java/org/springframework/test/context/event/PrepareTestInstanceEvent.java

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.test.context.TestContext;
+
+/**
+ * {@link TestContextEvent} published by {@link EventPublishingTestExecutionListener} when
+ * {@link org.springframework.test.context.TestExecutionListener#prepareTestInstance(TestContext)} is called.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see org.springframework.test.context.event.annotation.PrepareTestInstance
+ */
+@SuppressWarnings("serial")
+public class PrepareTestInstanceEvent extends TestContextEvent {
+
+    public PrepareTestInstanceEvent(TestContext source) {
+        super(source);
+    }
+
+}

spring-test/src/main/java/org/springframework/test/context/event/TestContextEvent.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event;
+
+import org.springframework.context.ApplicationEvent;
+import org.springframework.test.context.TestContext;
+
+/**
+ * Base class for events published by {@link EventPublishingTestExecutionListener}.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ */
+@SuppressWarnings("serial")
+public abstract class TestContextEvent extends ApplicationEvent {
+
+    public TestContextEvent(TestContext source) {
+        super(source);
+    }
+
+    /*
+     * (non-Javadoc)
+     *
+     * @see java.util.EventObject#getSource()
+     */
+    @Override
+    public TestContext getSource() {
+        return (TestContext) super.getSource();
+    }
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/AfterTestClass.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.AfterTestClassEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link AfterTestClassEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#afterTestClass(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see AfterTestClassEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(AfterTestClassEvent.class)
+public @interface AfterTestClass {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/AfterTestExecution.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.AfterTestExecutionEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link AfterTestExecutionEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#afterTestExecution(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see AfterTestExecutionEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(AfterTestExecutionEvent.class)
+public @interface AfterTestExecution {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/AfterTestMethod.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.AfterTestMethodEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link AfterTestMethodEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#afterTestMethod(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see AfterTestMethodEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(AfterTestMethodEvent.class)
+public @interface AfterTestMethod {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/BeforeTestClass.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.BeforeTestClassEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link BeforeTestClassEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#beforeTestClass(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see BeforeTestClassEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(BeforeTestClassEvent.class)
+public @interface BeforeTestClass {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/BeforeTestExecution.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.BeforeTestExecutionEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link BeforeTestExecutionEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#beforeTestExecution(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see BeforeTestExecutionEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(BeforeTestExecutionEvent.class)
+public @interface BeforeTestExecution {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/BeforeTestMethod.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.BeforeTestMethodEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link BeforeTestMethodEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#beforeTestMethod(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see BeforeTestMethodEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(BeforeTestMethodEvent.class)
+public @interface BeforeTestMethod {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/PrepareTestInstance.java

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2002-2019 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.test.context.event.annotation;
+
+import org.springframework.context.event.EventListener;
+import org.springframework.test.context.event.PrepareTestInstanceEvent;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+import static java.lang.annotation.ElementType.ANNOTATION_TYPE;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+/**
+ * {@link EventListener} annotation used to consume {@link PrepareTestInstanceEvent}s published
+ * by {@link org.springframework.test.context.event.EventPublishingTestExecutionListener}.
+ *
+ * <p>This annotation may be used on {@link EventListener}-compliant methods within the Spring test
+ * {@link org.springframework.context.ApplicationContext}, typically within
+ * {@link org.springframework.context.annotation.Configuration}s. A method annotated hereby will be
+ * called as part of the {@link org.springframework.test.context.TestExecutionListener#prepareTestInstance(org.springframework.test.context.TestContext)}
+ * life-cycle method.
+ *
+ * <p>Make sure {@link org.springframework.test.context.event.EventPublishingTestExecutionListener} is enabled,
+ * for this annotation to have an effect, e.g. by annotation your test class with
+ * {@link org.springframework.test.context.TestExecutionListeners} accordingly.
+ *
+ * @author Frank Scheffler
+ * @since 5.2
+ * @see PrepareTestInstanceEvent
+ */
+@Documented
+@Retention(RUNTIME)
+@Target({METHOD, ANNOTATION_TYPE})
+@EventListener(PrepareTestInstanceEvent.class)
+public @interface PrepareTestInstance {
+}

spring-test/src/main/java/org/springframework/test/context/event/annotation/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Test event annotations for the <em>Spring TestContext Framework</em>.
+ */
+package org.springframework.test.context.event.annotation;

spring-test/src/main/java/org/springframework/test/context/event/package-info.java

@@ -0,0 +1,4 @@
+/**
+ * Test event support classes for the <em>Spring TestContext Framework</em>.
+ */
+package org.springframework.test.context.event;