メインコンテンツまでスキップ
バージョン: 開発中

HTTP SET OPTION

HTTP SET OPTION ( option ; value )

引数説明
optionInteger設定するオプションのコード
valueIntegerオプションの値
互換性

このコマンドは互換性のためだけに維持されています。現在は 4D.HTTPRequest クラス を使用することが推奨されています。

説明

HTTP SET OPTIONコマンドは (HTTP GetHTTP Requestコマンドで実行される次のリクエストでクライアントにより使用される) HTTPオプションの値を設定します。設定するオプションの数だけこのコマンドを呼び出します。

注: 設定されるオプションはカレントプロセスに対し有効です。コンポーネントの場合そのコンポーネント内で有効です。

option 引数には設定するオプションの番号を、value 引数にはオプションの新しい値を渡します。option 引数にはHTTP Clientテーマの以下の定義済み変数のいずれかを指定できます:

定数コメント
HTTP client log倍長整数7value = 以下の定数のいづれか一つ: HTTP disable log: HTTP クライアントデバッグログは無効化されています(デフォルト) HTTP enable log with all body parts: HTTP クライアントデバッグログはレスポンスとリクエストの本文部分で有効化されています HTTP enable log with request body: HTTP クライアントデバッグログはリクエストにおいてのみ本文部分で有効化されています HTTP enable log with response body: HTTP クライアントデバッグログはレスポンスにおいてのみ本文部分で有効化されています HTTP enable log without body: HTTP クライアントデバッグログは本文部分以外において有効化されています(この場合本文サイズが提供されます) これを使用するとHTTP クライアントリクエストログファイルのステータスを取得あるいは設定することができます。この機能が有効化された場合アプリケーションの"Logs" フォルダ内に"4DHTTPClientLog_nn.txt" という名前のファイルが保存されます(nn はファイル番号です)。これはHTTP クライアントリクエストに関連した問題をデバッグするのに有用です。ここには各リクエストと各レスポンスがrawモードで記録されます。ヘッダーを含めてリクエスト全体が記録されます。またオプションとして本文部分を記録することができます。詳細な情報については、ログファイルの詳細 の章を参照してください。
HTTP compression倍長整数6値 = 0 (圧縮しない) または 1 (圧縮する)。デフォルト値: 0
このオプションを使用して、クライアント/サーバー間通信を効率化するための圧縮メカニズムの有効/無効を切り替えることができます。このメカニズムが有効になっていると、HTTPクライアントはサーバーのレスポンスに応じてdeflateまたはgzip圧縮を使用します。
HTTP display auth dial倍長整数4値 = 0 (ダイアログボックスを表示しない) または 1 (ダイアログボックスを表示する)。デフォルト値: 0
このオプションを使用して、HTTP GetHTTP Requestを実行した際に認証ダイアログボックスを表示するかどうかを指定できます。デフォルトで認証ダイアログボックスは表示されず、HTTP AUTHENTICATEコマンドを使用して認証を行います。しかし認証ダイアログを表示してユーザーに認証IDを入力させたい場合、valueに1を渡します。ダイアログボックスは認証が必要な場合のみ表示されます。
HTTP follow redirect倍長整数2値 = 0 (リダイレクトを許可しない) または 1 (リダイレクトを許可する)
デフォルト値 = 1
HTTP max redirect倍長整数3 = 受け入れるリダイレクト数の最大値
デフォルト値 = 2
HTTP reset auth settings倍長整数5値 = 0 (情報を削除しない) または 1 (情報を削除する)。デフォルト値: 0
このオプションを使用して4Dに、各HTTP GetHTTP Requestコマンド実行毎に、ユーザーの認証情報 (ユーザー名、パスワード、認証メソッド) をリセットするよう指示できます。デフォルトでこれらの情報は保持され、各リクエストで再利用されます。value に1を渡すとコマンド実行毎にこれらの情報は削除されます。この設定に関わらず、これらの情報はプロセスが終了すると削除されます。
HTTP timeout倍長整数1値 = クライアントリクエストのタイムアウト (秒単位)。このタイムアウトはサーバーからのレスポンスを何秒待つかを指定します。タイムアウト時間を経過するとクライアントはセッションを閉じ、リクエストは失われます。
デフォルトでタイムアウトは120秒に設定されています。ネットワークの状態やリクエストの特性に応じてこの値を変更できます。

オプションはどのような順番で設定してもかまいません。おなじオプションを複数回設定した場合、最後に設定された値が使用されます。

参照

HTTP AUTHENTICATE
HTTP GET OPTION