Class FlowableRule

  • All Implemented Interfaces:
    org.junit.rules.TestRule

    public class FlowableRule
    extends Object
    implements org.junit.rules.TestRule
    Convenience for ProcessEngine and services initialization in the form of a JUnit rule.

    Usage:

     public class YourTest {
     
       @Rule
       public FlowableRule flowableRule = new FlowableRule();
       
       ...
     }
     

    The ProcessEngine and the services will be made available to the test class through the getters of the FlowableRule. The processEngine will be initialized by default with the flowable.cfg.xml resource on the classpath. To specify a different configuration file, pass the resource location in the appropriate constructor. Process engines will be cached statically. Right before 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 before the setUp and cascade deleted after the tearDown.

    The FlowableRule 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.

    Author:
    Tom Baeyens
    • Constructor Detail

      • FlowableRule

        public FlowableRule()
      • FlowableRule

        public FlowableRule​(String configurationResource)
      • FlowableRule

        public FlowableRule​(ProcessEngine processEngine)
    • Method Detail

      • apply

        public org.junit.runners.model.Statement apply​(org.junit.runners.model.Statement base,
                                                       org.junit.runner.Description description)
        Implementation based on TestWatcher.
        Specified by:
        apply in interface org.junit.rules.TestRule
      • succeeded

        protected void succeeded​(org.junit.runner.Description description)
        Invoked when a test succeeds
      • failed

        protected void failed​(Throwable e,
                              org.junit.runner.Description description)
        Invoked when a test fails
      • skipped

        protected void skipped​(org.junit.internal.AssumptionViolatedException e,
                               org.junit.runner.Description description)
        Invoked when a test is skipped due to a failed assumption.
      • starting

        protected void starting​(org.junit.runner.Description description)
      • initializeProcessEngine

        protected void initializeProcessEngine()
      • initializeServices

        protected void initializeServices()
      • initializeMockSupport

        protected void initializeMockSupport()
      • configureProcessEngine

        protected void configureProcessEngine()
      • finished

        protected void finished​(org.junit.runner.Description description)
      • setCurrentTime

        public void setCurrentTime​(Date currentTime)
      • getConfigurationResource

        public String getConfigurationResource()
      • setConfigurationResource

        public void setConfigurationResource​(String configurationResource)
      • setProcessEngine

        public void setProcessEngine​(ProcessEngine processEngine)
      • setRepositoryService

        public void setRepositoryService​(RepositoryService repositoryService)
      • setRuntimeService

        public void setRuntimeService​(RuntimeService runtimeService)
      • setTaskService

        public void setTaskService​(TaskService taskService)
      • setHistoricDataService

        public void setHistoricDataService​(HistoryService historicDataService)
      • setIdentityService

        public void setIdentityService​(IdentityService identityService)
      • setManagementService

        public void setManagementService​(ManagementService managementService)
      • setProcessEngineConfiguration

        public void setProcessEngineConfiguration​(org.flowable.engine.impl.cfg.ProcessEngineConfigurationImpl processEngineConfiguration)