Main Content

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}
lastModifiedSeqself で表されるリクエストがいつ最終変更されたのかを示す数値。{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 で導入