js脚本过滤器
jsFilter
组件:JavaScript脚本过滤器。使用JavaScript脚本对消息(msg)、元数据(metadata)、消息类型(msgType)进行过滤。根据脚本返回值决定消息的路由方向(True或者False链)。
JavaScript脚本支持ECMAScript 5.1(+) 语法规范和部分ES6规范,如:async/await/Promise/let。允许在脚本中调用Go自定义函数,请参考udf 。
# 配置
字段 | 类型 | 说明 | 默认值 |
---|---|---|---|
jsScript | string | js脚本 | 无 |
jsScript
:用于编写过滤逻辑的JavaScript脚本。该字段内容会被封装到以下函数体中:function Filter(msg, metadata, msgType) { ${jsScript} }
1
2
3参数说明:
- msg:消息内容
- 当dataType=JSON时,类型为
jsonObject
,可直接使用点号访问属性,如msg.temperature
- 其他dataType时,类型为
string
- 当dataType=JSON时,类型为
- metadata:消息元数据,类型为
jsonObject
- msgType:消息类型,类型为
string
- 返回值:必须返回
boolean
类型,决定消息的路由方向
- msg:消息内容
注意事项
jsScript
脚本必须有明确的返回值(return true/false)- 脚本执行有超时限制,可通过config.ScriptMaxExecutionTime配置
# Relation Type
- True: 脚本返回true时,消息将沿
True
链路径继续传递 - False: 脚本返回false时,消息将沿
False
链路径继续传递 - Failure: 脚本执行出错时,消息将沿
Failure
链路径继续传递
# 执行结果
该组件是纯过滤组件,不会修改传入的msg
、metadata
和msgType
内容。
# 配置示例
{
"id": "s1",
"type": "jsFilter",
"name": "过滤",
"configuration": {
"jsScript": "return msg.temperature > 50;"
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 应用示例
如果msgType是:EVENT_APP1,则把消息推送到:http://192.168.136.26:9099/app1/api/msg,否则推送到:http://192.168.136.26:9099/app2/api/msg
{
"ruleChain": {
"id":"rule01",
"name": "测试规则链",
"root": true
},
"metadata": {
"nodes": [
{
"id": "s1",
"type": "jsFilter",
"name": "过滤",
"configuration": {
"jsScript": "return msgType =='EVENT_APP1';"
}
},
{
"id": "s2",
"type": "restApiCall",
"name": "推送数据-app2",
"configuration": {
"restEndpointUrlPattern": "http://192.168.136.26:9099/app1/api/msg",
"requestMethod": "POST",
"maxParallelRequestsCount": 200
}
},
{
"id": "s3",
"type": "restApiCall",
"name": "推送数据-app2",
"configuration": {
"restEndpointUrlPattern": "http://192.168.136.26:9099/app2/api/msg",
"requestMethod": "POST",
"maxParallelRequestsCount": 200
}
}
],
"connections": [
{
"fromId": "s1",
"toId": "s2",
"type": "True"
},
{
"fromId": "s1",
"toId": "s3",
"type": "False"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
在 GitHub 上编辑此页 (opens new window)
上次更新: 2024/12/22, 03:38:12