org.arquillian.ape.rdbms

Annotation Type JpaCacheEviction

@Inherited
 @Documented
 @Target(value={TYPE,METHOD})
 @Retention(value=RUNTIME)
public @interface JpaCacheEviction

Indicates that test want evict JPA second level cache between test method invocation.

Necessary attribute which must be set in annotation or in configuration is JNDI name(s) of entity manager(s), other attributes have default values. Default phase is before test method invocation and is used strategy which evict all entities from cache. Default values can be changed in Arquillian descriptor.

Eviction can be defined on test class or test method level, where latter takes precedence if both are present.

Example configuration:

 
 <extension qualifier="persistence-jpacacheeviction">
     <property name="defaultPhase">AFTER</property>
     <property name="defaultEntityManager">java:comp/env/MyPersistenceUnit</property>
     <property name="defaultStrategy">com.mycompany.MyCustomJpaCacheEvictionStrategy</property>
 </extension>
 
 

Example test:

 
 @RunWith(Arquillian.class)
 @JpaCacheEviction(entityManager = "java:comp/env/MyPersistenceUnit")
 public class MyIntegrationTest {
 ...
 
 

Author:

Tomas Hradec

See Also:

Cache

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String[]	entityManager Defines JNDI names of entity managers which second level caches should be evicted during test execution.
TestExecutionPhase	phase Defines when during the test execution second level cache should be evicted.
Class<? extends JpaCacheEvictionStrategy>	strategy Defines strategy how to evict cache.

Element Detail

phase

public abstract TestExecutionPhase phase

Defines when during the test execution second level cache should be evicted.

Default:

org.arquillian.ape.api.TestExecutionPhase.DEFAULT

entityManager

public abstract String[] entityManager

Defines JNDI names of entity managers which second level caches should be evicted during test execution. Both full JNDI name as well as short form can be provided. In case of latter it will be prefixed with java:comp/env/.

Default:

""

strategy

public abstract Class<? extends JpaCacheEvictionStrategy> strategy

Defines strategy how to evict cache.

Default:

org.arquillian.ape.rdbms.JpaCacheEviction.DefaultJpaCacheEvictionStrategy.class