跳到主要内容

关键编码概念介绍

概念

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,表示包括父实体在内的标识符

例如:某个子实体的identifierbar,其父实体的identifierfoo。那么这个子实体的fullIdentifier就是foo.bar

key

key这个概念通常只对实体有意义。

集成的实体的key格式为

{集成identifier}.integration.{实体identifier}[.{子实体identifier}]

设备的实体的key格式为

{集成identifier}.device.{设备identifier}.{实体identifier}[.{子实体identifier}]