Document how to switch to the default set of TestExecutionListeners

Closes gh-29281
spring-projects · Oct 8, 2022 · b71d95d · b71d95d
1 parent b20de75
commit b71d95d
Show file tree

Hide file tree

Showing 4 changed files with 20 additions and 12 deletions.
diff --git a/...c/main/java/org/springframework/test/context/junit4/AbstractJUnit4SpringContextTests.java b/...c/main/java/org/springframework/test/context/junit4/AbstractJUnit4SpringContextTests.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2022 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.
@@ -49,8 +49,10 @@
  * the appropriate {@link org.springframework.test.context.TestExecutionListener
  * TestExecutionListeners} manually.</em>
  *
- * <p>The following {@link org.springframework.test.context.TestExecutionListener
- * TestExecutionListeners} are configured by default:
+ * <p>This class explicitly registers the following {@code TestExecutionListener}
+ * implementations. If you want to switch to using the <em>default</em> set of
+ * listeners, see the class-level Javadoc for
+ * {@link TestExecutionListeners @TestExecutionListeners} for details.
  *
  * <ul>
  * <li>{@link org.springframework.test.context.web.ServletTestExecutionListener}

diff --git a/...rg/springframework/test/context/junit4/AbstractTransactionalJUnit4SpringContextTests.java b/...rg/springframework/test/context/junit4/AbstractTransactionalJUnit4SpringContextTests.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2022 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.
@@ -57,8 +57,10 @@
  * <p>Concrete subclasses must fulfill the same requirements outlined in
  * {@link AbstractJUnit4SpringContextTests}.
  *
- * <p>The following {@link org.springframework.test.context.TestExecutionListener
- * TestExecutionListeners} are configured by default:
+ * <p>This class explicitly registers the following {@code TestExecutionListener}
+ * implementations. If you want to switch to using the <em>default</em> set of
+ * listeners, see the class-level Javadoc for
+ * {@link TestExecutionListeners @TestExecutionListeners} for details.
  *
  * <ul>
  * <li>{@link org.springframework.test.context.web.ServletTestExecutionListener}

diff --git a/...c/main/java/org/springframework/test/context/testng/AbstractTestNGSpringContextTests.java b/...c/main/java/org/springframework/test/context/testng/AbstractTestNGSpringContextTests.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2022 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.
@@ -59,8 +59,10 @@
  * TestExecutionListeners} manually.</em> Concrete subclasses must also have
  * constructors which either implicitly or explicitly delegate to {@code super();}.
  *
- * <p>The following {@link org.springframework.test.context.TestExecutionListener
- * TestExecutionListeners} are configured by default:
+ * <p>This class explicitly registers the following {@code TestExecutionListener}
+ * implementations. If you want to switch to using the <em>default</em> set of
+ * listeners, see the class-level Javadoc for
+ * {@link TestExecutionListeners @TestExecutionListeners} for details.
  *
  * <ul>
  * <li>{@link org.springframework.test.context.web.ServletTestExecutionListener}

diff --git a/...rg/springframework/test/context/testng/AbstractTransactionalTestNGSpringContextTests.java b/...rg/springframework/test/context/testng/AbstractTransactionalTestNGSpringContextTests.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2020 the original author or authors.
+ * Copyright 2002-2022 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.
@@ -56,8 +56,10 @@
  * <p>Concrete subclasses must fulfill the same requirements outlined in
  * {@link AbstractTestNGSpringContextTests}.
  *
- * <p>The following {@link org.springframework.test.context.TestExecutionListener
- * TestExecutionListeners} are configured by default:
+ * <p>This class explicitly registers the following {@code TestExecutionListener}
+ * implementations. If you want to switch to using the <em>default</em> set of
+ * listeners, see the class-level Javadoc for
+ * {@link TestExecutionListeners @TestExecutionListeners} for details.
  *
  * <ul>
  * <li>{@link org.springframework.test.context.web.ServletTestExecutionListener}