协议版本: draft
取消流程
当一方希望取消一个进行中的请求时,它会发送一个notifications/cancelled 通知,其中包含:
- 需要取消的请求ID
- 一条可记录或显示的可选原因字符串
行为要求
- 取消通知 必须 仅引用满足以下条件的请求:
- 之前在同一方向上发布
- 被认为仍在进行中
initialize请求禁止被客户端取消- 取消通知的接收者应该:
- 停止处理已取消的请求
- 释放关联资源
- 不发送已取消请求的响应
- 接收者 可以 忽略取消通知,如果:
- 引用的请求未知
- 处理已完成
- 请求无法被取消
- 取消通知的发送者应忽略后续收到的任何请求响应
计时考量
由于网络延迟,取消通知可能在请求处理完成后才到达,甚至可能是在响应已经发送之后。 双方 必须 优雅地处理这些竞态条件:实现说明
- 双方应当记录取消原因以便于调试
- 应用用户界面应当在取消请求时进行指示
错误处理
无效的取消通知应该被忽略:- 未知请求ID
- 已经完成的请求
- 格式错误的通知