关键编码概念介绍
概念
identifier
identifier
指的是一个对象的标识符,这个标识符在同一个命名空间下不能重复。
只能含有以下字符:A-Z
a-z
0-9
_
@
#
$
-
/
[
]
,且最好以蛇形(小写字母加下划线,如 foo_bar
)命名。
- 对于集成来说,命名空间是全局,即一个Beaver IoT应用实例中的不同集成不能拥有重复的集成
identifier
。一般来说,所有Beaver IoT集成的identifier
都不应该重复。 - 对于设备来说,命名空间是这个设备的所属的集成,即一个集成下的每个设备的
identifier
都应该不同,集成之间的设备identifier
可以重复。如果是与第三方平台集成,我们建议将第三方平台的设备标识符作为identifier
,方便集成与这个平台的对应设备建立映射关系。 - 对于实体来说:
- 集成的实体命名空间是它的集成
- 设备的实体命名空间是它的设备。不同集成/设备下实体的
identifier
可以重复 - 父实体的子实体命名空间是它的父实体。不同父实体下子实体
identifier
可以重复
Full Identifier
子实体除了identifier
以外,还有fullIdentifier
,表示包括父实体在内的标识符
例如:某个子实体的identifier
是bar
,其父实体的identifier
是foo
。那么这个子实体的fullIdentifier
就是foo.bar
key
key这个概念通常只对实体有意义。
集成的实体的key格式为
{集成identifier}.integration.{实体identifier}[.{子实体identifier}]
设备的实体的key格式为
{集成identifier}.device.{设备identifier}.{实体identifier}[.{子实体identifier}]