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

GET Collection of Requests

查看请求集合

描述

使用 GET 方法查看服务器上的请求集合。up 字段的 URI 作为该方法的可寻址资源。

以下部分使用 JSON 作为数据序列化格式。有关如何使用 protobuf 作为 Java® 客户端 API 的数据序列化格式的示例，请参阅 查看特定客户端拥有的请求集合。

请求

HTTP 方法

GET

URI

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

查询参数

名称描述值类型
since

必需。

{server-state-number}
clients

如果未指定 ids，则必需。

{client-id-string_1},{client-id-string_2},...
ids

如果未指定 clients，则必需。

{id-string_1},{id_string_2},...

示例：

?since=30&clients=786

  • 如果您发出异步请求，则查询参数 since={server-state-number} 是必需的。

  • 查询参数 clients={client-id-string} 是可选的。

响应

成功

HTTP 状态代码

200 OK

主体

名称描述值类型
createdSeq表示服务器状态的数字。data 集合中包含的请求是在 since 和 createdSeq 之间经历了某种状态变化的请求。{server-state-number}
data与查询匹配的 MATLAB® 执行请求的集合。

"data": [
   {
   "id": {id-string},
   "self": [request-uri-string},
   "up": {request-collection-uri-string},
   "lastModifiedSeq": {server-state-number},
   "state": {request-state-string},
   "client": {client-id-string}
 },
{
   "id": {id-string},
   "self": {request-uri-string},
   "up": {request-collection-uri-string},
   "lastModifiedSeq": {server-state-number},
   "state": {request-state-string},
   "client": {client-id-string}
 },...
  ]

示例：

"data": [
    {
      "id": "c5666088-b087-4bae-aa7d-d8470e6e082d",
      "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d",
      "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
      "lastModifiedSeq": 19,
      "state": "READY",
      "client": "786"
    },
    {
      "id": "a4d0f902-d212-47d5-a855-6d64192842d8",
      "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/a4d0f902-d212-47d5-a855-6d64192842d8",
      "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
      "lastModifiedSeq": 17,
      "state": "READY",
      "client": "786"
    },
    
  ]

错误

如果您为不存在的客户端调用 GET 收集请求，您将收到 404 错误响应。

如果您对当前没有请求的客户端调用 GET 收集请求（例如，来自该客户端的所有先前的请求均已被删除），则 GET 调用可以执行以下操作之一：

  • 如果客户端指定了超时限制，则超时。

  • 无限期地等待，直到客户端发送新的请求。然后 GET 调用返回该请求。

HTTP 状态代码

400 InvalidParamSince

400 MissingParamSince

400 MissingQueryParams

400 NoMatchForQueryParams

404 URL not found

500 InternalServerError

示例调用

HTTP

请求：

GET /~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests?since=15&clients=786 HTTP/1.1
Host: localhost:9910

响应：

Status Code: 200 OK
{
  "createdSeq": 19,
  "data": [
    {
      "id": "c5666088-b087-4bae-aa7d-d8470e6e082d",
      "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d",
      "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
      "lastModifiedSeq": 19,
      "state": "READY",
      "client": "786"
    },
    {
      "id": "a4d0f902-d212-47d5-a855-6d64192842d8",
      "self": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/a4d0f902-d212-47d5-a855-6d64192842d8",
      "up": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests",
      "lastModifiedSeq": 17,
      "state": "READY",
      "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?since=15&clients=786");
xhr.send(data);

版本历史记录

在 R2016b 中推出

另请参阅

|

主题