HTTPRequest
HTTPRequest
クラスを使って、HTTPRequest オブジェクト
を扱うことができます。このオブジェクトは、HTTPサーバーへのリクエ ストの設定と送信、および HTTPサーバーのレスポンスを処理するのに使用します。
HTTPRequest
クラスは、4D
クラスストアにて提供されています。 HTTPリクエストを作成・送信するには、HTTPRequest オブジェクト
を返す 4D.HTTPRequest.new() 関数を使用します。
履歴
リリース | 内容 |
---|---|
19 R6 | クラスを追加 |
例題
リクエスト設定用の MyHttpRequestOptions
クラスを作成します:
Class constructor($method : Text; $headers : Object; $body : Text)
This.method:=$method
This.headers:=$headers
This.body:=$body
Function onResponse($request : 4D.HTTPRequest; $event : Object)
// リクエストを非同期的に処理する場合、onResponse メソッドをここに書きます
Function onError($request : 4D.HTTPRequest; $event : Object)
// リクエストを非同期的に処理する場合、onError メソッドをここに書きます
このクラスを使って、次のようにリクエストを作成できます:
var $headers : Object
$headers:=New object()
$headers["field1"]:="value1"
var myHttpRequestOptions : cs.MyHttpRequestOptions
myHttpRequestOptions := cs.MyHttpRequestOptions.new("GET"; $headers; "")
var $request : 4D.HTTPRequest
$request:=4D.HTTPRequest.new("www.google.com"; myHttpRequestOptions)
$request.wait() // リクエストを同期的に処理する場合
// $request.response からリクエストの結果を取得したり、$request.error からエラーの詳細を確認したりできます
HTTPRequest オブジェクト
HTTPRequest オブジェクトは共有できないオブジェクトです。
HTTPRequest オブジェクトは次のプロパティや関数を提供します:
agent : 4D.HTTPAgentoptions で渡された agent オブジェクト、もしくは省略された場合はグローバルなエージェントオブジェクト |
dataType : Text new() を呼び出す際に options オブジェクトに渡された dataType を格納します (省略時は "auto" |
encoding : Text new() を呼び出す際に options オブジェクトに渡された encoding を格納します (省略時は "UTF-8") |
errors : Collection 少なくとも 1つのエラーが発生した場合、全エラーのコレクションを格納します |
headers : Object |
method : Text new() を呼び出す際に options オブジェクトに渡された method を格納します |
protocol : Text new() を呼び出す際に options オブジェクトに渡された protocol を格納します |
response : Object 少なくともステータスコードを受け取った場合には、リクエストへのレスポンスを格納します (それ以外の場合は未定義) |
returnResponseBody : Boolean new() を呼び出す際に options オブジェクトに渡された returnResponseBody を格納します |
.terminate() HTTPリクエストを中止します |
terminated : Boolean リクエストが終了された場合 ( onTerminate への呼び出し後) は true を格納します (それ以外は false) |
timeout : Real new() を呼び出す際に options オブジェクトに渡された timeout を格納します |
url : Text HTTPリクエストの URL を格納します |
.wait( { time : Real } ) : HTTPRequestClass サーバーのレスポンスを待ちます |
4D.HTTPRequest.new()
履歴
リリース | 内容 |
---|---|
20 | TLS検証がデフォルトに |
19 R7 | automaticRedirections および decodeData プロパティをサポート。 |
4D.HTTPRequest.new( url : Text { ; options : Object } ) : 4D.HTTPRequest
引数 | タイプ | 説明 | |
---|---|---|---|
url | Text | -> | リクエストの送信先URL |
options | Object | -> | リクエスト設定プロパティ |
戻り値 | 4D.HTTPRequest | <- | 新規 HTTPRequest オブジェクト |