org.springframework.test.context.junit38
Class AbstractJUnit38SpringContextTests

java.lang.Object
  junit.framework.Assert
      junit.framework.TestCase
          org.springframework.test.context.junit38.AbstractJUnit38SpringContextTests

All Implemented Interfaces:

junit.framework.Test, ApplicationContextAware

Direct Known Subclasses:

AbstractTransactionalJUnit38SpringContextTests

@TestExecutionListeners(value={DependencyInjectionTestExecutionListener.class,DirtiesContextTestExecutionListener.class})
public class AbstractJUnit38SpringContextTests
extends junit.framework.TestCase
implements ApplicationContextAware

Abstract base TestCase which integrates the Spring TestContext Framework with explicit ApplicationContext testing support in a JUnit 3.8 environment.

Concrete subclasses:

• Typically declare a class-level @ContextConfiguration annotation to configure the application context resource locations. If your test does not need to load an application context, you may choose to omit the @ContextConfiguration declaration and configure the appropriate TestExecutionListeners manually.
• Must declare public constructors which match the signatures of AbstractJUnit38SpringContextTests() and AbstractJUnit38SpringContextTests(String) and delegate to super(); and super(name); respectively.

The following list constitutes all annotations currently supported directly by AbstractJUnit38SpringContextTests. (Note that additional annotations may be supported by various TestExecutionListeners)

• @DirtiesContext (via the configured DirtiesContextTestExecutionListener)
• @ProfileValueSourceConfiguration
• @IfProfileValue
• @ExpectedException
• @Timed
• @Repeat

Since:

2.5

Author:

Sam Brannen

See Also:

TestContext, TestContextManager, TestExecutionListeners, AbstractTransactionalJUnit38SpringContextTests, AbstractJUnit4SpringContextTests, AbstractTestNGSpringContextTests

Field Summary

protected ApplicationContext	applicationContext The ApplicationContext that was injected into this test instance via setApplicationContext(ApplicationContext).
protected Log	logger Logger available to subclasses.
protected ProfileValueSource	profileValueSource ProfileValueSource available to subclasses but primarily intended for internal use to provide support for @IfProfileValue.

Constructor Summary

AbstractJUnit38SpringContextTests()
Default no argument constructor which delegates to AbstractJUnit38SpringContextTests(String), passing a value of null for the test name.

AbstractJUnit38SpringContextTests(String name)
Constructs a new AbstractJUnit38SpringContextTests instance with the supplied name; initializes the internal TestContextManager for the current test; and retrieves the configured (or default) ProfileValueSource.

Method Summary

static int	getDisabledTestCount() Return the number of tests disabled in this environment.
protected void	recordDisabled(Method testMethod) Records the supplied test method as disabled in the current environment by incrementing the total number of disabled tests and logging a debug message.
void	runBare() Runs the Spring TestContext Framework test sequence.
void	setApplicationContext(ApplicationContext applicationContext) Sets the ApplicationContext to be used by this test instance, provided via ApplicationContextAware semantics.

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, runTest, setName, setUp, tearDown, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, failNotEquals, failNotSame, failSame, format

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

logger

protected final Log logger

Logger available to subclasses.

applicationContext

protected ApplicationContext applicationContext

The ApplicationContext that was injected into this test instance via setApplicationContext(ApplicationContext).

profileValueSource

protected final ProfileValueSource profileValueSource

ProfileValueSource available to subclasses but primarily intended for internal use to provide support for @IfProfileValue.

Set in the AbstractJUnit38SpringContextTests(String) constructor.

Constructor Detail

AbstractJUnit38SpringContextTests

public AbstractJUnit38SpringContextTests()

Default no argument constructor which delegates to AbstractJUnit38SpringContextTests(String), passing a value of null for the test name.

AbstractJUnit38SpringContextTests

public AbstractJUnit38SpringContextTests(String name)

Constructs a new AbstractJUnit38SpringContextTests instance with the supplied name; initializes the internal TestContextManager for the current test; and retrieves the configured (or default) ProfileValueSource.

Parameters:

name - the name of the current test to execute.

See Also:

TestCase.TestCase(String)

Method Detail

getDisabledTestCount

public static int getDisabledTestCount()

Return the number of tests disabled in this environment.

runBare

public void runBare()
             throws Throwable

Runs the Spring TestContext Framework test sequence.

In addition to standard TestCase.runBare() semantics, this implementation performs the following:

• Calls prepareTestInstance(), beforeTestMethod(), and afterTestMethod() on this test's TestContextManager at the appropriate test execution points.
• Provides support for @IfProfileValue.
• Provides support for @Repeat.
• Provides support for @Timed.
• Provides support for @ExpectedException.

Overrides:

runBare in class junit.framework.TestCase

Throws:

Throwable

See Also:

ProfileValueUtils.isTestEnabledInThisEnvironment(ProfileValueSource, Method), TestCase.runBare()

setApplicationContext

public final void setApplicationContext(ApplicationContext applicationContext)

Sets the ApplicationContext to be used by this test instance, provided via ApplicationContextAware semantics.

Specified by:

setApplicationContext in interface ApplicationContextAware

Parameters:

applicationContext - the application context to set.

See Also:

BeanInitializationException

recordDisabled

protected void recordDisabled(Method testMethod)

Records the supplied test method as disabled in the current environment by incrementing the total number of disabled tests and logging a debug message.

Parameters:

testMethod - the test method that is disabled.

See Also:

getDisabledTestCount()