主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

GET State Information

获取请求的状态信息

描述

使用 GET 方法获取有关请求状态的信息。self 字段的 URI 作为该方法的可寻址资源。可能的状态有:READINGIN_QUEUEPROCESSINGREADYERRORCANCELLED

以下部分使用 JSON 作为数据序列化格式。有关如何使用 protobuf 作为 Java® 客户端 API 的数据序列化格式的示例,请参阅 获取请求的状态信息

请求

HTTP 方法

GET

URI

http://host:port/{request-uri-string}/info

响应

成功

HTTP 状态代码

200 OK

主体

名称描述值类型
request当前请求的 URI。{request-uri-string}
lastModifiedSeq表示当前请求最后修改时间的数字。{server-state-number}
state当前请求的状态。

{request-state-string}

可能的状态:

READING
IN_QUEUE
PROCESSING
READY
ERROR
CANCELLED

示例

{
  "request": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d",
  "lastModifiedSeq": 19,
  "state": "READY"
}

错误

HTTP 状态代码

400 NoMatchForQueryParams - 具有无效请求 ID 的查询。

404 URL not found

示例调用

HTTP

请求:

GET /~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d/info HTTP/1.1
Host: localhost
Port: 9910

响应:

Status Code: 200 OK
{
  "request": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d",
  "lastModifiedSeq": 19,
  "state": "READY"
}

JavaScript

var data = null;
var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
    if (this.readyState === 4) {
        console.log(this.responseText);
    }
});
xhr.open("GET", "http://localhost:9910/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d/info");
xhr.send(data);

版本历史记录

在 R2016b 中推出