表达式 - Amazon IoT Events
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

表达式

Amazon IoT Events在创建和更新探测器模型时提供了多种指定值的方法。您可以使用表达式来指定文字值,或者Amazon IoT Events可以在指定特定值之前对表达式求值。

语法

您可以使用文字、运算符、函数、引用和替代模板Amazon IoT Events表达式。

文本

  • 整数

  • 小数

  • 字符串

  • 布尔值

运算符

一元结果
  • 不是(布尔值):!

  • 不是(按位):~

  • 减号(算术):-

字符串
  • 连接结果:+

    两个操作数都必须是字符串。字符串文本必须括在单引号 (') 内。

    例如:'my' + 'string'->'mystring'

算术
  • 另外:+

    两个操作数都必须是数字。

  • 减:-

  • 除:/

    除法结果是四舍五入的整数值,除非至少有一个操作数(除数或除数)是十进制值。

  • 乘法:*

按位(整数)
  • 或:|

    例如:13 | 5->13

  • 和:&

    例如:13 & 5->5

  • 异或:^

    例如:13 ^ 5->8

  • 不是:~

    例如:~13->-14

布尔值
  • 小于:<

  • 小于或等于:<=

  • 等于:==

  • 不等于:!=

  • 大于或等于:>=

  • 大于:>

  • 和:&&

  • 或:||

    注意

    当子表达式为||包含未定义的数据,该子表达式被视为false.

圆括号

您可以使用圆括号对表达式中的术语进行分组。

函数

内置函数
timeout("timer-name")

求解true如果指定的计时器已过。替换”计时器名称“使用您定义的计时器的名称,用引号括起来。在事件操作中,您可以定义一个计时器,然后启动计时器、重置计时器或清除先前定义的计时器。查看背景detectorModelDefinition.states.onInput|onEnter|onExit.events.actions.setTimer.timerName.

在一个状态下设置的计时器可以在不同的状态下被引用。在进入引用计时器的状态之前,必须访问创建计时器的状态。

例如,探测器模型有两种状态, TemperatureChecked 和 RecordUpdated. 您在中创建了一个计时器 TemperatureChecked 状态。你必须访问 TemperatureChecked 在使用计时器之前,请先注明 RecordUpdated 状态。

为了确保准确性,计时器设置的最短时间为 60 秒。

注意

timeout()回报true仅在实际计时器到期后第一次检查并返回false此后。

convert(type, expression)

计算结果为转换为指定类型的表达式的值。这些区域有:类型值必须是String,Boolean,或Decimal. 使用这些关键字之一或计算结果为包含该关键字的字符串的表达式。只有以下转换成功并返回有效值:

  • 布尔值

    返回字符串"true"要么"false".

  • DECIMAL

  • 字符串

  • 字符串

    指定的字符串必须是十进制数的有效表示形式,或convert()失败。

如果convert()不返回有效值,它所属的表达式也是无效的。此结果等同于false而且不会触发actions或者过渡到nextState指定为表达式发生的事件的一部分。

isNull(expression)

求解true如果表达式返回 null。例如,如果输入MyInput接收消息{ "a": null },则以下计算结果为true,但是isUndefined($input.MyInput.a)求解false.

isNull($input.MyInput.a)
isUndefined(expression)

求解true如果表达式未定义。例如,如果输入MyInput接收消息{ "a": null },则以下计算结果为false,但是isNull($input.MyInput.a)求解true.

isUndefined($input.MyInput.a)
triggerType("type")

这些区域有:类型值可以是"Message"要么"Timer". 求解true如果由于计时器已过期而对其出现的事件条件进行评估,如下例所示。

triggerType("Timer")

或者收到了输入消息。

triggerType("Message")
currentInput("input")

求解true如果因为收到指定的输入消息而正在评估其出现的事件条件。例如,如果输入Command接收消息{ "value": "Abort" },则以下计算结果为true.

currentInput("Command")

使用此函数验证是否因为已收到特定输入而计时器尚未过期而正在评估条件,如以下表达式所示。

currentInput("Command") && $input.Command.value == "Abort"
字符串匹配函数
startsWith(expression1, expression2)

求解true如果第一个字符串表达式以第二个字符串表达式开头。例如,如果输入MyInput接收消息{ "status": "offline"},则以下计算结果为true.

startsWith($input.MyInput.status, "off")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果不为字符串值,则该函数的结果未定义。不进行任何转换。

endsWith(expression1, expression2)

求解true如果第一个字符串表达式以第二个字符串表达式结尾。例如,如果输入MyInput接收消息{ "status": "offline" },则以下计算结果为true.

endsWith($input.MyInput.status, "line")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果不为字符串值,则该函数的结果未定义。不进行任何转换。

contains(expression1, expression2)

求解true如果第一个字符串表达式包含第二个字符串表达式。例如,如果输入MyInput接收消息{ "status": "offline" },则以下计算结果为true.

contains($input.MyInput.value, "fli")

这两个表达式的计算结果必须为字符串值。如果任一表达式的计算结果不为字符串值,则该函数的结果未定义。不进行任何转换。

按位整数操作函数
bitor(expression1, expression2)

计算整数表达式的按位 OR(二进制 OR 运算对整数的相应位执行)。例如,如果输入MyInput接收消息{ "value1": 13, "value2": 5 },则以下计算结果为13.

bitor($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果不为整数值,则该函数的结果未定义。不进行任何转换。

bitand(expression1, expression2)

计算整数表达式的按位 AND(二进制 AND 运算对整数的相应位执行)。例如,如果输入MyInput接收消息{ "value1": 13, "value2": 5 },则以下计算结果为5.

bitand($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果不为整数值,则该函数的结果未定义。不进行任何转换。

bitxor(expression1, expression2)

计算整数表达式的按位 XOR(二进制 XOR 运算对整数的相应位执行)。例如,如果输入MyInput接收消息{ "value1": 13, "value2": 5 },则以下计算结果为8.

bitxor($input.MyInput.value1, $input.MyInput.value2)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果不为整数值,则该函数的结果未定义。不进行任何转换。

bitnot(expression)

计算整数表达式的按位 NOT(二进制 NOT 运算对整数的位执行)。例如,如果输入MyInput接收消息{ "value": 13 },则以下计算结果为-14.

bitnot($input.MyInput.value)

两个表达式的计算结果都必须为整数值。如果任一表达式的计算结果不为整数值,则该函数的结果未定义。不进行任何转换。

参考

输入

$input.input-name.path-to-data

input-name是您使用创建的输入CreateInput操作。

例如,如果您具有名为TemperatureInput你为此定义的inputDefinition.attributes.jsonPath条目,这些值可能会出现在以下可用字段中。

{ "temperature": 78.5, "date": "2018-10-03T16:09:09Z" }

要引用temperature字段中,使用以下命令。

$input.TemperatureInput.temperature

对于值为数组的字段,您可以使用以下方法引用数组的成员[n]. 例如,给定以下值:

{ "temperatures": [ 78.4, 77.9, 78.8 ], "date": "2018-10-03T16:09:09Z" }

78.8可以使用以下命令进行引用。

$input.TemperatureInput.temperatures[2]
Variables

$variable.variable-name

这些区域有:variable-name是您使用定义的变量CreateDetectorModel操作。

例如,如果你有一个名为的变量TechnicianID你用它定义的detectorDefinition.states.onInputEvents.actions.setVariable.variableName,你可以使用以下命令引用最近给变量的(字符串)值。

$variable.TechnicianID

您只能使用以下方式设置变量的值setVariable操作。您不能为表达式中的变量赋值。变量不能被取消设置。例如,您不能为其分配值null.

注意

在使用不遵循(正则表达式)模式的标识符的引用中[a-zA-Z][a-zA-Z0-9_]*,你必须用反引号将这些标识符括起来 (`)。例如,对名为的输入的引用MyInput用一个名为的字段_value必须将此字段指定为$input.MyInput.`_value`.

在表达式中使用引用时,请检查以下几点:

  • 当您使用引用作为具有一个或多个运算符的操作数时,请确保您引用的所有数据类型都兼容。

    例如,在以下表达式中,INTEGER2是两个的操作数==&&运算符。为了确保操作数兼容,$variable.testVariable + 1$variable.testVariable必须引用整数或小数。

    此外,INTEGER1是的操作数+操作符。因此,$variable.testVariable必须引用整数或小数。

    ‘$variable.testVariable + 1 == 2 && $variable.testVariable’
  • 当您使用引用作为传递给函数的参数时,请确保该函数支持您引用的数据类型。

    例如以下几点timeout("time-name")函数需要一个以双引号作为参数的字符串。如果你使用参考来表示计时器名称值,则必须引用带双引号的字符串。

    timeout("timer-name")
    注意

    对于convert(type, expression)函数,如果你使用引用来表示类型值,您的参考文献的评估结果必须为String,Decimal,或Boolean.

Amazon IoT Events表达式支持整数、十进制、字符串和布尔数据类型。下表提供了不兼容类型对的列表。

不兼容的类型对

整数、字符串

整数,布尔值

十进数,字符串

十进数,布尔值

字符串

替换模板

'${expression}'

这些区域有:${}将该字符串标识为插值字符串。这些区域有:expression可以是任意Amazon IoT Events表达式。这包括运算符、函数和引用。

例如,您使用了SetVariableAction定义变量的操作。variableNameSensorIDvalue10。您可以创建以下替代模板。

替换模板 结果字符串
'${'Sensor ' + $variable.SensorID}'

"Sensor 10"

'Sensor ' + '${$variable.SensorID + 1}'

"Sensor 11"

'Sensor 10: ${$variable.SensorID == 10}'

"Sensor 10: true"

'{\"sensor\":\"${$variable.SensorID + 1}\"}'

"{\"sensor"\:\"11\"}"

'{\"sensor\":${$variable.SensorID + 1}}'

"{\"sensor\":11}"