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 | リクエストの状態。 |
取りうる状態: 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 で導入