3.4. 单元测试

由于Flowable DMN是一个可嵌入的Java引擎，因此编写DMN定义的单元测试就像编写常规单元测试一样简单。

Flowable支持JUnit版本4和5样式的单元测试。

在JUnit 5样式中，需要使用 org.flowable.dmn.engine.test.FlowableDmnTest 注解

或手动注册 org.flowable.dmn.engine.test.FlowableDmnExtension 。

FlowableDmnTest 注解只是一个元注解，并且注册了 FlowableDmnExtension

(即 @ExtendWith(FlowableDmnExtension.class)).

这将使DmnEngine和服务可用作测试和生命周期方法的参数

(@BeforeAll, @BeforeEach, @AfterEach, @AfterAll).

在每次测试之前，默认情况下将使用类路径上的 flowable.dmn.cfg.xml 资源初始化dmnEngine。

为了指定不同的配置文件需要使用org.flowable.dmn.engine.test.DmnConfigurationResource 注解(参见第二个例子)。

当配置资源相同时，Dmn引擎将在多个单元测试中静态缓存。

通过使用 FlowableDmnExtension ，您可以在测试方法上使用 org.flowable.dmn.engine.test.DmnDeployment 注解或 org.flowable.dmn.engine.test.DmnDeploymentAnnotation 注解。

如果同时使用 @DmnDeployment 和 @DmnDeploymentAnnotatio 那么 @DmnDeployment 优先，@DmnDeploymentAnnotation 将被忽略。

在测试方法上使用 @DmnDeployment 注解时，在每次测试之前，将部署 DmnDeployment＃resources 中定义的dmn文件。

如果没有定义资源，则为 testClassName.testMethod.dmn 形式的资源文件，将在与测试类相同的包中进行部署。

在测试结束时，部署将被删除，包括所有相关的dmn定义，执行等。

有关更多信息，请参阅 DmnDeployment 类。

考虑到所有这些，JUnit 5测试看起来如下：

使用默认资源进行JUnit 5测试

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17@FlowableDmnTest

class MyDecisionTableTest {

@Test

@DmnDeploymentAnnotation

void simpleDmnTest(DmnEngine dmnEngine) {

DmnRuleService dmnRuleService = dmnEngine.getDmnRuleService();

Map executionResult = ruleService.createExecuteDecisionBuilder()

.decisionKey("extensionUsage")

.variable("inputVariable1", 2)

.variable("inputVariable2", "test2")

.executeWithSingleResult();

Assertions.assertThat(executionResult).containsEntry("output1", "test1");

}

}

使用JUnit 5，您还可以将部署的ID(带有org.flowable.dmn.engine.test.DmnDeploymentId_)注入到测试和生命周期方法中。

使用自定义资源进行JUnit 5测试

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18@FlowableDmnTest

@DmnConfigurationResource("flowable.custom.dmn.cfg.xml")

class MyDecisionTableTest {

@Test

@DmnDeploymentAnnotation

void simpleDmnTest(DmnEngine dmnEngine) {

DmnRuleService dmnRuleService = dmnEngine.getDmnRuleService();

Map executionResult = ruleService.createExecuteDecisionBuilder()

.decisionKey("extensionUsage")

.variable("inputVariable1", 2)

.variable("inputVariable2", "test2")

.executeWithSingleResult();

Assertions.assertThat(executionResult).containsEntry("output1", "test1");

}

}

在编写JUnit 4单元测试时，可以使用 org.flowable.dmn.engine.test.FlowableDmnRule 规则。通过此规则，DMN引擎和服务可通过getter获得。包含此 Rule 将启用注解 org.flowable.dmn.engine.test.DmnDeploymentAnnotation (请参阅上文，了解其使用和配置) 它将在类路径中查找默认配置文件。 当使用相同的配置资源时，DMN引擎可以在多个单元测试中静态缓存。

也可以为规则提供自定义引擎配置。

以下代码片段显示了使用JUnit 4测试样式和 FlowableDmnRule 的用法的示例(并传递可选的自定义配置)：

JUnit 4 test

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20public class MyDecisionTableTest {

@Rule

public FlowableDmnRule flowableDmnRule = new FlowableDmnRule("custom1.flowable.dmn.cfg.xml");

@Test

@DmnDeploymentAnnotation

public void ruleUsageExample() {

DmnEngine dmnEngine = flowableDmnRule.getDmnEngine();

DmnRuleService dmnRuleService = dmnEngine.getDmnRuleService();

Map executionResult = ruleService.createExecuteDecisionBuilder()

.decisionKey("extensionUsage")

.variable("inputVariable1", 2)

.variable("inputVariable2", "test2")

.executeWithSingleResult();

Assertions.assertThat(executionResult).containsEntry("output1", "test1");

}

}