过滤规则参数说明
事件源产生的事件与过滤规则进行匹配，匹配成功后事件才会被路由到与过滤规则关联的事件目标。过滤规则必须和匹配的事件具有相同的结构。
本章节介绍过滤规则和事件匹配时的规则，以及构成过滤规则的参数：运算操作符、条件表达式和匹配字段。
匹配规则
过滤规则和事件匹配时，需要遵循以下规则：
- 顶级匹配字段只支持source、type、subject、data。
- 顶级匹配必须包括source字段，且source只支持StringIn操作符。
- data字段最多支持5个任意匹配字段，每个匹配字段最多嵌套5级。
- 每个匹配字段的匹配条件最多支持5个，多个匹配条件间是“或”的关系。
- 多个匹配字段间是“并且”的关系。
- 同一层级相同的匹配字段定义多次，则以最后一次为准。
运算操作符
过滤规则和事件匹配时，使用的运算操作符如表1所示。
|
操作符 |
输入值 |
条件值 |
说明 |
|---|---|---|---|
|
StringIn |
String/String[] |
String[] values |
检查输入值是否与任一条件值完全匹配 |
|
StringNotIn |
String/String[] |
String[] values |
检查输入值是否与所有条件值都不匹配 |
|
StringStartsWith |
String/String[] |
String[] values |
检查输入值是否与任一条件值前缀匹配 |
|
StringNotStartsWith |
String/String[] |
String[] values |
检查输入值是否与所有条件值前缀都不匹配 |
|
StringEndsWith |
String/String[] |
String[] values |
检查输入值是否与任一条件值后缀匹配 |
|
StringNotEndsWith |
String/String[] |
String[] values |
检查输入值是否与所有条件值后缀都不匹配 |
|
NumberIn |
Number/Number[] |
Number[] values |
检查输入值是否与任一条件值完全匹配 |
|
NumberNotIn |
Number/Number[] |
Number[] values |
检查输入值是否与所有条件值都不匹配 |
|
NumberLessThan |
Number/Number[] |
Number value |
检查输入值是否与小于条件值 |
|
NumberNotLessThan |
Number/Number[] |
Number value |
检查输入值是否与不小于（大于或等于）条件值 |
|
NumberGreaterThan |
Number/Number[] |
Number value |
检查输入值是否与大于条件值 |
|
NumberNotGreaterThan |
Number/Number[] |
Number value |
检查输入值是否与不大于（小于或等于）条件值 |
|
NumberInRange |
Number/Number[] |
Number[][] values |
检查输入值是否在任一条件范围内 |
|
NumberNotInRange |
Number/Number[] |
Number[][] values |
检查输入值是否不在任一条件范围内 |
|
IsNull |
- |
无 |
检查输入值是否为null或未定义 |
|
IsNotNull |
- |
无 |
检查输入值是否不为null或未定义 |
|
IsTrue |
Boolean |
无 |
检查输入值是否为true |
|
IsNotTrue |
Boolean |
无 |
检查输入值是否不为true，即false |
条件表达式
过滤规则和事件匹配时，使用的条件表达式如表2所示。
匹配字段
过滤规则和事件匹配时，使用的匹配字段如表3所示。
|
字段名 |
条件值类型 |
示例说明 |
|---|---|---|
|
source |
JSON对象数组 |
事件源，条件值位于JSON数组中，source字段只支持“StringIn” 示例: [{“op”: “StringIn”, “values”: [“HC.OBS”]}] |
|
type |
JSON对象数组 |
事件类型，条件值位于JSON数组中 示例: [{“op”: “StringIn”, “values”: [“object:put”]}] |
|
subject |
JSON对象数组 |
事件主体，条件值位于JSON数组中 示例: [{“op”: “StringEndsWith”, “values”: [“.jpg”]}] |
|
data |
JSON对象 |
事件数据，条件值位于JSON对象中，条件值为子匹配字段，支持最多5层嵌套结构 示例: {“state”: [{“op”: “StringIn”, “values”: [“running”]}] |
