16.5. DRL 中的类型声明和元数据

此标签决定，给定事实类型是作为常规事实处理，还是在复杂事件处理期间在决策引擎中的事件进行处理。

default 参数： fact

支持的参数： 事实、事件

@role( fact | event )

declare VoiceCall
  @role( event )
end

此标签会自动分配给决策引擎中的每个事件。默认情况下，会话时钟提供的时间，并在事件插入决策引擎的工作内存中时分配给事件。您可以指定自定义时间戳属性，而不是会话时钟添加的默认时间戳。

default 参数：决策引擎会话时钟添加的时间

支持的参数： Session clock time 或 custom time stamp 属性

@timestamp( <attributeName> )

declare VoiceCall
  @role( event )
  @timestamp( callDateTime )
end

此标签决定决策引擎中事件的持续时间。事件可以是基于间隔的事件或时间点事件。基于间隔的事件的时间，并在决策引擎的工作内存中保留一段时间，直到它们的持续时间可用为止。点内事件没有持续时间，基本上是基于 interval 的事件，且持续为零。默认情况下，决策引擎中的每个事件都会有零持续时间。您可以指定自定义持续时间属性，而不是默认值。

默认参数：Null（零）

支持的参数： 自定义持续时间属性

@duration( <attributeName> )

declare VoiceCall
  @role( event )
  @timestamp( callDateTime )
  @duration( callDuration )
end

此标签决定事件在决策引擎工作内存过期前的时间持续时间。默认情况下，事件过期，事件不再匹配并激活任何当前规则。您可以定义事件应过期的时间。此标签定义还覆盖从 KIE 基础中的时序限制和滑动窗口计算的隐式到期偏移。只有在决策引擎以流模式运行时，该标签才可用。

默认参数：Null（事件后的事件过期，不再匹配并激活规则）

