Drools用户手册翻译——第二章入门（上）

因为篇幅原因，所以分为上下两个部分，主要就是通过一个交通违章项目的例子，带你先粗略感受一下决策模型的使用流程，总体来说有详细，也有没说清的地方，如果想要了解一下决策模型，可以进来了解一下。

甩锅声明：本人英语一般，翻译只是为了做个笔记，所以有翻译错误的地方，错就错了，如果你想给我纠正，就给我留言，我会改过来，如果懒得理我，就直接划过即可。

原文地址：https://docs.drools.org/8.40.0.Final/drools-docs/drools/getting-started/index.html

第一个规则项目

需要的工具

用maven原型创建一个项目

Drools中的角色服务入门

从头开始创建交通违法项目

决策模型

创建交通违法的DMN决策需求图

创建交通违章DMN自定义数据类型

为DRD的输入和决策节点分配自定义数据类型

定义交通违章DMN的决策逻辑

第一个规则项目

这篇指导将带你走过创建一个简单Drools应用项目的过程。

需要的工具

JDK11+环境配置

版本3.8.6+的maven

可选，一个代码编辑器，可以是IDEA，VSCode或者Eclipse

用maven原型创建一个项目

用下面的命令创建一个项目

mvn archetype:generate -DarchetypeGroupId=org.kie -DarchetypeArtifactId=kie-drools-exec-model-ruleunit-archetype -DarchetypeVersion=8.40.0.Final

在命令执行期间，输入项目的属性值

Define value for property 'groupId': org.example
Define value for property 'artifactId': my-project
Define value for property 'version' 1.0-SNAPSHOT: :
Define value for property 'package' org.example: :
...
 Y: : Y
...
[INFO] BUILD SUCCESS

现在，你的第一个规则项目建好了，让我们进到项目里面去查看一下。

首先，是pom文件

<dependency>
   <groupId>org.drools</groupId>
   <artifactId>drools-ruleunits-engine</artifactId>
</dependency>

对于单元规则用例来说，这是一个必须的依赖。

你可以继续使用传统的drools7风格的规则而不是单元规则。

这个用例里面，使用kie-drools-exec-model-archetype。

原型包含一个DRL文件，如下面的例子所示：

package org.example;

unit MeasurementUnit;

rule "will execute per each Measurement having ID color"
when
        /measurements[ id == "color", $colorVal : val ]
then
        controlSet.add($colorVal);
end

query FindColor
    $m: /measurements[ id == "color" ]
end

这个规则检测传入的Measurement数据，并且当其实颜色信息时，将其值存储在一个全局变量controlSet中。when的部分实现了模式匹配，then的部分实现了当条件成立时的行为。

下一步，找到src/main/java/org/example/MeasurementUnit.java 该类详细说明了规则里面的单元MeasurementUnit。这个被叫做规则单元，用于对数据源，全局变量和DRL规则进行分组。

public class MeasurementUnit implements RuleUnitData {

    private final DataStore<Measurement> measurements;
    private final Set<String> controlSet = new HashSet<>();

