Http - stingray.Http ネームスペース リファレンス - Stingray Lua API リファレンス
説明
単純な HTTP クライアントを実装します。
この単純なクライアントでは SSL などの高度な機能はサポートされないことに注意してください。高度な機能が必要な場合は、プラグイン システムを使用してさらに高度な HTTP クライアント(Curl など)にリンクする必要があります。
Http オブジェクトはグローバル シングルトンであり、すべての関数はこのグローバル シングルトンに対して動作します。
その他の関連リファレンス項目 
この参照ページは、次の概要トピックと関連付けられています
列挙
関数
 |
close ( id ) 指定された要求を閉じ、関連するメモリをすべて解放します。
|
id : | integer | 操作の ID。 |
| この関数は値を返しません。 |
close() を呼び出すと、その要求に関する情報を取得できなくなります。
| |
error ( id ) : string?HTTP 操作のエラー メッセージを ERROR ステータスとともに返します。
|
id : | integer | 操作の ID。 |
string? |
HTTP 操作のエラーです。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。 |
ステータスが ERROR でない場合は、nil が返されます。
| |
get ( url, timeout ) : integer指定されたリソースを取得するための非同期 HTTP GET 操作を開始します。
|
url : | string | GET するリソースの URL です。 |
timeout : | number? | 要求が自動的に失敗するまでの秒単位でのタイムアウトです(既定値は 10s)。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。 |
integer |
この要求を識別する ID です。 |
返された ID を使用して、操作の進行状況をモニタすることができます。指定されたタイムアウトが経過すると要求は自動的に閉じられますが、メモリを節約するために、作業が終了したら手動で要求を閉じてください。
| |
post ( url, content_type, body, timeout ) : integer非同期の HTTP POST 操作を開始します。
|
url : | string | POST 先のエンドポイントの URL です。 |
content_type : | string | POST 要求のコンテンツ タイプ |
body : | string | POST 要求の本文 |
timeout : | number? | 要求が自動的に失敗するまでの秒単位でのタイムアウトです(既定値は 10s)。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。 |
integer |
この要求を識別する ID です。 |
返された ID を使用して、操作の進行状況をモニタすることができます。指定されたタイムアウトが経過すると要求は自動的に閉じられますが、メモリを節約するために、作業が終了したら手動で要求を閉じてください。
| |
response ( id ) : table?FINISHED である HTTP 操作の結果を返します。
|
id : | integer | 操作の ID。 |
table? |
HTTP 操作の結果です。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。 |
操作が FINISHED になっていない場合は、nil が返されます。
結果は、次のフィールドがあるテーブルとして返されます。
- status_code: 整数としての HTTP ステータス コード
- reason_phrase: ステータス コードに関連付けられている HTTP 理由フレーズです。
- headers: HTTP ヘッダのキーと値があるテーブルです。
- body: HTTP データの本文です。
| |
status ( id ) : stingray.Http.StatusHTTP 操作の現在のステータスを返します。
|