Question

业务流程是软件项目的必要组成部分，也需要使用测试一般应用逻辑的方法——单元测试——测试它们。Flowable是嵌入式的Java引擎，因此为业务流程编写单元测试就同编写一般的单元测试一样简单。

Flowable支持JUnit 3及4的单元测试风格。按照JUnit 3的风格，必须扩展(extended)org.flowable.engine.test.FlowableTestCase。它通过保护(protected)成员变量提供对ProcessEngine与服务的访问。在测试的setup()中，processEngine会默认使用classpath中的flowable.cfg.xml资源初始化。如果要指定不同的配置文件，请覆盖getConfigurationResource()方法。当使用相同的配置资源时，流程引擎会静态缓存，用于多个单元测试。

通过扩展FlowableTestCase，可以使用org.flowable.engine.test.Deployment注解测试方法。在测试运行前，会部署与测试类在同一个包下的格式为testClassName.testMethod.bpmn20.xml的资源文件。在测试结束时，会删除这个部署，包括所有相关的流程实例、任务，等等。也可以使用Deployment注解显式指定资源位置。查看该类以获得更多信息。

综上所述，JUnit 3风格的测试看起来类似：

public class MyBusinessProcessTest extends FlowableTestCase {

  @Deployment
  public void testSimpleProcess() {
  runtimeService.startProcessInstanceByKey("simpleProcess");

  Task task = taskService.createTaskQuery().singleResult();
  assertEquals("My Task", task.getName());

  taskService.complete(task.getId());
  assertEquals(0, runtimeService.createProcessInstanceQuery().count());
  }
}

要使用JUnit 4的风格书写单元测试并达成同样的功能，必须使用org.flowable.engine.test.FlowableRule Rule。这样能够通过它的getter获得流程引擎与服务。对于FlowableTestCase（上例），包含@Rule就可以使用org.flowable.engine.test.Deployment注解（参见上例解释其用途及配置），并且会自动在classpath中寻找默认配置文件。当使用相同的配置资源时，流程引擎会静态缓存，以用于多个单元测试。

下面的代码片段展示了JUnit 4风格的测试与FlowableRule的用法。

public class MyBusinessProcessTest {

  @Rule
  public FlowableRule FlowableRule = new FlowableRule();

  @Test
  @Deployment
  public void ruleUsageExample() {
  RuntimeService runtimeService = FlowableRule.getRuntimeService();
  runtimeService.startProcessInstanceByKey("ruleUsage");

  TaskService taskService = FlowableRule.getTaskService();
  Task task = taskService.createTaskQuery().singleResult();
  assertEquals("My Task", task.getName());

  taskService.complete(task.getId());
  assertEquals(0, runtimeService.createProcessInstanceQuery().count());
  }
}