    ...

规则文件rules.drl中的/measurements是绑定到MeasurementUnit中的mensurements属性的字段。所以你知道输入的数据类型是Measurement。这个类也被定义为全局变量controlSet。

然后，src/main/java/org/example/Measurement.java 是规则里面的一个java bean的类。这样的对象被称作Fact。

最后，src/test/java/org/example/Measurement.java是执行规则的测试用例。你可以学习在自己的应用中使用简单的API。

MeasurementUnit measurementUnit = new MeasurementUnit();

RuleUnitInstance<MeasurementUnit> instance = RuleUnitProvider.get().createRuleUnitInstance(measurementUnit);

创建一个Measurement实例，然后用RuleUnitProvider创建一个带有Measurement实例的RuleUnitInstance。

measurementUnit.getMeasurements().add(new Measurement("color", "red"));
measurementUnit.getMeasurements().add(new Measurement("color", "green"));
measurementUnit.getMeasurements().add(new Measurement("color", "blue"));

在measurementUnit.measurements添加Measurement facts。这意味着facts被插入到了Drools规则引擎。

List<Measurement> queryResult = instance.executeQuery("FindColor").stream().map(tuple -> (Measurement) tuple.get("$m")).collect(toList());

执行一个叫做FindColor的查询。当你执行一个查询，将自动启动与插入的facts匹配的规则。如果你指向启动规则，不需要查询，你可以直接调用Instance.fire()。

instance.close();

在最后，调用close方法释放RuleUnitInstance所持有的资源。

让我们用mvm clean test命令去运行一下测试程序。

[INFO] ------------------------------------------------------- [INFO] T E S T S [INFO] ------------------------------------------------------- [INFO] Running org.example.RuleTest 2022-06-13 12:49:56,499 [main] INFO Creating RuleUnit 2022-06-13 12:49:56,696 [main] INFO Insert data 2022-06-13 12:49:56,700 [main] INFO Run query. Rules are also fired [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.411 s - in org.example.RuleTest

现在你可以添加自己的规则和facts到项目里面去了。

规则项目需要在通过mvn编译阶段生成代码。如果你直接在IDE里面运行RuleTest.java，你可能需要先运行一下mvn compile命令。

Drools中的角色服务入门

作为一个业务规则的开发者，你可以使用Drools设计各种各样的决策服务。这篇文章基于从Kogito Examples GitHub repository（https://github.com/kiegroup/kogito-examples/tree/stable/kogito-quarkus-examples/dmn-quarkus-example）获得的Traffic_Violation样例工程描述了如何去创建并测试一个交通违章的例子。这个样例项目使用决策模型去定义司机在交通违章中的处罚。你可以根据本文档的步骤去建立一个项目和其包含的文件等，或者打开查看已经创建好的Traffic_Violation的示例项目。或者，你可以直接跳到项目评估部分，方法是从上面的连接中本地查看现成的Traffic_Violation示例项目，然后跳到 Evaluating the traffic violations DMN model with Drools（使用Drools评估交通违法DMN模型）（地址：https://docs.drools.org/8.40.0.Final/drools-docs/drools/getting-started/index.html#gs-evaluating-dmn_getting-started-decision-services）部分。

为了得到更多Drools中DMN模块和实现的信息，可以参考DMN Engine in Drools section（https://docs.drools.org/8.40.0.Final/drools-docs/drools/getting-started/index.html#dmn-con_dmn-models）.

先决条件

有一个明确的部署平台。例如使用drools所谓java的依赖，或者使用在云原生平台上使用Kogito。
满足部署平台的先决条件。
在遵循被教程的同时，考虑部署平台的部署过程。

从头开始创建交通违法项目

在IDE中创建一个名为traffic-violation的项目。该项目包含很多素材，例如数据对象，DMN素材，和测试方案。你创建的样例工程和已经存在的Traffic_Violation样例工程，是相似的。

根据你使用的IDE和下面的介绍，创建一个基于mavne的KJAR项目。

决策模型

决策模型是由OMG为了描述和建模而建立的一套标准。DMN定义了一套XML的模型，该模式可以让DMN模型在符合DMN模式的平台之间甚至跨越组织去分享，以便让业务分析师和业务规则开发人员在设计与实现DMN决策服务时进行合作。DMN标准和为了设计与建立业务模型过程的BPMN标准相似的标准，并且能够一起使用。

想要获取更多关于DMN背景和应用的信息，请看 Drools DMN landing page

（https://www.drools.org/learn/dmn.html）.

创建交通违法的DMN决策需求图

决策需求图是你的DMN模型的视觉表示。使用KIE DMN便捷器去为交通违法项目设计决策需求图，并且决策需求图组件的决策逻辑。

图示1.交通违法示例的DRD

先决条件

你已经用Drools建立了一个交通违法项目。

过程

在交通违法项目的首页，点击添加Asset。
在Add Asset页面，点击DMN。创建新的DMN窗口会被打开。 a.在创建新DMN窗口中，在DMN的name属性里面输入Traffic Violation . b.从Package列表里面，选择com.myspace.traffic_violation. c.点击OK。 DMN设计器里面的DMN素材就会被打开。
在DMN设计板上，拖两个DMN输入数据点到画布上。图示2. DMN输入数据点
在右上角点击编辑 icon。
双击输入点并且对其中一个重命名为Driver，另一个重命名为Violation。
拖一个DMN Decision决策点到画布上。
双击决策节点并且重命名为Fine
点击Violation输入节点，选择Create DMN Information Requirement图标，并且点击Fine决策节点去连接这两个节点。图示3.Create DMN Information Requirement图标
拖一个DMN Decision决策节点到画布上。
双击决策节点，重命名为Should the driver be suspended？
点击Driver输入节点，选择 Create DMN Information Requirement图标连接Should the driver be suspended?决策节点
点击Fine决策节点，选择 Create DMN Information Requirement图标，选择Should the driver be suspended?决策节点。
点击保存

注意：当你定期地保存DRD时，DMN设计者会对DMN模型进行验证，并且在模型完全定义之前，可能会产生错误的信息。在你完成DMN定义之后，如果还有错误，需要对指定的问题进行故障排除。

创建交通违章DMN自定义数据类型

DMN数据类型决定了在DMN装箱表达式中的表、列或字段中用于定义决策逻辑的数据的结构。你可以使用默认的数据类型（像String，Number或者Boolean），也可以使用自定义的数据类型，去指定你想实现装箱表达式值的属性和约束。使用KIE DMN编辑器的数据类型Tab为交通违章项目，定义自定义数据类型。

图示4.自定义数据类型tab

创建下面的表列表tDriver，tViolation和tFine自定义数据类型.

Name	Type
tDriver	Structure
Name	string
Age	number
State	string
City	string
Points	number

Name	Type
tViolation	Structure
Code	string
Date	date
Type	string
Speed Limit	number
Actual Speed	number

Name	Type
tFine	Structure
Amount	number
Points	number

先决条件：

你用KIE DMN编辑器创建了交通违章DMN决策需求表

过程

1.创建自定义数据tDriver，在Data Types tab页里点击Add a custom Data Type，在name属性栏里输入tDriver，在Type列表里面选择Structure。

2.单击New Data Type右侧的复选框来保存你的更改。

3.通过点击tDriver旁边的加号，添加下列属性到tDriver数据结构中。点击每一个新数据类型右侧的复合按钮保存更改。

Name（string）

Age（number）

State（string）

City（string）

Points（number）

4.创建自定义数据tViolation，点击New Data Type，在Name属性中输入tViolation，在Type列表里面选择Structure。

图示6. 自定义数据类型tViolation

6.通过点击tViolation旁边的加号，添加下列属性到tViolation数据结构中。点击每一个新数据类型右侧的复合按钮保存更改。

Code（string）

Date（date）

Type（string）

Speed Limit（number）

Actual Speed（number）

7.在嵌套数据类型Type里添加下列约束，点击编辑图标，点击添加约束，在Select constraint type下拉菜单里选择Enumeration。

Speed

Parking

Driving under the influence

8.点击OK，然后点击Type数据类型右侧的复选框保存你的修改。

9.创建自定义数据tFine，点击New Data Type，在Name属性中输入tFine，在Type列表里面选择Structure,点击保存。

图示7. 自定义数据类型tFine

10.通过点击tFine旁边的加号，添加下列属性到tFine数据结构中。点击每一个新数据类型右侧的复合按钮保存更改。

Amount（number）

Points（number）

11.点击Save。

为DRD的输入和决策节点分配自定义数据类型

在创建DMN自定义数据类型之后，将这些自定义数据分配给交通违章DRD里面的DMN输入节点和DMN决策节点。

先决条件：

在KIE DMN编辑器里面已经创建了交通违章DMN自定义数据类型。

过程：

单击DMN 设计者的Model菜单的tab页，单击DMN设计者的右上角的属性图标，导出DRD的属性。
在DRD中，选择Driver输入节点并且在Properties 面板的数据类型下拉菜单里面选择tDriver。
选择Violation输入节点并且在Properties 面板的数据类型下拉菜单里面选择tViolation。
选择Fine输入节点并且在Properties 面板的数据类型下拉菜单里面选择tFine。
选择Should the driver be suspended? 决策节点并且设置如下属性
1. 数据类型：string
2. 问题：Should the driver be suspended due to points on his driver license?
3. 允许的回答：Yes,No
单击保存。