public abstract class

AbstractJpaTests

extends AbstractAnnotationAwareTransactionalTests

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	org.springframework.test.ConditionalTestCase
			↳	org.springframework.test.AbstractSpringContextTests
				↳	org.springframework.test.AbstractSingleSpringContextTests
					↳	org.springframework.test.AbstractDependencyInjectionSpringContextTests
						↳	org.springframework.test.AbstractTransactionalSpringContextTests
							↳	org.springframework.test.AbstractTransactionalDataSourceSpringContextTests
								↳	org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests
									↳	org.springframework.test.jpa.AbstractJpaTests

Known Direct Subclasses

AbstractAspectjJpaTests

This class is deprecated.
as of Spring 3.0, in favor of using the listener-based test context framework (AbstractJUnit38SpringContextTests)

Class Overview

Convenient support class for JPA-related tests. Offers the same contract as AbstractTransactionalDataSourceSpringContextTests and equally good performance, even when performing the instrumentation required by the JPA specification.

Exposes an EntityManagerFactory and a shared EntityManager. Requires an EntityManagerFactory to be injected, plus the DataSource and JpaTransactionManager through the superclass.

When using Xerces, make sure a post 2.0.2 version is available on the classpath to avoid a critical bug that leads to StackOverflow. Maven users are likely to encounter this problem since 2.0.2 is used by default.

A workaround is to explicitly specify the Xerces version inside the Maven POM:

 <dependency>
   <groupId>xerces</groupId>
     <artifactId>xercesImpl</artifactId>
   <version>2.8.1</version>
 </dependency>

Summary

[Expand]

Inherited Constants

From class org.springframework.test.AbstractDependencyInjectionSpringContextTests

Fields
protected EntityManagerFactory	entityManagerFactory
protected EntityManager	sharedEntityManager	Subclasses can use this in test cases.

[Expand]

Inherited Fields

From class org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests

From class org.springframework.test.AbstractTransactionalDataSourceSpringContextTests

From class org.springframework.test.AbstractTransactionalSpringContextTests

From class org.springframework.test.AbstractSingleSpringContextTests

From class org.springframework.test.ConditionalTestCase

Public Constructors
	AbstractJpaTests()

Public Methods
void	runBare() Overridden to populate transaction definition from annotations.
void	setDirty() Called to say that the "applicationContext" instance variable is dirty and should be reloaded.
void	setEntityManagerFactory(EntityManagerFactory entityManagerFactory)

Protected Methods
String	cacheKeys()
EntityManager	createContainerManagedEntityManager() Create an EntityManager that will always automatically enlist itself in current transactions, in contrast to an EntityManager returned by `EntityManagerFactory.createEntityManager()` (which requires an explicit `joinTransaction()` call).
ClassLoader	createShadowingClassLoader(ClassLoader classLoader) NB: This method must not have a return type of ShadowingClassLoader as that would cause that class to be loaded eagerly when this test case loads, creating verify errors at runtime.
void	customizeResourceOverridingShadowingClassLoader(ClassLoader shadowingClassLoader) Customize the shadowing class loader.
String	getActualOrmXmlLocation() Subclasses can override this to return the real location path for orm.xml or null if they do not wish to find any orm.xml
boolean	shouldUseShadowLoader() Subclasses should override this method if they wish to disable shadow class loading.

[Expand]

Inherited Methods

From class org.springframework.test.annotation.AbstractAnnotationAwareTransactionalTests

From class org.springframework.test.AbstractTransactionalDataSourceSpringContextTests

From class org.springframework.test.AbstractTransactionalSpringContextTests

void	endTransaction() Immediately force a commit or rollback of the transaction, according to the `complete` and `rollback` flags.
boolean	isDefaultRollback() Get the default rollback flag for this test.
boolean	isRollback() Determines whether or not to rollback transactions for the current test.
void	onSetUp() This implementation creates a transaction before test execution.
void	onSetUpBeforeTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, before the transaction created by this class.
void	onSetUpInTransaction() Subclasses can override this method to perform any setup operations, such as populating a database table, within the transaction created by this class.
void	onTearDown() This implementation ends the transaction after test execution.
void	onTearDownAfterTransaction() Subclasses can override this method to perform cleanup after a transaction here.
void	onTearDownInTransaction() Subclasses can override this method to run invariant tests here.
void	preventTransaction() Call this method in an overridden `runBare()` method to prevent transactional execution.
void	setComplete() Cause the transaction to commit for this test method, even if the test method is configured to `rollback`.
void	setDefaultRollback(boolean defaultRollback) Subclasses can set this value in their constructor to change the default, which is always to roll the transaction back.
void	setTransactionDefinition(TransactionDefinition customDefinition) Call this method in an overridden `runBare()` method to override the transaction attributes that will be used, so that `setUp()` and `tearDown()` behavior is modified.
void	setTransactionManager(PlatformTransactionManager transactionManager) Specify the transaction manager to use.
void	startNewTransaction() Start a new transaction.

From class org.springframework.test.AbstractDependencyInjectionSpringContextTests

