2.2. 创建和管理计数
通过 REST API 创建、删除和修改计数器。
2.2.1. 创建计数 复制链接链接已复制到粘贴板!
使用在有效负载中包含配置的 POST 请求创建计数器。
POST /rest/v2/counters/{counterName}
POST /rest/v2/counters/{counterName}
Weak Counter 示例
Strong Counter 示例
2.2.2. 删除计数 复制链接链接已复制到粘贴板!
使用 DELETE 请求删除特定的计数器。
DELETE /rest/v2/counters/{counterName}
DELETE /rest/v2/counters/{counterName}
2.2.3. 检索计数配置 复制链接链接已复制到粘贴板!
使用 GET 请求检索特定计数器的配置。
GET /rest/v2/counters/{counterName}/config
GET /rest/v2/counters/{counterName}/config
Data Grid 使用 JSON 格式的计数器配置响应。
2.2.4. 获取计数值 复制链接链接已复制到粘贴板!
使用 GET 请求检索计数器值。
GET /rest/v2/counters/{counterName}
GET /rest/v2/counters/{counterName}
| 标头 | 必需/可选 | 参数 |
|---|---|---|
| OPTIONAL | 返回内容所需的格式。支持的格式为 application/json 和 text/plain。如果未提供标头,则会假定 JSON。 |
2.2.5. 重置计数 复制链接链接已复制到粘贴板!
恢复没有 POST 请求和 ?action=reset 参数的初始计数器值。
POST /rest/v2/counters/{counterName}?action=reset
POST /rest/v2/counters/{counterName}?action=reset
如果操作成功完成,服务会返回 204 (No Content)。
2.2.6. 递增计数 复制链接链接已复制到粘贴板!
使用 POST 请求'和 ?action=increment 参数递增计数器值。
POST /rest/v2/counters/{counterName}?action=increment
POST /rest/v2/counters/{counterName}?action=increment
WEAK 计数器不会在操作后响应并返回 204 (无内容)。
STRONG 计数器在每次操作后返回 200 (OK) 和当前值。
2.2.7. 将 Deltas 添加到 Counters 复制链接链接已复制到粘贴板!
使用包含 ?action=add 和 delta 参数的 POST 请求向计数器添加任意值。
POST /rest/v2/counters/{counterName}?action=add&delta={delta}
POST /rest/v2/counters/{counterName}?action=add&delta={delta}
WEAK 计数器不会在操作后响应并返回 204 (无内容)。
STRONG 计数器在每次操作后返回 200 (OK) 和当前值。
2.2.8. 减少计数值 复制链接链接已复制到粘贴板!
使用 POST 请求和 ?action=decrement 参数来解码计数器值。
POST /rest/v2/counters/{counterName}?action=decrement
POST /rest/v2/counters/{counterName}?action=decrement
WEAK 计数器不会在操作后响应并返回 204 (无内容)。
STRONG 计数器在每次操作后返回 200 (OK) 和当前值。
2.2.9. 在 Strong Counters 上执行比较AndSet 操作 复制链接链接已复制到粘贴板!
通过 GET 请求和 compareAndSet 参数,以原子方式设置计数器的值。
POST /rest/v2/counters/{counterName}?action=compareAndSet&expect={expect}&update={update}
POST /rest/v2/counters/{counterName}?action=compareAndSet&expect={expect}&update={update}
如果当前值为 {expect},则数据网格会以原子方式将值设置为 {update}。如果操作成功,Data Grid 将返回 true。
2.2.10. 在 Strong Counters 上执行比较AndSwap 操作 复制链接链接已复制到粘贴板!
通过 GET 请求和 compareAndSwap 参数,以原子方式设置计数器的值。
POST /rest/v2/counters/{counterName}?action=compareAndSwap&expect={expect}&update={update}
POST /rest/v2/counters/{counterName}?action=compareAndSwap&expect={expect}&update={update}
如果当前值为 {expect},则数据网格会以原子方式将值设置为 {update}。如果操作成功,Data Grid 会从载荷返回先前的值。
2.2.11. 列出计数 复制链接链接已复制到粘贴板!
使用 GET 请求检索 Data Grid 集群中的计数器列表。
GET /rest/v2/counters/
GET /rest/v2/counters/