疯狂Activiti6.0连载13DMN的XML规范

本文节选自《疯狂Workflow讲义（第2版）》

DMN的XML规范

DMN规范的官方网址为：http://www.omg.org/spec/DMN/，在官方网站上可以获取到DMN的规范文档、DMN的XML Schema文档和样例文档。笔者已经将以上三份文档下载，并保存到代码目录，以下为这三份文档的代码路径：

• 规范文档：codes\15\15.2\DMN规范.pdf
• XML Schema：codes\15\15.2\dmn.xsd
• 样例文档：codes\15\15.2\example.xml

决策

在DMN规范中，根节点为deFinitions，该节点下可以出现import、itemDeFinition、drgElement等元素，其中drgElement是一个抽象元素，decision元素继承于drgElement。一个decision表示一次决策，可以为它设置name、id、label属性，按照DMN规范，name属性是必需的，而其他属性则是可选的，但作为decision的唯一标识，建议id也需要设置。一个deFinitions下可以定义0个或多个decision。代码清单15-2定义了一个decision元素。

代码清单15-2：codes\15\15.2\decision.dmn

<?xml version="1.0" encoding="UTF-8"?>
<deFinitions xmlns="http://www.omg.org/spec/DMN/20151130"
	id="simple" name="Simple" namespace="http://activiti.org/dmn">
	<decision id="decision1" name="Simple decision">
	</decision>
</deFinitions>

一个decision元素由question、allowedAnswers、expression等元素组成，其中expression元素表示决策逻辑，expression是一个抽象元素，DMN规范中，decision元素下的expression可出现0次或1次。

决策表

一个decisionTable元素表示一个决策表，decisionTable继承于expression元素，因此在decision元素下，decisionTable只允许出现0次或1次，这是DMN定义的规范，在Activiti的实现中，decision元素下如果不提供decisionTable，会报出异常。代码清单15-3定义了一个decisionTable元素以及它的几个子元素。

代码清单15-3：codes\15\15.2\decisionTable.dmn

<?xml version="1.0" encoding="UTF-8"?>
<deFinitions xmlns="http://www.omg.org/spec/DMN/20151130"
	id="simple" name="Simple" namespace="http://activiti.org/dmn">
	<decision id="decision1" name="Simple decision">
		<decisionTable id="decisionTable">
			<input/>
			<output/>
			<rule></rule>
		</decisionTable>
	</decision>
</deFinitions>

根据 DMN规范，一个decision下最多只有一个decisionTable，虽然规范中定义可以出现0次，但这样做就失去了意义，如果不提供decisionTable，Activiti的规则引擎会报出异常，信息为：java.lang.IllegalArgumentException: no decision table present in decision。

决策表元素有四个属性：hitPolicy、aggregation、preferredOrientation和outputLabel，其中hitPolicy属性用于定义规则冲突策略。

元素decisionTable下的input、output和rule子元素，可以出现多次，其中规范中定义了output元素最少出现一次，也就是意味在规范中，一次业务决策必须产出一个结果。在Activiti的初步实现中，decisionTalbe元素下，input、output和rule三个子元素都必须出现一次。

输入参数

在decisionTable元素下，可以添加多个input元素来声明输入参数，为input元素增加inputExpression元素来声明输入参数的类型以及名称等信息，代码清单15-4中定义了输出参数。

代码清单15-4：codes\15\15.2\input.dmn

<?xml version="1.0" encoding="UTF-8"?>
<deFinitions xmlns="http://www.omg.org/spec/DMN/20151130"
	id="simple" name="Simple" namespace="http://activiti.org/dmn">
	<decision id="decision1" name="Simple decision">
		<decisionTable id="decisionTable">
			<input id="inputId">
				<inputExpression id="inputExpressionId" typeRef="string">
					<text>personName</text>
				</inputExpression>
			</input>
			<output/>
			<rule></rule>
		</decisionTable>
	</decision>
</deFinitions>

代码清单15-4定义了一个参数名称为“personName”的输入参数，类型字符串。需要注意的，参数名是persionName，而不是inputId。

输出结果

每个决策表至少有一个输出结果，使用output元素定义输出参数的名称以及数据类型。代码清单15-5定义了输出结果。

代码清单15-5：codes\15\15.2\output.dmn

<?xml version="1.0" encoding="UTF-8"?>
<deFinitions xmlns="http://www.omg.org/spec/DMN/20151130"
	id="simple" name="Simple" namespace="http://activiti.org/dmn">
	<decision id="decision1" name="Simple decision">
		<decisionTable id="decisionTable">
			<input id="inputId">
				<inputExpression id="inputExpressionId" typeRef="string">
					<text>personName</text>
				</inputExpression>
			</input>
			<output id="resultId" label="Output 1" name="resultName" typeRef="string" />
			<rule></rule>
		</decisionTable>
	</decision>
</deFinitions>

代码清单15-5的粗体字代码，定义了一个名称为“resultName”的输出结果，类型为字符串类型。需要注意的是，获取结果时，要根据name属性来获取，而不是id属性。

规则

在决策表元素下可以定义多个rule元素，rule元素下可以添加inputEntry与outputEntry元素，其中inputEntry元素下支持使用MVEL表达式来实现业务规则的判断逻辑，而outputEntry元素则表示规则结果的输出，一个rule下可以出现0个或多个inputEntry，而outputEntry最少出现1次。代码清单15-6中定义两个rule。

代码清章15-6：codes\15\15.2\rule.dmn

<?xml version="1.0" encoding="UTF-8"?>
<deFinitions xmlns="http://www.omg.org/spec/DMN/20151130"
	id="simple" name="Simple" namespace="http://activiti.org/dmn">
	<decision id="decision1" name="Simple decision">
		<decisionTable id="decisionTable" hitPolicy="UNIQUE">
			<input id="input1">
				<inputExpression id="inputExpression1" typeRef="number">
					<text>personAge</text>
				</inputExpression>
			</input>
			<input id="input2">
				<inputExpression id="inputExpression2" typeRef="string">
					<text>personName</text>
				</inputExpression>
			</input>
			<output id="outputId" label="Output 1" name="myResult" typeRef="string" />
			<rule>
				<inputEntry id="inputEntry2">
					<text><![CDATA[ > 18 ]]></text>
				</inputEntry>
				<inputEntry id="inputEntry2_2">
					<text><![CDATA[ .equals('Angus') ]]></text>
				</inputEntry>
				<outputEntry id="outputEntry2">
					<text>'Man Angus'</text>
				</outputEntry>
			</rule>
			<rule>
				<inputEntry id="inputEntry1">
					<text><![CDATA[ <= 18 ]]></text>
				</inputEntry>
				<outputEntry id="outputEntry1">
					<text>'Child'</text>
				</outputEntry>
			</rule>
		</decisionTable>
	</decision>
</deFinitions>

代码清单15-6中，定义了两个两个输入参数、一个输出结果以及两个规则，第一规则触发条件为第1个参数值大于18、第2个参数值等于“Angus”，两个条件都符合时，返回 “Man Angus”字符串。第二个规则触发条件则是参数1的值小于等于18。

目前Activiti还没有完全实现DMN规范，只是有一个大概的轮廓，本书的主要内容为Activiti，下面将开始介绍Activiti关于DMN规范的API。

本文节选自《疯狂Workflow讲义（第2版）》

本书代码目录：https://gitee.com/yangenxiong/CrazyActiviti