支持的参数：自定义 timeOffset 属性，格式为 [#d][#h][#m][#s][[ms]]

@expires( <timeOffset> )

declare VoiceCall
  @role( event )
  @timestamp( callDateTime )
  @duration( callDuration )
  @expires( 1h35m )
end

此选项卡确定给定事实类型是使用 还是没有类型安全性的编译。默认情况下，所有类型声明都是使用启用类型 security 进行的编译。您可以覆盖此行为来类型非安全评估，其中所有限制都是以 MVEL 约束并执行动态生成的。这在处理没有通用或混合类型集合的集合时很有用。

默认参数： true

支持的参数： true、false

@typesafe( <boolean> )

declare VoiceCall
  @role( fact )
  @typesafe( false )
end

此标记在事实声明中为 serializable 类定义标识 serialVersionUID 值。如果 serializable 类没有明确声明 serialVersionUID，则序列化运行时间会根据类的不同方面计算该类的默认 serialVersionUID 值，如 Java Object Serialization 规格 中所述。但是，为了实现最佳反序列化结果并更好地与序列化 KIE 会话的兼容性，请在相关类或您的 DRL 声明中根据需要设置 serialVersionUID。

默认参数： Null

支持的参数： 自定义 serialVersionUID 整数

@serialVersionUID( <integer> )

declare VoiceCall
  @serialVersionUID( 42 )
end

此标签启用事实类型属性，用作事实类型的键标识符。然后，生成的类可以实施 equals（） 和 hashCode（） 方法，以确定类型的两个实例是否等于。决策引擎还可使用所有关键属性作为参数生成构造器。

默认参数： None

支持的参数： 无

<attributeDefinition> @key

declare Person
    firstName : String @key
    lastName : String @key
    age : int
end

在本例中，决策引擎检查 firstName 和 lastName 属性，以确定 Person 的两个实例是否相互相等，但它没有检查 age 属性。决策引擎还会隐式生成三个构造器：一个没有参数，一个含有 @key 字段，另一个含有所有字段：

Person() // Empty constructor

Person( String firstName, String lastName )

Person( String firstName, String lastName, int age )

然后，您可以基于密钥构造器创建类型为 的实例，如下例所示：

Person person = new Person( "John", "Doe" );

此标记决定了位置参数中声明事实类型属性或字段的位置，覆盖属性的默认声明顺序。您可以使用此标签来修改模式中的位置限制，同时保持类型声明和位置参数的一致格式。此标签仅适用于 classpath 上类的字段。如果一个类中的一些字段使用此标签，则没有此标签的属性将按照声明的顺序定位。支持类继承，但不支持方法接口。

默认参数： None

支持的参数： 任何整数

<attributeDefinition> @position ( <integer> )

declare Person
    firstName : String @position( 1 )
    lastName : String @position( 0 )
    age : int @position( 2 )
    occupation: String
end

在本例中，属性按以下顺序在位置参数中排列优先级：

在位置参数中，您不需要指定字段名称，因为位置映射到已知命名字段。例如，参数 Person(lastName == "Doe") 与 Person("Doe";) 相同，其中 lastName 字段在 DRL 声明中具有最高位置注解。分号 ; 表示在它是一个位置参数之前的所有内容。您可以使用分号将它们分开，在模式中混合位置和命名参数。位置参数中的任何变量都未绑定到映射到该位置的字段。

以下示例模式演示了构建位置和命名参数的不同方法。该模式有两个限制和绑定，分号区分指定参数部分的 positional 部分。在位置参数中支持使用字面意义的变量和字面量，但不支持单独变量。

Person( "Doe", "John", $a; )

Person( "Doe", "John"; $a : age )

Person( "Doe"; firstName == "John", $a : age )

Person( lastName == "Doe"; firstName == "John", $a : age )

位置参数可以归类为 输入参数 或 输出参数。输入参数包含之前声明的绑定并使用未验证受到该绑定的限制。当绑定尚不存在时，输出参数会生成声明并将其绑定到 positional 参数代表的字段。

在扩展类型声明中，在定义 @position 注释时要谨慎，因为属性位置在子类型中继承。这种继承可能会导致混合属性顺序在在某些情况下可能会引起混淆。两个字段可以具有相同的 @position 值，并且不需要声明连续的值。如果重复位置，则使用继承的方式解决冲突，即父类型中的位置值具有优先权，然后使用第一个到最后一个声明中的声明顺序。

例如，以下扩展类型声明导致混合位置优先级：

declare Person
    firstName : String @position( 1 )
    lastName : String @position( 0 )
    age : int @position( 2 )
    occupation: String
end

declare Student extends Person
    degree : String @position( 1 )
    school : String @position( 0 )
    graduationDate : Date
end

在本例中，属性按以下顺序在位置参数中排列优先级：

如果在决策引擎中将属性重新活动设置为 ALWAYS （所有类型都是 reactive），则此标签会禁用特定 Java 类的默认属性重新活动行为或声明的 DRL 事实类型。如果您希望决策引擎在每次触发规则时重新评估指定事实类型的所有事实模式，则可使用此标签，而不是仅响应给定模式内受约束或绑定的属性。

declare Person
  @classReactive
    firstName : String
    lastName : String
end

@classReactive
public static class Person {
    private String firstName;
    private String lastName;
}

如果在决策引擎中将属性重新活动设置为 ALLOWED （没有属性重新活跃），则此标签为特定 Java 类启用属性重新活动，或者为声明的 DRL 事实类型启用属性重新活动。如果您希望决策引擎仅响应指定事实类型内受限制或绑定的属性，则可使用此标签，而不是在每次触发规则时重新评估所有事实模式。

declare Person
  @propertyReactive
    firstName : String
    lastName : String
end

@propertyReactive
public static class Person {
    private String firstName;
    private String lastName;
}

此标签为您在 DRL 规则中以实际模式指定的附加属性启用属性重新活动。只有在决策引擎中将属性重新活动设置为 ALWAYS 时，或将属性重新活动设置为 ALLOWED 且相关事实类型使用 @propertyReactive 标签时，才支持该标签。您可以在 DRL 规则中使用此标签在事实属性重新活动逻辑中添加或排除特定属性。

默认参数： None

支持的参数：Property name, * （全部）、! （不是）、!* （无属性）

<factPattern> @watch ( <property> )

// Listens for changes in both `firstName` (inferred) and `lastName`:
Person(firstName == $expectedFirstName) @watch( lastName )

// Listens for changes in all properties of the `Person` fact:
Person(firstName == $expectedFirstName) @watch( * )

// Listens for changes in `lastName` and explicitly excludes changes in `firstName`:
Person(firstName == $expectedFirstName) @watch( lastName, !firstName )

// Listens for changes in all properties of the `Person` fact except `age`:
Person(firstName == $expectedFirstName) @watch( *, !age )

// Excludes changes in all properties of the `Person` fact (equivalent to using `@classReactivity` tag):
Person(firstName == $expectedFirstName) @watch( !* )

如果您在使用 @classReactive 标签的事实类型中使用 @watch 标签（禁用属性重新活动），或在决策引擎中将属性重新活动设置为 ALLOWED，则决策引擎将 @watch 标签用于属性。如果您在监听器注解中重复属性（如 @watch(firstName, ! firstName) ）时，也会发生编译错误。

对于实现对 JavaBeans 规格中定义的属性更改的事实，此标签使决策引擎能够监控事实属性中的更改。

declare Person
    @propertyChangeSupport
end