分页查询数据字典表#

验证状态：已源码核验、未联调；适用基线：Web 7fe6dd10、services 89bd222c；核验日期：2026-09-12

用途与 App 场景#

按分页读取数据字典表。当前 Web 列表页以无限滚动逐页加载（每页 10 条）。

Web 使用位置#

协议身份#

前置条件与权限#

需要有效登录态，并满足 administrator 角色或 configuration-data-dictionary-table:read。 Controller 会把 body 的 tenantId 强制覆盖为当前认证租户后再查询（es-center-server-main-service/src/main/java/com/es/center/server/configuration/controller/DataDictionaryTableController.java:196 setTenantId）；资源表另受 MyBatis 租户拦截器按认证上下文约束。认证与空间。

输入#

输出、应答或事件#

完成判据#

status=200 且 data 为当前页记录；翻页结束判据为 extraData.current >= extraData.pages（当前 Web 的 isNoMore 规则）。total=0/空数组是成功空结果。

示例#

以下均为按已核验契约构造的示例，不是真实联调记录；ID、时间与租户为占位值。

请求：

1{
2  "dataDictionaryTypeCode": "device-vendor",
3  "dataDictionaryCode": "hikvision",
4  "row": "DS-2CD3T35",
5  "sqlQuerySorter": {
6    "field": "key",
7    "order": "ascend"
8  },
9  "sqlQueryLimit": 1000,
10  "current": 1,
11  "pageSize": 10
12}

成功响应：

1{
2  "timestamp": 1789142400000,
3  "status": 200,
4  "error": null,
5  "localizedError": null,
6  "path": null,
7  "extraData": {
8    "current": 1,
9    "pages": 1,
10    "size": 10,
11    "total": 1
12  },
13  "data": [
14    {
15      "dataDictionaryTableId": "dtab-01",
16      "dataDictionaryTypeCode": "device-vendor",
17      "dataDictionaryCode": "hikvision",
18      "row": "DS-2CD3T35",
19      "key": "resolution",
20      "value": "2560x1440",
21      "name": "分辨率",
22      "sort": 1,
23      "revision": 1,
24      "createdUsername": "administrator",
25      "createdTime": 1789142400,
26      "lastModifiedUsername": "administrator",
27      "lastModifiedTime": 1789142400,
28      "deleteTime": null,
29      "tenantId": "default"
30    }
31  ]
32}

信封字段证据：gt-common-core/src/main/java/tech/gt/api/ApiResult.java（成功/失败信封）与 es-center-server-main-service/src/main/java/com/es/center/server/config/JsonFormatConfig.java:20-113（时间序列化）。

错误与边界#

认证失败/权限失败：认证与资源权限拒绝的 wire 形态见错误差异页对应锚点。 公共 Web helper 默认 15 分钟超时（app/.common/lib/fetch-timeouts.ts:4-76 fetchTimeout/fetchTimeoutResponseJson）。读取无副作用，可按网络策略重试。

调用关系与资源清理#

无限滚动逐页加载（current 递增）；筛选条件变化会重置分页。写操作成功后 reload 回第一页。

已知缺口#

无已知会阻止按当前源码调用的关键契约缺口。 仅完成双仓静态源码核验，未执行真实 HTTP、数据库或权限矩阵联调。

验证状态与依据#