RESTful API - 批量操作的分块响应

时间:2015-02-27 15:24:34

标签: java json rest jax-rs chunked

我处理类似REST的API,它将支持某些资源上的批量操作。由于完成此类请求可能需要一些时间,因此我希望在分块响应中返回操作的状态。媒体类型应为JSON。如何使用JAX-RS?

(我知道有StreamingOutput,但需要手动序列化数据。)

1 个答案:

答案 0 :(得分:8)

Chunked Transfer编码通常用于发件人开始传输数据时内容长度未知的情况。接收器可以处理每个块,而服务器仍在生成新的块。 这意味着服务器正在发送整个时间。我不认为以块的形式发送I'm still working|I'm still working|I'm still working|是非常有意义的,据我所知,大多数应用服务器都会透明地处理分块传输编码。当响应大于特定大小时,它们会自动切换。

您的用例的常见模式如下所示:

客户端触发批量操作:

POST /batch-jobs HTTP/1.1

服务器创建一个描述作业状态的资源,并在Location头中返回URI:

HTTP/1.1 202 Accepted
Location: /batch-jobs/stats/4711

客户端检查此资源并收到200:

GET /batch-jobs/stats/4711 HTTP/1.1

此示例使用JSON,但您也可以返回纯文本或添加缓存标头,告诉客户端他应该等待下一次轮询的时间。

HTTP/1.1 200 OK
Content-Type: application/json

{ "status" : "running", "nextAttempt" : "3000ms" }

如果作业完成,服务器应回答303和他创建的资源的URI:

HTTP/1.1 303 See other
Location: /batch-jobs/4711