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

旧城冷巷雨未停 提交于 2019-12-03 02:42:18

本文节选自《疯狂工作流讲义(第2版)》

京东购买地址:https://item.jd.com/12246565.html

疯狂Activiti电子书:https://my.oschina.net/JavaLaw/blog/1570397

工作流Activiti教学视频:https://my.oschina.net/JavaLaw/blog/1577577

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。

本文节选自《疯狂工作流讲义(第2版)》

京东购买地址:https://item.jd.com/12246565.html

疯狂Activiti电子书:https://my.oschina.net/JavaLaw/blog/1570397

工作流Activiti教学视频:https://my.oschina.net/JavaLaw/blog/1577577

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

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!