31 lines
1.4 KiB
Markdown
31 lines
1.4 KiB
Markdown
# 任务提交与幂等
|
||
|
||
同一请求提交两次，查询任务和直接来源，再按版本取消。
|
||
|
||
## 准备
|
||
|
||
- Go 1.27.1、当前版本 Orbit；服务启动和初始化见[仓库 README](../../README.md#快速开始)。
|
||
- 任务提交、读取、取消权限；不需要 Worker。
|
||
- [示例总索引](../README.md)提供统一初始化和权限说明；完整字段、失败处理见[详细手册](../../docs/sdk/README.md)。
|
||
|
||
## 运行
|
||
|
||
以下命令从仓库根目录执行；凭据路径替换为实际初始化输出。
|
||
|
||
```sh
|
||
cd examples
|
||
export ORBIT_URL=http://127.0.0.1:8080
|
||
export ORBIT_CREDENTIALS_FILE="$PWD/../.local/development.credentials.json"
|
||
go run ./tasks
|
||
```
|
||
|
||
## 结果核对
|
||
|
||
duplicate=true；source_kind=DIRECT；final_state=CANCELLED。具体 ID 和统计值以本次运行为准。程序会核对上述关键条件，失败时打印错误并以非零状态退出。
|
||
|
||
## 接入自己的项目
|
||
|
||
阅读[main.go](main.go)中的客户端创建、请求及错误处理。业务项目通过 `go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.1` 引入 SDK，无需导入本示例包。
|
||
|
||
示例运行会写入真实平台数据，应使用专用测试应用/队列。正常结束保留历史和审计；重复演示通常创建新身份，不能当作上次失败操作的恢复。真实业务应在第一次请求前持久化操作身份，网络结果不明时沿原身份核对。
|