异步任务
概览
YSystem 会调用上游服务获取酒店价格方案等实时信息。由于查询需要一定时间,您可以使用异步任务机制,先返回部分结果,再补充完整数据。以下是一些典型场景:
- 在酒店列表中,
/hotel/search可以先返回酒店基础信息,同时异步获取价格;任务完成后,再将价格补充到页面。 - 在酒店详情中,
/hotel/rates可以先返回部分价格方案,同时异步获取后续方案。
技术实现方式
在请求中添加 mode 参数即可启用异步任务。响应会在部分结果之外返回 asyncJobId。
使用 asyncJobId 再次请求原路由,或调用 /job/getResult,即可获取后续结果。
下面列举了一些典型的异步任务场景:
/hotel/search?mode=async
/hotel/search响应:提供酒店基础信息,不包含价格。/job/getResult响应(或在/hotel/search的查询参数中带上asyncJobId):提供酒店基础信息及价格。
/hotel/rates?mode=asyncPaging
/hotel/rates响应:提供第一页价格方案。/job/getResult响应(或在/hotel/rates的查询参数中带上asyncJobId):提供后续价格方案,不包含第一页方案。
/hotel/rates?mode=asyncPagingMerged
/hotel/rates响应:提供第一页价格方案。/job/getResult响应(或在/hotel/rates的查询参数中带上asyncJobId):提供第一页和后续价格方案。
对于 /hotel/rates,/job/getResult 可能继续返回 asyncJobId,表示仍有后续页面正在获取。请持续调用 /job/getResult,直到响应中不再包含 asyncJobId。