org.springframework.test
Class AbstractSingleSpringContextTests

java.lang.Object
  junit.framework.Assert
      junit.framework.TestCase
          org.springframework.test.ConditionalTestCase
              org.springframework.test.AbstractSpringContextTests
                  org.springframework.test.AbstractSingleSpringContextTests

All Implemented Interfaces:

Test

Direct Known Subclasses:

AbstractDependencyInjectionSpringContextTests

public abstract class AbstractSingleSpringContextTests
extends AbstractSpringContextTests

Abstract test class that holds and exposes a single Spring ApplicationContext.

This class will cache contexts based on a context key: normally the config locations String array describing the Spring resource descriptors making up the context. Unless the setDirty() method is called by a test, the context will not be reloaded, even across different subclasses of this test. This is particularly beneficial if your context is slow to construct, for example if you are using Hibernate and the time taken to load the mappings is an issue.

If you don't want this behavior, you can override the contextKey() method, most likely to return the test class. In conjunction with this you would probably override the getContext method, which by default loads the locations specified in the getConfigLocations() method.

WARNING: When doing integration tests from within Eclipse, only use classpath resource URLs. Else, you may see misleading failures when changing context locations.

Since:

2.0

Author:

Juergen Hoeller

Field Summary

protected ConfigurableApplicationContext

applicationContext Application context this test will run against

Fields inherited from class org.springframework.test.ConditionalTestCase

logger

Constructor Summary

AbstractSingleSpringContextTests()
Default constructor for AbstractDependencyInjectionSpringContextTests.

AbstractSingleSpringContextTests(String name)
Constructor for AbstractDependencyInjectionSpringContextTests with a JUnit name.

Method Summary

protected Object	contextKey() Return a key for this context.
protected abstract String[]	getConfigLocations() Subclasses must implement this method to return the locations of their config files.
int	getLoadCount() Return the current number of context load attempts.
protected ConfigurableApplicationContext	loadContext(Object key) This implementation loads a context from the given String array.
protected ConfigurableApplicationContext	loadContextLocations(String[] locations) Load an ApplicationContext from the given config locations.
protected void	onSetUp() Subclasses can override this method in place of the setUp() method, which is final in this class.
protected void	onTearDown() Subclasses can override this to add custom behavior on teardown.
protected void	prepareTestInstance() Prepare this test instance, for example populating its fields.
protected void	setDirty() Called to say that the "applicationContext" instance variable is dirty and should be reloaded.
protected void	setUp() This implementation is final.
protected void	tearDown() This implementation is final.

Methods inherited from class org.springframework.test.AbstractSpringContextTests

addContext, contextKeyString, getContext, hasCachedContext, setDirty

Methods inherited from class org.springframework.test.ConditionalTestCase

getDisabledTestCount, isDisabledInThisEnvironment, recordDisabled, runBare

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, runTest, setName, 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

Methods inherited from class java.lang.Object

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

Field Detail

applicationContext

protected ConfigurableApplicationContext applicationContext

Application context this test will run against

Constructor Detail

AbstractSingleSpringContextTests

public AbstractSingleSpringContextTests()

Default constructor for AbstractDependencyInjectionSpringContextTests.

AbstractSingleSpringContextTests

public AbstractSingleSpringContextTests(String name)

Constructor for AbstractDependencyInjectionSpringContextTests with a JUnit name.

Parameters:

name - the name of this text fixture

Method Detail

setUp

protected final void setUp()
                    throws Exception

This implementation is final. Override onSetUp for custom behavior.

Overrides:

setUp in class TestCase

Throws:

Exception

See Also:

onSetUp()

prepareTestInstance

protected void prepareTestInstance()
                            throws Exception

Prepare this test instance, for example populating its fields.

This implementation does nothing.

Throws:

Exception

onSetUp

protected void onSetUp()
                throws Exception

Subclasses can override this method in place of the setUp() method, which is final in this class. This implementation does nothing.

Throws:

Exception - simply let any exception propagate

tearDown

protected final void tearDown()
                       throws Exception

This implementation is final. Override onTearDown for custom behavior.

Overrides:

tearDown in class TestCase

Throws:

Exception

See Also:

onTearDown()

onTearDown

protected void onTearDown()
                   throws Exception

Subclasses can override this to add custom behavior on teardown.

Throws:

Exception - simply let any exception propagate

contextKey

protected final Object contextKey()

Return a key for this context. Default is the config location array.

See Also:

getConfigLocations()

loadContext

protected final ConfigurableApplicationContext loadContext(Object key)
                                                    throws Exception

This implementation loads a context from the given String array.

Specified by:

loadContext in class AbstractSpringContextTests

Parameters:

key - the context key

Returns:

the corresponding ApplicationContext instance (new)

Throws:

Exception

loadContextLocations

protected ConfigurableApplicationContext loadContextLocations(String[] locations)
                                                       throws Exception

Load an ApplicationContext from the given config locations.

Parameters:

locations - the config locations

Returns:

the corresponding ApplicationContext instance (potentially cached)

Throws:

Exception

getLoadCount

public final int getLoadCount()

Return the current number of context load attempts.

setDirty

protected void setDirty()

Called to say that the "applicationContext" instance variable is dirty and should be reloaded. We need to do this if a test has modified the context (for example, by replacing a bean definition).

getConfigLocations

protected abstract String[] getConfigLocations()

Subclasses must implement this method to return the locations of their config files. A plain path will be treated as class path location. E.g.: "org/springframework/whatever/foo.xml". Note however that you may prefix path locations with standard Spring resource prefixes. Therefore, a config location path prefixed with "classpath:" with behave the same as a plain path, but a config location such as "file:/some/path/path/location/appContext.xml" will be treated as a filesystem location.

Returns:

an array of config locations