[SPR-5995] Updated documentation regarding compatibility with JUnit 4.5, 4.6, and 4.7.

This commit is contained in:
Sam Brannen 2009-08-26 13:13:06 +00:00
parent da3eb580f6
commit 8fb53c801e
5 changed files with 22 additions and 22 deletions

View File

@ -32,7 +32,7 @@ import org.springframework.test.context.support.DirtiesContextTestExecutionListe
* <p> * <p>
* Abstract base test class which integrates the <em>Spring TestContext * Abstract base test class which integrates the <em>Spring TestContext
* Framework</em> with explicit {@link ApplicationContext} testing support in a * Framework</em> with explicit {@link ApplicationContext} testing support in a
* <strong>JUnit 4.7</strong> environment. * <strong>JUnit 4.5+</strong> environment.
* </p> * </p>
* <p> * <p>
* Concrete subclasses should typically declare a class-level * Concrete subclasses should typically declare a class-level

View File

@ -50,7 +50,7 @@ import org.springframework.test.context.junit4.statements.SpringRepeat;
* <p> * <p>
* <code>SpringJUnit4ClassRunner</code> is a custom extension of * <code>SpringJUnit4ClassRunner</code> is a custom extension of
* {@link BlockJUnit4ClassRunner} which provides functionality of the * {@link BlockJUnit4ClassRunner} which provides functionality of the
* <em>Spring TestContext Framework</em> to standard JUnit 4.7+ tests by means * <em>Spring TestContext Framework</em> to standard JUnit 4.5+ tests by means
* of the {@link TestContextManager} and associated support classes and * of the {@link TestContextManager} and associated support classes and
* annotations. * annotations.
* </p> * </p>
@ -76,7 +76,7 @@ import org.springframework.test.context.junit4.statements.SpringRepeat;
* </ul> * </ul>
* <p> * <p>
* <b>NOTE:</b> As of Spring 3.0, <code>SpringJUnit4ClassRunner</code> requires * <b>NOTE:</b> As of Spring 3.0, <code>SpringJUnit4ClassRunner</code> requires
* JUnit 4.7. * JUnit 4.5+.
* </p> * </p>
* *
* @author Sam Brannen * @author Sam Brannen

View File

@ -1,6 +1,6 @@
/** /**
* <p>Support classes for ApplicationContext-based and transactional * <p>Support classes for ApplicationContext-based and transactional
* tests run with JUnit 4.7 and the <em>Spring TestContext Framework</em>.</p> * tests run with JUnit 4.5+ and the <em>Spring TestContext Framework</em>.</p>
*/ */
package org.springframework.test.context.junit4; package org.springframework.test.context.junit4;

View File

@ -4,7 +4,7 @@
* that is agnostic of the actual testing framework in use. The same * that is agnostic of the actual testing framework in use. The same
* techniques and annotation-based configuration used in, for example, a * techniques and annotation-based configuration used in, for example, a
* JUnit 3.8 environment can also be applied to tests written with JUnit * JUnit 3.8 environment can also be applied to tests written with JUnit
* 4.7, TestNG, etc.</p> * 4.5+, TestNG, etc.</p>
* *
* <p>In addition to providing generic and extensible testing * <p>In addition to providing generic and extensible testing
* infrastructure, the Spring TestContext Framework provides out-of-the-box * infrastructure, the Spring TestContext Framework provides out-of-the-box

View File

