Skip to content

Asset Management Service – 分页

使用租户时,它通常会收集越来越多的 assets、asset types、aspect 类型和文件。当使用相应的 GET 端点进行搜索时,响应结果将包含拥有数百条目的对象列表。为了将结果分解为可处理的块,Asset Management Service 提供了分页功能。此功能可将结果划分为多个页面,这些页面仅包含指定数量的结果。

以下端点支持分页功能:

GET /assettype
GET /aspecttype
GET /assets
GET /files
GET /assets/{assetId}/variables
GET /assets/{assetId}/aspects

分页参数

参数 描述 默认值
size 定义每页返回的对象数。(可选) 10
page 每个页面最多只包含 size 参数定义的对象数量,默认情况下,仅返回第一个页面。使用此参数可更改要返回的页码。(可选) 0
sort 定义对结果进行排序所依据的对象属性。(可选) 名称按升序排序

如上表所示,分页参数是可选的。默认情况下,端点按字母顺序返回前 10 个元素。响应结果的末尾列出了 size 参数值、元素总数、页面总数以及返回页面的页码,例如:

"page": {
 "size":10,
 "totalElements":433,
 "totalPages":44,
 "number":0
 }

大小

每页返回的对象数使用 size 参数设置。其默认值为 10。请注意,更改 size 值会影响页面总数,因为对象总数会划分为更大或更小的多个块。

页面

默认情况下,将返回结果的第一页。其页码为 0,为 page 参数的默认值。如果结果包含多个页面,可使用此参数选择要返回的页面。

排序

使用 sort 参数,可修改排序属性和排序顺序。此参数的输入需区分大小写,并接受根据对象属性名称进行排序。所有指定为可过滤的对象属性都可以作为输入。
若要按降序排序,请在对象属性的名称后面附加 ,desc。这需要显式设置对象属性,即使您要使用默认值也应如此。


Last update: April 24, 2019