OutboundNameValueハンドラーは、HTTPプロトコルを使用してリモート・サーバーに名前の値ペアをポストできます。
詳細については、「5.2.6 Webブラウザー・コンテンツ」を参照してください。
このコンテンツ・ハンドラーのSENDコマンドが実行されると、以下のステップが行われます。
1 オプションの作業リストを使用できる場合、名前の値ペア・データが作成されます。この作業リストには、名前とサイズの少なくとも2つのフィールドが必要です。ここで重要なのは、最初のフィールドに名前を指定し、2番目のフィールドに値を指定する点です。名前と値はURLでエンコードされます。
2 作業リストが使用できない場合は、長さゼロのコンテンツが作成されます。
3 METHODキーワードがGETの場合、HTTP GETプロトコルを使用してリモート・ホストにアクセスできます。名前の値ペアのコンテンツが存在する場合は、URLの最後に追加され、URLとこのデータは「?」で区切られます。
4 METHODキーワードがPOSTの場合、HTTP POSTプロトコルを使用してリモート・ホストにアクセスします。名前の値ペアのコンテンツが存在する場合、これはコンテンツとして含まれます。
構文：
コマンド |
キーワード |
値 |
開発者用メモ |
SEND |
HANDLER |
OutboundNameValue |
|
|
URI |
値 |
必須。リモートURI |
|
HOST |
値 |
必須。リモート・サーバー |
|
SNISERVER |
値 |
任意。TLS ハンドシェイクが使用するSNIホスト名です。指定の値、またはHOSTキーワード値に*HOSTを使用します。 |
|
USER |
値 |
任意。基本認証ユーザー |
|
PASSWORD |
値 |
任意。基本認証パスワード |
|
PROXY |
値 |
任意。プロキシー・サーバー |
|
PROXYUSER |
値 |
任意。基本認証ユーザー |
|
PROXYPASSWORD |
値 |
任意。基本認証パスワード |
|
METHOD |
|
任意。詳細は、「METHOD」を参照してください。 |
|
VERSION |
|
任意。詳細は、「VERSION」を参照してください。 |
|
SECURE |
*YES |
任意。HTTPSプロトコルを使用します。 |
|
|
*NO |
デフォルト。HTTPプロトコルを使用します。 |
|
ENCODING |
|
任意。詳細は、「ENCODING」を参照してください。 フィールド値のエンコードに使用されます。 |
|
WAIT |
*NO |
任意。HTTP応答を待機しません。 |
|
|
*YES |
デフォルト。HTTP応答を無限に待機します。 |
|
|
値 |
読み込み時間をミリ秒単位で待機します。 |
|
TIMEOUT |
値 |
任意。デフォルトは0で、無効を示します。 ホスト接続のタイムアウト(ミリ秒単位) |
|
LOCALE |
|
任意。詳細は、「LOCALE」を参照してください。 |
|
NUMBERFORMAT |
|
任意。詳細は、「NUMBERFORMAT」を参照してください。 |
|
SPACE |
*PLUS |
デフォルト。スペースを+記号にエンコードします。 |
|
|
*BLANK |
スペースをブランクにエンコードします。 |
|
|
*PERCENT20 |
スペースを%20にエンコードします。 |
例
SEND HANDLER(OutboundNameValue) HOST(…) URI(/cgi-bin/program) #WRKLST(NAME,VALUE)