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);