org.alfresco.util.test.junitrules

Class LoadTestRule

java.lang.Object

org.junit.rules.Verifier

org.junit.rules.ErrorCollector

org.alfresco.util.test.junitrules.LoadTestRule

All Implemented Interfaces:

org.junit.rules.TestRule

public class LoadTestRule
extends org.junit.rules.ErrorCollector

This JUnit rule can be used to turn existing test code into Load Tests. It does this in conjunction with the AlfrescoPeople JUnit rule. That rule is used to create a fixed number of Alfresco users. Then LoadTestRule will do the following for each of your JUnit 4 @Test methods:

• if they are annotated with the LoadTestRule.LoadTest marker annotation:
  1. one Java thread for each of the users created by the AlfrescoPeople rule will be created and started.
  2. each of those threads will start by authenticating as a different user from the above set.
  3. each of those threads will concurrently execute the same JUnit @Test method.
  4. if all the concurrent threads complete execution successfully, the @Test method is passed.
  5. but if one or more of those concurrent threads fail, the error messages will be aggregated together into a single error for that method.
• else they will be executed as normal and will pass or fail as normal.

Example usage, where we have a 'normal' feature test and a load test for the same feature.:

 public class YourTestClass
 {
     // We need to ensure that JUnit Rules in the same 'group' (in this case the 'static' group) execute in the correct
     // order. To do this we do not annotate the JUnit Rule fields themselves, but instead wrap them up in a RuleChain.
     
     // Initialise the spring application context with a rule.
     public static final ApplicationContextInit APP_CONTEXT_RULE = new ApplicationContextInit();
     public static final AlfrescoPeople         TEST_USERS       = new AlfrescoPeople(APP_CONTEXT_RULE, 32);
     
     @ClassRule public static RuleChain STATIC_RULE_CHAIN = RuleChain.outerRule(APP_CONTEXT_RULE)
                                                                     .around(TEST_USERS);
                                                              
     @Rule public LoadTestRule loadTestRule = new LoadTestRule(TEST_USERS);
     
     @Test public void aNormalTestMethod()
     {
         ensureFeatureFooWorks()
     }
     
     @LoadTest @Test public void aLoadTestMethod()
     {
         ensureFeatureFooWorks()
     }
     
     public void ensureFeatureFooWorks() {}
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	LoadTestRule.LoadTest This annotation is a marker used to identify a JUnit @Test method as a "load test".

Constructor Summary

Constructors

Constructor and Description
LoadTestRule(AlfrescoPeople people)

Method Summary

Methods

Modifier and Type	Method and Description
org.junit.runners.model.Statement	apply(org.junit.runners.model.Statement base, org.junit.runner.Description description)
int	getCount() Gets the number of users/concurrent threads that this Rule has been configured to use.

Methods inherited from class org.junit.rules.ErrorCollector

addError, checkSucceeds, checkThat, checkThat, verify

Methods inherited from class java.lang.Object

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

Constructor Detail

LoadTestRule

public LoadTestRule(AlfrescoPeople people)

Method Detail

getCount

public int getCount()

Gets the number of users/concurrent threads that this Rule has been configured to use.

Returns:

the number of users/threads.

apply

public org.junit.runners.model.Statement apply(org.junit.runners.model.Statement base,
                                      org.junit.runner.Description description)

Specified by:

apply in interface org.junit.rules.TestRule

Overrides:

apply in class org.junit.rules.Verifier