资源定位符

资源定位符又称 tacos path ，它是一种在 TacOS 中定位相关资源的 uri 路径。tacos path 描述了各类资源在 TacOS 中的位置，包括空间本身以及空间中的六要素信息。开发者可以通过 tacos path 进行资源查询，或者直接通过 tacos path 对目标资源进行操控。

路径

在tacos path中路径分为：绝对路径（/）和相对路径（./）两种

绝对路径：指从空间目录的最顶层开始匹配
相对路径：指从当前所在的空间路径开始匹配

格式

按照tacos path的资源类型可分为空间和六要素两类，空间的 path 由 路径规则 + 空间名称 组成，六要素的 path 由 路径规则 + 空间名称 + 关键字 + 匹配规则 组成

空间: [.]/spacename[/spacename][/query]
六要素:
- /spacename[/spacename]/keywords/query
- .[/spacename]/keywords/query
注：带方括号 [ ] 表示为可选项; spacename 表示空间名称; keywordsopen in new window 表示关键字; queryopen in new window 表示匹配规则

关键字

在tacos path中用 关键字 来区分对应的资源类型

布局：layouts
设备：devices
规则：rules
计划：plans
模式：modes

匹配

通配符：*
类型： 设备驱动名称 或 场景类型 ，eg: light、window、office等
筛选器：tacos path的筛选器与xpath的属性匹配规则一致

示例

假设目前存在如下这样的空间名称结构

重庆市大融城英利大楼
    1楼
    2楼
    3楼
    ...
    46楼
        1号会议室(类型：会议室)
            灯
            电动窗
            电动窗帘
            门
        2号会议室(类型：会议室)
    47楼
    48楼
    49楼
    50楼

在 TacOS 数字空间中对应的结构名称为

yingli
    1
    2
    3
    ...
    46
        meetingroom01（type: meetingroom）
            light
            window
            curtain
            door
        meetingroom02（type: meetingroom）
    47
    48
    49
    50

eg1: 查询空间

大融城英利46楼: /yingli/46
大融城英利46楼的所有空间: /yingli/46/*
大融城英利46楼的所有会议室: /yingli/46/*[@type=meetingroom]

eg2: 查询设备

大融城英利46楼所有设备: /yingli/46/devices/*
大融城英利46楼所有灯：/yingli/46/device/light 或 /yingli/46/devices/*[@driver=light]
大融城英利46楼所有电动门：/yingli/46/devices/door
大融城英利46楼1号会议室靠西边的电动窗帘：/yingli/46/meetromm01/devices/curtain[@direction=west]

设备的类型和更多可匹配属性可点击Driver查看

eg3: 查询规则

大融城英利46楼上班规则: /yingli/46/rules/onWork

eg4: 查询计划

大融城英利46楼上班计划: /yingli/46/plans/onWork

eg5: 查询模式

大融城英利46楼上班模式: /yingli/46/modes/onWork

eg6: 查询布局

大融城英利46楼 glb 类型的布局: /yingli/46/layouts/*[@type=glb]

# 资源定位符

# 路径

# 格式

# 关键字

# 匹配

# 示例

资源定位符

路径

格式

关键字

匹配

示例