咨询：如何获取entityGroupService与attributeService的详细参数及功能说明？

以下是基于ThingsBoard源码梳理的attributeService核心方法参数与功能：

• getEntityAttributes(entityId, scope, keys)

  • 功能：获取指定实体的属性数据，支持按属性范围和键筛选
  • 参数：
    • entityId：实体ID（EntityId类型，需指定实体类型如DEVICE、ASSET）
    • scope：属性范围（AttributeScope枚举，可选SERVER_SCOPE、CLIENT_SCOPE、SHARED_SCOPE）
    • keys：属性键列表（可选，为空则返回该scope下所有属性）
  • 返回：属性键值对的Map集合

• saveEntityAttributes(entityId, scope, attributes)

  • 功能：保存或更新实体的属性，支持批量操作
  • 参数：
    • entityId：目标实体ID
    • scope：属性范围
    • attributes：待保存的属性Map（键为属性名，值为对应属性值）
  • 说明：若属性已存在则覆盖，不存在则新增

• deleteEntityAttributes(entityId, scope, keys)

  • 功能：批量删除实体指定scope下的属性
  • 参数：
    • entityId：目标实体ID
    • scope：属性范围
    • keys：待删除的属性键列表
  • 说明：仅删除指定键对应的属性，未传入的键不受影响

• getEntityLatestAttributes(entityId, scope, keys)

  • 功能：获取实体指定属性的最新值（适用于时序属性场景）
  • 参数：
    • entityId：目标实体ID
    • scope：属性范围
    • keys：属性键列表（为空则返回该scope下所有属性的最新值）
  • 返回：包含最新属性值的Map

以下是entityGroupService的核心方法细节：

• getEntityGroup(groupId)

  • 功能：获取单个实体分组的详细信息
  • 参数：groupId：实体分组ID（EntityId类型，实体类型为ENTITY_GROUP）
  • 返回：EntityGroup对象，包含分组ID、名称、类型、租户ID等元数据

• getEntityGroupEntities(groupId, pageLink)

  • 功能：分页查询实体分组下的所有成员实体
  • 参数：
    • groupId：实体分组ID
    • pageLink：分页参数（PageLink类型，包含页码、每页数量、排序字段等）
  • 返回：分页后的实体列表（PageData<EntityId>）

• saveEntityGroup(entityGroup)

  • 功能：创建或更新实体分组
  • 参数：entityGroup：EntityGroup对象，需包含分组名称、类型（如DEVICE_GROUP、ASSET_GROUP）、租户ID等必填字段
  • 说明：若分组ID已存在则更新，不存在则创建新分组

• deleteEntityGroup(groupId)

  • 功能：删除指定实体分组，同时移除分组内的所有实体关联
  • 参数：groupId：实体分组ID
  • 说明：删除操作不可逆，需谨慎执行

• addEntitiesToEntityGroup(groupId, entityIds)

  • 功能：批量添加实体到指定分组
  • 参数：
    • groupId：目标分组ID
    • entityIds：待添加的实体ID列表（List<EntityId>）
  • 说明：重复添加已在分组内的实体不会报错，内部会自动去重

• removeEntitiesFromEntityGroup(groupId, entityIds)

  • 功能：批量从分组中移除实体
  • 参数：
    • groupId：目标分组ID
    • entityIds：待移除的实体ID列表
  • 说明：移除不存在于分组内的实体不会报错

内容的提问来源于stack exchange，提问作者AlexRak2