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

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

默认参数： fact

支持的参数： fact、event

@role( fact | event )

declare VoiceCall
  @role( event )
end

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

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

支持的参数： Session clock time 或自定义时间戳属性

@timestamp( <attributeName> )

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

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

默认参数：Null （零）

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

@duration( <attributeName> )

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

此标签决定事件在决策引擎工作内存中过期前的时长。默认情况下，当事件无法再匹配并激活任何当前规则时，事件会过期。您可以定义事件应过期的时间。此标签定义还覆盖由临时约束计算的隐式过期偏移，以及 KIE 基础中的分片窗口。只有在决策引擎以流模式运行时，此标签才可用。

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

支持的参数： 自定义 timeOffset 属性，格式为 [IANAd][ theh][ them][114s][[ms]]

@expires( <timeOffset> )

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

此选项卡决定给定事实类型是否使用类型 security 编译。默认情况下，所有类型声明都会在启用了安全类型的情况下编译。您可以将此行为覆盖为 type-unsafe 评估，其中所有约束都作为 MVEL 约束动态执行。这在处理没有任何通用或混合类型集合的集合时很有用。

默认参数： true

支持的参数： true,false

@typesafe( <boolean> )

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

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

默认参数：Null

支持的参数：Custom serialVersionUID 整数

@serialVersionUID( <integer> )

declare VoiceCall
  @serialVersionUID( 42 )
end

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

默认参数： None

支持的参数： 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 声明中具有最高位置注解。分号 ; 表示它之前的所有内容都是位置参数。您可以使用分号分隔它们，将位置和命名参数混合在模式上。尚未绑定的位置参数中的任何变量都绑定到映射到该位置的字段。

以下示例模式演示了构建位置和命名参数的不同方法。模式有两个限制和绑定，分号将位置部分与命名参数部分区分。仅使用字面参数支持变量和字面和表达式在位置参数中被支持，而不仅仅是变量。

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

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

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

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

位置参数可以归类为 输入参数 或 输出参数。输入参数包含之前声明的绑定，并使用取消配置来针对该绑定进行约束。输出参数生成声明，并将其绑定到位置参数表示的字段（如果绑定尚不存在）。

在扩展类型声明中，在定义 @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 （所有类型都是重新主动），则此标签将禁用特定 Java 类或声明的 DRL 事实类型的默认属性重新活动行为。如果您希望决策引擎在每次触发规则时重新评估指定事实类型的所有事实模式，而不是只响应给定模式内的修改属性，则可以使用此标签。

declare Person
  @classReactive
    firstName : String
    lastName : String
end

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

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

declare Person
  @propertyReactive
    firstName : String
    lastName : String
end

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

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

默认参数： None

支持的参数：Property name, rhncfg (all), ! (not), ! the ! the no properties）

<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( !* )

如果您在事实类型中使用 @watch 标签处理使用 @classReactive 标签（禁用属性重新活动），或者在决策引擎中将属性重新活动时，决策引擎会生成一个编译错误，相关事实类型不使用 @propertyReactive 标签。如果您在监听器注解中重复的属性（如 @watch (firstName, ! firstName) ），也会出现编译错误。

对于实施对 TTY 规范中定义的属性更改的支持的事实，此标签可让决策引擎监控事实属性中的更改。https://download.oracle.com/otndocs/jcp/7224-javabeans-1.01-fr-spec-oth-JSpec/

declare Person
    @propertyChangeSupport
end