final int	getAutowireMode() Return the autowire mode for test properties set by Dependency Injection.
void	injectDependencies() Inject dependencies into 'this' instance (that is, this test instance).
final boolean	isDependencyCheck() Return whether or not dependency checking should be performed for test properties set by Dependency Injection.
final boolean	isPopulateProtectedVariables() Return whether to populate protected variables of this test case.
void	prepareTestInstance() Prepare this test instance, injecting dependencies into its protected fields and its bean properties.
final void	setAutowireMode(int autowireMode) Set the autowire mode for test properties set by Dependency Injection.
final void	setDependencyCheck(boolean dependencyCheck) Set whether or not dependency checking should be performed for test properties set by Dependency Injection.
final void	setPopulateProtectedVariables(boolean populateFields) Set whether to populate protected variables of this test case.

From class org.springframework.test.AbstractSingleSpringContextTests

From class org.springframework.test.AbstractSpringContextTests

From class org.springframework.test.ConditionalTestCase

From class junit.framework.TestCase

From class junit.framework.Assert

static void	assertEquals(short arg0, short arg1)
static void	assertEquals(String arg0, int arg1, int arg2)
static void	assertEquals(String arg0, short arg1, short arg2)
static void	assertEquals(char arg0, char arg1)
static void	assertEquals(String arg0, String arg1, String arg2)
static void	assertEquals(int arg0, int arg1)
static void	assertEquals(String arg0, double arg1, double arg2, double arg3)
static void	assertEquals(String arg0, long arg1, long arg2)
static void	assertEquals(byte arg0, byte arg1)
static void	assertEquals(Object arg0, Object arg1)
static void	assertEquals(boolean arg0, boolean arg1)
static void	assertEquals(String arg0, float arg1, float arg2, float arg3)
static void	assertEquals(String arg0, boolean arg1, boolean arg2)
static void	assertEquals(String arg0, String arg1)
static void	assertEquals(float arg0, float arg1, float arg2)
static void	assertEquals(String arg0, byte arg1, byte arg2)
static void	assertEquals(double arg0, double arg1, double arg2)
static void	assertEquals(String arg0, char arg1, char arg2)
static void	assertEquals(String arg0, Object arg1, Object arg2)
static void	assertEquals(long arg0, long arg1)
static void	assertFalse(String arg0, boolean arg1)
static void	assertFalse(boolean arg0)
static void	assertNotNull(String arg0, Object arg1)
static void	assertNotNull(Object arg0)
static void	assertNotSame(Object arg0, Object arg1)
static void	assertNotSame(String arg0, Object arg1, Object arg2)
static void	assertNull(Object arg0)
static void	assertNull(String arg0, Object arg1)
static void	assertSame(Object arg0, Object arg1)
static void	assertSame(String arg0, Object arg1, Object arg2)
static void	assertTrue(String arg0, boolean arg1)
static void	assertTrue(boolean arg0)
static void	fail(String arg0)
static void	fail()
static void	failNotEquals(String arg0, Object arg1, Object arg2)
static void	failNotSame(String arg0, Object arg1, Object arg2)
static void	failSame(String arg0)
static String	format(String arg0, Object arg1, Object arg2)

From class java.lang.Object

From interface junit.framework.Test

Fields

protected EntityManagerFactory entityManagerFactory

protected EntityManager sharedEntityManager

Subclasses can use this in test cases. It will participate in any current transaction.

Public Constructors

public AbstractJpaTests ()

Public Methods

public void runBare ()

Overridden to populate transaction definition from annotations.

Throws

Throwable

public 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).

public void setEntityManagerFactory (EntityManagerFactory entityManagerFactory)

Protected Methods

protected String cacheKeys ()

protected EntityManager createContainerManagedEntityManager ()

Create an EntityManager that will always automatically enlist itself in current transactions, in contrast to an EntityManager returned by EntityManagerFactory.createEntityManager() (which requires an explicit joinTransaction() call).

protected ClassLoader createShadowingClassLoader (ClassLoader classLoader)

NB: This method must not have a return type of ShadowingClassLoader as that would cause that class to be loaded eagerly when this test case loads, creating verify errors at runtime.

protected void customizeResourceOverridingShadowingClassLoader (ClassLoader shadowingClassLoader)

Customize the shadowing class loader.

Parameters

shadowingClassLoader	this parameter is actually of type ResourceOverridingShadowingClassLoader, and can safely to be cast to that type. However, the signature must not be of that type as that would cause the present class loader to load that type.

protected String getActualOrmXmlLocation ()

Subclasses can override this to return the real location path for orm.xml or null if they do not wish to find any orm.xml

Returns

orm.xml path or null to hide any such file

protected boolean shouldUseShadowLoader ()

Subclasses should override this method if they wish to disable shadow class loading.

The default implementation deactivates shadow class loading if Spring's InstrumentationSavingAgent has been configured on VM startup.

Classes

AbstractJpaTests

Class Overview

Summary

Fields

protected EntityManagerFactory entityManagerFactory

protected EntityManager sharedEntityManager

Public Constructors

public AbstractJpaTests ()

Public Methods

public void runBare ()

Throws

public void setDirty ()

public void setEntityManagerFactory (EntityManagerFactory entityManagerFactory)

Protected Methods

protected String cacheKeys ()

protected EntityManager createContainerManagedEntityManager ()

protected ClassLoader createShadowingClassLoader (ClassLoader classLoader)

protected void customizeResourceOverridingShadowingClassLoader (ClassLoader shadowingClassLoader)

Parameters

protected String getActualOrmXmlLocation ()

Returns

protected boolean shouldUseShadowLoader ()