@ -621,8 +621,8 @@ public void testProcessWithoutTransaction() {
<para>The following annotations are <emphasis>only</emphasis> supported <para>The following annotations are <emphasis>only</emphasis> supported
when used in conjunction with JUnit (i.e., with the <link when used in conjunction with JUnit (i.e., with the <link
linkend="testcontext-junit4-runner">SpringJUnit4ClassRunner</link> or linkend="testcontext-junit4-runner">SpringJUnit4ClassRunner</link> or
the <link linkend="testcontext-support-classes-junit38">JUnit 3.8</link> the <link linkend="testcontext-support-classes-junit38">JUnit 3.8.2</link>
and <link linkend="testcontext-support-classes-junit4">JUnit 4.7</link> and <link linkend="testcontext-support-classes-junit4">JUnit 4.5+</link>
support classes.</para> support classes.</para>
<itemizedlist> <itemizedlist>
@ -812,16 +812,16 @@ public void testProcessRepeatedly() {
Framework</emphasis> (located in the Framework</emphasis> (located in the
<literal>org.springframework.test.context</literal> package) provides <literal>org.springframework.test.context</literal> package) provides
generic, annotation-driven unit and integration testing support that generic, annotation-driven unit and integration testing support that
is agnostic of the testing framework in use, for example JUnit 3.8, is agnostic of the testing framework in use, for example JUnit 3.8.2,
JUnit 4.7, TestNG 5.10, etc. The TestContext framework also places a JUnit 4.5+, TestNG 5.10, etc. The TestContext framework also places a
great deal of importance on <emphasis>convention over great deal of importance on <emphasis>convention over
configuration</emphasis> with reasonable defaults that can be configuration</emphasis> with reasonable defaults that can be
overridden via annotation-based configuration.</para> overridden via annotation-based configuration.</para>
<para>In addition to generic testing infrastructure, the TestContext <para>In addition to generic testing infrastructure, the TestContext
framework provides explicit support for JUnit 3.8, JUnit 4.7, and framework provides explicit support for JUnit 3.8.2, JUnit 4.5+, and
TestNG 5.10 in the form of <literal>abstract</literal> support TestNG 5.10 in the form of <literal>abstract</literal> support
classes. For JUnit 4.7, the framework also provides a custom classes. For JUnit 4.5+, the framework also provides a custom
<interfacename>Runner</interfacename> which allows one to write test <interfacename>Runner</interfacename> which allows one to write test
classes that are not required to extend a particular class classes that are not required to extend a particular class
hierarchy.</para> hierarchy.</para>
@ -1112,11 +1112,11 @@ public class ExtendedTest extends BaseTest {
<para>Consider the scenario where we have a class, <para>Consider the scenario where we have a class,
<classname>HibernateTitleDao</classname> (as outlined in the <link <classname>HibernateTitleDao</classname> (as outlined in the <link
linkend="testing-fixture-di">Goals</link> section). First, let's look linkend="testing-fixture-di">Goals</link> section). First, let's look
at a JUnit 4.7 based implementation of the test class itself which at a JUnit 4 based implementation of the test class itself which
uses <interfacename>@Autowired</interfacename> for field injection (we uses <interfacename>@Autowired</interfacename> for field injection (we
will look at the application context configuration after all sample will look at the application context configuration after all sample
code listings). <emphasis>Note: The dependency injection behavior in code listings). <emphasis>Note: The dependency injection behavior in
the following code listings is not in any way specific to JUnit 4.7. the following code listings is not in any way specific to JUnit 4.
The same DI techniques can be used in conjunction with any testing The same DI techniques can be used in conjunction with any testing
framework.</emphasis></para> framework.</emphasis></para>
@ -1525,10 +1525,10 @@ public void updateWithSessionFlush() {
</section> </section>
<section id="testcontext-support-classes-junit4"> <section id="testcontext-support-classes-junit4">
<title>JUnit 4.7 support classes</title> <title>JUnit 4.5+ support classes</title>
<para>The <literal>org.springframework.test.context.junit4</literal> <para>The <literal>org.springframework.test.context.junit4</literal>
package provides support classes for JUnit 4.7 based test package provides support classes for JUnit 4.5+ based test
cases.</para> cases.</para>
<itemizedlist> <itemizedlist>
@ -1538,7 +1538,7 @@ public void updateWithSessionFlush() {
<para>Abstract base test class which integrates the <para>Abstract base test class which integrates the
<emphasis>Spring TestContext Framework</emphasis> with explicit <emphasis>Spring TestContext Framework</emphasis> with explicit
<classname>ApplicationContext</classname> testing support in a <classname>ApplicationContext</classname> testing support in a
JUnit 4.7 environment.</para> JUnit 4.5+ environment.</para>
<para>When you extend <para>When you extend
<classname>AbstractJUnit4SpringContextTests</classname> you will <classname>AbstractJUnit4SpringContextTests</classname> you will
@ -1608,13 +1608,13 @@ public void updateWithSessionFlush() {
</section> </section>
<section id="testcontext-junit4-runner"> <section id="testcontext-junit4-runner">
<title>Custom JUnit 4.7 Runner</title> <title>Custom JUnit 4.5+ Runner</title>
<para>The <emphasis>Spring TestContext Framework</emphasis> offers <para>The <emphasis>Spring TestContext Framework</emphasis> offers
full integration with JUnit 4.7 via a custom runner. By annotating full integration with JUnit 4.5+ via a custom runner (tested on
test classes with JUnit 4.5, 4.6, and 4.7). By annotating test classes with
<literal>@Runwith(SpringJUnit4ClassRunner.class)</literal>, <literal>@Runwith(SpringJUnit4ClassRunner.class)</literal>,
developers can implement standard JUnit 4.7 unit and integration developers can implement standard JUnit 4.5+ unit and integration
tests and simultaneously reap the benefits of the TestContext tests and simultaneously reap the benefits of the TestContext
framework such as support for loading application contexts, framework such as support for loading application contexts,
dependency injection of test instances, transactional test method dependency injection of test instances, transactional test method
@ -1733,7 +1733,7 @@ public class SimpleTest {
<para>The PetClinic sample application included with the full Spring <para>The PetClinic sample application included with the full Spring
distribution illustrates several features of the <emphasis>Spring distribution illustrates several features of the <emphasis>Spring
TestContext Framework</emphasis> in a JUnit 4.7 environment. Most test TestContext Framework</emphasis> in a JUnit 4.5+ environment. Most test
functionality is included in the functionality is included in the
<classname>AbstractClinicTests</classname>, for which a partial listing <classname>AbstractClinicTests</classname>, for which a partial listing
is shown below:</para> is shown below:</para>
@ -1875,7 +1875,7 @@ public class HibernateClinicTests extends AbstractClinicTests { }
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para><ulink url="http://www.junit.org/">JUnit</ulink>: the Spring <para><ulink url="http://www.junit.org/">JUnit</ulink>: the Spring
Framework's unit and integration test suite is written using JUnit 3.8 Framework's unit and integration test suite is written using JUnit 3.8.2
and JUnit 4.7 as the testing framework.</para> and JUnit 4.7 as the testing framework.</para>
</listitem> </listitem>