org.camunda.bpm.engine.test

Class ProcessEngineTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

org.camunda.bpm.engine.test.ProcessEngineTestCase

All Implemented Interfaces:

junit.framework.Test

public class ProcessEngineTestCase
extends junit.framework.TestCase

Convenience for ProcessEngine and services initialization in the form of a JUnit base class.

Usage: public class YourTest extends ProcessEngineTestCase

The ProcessEngine and the services available to subclasses through protected member fields. The processEngine will be initialized by default with the camunda.cfg.xml resource on the classpath. To specify a different configuration file, override the getConfigurationResource() method. Process engines will be cached statically. The first time the setUp is called for a given configuration resource, the process engine will be constructed.

You can declare a deployment with the Deployment annotation. This base class will make sure that this deployment gets deployed in the setUp and cascade deleted in the tearDown.

This class also lets you set the current time used by the process engine. This can be handy to control the exact time that is used by the engine in order to verify e.g. e.g. due dates of timers. Or start, end and duration times in the history service. In the tearDown, the internal clock will automatically be reset to use the current system time rather then the time that was set during a test method. In other words, you don't have to clean up your own time messing mess ;-)

Author:

Tom Baeyens, Falko Menge (camunda)

Field Summary

Fields

Modifier and Type	Field and Description
protected AuthorizationService	authorizationService
protected CaseService	caseService
protected String	configurationResource
protected String	configurationResourceCompat
protected String	deploymentId
protected FilterService	filterService
protected FormService	formService
protected HistoryService	historicDataService Deprecated.
protected HistoryService	historyService
protected IdentityService	identityService
protected ManagementService	managementService
protected ProcessEngine	processEngine
protected RepositoryService	repositoryService
protected RuntimeService	runtimeService
protected boolean	skipTest
protected TaskService	taskService

Constructor Summary

Constructors

Constructor and Description
ProcessEngineTestCase() uses 'camunda.cfg.xml' as it's configuration resource

Method Summary

Modifier and Type	Method and Description
void	assertProcessEnded(String processInstanceId)
static void	closeProcessEngines()
String	getConfigurationResource()
protected void	initializeProcessEngine()
protected void	initializeServices()
protected void	runTest()
void	setConfigurationResource(String configurationResource)
void	setCurrentTime(Date currentTime)
protected void	setUp()
protected void	tearDown()

Methods inherited from class junit.framework.TestCase

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, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, setName, toString

Methods inherited from class java.lang.Object

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

Field Detail

configurationResource

protected String configurationResource

configurationResourceCompat

protected String configurationResourceCompat

deploymentId

protected String deploymentId

processEngine

protected ProcessEngine processEngine

repositoryService

protected RepositoryService repositoryService

runtimeService

protected RuntimeService runtimeService

taskService

protected TaskService taskService

historicDataService

@Deprecated
protected HistoryService historicDataService

Deprecated.

historyService

protected HistoryService historyService

identityService

protected IdentityService identityService

managementService

protected ManagementService managementService

formService

protected FormService formService

filterService

protected FilterService filterService

authorizationService

protected AuthorizationService authorizationService

caseService

protected CaseService caseService

skipTest

protected boolean skipTest

Constructor Detail

ProcessEngineTestCase

public ProcessEngineTestCase()

uses 'camunda.cfg.xml' as it's configuration resource

Method Detail

assertProcessEnded

public void assertProcessEnded(String processInstanceId)

setUp

protected void setUp()
              throws Exception

Overrides:

setUp in class junit.framework.TestCase

Throws:

Exception

runTest

protected void runTest()
                throws Throwable

Overrides:

runTest in class junit.framework.TestCase

Throws:

Throwable

initializeProcessEngine

protected void initializeProcessEngine()

initializeServices

protected void initializeServices()

tearDown

protected void tearDown()
                 throws Exception

Overrides:

tearDown in class junit.framework.TestCase

Throws:

Exception

closeProcessEngines

public static void closeProcessEngines()

setCurrentTime

public void setCurrentTime(Date currentTime)

getConfigurationResource

public String getConfigurationResource()

setConfigurationResource

public void setConfigurationResource(String configurationResource)