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

GET Representation of Asynchronous Request

查看对服务器发出的异步请求的表示方式

描述

使用 GET 方法查看服务器上异步请求的表示。self 字段的 URI 作为该方法的可寻址资源。

以下部分使用 JSON 作为数据序列化格式。

请求

HTTP 方法

GET

URI

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

响应

成功

HTTP 状态代码

200 OK

主体

名称描述值类型
id特定请求的 ID。{id-string}
self

特定请求的 URI。

在其他异步执行请求中使用 URI，例如检索请求的状态或请求的结果。

{request-uri-string}
up与特定客户端绑定的请求集合的 URI。{request-collection-uri-string}
lastModifiedSeq表示 self 所代表的请求的最后修改时间的数字。{server-state-number}
state请求的状态。

{request-state-string}

可能的状态： 

READING
IN_QUEUE
PROCESSING
READY
ERROR
CANCELLED

client发起异步请求时作为查询参数指定的客户端 ID 或名称。{client-id-string}

示例：

{
  "id": "f90c2ff8-4d27-4795-806d-18c351abeb5b",
  "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/f90c2ff8-4d27-4795-806d-18c351abeb5b",
  "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
  "lastModifiedSeq": 30,
  "state": "READING",
  "client": "786"
}

错误

HTTP 状态代码

400 NoMatchForQueryParams

404 ResourceNotFound

示例调用

HTTP

请求：

GET /~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/f90c2ff8-4d27-4795-806d-18c351abeb5b HTTP/1.1
Host: localhost:9910

响应：

Status Code: 200 OK
{
  "id": "f90c2ff8-4d27-4795-806d-18c351abeb5b",
  "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/f90c2ff8-4d27-4795-806d-18c351abeb5b",
  "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
  "lastModifiedSeq": 31,
  "state": "IN_QUEUE",
  "client": "786"
}

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/f90c2ff8-4d27-4795-806d-18c351abeb5b");
xhr.send(data);

版本历史记录

在 R2016b 中推出

另请参阅

主题